lists. It is a bit farther from here (using an entity for the title and for the last 'and' word), which makes the complete list language independent, and therefore easy to translate :)
Heh, I was searching for this on php.net/dochowto but didn't find nothing :) Thanks for the tip
Here's a new patch using another refsect1 for examples and introducing the new entities.
didou
Index: en/reference/xslt/functions/xslt-backend-info.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-backend-info.xml,v retrieving revision 1.2 diff -u -r1.2 xslt-backend-info.xml --- en/reference/xslt/functions/xslt-backend-info.xml 19 May 2004 20:47:51 -0000 1.2 +++ en/reference/xslt/functions/xslt-backend-info.xml 1 Aug 2004 17:10:52 -0000 @@ -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> Index: en/reference/xslt/functions/xslt-backend-name.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-backend-name.xml,v retrieving revision 1.2 diff -u -r1.2 xslt-backend-name.xml --- en/reference/xslt/functions/xslt-backend-name.xml 19 May 2004 20:47:51 -0000 1.2 +++ en/reference/xslt/functions/xslt-backend-name.xml 1 Aug 2004 17:10:52 -0000 @@ -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 @@ ?> ]]> - </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> Index: en/reference/xslt/functions/xslt-backend-version.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-backend-version.xml,v retrieving revision 1.3 diff -u -r1.3 xslt-backend-version.xml --- en/reference/xslt/functions/xslt-backend-version.xml 20 May 2004 16:22:12 -0000 1.3 +++ en/reference/xslt/functions/xslt-backend-version.xml 1 Aug 2004 17:10:52 -0000 @@ -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 @@ ?> ]]> - </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> Index: en/reference/xslt/functions/xslt-create.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-create.xml,v retrieving revision 1.8 diff -u -r1.8 xslt-create.xml --- en/reference/xslt/functions/xslt-create.xml 15 Jan 2004 12:43:47 -0000 1.8 +++ en/reference/xslt/functions/xslt-create.xml 1 Aug 2004 17:10:52 -0000 @@ -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 @@ } ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </refsect1> + <refsect1> + &reftitle.seealso; <para> - See also <function>xslt_free</function>. + <function>xslt_free</function>. </para> </refsect1> </refentry> Index: en/reference/xslt/functions/xslt-errno.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-errno.xml,v retrieving revision 1.5 diff -u -r1.5 xslt-errno.xml --- en/reference/xslt/functions/xslt-errno.xml 19 May 2004 20:47:51 -0000 1.5 +++ en/reference/xslt/functions/xslt-errno.xml 1 Aug 2004 17:08:16 -0000 @@ -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> Index: en/reference/xslt/functions/xslt-error.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-error.xml,v retrieving revision 1.6 diff -u -r1.6 xslt-error.xml --- en/reference/xslt/functions/xslt-error.xml 19 May 2004 20:47:51 -0000 1.6 +++ en/reference/xslt/functions/xslt-error.xml 1 Aug 2004 17:10:52 -0000 @@ -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 @@ 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> Index: en/reference/xslt/functions/xslt-free.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-free.xml,v retrieving revision 1.3 diff -u -r1.3 xslt-free.xml --- en/reference/xslt/functions/xslt-free.xml 18 Aug 2003 21:55:34 -0000 1.3 +++ en/reference/xslt/functions/xslt-free.xml 1 Aug 2004 17:08:16 -0000 @@ -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> Index: en/reference/xslt/functions/xslt-getopt.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-getopt.xml,v retrieving revision 1.2 diff -u -r1.2 xslt-getopt.xml --- en/reference/xslt/functions/xslt-getopt.xml 22 Jul 2004 22:23:36 -0000 1.2 +++ en/reference/xslt/functions/xslt-getopt.xml 1 Aug 2004 17:08:16 -0000 @@ -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> Index: en/reference/xslt/functions/xslt-set-error-handler.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-set-error-handler.xml,v retrieving revision 1.4 diff -u -r1.4 xslt-set-error-handler.xml --- en/reference/xslt/functions/xslt-set-error-handler.xml 30 Jul 2004 13:51:43 -0000 1.4 +++ en/reference/xslt/functions/xslt-set-error-handler.xml 1 Aug 2004 17:10:52 -0000 @@ -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 @@ ?> ]]> - </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 @@ } } ]]> - </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> Index: en/reference/xslt/functions/xslt-set-log.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-set-log.xml,v retrieving revision 1.6 diff -u -r1.6 xslt-set-log.xml --- en/reference/xslt/functions/xslt-set-log.xml 19 May 2004 18:46:47 -0000 1.6 +++ en/reference/xslt/functions/xslt-set-log.xml 1 Aug 2004 17:10:52 -0000 @@ -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> + ¬e.xslt.windows; + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Using the XSLT Logging features</title> + <programlisting role="php"> <![CDATA[ <?php @@ -61,10 +66,8 @@ xslt_free($xh); ?> ]]> - </programlisting> - </example> - </para> - ¬e.xslt.windows; + </programlisting> + </example> </refsect1> </refentry> Index: en/reference/xslt/functions/xslt-set-object.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-set-object.xml,v retrieving revision 1.2 diff -u -r1.2 xslt-set-object.xml --- en/reference/xslt/functions/xslt-set-object.xml 30 Jul 2004 13:51:43 -0000 1.2 +++ en/reference/xslt/functions/xslt-set-object.xml 1 Aug 2004 17:10:52 -0000 @@ -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 @@ ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> </refsect1> </refentry> Index: en/reference/xslt/functions/xslt-set-sax-handlers.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-set-sax-handlers.xml,v retrieving revision 1.6 diff -u -r1.6 xslt-set-sax-handlers.xml --- en/reference/xslt/functions/xslt-set-sax-handlers.xml 30 Jul 2004 13:51:43 -0000 1.6 +++ en/reference/xslt/functions/xslt-set-sax-handlers.xml 1 Aug 2004 17:10:52 -0000 @@ -154,10 +154,12 @@ 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_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 @@ ?> ]]> - </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 @@ <auteur>VIRGINIA WOOLF</auteur> </livre> ]]> - </screen> - </example> - </para> + </screen> + </example> </refsect1> </refentry> Index: en/reference/xslt/functions/xslt-setopt.xml =================================================================== RCS file: /repository/phpdoc/en/reference/xslt/functions/xslt-setopt.xml,v retrieving revision 1.3 diff -u -r1.3 xslt-setopt.xml --- en/reference/xslt/functions/xslt-setopt.xml 22 Jul 2004 22:41:55 -0000 1.3 +++ en/reference/xslt/functions/xslt-setopt.xml 1 Aug 2004 17:10:52 -0000 @@ -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 @@ ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </refsect1> + <refsect1> + &reftitle.seealso; <para> - See also: <function>xslt_getopt</function>. </para> </refsect1>