cvs: phpdoc /en/chapters config.xml install.hpux.xml tutorial.xml

derick Sun Jun 22 11:09:22 2003 EDT Modified files: /phpdoc/en/chapters config.xml install.hpux.xml tutorial.xml Log: - Summer cleaning time!

Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.107 phpdoc/en/chapters/config.xml:1.108 --- phpdoc/en/chapters/config.xml:1.107 Mon Jun 9 07:40:31 2003 +++ phpdoc/en/chapters/config.xml Sun Jun 22 11:09:22 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.107 $ --> +<!-- $Revision: 1.108 $ --> <chapter id="configuration"> <title>Runtime Configuration</title> @@ -112,20 +112,13 @@ Sets the value of the specified directive. Can be used only with <constant>PHP_INI_ALL</constant> and <constant>PHP_INI_PERDIR</constant> type directives. To clear a previously set value use <literal>none</literal> as the value. - <informalexample> - <programlisting role="ini"> -<![CDATA[ -php_value auto_prepend_file none -]]> - </programlisting> - </informalexample> </para> - <note> - <simpara> - Don't use <literal>php_value</literal> to set boolean values. - <literal>php_flag</literal> (see below) should be used instead. - </simpara> - </note> + <note> + <simpara> + Don't use <literal>php_value</literal> to set boolean values. + <literal>php_flag</literal> (see below) should be used instead. + </simpara> + </note> </listitem> </varlistentry> <varlistentry> @@ -154,13 +147,6 @@ Any directive type set with <systemitem role="directive">php_admin_value</systemitem> can not be overridden by &htaccess; or virtualhost directives. To clear a previously set value use <literal>none</literal> as the value. - <informalexample> - <programlisting role="ini"> -<![CDATA[ -php_admin_value open_basedir none -]]> - </programlisting> - </informalexample> </para> </listitem> </varlistentry> @@ -197,19 +183,18 @@ ]]> </programlisting> </example> - - <note> - <para> - PHP constants do not exist outside of PHP. For example, in - &httpd.conf; you can not use PHP constants - such as <constant>E_ALL</constant> or <constant>E_NOTICE</constant> - to set the <link linkend="ini.error-reporting">error_reporting</link> - directive as they will have no meaning and will evaluate to - <emphasis>0</emphasis>. Use the associated bitmask values instead. - These constants can be used in &php.ini; - </para> - </note> </para> + <caution> + <para> + PHP constants do not exist outside of PHP. For example, in + &httpd.conf; you can not use PHP constants + such as <constant>E_ALL</constant> or <constant>E_NOTICE</constant> + to set the <link linkend="ini.error-reporting">error_reporting</link> + directive as they will have no meaning and will evaluate to + <emphasis>0</emphasis>. Use the associated bitmask values instead. + These constants can be used in &php.ini; + </para> + </caution> </sect2> <sect2 id="configuration.changes.other"> @@ -1289,8 +1274,12 @@ <sect2 id="ini.sect.debugger"> <title>Debugger Configuration Directives</title> - <variablelist> + <caution> + Only PHP 3 implements a default debugger, for more information see <xref + linkend="debugger">Debugging PHP</xref>. + </caution> + <variablelist> <varlistentry id="ini.debugger.host"> <term> <parameter>debugger.host</parameter> Index: phpdoc/en/chapters/install.hpux.xml diff -u phpdoc/en/chapters/install.hpux.xml:1.2 phpdoc/en/chapters/install.hpux.xml:1.3 --- phpdoc/en/chapters/install.hpux.xml:1.2 Mon Feb 17 15:40:50 2003 +++ phpdoc/en/chapters/install.hpux.xml Sun Jun 22 11:09:22 2003 @@ -1,87 +1,120 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <sect1 id="install.hpux"> <title>Unix/HP-UX installs</title> <para> This section contains notes and hints specific to installing PHP - on HP-UX systems. + on HP-UX systems. (Contributed by paul_mckay at clearwater-it dot co dot + uk). </para> - <example id="install.hpux.example"> - <title> - Installation Instructions for HP-UX 10 - </title> - <screen> -<![CDATA[ -From: paul_mckay@clearwater-it.co.uk -04-Jan-2001 09:49 -(These tips are for PHP 4.0.4 and Apache v1.3.9) - -So you want to install PHP and Apache on a HP-UX 10.20 box? - -1. You need gzip, download a binary distribution from -http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z -uncompress the file and install using swinstall - -2. You need gcc, download a binary distribution from -http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz -gunzip this file and install gcc using swinstall. - -3. You need the GNU binutils, you can download a binary distribution from -http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz -gunzip and install using swinstall. - -4. You now need bison, you can download a binary distribution from -http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz -install as above. - -5. You now need flex, you need to download the source from one of the -http://www.gnu.org mirrors. It is in the non-gnu directory of the ftp site. -Download the file, gunzip, then tar -xvf it. Go into the newly created flex -directory and do a ./configure, then a make, and then a make install - -If you have errors here, it's probably because gcc etc. are not in your -PATH so add them to your PATH. - -Right, now into the hard stuff. - -6. Download the PHP and apache sources. - -7. gunzip and tar -xvf them. - -We need to hack a couple of files so that they can compile ok. - -8. Firstly the configure file needs to be hacked because it seems to lose -track of the fact that you are a hpux machine, there will be a -better way of doing this but a cheap and cheerful hack is to put - lt_target=hpux10.20 -on line 47286 of the configure script. - -9. Next, the Apache GuessOS file needs to be hacked. Under -apache_1.3.9/src/helpers change line 89 from - "echo "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0" -to: - "echo "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0" - -10. You cannot install PHP as a shared object under HP-UX so you must compile -it as a static, just follow the instructions at the Apache page. - -11. PHP and apache should have compiled OK, but Apache won't start. you need -to create a new user for Apache, eg www, or apache. You then change lines 252 -and 253 of the conf/httpd.conf in Apache so that instead of - User nobody - Group nogroup -you have something like - User www - Group sys - -This is because you can't run Apache as nobody under hp-ux. -Apache and PHP should then work. - -Hope this helps somebody, -Paul Mckay. -]]> - </screen> - </example> + <note> + <simpara> + These tips were written for PHP 4.0.4 and Apache 1.3.9. + </simpara> + </note> + <para> + <orderedlist> + <listitem> + <para> + You need gzip, download a binary distribution from + <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z</filename> + uncompress the file and install using swinstall + </para> + </listitem> + <listitem> + <para> + You need gcc, download a binary distribution from + <filename>http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz</filename>. + gunzip this file and install gcc using swinstall. + </para> + </listitem> + <listitem> + <para> + You need the GNU binutils, you can download a binary distribution from + <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz</filename>. + gunzip and install using swinstall. + </para> + </listitem> + <listitem> + <para> + You now need bison, you can download a binary distribution from + <filename>http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz</filename>, + install as above. + </para> + </listitem> + <listitem> + <para> + You now need flex, you need to download the source from one of the + http://www.gnu.org mirrors. It is in the non-gnu directory of the ftp + site. Download the file, gunzip, then <literal>tar -xvf</literal> it. + Go into the newly created flex directory and do a ./configure, then a + make, and then a make install + </para> + <para> + If you have errors here, it's probably because gcc etc. are not in your + PATH so add them to your PATH. + </para> + </listitem> + <listitem> + <para> + Download the PHP and apache sources. + </para> + </listitem> + <listitem> + <para> + <command>gunzip</command> and <command>tar -xvf</command> them. We + need to hack a couple of files so that they can compile ok. + </para> + </listitem> + <listitem> + <para> + Firstly the configure file needs to be hacked because it seems to lose + track of the fact that you are a hpux machine, there will be a better + way of doing this but a cheap and cheerful hack is to put + <literal>lt_target=hpux10.20</literal> on line 47286 of the configure + script. + </para> + </listitem> + <listitem> + <para> + Next, the Apache GuessOS file needs to be hacked. Under + apache_1.3.9/src/helpers change line 89 from <literal>echo + "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0</literal> to: <literal>echo + "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0</literal> + </para> + </listitem> + <listitem> + <para> + You cannot install PHP as a shared object under HP-UX so you must + compile it as a static, just follow the instructions at the Apache + page. + </para> + </listitem> + <listitem> + <para> + PHP and Apache should have compiled OK, but Apache won't start. you + need to create a new user for Apache, eg www, or apache. You then + change lines 252 and 253 of the conf/httpd.conf in Apache so that + instead of + </para> + <screen> +User nobody +Group nogroup + </screen> + <para> + you have something like + </para> + <screen> +User www +Group sys + </screen> + <para> + This is because you can't run Apache as nobody under hp-ux. Apache and + PHP should then work. + </para> + </listitem> + </orderedlist> + </para> </sect1> @@ -104,4 +137,4 @@ 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 +--> Index: phpdoc/en/chapters/tutorial.xml diff -u phpdoc/en/chapters/tutorial.xml:1.21 phpdoc/en/chapters/tutorial.xml:1.22 --- phpdoc/en/chapters/tutorial.xml:1.21 Fri Jun 6 01:33:09 2003 +++ phpdoc/en/chapters/tutorial.xml Sun Jun 22 11:09:22 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <chapter id="tutorial"> <title>A simple tutorial</title> @@ -85,8 +85,7 @@ If everything is setup correctly, this file will be parsed by PHP and the following output will make it to your browser: </simpara> - <para> - <screen role="html"> + <screen role="html"> <![CDATA[ <html> <head> @@ -97,8 +96,7 @@ </body> </html> ]]> - </screen> - </para> + </screen> </example> </para> <para> @@ -193,7 +191,6 @@ is <varname>$_SERVER["HTTP_USER_AGENT"]</varname>. </para> <note> - <title>PHP Autoglobals Note</title> <para> <link linkend="reserved.variables.server">$_SERVER</link> is a special reserved PHP variable that contains all web server information. @@ -220,10 +217,10 @@ </programlisting> <para> A sample output of this script may be: - <screen role="html"> -Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0) - </screen> </para> + <screen role="html"> +Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0) + </screen> </example> </para> <para> @@ -275,12 +272,12 @@ </programlisting> <para> A sample output of this script may be: - <screen role="html"> + </para> + <screen role="html"> <![CDATA[ You are using Internet Explorer<br /> ]]> - </screen> - </para> + </screen> </example> </para> <para> @@ -339,13 +336,13 @@ </programlisting> <para> A sample output of this script may be: - <screen role="html"> + </para> + <screen role="html"> <![CDATA[ <h3>strstr must have returned true</h3> <center><b>You are using Internet Explorer</b></center> ]]> - </screen> - </para> + </screen> </example> </para> <para> @@ -400,13 +397,13 @@ </programlisting> <para> A sample output of this script may be: - <screen role="html"> + </para> + <screen role="html"> <![CDATA[ Hi Joe. You are 22 years old. ]]> - </screen> - </para> + </screen> </example> </para> <para>