From 1b3da606b784fa660d7cd39f810e698914d66cd2 Mon Sep 17 00:00:00 2001
From: dannydelott <dannydelott@gmail.com>
Date: Fri, 17 Jul 2015 14:12:33 -0700
Subject: [PATCH] Add docs for View#events

---
 index.html | 35 +++++++++++++++++++++++++++++++++--
 1 file changed, 33 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index 28dd63c9..c3e6f3f5 100644
--- a/index.html
+++ b/index.html
@@ -450,6 +450,7 @@
       <li>– <a href="#View-template">template</a></li>
       <li>– <a href="#View-render">render</a></li>
       <li>– <a href="#View-remove">remove</a></li>
+      <li>– <a href="#View-events">events</a></li>
       <li>– <a href="#View-delegateEvents">delegateEvents</a></li>
       <li>– <a href="#View-undelegateEvents">undelegateEvents</a></li>
     </ul>
@@ -2929,6 +2930,36 @@ var Bookmark = Backbone.View.extend({
       events that the view has <a href="#Events-listenTo">listenTo</a>'d.
     </p>
 
+    <p id="View-events">
+      <b class="header">events</b><code>view.events or view.events()</code>
+      <br />
+      The <b>events</b> hash (or method) can be used to specify a set of DOM
+      events that will be bound to methods on your View
+      through <a href="#View-delegateEvents">delegateEvents</a>.
+    </p>
+
+    <p>Backbone will automatically attach the event listeners at instantiation
+    time, right before invoking <a href="#View-constructor">initialize</a>.
+    </p>
+
+<pre>
+var InputView = Backbone.View.extend({
+
+  tagName: 'input',
+
+  events: {
+    "keydown" : "keyAction",
+  },
+
+  render: function(){ ... },
+
+  keyAction: function(e) {
+    var isEnterKey = e.which === 13;
+    if(isEnterKey){ this.collection.addEntry(this.$el.val()); }
+  }
+});
+</pre>
+
     <p id="View-delegateEvents">
       <b class="header">delegateEvents</b><code>delegateEvents([events])</code>
       <br />
@@ -4263,7 +4294,7 @@ ActiveRecord::Base.include_root_in_json = false
         in 1.2.0.
       </li>
     </ul>
-  
+
     <b class="header">1.2.0</b> &mdash; <small><i>May 13, 2015</i></small>
     &mdash; <a href="https://github.com/jashkenas/backbone/compare/1.1.2...1.2.0">Diff</a>
     &mdash; <a href="https://cdn.rawgit.com/jashkenas/backbone/1.2.0/index.html">Docs</a>
@@ -4286,7 +4317,7 @@ ActiveRecord::Base.include_root_in_json = false
       <li>
         Views now always delegate their events in <a href="#View-setElement">setElement</a>.
         You can no longer modify the events hash or your view's <tt>el</tt> property in
-        <tt>initialize</tt>. 
+        <tt>initialize</tt>.
       </li>
       <li>
         Added an <tt>"update"</tt> event that triggers after any amount of