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

MFB: Upgrade to the new-reference-structure

Browse source 
- Moved the intro from reference.xml to book.xml
    - Change the intro ID to intro.<extname>
    - Moved the setup sections to setup.xml
    - Changed the constants section to be <appendix>


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@248351 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Hannes Magnusson 2007-12-16 11:57:07 +00:00
parent f2f7adf47a
commit b4fabcdafb
20 changed files with 694 additions and 347 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

57
reference/dbplus/book.xml Normal file
View file

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: pecl, external -->
<!-- State: experimental -->
<book xml:id="book.dbplus" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>DB++</title>
<!-- {{{ preface -->
<preface xml:id="intro.dbplus">
&reftitle.intro;
<para>
db++, made by the German company <link
xlink:href="&url.dbplus.company;">Concept asa</link>, is a relational
database system with high performance and low memory and disk
usage in mind. While providing SQL as an additional language
interface, it is not really a SQL database in the first place but
provides its own AQL query language which is much more influenced
by the relational algebra than SQL is.
</para>
<para>
Concept asa always had an interest in supporting open source
languages, db++ has had Perl and Tcl call interfaces for years
now and uses Tcl as its internal stored procedure language.
</para>
&warn.experimental;
</preface>
<!-- }}} -->
&reference.dbplus.setup;
&reference.dbplus.constants;
&reference.dbplus.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

6
reference/dbplus/constants.xml
View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<section xml:id="dbplus.constants" xmlns="http://docbook.org/ns/docbook">
<!-- $Revision: 1.7 $ -->
<appendix xml:id="dbplus.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<section xml:id="dbplus.errorcodes">
@ -343,7 +343,7 @@
</table>
</para>
</section>
</section>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:

74
reference/dbplus/reference.xml
View file

@ -1,77 +1,13 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: pecl, external -->
<!-- State: experimental -->
<!-- $Revision: 1.13 $ -->
<reference xml:id="ref.dbplus" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>DB++ Functions</title>
<titleabbrev>DB++</titleabbrev>
<reference xml:id="ref.dbplus" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>DB++ &Functions;</title>
<partintro>
&warn.experimental;
<section xml:id="dbplus.intro">
&reftitle.intro;
<para>
db++, made by the German company <link
xlink:href="&url.dbplus.company;">Concept asa</link>, is a relational
database system with high performance and low memory and disk
usage in mind. While providing SQL as an additional language
interface, it is not really a SQL database in the first place but
provides its own AQL query language which is much more influenced
by the relational algebra than SQL is.
</para>
<para>
Concept asa always had an interest in supporting open source
languages, db++ has had Perl and Tcl call interfaces for years
now and uses Tcl as its internal stored procedure language.
</para>
</section>
&reference.dbplus.entities.functions;
<section xml:id="dbplus.requirements">
&reftitle.required;
<para>
This extension relies on external client libraries so you have
to have a db++ client installed on the system you want to use
this extension on.
</para>
<para>
<link xlink:href="&url.dbplus.company;">Concept asa</link> provides
<link xlink:href="&url.dbplus.download;">db++ Demo versions</link>
and <link xlink:href="&url.dbplus.documentation;">documentation</link>
for Linux, some other Unix versions. There is also a Windows
version of db++, but this extension doesn't support it (yet).
</para>
</section>
&reference.dbplus.configure;
<section xml:id="dbplus.configuration">
&reftitle.runtime;
&no.config;
</section>
<section xml:id="dbplus.resources">
&reftitle.resources;
<section xml:id="dbplus.resources.relation">
<title>dbplus_relation</title>
<para>
Most db++ functions operate on or return
<parameter>dbplus_relation</parameter> resources. A
<parameter>dbplus_relation</parameter> is a handle to a stored
relation or a relation generated as the result of a query.
</para>
</section>
</section>
</reference>
&reference.dbplus.constants;
</partintro>
&reference.dbplus.entities.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

73
reference/dbplus/setup.xml Normal file
View file

