MFB: Upgrade to the new-reference-structure

- Split reference.xml into book.xml and setup.xml
- Moved from reference.xml to book.xml:
  - The intro text (partintro), and link to constants.xml
- Moved from reference.xml to setup.xml:
  - The rest: requirements, installation, configuration, and resources
- Changed the constants section to be an <appendix>
- Changed the intro ID from <extname>.intro to intro.<extname>


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@248177 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Philip Olson 2007-12-13 20:34:44 +00:00
parent 89a13f61ee
commit 77506bd6a3
4 changed files with 135 additions and 69 deletions

70
reference/uodbc/book.xml Normal file
View file

@ -0,0 +1,70 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<!-- Purpose: database.abstract -->
<!-- Membership: bundled, external -->
<book xml:id="book.uodbc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>ODBC</title>
<!-- {{{ preface -->
<preface xml:id="intro.uodbc">
&reftitle.intro;
<para>
In addition to normal ODBC support, the Unified ODBC functions in
PHP allow you to access several databases that have borrowed the
semantics of the ODBC API to implement their own API. Instead of
maintaining multiple database drivers that were all nearly
identical, these drivers have been unified into a single set of
ODBC functions.
</para>
<para>
The following databases are supported by the Unified ODBC
functions: <link xlink:href="&url.adabas;">Adabas D</link>,
<link xlink:href="&url.ibmdb2;">IBM DB2</link>,
<link xlink:href="&url.iodbc;">iODBC</link>,
<link xlink:href="&url.solid;">Solid</link>, and
<link xlink:href="&url.sybase;">Sybase SQL Anywhere</link>.
</para>
<note>
<para>
With the exception of iODBC, there is no ODBC involved when
connecting to the above databases. The functions that you
use to speak natively to them just happen to share the same
names and syntax as the ODBC functions. However, building PHP
with iODBC support enables you to use any ODBC-compliant
drivers with your PHP applications. More information on iODBC,
is available at <link xlink:href="&url.iodbc;">www.iodbc.org</link>
with the alternative unixODBC available at
<link xlink:href="&url.unixodbc;">www.unixodbc.org</link>.
</para>
</note>
</preface>
<!-- }}} -->
&reference.uodbc.setup;
&reference.uodbc.constants;
&reference.uodbc.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
-->

View file

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

View file

@ -1,73 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.13 $ -->
<!-- Purpose: database.abstract -->
<!-- Membership: bundled, external -->
<!-- $Revision: 1.14 $ -->
<reference xml:id="ref.uodbc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>ODBC Functions (Unified)</title>
<titleabbrev>ODBC</titleabbrev>
<reference xml:id="ref.uodbc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>ODBC Functions (Unified)</title>
<partintro>
<section xml:id="uodbc.intro">
&reftitle.intro;
<para>
In addition to normal ODBC support, the Unified ODBC functions in
PHP allow you to access several databases that have borrowed the
semantics of the ODBC API to implement their own API. Instead of
maintaining multiple database drivers that were all nearly
identical, these drivers have been unified into a single set of
ODBC functions.
</para>
<para>
The following databases are supported by the Unified ODBC
functions: <link xlink:href="&url.adabas;">Adabas D</link>,
<link xlink:href="&url.ibmdb2;">IBM DB2</link>,
<link xlink:href="&url.iodbc;">iODBC</link>,
<link xlink:href="&url.solid;">Solid</link>, and
<link xlink:href="&url.sybase;">Sybase SQL Anywhere</link>.
</para>
<note>
<para>
With the exception of iODBC, there is no ODBC involved when
connecting to the above databases. The functions that you
use to speak natively to them just happen to share the same
names and syntax as the ODBC functions. However, building PHP
with iODBC support enables you to use any ODBC-compliant
drivers with your PHP applications. More information on iODBC,
is available at <link xlink:href="&url.iodbc;">www.iodbc.org</link>
with the alternative unixODBC available at
<link xlink:href="&url.unixodbc;">www.unixodbc.org</link>.
</para>
</note>
</section>
&reference.uodbc.entities.functions;
<section xml:id="uodbc.requirements">
&reftitle.required;
<para>
To access any of the supported databases you need to have
the required libraries installed.
</para>
</section>
&reference.uodbc.configure;
&reference.uodbc.ini;
<section xml:id="uodbc.resources">
&reftitle.resources;
<para>
This extension defines two resource types: an ODBC connection identifier
and an ODBC result identifier.
</para>
</section>
&reference.uodbc.constants;
</partintro>
&reference.uodbc.entities.functions;
</reference>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

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

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<chapter xml:id="uodbc.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="uodbc.requirements">
&reftitle.required;
<para>
To access any of the supported databases you need to have
the required libraries installed.
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.uodbc.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
&reference.uodbc.ini;
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="uodbc.resources">
&reftitle.resources;
<para>
This extension defines two resource types: an ODBC connection identifier
and an ODBC result identifier.
</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
-->