----- "Igor Galić" <[email protected]> wrote:

> Hi folks,
> 
> I'm putting my entire conversation with Bill here on the list,
> although right now the only thing relevant to us is the point
> 
> ----- "William A. Rowe Jr." <[email protected]> wrote:
> 
> > On 4/18/2010 6:43 PM, Igor Galić wrote:
> > > 
> > > Hi Bill - hope this one finally arrives!
> > > 
> > > Here's a reminder of the things we talked about at the retreat:
> > > 
> > > * How to merge ProxyPass and ProxyPassReverse, such that the
> latter
> > > only remains for edge cases.
> > 
> > Yup, it's #4 on my list!
> > 
> > > * move mod_allowmethods from infra into httpd's sandbox
> > 
> > You mean introduce a new mod_authz_method module which takes the
> > typical
> > 'Allow method GET PUT POST' or a similar syntax, using allow/deny
> :)
> > 
> > > * How to include mod_fcgid into a release?
> > 
> > Not going to be significantly debated until 2.3.x is into beta,
> bring
> > this
> > up again then please?
> > 
> > > ** Derived from that: How do we make it easy for modules to be
> > dropped
> > > in *with* documentation?
> > 
> > As an add in, that's #3 in my list, along with other apxs
> improvements
> > :)

One of the things we discussed in this context but which I didn't put on
the list is how to speed up the process of documenting so far rather
under-documented modules (like mod_lua).
IIRC, Bill has a method of extracting a module's (or an httpd's) directives.
If that could be used to fill:
http://httpd.apache.org/docs-project/mod_template.txt
That would be a good first step.

Btw, that template itself appears to be in need of updating, but I
don't have commit access, so I'm attaching the patch.

Bye,
-- 
Igor Galić

Tel: +43 (0) 699 122 96 338
Fax: +43(0) 1 91 333 41
Mail: [email protected]
URL: http://brainsware.org/
Index: mod_template.txt
===================================================================
--- mod_template.txt	(revision 935430)
+++ mod_template.txt	(working copy)
@@ -16,19 +16,19 @@
 <description>Demonstrates the module documentation format</description>
 
 <!-- From:
-http://httpd.apache.org/docs-2.0/mod/module-dict.html#Status -->
+http://httpd.apache.org/docs/2.2/mod/module-dict.html#Status -->
 <status>experimental</status>
 
 <!-- As in:
-http://httpd.apache.org/docs-2.0/mod/module-dict.html#SourceFile -->
+http://httpd.apache.org/docs/2.2/mod/module-dict.html#SourceFile -->
 <sourcefile>mod_template.c</sourcefile>
 
 <!-- As in:
-http://httpd.apache.org/docs-2.0/mod/module-dict.html#ModuleIdentifier -->
+http://httpd.apache.org/docs/2.2/mod/module-dict.html#ModuleIdentifier -->
 <identifier>template_module</identifier>
 
 <!-- Optional: as in:
-http://httpd.apache.org/docs-2.0/mod/module-dict.html#Compatibility -->
+http://httpd.apache.org/docs/2.2/mod/module-dict.html#Compatibility -->
 <compatibility>Not actually available in any version</compatibility>
 
 
@@ -83,23 +83,23 @@
 <description>Changes absolutely nothing</description>
 
 <!-- As in:
-http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Syntax -->
+http://httpd.apache.org/docs/2.2/mod/directive-dict.html#Syntax -->
 <syntax>TemplateDirective One|Two|Thee <em>file-path</em> 
 [<em>env-variable</em>] [<em>env-variable</em>] ...</syntax>
 
 <!-- Optional: Plain text only, exactly as the dirctive would appear in
 the config file, as in:
-http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Default -->
+http://httpd.apache.org/docs/2.2/mod/directive-dict.html#Default -->
 <default>TemplateDirective Two /usr/local/apache</default>
 
 <!-- Each context as in:
-http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Context
+http://httpd.apache.org/docs/2.2/mod/directive-dict.html#Context
 is placed in a separate context tag -->
 <contextlist><context>Directory</context><context>.htaccess</context>
 </contextlist>
 
 <!-- Required if and only if the contextlist includes .htacccess, as in
-http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Override -->
+http://httpd.apache.org/docs/2.2/mod/directive-dict.html#Override -->
 <override>FileInfo</override>
 
 <!-- Used only if the same directive is implemented by multiple modules.
@@ -110,11 +110,11 @@
 
 <!-- Used only if the status for the directive differs from the status
 for the module as a whole.  As in:
-http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Status -->
+http://httpd.apache.org/docs/2.2/mod/directive-dict.html#Status -->
 <status>Experimental</status>
 
 <!-- Optional, as in:
-http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Compatibility -->
+http://httpd.apache.org/docs/2.2/mod/directive-dict.html#Compatibility -->
 <compatibility>Does not really exist</compatibility>
 
 <!-- Detailed description of what the directive does and how to use it -->

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to