 |
 |
Thanks to all those who replied (Craig McNeile, Pincon Bruno, Harvey Richardson, TedStern). My original question was: I am looking for something that will automatically generate/extract information from source code and produce HTML documentation. I have seen this done well for non-Fortran90 projects (e.g. using JavaDoc or doxygen http://www.stack.nl/~dimitri/doxygen/ ). Does anybody have any recomendations for something (non-commercail) that will work with Fortran90 source? >From the replies and my own searches I came up with the following possibilites (they are all written as Perl scirpts by the way) :- 1.) for2html ( http://www.e13.physik.tu-muenchen.de/Wuttke/f2h.html ) This converts fortran source to HTML. It adds cross referencing of all function and subroutine calls but does not allow additional comment fields. It is not tested for f90 (does not accept free format files at the moment). 2.) f90doc ( http://daisy.uwaterloo.ca/~eddemain/f90doc/ ). This tool is specifically aimed at f90. Information is processed on a module-by-module basis and a html documentation file generated from tagged comments in the source. No index is produced. The output is fairly basic html (an example is at http://daisy.uwaterloo.ca/~eddemain/f90doc/ordered_pair.html ). 3.) grdoc ( http://jean-luc.ncsa.uiuc.edu/Codes/grdoc/ ). This tool was developed with c, c++, and F77 in mind. This works in a similar way to doxygen (above) and has a wide range of tags available. It processes list of files or whole directories and is able to produce indexes and cross references of routines, files, variables and parameters. (see example at http://jean-luc.ncsa.uiuc.edu/Codes/grdoc/grdoc/index.html ). Unfortunately, although tested on F77 it is not adapted for f90. (There are no tags relating to modules for example.) However, it may be possible to adapt the scripts to deal with this. I expect I will have a closer look at grdoc and f90doc and see what results I get. I Hope this is useful. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Simon J. Rees, Ph.D Visiting Assistant Professor Oklahoma State University School of Mechanical & Aerospace Engineering 218 Engineering North Stillwater. OK 74078, USA Phone: (+1) 405-744-5900 Fax: (+1) 405-744-7873 URL: http://www.mae.okstate.edu/Faculty/sjrees/index.html ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%