Added comments

JsonParser/JsonToken.h

@@ -11,73 +11,85 @@ namespace ArduinoJson
 {
     namespace Parser
     {
+        // A pointer to a JSON token
         class JsonToken
         {
         public:
 
+            // Create a "null" pointer
             JsonToken()
                 : token(0)
             {
-
             }
 
+            // Create a pointer to the specified JSON token
             JsonToken(char* json, jsmntok_t* token)
-                : json(json),  token(token)
+                : json(json), token(token)
             {
-
             }
 
+            // Get content of the JSON token
             char* getText()
             {
                 json[token->end] = 0;
                 return json + token->start;
             }
 
+            // Get the number of children tokens
+            int childrenCount()
+            {
+                return token->size;
+            }
+
+            // Get a pointer to the first child of the current token
             JsonToken firstChild() const
             {
                 return JsonToken(json, token + 1);
             }
 
+            // Get a pointer to the next sibling token (ie skiping the children tokens)
             JsonToken nextSibling() const;
 
-            bool operator!= (const JsonToken& other) const
+            // Test equality
+            bool operator!=(const JsonToken& other) const
             {
                 return token != other.token;
             }
 
-            static JsonToken null()
-            {
-                return JsonToken(0, 0);
-            }
-
+            // Tell if the pointer is "null"
             bool isValid()
             {
                 return token != 0;
             }
 
+            // Tell if the JSON token is a JSON object
             bool isObject()
             {
                 return token != 0 && token->type == JSMN_OBJECT;
             }
 
+            // Tell if the JSON token is a JSON array
             bool isArray()
             {
                 return token != 0 && token->type == JSMN_ARRAY;
             }
 
+            // Tell if the JSON token is a primitive
             bool isPrimitive()
             {
                 return token != 0 && token->type == JSMN_PRIMITIVE;
             }
 
+            // Tell if the JSON token is a string
             bool isString()
             {
                 return token != 0 && token->type == JSMN_STRING;
             }
 
-            int childrenCount()
+            // Explicit wait to create a "null" JsonToken
+            static JsonToken null()
             {
-                return token->size;
+                return JsonToken();
             }
 
         private:
@@ -85,5 +97,4 @@ namespace ArduinoJson
             jsmntok_t* token;
         };
     }
-}
-
+}