document Zend_Json::prettyPrint

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@19911 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/en/module_specs/Zend_Json-Basics.xml

@@ -14,6 +14,28 @@ $phpNative = Zend_Json::decode($encodedValue);
 // Encode it to return to the client:
 $json = Zend_Json::encode($phpNative);
 ]]></programlisting>
+
+    <sect2 id="zend.json.basics.prettyprint">
+	<title>Pretty-printing JSON</title>
+	<para>
+	Sometimes, it may be hard to explore <acronym>JSON</acronym>  data generated by
+	<methodname>Zend_Json::encode()</methodname>,
+	since it has no spacing or indentation. In order to make it easier, <classname>Zend_Json</classname>
+	allows you to pretty-print <acronym>JSON</acronym> data in the human-readable format 
+	with <methodname>Zend_Json::prettyPrint()</methodname>.
+	</para>
+    <programlisting language="php"><![CDATA[
+// Encode it to return to the client:
+$json = Zend_Json::encode($phpNative);
+if($debug) {
+	echo Zend_Json::prettyPrint($json, array("indent" => " "));
+}
+]]></programlisting>
+	<para>
+	Second optional argument of <methodname>Zend_Json::prettyPrint()</methodname> is an option array. 
+	Option <code>indent</code> allows to set indentation string - by default it's a single tab character.
+	</para>
+	</sect2>
 </sect1>
 <!--
 vim:se ts=4 sw=4 et: