Hi all
The first maintenance release of PhD 0.2, PhD 0.2.1 has been released.
This release only contains handful of fixes, mainly for phpdocs
new-oo-style (see below).
To upgrade PhD from prior releases:
pear upgrade http://doc.php.net/phd/PhD-0.2.1.tgz
Installing PhD for the first time:
pear install http://doc.php.net/phd/PhD-0.2.1.tgz
I would like to reiterate that as of 0.2.0 config.php should not be edited.
PhD 0.2.0 added support for most of the configurable options, including:
-d [--docbook] </path/to/the/docbook/xml/file.xml>
The location of the file to render
Example: -d/cvs/php/phpdoc/.manual.xml
-t [--theme] <theme name>
The theme to render
Example: -t chunkedhtml
-p [--partial] <ID>
Partial rendering
Example: -p function.strpos
The recommended way to build the PHP docs:
cd phpdoc
php configure.php
phd -d .manual.xml -t chunkedhtml # Or "phpweb" for the .php files
PhD is still looking for volunteers to create a basic "project
page"/"web site", to be located on http://doc.php.net/phd, so in the
mean time the wiki on doc.php.net (http://doc.php.net/wiki/phd) will
have to do.
PhD 0.2.1 Changelog:
Improved phpdoc support:
- Method names in <classsynopsis> listings are now compressed (Edward Z.)
- Auto-generated method links now follow phpdocs new-oo-style (Edward Z.)
Improved Docbook element support:
- Multiple <term> elements (in a row) are now separated by new line
Other bug fixes:
- The "bightml" theme now includes html headers.
- Warnings about missing translation files (for auto-generated
text) are now suppressed.
-Hannes
