==========================================
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(hide)]----------------------------------------------*
  |                                                             |
  |  rm -rf /tmp/lapack                                         |
  |                                                             |
  *-------------------------------------------------------------*

  *--[SHELL]----------------------------------------------------*
  |                                                             |
  |  mkdir /tmp/lapack                                          |
  |  cd /tmp/lapack                                             |
  |  curl -s -O http://www.netlib.org/lapack/lapack-3.3.1.tgz   |
  |  tar xfz lapack-3.3.1.tgz                                   |
  |  time lapackdoc 2>log                                       |
  |                                                             |
  *-------------------------------------------------------------*


:links: here      ->  doc:index
        LAPACK    ->  http://www.netlib.org/lapack/
        Graphviz  ->  http://www.graphviz.org