From afd2923f115b500f261ffc70da1da613a6f3fa69 Mon Sep 17 00:00:00 2001
From: TJ VanToll <tj.vantoll@gmail.com>
Date: Wed, 23 Jan 2013 22:51:14 -0500
Subject: [PATCH] Docmument the uselessness of native change events on widgets
 (#12)

---
 entries/autocomplete.xml | 1 +
 entries/datepicker.xml   | 1 +
 entries/spinner.xml      | 1 +
 notes.xsl                | 3 +++
 4 files changed, 6 insertions(+)

diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml
index 362e0cce..5a6061e5 100644
--- a/entries/autocomplete.xml
+++ b/entries/autocomplete.xml
@@ -35,6 +35,7 @@
 		</ul>
 	</longdesc>
 	<note id="functional-css"/>
+	<note id="native-change-warning"/>
 	<added>1.8</added>
 	<options>
 		<option name="appendTo" type="Selector" default="null" example-value='"#someElem"'>
diff --git a/entries/datepicker.xml b/entries/datepicker.xml
index 0a587129..0695a7fa 100644
--- a/entries/datepicker.xml
+++ b/entries/datepicker.xml
@@ -48,6 +48,7 @@
 		</ul>
 	</longdesc>
 	<note id="functional-css"/>
+	<note id="native-change-warning"/>
 	<added>1.0</added>
 	<options>
 		<option name="altField" default='""' example-value='"#actualDate"'>
diff --git a/entries/spinner.xml b/entries/spinner.xml
index a9bd4127..595ea7f6 100644
--- a/entries/spinner.xml
+++ b/entries/spinner.xml
@@ -29,6 +29,7 @@
 		</ul>
 	</longdesc>
 	<note id="functional-css"/>
+	<note id="native-change-warning"/>
 	<added>1.9</added>
 	<options>
 		<option name="culture" type="String" default="null" example-value='"fr"'>
diff --git a/notes.xsl b/notes.xsl
index 3072976b..88bcccec 100644
--- a/notes.xsl
+++ b/notes.xsl
@@ -4,6 +4,9 @@
 		<xsl:when test="@id = 'functional-css'">
 			This widget requires some functional CSS, otherwise it won't work. If you build a custom theme, use the widget's specific CSS file as a starting point.
 		</xsl:when>
+		<xsl:when test="@id = 'native-change-warning'">
+			This widget manipulates its element's value programmatically, therefore a native change may not be fired when the element's value changes.
+		</xsl:when>
 	</xsl:choose>
 </xsl:template>
 </xsl:stylesheet>