From f06c0e12d8eb1e12c38e363229f536ea23566d0e Mon Sep 17 00:00:00 2001
From: Hannes Magnusson <bjori@php.net>
Date: Wed, 26 Dec 2007 13:30:44 +0000
Subject: [PATCH] MFB: Upgrade to the new-reference-structure  - (Created
 missing setup sections in setup.xml, if any)  - Moved the intro to book.xml 
 - Changed the intro ID from <extname>.intro to intro.<extname>  - Moved the
 constants entity to book.xml  - Changed constants.xml to be an appendix  -
 Moved mhash.examples into its own chapter (examples.xml)  - Moved the
 requirements, configuration and resources sections to setup.xml  - Moved the
 configure entity to setup.xml

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@248999 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mhash/book.xml      | 60 +++++++++++++++++++++++
 reference/mhash/constants.xml |  6 +--
 reference/mhash/examples.xml  | 53 ++++++++++++++++++++
 reference/mhash/reference.xml | 91 +++--------------------------------
 reference/mhash/setup.xml     | 58 ++++++++++++++++++++++
 5 files changed, 180 insertions(+), 88 deletions(-)
 create mode 100644 reference/mhash/book.xml
 create mode 100644 reference/mhash/examples.xml
 create mode 100644 reference/mhash/setup.xml

diff --git a/reference/mhash/book.xml b/reference/mhash/book.xml
new file mode 100644
index 0000000000..bf2a2fa409
--- /dev/null
+++ b/reference/mhash/book.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+<!-- Purpose: mathcrypto.crypto -->
+<!-- Membership: bundled, external -->
+ 
+<book xml:id="book.mhash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Mhash</title>
+ 
+ <!-- {{{ preface -->
+ <preface xml:id="intro.mhash">
+  &reftitle.intro;
+  <para>
+   These functions are intended to work with <link
+   xlink:href="&url.mhash;">mhash</link>. Mhash can be used to create checksums,
+   message digests, message authentication codes, and more.
+  </para>
+  <para>
+   This is an interface to the mhash library. mhash supports a wide
+   variety of hash algorithms such as MD5, SHA1, GOST, and many
+   others. For a complete list of supported hashes, refer to the
+   documentation of mhash. The general rule is that you can access
+   the hash algorithm from PHP with MHASH_HASHNAME. For example, to
+   access TIGER you use the PHP constant MHASH_TIGER.
+  </para>
+  <note>
+   <para>
+    This extension is obsoleted by <link linkend="book.hash">Hash</link>.
+   </para>
+  </note>
+ </preface>
+ <!-- }}} -->
+ 
+ &reference.mhash.setup;
+ &reference.mhash.constants;
+ &reference.mhash.examples;
+ &reference.mhash.reference;
+
+</book>
+
+<!-- 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/mhash/constants.xml b/reference/mhash/constants.xml
index ab5c5bcaa2..8d2e88e996 100644
--- a/reference/mhash/constants.xml
+++ b/reference/mhash/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<section xml:id="mhash.constants" xmlns="http://docbook.org/ns/docbook">
+<!-- $Revision: 1.5 $ -->
+<appendix xml:id="mhash.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
  <para>
@@ -90,7 +90,7 @@
    </listitem>
   </itemizedlist>
  </para>
-</section>
+</appendix>
 
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/mhash/examples.xml b/reference/mhash/examples.xml
new file mode 100644
index 0000000000..a772286f40
--- /dev/null
+++ b/reference/mhash/examples.xml
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+
+<appendix xml:id="mhash.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+ <para>
+  <example>
+   <title>Compute the MD5 digest and hmac and print it out as hex</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$input = "what do ya want for nothing?";
+$hash = mhash(MHASH_MD5, $input);
+echo "The hash is " . bin2hex($hash) . "<br />\n";
+$hash = mhash(MHASH_MD5, $input, "Jefe");
+echo "The hmac is " . bin2hex($hash) . "<br />\n";
+?>
+]]>
+   </programlisting>
+   <para>
+    This will produce:
+    <screen>
+<![CDATA[
+The hash is d03cb659cbf9192dcd066272249f8412 
+The hmac is 750c783e6ab0b503eaa86e310a5db738 
+]]>
+    </screen>
+   </para>
+  </example>
+ </para>
+</appendix>
+
+<!-- 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/mhash/reference.xml b/reference/mhash/reference.xml
index 756fad6620..59085cfb40 100644
--- a/reference/mhash/reference.xml
+++ b/reference/mhash/reference.xml
@@ -1,93 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
-<!-- Purpose: mathcrypto.crypto -->
-<!-- Membership: bundled, external -->
+<!-- $Revision: 1.12 $ -->
 
