update comment

diff --git a/json_object.h b/json_object.h
index 41d6d7e80b91c03e5b6ef8b8887924c108645e6e..afd6e4f4daf42bf21c744f3c6a00cebb452cbc6d 100644 (file)
--- a/json_object.h
+++ b/json_object.h
@@ -965,8 +965,9 @@ JSON_EXPORT int json_object_set_string(json_object* obj, const char* new_value);
  */
 JSON_EXPORT int json_object_set_string_len(json_object* obj, const char* new_value, int len);
 
-/** Create a new empty json_object of type null and return NULL.
- *
+/** This method exists only to provide a complementary function
+ * along the lines of the other json_object_new_* functions.
+ * It always returns NULL, and it is entirely acceptable to simply use NULL directly.
  */
 JSON_EXPORT struct json_object* json_object_new_null();