javoaxian cambió a: javoaxian.me
Este blog se mantendrá como histórico del nuevo javoaxian.me. Por tal motivo, sólo serán creados post que harán referencia a los del nuevo blog. Si hay dudas y comentarios, favor de hacerlos en javoaxian.me.

lunes, 24 de marzo de 2008

Natural Docs: Una herramienta para generar documentación a partir del código fuente

Hace algunos días publiqué una herramienta llamada JSDoc, la cual funcionaba muy parecido al javadoc de Java. Pues bien, ésta es otra herramienta similar a la mencionada anteriormente, la gran diferencia es que esta funciona con una gran cantidad de lenguajes, entre los que podemos encontrar:

  • C#
  • Perl
  • ActionScript
  • C/C++
  • Java
  • PHP
  • Python
  • PL/SQL
  • Visual Basic
  • Pascal/Delphi
  • Ada
  • JavaScript
  • Ruby
  • Tcl
  • ColdFusion
  • Assembly
  • Fortran (Formato free solamente)
  • R
  • Makefiles
  • Plain text (Archivos de texto plano)
Un inconveniente que tiene JSDoc es que no puedes documentar las clases generadas con mootools o cuando creas objetos con JavaScript, por lo cual puede que no resulte útil para algunos desarrolladores. Pero como una muy buena alternativa se puede Natural Docs.

El único requerimiento para que funcione, es tener Perl.

Como dato, esta herramienta fue usada por el autor de mootools para generar su documentación junto con GeSHi.