From 92927dc7f06b676254d5b6ab62f463d01809843f Mon Sep 17 00:00:00 2001
From: Enrique Garcia Briones <baoengb@php.net>
Date: Wed, 16 Jun 2004 21:35:43 +0000
Subject: [PATCH] give more presentation :)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@161539 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/bzip2/functions/bzclose.xml      |  9 ++++++---
 reference/bzip2/functions/bzcompress.xml   | 15 +++++++++------
 reference/bzip2/functions/bzdecompress.xml | 15 +++++++++------
 reference/bzip2/functions/bzerrno.xml      |  8 ++++++--
 reference/bzip2/functions/bzerror.xml      | 16 ++++++++++------
 reference/bzip2/functions/bzerrstr.xml     |  8 ++++++--
 reference/bzip2/functions/bzflush.xml      | 11 +++++++++--
 reference/bzip2/functions/bzopen.xml       | 18 ++++++++++++------
 reference/bzip2/functions/bzread.xml       | 19 +++++++++++--------
 reference/bzip2/functions/bzwrite.xml      | 16 ++++++++++------
 10 files changed, 88 insertions(+), 47 deletions(-)

diff --git a/reference/bzip2/functions/bzclose.xml b/reference/bzip2/functions/bzclose.xml
index 54763a4c71..94fecc5552 100644
--- a/reference/bzip2/functions/bzclose.xml
+++ b/reference/bzip2/functions/bzclose.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzclose">
    <refnamediv>
     <refname>bzclose</refname>
-    <refpurpose>Close a bzip2 file pointer</refpurpose>
+    <refpurpose>Close a bzip2 file</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -22,8 +22,11 @@
      The file pointer must be valid, and must point to a file
      successfully opened by <function>bzopen</function>.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>bzopen</function>.
+     <function>bzopen</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/bzip2/functions/bzcompress.xml b/reference/bzip2/functions/bzcompress.xml
index b1b246728c..ecf9039f93 100644
--- a/reference/bzip2/functions/bzcompress.xml
+++ b/reference/bzip2/functions/bzcompress.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzcompress">
    <refnamediv>
@@ -34,9 +34,16 @@
      value. Regardless of the <parameter>workfactor</parameter>, the
      generated output is the same.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
+     <function>bzdecompress</function>.
+    </para>
+   </refsect1>
+   <refsect1>
+    <title>Example</title>
      <example>
-      <title><function>bzcompress</function> Example</title>
       <programlisting role="php">
 <![CDATA[
 <?php
@@ -47,10 +54,6 @@ echo $bzstr;
 ]]>
       </programlisting>
      </example>
-    </para>
-    <para>
-     See also <function>bzdecompress</function>.
-    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/bzip2/functions/bzdecompress.xml b/reference/bzip2/functions/bzdecompress.xml
index c0ed495e35..e7f439ca33 100644
--- a/reference/bzip2/functions/bzdecompress.xml
+++ b/reference/bzip2/functions/bzdecompress.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzdecompress">
    <refnamediv>
@@ -23,9 +23,16 @@
      roughly half the speed.  See the <ulink url="&url.bzip2;">bzip2
      documentation</ulink> for more information about this feature.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
+     <function>bzcompress</function>.
+    </para>
+   </refsect1>
+   <refsect1>
+    <title>Example</title>
      <example>
-      <title><function>bzdecompress</function></title>
       <programlisting role="php">
 <![CDATA[
 <?php
@@ -44,10 +51,6 @@ echo "\n<br />\n";
 ]]>
       </programlisting>
      </example>
-    </para>
-    <para>
-     See also <function>bzcompress</function>.
-    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/bzip2/functions/bzerrno.xml b/reference/bzip2/functions/bzerrno.xml
index faa0e775e7..6b38a6ed20 100644
--- a/reference/bzip2/functions/bzerrno.xml
+++ b/reference/bzip2/functions/bzerrno.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzerrno">
    <refnamediv>
@@ -16,8 +16,12 @@
      Returns the error number of any bzip2 error returned by the file
      pointer <parameter>bz</parameter>.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>bzerror</function> and <function>bzerrstr</function>.
+     <function>bzerror</function>, 
+     <function>bzerrstr</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/bzip2/functions/bzerror.xml b/reference/bzip2/functions/bzerror.xml
index 3790a889cd..efee86ad98 100644
--- a/reference/bzip2/functions/bzerror.xml
+++ b/reference/bzip2/functions/bzerror.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzerror">
    <refnamediv>
@@ -17,9 +17,17 @@
      of any bzip2 error returned by the file pointer
      <parameter>bz</parameter>.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
+     <function>bzerrno</function>, 
+     <function>bzerrstr</function>.
+    </para>
+   </refsect1>
+   <refsect1>
+    <title>Example</title>
      <example>
