Update to the installation instructions for TPF to clarify how to
exclude expat-lite from the Apache compilation.
Submitted at a customer's request.
David McCreedy
[EMAIL PROTECTED]
Index: httpd-docs-1.3/htdocs/manual/install-tpf.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install-tpf.html,v
retrieving revision 1.16
diff -u -d -b -r1.16 install-tpf.html
--- httpd-docs-1.3/htdocs/manual/install-tpf.html 29 Mar 2002 19:05:54 -0000
1.16
+++ httpd-docs-1.3/htdocs/manual/install-tpf.html 17 May 2002 15:10:08 -0000
@@ -113,14 +113,14 @@
<b><tt>pax -rvzkf <i>os390_unix_filename</i>.tar.Z -o from=ISO8859-1,to=IBM-1047 "*/src"</tt></b><br
/>
</li>
- <li>
+ <li><a id="delete-expat" name="delete-expat"></a>
Remove unnecessary subdirectories:
<ul>
- <li>
- <b><tt>cd apache_1.3.<em>xx</em>/src/os</tt></b></li>
-
- <li>
-
<b><tt>rm -r bs2000 cygwin mpeix netware os2 os390 win32</tt></b></li>
+ <li><b><tt>cd apache_1.3.<em>xx</em>/src/lib</tt></b></li>
+ <li><b><tt>rm -r expat-lite sdbm</tt></b></li>
+ <li><b><tt>cd ../os</tt></b></li>
+
+<li><b><tt>rm -r bs2000 cygwin mpeix netware os2 os390 win32</tt></b></li>
+ <li><b><tt>cd ..</tt></b></li>
</ul>
</li>
@@ -174,11 +174,6 @@
<ul>
- <li>adjust the rules and
- <tt>EXTRA_CFLAGS|LIBS|LDFLAGS|INCLUDES</tt> if you feel
- so inclined
- </li>
-
<li>comment out (by preceding the line with a "#") lines
corresponding to those modules you DO NOT wish to
include
@@ -189,6 +184,14 @@
or add new lines corresponding to any custom modules you
have written (the <a href="readme-tpf.html">readme-tpf.html</a> document
lists
the modules that have been tested on TPF) </li>
+
+ <li>if you did not delete the src/lib/expat-lite directory
+ as noted in the <a href="#delete-expat">download instructions</a>,
+ add "<tt>Rule EXPAT=no</tt>" to the src/Configuration file</li>
+
+ <li>adjust the other rules, <tt>EXTRA_CFLAGS</tt>, <tt>EXTRA_LIBS</tt>,
+<tt>EXTRA_LDFLAGS</tt>,
+ and <tt>EXTRA_INCLUDES</tt> settings if you feel so inclined</li>
+
</ul>
<p>The modules placed in the Apache distribution are the
@@ -328,7 +331,7 @@
TPF. <br />
</li>
- <li>
+ <li><a id="run-configure" name="run-configure"></a>
Run the "Configure" script:
<b><tt>Configure</tt></b> <br />
@@ -349,7 +352,6 @@
Creating Makefile in os/tpf
Creating Makefile in ap
Creating Makefile in main
- Creating Makefile in lib/expat-lite
Creating Makefile in modules/standard
$ _
@@ -379,14 +381,12 @@
</b> or find a line with a "\": <b>/\\</b>
</pre>
- <div style="margin-left: 2em">
The end of line should display as "<tt>\$</tt>". If it is
displayed as "<tt>\ $</tt>" (with a blank between \
and $) then you should revert to the distributed version
of the file and make the site-specific changes again
using a UNIX compatible editor such as vi or emacs. Then
try the Configure command again.
- </div>
<pre>
close the file: <b>:q</b> (or <b>:quit!</b>)
</pre>
@@ -471,7 +471,6 @@
has been included as src/os/tpf/samples/linkhttp.jcl. You
will need to modify this JCL:<br />
-
<ul>
<li>Change the IDs, data set names, and libraries for
your particular site. </li>
@@ -484,8 +483,18 @@
<font color="#FF0000"><font size="+1">TIP:</font></font>
Do NOT include gen_test_char.o or gen_uri_delims.o in the
link JCL since these files are only used during the
- <tt>make</tt> step. <br />
+ <tt>make</tt> step. <br /><br />
+
+
+ If you receive an "Unresolved references" error for "<tt>XML_ErrorString</tt>"
+ you probably need to <a href="#delete-expat">remove the expat-lite
+directory</a>
+ and start back at the "<a href="#run-configure">Run the Configure script"
+step</a><br /><br />
+
+
+ If you receive an "unable to open" error for
+<tt>lib/expat-lite/hashtable.o</tt>"
+ you probably need to remove all of the expat-lite .o's from your link JCL<br
+/>
+
</li>
<li>Create a loadset. Sample loadset JCL has been included as
@@ -561,8 +570,6 @@
<tt>fopen</tt> error while running Apache:<br />
<br />
-
- <div style="margin-left: 2em">
If you're running a PUT10 or higher version of TPF make
the directory using the <b><tt>zfile
mkdir /usr/local/apache/logs</tt></b> command.<br />
@@ -570,7 +577,7 @@
If you're running TPF version PUT09 TFTP an empty file
into the logs subdirectory to create it. <br />
<br />
- </div>
+
Make sure Apache can write into the logs subdirectory by
doing a <tt>zfile chmod</tt> on it with the
appropriate permission settings.
