Note that JSON supports top-level scalar values and null

-- 
Provided by anonymous 32932 (ajf@ajf.me)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@331384 c90b9560-bf6c-de11-be94-00142212c4b1

language-snippets.ent

@@ -455,6 +455,13 @@ own font identifiers registered with <function>imageloadfont</function>.
 dbm_identifier</parameter></term><listitem><para>The DBM link identifier,
 returned by <function>dbmopen</function>.</para></listitem></varlistentry>'>
 
+<!-- JSON notes -->
+
+<!ENTITY json.implementation.superset '<note xmlns="http://docbook.org/ns/docbook"><para>PHP implements a superset of
+JSON - it will also encode and decode scalar types and &null;. The JSON standard
+only supports these values when they are nested inside an array or an object.
+</para></note>'>
+
 <!-- cURL notes -->
 
 <!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>ch</parameter>

reference/json/book.xml

@@ -14,6 +14,7 @@
    data-interchange format. The decoding is handled by a parser based on 
    the JSON_checker by Douglas Crockford.
   </para>
+  &json.implementation.superset;
  </preface>
 
  &reference.json.setup;

reference/json/functions/json-decode.xml

@@ -31,8 +31,9 @@
        The <parameter>json</parameter> <type>string</type> being decoded.
       </para>
       <para>
-       This function only works with UTF-8 encoded data.
+       This function only works with UTF-8 encoded strings.
       </para>
+      &json.implementation.superset;
      </listitem>
     </varlistentry>
     <varlistentry>

reference/json/functions/json-encode.xml

@@ -32,8 +32,9 @@
        a <type>resource</type>.
       </para>
       <para>
-       This function only works with UTF-8 encoded data.
+       All string data must be UTF-8 encoded.
       </para>
+      &json.implementation.superset;
      </listitem>
     </varlistentry>
     <varlistentry>