On his blog today, Greg Beaver has a release note about the latest version of the PECL extension for working with docblock - version 0.2.0 has been posted.

Just a few moments ago, I uploaded a new release of the docblock lexer extension for PECL at http://pecl.php.net/docblock. This release fixes two edge case bugs that I discovered while writing a docblock parser using the docblock extension. Otherwise, it's the same as the initial release.

He demonstrates how the extension works through two different examples - one with a simplely formatted comment block, and the other with something a bit more complex (an include).