* *\r
******************************************************************************/\r
package org.json;\r
-\r
+/**\r
+ * The <code>JSONString</code> interface allows a <code>toJSONString()</code>\r
+ * method so that a class can change the behavior of\r
+ * <code>JSONObject.toString()</code>, <code>JSONArray.toString()</code>,\r
+ * and <code>JSONWriter.value(</code>Object<code>)</code>. The\r
+ * <code>toJSONString</code> method will be used instead of the default behavior\r
+ * of using the Object's <code>toString()</code> method and quoting the result.\r
+ */\r
public interface JSONString {\r
-\r
+ /**\r
+ * The <code>toJSONString</code> method allows a class to produce its own JSON\r
+ * serialization.\r
+ *\r
+ * @return A strictly syntactically correct JSON text.\r
+ */\r
public String toJSONString();\r
}\r