Sync xml functions

Author: sy-records

reference/xml/examples.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 802374deda550dfb866348d41a019315cb1f9840 Maintainer: Luffy Status: ready -->
+<!-- EN-Revision: 00a8ae0c879a70f4bc96a707212482f0fcbd9ac6 Maintainer: Luffy Status: ready -->
 <chapter xml:id="xml.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
  <section xml:id="example.xml-structure">
@@ -45,7 +45,6 @@ while ($data = fread($fp, 4096)) {
                     xml_get_current_line_number($xml_parser)));
     }
 }
-xml_parser_free($xml_parser);
 ?>
 ]]>
     </programlisting>
@@ -110,7 +109,6 @@ while ($data = fread($fp, 4096)) {
                     xml_get_current_line_number($xml_parser)));
     }
 }
-xml_parser_free($xml_parser);
 ?>
 ]]>
     </programlisting>
@@ -208,11 +206,9 @@ function externalEntityRefHandler($parser, $openEntityNames, $base, $systemId,
                 printf("XML error: %s at line %d while parsing entity %s\n",
                        xml_error_string(xml_get_error_code($parser)),
                        xml_get_current_line_number($parser), $openEntityNames);
-                xml_parser_free($parser);
                 return false;
             }
         }
-        xml_parser_free($parser);
         return true;
     }
     return false;
@@ -254,7 +250,6 @@ while ($data = fread($fp, 4096)) {
 }
 echo "</pre>";
 echo "parse complete\n";
-xml_parser_free($xml_parser);
 
 ?>
 ]]>
@@ -419,4 +414,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-

reference/xml/functions/xml-parse-into-struct.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 18aa2012f6fa1e5b09733147e02911d16e06d4a1 Maintainer: class007 Status: ready -->
+<!-- EN-Revision: 00a8ae0c879a70f4bc96a707212482f0fcbd9ac6 Maintainer: class007 Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.xml-parse-into-struct" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -99,7 +99,6 @@
 $simple = "<para><note>simple note</note></para>";
 $p = xml_parser_create();
 xml_parse_into_struct($p, $simple, $vals, $index);
-xml_parser_free($p);
 echo "Index array\n";
 print_r($index);
 echo "\nVals array\n";
@@ -215,7 +214,7 @@ function readDatabase($filename)
     xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
     xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1);
     xml_parse_into_struct($parser, $data, $values, $tags);
-    xml_parser_free($parser);
+    unset($parser);
 
     // loop through the structures
     foreach ($tags as $key=>$val) {

reference/xml/functions/xml-parse.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 00a8ae0c879a70f4bc96a707212482f0fcbd9ac6 Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.xml-parse" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -109,7 +109,6 @@ while (($data = fread($stream, 16384))) {
     xml_parse($parser, $data); // parse the current chunk
 }
 xml_parse($parser, '', true); // finalize parsing
-xml_parser_free($parser);
 fclose($stream);
 ]]>
    </programlisting>

reference/xml/functions/xml-parser-create-ns.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f9c4a68ef4f89e51e6d9b905ad3ddb6492386dd3 Maintainer: class007 Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: 00a8ae0c879a70f4bc96a707212482f0fcbd9ac6 Maintainer: class007 Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.xml-parser-create-ns" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>xml_parser_create_ns</refname>
@@ -85,7 +85,6 @@
   <para>
    <simplelist>
     <member><function>xml_parser_create</function></member>
-    <member><function>xml_parser_free</function></member>
    </simplelist>
   </para>
  </refsect1>

reference/xml/functions/xml-parser-create.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8cdc6621f9826d04abc3e50438c010804d7e8683 Maintainer: class007 Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: 00a8ae0c879a70f4bc96a707212482f0fcbd9ac6 Maintainer: class007 Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.xml-parser-create" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>xml_parser_create</refname>
@@ -76,7 +76,6 @@
   <para>
    <simplelist>
     <member><function>xml_parser_create_ns</function></member>
-    <member><function>xml_parser_free</function></member>
    </simplelist>
   </para>
  </refsect1>

reference/xml/functions/xml-parser-free.xml

@@ -1,16 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 52dc204a77076e1404257cf39f179882b90b5780 Maintainer: Gregory Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: 00a8ae0c879a70f4bc96a707212482f0fcbd9ac6 Maintainer: Gregory Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.xml-parser-free" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>xml_parser_free</refname>
   <refpurpose>释放 XML 解析器</refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>xml_parser_free</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
   </methodsynopsis>
@@ -60,6 +65,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       此函数已被弃用。
+      </entry>
+     </row>
       &xml.changelog.parser-param;
     </tbody>
    </tgroup>