Add configuration stubs for PDO_ODBC (UNIX only to begin with).

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@197010 c90b9560-bf6c-de11-be94-00142212c4b1

reference/pdo_odbc/configure.xml

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<section id="ref.pdo-odbc.installation">
+ &reftitle.install;
+ <procedure id="ref.pdo-odbc.install.unix">
+  <title>PDO_ODBC on UNIX systems</title>
+  <step>
+   <para>
+    As of PHP 5.1, PDO_ODBC is included in the PHP source. You can compile the
+    PDO_ODBC extension as either a static or shared module using the following
+    <command>configure</command> commands.
+    <variablelist>
+     <varlistentry>
+      <term>ibm_db2</term>
+      <listitem>
+       <para>
+        <screen><![CDATA[
+./configure --enable-pdo_odbc=ibm-db2,/opt/IBM/db2/V8.1/
+]]></screen>
+        To build PDO_ODBC with the ibm-db2 flavour, you have to have
+        previously installed the DB2 application development headers on the
+        same machine on which you are compiling PDO_ODBC. The DB2 application
+        development headers are an installable option in the DB2 servers, and
+        are also available as part of the DB2 Application Development Client
+        freely available for download from the IBM DB2 Universal Database
+        <ulink url="&url.ibm.db2.client;">support site</ulink>.
+       </para>
+       <para>
+        If you do not supply a location for the DB2 libraries and headers to
+        the <command>configure</command> command, PDO_ODBC defaults to
+        <filename class="directory">/home/db2inst1/sqllib</filename>.
+       </para>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term>unixODBC</term>
+      <listitem>
+       <para>
+        <screen><![CDATA[
+./configure --enable-pdo_odbc=unixODBC,/usr/local
+]]></screen>
+        If you do not supply a location for the unixODBC libraries and
+        headers to the <command>configure</command> command, PDO_ODBC
+        defaults to <filename class="directory">/usr/local</filename>.
+       </para>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term>generic</term>
+      <listitem>
+       <screen><![CDATA[
+./configure --enable-pdo_odbc=generic,/usr/local,libname,ldflags,cflags
+]]></screen>
+      </listitem>
+     </varlistentry>
+    </variablelist>
+   </para>
+  </step>
+ </procedure>
+</section>

reference/pdo_odbc/reference.xml

@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <!-- Purpose: database.vendors -->
 <!-- Membership: bundled, external, pecl -->
 
@@ -11,11 +11,40 @@
    <section id="pdo-odbc.intro">
    &reftitle.intro;
     <para>
-     &warn.experimental;
      PDO_ODBC is a driver that implements the <link linkend="ref.pdo">PHP Data
      Objects (PDO) interface</link>
      to enable access from PHP to databases through ODBC drivers or through the
-     IBM DB2 Call Level Interface (DB2 CLI) library.
+     IBM DB2 Call Level Interface (DB2 CLI) library. PDO_ODBC currently supports
+     three different "flavours" of database drivers:
+     <variablelist>
+      <varlistentry>
+       <term>ibm-db2</term>
+       <listitem>
+        <para>
+         Supports access to IBM DB2 Universal Database, Cloudscape, and Apache
+         Derby servers through the free DB2 client.
+        </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>unixODBC</term>
+       <listitem>
+        <para>
+         Supports access to database servers through the unixODBC driver
+         manager and the database's own ODBC drivers. 
+        </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>generic</term>
+       <listitem>
+        <para>
+         Offers a compile option for ODBC driver managers that are not
+         explicitly supported by PDO_ODBC.
+        </para>
+       </listitem>
+      </varlistentry>
+     </variablelist>
     </para>
     <para>
      On Windows, PDO_ODBC is built into the PHP core by default. It is linked
@@ -24,6 +53,10 @@
      connecting to Microsoft SQL Server databases.
     </para>
    </section>
+
+   <!-- Information found in configure.xml -->
+   &reference.pdo-odbc.configure;
+  <!-- Information found in ini.xml -->
    &reference.pdo-odbc.ini;
   </partintro>