AW: Re: [PHP-DOC] cvs: phpdoc /en/chapters install.apache.xml install.caudium.xml install.commandline.xml install.configure.xml install.fhttpd.xml
install.hpux.xml install.iis.xml install.linux.xml install.macosx.xml install.netscape-enterprise.xml install.omn
| From: | Mark Kronsbein | Date: | Fri, 11 Jan 2002 07:09:34 +0000 |
| Subject: | AW: Re: [PHP-DOC] cvs: phpdoc /en/chapters install.apache.xml install.caudium.xml install.commandline.xml install.configure.xml install.fhttpd.xml install.hpux.xml install.iis.xml install.linux.xml install.macosx.xml install.netscape-enterprise.xml install.omn |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969341068@lists.php.net to get a copy of this message | ||
> You intended to write split of install.xml :) When this split is
Arghs, sure, install.xml
>intended to be integrated to the build system? Estimated? Just to make
>sure other languages can update, and make the same split.
I _plan_ to split install.configure.xml (the configure options) on
Sunday. If all is okay (I started this already but I couldn't test,
since Hartmut broke something and I wanted to sleep ;), I'll commit and
write a mailt to phpdoc, too.
> IMHO a phpdoc/chapters/install/filename.xml or a
>phpdoc/install/filename.xml solution would be somewhat better...
I totally agree. I talked to Hartmut (and Georg) and Hartmut said, I
should wait and perhaps discuss this first. I don't care if it will be
chapters/install/ or install/. I think, if I am finished, we can discuss
this. Moving the files then is no problem.
>Having install prepended is much
> like a logical grouping, and we have directories for logical grouping.
ACK.
> This is why I added this to TODO. I thought it would be better to talk
Ah, this was you, who added this ;)
> about this before we change. I vote for moving all the things to
> phpdoc/install/filename.xml, so eg. phpdoc/install/unix.xml
See above.
> Seems much more logical for me. I would also vote for making install
> a major part in the manual itself (the presentation formats), not
Installation should be definately a major part of the manual. Since
(installation) beginners need _much_ help on installing, there should
be as much information given as possible. After splitting
install.configure.xml, we can start think about _how_ we can document
each option.
Mark