httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ben Laurie <...@gonzo.ben.algroup.co.uk>
Subject Re: apache1.1b1 documentation bug fix and suggestion
Date Fri, 03 May 1996 12:15:52 GMT
Paul Richards wrote:
> 
> In reply to Brian Behlendorf who said
> > 
> > On Mon, 29 Apr 1996, John Heidemann wrote:
> > > Second, Apache's got good documentation.  It's too bad it's not kept
> > > with the source code.  A "doc" subdirectory would make the
> > > documentation easier and faster to get at, available when off-line,
> > > and available for editing (I considered patching
> > > <http://www.apache.org/docs/mod_log_referer.html> wrt my first
> > > comment, but I don't have source :-( ).
> > > 
> > > Has anyone considered distributing the documentation HTML, Postscript,
> > > and source with the Apache source code distribution?
> > 
> > The postscript docs are available as a tar file - the HTML docs probably 
> > could be as well, in fact they are, as 
> > ftp://ftp.apache.org/apache/docs.tar, but that's undocumented. :)  
> > We discussed this a while back and I believe the conclusion we came to 
> > was that it would just make the distribution a whole lot larger....
> 
> Documentation should probably go into cvs. What source format are we
> using? We should cvs import it onto a separate tree, e.g. apache_docs and
> if people are concerned about distribution size we can create a separate
> tar ball for it.
> 
> I'm inclined to think that in full releases the html docs should be part of
> the base installation and should be installed as "example" pages so that when
> the server comes up you get a welcome html page and the docs online.

I agree.

Cheers,

Ben.

> 
> -- 
>   Paul Richards. Originative Solutions Ltd.  (Netcraft Ltd. contractor)
>   Elsevier Science TIS online journal project.
>   Email: p.richards@elsevier.co.uk
>   Phone: 0370 462071 (Mobile), +44 (0)1865 843155

-- 
Ben Laurie                  Phone: +44 (181) 994 6435
Freelance Consultant and    Fax:   +44 (181) 994 6472
Technical Director          Email: ben@algroup.co.uk
A.L. Digital Ltd,           URL: http://www.algroup.co.uk
London, England.

Mime
View raw message