| Hannes Magnusson 2007-11-08, 7:01 pm |
| Hi all
PhD 0.2.0 has been released \o/.
There have been some minor changes to configuration of PhD, you should
no longer edit the `config.php`.
We have added parameter parsing support to deal with most of the
configuration settings, including the path to the XML file.
The recommended way to build the PHP docs, using phd, is to pass the
/path/to/phpdoc/.manual.xml using the --docbook parameter (or -d for
PHP prior to 5.3).
However, for backwards compatibility (and PHP on Windows, prior to
5.3) it is still possible to pass /path/to/phpdoc as the only
parameter to `phd`.
Other supported parameters are, to name a few;
--theme (-t), to pick which "themes" to render.
Example: phd --theme chunkedhtml --docbook /path/to/phpdoc/.manual.xml
Note: You can pass --theme multiple times if you want to
render multiple themes
--partial (-p), to pick which IDs to render.
Example: phd --partial ref.strings --docbook /path/to/phpdoc/.manual.xml
Note: you can pass --partial multiple times if you want to
render multiple IDs
Furthermore you can add =false to the ID if you do not want to
render any children of the ID, i.e. --partial ref.strings=false will
_only_ render the ref.strings page, not any of its children (i.e.
function.strpos, function.substr....).
--help (-h), lists the supported parameters.
To upgrade PhD from prior releases:
pear upgrade http://doc.php.net/phd/PhD-0.2.0.tgz
Installing PhD for the first time:
pear install http://doc.php.net/phd/PhD-0.2.0.tgz
New features:
- Added getopt() parsing for few configuration options (see `phd -h`)
- Added partial rendering (`phd --partial <the-id-you-want-to-render>`)
- Added various verbosity levels
New Docbook element support:
- Added support for errorcode, symbol and superscript elements
(used by few translations)
- Suppressed the contrib element
And bug fixes:
- Fixed bug#43192 (Chunked HTML output difficult to use without
TOC). (Edward Z. Yang)
- Fixed bug#43191 (build.php fails to include necessary theme
dependencies). (Edward Z. Yang, Richard Q)
-Hannes
|