diff --git a/reference/sdo/reference.xml b/reference/sdo/reference.xml index a036960a4c..2eddd25a90 100644 --- a/reference/sdo/reference.xml +++ b/reference/sdo/reference.xml @@ -1,5 +1,5 @@ - + SDO Functions @@ -87,34 +87,141 @@
&reftitle.install; - SDO extension can be installed using pear. However as it is - still in it's beta you need set pear option 'preferred_state' to beta. - like pear -D preferred_state=beta install sdo . - If you want to install this extension manually on Linux, you - can do so by following steps described below. - - - Linux installation steps + There are several options, depending on whether you are installing on + Windows or Linux, and depending on whether you are installing a released + 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. + + + 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. + + + The options are summarised in the following table: + + + + + latest CVS/Release + Windows + Linux + + + + + + latest CVS + + + + + + 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 + php_sdo.dll + . + The latest XML DAS is + php_sdo_das_xml.dll + . + + + + + Check out the Relational DAS from CVS to somewhere on the + PHP + include_path + . + + + + + + + + + Check out the SDO core and the XML DAS from CVS + and build according to the instructions + immediately following for building on Linux. + + + + + Check out the Relational DAS from CVS to somewhere on the + PHP + include_path + . + + + + + + + + Release + + + + + + 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). + + + + + The Relational DAS can be downloaded and installed with + + + + pear -B install sdo-0.5.0 + + . + + + + + + + + + You can download and install all three SDO components - the + SDO core, the XML DAS and the Relational DAS - with the + command + + pear install sdo-0.5.0 + + . + This will build the SDO and XML shared libraries as well as + installing the PHP files that make the Relational DAS. + + + + + + + + + + + + Building SDO on Linux - The following instructions describe how to install the - SDO extension on Linux. Note, these steps will also install the - XML Data Access Service - which is packaged as part of this extension. + This section describes how to build the SDO core and XML DAS on Linux. + Currently you would only need to know how to do this if you + wish to build a recent version that you have checked out + of CVS. - - - Download the SDO extension from the pecl/sdo directory on CVS. - - - - - Untar the downloaded image in your favourite folder. - - Change to the main extension directory: - cd sdo-< version > + cd < wherever your sdo code is >