From 02ac13139cd6382fc01a52affac6cc71bb3769e1 Mon Sep 17 00:00:00 2001
From: Joe Orton <jorton@apache.org>
Date: Tue, 28 Sep 2004 15:24:00 +0000
Subject: [PATCH] Bring up to date a little, and don't talk about building
 PHP3(!).

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@105312 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/programs/apxs.xml | 51 +++++++++++++++--------------------
 1 file changed, 22 insertions(+), 29 deletions(-)

diff --git a/docs/manual/programs/apxs.xml b/docs/manual/programs/apxs.xml
index 5535bf5cc0..0d4ac7a50b 100644
--- a/docs/manual/programs/apxs.xml
+++ b/docs/manual/programs/apxs.xml
@@ -1,7 +1,7 @@
 <?xml version='1.0' encoding='UTF-8' ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 
 <!--
  Copyright 2003-2004 The Apache Software Foundation
@@ -203,11 +203,13 @@
 
       <dt><code>-Wc,<var>compiler-flags</var></code></dt>
       <dd>This option passes <var>compiler-flags</var> as additional flags to
-      the compiler command. Use this to add local compiler-specific options.</dd>
+      the <code>libtool --mode=compile</code> command. Use this to add local
+      compiler-specific options.</dd>
 
       <dt><code>-Wl,<var>linker-flags</var></code></dt>
-      <dd>This option passes <var>linker-flags</var> as additional flags to
-      the linker command. Use this to add local linker-specific options.</dd>
+      <dd>This option passes <var>linker-flags</var> as additional
+      flags to the <code>libtool --mode=link</code> command. Use this
+      to add local linker-specific options.</dd>
       </dl>
     </section>
 
@@ -248,8 +250,8 @@
 
     <example>
       $ apxs -c mod_foo.c<br />
-      gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c<br />
-      ld -Bshareable -o mod_foo.so mod_foo.o<br />
+      /path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
+      /path/to/libtool --mode=link -o mod_foo.la mod_foo.slo<br />
       $ _
     </example>
 
@@ -261,10 +263,12 @@
     achieved by running:</p>
 
     <example>
-      $ apxs -i -a mod_foo.c<br />
-      cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
+      $ apxs -i -a mod_foo.la<br />
+      /path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
+      /path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
+      ...
       chmod 755 /path/to/apache/modules/mod_foo.so<br />
-      [activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
+      [activating module `foo' in /path/to/apache/conf/httpd.conf]<br />
       $ _
     </example>
 
@@ -289,7 +293,9 @@
       $ apxs -g -n foo<br />
       Creating [DIR]  foo<br />
       Creating [FILE] foo/Makefile<br />
+      Creating [FILE] foo/modules.mk<br />
       Creating [FILE] foo/mod_foo.c<br />
+      Creating [FILE] foo/.deps<br />
       $ _
     </example>
 
@@ -300,12 +306,14 @@
       $ cd foo<br />
       $ make all reload<br />
       apxs -c mod_foo.c<br />
-      gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c<br />
-      ld -Bshareable -o mod_foo.so mod_foo.o<br />
-      apxs -i -a -n "foo" mod_foo.so<br />
-      cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
+      /path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
+      /path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
+      apxs -i -a -n "foo" mod_foo.la<br />
+      /path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
+      /path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
+      ...
       chmod 755 /path/to/apache/modules/mod_foo.so<br />
-      [activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
+      [activating module `foo' in /path/to/apache/conf/httpd.conf]<br />
       apachectl restart<br />
       /path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
       [Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
@@ -313,20 +321,5 @@
       $ _
     </example>
 
-    <p>You can even use <code>apxs</code> to compile complex modules outside the
-    Apache source tree, like PHP3:</p>
-
-    <example>
-      $ cd php3<br />
-      $ ./configure --with-shared-apache=../apache-1.3<br />
-      $ apxs -c -o libphp3.so mod_php3.c libmodphp3-so.a<br />
-      gcc -fpic -DSHARED_MODULE -I/tmp/apache/include  -c mod_php3.c<br />
-      ld -Bshareable -o libphp3.so mod_php3.o libmodphp3-so.a<br />
-      $ _
-    </example>
-
-    <p>because <code>apxs</code> automatically recognized C source files and
-    object files. Only C source files are compiled while remaining object
-    files are used for the linking phase.</p>
 </section>
 </manualpage>
-- 
2.40.0