From dc6882a311e06281d7e5a94b36476289e54223ca Mon Sep 17 00:00:00 2001
From: Friedhelm Betz <betz@php.net>
Date: Mon, 23 Jun 2003 17:33:28 +0000
Subject: [PATCH] examples to xml, restructering

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@133058 c90b9560-bf6c-de11-be94-00142212c4b1
---
 chapters/install.iplanet.xml | 314 +++++++++++++++++++++--------------
 1 file changed, 186 insertions(+), 128 deletions(-)

diff --git a/chapters/install.iplanet.xml b/chapters/install.iplanet.xml
index 293210f3e7..9b5221b1dc 100644
--- a/chapters/install.iplanet.xml
+++ b/chapters/install.iplanet.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <sect1 id="install.netscape-enterprise">
    <title>Servers-Netscape and iPlanet</title>
    <para>
@@ -8,153 +8,211 @@
     and <link linkend="install.netscape.windows">Windows</link> versions.
    </para>
    <para>
-    You can find more information about setting up PHP for
-    the Netscape Enterprise Server here:
+    You can find more information about setting up PHP for the Netscape
+    Enterprise Server (NES) here:
     <ulink url="&url.netscape.nsapi;">&url.netscape.nsapi;</ulink>
    </para>
    <sect2 id="install.netscape.sun">
     <title>Installing PHP with Netscape on Sun Solaris</title>
     <para>
-     To build PHP with NES or iPlanet web servers, enter the proper
-     install directory for the 
-     <link linkend="install.configure.with-nsapi">--with-nsapi</link>
-     = <replaceable>DIR</replaceable> option. The default
-     directory is usually <filename class="directory">/opt/netscape/suitespot/</filename>.
+     To build PHP with NES or iPlanet web servers, enter the proper install
+     directory for the 
+     <link linkend="install.configure.with-nsapi">--with-nsapi=[DIR]</link>
+     option. The default directory is usually
+     <filename class="directory">/opt/netscape/suitespot/</filename>.
      Please also read <filename>/php-xxx-version/sapi/nsapi/nsapi-readme.txt</filename>. 
     </para>
+    <note>
+     <simpara>
+      These instructions are written for Sun Solaris 2.6 with Netscape
+      Enterprise Server 3.6, conributed by bhager at invacare dot com.
+     </simpara>
+    </note>
     <para>
-     <example id="install.netscape-enterprise.solaris">
-      <title>Installation Example for Netscape Enterprise on Solaris</title>
-      <screen>
+     <orderedlist>
+      <listitem>
+       <para>
+        Install the following packages from <ulink url="&url.sun.freeware;">
+        &url.sun.freeware;</ulink> or another download site: 
+        <simplelist>
+         <member><filename>autoconf-2.13</filename></member>
+         <member><filename>automake-1.4</filename></member>
+         <member><filename>bison-1_25-sol26-sparc-local</filename></member>
+         <member><filename>flex-2_5_4a-sol26-sparc-local</filename></member>
+         <member><filename>gcc-2_95_2-sol26-sparc-local</filename></member>
+         <member><filename>gzip-1.2.4-sol26-sparc-local</filename></member>
+         <member><filename>m4-1_4-sol26-sparc-local</filename></member>
+         <member><filename>make-3_76_1-sol26-sparc-local</filename></member>
+         <member>
+          <filename>mysql-3.23.24-beta</filename> (if you want mysql support)
+         </member>
+         <member><filename>perl-5_005_03-sol26-sparc-local</filename></member>
+         <member><filename>tar-1.13</filename> (GNU tar)</member>
+        </simplelist>
+       </para>
+      </listitem>
+      <listitem>
+       <simpara>
+        Make sure your path includes the proper directories
+        <literal>PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin</literal>
+        and make it available to your system <userinput>export PATH</userinput>.
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+        <userinput>gunzip php-x.x.x.tar.gz</userinput> (if you have a .gz dist,
+        otherwise go to 4).
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+        <userinput>tar xvf php-x.x.x.tar</userinput>
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+        Change to your extracted PHP directory:
+        <userinput>cd ../php-x.x.x </userinput>
+       </simpara>
+      </listitem>
+      <listitem>
+       <para>
+        For the following step, make sure
+        <filename class="directory">/opt/netscape/suitespot/</filename> is
+        where your netscape server is installed. Otherwise, change to the
+        correct path and run:
+        <programlisting role="shell">
 <![CDATA[
-Instructions for Sun Solaris 2.6 with Netscape Enterprise Server 3.6
-From: bhager@invacare.com
-
-1. Install the following packages from www.sunfreeware.com or another
-download site: 
-
-    flex-2_5_4a-sol26-sparc-local 
-    gcc-2_95_2-sol26-sparc-local 
-    gzip-1.2.4-sol26-sparc-local 
-    perl-5_005_03-sol26-sparc-local 
-    bison-1_25-sol26-sparc-local 
-    make-3_76_1-sol26-sparc-local 
-    m4-1_4-sol26-sparc-local 
-    autoconf-2.13 
-    automake-1.4 
-    mysql-3.23.24-beta (if you want mysql support) 
-    tar-1.13 (GNU tar) 
-
-2. Make sure your path includes the proper directories
-    PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin 
-    export PATH 
-
-3. gunzip php-x.x.x.tar.gz (if you have a .gz dist, otherwise go to 4) 
-4. tar xvf php-x.x.x.tar 
-5. cd ../php-x.x.x 
-
-6. For the following step, make sure /opt/netscape/suitespot/ is where
-   your netscape server is installed. Otherwise, change to correct path:
-    /configure --with-mysql=/usr/local/mysql --with-nsapi=/opt/netscape/suitespot/ --enable-track-vars --enable-libgcc 
-7. make 
-8. make install
+./configure --with-mysql=/usr/local/mysql \
+--with-nsapi=/opt/netscape/suitespot/ \
+--enable-libgcc
 ]]>
