==============
LapackDoc Tour
==============

Let's start with the documentation of __DGETRF__.  It was extracted from the
source file __dgetrf.f__.


Documentation
=============
Right after the title we have a box containing the subroutine declaration.
Clicking on it leads you to its definition inside the source code.

Further we have a __Purpose__ and __Arguments__ section.  The variable names in
the __Arguments__ section are also clickable.  For example __INFO__ is linked
with its definition in the source code.

Finally we have sections with a __Call Graph__ and __Caller Graph__.  Each node
is linked with the documentation of the corresponding subroutine or function.


Source Code
===========
When you look at the source file __dgetrf.f__ you notice that variables and
function/subroutine names are linked.  Links are underlined:

 - *dotted underlined* links a variable to its point of definition.  Check out
   what happens if you click on __IPIV__.
 - *solid black underlined* links to an _external_ definition or
   _documentation_.  Check this out:

     - Click in the first line of __dgetrf.f__ on `DGETRF`.  This leads you to
       the documentation of this `SUBROUTINE`.
     - Click on __DGETF2__.  This leads you to its source file.
     - Click on __LDA__.  This leads you to its description in the __Arguments__
       section of the __DGETRF__ documentation.

 - *solid red underlined* means that more than one external definition was
   found.  Clicking pops up a selection box.  For example __ILAENV__


:links:  DGETRF        -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.html
         Purpose       -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.html#section_Purpose
         Arguments     -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.html#section_Arguments
         INFO          -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.html#info
         Caller Graph  -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.html#section_Caller_Graph
         Call Graph    -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.html#section_Call_Graph
         dgetrf.f      -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.f.html
         IPIV          -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.f.html#125
         DGETF2        -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.f.html#125
         LDA           -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.f.html#9
         ILAENV        -> http://apfel.mathematik.uni-ulm.de/~lehn/lapack-3.3.1/SRC/dgetrf.f.html#72