From 78bc067beba2734cea1c21e04b8b5608758afec3 Mon Sep 17 00:00:00 2001
From: Mike Sierra <msierra@adobe.com>
Date: Wed, 9 Oct 2013 14:30:48 -0400
Subject: [PATCH] EDIT & COMMENT Element.attr

---
 src/svg.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/svg.js b/src/svg.js
index 7f36af5..eed1029 100644
--- a/src/svg.js
+++ b/src/svg.js
@@ -1446,13 +1446,14 @@ function arrayFirstValue(arr) {
     }
 }
 (function (elproto) {
+    // SIERRA Element.attr(): There appear to be two possible return values, one of which is blank. (Search the doc for _Returns:_ to identify problems.)
     /*\
      * Element.attr
      [ method ]
      **
      * Gets or sets given attributes of the element
      **
-     - params (object) key-value pairs of attributes you want to set
+     - params (object) contains key-value pairs of attributes you want to set
      * or
      - param (string) name of the attribute
      = (Element)
@@ -1773,6 +1774,7 @@ function arrayFirstValue(arr) {
         }
         return unit2px(this, attr, value);
     };
+    // SIERRA Element.use(): I suggest adding a note about how to access the original element the returned <use> instantiates. It's a part of SVG with which ordinary web developers may be least familiar.
     /*\
      * Element.use
      [ method ]