Tip for documentation machinery?

[m98marba]

Hi!
As my experience with PHP has increased I recently started to search for some kind of system to help documentation of my code. Does anyone have a good tip concerning what system to use?

I've had a glance at PHPDoc

http://www.phpdoc.de/index.html

and read a description of the DDDA

http://www.aditus.nu/jpgraph/DDDA/

(Database Driven Documentation Architecture). The DDDA approach seems really "competent" as it combines inline documentation as well as a WEB-based user interface for comprehensive documentaion. Unfortunately I haven't found any script implementing the DDDA to download. Maybe it dosn't exists (yet)?

However PHPDoc may be less tricky to use and learn. I also had the impression that PHPDoc is quite slow when generation the documentation (- it creates a bunch of HTML and XML files).

Any comments, tips or experiences are greatly apprecciated!

Markus

 

[ArkM]

Try Doxygen:

http://www.stack.nl/~dimitri/doxygen/.

It's C++ doc sys, but now it can work with Java and PHP sources. In C++ area it's the best choice (I think). Doxygen is a true "jet fighter"...

 

[m98marba]

Thanks ArkM,
I've had a glance at Doxygen. Seems intersting. But, I think i'll study PHPDoc some more first because it's writen with PHP.

There are a good list of links to other documentaion systems at the page you've mentioned. Maybe I find something there too.