@ -0,0 +1,73 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="dbplus.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="dbplus.requirements">
&reftitle.required;
<para>
This extension relies on external client libraries so you have
to have a db++ client installed on the system you want to use
this extension on.
</para>
<para>
<link xlink:href="&url.dbplus.company;">Concept asa</link> provides
<link xlink:href="&url.dbplus.download;">db++ Demo versions</link>
and <link xlink:href="&url.dbplus.documentation;">documentation</link>
for Linux, some other Unix versions. There is also a Windows
version of db++, but this extension doesn't support it (yet).
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.dbplus.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="dbplus.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="dbplus.resources">
&reftitle.resources;
<section xml:id="dbplus.resources.relation">
<title>dbplus_relation</title>
<para>
Most db++ functions operate on or return
<parameter>dbplus_relation</parameter> resources. A
<parameter>dbplus_relation</parameter> is a handle to a stored
relation or a relation generated as the result of a query.
</para>
</section>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

54
reference/dbx/book.xml Normal file
View file

@ -0,0 +1,54 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<!-- Purpose: database.abstract -->
<!-- Membership: pecl, external -->
<book xml:id="book.dbx" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>dbx</title>
<!-- {{{ preface -->
<preface xml:id="intro.dbx">
&reftitle.intro;
<para>
The dbx module is a database abstraction layer (db 'X', where 'X'
is a supported database). The dbx functions allow you to access
all supported databases using a single calling convention.
The dbx-functions themselves do not interface directly to the
databases, but interface to the modules that are used to support
these databases.
</para>
<note>
<para>
&pecl.moved-ver;5.1.0.
</para>
</note>
</preface>
<!-- }}} -->
&reference.dbx.setup;
&reference.dbx.constants;
&reference.dbx.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

6
reference/dbx/constants.xml
View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<section xml:id="constants.dbx" xmlns="http://docbook.org/ns/docbook">
<!-- $Revision: 1.12 $ -->
<appendix xml:id="constants.dbx" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<variablelist>
@ -236,7 +236,7 @@
</listitem>
</varlistentry>
</variablelist>
</section>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:

104
reference/dbx/reference.xml
View file

@ -1,106 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.21 $ -->
<!-- Purpose: database.abstract -->
<!-- Membership: pecl, external -->
<!-- $Revision: 1.22 $ -->
<reference xml:id="ref.dbx" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>dbx Functions</title>
<titleabbrev>dbx</titleabbrev>
<reference xml:id="ref.dbx" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>dbx &Functions;</title>
<partintro>
<section xml:id="dbx.intro">
&reftitle.intro;
<para>
The dbx module is a database abstraction layer (db 'X', where 'X'
is a supported database). The dbx functions allow you to access
all supported databases using a single calling convention.
The dbx-functions themselves do not interface directly to the
databases, but interface to the modules that are used to support
these databases.
</para>
<note>
<para>
&pecl.moved-ver;5.1.0.
</para>
</note>
</section>
<section xml:id="dbx.required">
&reftitle.required;
<para>
To be able to use a database with the dbx-module, the module must be either
linked or loaded into PHP, and the database module must be supported by the
dbx-module. Currently, the following databases are supported, but others
will follow:
<itemizedlist>
<listitem>
<simpara>
<link linkend="ref.fbsql">FrontBase</link> (available from PHP 4.1.0).
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.mssql">Microsoft SQL Server</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.mysql">MySQL</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.uodbc">ODBC</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.pgsql">PostgreSQL</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.sybase">Sybase-CT</link> (available from PHP 4.2.0).
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.oci8">Oracle (oci8)</link> (available from PHP 4.3.0).
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.sqlite">SQLite</link> (PHP 5).
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
Documentation for adding additional database support to dbx can be
found at <link xlink:href="&url.dbx.docs;">&url.dbx.docs;</link>.
</para>
</section>
&reference.dbx.entities.functions;
&reference.dbx.configure;
&reference.dbx.ini;
<section xml:id="dbx.resources">
&reftitle.resources;
<para>
There are two resource types used in the dbx module. The first one is the
link-<type>object</type> for a database connection, the second a
result-<type>object</type> which holds the result of a query.
</para>
</section>
&reference.dbx.constants;
</partintro>
&reference.dbx.entities.functions;
</reference>
</reference>
<!-- Keep this comment at the end of the file
Local variables:

106
reference/dbx/setup.xml Normal file
View file

