Okay, I’m fed up with phpDocumentator. It consumes way much more memory (1.4 GB) and time (5 minutes on 2.6GHz Core 2 Duo) than I’m willing to give it. Does there exist some really compatible program to generate documentation for PHP code?
I’ve also tried PhpDocGen, but it just bails out with some Perl errors, which I’m too lazy to study.
Doxygen also does not seem to play well with our sources.
Update: The code contains lot of functions and not only objects, what is the biggest problem with Doxygen, because it fails to organize them.
Doxygen is pretty complex, and it’s supposed to support PHP 5.3 features. However, it didn’t work exactly how I wanted it and I realized it’s a big program, but not designed for PHP; so I needed something lighter, simpler and preferably PHP exclusive, because let’s face it, PHP does not have quite the common programming language syntax and look.
I know you mentioned it, but I chose PHPDoctor in the end. It does indeed lack some features, but it’s simple and fast, exactly what I was looking for.
Let us know what you chose and what were the reasons.
Also something to mention is that I found the PHPDoctor interface to be quite simple and easy to style (with few CSS changes). I was able to create quite a clean page for my docs.
We switched from phpDocumentor to Doxygen because the former did not support PHP 5.3 features like namespaces and closures. phpDocumentor’s last update was in 2008.
@-attributes are the same in Doxygen, because they both do JavaDoc-style comments. It is quite configurable, too.
You can also try DocBlox; it is a new kid on the block (pun intended) but already supports many of the features that phpDocumentor provides and many of the newer things (like namespaces).
Please try it out at https://www.github.com/mvriel/Docblox
I’ve been using Natural Docs, works well for me