cortesi Wed Apr 17 13:35:57 2002 EDT
Modified files:
/phpdoc/en/faq build.xml
Log:
adding consistency to the FAQ
we dont usually use quotes around <command> tags
adding some docbook tags, where missin
Index: phpdoc/en/faq/build.xml
diff -u phpdoc/en/faq/build.xml:1.14 phpdoc/en/faq/build.xml:1.15
--- phpdoc/en/faq/build.xml:1.14 Thu Feb 28 13:14:31 2002
+++ phpdoc/en/faq/build.xml Wed Apr 17 13:35:57 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.14 $ -->
+<!-- $Revision: 1.15 $ -->
<chapter id="faq.build">
<title>Build Problems</title>
<titleabbrev>Build Problems</titleabbrev>
@@ -20,15 +20,15 @@
<answer>
<para>
You have to have the GNU autoconf package installed so you can
- generate the configure script from configure.in. Just run
+ generate the configure script from <filename>configure.in</filename>. Just run
<command>./buildconf</command> in the top-level directory after getting
the sources from the CVS server. (Also, unless you run configure
with the <literal>--enable-maintainer-mode</literal> option, the
configure script will not automatically get rebuilt when the
- configure.in file is updated, so you should make sure to do that
+ <filename>configure.in</filename> file is updated, so you should make sure to
+do that
manually when you notice configure.in has changed. One symptom
of this is finding things like @VARIABLE@ in your Makefile after
- configure or config.status is run.)
+ configure or <filename>config.status</filename> is run.)
</para>
</answer>
</qandaentry>
@@ -37,15 +37,15 @@
<question>
<para>
I'm having problems configuring PHP to work with Apache.
- It says it can't find httpd.h, but it's right where I said it is!
+ It says it can't find <filename>httpd.h</filename>, but it's right where I said
+it is!
</para>
</question>
<answer>
<para>
You need to tell the configure/setup script the location of the
top-level of your Apache source tree. This means that
- you want to specify '<literal>--with-apache=/path/to/apache</literal>'
- and <emphasis>not</emphasis>
'<literal>--with-apache=/path/to/apache/src</literal>'.
+ you want to specify <literal>--with-apache=/path/to/apache</literal>
+ and <emphasis>not</emphasis>
+<literal>--with-apache=/path/to/apache/src</literal>.
</para>
</answer>
</qandaentry>
@@ -76,8 +76,8 @@
<qandaentry id="faq.build.yytname">
<question>
<para>
- When it is compiling the file language-parser.tab.c, it gives me errors
- that say 'yytname undeclared'.
+ When it is compiling the file <filename>language-parser.tab.c</filename>, it
+gives me errors
+ that say <literal>yytname undeclared</literal>.
</para>
</question>
<answer>
@@ -91,7 +91,7 @@
<qandaentry id="faq.build.link">
<question>
<para>
- When I run 'make', it seems to run fine but then fails when it tries
+ When I run <command>make</command>, it seems to run fine but then fails when it
+tries
to link the final application complaining that it can't find some files.
</para>
</question>
@@ -99,8 +99,8 @@
<para>
Some old versions of make that don't correctly put the compiled
versions of the files in the functions directory into that same
- directory. Try running "<command>cp *.o functions</command>" and then
- re-running '<command>make</command>' to see if that helps. If it does, you
should really
+ directory. Try running <command>cp *.o functions</command> and then
+ re-running <command>make</command> to see if that helps. If it does, you should
+really
upgrade to a recent version of GNU make.
</para>
</answer>
@@ -128,7 +128,7 @@
</para>
<para>
Some people have also reported that they had to add '-ldl' immediately
- following '<filename>libphp4.a</filename>' when linking with Apache.
+ following <filename>libphp4.a</filename> when linking with Apache.
</para>
</answer>
</qandaentry>
@@ -164,7 +164,7 @@
</listitem>
<listitem>
<simpara>
- Type '<literal>make</literal>' followed by '<literal>make install</literal>'
+ Type <literal>make</literal> followed by <literal>make install</literal>
to build PHP and copy the necessary files to the Apache distribution tree.
</simpara>
</listitem>
@@ -178,7 +178,7 @@
</listitem>
<listitem>
<simpara>
- Type: '<command>./Configure</command>' followed by '<literal>make</literal>'.
+ Type: <command>./Configure</command> followed by <literal>make</literal>.
</simpara>
</listitem>
<listitem>
@@ -189,7 +189,7 @@
</itemizedlist>
</para>
<para>
- <emphasis>Note:</emphasis> : You can also use the new Apache
+ <emphasis>Note:</emphasis> You can also use the new Apache
<literal>./configure</literal> script. See the instructions in
the <literal>README.configure</literal> file which is part of
your Apache distribution. Also have a look at the <filename>INSTALL</filename>
@@ -264,7 +264,7 @@
</question>
<answer>
<para>
- Note that the libphp4.a file is not supposed to exist. The
+ Note that the <filename>libphp4.a</filename> file is not supposed to exist.
+The
apache process will create it!
</para>
</answer>
@@ -298,8 +298,9 @@
There are three things to check here. First, for some reason
when Apache builds the apxs Perl script, it sometimes ends up
getting built without the proper compiler and flags variables.
- Find your apxs script (try the command 'which apxs',
- it's sometimes found in /usr/local/apache/bin/apxs or /usr/sbin/apxs.
+ Find your apxs script (try the command <command>which apxs</command>,
+ it's sometimes found in <filename>/usr/local/apache/bin/apxs</filename>
+ or <filename>/usr/sbin/apxs</filename>.
Open it and check for lines similar to these:
<programlisting>
my $CFG_CFLAGS_SHLIB = ' '; # substituted via Makefile.tmpl
@@ -323,8 +324,8 @@
<programlisting>
my $CFG_LIBEXECDIR = '/usr/lib/apache'; # substituted via APACI install
</programlisting>
- Last, if you reconfigure/reinstall Apache, add a 'make clean'
- to the process after './configure' and before 'make'.
+ Last, if you reconfigure/reinstall Apache, add a <command>make clean</command>
+ to the process after <command>./configure</command> and before
+<command>make</command>.
</para>
</answer>
</qandaentry>
@@ -332,12 +333,12 @@
<qandaentry id="faq.build.microtime">
<question>
<para>
- During 'make', I get errors in microtime, and a lot of 'RUSAGE_' stuff.
+ During <command>make</command>, I get errors in microtime, and a lot of
+<literal>RUSAGE_</literal> stuff.
</para>
</question>
<answer>
<para>
- During the 'make' portion of installation, if you encounter problems
+ During the <command>make</command> portion of installation, if you encounter
+problems
that look similar to this:
<programlisting>
microtime.c: In function `php_if_getrusage':
@@ -356,7 +357,7 @@
</programlisting>
</para>
<para>
- Your system is broken. You need to fix your /usr/include files by
+ Your system is broken. You need to fix your <filename>/usr/include</filename>
+files by
installing a glibc-devel package that matches your glibc. This has
absolutely nothing to do with PHP. To prove this to yourself, try this
simple test:
