[PHP-DOC] cvs: phpdoc /howto working.xml

[Jakub Vrana]

vrana           Mon Apr 11 04:55:24 2005 EDT

  Modified files:              
    /phpdoc/howto       working.xml 
  Log:
  Promote scripts for translators
  
http://cvs.php.net/diff.php/phpdoc/howto/working.xml?r1=1.54&r2=1.55&ty=u
Index: phpdoc/howto/working.xml
diff -u phpdoc/howto/working.xml:1.54 phpdoc/howto/working.xml:1.55
--- phpdoc/howto/working.xml:1.54       Mon Apr 11 04:42:30 2005
+++ phpdoc/howto/working.xml    Mon Apr 11 04:55:22 2005
@@ -494,7 +494,7 @@
     <title>A function skeleton (<filename>func-name.xml</filename>)</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.54 $ --&gt;
+&lt;!-- $Revision: 1.55 $ --&gt;
 &lt;refentry id="function.func-name"&gt;
  &lt;refnamediv&gt;
   &lt;refname&gt;func_name&lt;/refname&gt;
@@ -653,7 +653,7 @@
     <title>A <filename>reference.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.54 $ --&gt;
+&lt;!-- $Revision: 1.55 $ --&gt;
 &lt;reference id="ref.extname"&gt;
  &lt;title&gt;Extname &amp;Functions;&lt;/title&gt;
  &lt;titleabbrev&gt;Extname&lt;/titleabbrev&gt;
@@ -720,7 +720,7 @@
     <title>A <filename>configure.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.54 $ --&gt;
+&lt;!-- $Revision: 1.55 $ --&gt;
 &lt;section id="extname.installation"&gt;
  &amp;reftitle.install;
  &lt;para&gt;
@@ -761,7 +761,7 @@
     <title>A <filename>constants.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.54 $ --&gt;
+&lt;!-- $Revision: 1.55 $ --&gt;
 &lt;section id="extname.constants"&gt;
  &amp;reftitle.constants;
  &amp;extension.constants;
@@ -811,7 +811,7 @@
     <title>A <filename>ini.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.54 $ --&gt;
+&lt;!-- $Revision: 1.55 $ --&gt;
 &lt;section id="extname.configuration"&gt;
  &amp;reftitle.runtime;
  &amp;extension.runtime;
@@ -1100,6 +1100,9 @@
     updates needed. We have two (plus one) system for tracking
     the revisions and modification dates of the files in
     <literal>phpdoc</literal>.
+    There is also a simple script to check parameters count/type/opt/reference
+    in translated <literal>&lt;methodsynopsis&gt;</literal> -
+    <filename>scripts/check-trans-params.php</filename>.
    </para>
 
    <sect2 id="translation-revcheck-translators">
@@ -1344,6 +1347,13 @@
      comments only affect the display of the translators table in
      <filename>revcheck.html.gz</filename>.
     </para>
+    
+    <para>
+     Revision comments can be used also to print a diff between the current
+     English file and the file used for the translation. Script
+     <filename>scripts/diff_en_rev.php</filename> was created for this
+     purpose.
+    </para>
    </sect2>
 
    <sect2 id="translation-revcheck-status">