From 458c4692145fb329f7ddc2763d291031fc762aca Mon Sep 17 00:00:00 2001
From: Ken Earley <ken@getharvest.com>
Date: Fri, 19 Jul 2013 13:38:49 -0500
Subject: [PATCH 1/3] Added events example and descriptions to documentation

---
 public/options.html | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/public/options.html b/public/options.html
index b91bb488f8a..b9f2a94a1a4 100644
--- a/public/options.html
+++ b/public/options.html
@@ -157,6 +157,44 @@ <h3>Example:</h3>
           </td>
         <tr>
       </table>
+
+      <h2>Events</h2>
+      <p>Chosen fires events to which you can attach listeners.</p>
+
+      <h3>Example:</h3>
+
+<pre>
+  <code class="language-javascript">$('.chzn-select').bind('change', function(evt, params) {
+    do_something(evt, params);
+  });</code>
+</pre>
+
+      <table class="docs-table">
+        <tr>
+          <th>Event</th><th>Description</th>
+        </tr>
+        <tr>
+          <td>change</td>
+          <td>Chosen triggers the standard DOM event whenever a selection is made (it also includes a selected or deselected parameter that tells you which option was changed).</td>
+        </tr>
+        <tr>
+          <td>liszt:ready</td>
+          <td>after Chosen has been fully instantiated.</td>
+        </tr>
+        <tr>
+          <td>liszt:maxselected</td>
+          <td>triggered if <code class="language-javascript">max_selected_options</code> is set and that total is broken.</td>
+        </tr>
+        <tr>
+          <td>liszt:showing_dropdown</td>
+          <td>triggered when the dropdown is opened</td>
+        </tr>
+        <tr>
+          <td>liszt:hiding_dropdown</td>
+          <td>triggered when the dropdown is closed</td>
+        </tr>
+      </table>
+
     </div>
   </div>
   <div class="oss-bar">

From 944b67c085c961265d0d799916eae7a8595c1e94 Mon Sep 17 00:00:00 2001
From: Ken Earley <ken@getharvest.com>
Date: Fri, 19 Jul 2013 13:54:45 -0500
Subject: [PATCH 2/3] Updated events documentation

---
 public/options.html | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/public/options.html b/public/options.html
index b9f2a94a1a4..8b5c1b2bf54 100644
--- a/public/options.html
+++ b/public/options.html
@@ -159,12 +159,12 @@ <h3>Example:</h3>
       </table>
 
       <h2>Events</h2>
-      <p>Chosen fires events to which you can attach listeners.</p>
+      <p>Chosen triggers a number of standard and custom events on the original select field.</p>
 
       <h3>Example:</h3>
 
 <pre>
-  <code class="language-javascript">$('.chzn-select').bind('change', function(evt, params) {
+  <code class="language-javascript">$('select').on('change', function(evt, params) {
     do_something(evt, params);
   });</code>
 </pre>
@@ -175,7 +175,10 @@ <h3>Example:</h3>
         </tr>
         <tr>
           <td>change</td>
-          <td>Chosen triggers the standard DOM event whenever a selection is made (it also includes a selected or deselected parameter that tells you which option was changed).</td>
+          <td>
+            <p>Chosen triggers the standard DOM event whenever a selection is made (it also includes a selected or deselected parameter that tells you which option was changed).</p>
+            <p><strong>Note:</strong> in order to use change in the Prototype version, you have to include the <a href="https://github.com/kangax/protolicious/blob/5b56fdafcd7d7662c9d648534225039b2e78e371/event.simulate.js">Event.simulate</a> class. The selected and deselected parameters are not available for Prototype.</p>
+          </td>
         </tr>
         <tr>
           <td>liszt:ready</td>
@@ -187,11 +190,11 @@ <h3>Example:</h3>
         </tr>
         <tr>
           <td>liszt:showing_dropdown</td>
-          <td>triggered when the dropdown is opened</td>
+          <td>triggered when Chosen's dropdown is opened.</td>
         </tr>
         <tr>
           <td>liszt:hiding_dropdown</td>
-          <td>triggered when the dropdown is closed</td>
+          <td>triggered when Chosen's dropdown is closed.</td>
         </tr>
       </table>
 

From 7be5a7ba021ebcf0d4c6325d834ed24708c8ee23 Mon Sep 17 00:00:00 2001
From: Ken Earley <ken@getharvest.com>
Date: Fri, 19 Jul 2013 14:15:21 -0500
Subject: [PATCH 3/3] Added info about params sent with events

---
 public/options.html | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/public/options.html b/public/options.html
index 8b5c1b2bf54..93f79df27fb 100644
--- a/public/options.html
+++ b/public/options.html
@@ -176,25 +176,25 @@ <h3>Example:</h3>
         <tr>
           <td>change</td>
           <td>
-            <p>Chosen triggers the standard DOM event whenever a selection is made (it also includes a selected or deselected parameter that tells you which option was changed).</p>
+            <p>Chosen triggers the standard DOM event whenever a selection is made (it also sends a <code class="language-javascript">selected</code> or <code class="language-javascript">deselected</code> parameter that tells you which option was changed).</p>
             <p><strong>Note:</strong> in order to use change in the Prototype version, you have to include the <a href="https://github.com/kangax/protolicious/blob/5b56fdafcd7d7662c9d648534225039b2e78e371/event.simulate.js">Event.simulate</a> class. The selected and deselected parameters are not available for Prototype.</p>
           </td>
         </tr>
         <tr>
           <td>liszt:ready</td>
-          <td>after Chosen has been fully instantiated.</td>
+          <td>after Chosen has been fully instantiated (it also sends the <code class="language-javascript">chosen</code> object as a parameter).</td>
         </tr>
         <tr>
           <td>liszt:maxselected</td>
-          <td>triggered if <code class="language-javascript">max_selected_options</code> is set and that total is broken.</td>
+          <td>triggered if <code class="language-javascript">max_selected_options</code> is set and that total is broken. (it also sends the <code class="language-javascript">chosen</code> object as a parameter)</td>
         </tr>
         <tr>
           <td>liszt:showing_dropdown</td>
-          <td>triggered when Chosen's dropdown is opened.</td>
+          <td>triggered when Chosen's dropdown is opened (it also sends the <code class="language-javascript">chosen</code> object as a parameter).</td>
         </tr>
         <tr>
           <td>liszt:hiding_dropdown</td>
-          <td>triggered when Chosen's dropdown is closed.</td>
+          <td>triggered when Chosen's dropdown is closed (it also sends the <code class="language-javascript">chosen</code> object as a parameter).</td>
         </tr>
       </table>