Re: cvs: phpdoc /en/appendices phpdevel.xml
| From: | Gabor Hojtsy | Date: | Sun, 02 Jun 2002 10:22:43 +0000 |
| Subject: | Re: cvs: phpdoc /en/appendices phpdevel.xml | ||
| References: | 1 2 3 4 5 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969346112@lists.php.net to get a copy of this message | ||
> > Very nice idea ;) As I tried to propagte the idea of having a separate
> > <book> (!) for developing PHP, and providing it in a separate download,
> > I fully agree on at least consolidating these sections all in one place
> > in the manual. BTW I still think it would be better to open a new book
> > on developing PHP, because this part is **rarely** used by PHP
> > programmers. It would make searches faster, download size smaller,
> > manual generation faster + simpler, etc.
>
> hmm.. must have missed your try to propagate, but anyhow: A great idea!
>
> The licensing-question for the Zend-Part still stays (if we can really
> do what we want), but with books we have also some other decision-points
> (have to leave urgently, so it might be very incomplete):
>
> Integration into the phpdoc-path?
> Build-handling: "semi-integrated" like the howto?
> Should it be provided at www.php.net
> only as a compressed file?
Well, I think it still can be stored under phpdoc-LANG/phpdevel,
but it needs a separate root XML file. This may add some new
bits to the configure script, but IMHO we should not duplicate
the configure system [one of the phpdoc meeting ideas was to
open a completely new repository for phpdoc-build, and let all the
manuals use it - it would be a hard work to do ;)]. So to look
a bit closer, IMHO it would be nice to have the phpdevel stuff in
the phpdoc-LANG repositories, thus allowing translation, and using
the same build system (as the howto does).
Goba