From d49cd8fceae6609e365e73374deb6a5e3eb198b1 Mon Sep 17 00:00:00 2001
From: Mehdi Achour <didou@php.net>
Date: Tue, 3 Aug 2004 14:33:40 +0000
Subject: [PATCH] switch to multiple refsect1

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@165083 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../xslt/functions/xslt-backend-info.xml      |  8 ++--
 .../xslt/functions/xslt-backend-name.xml      | 23 ++++++-----
 .../xslt/functions/xslt-backend-version.xml   | 23 ++++++-----
 reference/xslt/functions/xslt-create.xml      | 22 ++++++-----
 reference/xslt/functions/xslt-errno.xml       |  7 +++-
 reference/xslt/functions/xslt-error.xml       | 24 +++++++-----
 reference/xslt/functions/xslt-free.xml        |  7 +++-
 reference/xslt/functions/xslt-getopt.xml      |  6 ++-
 .../xslt/functions/xslt-set-error-handler.xml | 32 ++++++++-------
 reference/xslt/functions/xslt-set-log.xml     | 21 +++++-----
 reference/xslt/functions/xslt-set-object.xml  | 17 ++++----
 .../xslt/functions/xslt-set-sax-handlers.xml  | 39 +++++++++----------
 reference/xslt/functions/xslt-setopt.xml      | 21 +++++-----
 13 files changed, 142 insertions(+), 108 deletions(-)

diff --git a/reference/xslt/functions/xslt-backend-info.xml b/reference/xslt/functions/xslt-backend-info.xml
index 4e82fbcc75..835ac3d2ac 100755
--- a/reference/xslt/functions/xslt-backend-info.xml
+++ b/reference/xslt/functions/xslt-backend-info.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
   <refentry id="function.xslt-backend-info">
    <refnamediv>
     <refname>xslt_backend_info</refname>
@@ -18,9 +18,11 @@
      information about the compilation setting of the backend
      or an error string when no information available.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also 
-     <function>xslt_backend_name</function> and
+     <function>xslt_backend_name</function>&listendand;
      <function>xslt_backend_version</function>.
     </para>
    </refsect1>
diff --git a/reference/xslt/functions/xslt-backend-name.xml b/reference/xslt/functions/xslt-backend-name.xml
index 3c51ca0d25..9273a067d8 100755
--- a/reference/xslt/functions/xslt-backend-name.xml
+++ b/reference/xslt/functions/xslt-backend-name.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
   <refentry id="function.xslt-backend-name">
    <refnamediv>
     <refname>xslt_backend_name</refname>
@@ -17,10 +17,12 @@
      <function>xslt_backend_name</function> will always return
      <productname>Sablotron</productname>.
     </para>
-    <para>
-     <example>
-      <title><function>xslt_backend_name</function> example</title>
-      <programlisting role="php">
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title><function>xslt_backend_name</function> example</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -28,12 +30,13 @@ echo xslt_backend_name(); // Sablotron
 
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
+     </programlisting>
+    </example>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also 
-     <function>xslt_backend_info</function> and
+     <function>xslt_backend_info</function>&listendand;
      <function>xslt_backend_version</function>.
     </para>
    </refsect1>
diff --git a/reference/xslt/functions/xslt-backend-version.xml b/reference/xslt/functions/xslt-backend-version.xml
index 01c861619b..9a94c8708a 100755
--- a/reference/xslt/functions/xslt-backend-version.xml
+++ b/reference/xslt/functions/xslt-backend-version.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
   <refentry id="function.xslt-backend-version">
    <refnamediv>
     <refname>xslt_backend_version</refname>
@@ -18,10 +18,12 @@
      number of <productname>Sablotron</productname> if available, 
      &false; otherwise.
     </para>
-    <para>
-     <example>
-      <title><function>xslt_backend_version</function> example</title>
-      <programlisting role="php">
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title><function>xslt_backend_version</function> example</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -29,12 +31,13 @@ echo xslt_backend_version(); // 0.98 for example
 
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
+     </programlisting>
+    </example>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also 
-     <function>xslt_backend_name</function> and
+     <function>xslt_backend_name</function>&listendand;
      <function>xslt_backend_info</function>.
     </para>
    </refsect1>
diff --git a/reference/xslt/functions/xslt-create.xml b/reference/xslt/functions/xslt-create.xml
index 8e816e0302..9d76d83bfd 100644
--- a/reference/xslt/functions/xslt-create.xml
+++ b/reference/xslt/functions/xslt-create.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/xslt.xml, last change in rev 1.3 -->
   <refentry id="function.xslt-create">
    <refnamediv>
@@ -16,10 +16,12 @@
      Create and return a new XSLT processor resource for manipulation by the
      other XSLT functions.
     </para>