-      </screen>
-     </example>
-     After performing the base install and reading the appropriate
-     readme file, you may need to performs some additional
-     configuration steps.
+        </programlisting>
+       </para>
+      </listitem>
+      <listitem>
+       <simpara>
+        Run <command>make</command> followed by <command>make install</command>.
+       </simpara>
+      </listitem>
+     </orderedlist>
     </para>
     <para>
-     Firstly you may need to add some paths to the LD_LIBRARY_PATH 
-     environment for Netscape to find all the shared libs. This can 
-     best done in the start script for your Netscape server. 
-     Windows users can probably skip this step. The start 
-     script is often located in:
-     <filename
-     class="directory">/path/to/server/https-servername/start</filename> 
+     After performing the base install and reading the appropriate readme file,
+     you may need to perform some additional configuration steps.
     </para>
-    <para>
-     You may also need to edit the configuration files that are
-     located in:<filename
-     class="directory">/path/to/server/https-servername/config/</filename>.
-    </para>
-
-    <example id="install.netscape-enterprise.configure">
-     <title>
-      Configuration Example for Netscape Enterprise
-     </title>
-     <screen>
+    <formalpara>
+     <title>Configuration Instructions for NES</title>
+     <para>
+      Firstly you may need to add some paths to the LD_LIBRARY_PATH environment
+      for Netscape to find all the shared libs. This can best done in the start
+      script for your Netscape server. Windows users can probably skip this
+      step. The start script is often located in: <filename
+      class="directory">/path/to/server/https-servername/start</filename>.
+      You may also need to edit the configuration files that are
+      located in: <filename
+      class="directory">/path/to/server/https-servername/config/</filename>.
+      <orderedlist>
+       <listitem>
+        <para>
+         Add the following line to <filename>mime.types</filename>:
+         <screen>
 <![CDATA[
-Configuration Instructions for Netscape Enterprise Server
-From: bhager@invacare.com
-
-1. Add the following line to mime.types:
-    type=magnus-internal/x-httpd-php exts=php
-
-2. Add the following to obj.conf, shlib will vary depending on
-    your OS, for unix it will be something like
-    /opt/netscape/suitespot/bin/libphp4.so.
-
-    You should place the following lines after mime types init.
-    Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="/php4/nsapiPHP4.dll"
-    Init fn=php4_init errorString="Failed to initialize PHP!"
-
-    <object name="default">
-    . 
-    . 
-    . 
-    .#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines 
-    Service fn="php4_execute" type="magnus-internal/x-httpd-php" 
+type=magnus-internal/x-httpd-php exts=php
+]]>
+         </screen>
+        </para>
+       </listitem>
+       <listitem>
+        <para>
+         Edit <filename>obj.conf</filename> and add the following, shlib will
+         vary depending on your OS, for Unix it will be something like
+         <filename>/opt/netscape/suitespot/bin/libphp4.so</filename>. You should
+         place the following lines after <literal>mime types init</literal>.
+         <programlisting>
+<![CDATA[
+Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="/php4/nsapiPHP4.dll"
+Init fn=php4_init errorString="Failed to initialize PHP!"
+]]>
+         </programlisting>
+        </para>
+       </listitem>
+       <listitem>
+        <para>
+         Configure the default object:
+         <programlisting>
+<![CDATA[
+<object name="default">
+.
+.
+.
+.#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines 
+Service fn="php4_execute" type="magnus-internal/x-httpd-php" 
     . 
     . 
     </Object>
-
-
-    <Object name="x-httpd-php"> 
-    ObjectType fn="force-type" type="magnus-internal/x-httpd-php" 
-    Service fn=php4_execute 
-    </Object> 
-
-
-    Authentication configuration 
-
-    PHP authentication cannot be used with any other authentication. ALL AUTHENTICATION IS 
-    PASSED TO YOUR PHP SCRIPT. To configure PHP Authentication for the entire server, add 
-    the following line: 
-
-    <Object name="default"> 
-    AuthTrans fn=php4_auth_trans 
-    . 
-    . 
-    . 
-    . 
-    </Object> 
-
-    To use PHP Authentication on a single directory, add the following: 
-
-    <Object ppath="d:\path\to\authenticated\dir\*"> 
-    AuthTrans fn=php4_auth_trans 
-    </Object>
 ]]>
