RE: [PHP-DOC] Documenting configure options/Updating and splitting install.configure.php
| From: | James Cox | Date: | Thu, 27 Dec 2001 02:26:27 +0000 |
| Subject: | RE: [PHP-DOC] Documenting configure options/Updating and splitting install.configure.php | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969340360@lists.php.net to get a copy of this message | ||
The core thing here is about getting install (configure) options out in the
open, making life easier to understand for everyone. I also think that some
default configure options (examples) should be provided to make the process
that bit easier.
Wherever it is stored till it's published is neither here nor there - i
think. It might be nice to make a seperate appendix for this?
Anyhow, i'll go back to lurking.
James Cox
>
> > Every manual is not complete. Holding nearly complete chapters in
> > temp-directories is also a bad idea. This will confuse readers and
> > writers.
>
> Well, I don't care _where_ to put in this stuff. I just thought, that it
> would
> be better to not put stuff into the manual, which is not only incomplete,
> but not even really started. We have to put all these configure options
> into xml and start to sort them. I you'd like to have such things in
> the "real" manual, well, go for it. IMHO _this_ would confuse readers.
>
> > The PHP manual have four parts. Part 4 is the function reference and
> > there is now (with Hartmuts help) a function index. This means, it
> > is nearly impossible to find something in the first three parts.
>
> Ah, okay.
>
> Mark
>