And that's about it from me. As you can see, tools such as the ones discussed in this article can substantially reduce the time you spend documenting your code...so long as you remember to comment your code correctly. If you can manage that - and you should be able to - then say goodbye to those long hours writing API documentation, and say hello to the brave new world of PHPDoc and its brethren. In case you're interested in learning more about the technologies discussed in this article, consider visiting the following links: The JavaDoc Web site, at http://java.sun.com/j2se/javadoc/ The PHPDoc Web site, at http://www.phpdoc.de/ The eZ phpdoc Web site, at http://developer.ez.no/ The eZ phpdoc tutorial, at http://publish.ez.no/article/articleprint/29/ Till next time...be good! Note: All examples in this article have been tested on Linux/i586 with PHPDoc 1.0b, Apache 1.3.20 and PHP 4.1.1. Examples are illustrative only, and are not meant for a production environment. Melonfire provides no warranties or support for the source code described in this article. YMMV!
blog comments powered by Disqus |