-    <para>
-     <example>
-      <title><function>xslt_create</function> example</title>
-      <programlisting role="php">
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title><function>xslt_create</function> example</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 function xml2html($xmldata, $xsl) 
@@ -42,11 +44,13 @@ function xml2html($xmldata, $xsl)
 }            
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
+     </programlisting>
+    </example>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>xslt_free</function>.
+     <function>xslt_free</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/xslt/functions/xslt-errno.xml b/reference/xslt/functions/xslt-errno.xml
index 8389955a69..3e432f9bee 100644
--- a/reference/xslt/functions/xslt-errno.xml
+++ b/reference/xslt/functions/xslt-errno.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/xslt.xml, last change in rev 1.3 -->
   <refentry id="function.xslt-errno">
    <refnamediv>
@@ -16,8 +16,11 @@
      Returns an error code describing the last error that occurred on the 
      passed XSLT processor.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>xslt_error</function>.
+     <function>xslt_error</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/xslt/functions/xslt-error.xml b/reference/xslt/functions/xslt-error.xml
index f4ad3dd5be..9036cb8c8b 100644
--- a/reference/xslt/functions/xslt-error.xml
+++ b/reference/xslt/functions/xslt-error.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <!-- splitted from ./en/functions/xslt.xml, last change in rev 1.3 -->
   <refentry id="function.xslt-error">
    <refnamediv>
@@ -16,13 +16,15 @@
      Returns a string describing the last error that occurred on the 
      passed XSLT processor.
     </para>
-    <para>
-     <example>
-      <title>
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title>
       Handling errors using the <function>xslt_error</function> and 
       <function>xslt_errno</function> functions.
-      </title>
-      <programlisting role="php">
+     </title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -38,11 +40,13 @@ echo $result;
 xslt_free($xh);
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
+     </programlisting>
+    </example>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>xslt_errno</function>.
+     <function>xslt_errno</function>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/xslt/functions/xslt-free.xml b/reference/xslt/functions/xslt-free.xml
index 42b3a31d3f..d402ca57ac 100644
--- a/reference/xslt/functions/xslt-free.xml
+++ b/reference/xslt/functions/xslt-free.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/xslt.xml, last change in rev 1.3 -->
   <refentry id="function.xslt-free">
    <refnamediv>
@@ -15,8 +15,11 @@
     <para>
      Free the XSLT processor identified by the given handle.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>xslt_create</function>
+     <function>xslt_create</function>
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/xslt/functions/xslt-getopt.xml b/reference/xslt/functions/xslt-getopt.xml
index 2d3e6353f6..0f90a2ac6c 100755
--- a/reference/xslt/functions/xslt-getopt.xml
+++ b/reference/xslt/functions/xslt-getopt.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
   <refentry id="function.xslt-getopt">
    <refnamediv>
     <refname>xslt_getopt</refname>
@@ -17,8 +17,10 @@
      <function>xslt_getopt</function> returns the options on the given 
      <parameter>processor</parameter>.
     </para>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also:
      <function>xslt_setopt</function>.
     </para>
    </refsect1>
diff --git a/reference/xslt/functions/xslt-set-error-handler.xml b/reference/xslt/functions/xslt-set-error-handler.xml
index 4f9a6f85cb..ea8beb2c9b 100644
--- a/reference/xslt/functions/xslt-set-error-handler.xml
+++ b/reference/xslt/functions/xslt-set-error-handler.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/xslt.xml, last change in rev 1.1 -->
   <refentry id="function.xslt-set-error-handler">
    <refnamediv>
@@ -31,10 +31,12 @@
       <methodparam><type>array</type><parameter>messages</parameter></methodparam>
      </methodsynopsis>
     </para>
-    <para>
-     <example>
-      <title><function>xslt_set_error_handler</function> Example</title>
-      <programlisting role="php">
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title><function>xslt_set_error_handler</function> Example</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -68,11 +70,11 @@ echo xslt_process($xh, 'arg:/_xml', 'arg:/_xsl',
 
 ?>
 ]]>
-      </programlisting>
-      <para>
-       This example will output something similar to:
-      </para>
-      <screen>
+     </programlisting>
+     <para>
+      This example will output something similar to:
+     </para>
+     <screen>
 <![CDATA[
 array(4) {
   [0]=>
@@ -98,11 +100,13 @@ array(4) {
   }
 }
 ]]>
-      </screen>
-     </example>
-    </para>
+     </screen>
+    </example>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also <function>xslt_set_object</function> if you want to use an
+     <function>xslt_set_object</function> if you want to use an
      object method as handler.
     </para>
    </refsect1>
diff --git a/reference/xslt/functions/xslt-set-log.xml b/reference/xslt/functions/xslt-set-log.xml
index 5aee8dfe84..7f688dc1ef 100644
--- a/reference/xslt/functions/xslt-set-log.xml
+++ b/reference/xslt/functions/xslt-set-log.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <!-- splitted from ./en/functions/xslt.xml, last change in rev 1.3 -->
   <refentry id="function.xslt-set-log">
    <refnamediv>
@@ -44,10 +44,15 @@
      By default logging is disabled, in order to enable logging you must 
      first call <function>xslt_set_log</function> with a boolean parameter 
      which enables logging, then if you want to set the log file to debug to,
