Leyendo más fácilmente el código C o C++ de un proyecto grande.

[Donatien]

Cada tanto leo en artículos o posts que la mejor forma de aprender C es leyendo el código de otros programas e intentar entenderlo... Esto no es más fácil de decir que de hacer, pero encontré una herramienta que puede ayudarnos a leer y entender el código fuente completo de cualquier proyecto por más grande que éste sea, incluso un kernel mismo... (¿me habré ido al carajo?)

Esta herramienta se llama Doxygen y es un programa que está disponible para Linux, Windows y varios Unix'es:

Pagina web: http://www.stack.nl/~dimitri/doxygen/index.html
Download directo: http://www.stack.nl/~dimitri/doxygen...html#latestsrc

Lo bueno de Doxygen es que transforma el código fuente en un HTML browseable, en el cual, por ejemplo, cada vez que se declara una variable de un tipo definido por el usuario, el tipo aparece como un link al archivo que lo define. Cada vez que encontremos un #include el mismo será un link al archivo incluído, y para cada función declarada por el programador tendremos una lista de referencias utilizadas y de funciones que a su vez, hacen referencia a la misma.

Como ejemplo, un poryecto que utiliza Doxygen es el famoso rsync (un servicio/utilitario para sincronizar el contenido de dos discos en distintas máquinas).

Acá pueden leer el archivo socket.c que rsync usa para sus conexiones. Cada referencia está linkeada a su archivo original:
http://samba.anu.edu.au/rsync/doxyge...8c-source.html

El resultado de ejecutar Doxygen en nuestros propios proyectos (o en cualquier proyecto de terceros) no va a ser muy distinto al ejemplo de rsync...

Además, Doxygen nos va a permitir generar el output en distintos formatos, el más común va a ser HTML, pero tambien permite generar fuentes para archivos .CHM muy bien organizados (de acá surgió en principio la iniciativa de buscar el MS. HTML Help Workshop que nombré en Bajando libros y compilandolos en archivos CHM (ayuda de Windows)) además de que puede generar Man Pages, archivos LaTeX, etc, todo con infinidad de opciones.

Nos vemos!

Donatien.-

PD: Yo no soy un programador avanzado en C ni C++, más bien principiante, pero quiero compartir todo lo que voy descubriendo porque si somos más los que investigamos juntos más va a ser lo que aprendamos.
Lo que quiero decir con esto es que posteen recomendaciones a las herramientas más útiles que usen generalmente, así como yo comparto las mías también me gustaría conocer las de ustedes.

[Donatien]

Ops, en el primer parrafo lease: "esto es más facil de decir que de hacer"...
(me sobró un "no")

[qwerty]

Che gracias, te estas re portando con las cosas sobre C que estas trayendo.

[qwerty]

Jajaja, fijate que por internet hay kernels pasados a html asi... seguramente usaron ese soft porque a mano es una tortura

[Negro]

gracias por el post! Por cierto, que compilador/entonrno, etc están usando para Win?

Yo estube buscando y conseguí el DevC++/mingw (gcc para win) y el lcc-win32. Alguien tiene experiencia con ellos?

[qwerty]

Comerciales:
Visual C++ 6.0 (Mi preferido)
Borland (Hay una version sin ide que se baja gratuita de la pagina de Borland)
Gnu:
Djgpp: Exelente, estilo Dos, basado en el gcc.
Cygnus: Mejor todabia, y anda en windows perfecto. Ademas podes llegar a convinar los headers y librerias con el Visual Studio, funciona como una Api de Unix en Windows.

Con esos 4 estas hecho.

[Gallagher]

gracais!