-      <title><function>bzerror</function> Example</title>
       <programlisting role="php">
 <![CDATA[
 <?php
@@ -31,10 +39,6 @@ echo $error["errstr"];
 ]]>
       </programlisting>
      </example>
-    </para>
-    <para>
-     See also <function>bzerrno</function> and <function>bzerrstr</function>.
-    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/bzip2/functions/bzerrstr.xml b/reference/bzip2/functions/bzerrstr.xml
index e3f0ee99f0..5351618b76 100644
--- a/reference/bzip2/functions/bzerrstr.xml
+++ b/reference/bzip2/functions/bzerrstr.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzerrstr">
    <refnamediv>
@@ -16,8 +16,12 @@
      Returns the error string of any bzip2 error returned by the file
      pointer <parameter>bz</parameter>.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>bzerrno</function> and <function>bzerror</function>.
+     <function>bzerrno</function>, 
+     <function>bzerror</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/bzip2/functions/bzflush.xml b/reference/bzip2/functions/bzflush.xml
index 40ff387ab4..cee4d5e960 100644
--- a/reference/bzip2/functions/bzflush.xml
+++ b/reference/bzip2/functions/bzflush.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzflush">
    <refnamediv>
@@ -16,11 +16,18 @@
      Forces a write of all buffered bzip2 data for the file pointer
      <parameter>bz</parameter>.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.returnvalues;
     <para>
      &return.success;
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>bzread</function> and <function>bzwrite</function>.
+     <function>bzread</function>, 
+     <function>bzwrite</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/bzip2/functions/bzopen.xml b/reference/bzip2/functions/bzopen.xml
index 22663831b0..ddca259e0f 100644
--- a/reference/bzip2/functions/bzopen.xml
+++ b/reference/bzip2/functions/bzopen.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzopen">
    <refnamediv>
@@ -19,13 +19,23 @@
      open. <parameter>mode</parameter> is similar to the
      <function>fopen</function> function (`r' for read, `w' for write, etc.).
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.returnvalues;
     <para>
      If the open fails, <function>bzopen</function> returns &false;, otherwise it
      returns a pointer to the newly opened file.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
+     <function>bzclose</function>.
+    </para>
+   </refsect1>
+   <refsect1>
+    <title>Example</title>
      <example>
-      <title><function>bzopen</function> Example</title>
       <programlisting role="php">
 <![CDATA[
 <?php
@@ -39,10 +49,6 @@ bzclose($bz);
 ]]>
       </programlisting>
      </example>
-    </para>
-    <para>
-     See also <function>bzclose</function>.
-    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/bzip2/functions/bzread.xml b/reference/bzip2/functions/bzread.xml
index b21e3b7399..aa5dea7596 100644
--- a/reference/bzip2/functions/bzread.xml
+++ b/reference/bzip2/functions/bzread.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzread">
    <refnamediv>
@@ -23,9 +23,18 @@
      <function>bzread</function> will read 1024 (uncompressed) bytes
      at a time.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
+     <function>bzwrite</function>, 
+     <function>feof</function>, 
+     <function>bzopen</function>.
+    </para>
+   </refsect1>
+   <refsect1>
+    <title>Example</title>
      <example>
-      <title><function>bzread</function> Example</title>
       <programlisting role="php">
 <![CDATA[
 <?php
@@ -46,12 +55,6 @@ echo $decompressed_file;
 ]]>
       </programlisting>
      </example>
-    </para>
-    <para>
-     See also <function>bzwrite</function>,
-     <function>feof</function>, and
-     <function>bzopen</function>.
-    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/bzip2/functions/bzwrite.xml b/reference/bzip2/functions/bzwrite.xml
index 0ffedff0e7..ae693ac9f5 100644
--- a/reference/bzip2/functions/bzwrite.xml
+++ b/reference/bzip2/functions/bzwrite.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/bzip2.xml, last change in rev 1.1 -->
   <refentry id="function.bzwrite">
    <refnamediv>
@@ -22,9 +22,17 @@
      after length (uncompressed) bytes have been written or the end of
      string is reached, whichever comes first.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
+     <function>bzread</function>, 
+     <function>bzopen</function>.
+    </para>
+   </refsect1>
+   <refsect1>
+   <title>Example</title>
      <example>
-      <title><function>bzwrite</function> Example</title>
       <programlisting role="php">
 <![CDATA[
 <?php
@@ -36,10 +44,6 @@ bzclose($bz);
 ]]>
       </programlisting> 
      </example>
-    </para>
-    <para>
-     See also <function>bzread</function> and <function>bzopen</function>.
-    </para>
    </refsect1>
   </refentry>