svn co and build of PHP manual could be clearer
| From: | Robert P. J. Day | Date: | Sat, 20 Mar 2010 11:56:18 +0000 |
| Subject: | svn co and build of PHP manual could be clearer | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969381459@lists.php.net to get a copy of this message | ||
in order to stay on top of things, i thought i'd "svn co" the
development stream of the PHP manual, but it seems that doing that
could be more clearly explained.
starting here:
http://www.php.net/download-docs.php
there is no mention whatsoever about doing an svn checkout of the
manual -- how to do that is buried partway down in the page here:
http://php.net/svn.php
it really should be mentioned on that first page, no? also, once i do
the checkout:
$ svn checkout http://svn.php.net/repository/phpdoc/en/trunk
./phpdoc-en
there's nothing in that checkout that tells me how to configure and
build the manual. i look in vain for a README or Makefile or
"configure" script. a little searching and i eventually end up here:
http://doc.php.net/php
where, curiously, the "PHP section" link at the bottom refers back to
itself. how odd. eventually, i follow the link labelled
"Documentation Howto" over there on the right, looking for build
instructions, but i still don't see them. i see directions for how to
edit and validate XML files, but is there a single page with
instructions for how to simply generate the manual HTML?
rday
--
========================================================================
Robert P. J. Day Waterloo, Ontario, CANADA
Linux Consulting, Training and Kernel Pedantry.
Web page: http://crashcourse.ca
Twitter: http://twitter.com/rpjday
========================================================================