goba Sun Apr 3 08:22:57 2005 EDT
Modified files:
/phpdoc/howto howto.ent working.xml
Log:
document relations of cvs modules, mailing lists, subprojects, websites, one
of the frequently asked questions
http://cvs.php.net/diff.php/phpdoc/howto/howto.ent?r1=1.26&r2=1.27&ty=u
Index: phpdoc/howto/howto.ent
diff -u phpdoc/howto/howto.ent:1.26 phpdoc/howto/howto.ent:1.27
--- phpdoc/howto/howto.ent:1.26 Sun Apr 3 06:53:20 2005
+++ phpdoc/howto/howto.ent Sun Apr 3 08:22:56 2005
@@ -9,6 +9,7 @@
<!ENTITY email.jirka "[EMAIL PROTECTED]">
<!ENTITY email.jeroen "[EMAIL PROTECTED]">
<!ENTITY email.phpdoc "[email protected]">
+<!ENTITY email.lists "@lists.php.net">
<!ENTITY email.internals "[email protected]">
<!ENTITY email.group.php "[EMAIL PROTECTED]">
<!ENTITY email.systems.php "[EMAIL PROTECTED]">
@@ -23,6 +24,7 @@
<!ENTITY url.php.cvsaccount "http://www.php.net/cvs-php">
<!ENTITY url.php.anoncvs "http://www.php.net/anoncvs">
<!ENTITY url.php.docs "http://www.php.net/docs">
+<!ENTITY url.php.docs-echm "http://www.php.net/docs-echm">
<!ENTITY url.php.docdownload "http://www.php.net/get/docs">
<!ENTITY url.php.manual "http://www.php.net/manual/">
<!ENTITY url.php.manual.plain "http://www.php.net/manual/html/">
@@ -31,6 +33,7 @@
<!ENTITY url.php.news "http://php.net/php4news">
<!ENTITY url.php.howto "http://php.net/get/dochowto">
<!ENTITY url.php.howto.online "http://doc.php.net/dochowto">
+<!ENTITY url.php.docweb "http://doc.php.net/">
<!-- For DocBook section -->
<!ENTITY url.docbook "http://www.docbook.org/">
@@ -79,6 +82,7 @@
<!ENTITY url.buildlogs.fresh "http://rsync.php.net/~imajes/manual/">
<!ENTITY url.listarchive "http://marc.theaimsgroup.com/?l=phpdoc">
<!ENTITY url.listnews "news://news.php.net/php.doc">
+<!ENTITY url.newsserver "http://news.php.net/">
<!ENTITY url.listnewshttp "http://news.php.net/group.php?group=php.doc">
<!ENTITY url.docsubscribe "[EMAIL PROTECTED]">
<!ENTITY url.docunsubscribe "[EMAIL PROTECTED]">
http://cvs.php.net/diff.php/phpdoc/howto/working.xml?r1=1.50&r2=1.51&ty=u
Index: phpdoc/howto/working.xml
diff -u phpdoc/howto/working.xml:1.50 phpdoc/howto/working.xml:1.51
--- phpdoc/howto/working.xml:1.50 Fri Nov 19 06:04:11 2004
+++ phpdoc/howto/working.xml Sun Apr 3 08:22:56 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.50 $ -->
+<!-- $Revision: 1.51 $ -->
<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.50 $ -->
+<!-- $Revision: 1.51 $ -->
<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.50 $ -->
+<!-- $Revision: 1.51 $ -->
<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.50 $ -->
+<!-- $Revision: 1.51 $ -->
<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.50 $ -->
+<!-- $Revision: 1.51 $ -->
<section id="extname.configuration">
&reftitle.runtime;
&extension.runtime;
@@ -1406,7 +1406,7 @@
</chapter>
<chapter id="chapter-maillist">
- <title>The phpdoc, php-doc-chm, php-notes, doc-license and Other Mailing
Lists</title>
+ <title>Mailing Lists, Newsgroups and CVS Modules</title>
<para>
The XML content of documentation files is updated from day
@@ -1506,7 +1506,7 @@
</listitem>
<listitem>
<simpara>
- Read the messages on the web, with the experimental news interface at
+ Read the messages on the web, with the news interface at
<ulink url="&url.listnewshttp;">&url.listnewshttp;</ulink>.
</simpara>
</listitem>
@@ -1544,9 +1544,344 @@
list with the usual way (you can find out from the info above).
</para>
<para>
- Finnaly, the upcoming doc.php.net site is forming on the
<literal>doc-web</literal>
- mailing list. This site will be the meeting point for documentation authors
- of any of the projects developed on PHP.net.
+ Finnaly, the doc.php.net site is forming on the <literal>doc-web</literal>
+ mailing list. This site is supposed to be the meeting point for
documentation
+ authors of any of the projects developed on PHP.net.
+ </para>
+ <para>
+ The following table documents the relations between the different CVS
modules,
+ websites, mailing lists and newsgroups. Note that not all documentation
sources
+ are built to be available online.
+ <table>
+ <title>CVS Modules, Mailing lists and Newsgroups</title>
+ <tgroup cols="5">
+ <thead>
+ <row>
+ <entry>Project Name</entry>
+ <entry>CVS Locations</entry>
+ <entry>Mailing List</entry>
+ <entry>Newsgroup</entry>
+ <entry>On the web</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>PHP Documentation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc/">phpdoc</ulink>,
+ <ulink url="&url.php.cvs;livedocs/">livedocs</ulink>,
+ <ulink url="&url.php.cvs;peardoc/en/pecl/">peardoc/en/pecl</ulink>
+ </entry>
+ <entry><ulink url="mailto:&email.phpdoc;">phpdoc</ulink></entry>
+ <entry><ulink url="&url.newsserver;php.doc">php.doc</ulink></entry>
+ <entry><ulink url="&url.php.manual;en/">manual/en</ulink></entry>
+ </row>
+ <row>
+ <entry>PHP Documentation Licensing</entry>
+ <entry>N/A</entry>
+ <entry><ulink
url="mailto:doc-license&email.lists;">doc-license</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.license">php.doc.license</ulink></entry>
+ <entry>N/A</entry>
+ </row>
+ <row>
+ <entry>Extended CHM PHP Documentation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc/htmlhelp/">phpdoc/htmlhelp</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-chm&email.lists;">doc-chm</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.chm">php.doc.chm</ulink></entry>
+ <entry><ulink
url="&url.php.docs-echm;">&url.php.docs-echm;</ulink></entry>
+ </row>
+ <row>
+ <entry>PHP Documentation Website</entry>
+ <entry>
+ <ulink url="&url.php.cvs;docweb/">docweb</ulink>,
+ <ulink url="&url.php.cvs;funclist/">funclist</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-web&email.lists;">doc-web</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.web">php.doc.web</ulink></entry>
+ <entry><ulink url="&url.php.docweb;">&url.php.docweb;</ulink></entry>
+ </row>
+ <row>
+ <entry>Documentation User Notes</entry>
+ <entry>N/A</entry>
+ <entry><ulink
url="mailto:php-notes&email.lists;">php-notes</ulink></entry>
+ <entry><ulink url="&url.newsserver;php.notes">php.notes</ulink></entry>
+ <entry>N/A</entry>
+ </row>
+ <row>
+ <entry>Arabic translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-ar/">phpdoc-ar</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-ar&email.lists;">doc-ar</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.ar">php.doc.ar</ulink></entry>
+ <entry><ulink url="&url.php.manual;ar/">manual/ar</ulink></entry>
+ </row>
+ <row>
+ <entry>Belgian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-bg/">phpdoc-bg</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-bg&email.lists;">doc-bg</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.bg">php.doc.bg</ulink></entry>
+ <entry><ulink url="&url.php.manual;bg/">manual/bg</ulink></entry>
+ </row>
+ <row>
+ <entry>Czech translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-cs/">phpdoc-cs</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-cs&email.lists;">doc-cs</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.cs">php.doc.cs</ulink></entry>
+ <entry><ulink url="&url.php.manual;cs/">manual/cs</ulink></entry>
+ </row>
+ <row>
+ <entry>Danish translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-da/">phpdoc-da</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-da&email.lists;">doc-da</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.da">php.doc.da</ulink></entry>
+ <entry><ulink url="&url.php.manual;da/">manual/da</ulink></entry>
+ </row>
+ <row>
+ <entry>German translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-de/">phpdoc-de</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-de&email.lists;">doc-de</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.de">php.doc.de</ulink></entry>
+ <entry><ulink url="&url.php.manual;de/">manual/de</ulink></entry>
+ </row>
+ <row>
+ <entry>Greek translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-el/">phpdoc-el</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-el&email.lists;">doc-el</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.el">php.doc.el</ulink></entry>
+ <entry><ulink url="&url.php.manual;el/">manual/el</ulink></entry>
+ </row>
+ <row>
+ <entry>Spanish translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-es/">phpdoc-es</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-es&email.lists;">doc-es</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.es">php.doc.es</ulink></entry>
+ <entry><ulink url="&url.php.manual;es/">manual/es</ulink></entry>
+ </row>
+ <row>
+ <entry>Persian (Farsi) translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-fa_IR/">phpdoc-fa_IR</ulink>
+ </entry>
+ <entry><ulink
url="mailto:doc-fa-ir&email.lists;">doc-fa-ir</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.fa-ir">php.doc.fa-ir</ulink></entry>
+ <entry><ulink url="&url.php.manual;fa_IR/">manual/fa_IR</ulink></entry>
+ </row>
+ <row>
+ <entry>Finnish translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-fi/">phpdoc-fi</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-fi&email.lists;">doc-fi</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.fi">php.doc.fi</ulink></entry>
+ <entry><ulink url="&url.php.manual;fi/">manual/fi</ulink></entry>
+ </row>
+ <row>
+ <entry>French translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-fr/">phpdoc-fr</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-fr&email.lists;">doc-fr</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.fr">php.doc.fr</ulink></entry>
+ <entry><ulink url="&url.php.manual;fr/">manual/fr</ulink></entry>
+ </row>
+ <row>
+ <entry>Hebrew translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-he/">phpdoc-he</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-he&email.lists;">doc-he</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.he">php.doc.he</ulink></entry>
+ <entry><ulink url="&url.php.manual;he/">manual/he</ulink></entry>
+ </row>
+ <row>
+ <entry>Chinese (Hong Kong Cantonese) translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-hk/">phpdoc-hk</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-hk&email.lists;">doc-hk</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.hk">php.doc.hk</ulink></entry>
+ <entry><ulink url="&url.php.manual;hk/">manual/hk</ulink></entry>
+ </row>
+ <row>
+ <entry>Hungarian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-hu/">phpdoc-hu</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-hu&email.lists;">doc-hu</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.hu">php.doc.hu</ulink></entry>
+ <entry><ulink url="&url.php.manual;hu/">manual/hu</ulink></entry>
+ </row>
+ <row>
+ <entry>Indonesian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-id/">phpdoc-id</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-id&email.lists;">doc-id</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.id">php.doc.id</ulink></entry>
+ <entry><ulink url="&url.php.manual;id/">manual/id</ulink></entry>
+ </row>
+ <row>
+ <entry>Italian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-it/">phpdoc-it</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-it&email.lists;">doc-it</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.it">php.doc.it</ulink></entry>
+ <entry><ulink url="&url.php.manual;it/">manual/it</ulink></entry>
+ </row>
+ <row>
+ <entry>Japanese translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-ja/">phpdoc-ja</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-ja&email.lists;">doc-ja</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.ja">php.doc.ja</ulink></entry>
+ <entry><ulink url="&url.php.manual;ja/">manual/ja</ulink></entry>
+ </row>
+ <row>
+ <entry>Korean translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-kr/">phpdoc-kr</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-kr&email.lists;">doc-kr</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.kr">php.doc.kr</ulink></entry>
+ <entry><ulink url="&url.php.manual;kr/">manual/kr</ulink></entry>
+ </row>
+ <row>
+ <entry>Lithuanian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-lt/">phpdoc-lt</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-lt&email.lists;">doc-lt</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.lt">php.doc.lt</ulink></entry>
+ <entry><ulink url="&url.php.manual;lt/">manual/lt</ulink></entry>
+ </row>
+ <row>
+ <entry>Dutch translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-nl/">phpdoc-nl</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-nl&email.lists;">doc-nl</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.nl">php.doc.nl</ulink></entry>
+ <entry><ulink url="&url.php.manual;nl/">manual/nl</ulink></entry>
+ </row>
+ <row>
+ <entry>Polish translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-pl/">phpdoc-pl</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-pl&email.lists;">doc-pl</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.pl">php.doc.pl</ulink></entry>
+ <entry><ulink url="&url.php.manual;pl/">manual/pl</ulink></entry>
+ </row>
+ <row>
+ <entry>Portuguese translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-pt/">phpdoc-pt</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-pt&email.lists;">doc-pt</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.pt">php.doc.pt</ulink></entry>
+ <entry><ulink url="&url.php.manual;pt/">manual/pt</ulink></entry>
+ </row>
+ <row>
+ <entry>Brazilian Portuguese translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-pt_BR/">phpdoc-pt_BR</ulink>
+ </entry>
+ <entry><ulink
url="mailto:doc-pt-br&email.lists;">doc-pt-br</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.pt-br">php.doc.pt-br</ulink></entry>
+ <entry><ulink url="&url.php.manual;pt_BR/">manual/pt_BR</ulink></entry>
+ </row>
+ <row>
+ <entry>Romanian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-ro/">phpdoc-ro</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-ro&email.lists;">doc-ro</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.ro">php.doc.ro</ulink></entry>
+ <entry><ulink url="&url.php.manual;ro/">manual/ro</ulink></entry>
+ </row>
+ <row>
+ <entry>Russian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-ru/">phpdoc-ru</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-ru&email.lists;">doc-ru</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.ru">php.doc.ru</ulink></entry>
+ <entry><ulink url="&url.php.manual;ru/">manual/ru</ulink></entry>
+ </row>
+ <row>
+ <entry>Slovak translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-sk/">phpdoc-sk</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-sk&email.lists;">doc-sk</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.sk">php.doc.sk</ulink></entry>
+ <entry><ulink url="&url.php.manual;sk/">manual/sk</ulink></entry>
+ </row>
+ <row>
+ <entry>Slovenian translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-sl/">phpdoc-sl</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-sl&email.lists;">doc-sl</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.sl">php.doc.sl</ulink></entry>
+ <entry><ulink url="&url.php.manual;sl/">manual/sl</ulink></entry>
+ </row>
+ <row>
+ <entry>Swedish translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-sv/">phpdoc-sv</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-sv&email.lists;">doc-sv</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.sv">php.doc.sv</ulink></entry>
+ <entry><ulink url="&url.php.manual;sv/">manual/sv</ulink></entry>
+ </row>
+ <row>
+ <entry>Turkish translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-tr/">phpdoc-tr</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-tr&email.lists;">doc-tr</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.tr">php.doc.tr</ulink></entry>
+ <entry><ulink url="&url.php.manual;tr/">manual/tr</ulink></entry>
+ </row>
+ <row>
+ <entry>Chinese (Traditional) translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-tw/">phpdoc-tw</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-tw&email.lists;">doc-tw</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.tw">php.doc.tw</ulink></entry>
+ <entry><ulink url="&url.php.manual;tw/">manual/tw</ulink></entry>
+ </row>
+ <row>
+ <entry>Chinese (Simplified) translation</entry>
+ <entry>
+ <ulink url="&url.php.cvs;phpdoc-zh/">phpdoc-zh</ulink>
+ </entry>
+ <entry><ulink url="mailto:doc-zh&email.lists;">doc-zh</ulink></entry>
+ <entry><ulink
url="&url.newsserver;php.doc.zh">php.doc.zh</ulink></entry>
+ <entry><ulink url="&url.php.manual;zh/">manual/zh</ulink></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
</para>
</chapter>