[dev] Re: Source-level documentation

[Sebastian Bergmann]

Jon Parise wrote:
>  -  Doxygen mostly supports a superset of the phpdoc commands,
>     although some of the phpdoc are now used (i.e. @access).

  Do projects commented with PHPDoc tags need to be "re-commented" for
  doxygen? Or does doxygen understand the PHPDoc tags?

> I've been hearing talk about phpdoc being rewritten / updated /
> improved for almost two years now, and I have yet to see anything
> exciting come of it.

  Right after the PHP Conference 2000, where Ulf Wendel presented PHPDoc,
  Jan Kneschke wrote a Zend Extension that uses PHP's scanner/parser to
  generate the PHPDoc internal XML markup for PHPDoc-style commented PHP
  sourcecode. IIRC, this extension now lives in PECL.

  I'm not sure why there's never been a PHPDoc version that leverages the
  benefits of this extension...

-- 
  Sebastian Bergmann
  http://sebastian-bergmann.de/                 http://phpOpenTracker.de/

  Did I help you? Consider a gift: http://wishlist.sebastian-bergmann.de/