News Feed
Sections




News Archive
Looking for more information on how to do PHP the right way? Check out PHP: The Right Way

Liip Blog:
PHPDoc Compilers and the @inheritdoc
July 26, 2011 @ 09:29:06

On the Liip blog there's a new post that compares some of the popular PHPDocumentor-formatted comments parsers. They're looking specifically at the support for interfaces, not just the usual classes and methods.

The interfaces define the standard and are extensively documented. The implementation was built by copying the interfaces and implementing the methods. Now we have the documentation comments duplicated, which is a pain to maintain if we clarify or change anything in the interfaces documentation. [...] In PHP, there is a couple of doc compilers. While they basically all follow the same syntax as Java uses, none of them gets everything right unfortunately.

The four covered are PhpDoctor, DocBlox, PHPDoc and Doxygen. They look at things like namespace support, the inheritance information they generate and if it correctly uses the "@inheritDoc" tagging functionality.

0 comments voice your opinion now!
inheritdoc phpdocumentor standard library phpdoctor docblox phpdoc doxygen


blog comments powered by Disqus

Similar Posts

Tom Butler: PHP: PSR-0: Pretty Shortsighted, Really

Drew McLellan's Blog: hKit Microformats Toolkit for PHP

Greg Beaver\'s Blog: phpDocumentor and PEAR - interesting crossing of paths

LispCast.com: An interesting analysis of why PHP is so popular

PHPit.net: Taking a first look at the AutoCRUD for PHP library


Community Events

Don't see your event here?
Let us know!


library series symfony2 configure opinion interview laravel framework api introduction php7 podcast part2 performance example application community voicesoftheelephpant conference release

All content copyright, 2015 PHPDeveloper.org :: info@phpdeveloper.org - Powered by the Solar PHP Framework