From d902d5e491614f30e06812f44e2208f1f2a08319 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Andr=C3=A9=20Malo?= Date: Tue, 28 Sep 2004 17:32:39 +0000 Subject: [PATCH] update transformation git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@105321 13f79535-47bb-0310-9956-ffa450edef68 --- docs/man/apxs.8 | 51 ++++++++++-------------- docs/manual/programs/apxs.html.en | 49 ++++++++++------------- docs/manual/programs/apxs.html.ko.euc-kr | 2 + docs/manual/programs/apxs.xml.ko | 2 +- docs/manual/programs/apxs.xml.meta | 2 +- 5 files changed, 45 insertions(+), 61 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\&. - diff --git a/docs/manual/programs/apxs.html.en b/docs/manual/programs/apxs.html.en index efeabc7c2a..64e30fdba4 100644 --- a/docs/manual/programs/apxs.html.en +++ b/docs/manual/programs/apxs.html.en @@ -203,11 +203,13 @@
-Wc,compiler-flags
This option passes compiler-flags as additional flags to - the compiler command. Use this to add local compiler-specific options.
+ the libtool --mode=compile command. Use this to add local + compiler-specific options.
-Wl,linker-flags
-
This option passes linker-flags as additional flags to - the linker command. Use this to add local linker-specific options.
+
This option passes linker-flags as additional + flags to the libtool --mode=link command. Use this + to add local linker-specific options.
@@ -247,8 +249,8 @@

$ 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
$ _

@@ -260,10 +262,12 @@ achieved by running:

- $ 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]
$ _

@@ -288,7 +292,9 @@ $ 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
$ _

@@ -299,12 +305,14 @@ $ 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
@@ -312,21 +320,6 @@ $ _

-

You can even use apxs to compile complex modules outside the - Apache source tree, like PHP3:

- -

- $ 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
- $ _ -

- -

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.

Available Languages:  en  | diff --git a/docs/manual/programs/apxs.html.ko.euc-kr b/docs/manual/programs/apxs.html.ko.euc-kr index 0a7d41c29e..80d79d8194 100644 --- a/docs/manual/programs/apxs.html.ko.euc-kr +++ b/docs/manual/programs/apxs.html.ko.euc-kr @@ -21,6 +21,8 @@

°¡´ÉÇÑ ¾ð¾î:  en  |  ko 

+
ÀÌ ¹®¼­´Â ÃÖ½ÅÆÇ ¹ø¿ªÀÌ ¾Æ´Õ´Ï´Ù. + ÃÖ±Ù¿¡ º¯°æµÈ ³»¿ëÀº ¿µ¾î ¹®¼­¸¦ Âü°íÇϼ¼¿ä.

apxs´Â ¾ÆÆÄÄ¡ ÇÏÀÌÆÛÅؽºÆ® Àü¼Û ÇÁ·ÎÅäÄÝ (HTTP) ¼­¹öÀÇ È®Àå¸ðµâÀ» ÄÄÆÄÀÏÇÏ°í ¼³Ä¡ÇÏ´Â µµ±¸ÀÌ´Ù. ÀÌ diff --git a/docs/manual/programs/apxs.xml.ko b/docs/manual/programs/apxs.xml.ko index 367502b294..97bd22b329 100644 --- a/docs/manual/programs/apxs.xml.ko +++ b/docs/manual/programs/apxs.xml.ko @@ -1,7 +1,7 @@ - +