From cf7a5097a7269f7602684344d4f40c1c146383d5 Mon Sep 17 00:00:00 2001
From: Mehdi Achour <didou@php.net>
Date: Sat, 30 Dec 2006 01:26:53 +0000
Subject: [PATCH] Document DOMDocument->normalizeDocument() and remove
 DOMDocument->normalize() which never existed and never will

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@226012 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../functions/dom-domdocument-normalize.xml   | 58 -------------------
 .../dom-domdocument-normalizedocument.xml     | 40 +++++++++----
 .../dom/functions/dom-domnode-normalize.xml   |  7 ++-
 reference/dom/reference.xml                   |  4 +-
 4 files changed, 37 insertions(+), 72 deletions(-)
 delete mode 100644 reference/dom/functions/dom-domdocument-normalize.xml

diff --git a/reference/dom/functions/dom-domdocument-normalize.xml b/reference/dom/functions/dom-domdocument-normalize.xml
deleted file mode 100644
index 1000ea5350..0000000000
--- a/reference/dom/functions/dom-domdocument-normalize.xml
+++ /dev/null
@@ -1,58 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
-<refentry id="function.dom-domdocument-normalize">
- <refnamediv>
-  <refname>DOMDocument->normalize()</refname>
-  <refpurpose>
-   Normalizes the document
-  </refpurpose>
- </refnamediv>
- <refsect1 role="description">
-  &reftitle.description;
-  <classsynopsis>
-   <ooclass><classname>DOMDocument</classname></ooclass>
-   <methodsynopsis>
-    <type>void</type><methodname>normalize</methodname>
-    <void/>
-   </methodsynopsis>
-  </classsynopsis>
-  <para>
-   Normalizes the document.
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   &return.void;
-  </para>
- </refsect1>
- <refsect1 role="seealso">
-  &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><xref linkend="function.dom-domnode-normalize" /></member>
-   </simplelist>
-  </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
diff --git a/reference/dom/functions/dom-domdocument-normalizedocument.xml b/reference/dom/functions/dom-domdocument-normalizedocument.xml
index feda507b45..8c0fd98431 100644
--- a/reference/dom/functions/dom-domdocument-normalizedocument.xml
+++ b/reference/dom/functions/dom-domdocument-normalizedocument.xml
@@ -1,23 +1,43 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <refentry id="function.dom-domdocument-normalizedocument">
  <refnamediv>
-  <refname>DOMDocument::normalizeDocument</refname>
-  <refpurpose>Acts as if the document was going through a save and load cycle, putting the document in a "normal" form</refpurpose>
+  <refname>DOMDocument->normalizeDocument()</refname>
+  <refpurpose>Normalizes the document</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
-   <type>void</type><methodname>DOMDocument::normalizeDocument</methodname>
-   <void/>
-  </methodsynopsis>
+  <classsynopsis>
+   <ooclass><classname>DOMDocument</classname></ooclass>
+   <methodsynopsis>
+    <type>void</type><methodname>normalizeDocument</methodname>
+    <void/>
+   </methodsynopsis>
+  </classsynopsis>
 
   <para>
-   <ulink url="&url.dom3.spec;#core-Document3-normalizeDocument">Specification</ulink>
+   This method acts as if you saved and then loaded the document, putting the
+   document in a "normal" form.
   </para>
+ </refsect1>
+ 
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
 
-  &warn.undocumented.func;
-
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member>
+     <ulink url="&url.dom3.spec;#core-Document3-normalizeDocument">The DOM Specification</ulink>
+    </member>
+    <member><xref linkend="function.dom-domnode-normalize" /></member>
+   </simplelist>
+  </para>
  </refsect1>
 
 </refentry>
diff --git a/reference/dom/functions/dom-domnode-normalize.xml b/reference/dom/functions/dom-domnode-normalize.xml
index a8270ebd2f..9d1ed813e7 100644
--- a/reference/dom/functions/dom-domnode-normalize.xml
+++ b/reference/dom/functions/dom-domnode-normalize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry id="function.dom-domnode-normalize">
  <refnamediv>
   <refname>DOMNode->normalize()</refname>
@@ -30,7 +30,10 @@
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><xref linkend="function.dom-domdocument-normalize" /></member>
+    <member>
+     <ulink url="&url.dom3.spec;#core-ID-normalize">The DOM Specification</ulink>
+    </member>
+    <member><xref linkend="function.dom-domdocument-normalizedocument" /></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/dom/reference.xml b/reference/dom/reference.xml
index 157a8327fe..455280ffce 100644
--- a/reference/dom/reference.xml
+++ b/reference/dom/reference.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.25 $ -->
+<!-- $Revision: 1.26 $ -->
 <!-- Purpose: xml -->
 <!-- Membership: bundled, external -->
 
@@ -254,7 +254,7 @@
        <para><xref linkend='function.dom-domdocument-loadxml' /> - Load XML from a string</para>
       </listitem>
       <listitem>
-       <para><xref linkend='function.dom-domdocument-normalize' /> - Normalizes document</para>
+       <para><xref linkend='function.dom-domdocument-normalizedocument' /> - Normalizes the document</para>
       </listitem>
       <listitem>
        <para><xref linkend='function.dom-domdocument-relaxngvalidate' /> - Performs relaxNG validation on the document</para>