-     you must then pass it a string containing the filename:
-     <example>
-      <title>Using the XSLT Logging features</title>
-      <programlisting role="php">
+     you must then pass it a string containing the filename.
+    </para>
+    &note.xslt.windows;
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title>Using the XSLT Logging features</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -61,10 +66,8 @@ echo $result;
 xslt_free($xh);
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
-    &note.xslt.windows;
+     </programlisting>
+    </example>
    </refsect1>
   </refentry>
 
diff --git a/reference/xslt/functions/xslt-set-object.xml b/reference/xslt/functions/xslt-set-object.xml
index 121f7db95d..13e766a7a8 100755
--- a/reference/xslt/functions/xslt-set-object.xml
+++ b/reference/xslt/functions/xslt-set-object.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
   <refentry id="function.xslt-set-object">
    <refnamediv>
     <refname>xslt_set_object</refname>
@@ -26,10 +26,12 @@
      <function>xslt_set_error_handler</function> and are assumed to be methods
      of <parameter>object</parameter>.
     </para>
-    <para>
-     <example>
-      <title>Using your own error handler as a method</title>
-      <programlisting role="php">
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title>Using your own error handler as a method</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -57,9 +59,8 @@ class my_xslt_processor {
 
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
+     </programlisting>
+    </example>
    </refsect1>
   </refentry>
 
diff --git a/reference/xslt/functions/xslt-set-sax-handlers.xml b/reference/xslt/functions/xslt-set-sax-handlers.xml
index 203c3c94aa..9404e5e7a9 100644
--- a/reference/xslt/functions/xslt-set-sax-handlers.xml
+++ b/reference/xslt/functions/xslt-set-sax-handlers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <!-- splitted from ./en/functions/xslt.xml, last change in rev 1.29 -->
   <refentry id='function.xslt-set-sax-handlers'>
    <refnamediv>
@@ -154,10 +154,12 @@ $handlers = array(
      running a SAX parser like <function>xml_parse</function> on the result of an 
      <function>xslt_process</function> transformation.
     </para>
-    <para>
-     <example>
-      <title><function>xslt_set_sax_handlers</function> Example</title>
-      <programlisting role="php">
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title><function>xslt_set_sax_handlers</function> Example</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 // From ohlesbeauxjours at yahoo dot fr
@@ -233,17 +235,15 @@ xslt_process($xh, 'arg:/_xml', 'arg:/_xsl', NULL, array("/_xml"=>$xml, "/_xsl"=>
 xslt_free($xh);
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
+     </programlisting>
+    </example>
     <para>
      You can also use <function>xslt_set_object</function> if you want to
      implement your handlers in an object.
     </para>
-    <para>
-     <example>
-      <title>Object oriented handler</title>
-      <programlisting role="php">
+    <example>
+     <title>Object oriented handler</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 // This is the object oriented version of the previous example
@@ -314,11 +314,11 @@ $exec = new data_sax_handler($xml, $xsl);
 
 ?>
 ]]>
-      </programlisting>
-      <para>
-       Both examples will output:
-      </para>
-      <screen role="xml">
+     </programlisting>
+     <para>
+      Both examples will output:
+     </para>
+     <screen role="xml">
 <![CDATA[
 <livre>
    <auteur>GUSTAVE FLAUBERT</auteur>
@@ -327,9 +327,8 @@ $exec = new data_sax_handler($xml, $xsl);
    <auteur>VIRGINIA WOOLF</auteur>
 </livre>
 ]]>
-      </screen>
-     </example> 
-    </para>
+     </screen>
+    </example> 
    </refsect1>
   </refentry>
 
diff --git a/reference/xslt/functions/xslt-setopt.xml b/reference/xslt/functions/xslt-setopt.xml
index 4c266d6824..048799e7a7 100755
--- a/reference/xslt/functions/xslt-setopt.xml
+++ b/reference/xslt/functions/xslt-setopt.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
   <refentry id="function.xslt-setopt">
    <refnamediv>
     <refname>xslt_setopt</refname>
@@ -49,10 +49,12 @@
       </listitem>
      </itemizedlist>
     </para>
-    <para>
-     <example>
-      <title><function>xslt_setopt</function> Example</title>
-      <programlisting role="php">
+   </refsect1>
+   <refsect1>
+    &reftitle.examples;
+    <example>
+     <title><function>xslt_setopt</function> Example</title>
+     <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -66,11 +68,12 @@ xslt_setopt($xh, xslt_getopt($xh) | XSLT_SABOPT_PARSE_PUBLIC_ENTITIES);
 
 ?>
 ]]>
-      </programlisting>     
-     </example>
-    </para>
+     </programlisting>     
+    </example>
+   </refsect1>
+   <refsect1>
+    &reftitle.seealso;
     <para>
-     See also:
      <function>xslt_getopt</function>.
     </para>
    </refsect1>