* Thus wrote Olivier Hill:
> Hello,
> 
> I have written the part in the manual about installing PHP on Gentoo
> at the beginning of the summer. I can see now that it is online.
> 
> My question is, is there any way to force the manual build so that the
> Gentoo part of the UNIX installation is in a different file? The fact
> that it is on the main "UNIX install" page is bugging me.

That sort of bugs me as well, Its mostly due to the way phpweb is
built.  Attached is a fix so that the introduction has its own
<sect1> forcing the gentoo not to be displayed on the first page.

Example phpweb rendering:
  http://phpweb.zirzow.dyndns.org/manual/en/install.unix.php

Any objections to this patch?



Curt
-- 
First, let me assure you that this is not one of those shady pyramid schemes
you've been hearing about.  No, sir.  Our model is the trapezoid!
Index: index.xml
===================================================================
RCS file: /repository/phpdoc/en/install/unix/index.xml,v
retrieving revision 1.2
diff -u -r1.2 index.xml
--- index.xml   14 Jun 2004 20:58:34 -0000      1.2
+++ index.xml   2 Sep 2004 04:29:51 -0000
@@ -2,83 +2,78 @@
 <!-- $Revision: 1.2 $ -->
   <chapter id="install.unix">
    <title>Installation on Unix systems</title>
-   <para>
-    This section will guide you through the general configuration and
-    installation of PHP on Unix systems. Be sure to investigate any
-    sections specific to your platform or web server before you begin
-    the process.
-   </para>
-   <para>
-    As our manual outlines in the <link linkend="install.general">General
-    Installation Considerations</link> section, we are mainly dealing with
-    web centric setups of PHP in this section, although we will cover
-    setting up PHP for command line usage as well.
-   </para>
-   <para> 
-    There are several ways to install PHP for the Unix platform, either
-    with a compile and configure process, or through various
-    pre-packaged methods. This documentation is mainly focused around
-    the process of compiling and configuring PHP. Many Unix like systems
-    have some sort of package installation system. This can assist in
-    setting up a standard configuration, but if you need to have a
-    different set of features (such as a secure server, or a different
-    database driver), you may need to build PHP and/or your webserver.
-    If you are unfamiliar with building and compiling your own software,
-    it is worth checking to see whether somebody has already built a
-    packaged version of PHP with the features you need.
-   </para>
-   <para>
-    Prerequisite knowledge and software for compiling:
-    <itemizedlist>
-     <listitem>
-      <simpara>
-       Basic Unix skills (being able to operate "make" and a C
-       compiler)
-      </simpara>
-     </listitem> 
-     <listitem>
-      <simpara>
-       An ANSI C compiler
-      </simpara>
-     </listitem> 
-     <listitem>
-      <simpara>
-       flex
-      </simpara>
-     </listitem>
-     <listitem>
-      <simpara>
-       bison
-      </simpara>
-     </listitem>
-     <listitem>
-      <simpara>
-       A web server
-      </simpara>
-     </listitem>
-     <listitem>
-      <simpara>
-       Any module specific components (such as gd, pdf libs, etc.)
-      </simpara>
-     </listitem>
-    </itemizedlist>
-   </para>
-   
-   <para>
-    The initial PHP setup and configuration process is controlled by the
-    use of the commandline options of the <filename>configure</filename>
-    script. Our manual documents the different options separately. You will
-    find the <link linkend="configure">core options in the appendix</link>,
-    while the different extension specific options are descibed on the
-    reference pages.
-   </para>
-    
-   <para>
-    When PHP is configured, you are ready to build the module and/or
-    executables. The command <command>make</command> should
-    take care of this. If it fails and you can't figure out why, see
-    the <link linkend="install.problems">Problems section</link>.
-   </para>
+   <sect1 id="install.unix.intro">
+    <title>Intro</title>
+    <para>
+     This section will guide you through the general configuration and
+     installation of PHP on Unix systems. Be sure to investigate any
+     sections specific to your platform or web server before you begin
+     the process.
+    </para>
+    <para>
+     As our manual outlines in the <link linkend="install.general">General
+     Installation Considerations</link> section, we are mainly dealing with
+     web centric setups of PHP in this section, although we will cover
+     setting up PHP for command line usage as well.
+    </para>
+    <para> 
+     There are several ways to install PHP for the Unix platform, either
+     with a compile and configure process, or through various
+     pre-packaged methods. This documentation is mainly focused around
+     the process of compiling and configuring PHP. Many Unix like systems
+     have some sort of package installation system. This can assist in
+     setting up a standard configuration, but if you need to have a
+     different set of features (such as a secure server, or a different
+     database driver), you may need to build PHP and/or your webserver.
+     If you are unfamiliar with building and compiling your own software,
+     it is worth checking to see whether somebody has already built a
+     packaged version of PHP with the features you need.
+    </para>
+    <para>
+     Prerequisite knowledge and software for compiling:
+     <itemizedlist>
+      <listitem>
+       <simpara>
+        Basic Unix skills (being able to operate "make" and a C
+        compiler)
+       </simpara>
+      </listitem> 
+      <listitem>
+       <simpara>
+        An ANSI C compiler
+       </simpara>
+      </listitem> 
+      <listitem>
+       <simpara>
+        flex
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+        bison
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+        A web server
+       </simpara>
+      </listitem>
+      <listitem>
+       <simpara>
+        Any module specific components (such as gd, pdf libs, etc.)
+       </simpara>
+      </listitem>
+     </itemizedlist>
+    </para>
+    <para>
+     The initial PHP setup and configuration process is controlled by the
+     use of the commandline options of the <filename>configure</filename>
+     script. Our manual documents the different options separately. You will
+     find the <link linkend="configure">core options in the appendix</link>,
+     while the different extension specific options are descibed on the
+     reference pages.
+    </para>
+   </sect1>
    
    &install.unix.gentoo;
    &install.unix.hpux;

Reply via email to