Doxygen Fortran
November 21st, 2007Para alegrÃa de propios y extraños ya se encuentra disponible el soporte de Fortran por parte de Doxygen, el popular software de documentación automática. La versión que soporta Fortran es la 1.5.4 y esta disponible vÃa svn o bajando el tarball adecuado. Supongo que en poco tiempo (si no está ya listo) se podrán descargar los binarios de las distribuciones más populares a través de los tÃpicos interfaces.
Mencionar que no soporta correctamente los fuentes de Fortran 95, con lo que si queremos que nuestros .f95 sean procesados correctamente tendremos que bajarnos los fuentes y añadir dos lÃneas en el fichero fuente doxygen.cpp alrededor de la lÃnea 8860. Simplemente copiar las de los ficheros .f90 y sustituir el 0 por un 5. Recompilar y listo.
Para usarlo simplemente poner las etiquetas y descripciones para doxygen utilizando el comentario del modo siguiente!> Mi comentario. Por ejemplo:
!> Cuerpo principal del programa
!> @file krube.f95
!> @author David Suárez
!> @version 1.0
program Krube
!> Almacenaje de datos
double precision :: data(100)
call processData(data)
!> Procesamiento de datos
!> @param d, vector de datos a tratar en doble precisión
suroutine processData(d)
double precision, intent(inout) :: d
!! Procesamiento
end subroutine processData
end program Krube
El resto del uso de doxygen es tal y como indica la documentación oficianl. Visiten Doxygen para más información.
La página del autor de la ampliación a Fortran es: http://dougdevel.org/index.php?page=doxygen.