@ -0,0 +1,106 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="dbx.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="dbx.requirements">
&reftitle.required;
<para>
To be able to use a database with the dbx-module, the module must be either
linked or loaded into PHP, and the database module must be supported by the
dbx-module. Currently, the following databases are supported, but others
will follow:
<itemizedlist>
<listitem>
<simpara>
<link linkend="ref.fbsql">FrontBase</link> (available from PHP 4.1.0).
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.mssql">Microsoft SQL Server</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.mysql">MySQL</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.uodbc">ODBC</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.pgsql">PostgreSQL</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.sybase">Sybase-CT</link> (available from PHP 4.2.0).
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.oci8">Oracle (oci8)</link> (available from PHP 4.3.0).
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="ref.sqlite">SQLite</link> (PHP 5).
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
Documentation for adding additional database support to dbx can be
found at <link xlink:href="&url.dbx.docs;">&url.dbx.docs;</link>.
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.dbx.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
&reference.dbx.ini;
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="dbx.resources">
&reftitle.resources;
<para>
There are two resource types used in the dbx module. The first one is the
link-<type>object</type> for a database connection, the second a
result-<type>object</type> which holds the result of a query.
</para>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

57
reference/dio/book.xml Normal file
View file

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<book xml:id="book.dio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Direct IO &Functions;</title>
<!-- {{{ preface -->
<preface xml:id="intro.dio">
&reftitle.intro;
<para>
PHP supports the direct io functions as described in the Posix
Standard (Section 6) for performing I/O functions at a lower
level than the C-Language stream I/O functions
(<function>fopen</function>, <function>fread</function>,..). The use
of the DIO functions should be considered only when direct
control of a device is needed. In all other cases, the standard
<link linkend="book.filesystem">filesystem</link> functions are more
than adequate.
</para>
<note>
<para>
&pecl.moved-ver;5.1.0.
</para>
</note>
<para>
This extension is only available on Windows Platforms as of PHP 5.0.0
</para>
</preface>
<!-- }}} -->
&reference.dio.setup;
&reference.dio.constants;
&reference.dio.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

6
reference/dio/constants.xml
View file

@ -1,6 +1,6 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.2 $ -->
<section xml:id="dio.constants" xmlns="http://docbook.org/ns/docbook">
<!-- $Revision: 1.3 $ -->
<appendix xml:id="dio.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<variablelist>
@ -338,7 +338,7 @@
</listitem>
</varlistentry>
</variablelist>
</section>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:

59
reference/dio/reference.xml
View file

@ -1,61 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.16 $ -->
<!-- Purpose: fileprocess.file -->
<!-- Membership: pecl -->
<!-- $Revision: 1.17 $ -->
<reference xml:id="ref.dio" xmlns="http://docbook.org/ns/docbook">
<title>Direct IO Functions</title>
<titleabbrev>Direct IO</titleabbrev>
<reference xml:id="ref.dio" xmlns="http://docbook.org/ns/docbook">
<title>Direct IO &Functions;</title>
<partintro>
<section xml:id="dio.intro">
&reftitle.intro;
<para>
PHP supports the direct io functions as described in the Posix
Standard (Section 6) for performing I/O functions at a lower
level than the C-Language stream I/O functions
(<function>fopen</function>, <function>fread</function>,..). The use
of the DIO functions should be considered only when direct
control of a device is needed. In all other cases, the standard
<link linkend="ref.filesystem">filesystem</link> functions are more
than adequate.
</para>
<note>
<para>
&pecl.moved-ver;5.1.0.
</para>
</note>
<para>
This extension is only available on Windows Platforms as of PHP 5.0.0
</para>
</section>
&reference.dio.entities.functions;
<section xml:id="dio.requirements">
&reftitle.required;
&no.requirement;
</section>
&reference.dio.configure;
&reference.dio.constants;
<section xml:id="dio.configuration">
&reftitle.runtime;
&no.config;
</section>
<section xml:id="dio.resources">
&reftitle.resources;
<para>
One resource type is defined by this extension:
a file descriptor returned by <function>dio_open</function>.
</para>
</section>
</partintro>
&reference.dio.entities.functions;
</reference>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

57
reference/dio/setup.xml Normal file
View file

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="dio.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="dio.requirements">
&reftitle.required;
&no.requirement;
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.dio.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="dio.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="dio.resources">
&reftitle.resources;
<para>
One resource type is defined by this extension:
a file descriptor returned by <function>dio_open</function>.
</para>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

