update transformation

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@105321 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 20 insertions, 31 deletions

diff --git a/docs/man/apxs.8 b/docs/man/apxs.8
index 55decb92b7..13df607084 100644
--- a/docs/man/apxs.8
+++ b/docs/man/apxs.8
@@ -19,7 +19,7 @@
 .el .ne 3
 .IP "\\$1" \\$2
 ..
-.TH "APXS" 8 "2003-11-25" "Apache HTTP Server" "apxs"
+.TH "APXS" 8 "2004-09-28" "Apache HTTP Server" "apxs"
 
 .SH NAME
 apxs \- APache eXtenSion tool
@@ -96,7 +96,7 @@ This explicitly sets the module name for the -i (install) and -g (template gener
  
 .TP
 -q
-Performs a query for apxs's knowledge about certain settings\&. The \fIquery\fR parameters can be one or more of the following strings: CC, CFLAGS, CFLAGS_SHLIB, INCLUDEDIR, LD_SHLIB, LDFLAGS_SHLIB, LIBEXECDIR, LIBS_SHLIB, SBINDIR, SYSCONFDIR, TARGET\&. .PP Use this for manually determining settings\&. For instance use .nf INC=-I`apxs -q INCLUDEDIR` .fi .PP inside your own Makefiles if you need manual access to Apache's C header files\&.  
+Performs a query for apxs's knowledge about certain settings\&. The \fIquery\fR parameters can be one or more of the following strings: CC, CFLAGS, CFLAGS_SHLIB, INCLUDEDIR, LD_SHLIB, LDFLAGS_SHLIB, LIBEXECDIR, LIBS_SHLIB, SBINDIR, SYSCONFDIR, TARGET\&. .PP Use this for manually determining settings\&. For instance use INC=-I`apxs -q INCLUDEDIR` .PP inside your own Makefiles if you need manual access to Apache's C header files\&.  
   
 .SS "Configuration Options"
  
@@ -135,10 +135,10 @@ This option is directly passed through to the linker command\&. Use this to add
 This option is directly passed through to the linker command\&. Use this to add your own libraries to search to the build process\&.  
 .TP
 -Wc,\fIcompiler-flags\fR
-This option passes \fIcompiler-flags\fR as additional flags to the compiler command\&. Use this to add local compiler-specific options\&.  
+This option passes \fIcompiler-flags\fR as additional flags to the libtool --mode=compile command\&. Use this to add local compiler-specific options\&.  
 .TP
 -Wl,\fIlinker-flags\fR
-This option passes \fIlinker-flags\fR as additional flags to the linker command\&. Use this to add local linker-specific options\&.  
+This option passes \fIlinker-flags\fR as additional flags to the libtool --mode=link command\&. Use this to add local linker-specific options\&.  
   
 .SS "DSO Installation and Configuration Options"
   
@@ -164,8 +164,8 @@ Assume you have an Apache module named mod_foo\&.c available which should extend
 .nf
 
       $ apxs -c mod_foo\&.c
-      gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo\&.c
-      ld -Bshareable -o mod_foo\&.so mod_foo\&.o
+      /path/to/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
+      /path/to/libtool --mode=link -o mod_foo\&.la mod_foo\&.slo
       $ _
     
 .fi
@@ -175,10 +175,12 @@ Then you have to update the Apache configuration by making sure a LoadModule dir
  
 .nf
 
-      $ apxs -i -a mod_foo\&.c
-      cp mod_foo\&.so /path/to/apache/modules/mod_foo\&.so
+      $ apxs -i -a mod_foo\&.la
+      /path/to/instdso\&.sh mod_foo\&.la /path/to/apache/modules
+      /path/to/libtool --mode=install cp mod_foo\&.la /path/to/apache/modules
+      \&.\&.\&.
       chmod 755 /path/to/apache/modules/mod_foo\&.so
-      [activating module `foo' in /path/to/apache/etc/httpd\&.conf]
+      [activating module `foo' in /path/to/apache/conf/httpd\&.conf]
       $ _
     
 .fi
@@ -209,7 +211,9 @@ For a quick test of the apxs mechanism you can create a sample Apache module tem
       $ apxs -g -n foo
       Creating [DIR]  foo
       Creating [FILE] foo/Makefile
+      Creating [FILE] foo/modules\&.mk
       Creating [FILE] foo/mod_foo\&.c
+      Creating [FILE] foo/\&.deps
       $ _
     
 .fi
@@ -222,12 +226,14 @@ Then you can immediately compile this sample module into a shared object and loa
       $ cd foo
       $ make all reload
       apxs -c mod_foo\&.c
-      gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo\&.c
-      ld -Bshareable -o mod_foo\&.so mod_foo\&.o
-      apxs -i -a -n "foo" mod_foo\&.so
-      cp mod_foo\&.so /path/to/apache/modules/mod_foo\&.so
+      /path/to/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
+      /path/to/libtool --mode=link gcc \&.\&.\&. -o mod_foo\&.la mod_foo\&.slo
+      apxs -i -a -n "foo" mod_foo\&.la
+      /path/to/instdso\&.sh mod_foo\&.la /path/to/apache/modules
+      /path/to/libtool --mode=install cp mod_foo\&.la /path/to/apache/modules
+      \&.\&.\&.
       chmod 755 /path/to/apache/modules/mod_foo\&.so
-      [activating module `foo' in /path/to/apache/etc/httpd\&.conf]
+      [activating module `foo' in /path/to/apache/conf/httpd\&.conf]
       apachectl restart
       /path/to/apache/sbin/apachectl restart: httpd not running, trying to start
       [Tue Mar 31 11:27:55 1998] [debug] mod_so\&.c(303): loaded module foo_module
@@ -236,20 +242,3 @@ Then you can immediately compile this sample module into a shared object and loa
     
 .fi
  
-.PP
-You can even use apxs to compile complex modules outside the Apache source tree, like PHP3:
- 
-.nf
-
-      $ cd php3
-      $ \&./configure --with-shared-apache=\&.\&./apache-1\&.3
-      $ apxs -c -o libphp3\&.so mod_php3\&.c libmodphp3-so\&.a
-      gcc -fpic -DSHARED_MODULE -I/tmp/apache/include  -c mod_php3\&.c
-      ld -Bshareable -o libphp3\&.so mod_php3\&.o libmodphp3-so\&.a
-      $ _
-    
-.fi
- 
-.PP
-because apxs automatically recognized C source files and object files\&. Only C source files are compiled while remaining object files are used for the linking phase\&.
-