Demo: Creating a Full LAPACK Documentation
All the tools introduced here can be combined for creating a cool Fortran documentation tool. The lapackdoc script is such a bundle:
-
For each LAPACK source file a cross referenced and syntax highlighted HTML listing gets created.
-
If a LAPACK source file contains embedded documentation it gets extracted.
-
The documentation gets enhanced by call and caller graph.
Note: Creating the call and caller graphs for a large software project is pretty time consuming. Actually a half the time gets used up by Graphviz dot command.
$shell> mkdir /tmp/lapack $shell> cd /tmp/lapack $shell> curl -s -O http://www.netlib.org/lapack/lapack-3.3.1.tgz $shell> tar xfz lapack-3.3.1.tgz $shell> time lapackdoc 2>log real 42m33.900s user 21m0.007s sys 13m49.531s