-     </screen>
-    </example>
+         </programlisting>
+        </para>
+       </listitem>
+       <listitem>
+        <para>
+         Create a new object for the usage of PHP:
+         <programlisting>
+<![CDATA[
+<Object name="x-httpd-php"> 
+ObjectType fn="force-type" type="magnus-internal/x-httpd-php" 
+Service fn=php4_execute 
+</Object> 
+]]>
+         </programlisting>
+        </para>
+       </listitem>
+       <listitem>
+        <para>
+         Setup of authentication: PHP authentication cannot be used with any
+         other authentication. ALL AUTHENTICATION IS PASSED TO YOUR PHP SCRIPT.
+         To configure PHP Authentication for the entire server, add the
+         following line to your default object: 
+         <programlisting>
+<![CDATA[
+<Object name="default">
+AuthTrans fn=php4_auth_trans
+.
+.
+.
+</Object>
+]]>
+         </programlisting>
+        </para>
+       </listitem>
+       <listitem>
+        <para>
+         To use PHP Authentication on a single directory, add the following: 
+         <programlisting>
+<![CDATA[
+<Object ppath="d:\path\to\authenticated\dir\*"> 
+AuthTrans fn=php4_auth_trans 
+</Object>
+]]>
+         </programlisting>
+        </para>
+       </listitem>
+      </orderedlist>
+     </para>
+    </formalpara>
     <para>
-     If you are running Netscape Enterprise 4.x, then you should use the following:
-    </para>
-    <example>
-     <title>Configuration Example for Netscape Enterprise 4.x</title>
+     If you are running Netscape Enterprise 4.x, then you should use the
+     following: Place these lines after the <literal>mime types init</literal>,
+     and everything else is similar to the example configuration above.
+     (Contributed by Graeme Hoose, GraemeHoose at BrightStation dot com).
      <programlisting>
 <![CDATA[
-Place these lines after the mime types init, and everything else is similar
-to the example configuration above.
-From: Graeme Hoose (GraemeHoose@BrightStation.com)
-
 Init fn="load-modules" shlib="/path/to/server4/bin/libphp4.so" funcs="php4_init,php4_close,php4_execute,php4_auth_trans"
 Init fn="php4_init" LateInit="yes"
 ]]>
      </programlisting>
-    </example>
+    </para>
    </sect2>
    <sect2 id="install.netscape.windows">
     <title>Installing PHP with Netscape on Windows</title>
@@ -166,14 +224,14 @@ Init fn="php4_init" LateInit="yes"
      <listitem>
       <simpara>
        Copy <filename>php4ts.dll</filename> to your systemroot
-       (the directory where you installed windows)
+       (the directory where you installed Windows)
       </simpara>
      </listitem>
      <listitem>
       <para>
        Make a file association from the command line.
        Type the following two lines:
-       <programlisting>
+       <programlisting role="shell">
 <![CDATA[
 assoc .php=PHPScript
 ftype PHPScript=c:\php\php.exe %1 %*
@@ -215,14 +273,14 @@ ftype PHPScript=c:\php\php.exe %1 %*
      <listitem>
       <simpara>
        Copy <filename>php4ts.dll</filename> to your systemroot
-       (the directory where you installed windows)
+       (the directory where you installed Windows)
       </simpara>
      </listitem>
      <listitem>
       <para>
        Make a file association from the command line.
        Type the following two lines:
-       <programlisting>
+       <programlisting role="shell">
 <![CDATA[
 assoc .php=PHPScript
 ftype PHPScript=c:\php\php.exe %1 %*
@@ -314,4 +372,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->