Doxygen Fortran

November 21st, 2007

Para 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.

Comments are closed.