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.
the docblock extension takes a T_DOC_COMMENT like so:
<?php
/**
* Hello
*
* This is a documentation comment
* @author Greg Beaver
* @version 1.3.5
*/
?>
and scans it for tokens. This is useful in several ways, not the least of which will be found in the 1.4.x series of phpDocumentor, a true docblock parser with support for some of the more unusual stuff like:
<?php
/**
* Hello
*
* This documentation causes problems in
* phpDocumentor 1.3.x:
*
* <code>
* @include 'oops.php';
* </code>
*
* because it doesn't truly lex the doc comment, and so thinks "@include" is a tag like "@version" or "@author"!
*/
?>
Enjoy!