Aleksandar Donev wrote:
>
> Drew McCormack wrote:
>
> > Can anyone on this list recommend a program to extract documentation
> > from Fortran 77 and 90? Something along the lines of javadoc, but then
> > fortran aware.
>
> I have researched this question in detail (last summer--I doubt anything
> has changed since). You basically don't have that much choice, so you'll
> have to relax any requirements that you have and just go along with what
> is out there.
> First, you have the choice of using a language-independent documentation
> system like NuWeb (http://nuweb.sourceforge.net/), or even better (with
> macro support), FunnelWeb (http://www.ross.net/funnelweb/).
> The analog of javadoc is f90doc
> (http://theory.lcs.mit.edu/~edemaine/f90doc/).
> I use FWEB (http://w3.pppl.gov/~krommes/fweb.html), which is much more
> compehensive then what you need, but also much harder to learn and use
> well.
>
> So I say look at f90doc first!
one of the nicest tools out there for this sort of thing is Doxygen
(http://www.stack.nl/~dimitri/doxygen/index.html), but it's only for
C-ish langs - I've always wondered how difficult it would be to add
support for Fortran to its language parser
an overview of the architecture is here:
http://www.stack.nl/~dimitri/doxygen/arch.html
-John Turner
LANL, CCS-2
|