Je suis fan de la JavaDoc du coup je truffe mes devs PHP de @return et autres @param (pour ne citer qu’eux) et maintenant avec PHP5 je peux ajouter des @access et autres @static et @abstract … bref tout ça pour dire que j’ai trouvé l’outil ultime : j’ai nommé doxygen, il permet de générer la doc en HTML, RTF, PS, PDF, man Unix. Doxygen est distribué sous license GPL.

Bref pour l’avoir testé à l’instant, je dois dire que le résultat surpasse ce que j’obtenais avec le parser de phpDoc (http://www.phpdoc.de à ne pas confondre avec les autres parseurs comme phpdocumentor par exemple.)

Bref, si vous ne développez pas avec un ide ayant cette fonctionnalité intégrée, je vous le conseille.

Ah oui j’allais oublier, ici (developpez.com) vous pouvez trouver un bon comparatif des solutions de documentations pour PHP.