La plaga Tux

Acabo de encontrar una nueva razón para que Eclipse se convierta en mi entorno de desarrollo por defecto, y no es otra que el plugin Eclox, con el cual podremos tener una documentación doxygen mediante dos sencillos clicks .

Ante la reciente salida de la nueva versión de Eclipse Ganymede, me decidí a borrar la versión que tenía instalada en mi equipo mediante el sistema de paquetes de Ubuntu y bajarme y probar esta nueva versión orientada al desarrollo en C++ con el plugin CDT integrado. Después echando en falta de nuevo la capacidad para gestionar la documentación mediante Doxygen en Eclipse me puse a buscar si existía algún componente especializado en este cometido, ¡y vaya si existe!.

Para quienes no lo sepan, doxygen es un generador de documentación software para una gran diversidad de lenguajes de programación, entre los que se incluyen C, C++, C# y Java. Con el uso de esta herramienta se generarán documentaciones profesionales solamente en base a los comentarios que se hayan ido introduciendo en cada uno de los ficheros de código que componen el proyecto.

En la página del proyecto Eclox podemos encontrar el sitio que podemos indicarle al gestor de actualizaciones de Eclipse para instalar de forma automática el plugin. Esta dirección es concretamente:

http://download.gna.org/eclox/update

Una vez que tengamos Eclipse abierto, nos vamos al menú “Help” -> “Software Updates”, y desde ahí pulsamos en la pestaña “Available Software”. Ahora pulsamos en “Add Site” y añadimos la dirección anterior, una vez que aparezca en el árbol de sitios la marcamos y pulsamos en el botón install que aparece arriba. Después de que se instale no pedirá que reiniciemos la aplicación, le hacemos caso y listo.

Ahora una vez que tengamos creado un proyecto en C++ tal y como indiqué en una entrada anterior, pulsamos en el nuevo botón que aparece justo al lado del botón de depuración, y el cual aparece con el símnolo de una arroba. Este botón sirve para generar la configuración del doxyfile, el archivo que almacena toda la configuración para la generación posterior de la documentación.

Una vez que se ha creado, para editarlo tendremos que abrirlo desde el explorador de proyectos, ya que si le damos de nuevo al botón mencionado anteriormente se generará la documentación en base a las opciones establecidas en el fichero.