PHPDocumentor

Il s'agit d'un outil pour documenter automatiquement le code PHP à partir de commentaires suivant un format précis dans le code. Il gère plusieurs format html, pdf, chm etc.
L'installation se fait avec pear install phpdocumentor (en supposant que vous avez installé PEAR).

Dans Eclipse on peut créer une commande Externe en allant dans le menu Run / External tools / External Tools Configuration.
Vous choisissez Program comme type de commande externe et New.
Définir le nom de l'ouil : PHPDoc par exemple
Définir le chemin de l'exécutable : C:\wamp\bin\php\php5.2.9-2\phpdoc.bat dans mon cas.
Définir le répertorie de travail ; C:\wamp\bin\php\php5.2.9-2 dans mon cas
Définir les arguments : -d "${project_loc}\include" -o HTML:Smarty:default -t "${project_loc}\help" pour scanner le répertoire include avec un rendu de type HTML sans cadre et le résultat stocké dans le répertoire help.

Il suffit après de se placer sur un projet et de faire run / External Tools / PHPDoc

Vous trouverez la documentation officielle en anglais sur www.phpdoc.org