Logotipo de PHPDocumentor Para generar la documentación a partir del código fuente de Gesbit, vengo utilizando el programa phpDocumentor, y no es que me vaya mal del todo, aunque, esta aplicación puede llegar a dar un poco de miedo, porque, y no exagero, generar la documentación de Gesbit viene a costar unos veinte minutos, y un consumo de la CPU extraordinario, con lo que viejo PC las pasa canutas.

Como tengo la sana costumbre de pasar por SourceForge de vez en cuando, a veces me topo con pequeñas joyas, como creo que es el programa que me he encontrado esta tarde: phpDoctor. Ahora bien, hasta el diamante más brillante ha de tener algún fallo, ¿no? Y en el caso de phpDoctor hemos de tener en cuenta que no tiene todas las funcionalidades que ofrece phpDocumentor, y, sin embargo, no deja de ser un excelente programa, en mi opinión.

El caso es que los veinte minutos que tardo en generar la documentación de Gesbit usando phpDocumentor, se queda en cuestión de segundos utilizando phpDoctor. ¿He dicho segundos? Así es. Rara vez, en las pruebas que he llevado a cabo, ha pasado del minuto en generar la documentación del proyecto. Además phpDoctor cuenta con muy completa documentación, y, si antes he dicho que era más sencillo que phpDocumentor, también he dicho que no tanto.

Una de las características que pueden echarse en falta en phpDoctor es que, hasta donde yo he podido llegar, no incluye el código fuente del proyecto en la documentación. Esto es una opción en phpDocumentor, que, parece no estar disponible en phpDoctor. Y seguro de que esta es una tarea que le lleva su tiempo a phpDocumentor. Sólo por esto he dudado en usar phpDoctor en lugar de phpDocumentor, pero, lo cierto es que se muestra muy, muy rápido.

Si no conocías el programa phpDoctor, échale un vistazo. No pierdes nada.