mfp Thu Aug 4 07:41:40 2005 EDT
Modified files:
/phpdoc/en/reference/sdo reference.xml
Log:
Improvements to Install section - Include link to PECL snaps; describe
alterations to php.ini.
http://cvs.php.net/diff.php/phpdoc/en/reference/sdo/reference.xml?r1=1.12&r2=1.13&ty=u
Index: phpdoc/en/reference/sdo/reference.xml
diff -u phpdoc/en/reference/sdo/reference.xml:1.12
phpdoc/en/reference/sdo/reference.xml:1.13
--- phpdoc/en/reference/sdo/reference.xml:1.12 Wed Aug 3 10:29:59 2005
+++ phpdoc/en/reference/sdo/reference.xml Thu Aug 4 07:41:38 2005
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.12 $ -->
+<!-- $Revision: 1.13 $ -->
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc.
-->
<reference id="ref.sdo">
<title>SDO Functions</title>
@@ -92,124 +92,153 @@
version (a .tgz file from the PECL site) or the latest from CVS.
The Relational DAS also needs special attention as it is written in
PHP.
- </para>
- <para>
- The instructions are likely to change as PHP 5.1 progresses in status
- from beta to stable release. The instructions here were correct on 3rd
- August 2005, when PHP 5.1.0b3 was the current beta release of
- PHP, and 0.5.0 was the current beta release of SDO.
- </para>
- <para>
- The options are summarised in the following table:
- <informaltable>
- <tgroup cols='3'>
- <thead>
- <row>
- <entry>latest CVS/Release</entry>
- <entry>Windows</entry>
- <entry>Linux</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>
- latest CVS
- </entry>
- <entry>
- <itemizedlist>
- <listitem>
- <para>
- You will find the latest DLLs for the SDO core and the
- XML DAS at the PHP snaps site.
- The "PECL extensions for the unstable win32 branch" link points
- to the list of recently built DLLs. The latest sdo core is
- <filename>php_sdo.dll</filename>
- .
- The latest XML DAS is
- <filename>php_sdo_das_xml.dll</filename>
- .
- </para>
- </listitem>
- <listitem>
- <para>
- Check out the Relational DAS from CVS to somewhere on the
- PHP
- <link linkend="ini.include-path">include_path</link>
- .
- </para>
- </listitem>
- </itemizedlist>
- </entry>
- <entry>
- <itemizedlist>
- <listitem>
- <para>
- Check out the SDO core and the XML DAS from CVS
- and build according to the instructions
- immediately following for building on Linux.
- </para>
- </listitem>
- <listitem>
- <para>
- Check out the Relational DAS from CVS to somewhere on the
- PHP
- <link linkend="ini.include-path">include_path</link>
- .
- </para>
- </listitem>
- </itemizedlist>
- </entry>
- </row>
- <row>
- <entry>
- Release
- </entry>
- <entry>
- <itemizedlist>
- <listitem>
- <para>
- There is currently no way provided for building the release
- version of the SDO core and XML DAS on a user's machine.
- You will only be able to pick up the latest DLLs from the
- snaps site (see previous row of this table).
- </para>
- </listitem>
- <listitem>
- <para>
- The Relational DAS can be downloaded and installed with
- </para>
- <para>
- <command>
- pear -B install sdo-0.5.0
- </command>
- .
- </para>
- </listitem>
- </itemizedlist>
- </entry>
- <entry>
- <itemizedlist>
- <listitem>
- <para>
- You can download and install all three SDO components - the
- SDO core, the XML DAS and the Relational DAS - with the
- command
- <command>
- pear install sdo-0.5.0
- </command>
- .
- This will build the SDO and XML shared libraries as well as
- installing the PHP files that make the Relational DAS.
- </para>
- </listitem>
- </itemizedlist>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
+ </para>
+ <para>
+ The instructions are likely to change as PHP 5.1 progresses in status
+ from beta to stable release. The instructions here were correct on 3rd
+ August 2005, when PHP 5.1.0b3 was the current beta release of
+ PHP, and 0.5.0 was the current beta release of SDO.
+ </para>
+ <para>
+ The options are summarised in the following table:
+ <informaltable>
+ <tgroup cols='3'>
+ <thead>
+ <row>
+ <entry>latest/Release</entry>
+ <entry>Windows</entry>
+ <entry>Linux</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ latest CVS
+ </entry>
+ <entry>
+ <itemizedlist>
+ <listitem>
+ <para>
+ You will find the latest DLLs for the SDO core and the
+ XML DAS at the PHP snaps site. Follow the link to
+ <ulink url='&url.pecl.get.win.unstable;'>
+ "PECL extensions for the unstable win32 branch"
+ </ulink>
+ for the list of recently built DLLs. The latest sdo core DLL is
+ <filename>php_sdo.dll</filename>
+ and the latest XML DAS DLL is
+ <filename>php_sdo_das_xml.dll</filename>
+ .
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Check out the Relational DAS from CVS to somewhere on the
+ PHP
+ <link linkend="ini.include-path">include_path</link>
+ .
+ </para>
+ </listitem>
+ </itemizedlist>
+ </entry>
+ <entry>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Check out the SDO core and the XML DAS from CVS
+ and build according to the instructions
+ below for building on Linux.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Check out the Relational DAS from CVS to somewhere on the
+ PHP
+ <link linkend="ini.include-path">include_path</link>
+ .
+ </para>
+ </listitem>
+ </itemizedlist>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ Release
+ </entry>
+ <entry>
+ <itemizedlist>
+ <listitem>
+ <para>
+ There is currently no way provided for building the release
+ version of the SDO core and XML DAS on a user's machine.
+ You will only be able to pick up the latest DLLs from the
+ snaps site (see previous row of this table).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The Relational DAS can be downloaded and installed with
+ </para>
+ <para>
+ <command>
+ pear -B install sdo-0.5.0
+ </command>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </entry>
+ <entry>
+ <itemizedlist>
+ <listitem>
+ <para>
+ You can download and install all three SDO components - the
+ SDO core, the XML DAS and the Relational DAS - with the
+ command
+ <command>
+ pear install sdo-0.5.0
+ </command>
+ .
+ This will build the SDO and XML shared libraries as well as
+ installing the PHP files that make the Relational DAS.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Regardless of which platform or which level of the code you have installed
+ you will need add the two extension libraries to your &php.ini; file.
+ On Windows, add:
+ <programlisting role="php" id="sdo.installation.ini.windows">
+<![CDATA[
+extension=php_sdo.dll
+extension=php_sdo_das_xml.dll
+]]>
+ </programlisting>
+ On Linux, add:
+ <programlisting role="php" id="sdo.installation.ini.linux">
+<![CDATA[
+extension=sdo.so
+extension=sdo_das_xml.so
+]]>
+ </programlisting>
+ You may also need to update your
+ <link linkend="ini.extension-dir">extension_dir</link>
+ in &php.ini; to point to the location of these libraries.
+ </para>
+ <para>
+ The Relational DAS is written in PHP. You may need to
+ update your
+ <link linkend="ini.include-path">include_path</link>
+ in &php.ini; to point to the directory that contains
+ <filename>sdo/DAS/Relational</filename>
+ .
+ </para>
<procedure id='sdo.build.linux.steps'>
<title>Building SDO on Linux</title>
<para>
