docblocks

Most common docblock for Delphi and/or FreePascal code

I'm quite familiar with PHP dockblocks since it's been my job for the last 15+ years. /** * Description * * @tag bla bla * @tag more bla bla */ What I'm trying to understand is if there is a standard like that for Delphi and/or FreePascal. From my analysis on an awful lot of code I never seen any, but I could be dead wrong....

Zend Framework Generator generating extra line for dockblocks

I'm creating a php cli program to generate unit tests for our project. in the command line a enter a sourcefile and a destination file. If the destination file allready exists I parse it with Zend_CodeGenerator_File::fromReflection(). The destination file is the unit test class file. Then I check what methods need to be added to the unit...

Are there any PHP DocBlock parser tools available?

I would like to build some smaller scale but hightly customized documentation sites for a few projects. PhpDocumentor is pretty great but it is very heavy. I thought about trying to tweak the templates for that but after spending only a couple of minutes looking into it I decided that it would be too much work. Ideally I'd like to see s...

Resources for writing good PHP documentation

I am getting a tool ready to make the source public. I would like to have it well documented for people who would use it as well as potential contributors. I am already using some rudimentary docblocks and some line comments for class variables. Currently I am using doxygen because it integrates into eclipse, but I am not wedded to it...