> Look into howto/working.xml for a suggested version of marking see also
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>
+    &note.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>
-    &note.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>

Reply via email to