43
reference/dir/book.xml Normal file
View file

@ -0,0 +1,43 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<book xml:id="book.dir" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Directory &Functions;</title>
<titleabbrev>Directories</titleabbrev>
<!-- {{{ preface
FIXME: Empty intro?
<preface xml:id="intro.dir">
&reftitle.intro;
<para>
</para>
</preface>
}}} -->
&reference.dir.setup;
&reference.dir.constants;
&reference.dir.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

6
reference/dir/constants.xml
View file

@ -1,6 +1,6 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.3 $ -->
<section xml:id="dir.constants" xmlns="http://docbook.org/ns/docbook">
<!-- $Revision: 1.4 $ -->
<appendix xml:id="dir.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<variablelist>
@ -32,7 +32,7 @@
The <constant>PATH_SEPARATOR</constant> was introduced with PHP 4.3.0-RC2.
</simpara>
</note>
</section>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:

64
reference/dir/reference.xml
View file

@ -1,58 +1,24 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- Purpose: fileprocess.file -->
<!-- Membership: core -->
<!-- $Revision: 1.10 $ -->
<reference xml:id="ref.dir" xmlns="http://docbook.org/ns/docbook">
<title>Directory Functions</title>
<titleabbrev>Directories</titleabbrev>
<reference xml:id="ref.dir" xmlns="http://docbook.org/ns/docbook">
<title>Directory &Functions;</title>
<titleabbrev>Directories</titleabbrev>
<partintro>
<partintro>
&reftitle.seealso;
<para>
For related functions such as <function>dirname</function>,
<function>is_dir</function>, <function>mkdir</function>, and
<function>rmdir</function>, see the
<link linkend="ref.filesystem">Filesystem</link> section.
</para>
</partintro>
<section xml:id="dir.intro">
&reftitle.intro;
<para>
</para>
</section>
<section xml:id="dir.requirements">
&reftitle.required;
&no.requirement;
</section>
<section xml:id="dir.installation">
&reftitle.install;
&no.install;
</section>
&reference.dir.entities.functions;
<section xml:id="dir.configuration">
&reftitle.runtime;
&no.config;
</section>
</reference>
<section xml:id="dir.resources">
&reftitle.resources;
<para>
</para>
</section>
&reference.dir.constants;
<section xml:id="dir.seealso">
&reftitle.seealso;
<para>
For related functions such as <function>dirname</function>,
<function>is_dir</function>, <function>mkdir</function>, and
<function>rmdir</function>, see the
<link linkend="ref.filesystem">Filesystem</link> section.
</para>
</section>
</partintro>
&reference.dir.entities.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

