Doxygen es un programa esencialmente de consola, que lee el código fuente de un programa, y a partir de los “comentarios” más las definiciones del propio código genera la documentación, la cual puede hacerse en varios formatos a la vez.

Dentro de los formatos de documento que más me interesan está disponible el HTML (varias páginas con enlaces entre sí) y LaTeX (el cual se puede pasar a PDF con pdflatex).

En el proyecto GDT, he estado traspasando la antigua documentación a los comentarios del código fuente.

Lo interesante de Doxygen, es que en sí trabaja parecido a un compilador, en el sentido de que analiza el texto, la sintaxis, reconoce el lenguaje,y además permite su propia sintaxis en los comentarios, de modo que cualquier cosa que uno escriba puede ser formateada al generar el documento, pero sin alterar la funcionalidad del programa.

Otro dato bueno, es que Doxygen permite ocupar una herramienta externa de Graphviz llamada “dot“. Este programita hace gráficos/diagramas. En conjunto con Doxygen, genera los diagramas de colaboración y herencia entre las Clases.

Finalmente, obtenemos un documento que hace referencia a todo nuestro programa, de calidad profesional, y que permite una facil publicación.

El único contra que llevo hasta el minuto, es que en la versión PDF, la documentación de GDT me está quedando un poquito pasada de peso (3 MB, con más de 500 páginas). Tal vez sea porque active la opción que incluye todos los métodos heredados en las Clases hijas, o quizás GDT tiene muchas Clases.

Hay 2 cosas que he descubierto muy bien aún, pero me parece que se pueden hacer son:

• Agrandar el tamaño de las fórmulas matemáticas.
• Incluir imágenes en el PDF (para contribuir con la obesidad del documento :P)

Para instalar en ubuntu:

sudo apt-get install doxygen graphviz tetex-base tetex-extra

Más información en la web oficial de Doxygen.

El mismo driver de nvidia fué un dolor de cabeza.

De hecho no está el mismo cmake, que es vital para poder hallar las dependencias y poder compilar con ellas.

Acá un hay un screenshot del Juegodemo corriendo en Opensuse.

El procedimiento consiste en

• Instalar el manejador de paquetes smart. El porque, bueno, se darán cuenta cuando quieran agregar repositorios en Yast, quizás sus nietos terminen compilando GDT.
• Agregar los repositorios (canal) sugeridos acá.

su
smart channel --add suse-oss102 type=yast2 baseurl=http://ftp.skynet.be/pub/ftp.opensuse.org/opensuse/distribution/10.2/repo/oss/
smart channel --add suse-non-oss102 type=yast2 baseurl=http://ftp.skynet.be/pub/ftp.opensuse.org/opensuse/distribution/10.2/repo/non-oss/
smart channel --add update10.2 type=rpm-md name="update 10.2" baseurl=http://ftp.skynet.be/pub/ftp.suse.com/suse/update/10.2/
smart channel --add packman102 type=rpm-md name="Packman 10.2" baseurl=http://ftp.skynet.be/pub/packman/suse/10.2/
smart channel --add guru102 type=yast2 name="Guru 10.2" baseurl=http://ftp.skynet.be/pub/suser-guru/rpm/10.2/
smart update


• Instalar los paquetes dependencia.

sudo smart install cmake Mesa xorg-x11-devel openal openal-devel freealut freealut-devel libogg libogg-devel libvorbis libvorbis-devel lua lua-devel

• Instalar Irrlicht manualmente, es decir, bajar el SDK, compilarlo e instalarlo.
• Algo que no hace el “make install” de Irrlicht es copiar los headers. Es necesario copiar (con permisos de root) todo

sudo mkdir /usr/local/include/Irrlicht
sudo cp /ruta-a-irrlicht-sdk/include/*.h /usr/local/include/Irrlicht

• Listo, ahora basta bajar el codigo fuente de gdt, y configurar y compilar. Para ello es necesario posicionarse en el directorio donde se ha descomprimido el paquete , y luego…
  cmake .
make gdt
• Listo, ahora basta bajar el codigo fuente de gdt, y configurar y compilar. Para ello es necesario posicionarse en el directorio donde se ha descomprimido el paquete , y luego…
  Finalmente, para probar, en caso de haber bajado el gdt-sdk...
make juegodemo
bin/juegodemo