goba Sun Aug 21 08:38:06 2005 EDT
Added files:
/phpdoc/en extensions.ent
Modified files:
/phpdoc manual.xml.in
/phpdoc/en/appendices extensions.xml
Log:
split up extensions.xml to extensions.xml and extensions.ent, so that the
extension categorization will be language neutral, and will be automatically up
to date in all languages (next step is to generate the extensions.xml file in
configure time with collecting flags from reference.xml files, TBD)
http://cvs.php.net/diff.php/phpdoc/manual.xml.in?r1=1.206&r2=1.207&ty=u
Index: phpdoc/manual.xml.in
diff -u phpdoc/manual.xml.in:1.206 phpdoc/manual.xml.in:1.207
--- phpdoc/manual.xml.in:1.206 Sun Jul 24 16:09:24 2005
+++ phpdoc/manual.xml.in Sun Aug 21 08:38:04 2005
@@ -2,22 +2,26 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"@srcdir@/dtds/dbxml-4.1.2/docbookx.dtd" [
-<!-- $Revision: 1.206 $ -->
+<!-- $Revision: 1.207 $ -->
<!-- Add translated specific definitions and snippets -->
<!ENTITY % language-defs SYSTEM "@srcdir@/@LANGDIR@/language-defs.ent">
<!ENTITY % language-snippets SYSTEM "@srcdir@/@LANGDIR@/language-snippets.ent">
+<!ENTITY % extensions SYSTEM "@srcdir@/@LANGDIR@/extensions.ent">
<!ENTITY % language-livedocs SYSTEM "@srcdir@/@LANGDIR@/livedocs.ent">
%language-defs;
%language-snippets;
+%extensions;
<!-- Fallback to English definitions and snippets (in case of missing
translation) -->
<!ENTITY % language-defs.default SYSTEM "@srcdir@/en/language-defs.ent">
<!ENTITY % language-snippets.default SYSTEM
"@srcdir@/en/language-snippets.ent">
+<!ENTITY % extensions.default SYSTEM "@srcdir@/en/extensions.ent">
%language-defs.default;
%language-snippets.default;
+%extensions.default;
<!-- phpweb entities - autogenerated! -->
<!ENTITY % phpweb.entities SYSTEM "entities/phpweb.ent">
http://cvs.php.net/diff.php/phpdoc/en/appendices/extensions.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/appendices/extensions.xml
diff -u phpdoc/en/appendices/extensions.xml:1.3
phpdoc/en/appendices/extensions.xml:1.4
--- phpdoc/en/appendices/extensions.xml:1.3 Fri Aug 19 11:00:54 2005
+++ phpdoc/en/appendices/extensions.xml Sun Aug 21 08:38:06 2005
@@ -1,22 +1,23 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
-
-<appendix id="extensions">
- <title>Extension Categorization</title>
- <para>
- This appendix categorizes more than 150 extensions documented in the PHP
manual by several criteria.
- </para>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.4 $ -->
+<!--
+ DO NOT TRANSLATE THIS FILE! All the content that is displayed
+ on the extension categorization page in your translated manual
+ can be translated in extensions.ent
+-->
+<appendix id="extensions">
+ &extcat.intro;
<section id="extensions.purpose">
- <title>Purpose</title>
+ &extcat.purpose;
<section id="refs.basic">
- <title>Basic PHP Extensions</title>
+ &extcat.purpose.basic;
<section id="refs.basic.vartype">
- <title>Variable and Type Related Extensions</title>
+ &extcat.purpose.basic.vartype;
<itemizedlist>
<listitem><para><xref linkend="ref.array"/></para></listitem>
<listitem><para><xref linkend="ref.classobj"/></para></listitem>
@@ -29,7 +30,7 @@
</section>
<section id="refs.basic.text">
- <title>Text Processing</title>
+ &extcat.purpose.basic.text;
<itemizedlist>
<listitem><para><xref linkend="ref.strings"/></para></listitem>
<listitem><para><xref linkend="ref.regex"/></para></listitem>
@@ -38,7 +39,7 @@
</section>
<section id="refs.basic.php">
- <title>Affecting PHP's Behaviour</title>
+ &extcat.purpose.basic.php;
<itemizedlist>
<listitem><para><xref linkend="ref.apc"/></para></listitem>
<listitem><para><xref linkend="ref.apd"/></para></listitem>
@@ -53,7 +54,7 @@
</section>
<section id="refs.basic.session">
- <title>Session Extensions</title>
+ &extcat.purpose.basic.session;
<itemizedlist>
<listitem><para><xref linkend="ref.msession"/></para></listitem>
<listitem><para><xref linkend="ref.muscat"/></para></listitem>
@@ -62,7 +63,7 @@
</section>
<section id="refs.basic.other">
- <title>Other Basic Extensions</title>
+ &extcat.purpose.basic.other;
<itemizedlist>
<listitem><para><xref linkend="ref.misc"/></para></listitem>
<listitem><para><xref linkend="ref.url"/></para></listitem>
@@ -77,10 +78,10 @@
</section>
<section id="refs.database">
- <title>Database Extensions</title>
+ &extcat.purpose.database;
<section id="refs.database.abstract">
- <title>Abstraction Layers</title>
+ &extcat.purpose.database.abstract;
<itemizedlist>
<listitem><para><xref linkend="ref.dba"/></para></listitem>
<listitem><para><xref linkend="ref.dbx"/></para></listitem>
@@ -92,7 +93,7 @@
</section>
<section id="refs.database.vendors">
- <title>Vendor Specific Database Extensions</title>
+ &extcat.purpose.database.vendors;
<itemizedlist>
<listitem><para><xref linkend="ref.dbase"/></para></listitem>
<listitem><para><xref linkend="ref.dbm"/></para></listitem>
@@ -122,7 +123,7 @@
</section>
<section id="refs.xml">
- <title>XML Manipulation</title>
+ &extcat.purpose.xml;
<itemizedlist>
<listitem><para><xref linkend="ref.dom"/></para></listitem>
<listitem><para><xref linkend="ref.domxml"/></para></listitem>
@@ -138,7 +139,7 @@
</section>
<section id="refs.webservice">
- <title>Web Services</title>
+ &extcat.purpose.webservice;
<itemizedlist>
<listitem><para><xref linkend="ref.soap"/></para></listitem>
<listitem><para><xref linkend="ref.wddx"/></para></listitem>
@@ -147,7 +148,7 @@
</section>
<section id="refs.creditcard">
- <title>Credit Card Processing</title>
+ &extcat.purpose.creditcard;
<itemizedlist>
<listitem><para><xref linkend="ref.ccvs"/></para></listitem>
<listitem><para><xref linkend="ref.cybermut"/></para></listitem>
@@ -158,10 +159,10 @@
</section>
<section id="refs.mathcrypto">
- <title>Math and Cryptography</title>
+ &extcat.purpose.mathcrypto;
<section id="refs.mathcrypto.math">
- <title>Mathematical Extensions</title>
+ &extcat.purpose.mathcrypto.math;
<itemizedlist>
<listitem><para><xref linkend="ref.bc"/></para></listitem>
<listitem><para><xref linkend="ref.gmp"/></para></listitem>
@@ -170,7 +171,7 @@
</section>
<section id="refs.mathcrypto.crypto">
- <title>Cryptography Extensions</title>
+ &extcat.purpose.mathcrypto.crypto;
<itemizedlist>
<listitem><para><xref linkend="ref.crack"/></para></listitem>
<listitem><para><xref linkend="ref.mcrypt"/></para></listitem>
@@ -180,7 +181,7 @@
</section>
<section id="refs.international">
- <title>Human Language and Character Encoding Support</title>
+ &extcat.purpose.international;
<itemizedlist>
<listitem><para><xref linkend="ref.fribidi"/></para></listitem>
<listitem><para><xref linkend="ref.gettext"/></para></listitem>
@@ -193,10 +194,10 @@
</section>
<section id="refs.fileprocess">
- <title>File System and Process Control</title>
+ &extcat.purpose.fileprocess;
<section id="refs.fileprocess.file">
- <title>File System Related Extensions</title>
+ &extcat.purpose.fileprocess.file;
<itemizedlist>
<listitem><para><xref linkend="ref.dio"/></para></listitem>
<listitem><para><xref linkend="ref.dir"/></para></listitem>
@@ -208,7 +209,7 @@
</section>
<section id="refs.fileprocess.process">
- <title>Process Control Extensions</title>
+ &extcat.purpose.fileprocess.process;
<itemizedlist>
<listitem><para><xref linkend="ref.posix"/></para></listitem>
<listitem><para><xref linkend="ref.pcntl"/></para></listitem>
@@ -220,10 +221,10 @@
</section>
<section id="refs.remote">
- <title>Accessing Services</title>
+ &extcat.purpose.remote;
<section id="refs.remote.mail">
- <title>Mail Related Extensions</title>
+ &extcat.purpose.remote.mail;
<itemizedlist>
<listitem><para><xref linkend="ref.cyrus"/></para></listitem>
<listitem><para><xref linkend="ref.mail"/></para></listitem>
@@ -234,7 +235,7 @@
</section>
<section id="refs.remote.auth">
- <title>Authentication Services</title>
+ &extcat.purpose.remote.auth;
<itemizedlist>
<listitem><para><xref linkend="ref.kadm5"/></para></listitem>
<listitem><para><xref linkend="ref.radius"/></para></listitem>
@@ -242,7 +243,7 @@
</section>
<section id="refs.remote.other">
- <title>Other Services</title>
+ &extcat.purpose.remote.other;
<itemizedlist>
<listitem><para><xref linkend="ref.curl"/></para></listitem>
<listitem><para><xref linkend="ref.fam"/></para></listitem>
@@ -269,7 +270,7 @@
</section>
<section id="refs.compression">
- <title>Compression Extensions</title>
+ &extcat.purpose.compression;
<itemizedlist>
<listitem><para><xref linkend="ref.bzip2"/></para></listitem>
<listitem><para><xref linkend="ref.lzf"/></para></listitem>
@@ -280,7 +281,7 @@
</section>
<section id="refs.calendar">
- <title>Calendar and Event Related Extensions</title>
+ &extcat.purpose.compression;
<itemizedlist>
<listitem><para><xref linkend="ref.icap"/></para></listitem>
<listitem><para><xref linkend="ref.calendar"/></para></listitem>
@@ -290,10 +291,10 @@
</section>
<section id="refs.utilspec">
- <title>Utilization Area Specific Extensions</title>
+ &extcat.purpose.utilspec;
<section id="refs.utilspec.nontext">
- <title>Non-Text MIME Output</title>
+ &extcat.purpose.utilspec.nontext;
<itemizedlist>
<listitem><para><xref linkend="ref.cpdf"/></para></listitem>
<listitem><para><xref linkend="ref.fdf"/></para></listitem>
@@ -305,7 +306,7 @@
</section>
<section id="refs.utilspec.image">
- <title>Image Processing and Generation</title>
+ &extcat.purpose.utilspec.image;
<itemizedlist>
<listitem><para><xref linkend="ref.exif"/></para></listitem>
<listitem><para><xref linkend="ref.image"/></para></listitem>
@@ -313,7 +314,7 @@
</section>
<section id="refs.utilspec.audio">
- <title>Audio Formats Manipulation</title>
+ &extcat.purpose.utilspec.audio;
<itemizedlist>
<listitem><para><xref linkend="ref.id3"/></para></listitem>
<listitem><para><xref linkend="ref.oggvorbis"/></para></listitem>
@@ -323,7 +324,7 @@
</section>
<section id="refs.utilspec.cmdline">
- <title>Command Line Specific Extensions</title>
+ &extcat.purpose.utilspec.cmdline;
<itemizedlist>
<listitem><para><xref linkend="ref.ncurses"/></para></listitem>
<listitem><para><xref linkend="ref.readline"/></para></listitem>
@@ -331,7 +332,7 @@
</section>
<section id="refs.utilspec.windows">
- <title>Windows Only Extensions</title>
+ &extcat.purpose.utilspec.windows;
<itemizedlist>
<listitem><para><xref linkend="ref.dotnet"/></para></listitem>
<listitem><para><xref linkend="ref.com"/></para></listitem>
@@ -341,26 +342,20 @@
</section>
<section id="refs.utilspec.server">
- <title>Server Specific Extensions</title>
+ &extcat.purpose.utilspec.server;
<itemizedlist>
<listitem><para><xref linkend="ref.apache"/></para></listitem>
<listitem><para><xref linkend="ref.nsapi"/></para></listitem>
<listitem><para><xref linkend="ref.iisfunc"/></para></listitem>
</itemizedlist>
</section>
-
</section>
-
-
<section id="extensions.membership">
- <title>Membership</title>
+ &extcat.membership;
<section id="extensions.membership.core">
- <title>Core Extensions</title>
- <para>
- These are not actual extensions - they are part of the PHP core and cannot
be compilled out with compilation options.
- </para>
+ &extcat.membership.core;
<itemizedlist>
<listitem><para><xref linkend="ref.array"/></para></listitem>
<listitem><para><xref linkend="ref.classobj"/></para></listitem>
@@ -386,10 +381,7 @@
</section>
<section id="extensions.membership.bundled">
- <title>Bundled Extensions</title>
- <para>
- These extensions are bundled with PHP.
- </para>
+ &extcat.membership.bundled;
<itemizedlist>
<listitem><para><xref linkend="ref.apache"/></para></listitem>
<listitem><para><xref linkend="ref.bc"/></para></listitem>
@@ -444,10 +436,7 @@
</section>
<section id="extensions.membership.external">
- <title>External Extensions</title>
- <para>
- In order to compile these extensions, external libraries will be needed.
- </para>
+ &extcat.membership.external;
<itemizedlist>
<listitem><para><xref linkend="ref.aspell"/></para></listitem>
<listitem><para><xref linkend="ref.ccvs"/></para></listitem>
@@ -485,10 +474,7 @@
</section>
<section id="extensions.membership.pecl">
- <title>PECL Extensions</title>
- <para>
- These extensions are available from <ulink url="&url.pecl;">PECL</ulink>.
More PECL extensions exist but they are not documented in the PHP manual yet.
- </para>
+ &extcat.membership.pecl;
<itemizedlist>
<listitem><para><xref linkend="ref.apc"/></para></listitem>
<listitem><para><xref linkend="ref.apd"/></para></listitem>
@@ -546,22 +532,13 @@
<listitem><para><xref linkend="ref.zip"/></para></listitem>
</itemizedlist>
</section>
-
</section>
-
-
<section id="extensions.state">
- <title>State</title>
- <para>
- This part lists extensions not intended for the production use - they are
either too "old" (deprecated) or "new" (experimental).
- </para>
+ &extcat.state;
<section id="extensions.state.deprecated">
- <title>Deprecated Extensions</title>
- <para>
- These extensions have been deprecated usually in the favor of some other
extensions.
- </para>
+ &extcat.state.deprecated;
<itemizedlist>
<listitem><para><xref linkend="ref.aspell"/></para></listitem>
<listitem><para><xref linkend="ref.ccvs"/></para></listitem>
@@ -572,10 +549,7 @@
</section>
<section id="extensions.state.experimental">
- <title>Experimental Extensions</title>
- <para>
- The behaviour of these extensions - including the names of their functions
and anything else documented about these extensions - may change without notice
in a future release of PHP. Use these extensions at your own risk.
- </para>
+ &extcat.state.experimental;
<itemizedlist>
<listitem><para><xref linkend="ref.bcompiler"/></para></listitem>
<listitem><para><xref linkend="ref.dbplus"/></para></listitem>
@@ -599,11 +573,8 @@
<listitem><para><xref linkend="ref.xmlrpc"/></para></listitem>
</itemizedlist>
</section>
-
</section>
-
-
</appendix>
<!-- Keep this comment at the end of the file
http://cvs.php.net/co.php/phpdoc/en/extensions.ent?r=1.1&p=1
Index: phpdoc/en/extensions.ent
+++ phpdoc/en/extensions.ent
<!-- $Revision: 1.1 $ -->
<!--
Entities for the categorized extension list, so it does not need
to be translated, and thus it is not going to be outdated.
-->
<!ENTITY extcat.intro '<title>Extension Categorization</title><para>This
appendix categorizes more than 150 extensions documented in the PHP
Manual by several criteria.</para>'>
<!-- ======================================================================= -->
<!ENTITY extcat.purpose '<title>Purpose</title>'>
<!ENTITY extcat.purpose.basic '<title>Basic PHP Extensions</title>'>
<!ENTITY extcat.purpose.basic.vartype '<title>Variable and Type Related
Extensions</title>'>
<!ENTITY extcat.purpose.basic.text '<title>Text Processing</title>'>
<!ENTITY extcat.purpose.basic.php "<title>Affecting PHP's Behaviour</title>">
<!ENTITY extcat.purpose.basic.session '<title>Session Extensions</title>'>
<!ENTITY extcat.purpose.basic.other '<title>Other Basic Extensions</title>'>
<!ENTITY extcat.purpose.database '<title>Database Extensions</title>'>
<!ENTITY extcat.purpose.database.abstract '<title>Abstraction Layers</title>'>
<!ENTITY extcat.purpose.database.vendors '<title>Vendor Specific Database
Extensions</title>'>
<!ENTITY extcat.purpose.xml '<title>XML Manipulation</title>'>
<!ENTITY extcat.purpose.webservice '<title>Web Services</title>'>
<!ENTITY extcat.purpose.creditcard '<title>Credit Card Processing</title>'>
<!ENTITY extcat.purpose.mathcrypto '<title>Math and Cryptography</title>'>
<!ENTITY extcat.purpose.mathcrypto.math '<title>Mathematical
Extensions</title>'>
<!ENTITY extcat.purpose.mathcrypto.crypto '<title>Cryptography
Extensions</title>'>
<!ENTITY extcat.purpose.international '<title>Human Language and Character
Encoding Support</title>'>
<!ENTITY extcat.purpose.fileprocess '<title>File System and Process
Control</title>'>
<!ENTITY extcat.purpose.fileprocess.file '<title>File System Related
Extensions</title>'>
<!ENTITY extcat.purpose.fileprocess.process '<title>Process Control
Extensions</title>'>
<!ENTITY extcat.purpose.remote '<title>Accessing Services</title>'>
<!ENTITY extcat.purpose.remote.mail '<title>Mail Related Extensions</title>'>
<!ENTITY extcat.purpose.remote.auth '<title>Authentication Services</title>'>
<!ENTITY extcat.purpose.remote.other '<title>Other Services</title>'>
<!ENTITY extcat.purpose.compression '<title>Compression Extensions</title>'>
<!ENTITY extcat.purpose.calendar '<title>Calendar and Event Related
Extensions</title>'>
<!ENTITY extcat.purpose.utilspec '<title>Utilization Area Specific
Extensions</title>'>
<!ENTITY extcat.purpose.utilspec.nontext '<title>Non-Text MIME Output</title>'>
<!ENTITY extcat.purpose.utilspec.image '<title>Image Processing and
Generation</title>'>
<!ENTITY extcat.purpose.utilspec.audio '<title>Audio Formats
Manipulation</title>'>
<!ENTITY extcat.purpose.utilspec.cmdline '<title>Command Line Specific
Extensions</title>'>
<!ENTITY extcat.purpose.utilspec.windows '<title>Windows Only
Extensions</title>'>
<!ENTITY extcat.purpose.utilspec.server '<title>Server Specific
Extensions</title>'>
<!-- ======================================================================= -->
<!ENTITY extcat.membership '<title>Membership</title>'>
<!ENTITY extcat.membership.core '<title>Core Extensions</title><para>These
are not actual extensions. They are part of the PHP core and cannot be
left out of a PHP binary with compilation options.</para>'>
<!ENTITY extcat.membership.bundled '<title>Bundled Extensions</title><para>These
extensions are bundled with PHP.</para>'>
<!ENTITY extcat.membership.external '<title>External Extensions</title><para>In
order to compile these extensions, external libraries will be needed.</para>'>
<!ENTITY extcat.membership.pecl '<title>PECL Extensions</title><para>These
extensions are available from <ulink url="&url.pecl;">PECL</ulink>. More PECL
extensions exist but they are not documented in the PHP manual yet.</para>'>
<!-- ======================================================================= -->
<!ENTITY extcat.state '<title>State</title><para>This part lists extensions not
intended for the production use - they are either too "old" (deprecated) or
"new" (experimental).</para>'>
<!ENTITY extcat.state.deprecated '<title>Deprecated
Extensions</title><para>These
extensions have been deprecated usually in the favor of some other
extensions.</para>'>
<!ENTITY extcat.state.experimental '<title>Experimental
Extensions</title><para>The
behaviour of these extensions - including the names of their functions and
anything
else documented about these extensions - may change without notice in a future
release
of PHP. Use these extensions at your own risk.</para>'>
