From 136b6fae7b62fa49770c3fbff655834e25603a9b Mon Sep 17 00:00:00 2001
From: Mike Sierra <msierra@adobe.com>
Date: Wed, 9 Oct 2013 12:43:17 -0400
Subject: [PATCH] COMMENTS for Snap.angle, Snap.Matrix, Snap.animate

---
 src/svg.js | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/svg.js b/src/svg.js
index 743108e..e0f5bf4 100644
--- a/src/svg.js
+++ b/src/svg.js
@@ -288,6 +288,7 @@ Snap.rad = rad;
  = (number) angle in degrees.
 \*/
 Snap.deg = deg;
+// SIERRA for which point is the angle calculated?
 /*\
  * Snap.angle
  [ method ]
@@ -591,6 +592,7 @@ function Matrix(a, b, c, d, e, f) {
         }
     };
 })(Matrix.prototype);
+// SIERRA Unclear the difference between the two matrix formats ("parameters" vs svgMatrix). See my comment about Element.matrix().
 /*\
  * Snap.Matrix
  [ method ]
@@ -2045,6 +2047,9 @@ function arrayFirstValue(arr) {
         }
         return res;
     };
+    // SIERRA unfamiliar with the phrase _caring function,_ so the text for the _setter_ param isn't clear.
+    // SIERRA With the animation's start/end states defined, how is its _speed_ distinguished from its _duration_?
+    // SIERRA Text explaining the mina format should move to the section on the mina object interface. (Prior comment applies: object interfaces need to also be documented.)
     /*\
      * Snap.animate
      [ method ]