pcs 97/08/13 01:57:40
Modified: htdocs/manual sourcereorg.html
Log:
Add instructions for adding a single-file module
Revision Changes Path
1.2 +24 -5 apachen/htdocs/manual/sourcereorg.html
Index: sourcereorg.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/sourcereorg.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- sourcereorg.html 1997/08/11 10:07:48 1.1
+++ sourcereorg.html 1997/08/13 08:57:40 1.2
@@ -61,7 +61,7 @@
<h2>Adding Modules</h2>
-Modules are added to Apache by adding a reference tp them in
+Modules are added to Apache by adding a reference to them in
<CODE>src/Configuration</CODE> then running <CODE>Configure</CODE> and
<CODE>make</CODE>. In earlier version of Apache before 1.3, the
line added to Configuration looked like this:
@@ -80,6 +80,25 @@
The argument to AddModule is the path, relative to <CODE>src</CODE>, to
the module file's source or object file.
+<P>
+
+Normally when adding a module you should follow the instructions of
+the module author. However if the module comes as a single source
+file, say mod_foo.c, then the way to add the module to Apache is as
+follows:
+
+<ul>
+ <li>Put <CODE>mod_foo.c</CODE> into the directory
+ <CODE>src/modules/extra</CODE>
+ </li>
+ <li>Go to the <CODE>src</CODE> directory and add the following line
+ to <CODE>Configuration</CODE><br>
+ <CODE>AddModule modules/extra/mod_foo.o</CODE>
+ </li>
+ <li>Run <CODE>./Configure</CODE></li>
+ <li>Run <CODE>make</CODE></li>
+</ul>
+
<h2>New Facilities for Module Authors</h2>
In previous releases of Apache, new modules were added to the
@@ -129,9 +148,9 @@
<li>mod_demo/Makefile.tmpl
</ul>
-(Of course end-user instructions, README's etc can also be supplied in
-the archive). The end user should be told to extract this archive in
-the <CODE>src/modules</CODE> directory of their Apache source
+(Of course end-user instructions, README's, etc can also be supplied
+in the archive). The end user should be told to extract this archive
+in the <CODE>src/modules</CODE> directory of their Apache source
tree. This will create a new directory
<CODE>src/modules/mod_demo</CODE>. Then they need to add the following
line to the <CODE>Configuration</CODE> file:
@@ -250,7 +269,7 @@
</PRE>
See the default distribution's mod_auth_db.module for an example of
-an separate module definition file.
+a separate module definition file.
<!--#include virtual="footer.html" -->
</BODY>
