Encontré esta pequeña aplicación que parsea los comentarios del código de php (los que tienen un formato compatible a la aplicación), y genera documentación estilo javadoc. Es bastante útil y simple de usar, y me está ayudando a comentar de mejor manera mis aplicaciones:
phpscribe
Documentación de Código
