sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-15 08:28:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

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)

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@194077 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Gabor Hojtsy 2005-08-21 12:38:06 +00:00
parent 2536aa0697
commit d447a8578e
2 changed files with 141 additions and 79 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

129
appendices/extensions.xml
View file

@ -1,22 +1,23 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<?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">
<title>Extension Categorization</title>
<para>
This appendix categorizes more than 150 extensions documented in the PHP manual by several criteria.
</para>
&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

91
extensions.ent Normal file
View file

@ -0,0 +1,91 @@
<!-- $Revision$ -->
<!--
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>'>