Re: MSIE and laguages and a bug? in mod_expires

[Doug MacEachern <do...@osf.org>]

sameer <sa...@c2.net> wrote:

> > I'd like to see the mod_perl stuff as well, but I disagree that it
> > should be "put in the tree". As of right now, I would not want to see
> > documentation appear in 1.2b5 that is 1) relevant to a Perl version of
> > the Apache API, not the C version we use, and 2) possibly incorrect.
> > 
> > OTOH, it could very well be put somewhere on dev.apache.org, so we
> > could look at it.
> 
> 	that's a good point. I will use the perl stuff as a starting
> point for api docs, but not put it in the docs tree. 

Right, I only offered the mod_perl docs as a starting point.  There's
a handful of functions specific to mod_perl, and the examples are of
course, in perl.  But for most you can just drop the $ variable prefix.
One of the exceptions to the "thin glue layer rule" is reading data from
the client, where mod_perl takes care of things like 
if(client_should_block(r)) under the covers.
I would suggest you stick with the pod (plain old documentation) format. 
It's simple and can be converted into just about any other format, html,
man pages, latext, os2's help format (I forget the name), and others.  
It's not than "robust", but plenty for an API listing.  
#2 is also possible in certain places, but I did not have a C API
listing to go by :-)

-Doug

> 
> -- 
> Sameer Parekh					Voice:   510-986-8770
> President					FAX:     510-986-8777
> C2Net 		    C2Net is having a party: http://www.c2.net/party/
> http://www.c2.net/				sameer@c2.net
>