From ad4f464d7c1843a94c85a8441a00b3569769ea8a Mon Sep 17 00:00:00 2001
From: Ben Ogle <ogle.ben@gmail.com>
Date: Fri, 22 Aug 2014 15:08:07 -0700
Subject: [PATCH] Fix Decoration events

---
 src/decoration.coffee | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/decoration.coffee b/src/decoration.coffee
index aa98eba87..3d888ab34 100644
--- a/src/decoration.coffee
+++ b/src/decoration.coffee
@@ -29,11 +29,17 @@ nextId = -> idCounter++
 #
 # ## Events
 #
-# A couple of events are emitted:
+# ### updated
 #
-# * `destroyed`: When the {Decoration} is destroyed
-# * `updated`: When the {Decoration} is updated via {Decoration::update}.
-#     Event object has properties `oldParams` and `newParams`
+# Extended: When the {Decoration} is updated via {Decoration::update}.
+#
+# * `event` {Object}
+#   * `oldParams` {Object} the old parameters the decoration used to have
+#   * `newParams` {Object} the new parameters the decoration now has
+#
+# ### destroyed
+#
+# Extended: When the {Decoration} is destroyed
 #
 module.exports =
 class Decoration