os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Update Apache section with new bsd.apache.mk stuff

Browse source 
- Talk about Apache module framework
- Mention where web apps should end

PR:		docs/96336 (based on)
Submitted by:	Rong-En Fan <rafan@infor.org>
Informations:	painfully extracted from clement over IRC
This commit is contained in:
Pav Lucistnik 2006-05-11 15:07:54 +00:00
parent cdc49f5ea7
commit 9a8ef22b92
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=27807
1 changed files with 112 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

119
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -5372,29 +5372,134 @@ BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
<tbody>
<row>
<entry>USE_APACHE</entry>
<entry><makevar>USE_APACHE</makevar></entry>
<entry>The port requires Apache.</entry>
<entry>The port requires Apache. Possible values:
<literal>yes</literal> (gets any version),
<literal>1.3</literal>, <literal>2.0</literal>,
<literal>2.2</literal>, <literal>2.0+</literal>,
etc. Default dependency is on version
<literal>1.3</literal>.</entry>
</row>
<row>
<entry>WITH_APACHE2</entry>
<entry><makevar>WITH_APACHE2</makevar></entry>
<entry>The port requires Apache 2.0. Without this variable,
the port will depend on Apache 1.3.</entry>
the port will depend on Apache 1.3. This variable is
deprecated and should not be used anymore.</entry>
</row>
<row>
<entry>APXS</entry>
<entry><makevar>APXS</makevar></entry>
<entry>Full path to the <command>apxs</command> binary
(read-only variable).</entry>
<entry>Full path to the <command>apxs</command> binary.
Can be overriden in your port.</entry>
</row>
<row>
<entry><makevar>HTTPD</makevar></entry>
<entry>Full path to the <command>httpd</command> binary.
Can be overriden in your port.</entry>
</row>
<row>
<entry><makevar>APACHE_VERSION</makevar></entry>
<entry>The version of present Apache installation (read-only
variable). This variable is only available after inclusion
of <filename>bsd.port.pre.mk</filename>. Possible values:
<literal>13</literal>, <literal>20</literal>,
<literal>22</literal>.</entry>
</row>
<row>
<entry><makevar>APACHEMODDIR</makevar></entry>
<entry>Directory for Apache modules. This variable is
automatically expanded in pkg-plist.</entry>
</row>
<row>
<entry><makevar>APACHEINCLUDEDIR</makevar></entry>
<entry>Directory for Apache headers. This variable is
automatically expanded in pkg-plist.</entry>
</row>
</tbody>
</tgroup>
</table>
<table frame="none">
<title>Useful variables for porting Apache modules</title>
<tgroup cols="2">
<tbody>
<row>
<entry><makevar>MODULENAME</makevar></entry>
<entry>Name of the module. Default value is
<makevar>PORTNAME</makevar>. Example:
<literal>mod_hello</literal></entry>
</row>
<row>
<entry><makevar>SHORTMODNAME</makevar></entry>
<entry>Short name of the module. Automatically derived
from <makevar>MODULENAME</makevar>, but can be overriden.
Example: <literal>hello</literal></entry>
</row>
<row>
<entry><makevar>AP_FAST_BUILD</makevar></entry>
<entry>Use <command>apxs</command> to compile and install
the module.</entry>
</row>
<row>
<entry><makevar>AP_GENPLIST</makevar></entry>
<entry>Also automatically creates
a <filename>pkg-plist</filename>.</entry>
</row>
<row>
<entry><makevar>AP_INC</makevar></entry>
<entry>Adds a directory to a header search path during
compilation.</entry>
</row>
<row>
<entry><makevar>AP_LIB</makevar></entry>
<entry>Adds a directory to a library search path during
compilation.</entry>
</row>
<row>
<entry><makevar>AP_EXTRAS</makevar></entry>
<entry>Additional flags to pass to
<command>apxs</command>.</entry>
</row>
</tbody>
</tgroup>
</table>
<para>Web applications should be installed into
<makevar>PREFIX</makevar><filename>/www/<replaceable>appname</replaceable></filename>
and should not assume Apache is present, unless they depend
on Apache explicitly. User may wish to run them on different
web server than Apache.</para>
</sect2>
<sect2 id="php-variables">