Re: fast build for manual chapter
| From: | Hannes Magnusson | Date: | Thu, 09 Aug 2007 02:03:39 +0000 |
| Subject: | Re: fast build for manual chapter | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969377283@lists.php.net to get a copy of this message | ||
Hi Stanislav
On 8/9/07, Stanislav Malyshev <stas@zend.com> wrote:
> Hi!
>
> I'm writing documentation for an extension, and I want to check
> periodically if what I wrote looks good. Building a manual takes serious
> amount of time, so I wanted to ask - is there any way to build only one
> chapter for the manual and look only into it, without building all the rest?
make part/the-id
Take for example the strpos function, which has the id function.strpos:
make part/function.strpos
The strings reference page (and all sub-pages):
make part/ref.strings
By default it does html build, but if you have a phpweb running you
can run ./configure --with-buildstyle=phpweb
If you are feeling adventures you can checkout "PhD" from cvs:
cd path/to/phpdoc
./configure
make .manual.xml
cd ..
cvs co phd
cd phd
php build.php ../phpdoc/.manual.xml ../phpdoc/phpbook/phpbook-xsl/version.xml
the "make .manual.xml" will take 30-60seconds and the build.php will
take 2-3 minutes generating the complete manual in all three formats
(phpweb, html & bightml).
PhD is still however highly experimental and still missing bunch of
tags, but the most "important ones" are there.
-Hannes