57
reference/dir/setup.xml Normal file
View file

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="dir.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="dir.requirements">
&reftitle.required;
&no.requirement;
</section>
<!-- }}} -->
<!-- {{{ Installation -->
<section xml:id="dir.installation">
&reftitle.install;
&no.install;
</section>
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="dir.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="dir.resources">
&reftitle.resources;
&no.resource;
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

75
reference/domxml/book.xml Normal file
View file

@ -0,0 +1,75 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<!-- Purpose: xml -->
<!-- Membership: pecl, external -->
<book xml:id="book.domxml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>DOM XML</title>
<!-- {{{ preface -->
<preface xml:id="intro.domxml">
&reftitle.intro;
<para>
The DOM XML extension has been overhauled in PHP 4.3.0 to better comply with
the DOM standard. The extension still contains
many old functions, but they should no longer be used. In particular, functions
that are not object-oriented should be avoided.
</para>
<para>
The extension allows you to operate on an XML document with the DOM API.
It also provides a function <function>domxml_xmltree</function> to turn the
complete XML document into a tree of PHP objects. Currently, this
tree should be considered read-only - you can modify it, but this
would not make any sense since <function>DomDocument_dump_mem</function>
cannot be
applied to it. Therefore, if you want to read an XML file and write
a modified version, use <function>DomDocument_create_element</function>,
<function>DomDocument_create_text_node</function>,
<function>set_attribute</function>, etc. and finally the
<function>DomDocument_dump_mem</function> function.
</para>
<note>
<para>
&pecl.moved-ver;5.0.0.
</para>
</note>
<note>
<simpara>
This extension is no longer marked experimental. It will, however, never
be released with PHP 5, and will only be distributed with PHP 4.
If you need DOM XML support with PHP 5 you can use the
<link linkend="book.dom">DOM</link> extension. This
<literal>domxml</literal> extension is not compatible with the
<link linkend="book.dom">DOM</link> extension.
</simpara>
</note>
</preface>
<!-- }}} -->
&reference.domxml.setup;
&reference.domxml.constants;
&reference.domxml.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

6
reference/domxml/constants.xml
View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<section xml:id="domxml.constants" xmlns="http://docbook.org/ns/docbook">
<!-- $Revision: 1.6 $ -->
<appendix xml:id="domxml.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<table>
@ -334,7 +334,7 @@ no someone familiar with this extension should do further work.
</tbody>
</tgroup>
</table>
</section>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:

68
reference/domxml/reference.xml
View file

@ -1,67 +1,10 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.24 $ -->
<!-- Purpose: xml -->
<!-- Membership: pecl, external -->
<!-- $Revision: 1.25 $ -->
<reference xml:id="ref.domxml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>DOM XML Functions</title>
<titleabbrev>DOM XML</titleabbrev>
<title>DOM XML &Functions;</title>
<partintro>
<section xml:id="domxml.intro">
&reftitle.intro;
<para>
The DOM XML extension has been overhauled in PHP 4.3.0 to better comply with
the DOM standard. The extension still contains
many old functions, but they should no longer be used. In particular, functions
that are not object-oriented should be avoided.
</para>
<para>
The extension allows you to operate on an XML document with the DOM API.
It also provides a function <function>domxml_xmltree</function> to turn the
complete XML document into a tree of PHP objects. Currently, this
tree should be considered read-only - you can modify it, but this
would not make any sense since <function>DomDocument_dump_mem</function>
cannot be
applied to it. Therefore, if you want to read an XML file and write
a modified version, use <function>DomDocument_create_element</function>,
<function>DomDocument_create_text_node</function>,
<function>set_attribute</function>, etc. and finally the
<function>DomDocument_dump_mem</function> function.
</para>
<note>
<para>
&pecl.moved-ver;5.0.0.
</para>
</note>
<note>
<simpara>
This extension is no longer marked experimental. It will, however, never
be released with PHP 5, and will only be distributed with PHP 4.
If you need DOM XML support with PHP 5 you can use the
<link linkend="ref.dom">DOM</link> extension. This
<literal>domxml</literal> extension is not compatible with the
<link linkend="ref.dom">DOM</link> extension.
</simpara>
</note>
</section>
<section xml:id="domxml.requirements">
&reftitle.required;
<para>
This extension makes use of the
<link xlink:href="&url.libxml;">GNOME XML library</link>. Download
and install this library. You will need at least libxml-2.4.14.
To use DOM XSLT features you can use the
<link xlink:href="&url.libxslt;">libxslt library</link> and EXSLT
enhancements from <link xlink:href="&url.exslt;">&url.exslt;</link>.
Download and install these libraries if you plan to use (enhanced) XSLT
features. You will need at least libxslt-1.0.18.
</para>
</section>
&reference.domxml.configure;
<section xml:id="domxml.deprecated">
<title>Deprecated functions</title>
<para>
@ -175,8 +118,11 @@
</para>
</section>
&reference.domxml.constants;
<!--
FIXME:
Maybe someone, someday, wants to upgrade this mess to use the
new OO markup..
-->
<section xml:id="domxml.classes">
<title>Classes</title>
<para>

63
reference/domxml/setup.xml Normal file
View file

@ -0,0 +1,63 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="domxml.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="domxml.requirements">
&reftitle.required;
<para>
This extension makes use of the
<link xlink:href="&url.libxml;">GNOME XML library</link>. Download
and install this library. You will need at least libxml-2.4.14.
To use DOM XSLT features you can use the
<link xlink:href="&url.libxslt;">libxslt library</link> and EXSLT
enhancements from <link xlink:href="&url.exslt;">&url.exslt;</link>.
Download and install these libraries if you plan to use (enhanced) XSLT
features. You will need at least libxslt-1.0.18.
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.domxml.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="domxml.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="domxml.resources">
&reftitle.resources;
&no.resource;
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->