Hi all
The second maintenance release of PhD 0.2, PhD 0.2.2 has been released.
This release contains a good chunk of bug fixes and few neat features
(see below), definitely worth upgrading to :)
As usual, to upgrade PhD from prior releases:
pear upgrade http://doc.php.net/phd/PhD-0.2.2.tgz
And to install PhD for the first time:
pear install http://doc.php.net/phd/PhD-0.2.2.tgz
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
Noticeable changes in 0.2.2:
- Index cacher (-i [--index] <bool>) (by Edward Z.)
- <function>s are now matched against <refname>, not IDs
- Classes in <type>s now create links to the class documentation
- Partial rendering now checks if the ID passed exists before rendering
- Internal links in the bightml now work
- New option (-l [--list]) to list supported formats/themes
PhD 0.2.1 Changelog:
- Removed support for phnotify
- Added index caching (Edward Z.)
- Added option (-l/--list) to list the supported formats/themes
- Added support for linkend in fieldsynopsis varnames
- Added autogenerated text for <editor>
- Added autogenerated text for the first <author> element in <authorgroup>
- Added missing closing "}" for classsynopsis
- Fixed E_NOTICE on empty references
- Fixed weird error message when no arguments are given (reported by Tony)
- Fixed typos in the argument descriptions (--help) (reported by Tony)
- Fixed bug#43972 (PhD doesn't warn on missing partial IDs)
- Fixed bug#43904 (PhD doesn't detect <section> without xml:id)
- Fixed bug#43489 (Class synopsis return types are not links)
- Fixed bug#43440 (Wrong encoding on some parts of the page)
- Fixed bug#43428 (Empty TOC)
- Fixed bug#43421 (All intra-document hyperlinks broken in the
Single HTML file form of manual)
- Fixed bug#43416 (Function links do not render as links)
It is a good chunk of changes and definitely improves both the
end-user experience
(less weird function references without links & looking up the class
description in an argument now "just a click away") and the documentors
(less time wasted on re-indexing all the time & warning issued if ID
doesn't exist in partial rendering).
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.
-Hannes
