From 407d536e06fab42b9a6b1a0f71c7adf51351e37e Mon Sep 17 00:00:00 2001
From: Benoit Blanchon <github@benoitblanchon.fr>
Date: Mon, 21 Jul 2014 14:14:31 +0200
Subject: [PATCH] Added comments

---
 JsonParser/JsonArray.h | 33 ++++++++++++++++++++++++---------
 1 file changed, 24 insertions(+), 9 deletions(-)

diff --git a/JsonParser/JsonArray.h b/JsonParser/JsonArray.h
index afeb142c..27af4bec 100644
--- a/JsonParser/JsonArray.h
+++ b/JsonParser/JsonArray.h
@@ -13,72 +13,87 @@ namespace ArduinoJson
     namespace Parser
     {
         class JsonObject;
-               
+                
+        // A JSON array.
         class JsonArray : JsonValue
         {          
         public:
 
+            // Create an invalid array.
             JsonArray() 
             {            
             }
-
+
+            // Convert a JsonValue into a JsonArray.
             JsonArray(JsonValue value)
                 : JsonValue(value)
             {
             }
-
+
+            // Tell if the array is valid.
             bool success()
             {
                 return isArray();
             }
-
+
+            // Get the JsonValue at specified index.
             JsonValue operator[](int index)
             {
                 return JsonValue::operator[](index);
             }
-
+
+            // Get the size of the array.
             int size()
             {
                 return isArray() ? childrenCount() : 0;
             }
-
+
+            // Get an iterator pointing to the beginning of the array.
             JsonArrayIterator begin()
             {
                 return isArray() ? firstChild() : null();
             }
-
+
+            // Gets an iterator pointing to the end of the array.
             JsonArrayIterator end()
             {
                 return isArray() ? nextSibling() : null();
             }
-
+
+            // Obsolete. Use size() instead.
             DEPRECATED int getLength()
             {
                 return size();
             }
-                      
+                   
+            // Obsolete. Use operator[] instead.
             DEPRECATED JsonArray getArray(int index)
             {
                 return operator[](index);
             }
 
+            // Obsolete. Use operator[] instead.
             DEPRECATED bool getBool(int index)
             {
                 return operator[](index);
             }
 
+            // Obsolete. Use operator[] instead.
             DEPRECATED double getDouble(int index)
             {
                 return operator[](index);
             }
 
+            // Obsolete. Use operator[] instead.
             DEPRECATED JsonObject getHashTable(int index);
 
+            // Obsolete. Use operator[] instead.
             DEPRECATED long getLong(int index)
             {
                 return operator[](index);
             }
 
+            // Obsolete. Use operator[] instead.
             DEPRECATED char* getString(int index)
             {
                 return operator[](index);