goba Sun Aug 21 09:03:03 2005 EDT
Modified files:
/phpdoc/howto howto.ent working.xml
Log:
Remove refenrence to Rasmus' status script,
as it is not available anymore, and it is not used anyway
Plus add some troubleshooting information on the 'crossreference
to paragraph not supported' error.
http://cvs.php.net/diff.php/phpdoc/howto/howto.ent?r1=1.30&r2=1.31&ty=u
Index: phpdoc/howto/howto.ent
diff -u phpdoc/howto/howto.ent:1.30 phpdoc/howto/howto.ent:1.31
--- phpdoc/howto/howto.ent:1.30 Wed Apr 6 12:30:26 2005
+++ phpdoc/howto/howto.ent Sun Aug 21 09:03:02 2005
@@ -87,8 +87,6 @@
<!ENTITY url.docsubscribe "[EMAIL PROTECTED]">
<!ENTITY url.docunsubscribe "[EMAIL PROTECTED]">
<!ENTITY url.maillists "http://www.php.net/mailing-lists";>
-<!ENTITY url.status "http://toye.php.net/~rasmus/status.php";>
-<!ENTITY url.status.hu "http://toye.php.net/~rasmus/status.php?l=hu";>
<!ENTITY url.revcheck.it "http://www.php.net/it/rev";>
<!ENTITY url.user-notes
"http://cvs.php.net/co.php/php-master-web/manage/user-notes.php";>
<!ENTITY url.notes.admin "http://master.php.net/manage/user-notes.php";>
http://cvs.php.net/diff.php/phpdoc/howto/working.xml?r1=1.58&r2=1.59&ty=u
Index: phpdoc/howto/working.xml
diff -u phpdoc/howto/working.xml:1.58 phpdoc/howto/working.xml:1.59
--- phpdoc/howto/working.xml:1.58 Thu Jul 14 10:38:49 2005
+++ phpdoc/howto/working.xml Sun Aug 21 09:03:03 2005
@@ -494,7 +494,7 @@
<title>A function skeleton (<filename>func-name.xml</filename>)</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
<refentry id="function.func-name">
<refnamediv>
<refname>func_name</refname>
@@ -653,7 +653,7 @@
<title>A <filename>reference.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
<reference id="ref.extname">
<title>Extname &Functions;</title>
<titleabbrev>Extname</titleabbrev>
@@ -720,7 +720,7 @@
<title>A <filename>configure.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
<section id="extname.installation">
&reftitle.install;
<para>
@@ -761,7 +761,7 @@
<title>A <filename>constants.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
<section id="extname.constants">
&reftitle.constants;
&extension.constants;
@@ -811,7 +811,7 @@
<title>A <filename>ini.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
<section id="extname.configuration">
&reftitle.runtime;
&extension.runtime;
@@ -1077,6 +1077,21 @@
error.
</simpara>
</listitem>
+ <listitem>
+ <simpara>
+ If a documentation build process sends an error
+ report to the translation mailing list, examine
+ the problems, and try to fix them before the next
+ build. If you have 'cross reference to paragraphs
+ not supported' errors, you probably have old
+ translated files around. Since paragraphs are
+ generated by the build system for the missing ids
+ not yet in those old files, these errors are
+ inevitable. Either update your translation, or
+ remove the offending files, thus allowing the
+ English originals to take precendence.
+ </simpara>
+ </listitem>
</itemizedlist>
</para>
</sect1>
@@ -1359,36 +1374,6 @@
purpose.
</para>
</sect2>
-
- <sect2 id="translation-revcheck-status">
- <title>The Online Status Script</title>
-
- <para>
- Rasmus Lerdorf developed on online status checking script.
- This script is most useful for files without revision comments,
- so if you use the Revision comments, use the specific script
- <link linkend="translation-revcheck-comments">mentioned above</link>.
- </para>
- <para>
- You can access the script at: <ulink
url="&url.status;">&url.status;</ulink>.
- Visiting this page, you need to wait for some time to generate,
- as it builds a whole table of file and dates information about
- all translations. If you would like to restrict the table to only
- one translation, you can provide the <literal>?l=LANGCODE</literal>
- URL parameter, so to view the Hungarian status, visit:
- <ulink url="&url.status.hu;">&url.status.hu;</ulink>.
- </para>
- <para>
- This script tries to decide whether a file is up to date or not
- from the last modification date. The results are not correct if
- you modify your language's file, fixing typos, as this script thinks
- you modified the file to get in sync with the English one, and will
- mark your file as up to date. Although this script can help some
- to track files without <link
linkend="translation-revcheck-comments">revision
- comments</link>, if you use revision comments, you can get more
- accurate results than this script, and much more than that.
- </para>
- </sect2>
</sect1>
</chapter>