- <reference xml:id="ref.mhash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
-  <title>Mhash Functions</title>
-  <titleabbrev>mhash</titleabbrev>
-  
-  <partintro>
-   <section xml:id="mhash.intro">
-    &reftitle.intro;
-    <para>
-     These functions are intended to work with <link
-     xlink:href="&url.mhash;">mhash</link>. Mhash can be used to create checksums,
-     message digests, message authentication codes, and more.
-    </para>
-    <para>
-     This is an interface to the mhash library. mhash supports a wide
-     variety of hash algorithms such as MD5, SHA1, GOST, and many
-     others. For a complete list of supported hashes, refer to the
-     documentation of mhash. The general rule is that you can access
-     the hash algorithm from PHP with MHASH_HASHNAME. For example, to
-     access TIGER you use the PHP constant MHASH_TIGER.
-    </para>
-    <note>
-     <para>
-      &pecl.moved-ver;5.3.0.
-      This extension is obsoleted by <link linkend="ref.hash">Hash</link>.
-     </para>
-    </note>
-   </section>
+<reference xml:id="ref.mhash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Mhash &Functions;</title>
+ <titleabbrev>mhash</titleabbrev>
 
-   <section xml:id="mhash.requirements">
-    &reftitle.required;
-    <para>
-     To use it, download the mhash distribution from <link
-     xlink:href="&url.mhash;">its web site</link> and follow the included
-     installation instructions.
-    </para>
-   </section>
+ &reference.mhash.entities.functions;
 
-   &reference.mhash.configure;
+</reference> 
 
-   <section xml:id="mhash.configuration">
-    &reftitle.runtime;
-    &no.config;
-   </section>
-
-   <section xml:id="mhash.resources">
-    &reftitle.resources;
-    &no.resource;
-   </section>
-
-   &reference.mhash.constants;
-
-   <section xml:id="mhash.examples">
-    &reftitle.examples;
-    <para>
-     <example>
-      <title>Compute the MD5 digest and hmac and print it out as hex</title>
-      <programlisting role="php">
-<![CDATA[
-<?php
-$input = "what do ya want for nothing?";
-$hash = mhash(MHASH_MD5, $input);
-echo "The hash is " . bin2hex($hash) . "<br />\n";
-$hash = mhash(MHASH_MD5, $input, "Jefe");
-echo "The hmac is " . bin2hex($hash) . "<br />\n";
-?>
-]]>
-      </programlisting>
-      <para>
-       This will produce:
-       <screen>
-<![CDATA[
-The hash is d03cb659cbf9192dcd066272249f8412 
-The hmac is 750c783e6ab0b503eaa86e310a5db738 
-]]>
-       </screen>
-      </para>
-     </example>
-    </para>
-   </section>
-
-  </partintro>
-
-&reference.mhash.entities.functions;
-
- </reference> 
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/mhash/setup.xml b/reference/mhash/setup.xml
new file mode 100644
index 0000000000..9e427839d6
--- /dev/null
+++ b/reference/mhash/setup.xml
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+
+<chapter xml:id="mhash.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <!-- {{{ Requirements -->
+ <section xml:id="mhash.requirements">
+  &reftitle.required;
+  <para>
+   To use it, download the mhash distribution from <link
+   xlink:href="&url.mhash;">its web site</link> and follow the included
+   installation instructions.
+  </para>
+ </section>
+ <!-- }}} -->
+
+ <!-- {{{ Installation -->
+ &reference.mhash.configure;
+ <!-- }}} -->
+
+ <!-- {{{ Configuration -->
+ <section xml:id="mhash.configuration">
+  &reftitle.runtime;
+  &no.config;
+ </section>
+ <!-- }}} -->
+
+ <!-- {{{ Resources -->
+ <section xml:id="mhash.resources">
+  &reftitle.resources;
+  &no.resource;
+ </section>
+ <!-- }}} -->
+
+</chapter>
+
+<!-- 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
+-->
+