Cosmetic changes in Doxygen presentation.

Use \par instead of \details for section.

add a Contributors Section and a Reference Section.
Remove (some) verbatim section when not needed.
Those changes have been done by hand so I am not sure I manage to catch them all.

23 files changed, 231 insertions, 283 deletions

diff --git a/INSTALL/LAPACK_version.f b/INSTALL/LAPACK_version.f
index d39cfd2e..4d3ce093 100644
--- a/INSTALL/LAPACK_version.f
+++ b/INSTALL/LAPACK_version.f
@@ -5,13 +5,13 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      PROGRAM LAPACK_VERSION
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -22,8 +22,7 @@
 *
 *> \ingroup auxOTHERauxiliary
 *
-*  =====================================================================
-      PROGRAM LAPACK_VERSION
+*  =====================================================================      PROGRAM LAPACK_VERSION
 *
 *  -- LAPACK auxiliary routine (version 3.2) --
 *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
diff --git a/INSTALL/dlamch.f b/INSTALL/dlamch.f
index 6b001c2a..4ab609ef 100644
--- a/INSTALL/dlamch.f
+++ b/INSTALL/dlamch.f
@@ -5,23 +5,22 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      DOUBLE PRECISION FUNCTION DLAMCH( CMACH )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
 *>
-*> DLAMCH determines double precision machine parameters.
+*> \verbatim
 *>
-*>\endverbatim
+*> DLAMCH determines double precision machine parameters.
+*> \endverbatim
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *> \param[in] CMACH
 *> \verbatim
@@ -49,8 +48,8 @@
 *>          rmax  = overflow threshold  - (base**emax)*(1-eps)
 *> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -148,15 +147,13 @@
       END
 ************************************************************************
 *> \brief \b DLAMC3
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> DLAMC3  is intended to force  A  and  B  to be stored prior to doing
 *> the addition of  A  and  B ,  for use in situations where optimizers
 *> might hold one of these in a register.
-*>
-*>\endverbatim
+*> \endverbatim
 *> \author LAPACK is a software package provided by Univ. of Tennessee, Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..
 *> \date November 2011
 *> \ingroup auxOTHERauxiliary
diff --git a/INSTALL/dlamchf77.f b/INSTALL/dlamchf77.f
index 5c848214..6606553f 100644
--- a/INSTALL/dlamchf77.f
+++ b/INSTALL/dlamchf77.f
@@ -5,23 +5,22 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      DOUBLE PRECISION FUNCTION DLAMCH( CMACH )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
 *>
-*> DLAMCHF77 determines double precision machine parameters.
+*> \verbatim
 *>
-*>\endverbatim
+*> DLAMCHF77 determines double precision machine parameters.
+*> \endverbatim
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *> \param[in] CMACH
 *> \verbatim
@@ -49,8 +48,8 @@
 *>          rmax  = overflow threshold  - (base**emax)*(1-eps)
 *> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -185,14 +184,12 @@
 ************************************************************************
 *
 *> \brief \b DLAMC1
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> DLAMC1 determines the machine parameters given by BETA, T, RND, and
 *> IEEE1.
-*>
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[out] BETA
 *> \verbatim
@@ -216,13 +213,12 @@
 *> \verbatim
 *>          Specifies whether rounding appears to be done in the IEEE
 *>          'round to nearest' style.
-*>
-*>\endverbatim
+*> \endverbatim
 *> \author LAPACK is a software package provided by Univ. of Tennessee, Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..
 *> \date November 2011
 *> \ingroup auxOTHERauxiliary
 *>
-*>\details \b Further \b Details
+*> \details \b Further \b Details
 *> \verbatim
 *>
 *>  The routine is based on the routine  ENVRON  by Malcolm and
@@ -384,14 +380,12 @@
 ************************************************************************
 *
 *> \brief \b DLAMC2
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> DLAMC2 determines the machine parameters specified in its argument
 *> list.
-*>
-*>\endverbatim
+*> \endverbatim
 *> \author LAPACK is a software package provided by Univ. of Tennessee, Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..
 *> \date November 2011
 *> \ingroup auxOTHERauxiliary
@@ -445,12 +439,11 @@
 *>          value of BETA.
 *> \endverbatim
 *>
-*>\details \b Further \b Details
+*> \details \b Further \b Details
 *> \verbatim
 *>
 *>  The computation of  EPS  is based on a routine PARANOIA by
 *>  W. Kahan of the University of California at Berkeley.
-*>
 *> \endverbatim
       SUBROUTINE DLAMC2( BETA, T, RND, EPS, EMIN, RMIN, EMAX, RMAX )
 *
@@ -660,14 +653,13 @@
 ************************************************************************
 *
 *> \brief \b DLAMC3
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> DLAMC3  is intended to force  A  and  B  to be stored prior to doing
 *> the addition of  A  and  B ,  for use in situations where optimizers
 *> might hold one of these in a register.
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[in] A
 *>
@@ -700,13 +692,11 @@
 ************************************************************************
 *
 *> \brief \b DLAMC4
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> DLAMC4 is a service routine for DLAMC2.
-*>
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[out] EMIN
 *> \verbatim
@@ -789,18 +779,16 @@
 ************************************************************************
 *
 *> \brief \b DLAMC5
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> DLAMC5 attempts to compute RMAX, the largest machine floating-point
 *> number, without overflow.  It assumes that EMAX + abs(EMIN) sum
 *> approximately to a power of 2.  It will fail on machines where this
 *> assumption does not hold, for example, the Cyber 205 (EMIN = -28625,
 *> EMAX = 28718).  It will also fail if the value supplied for EMIN is
 *> too large (i.e. too close to zero), probably with overflow.
-*>
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[in] BETA
 *> \verbatim
diff --git a/INSTALL/dlamchtst.f b/INSTALL/dlamchtst.f
index d2cf15b9..9b4a86ae 100644
--- a/INSTALL/dlamchtst.f
+++ b/INSTALL/dlamchtst.f
@@ -5,13 +5,13 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      PROGRAM DLAMCHTST
 *  
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -22,8 +22,7 @@
 *
 *> \ingroup auxOTHERauxiliary
 *
-*  =====================================================================
-      PROGRAM DLAMCHTST
+*  =====================================================================      PROGRAM DLAMCHTST
 *
 *  -- LAPACK test routine (version 3.2) --
 *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
diff --git a/INSTALL/dsecnd_EXT_ETIME.f b/INSTALL/dsecnd_EXT_ETIME.f
index 1118042e..a244b49f 100644
--- a/INSTALL/dsecnd_EXT_ETIME.f
+++ b/INSTALL/dsecnd_EXT_ETIME.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      DOUBLE PRECISION FUNCTION DSECND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  DSECND returns the user time for a process in seconds.
 *>  This version gets the time from the EXTERNAL system function ETIME.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/dsecnd_EXT_ETIME_.f b/INSTALL/dsecnd_EXT_ETIME_.f
index 4b5161b2..7fc36964 100644
--- a/INSTALL/dsecnd_EXT_ETIME_.f
+++ b/INSTALL/dsecnd_EXT_ETIME_.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      DOUBLE PRECISION FUNCTION DSECND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  DSECND returns the user time for a process in seconds.
 *>  This version gets the time from the system function ETIME_.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/dsecnd_INT_CPU_TIME.f b/INSTALL/dsecnd_INT_CPU_TIME.f
index 1a0ecd9a..588db945 100644
--- a/INSTALL/dsecnd_INT_CPU_TIME.f
+++ b/INSTALL/dsecnd_INT_CPU_TIME.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      DOUBLE PRECISION FUNCTION DSECND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  DSECND returns the user time for a process in seconds.
 *>  This version gets the time from the INTERNAL function CPU_TIME.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/dsecnd_INT_ETIME.f b/INSTALL/dsecnd_INT_ETIME.f
index a8d8156b..157cde7f 100644
--- a/INSTALL/dsecnd_INT_ETIME.f
+++ b/INSTALL/dsecnd_INT_ETIME.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      DOUBLE PRECISION FUNCTION DSECND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  DSECND returns the user time for a process in seconds.
 *>  This version gets the time from the INTERNAL function ETIME.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/dsecnd_NONE.f b/INSTALL/dsecnd_NONE.f
index b65279ad..527c792c 100644
--- a/INSTALL/dsecnd_NONE.f
+++ b/INSTALL/dsecnd_NONE.f
@@ -5,26 +5,25 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      DOUBLE PRECISION FUNCTION DSECND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  DSECND returns nothing instead of returning the user time for a process in seconds.
 *>  If you are using that routine, it means that neither EXTERNAL ETIME,
 *>  EXTERNAL ETIME_, INTERNAL ETIME, INTERNAL CPU_TIME is available  on
 *>  your machine.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/dsecndtst.f b/INSTALL/dsecndtst.f
index 603d53ee..7403de48 100644
--- a/INSTALL/dsecndtst.f
+++ b/INSTALL/dsecndtst.f
@@ -5,13 +5,13 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      PROGRAM DSECNDTST
 *  
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -22,8 +22,7 @@
 *
 *> \ingroup auxOTHERauxiliary
 *
-*  =====================================================================
-      PROGRAM DSECNDTST
+*  =====================================================================      PROGRAM DSECNDTST
 *
 *  -- LAPACK test routine (version 3.3.1) --
 *
diff --git a/INSTALL/ilaver.f b/INSTALL/ilaver.f
index 4d4714be..779778d5 100644
--- a/INSTALL/ilaver.f
+++ b/INSTALL/ilaver.f
@@ -5,25 +5,24 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *     SUBROUTINE ILAVER( VERS_MAJOR, VERS_MINOR, VERS_PATCH )
 *
 *     INTEGER VERS_MAJOR, VERS_MINOR, VERS_PATCH
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
 *>
-*>  This subroutine returns the LAPACK version.
+*> \verbatim
 *>
-*>\endverbatim
+*>  This subroutine returns the LAPACK version.
+*> \endverbatim
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *>  \param[out] VERS_MAJOR
 *>      return the lapack major version
@@ -34,8 +33,8 @@
 *>  \param[out] VERS_PATCH
 *>      return the lapack patch version from the minor version
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -57,8 +56,7 @@
 *  =====================================================================
 *
       INTEGER VERS_MAJOR, VERS_MINOR, VERS_PATCH
-*  =====================================================================
-      VERS_MAJOR = 3
+*  =====================================================================      VERS_MAJOR = 3
       VERS_MINOR = 3
       VERS_PATCH = 1
 *  =====================================================================
diff --git a/INSTALL/lsame.f b/INSTALL/lsame.f
index b284aa4c..227cc059 100644
--- a/INSTALL/lsame.f
+++ b/INSTALL/lsame.f
@@ -5,8 +5,8 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      LOGICAL FUNCTION LSAME( CA, CB )
 *
@@ -14,19 +14,18 @@
 *      CHARACTER          CA, CB
 *     ..
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> LSAME returns .TRUE. if CA is the same letter as CB regardless of
 *> case.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *> \param[in] CA
 *> \verbatim
@@ -37,8 +36,8 @@
 *>          CA and CB specify the single characters to be compared.
 *> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/lsametst.f b/INSTALL/lsametst.f
index 75dba05a..c44c63e7 100644
--- a/INSTALL/lsametst.f
+++ b/INSTALL/lsametst.f
@@ -5,13 +5,13 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      PROGRAM LSAMETST
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -22,8 +22,7 @@
 *
 *> \ingroup auxOTHERauxiliary
 *
-*  =====================================================================
-      PROGRAM LSAMETST
+*  =====================================================================      PROGRAM LSAMETST
 *
 *  -- LAPACK test routine (version 3.2) --
 *
diff --git a/INSTALL/second_EXT_ETIME.f b/INSTALL/second_EXT_ETIME.f
index 3b010a84..636e18ed 100644
--- a/INSTALL/second_EXT_ETIME.f
+++ b/INSTALL/second_EXT_ETIME.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      REAL FUNCTION SECOND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  SECOND returns the user time for a process in seconds.
 *>  This version gets the time from the EXTERNAL system function ETIME.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/second_EXT_ETIME_.f b/INSTALL/second_EXT_ETIME_.f
index 1e0357ff..29a800c2 100644
--- a/INSTALL/second_EXT_ETIME_.f
+++ b/INSTALL/second_EXT_ETIME_.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      REAL FUNCTION SECOND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  SECOND returns the user time for a process in seconds.
 *>  This version gets the time from the system function ETIME_.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/second_INT_CPU_TIME.f b/INSTALL/second_INT_CPU_TIME.f
index ada39a9f..5816f9f4 100644
--- a/INSTALL/second_INT_CPU_TIME.f
+++ b/INSTALL/second_INT_CPU_TIME.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      REAL FUNCTION SECOND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  SECOND returns the user time for a process in seconds.
 *>  This version gets the time from the INTERNAL function CPU_TIME.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/second_INT_ETIME.f b/INSTALL/second_INT_ETIME.f
index 9b6a61bb..ef2d0251 100644
--- a/INSTALL/second_INT_ETIME.f
+++ b/INSTALL/second_INT_ETIME.f
@@ -5,24 +5,23 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      REAL FUNCTION SECOND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  SECOND returns the user time for a process in seconds.
 *>  This version gets the time from the INTERNAL function ETIME.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/second_NONE.f b/INSTALL/second_NONE.f
index 67d1b677..ffb25283 100644
--- a/INSTALL/second_NONE.f
+++ b/INSTALL/second_NONE.f
@@ -5,26 +5,25 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      REAL FUNCTION SECOND( )
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>  SECOND returns nothing instead of returning the user time for a process in seconds.
 *>  If you are using that routine, it means that neither EXTERNAL ETIME,
 *>  EXTERNAL ETIME_, INTERNAL ETIME, INTERNAL CPU_TIME is available  on
 *>  your machine.
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
diff --git a/INSTALL/secondtst.f b/INSTALL/secondtst.f
index 858a430c..a5078958 100644
--- a/INSTALL/secondtst.f
+++ b/INSTALL/secondtst.f
@@ -6,8 +6,8 @@
 *            http://www.netlib.org/lapack/explore-html/ 
 *
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -18,8 +18,7 @@
 *
 *> \ingroup auxOTHERcomputational
 *
-*  =====================================================================
-      PROGRAM SECONDTST
+*  =====================================================================      PROGRAM SECONDTST
 *
 *  -- LAPACK test routine (version 3.3.1) --
 *
diff --git a/INSTALL/slamch.f b/INSTALL/slamch.f
index e96ed21d..1947b6a6 100644
--- a/INSTALL/slamch.f
+++ b/INSTALL/slamch.f
@@ -5,8 +5,8 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      REAL             FUNCTION SLAMCH( CMACH )
 *
@@ -14,18 +14,17 @@
 *      CHARACTER          CMACH
 *     ..
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
 *>
-*> SLAMCH determines single precision machine parameters.
+*> \verbatim
 *>
-*>\endverbatim
+*> SLAMCH determines single precision machine parameters.
+*> \endverbatim
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *> \param[in] CMACH
 *> \verbatim
@@ -52,10 +51,9 @@
 *>          emax  = largest exponent before overflow
 *>          rmax  = overflow threshold  - (base**emax)*(1-eps)
 *> \endverbatim
-*>
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -149,15 +147,13 @@
       END
 ************************************************************************
 *> \brief \b SLAMC3
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> SLAMC3  is intended to force  A  and  B  to be stored prior to doing
 *> the addition of  A  and  B ,  for use in situations where optimizers
 *> might hold one of these in a register.
-*>
-*>\endverbatim
+*> \endverbatim
 *> \author LAPACK is a software package provided by Univ. of Tennessee, Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..
 *> \date November 2011
 *> \ingroup auxOTHERauxiliary
diff --git a/INSTALL/slamchf77.f b/INSTALL/slamchf77.f
index 71baea2a..5a078d18 100644
--- a/INSTALL/slamchf77.f
+++ b/INSTALL/slamchf77.f
@@ -5,8 +5,8 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *      REAL FUNCTION SLAMCH( CMACH )
 *
@@ -14,18 +14,17 @@
 *      CHARACTER          CMACH
 *     ..
 *  
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
 *>
-*> SLAMCH determines single precision machine parameters.
+*> \verbatim
 *>
-*>\endverbatim
+*> SLAMCH determines single precision machine parameters.
+*> \endverbatim
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *> \param[in] CMACH
 *> \verbatim
@@ -52,10 +51,9 @@
 *>          emax  = largest exponent before overflow
 *>          rmax  = overflow threshold  - (base**emax)*(1-eps)
 *> \endverbatim
-*>
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -191,14 +189,12 @@
 ************************************************************************
 *
 *> \brief \b SLAMC1
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> SLAMC1 determines the machine parameters given by BETA, T, RND, and
 *> IEEE1.
-*>
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[out] BETA
 *> \verbatim
@@ -222,13 +218,12 @@
 *> \verbatim
 *>          Specifies whether rounding appears to be done in the IEEE
 *>          'round to nearest' style.
-*>
-*>\endverbatim
+*> \endverbatim
 *> \author LAPACK is a software package provided by Univ. of Tennessee, Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..
 *> \date November 2011
 *> \ingroup auxOTHERauxiliary
 *>
-*>\details \b Further \b Details
+*> \details \b Further \b Details
 *> \verbatim
 *>
 *>  The routine is based on the routine  ENVRON  by Malcolm and
@@ -390,14 +385,12 @@
 ************************************************************************
 *
 *> \brief \b SLAMC2
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> SLAMC2 determines the machine parameters specified in its argument
 *> list.
-*>
-*>\endverbatim
+*> \endverbatim
 *> \author LAPACK is a software package provided by Univ. of Tennessee, Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..
 *> \date November 2011
 *> \ingroup auxOTHERauxiliary
@@ -451,12 +444,11 @@
 *>          value of BETA.
 *> \endverbatim
 *>
-*>\details \b Further \b Details
+*> \details \b Further \b Details
 *> \verbatim
 *>
 *>  The computation of  EPS  is based on a routine PARANOIA by
 *>  W. Kahan of the University of California at Berkeley.
-*>
 *> \endverbatim
       SUBROUTINE SLAMC2( BETA, T, RND, EPS, EMIN, RMIN, EMAX, RMAX )
 *
@@ -666,14 +658,13 @@
 ************************************************************************
 *
 *> \brief \b SLAMC3
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> SLAMC3  is intended to force  A  and  B  to be stored prior to doing
 *> the addition of  A  and  B ,  for use in situations where optimizers
 *> might hold one of these in a register.
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[in] A
 *>
@@ -706,13 +697,11 @@
 ************************************************************************
 *
 *> \brief \b SLAMC4
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> SLAMC4 is a service routine for SLAMC2.
-*>
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[out] EMIN
 *> \verbatim
@@ -796,18 +785,16 @@
 ************************************************************************
 *
 *> \brief \b SLAMC5
-*>\details
+*> \details
 *> \b Purpose:
-*>\verbatim
-*>
+*> \verbatim
 *> SLAMC5 attempts to compute RMAX, the largest machine floating-point
 *> number, without overflow.  It assumes that EMAX + abs(EMIN) sum
 *> approximately to a power of 2.  It will fail on machines where this
 *> assumption does not hold, for example, the Cyber 205 (EMIN = -28625,
 *> EMAX = 28718).  It will also fail if the value supplied for EMIN is
 *> too large (i.e. too close to zero), probably with overflow.
-*>
-*>\endverbatim
+*> \endverbatim
 *>
 *> \param[in] BETA
 *> \verbatim
diff --git a/INSTALL/slamchtst.f b/INSTALL/slamchtst.f
index 98122750..59c689ac 100644
--- a/INSTALL/slamchtst.f
+++ b/INSTALL/slamchtst.f
@@ -6,8 +6,8 @@
 *            http://www.netlib.org/lapack/explore-html/ 
 *
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -18,8 +18,7 @@
 *
 *> \ingroup auxOTHERcomputational
 *
-*  =====================================================================
-      PROGRAM SLAMCHTST
+*  =====================================================================      PROGRAM SLAMCHTST
 *
 *  -- LAPACK test routine (version 3.2) --
 *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
diff --git a/INSTALL/tstiee.f b/INSTALL/tstiee.f
index 1064f14b..300160f1 100644
--- a/INSTALL/tstiee.f
+++ b/INSTALL/tstiee.f
@@ -5,8 +5,8 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -18,7 +18,6 @@
 *> \ingroup auxOTHERauxiliary
 *
 *  =====================================================================
-
       PROGRAM TSTIEE
 *
 *  -- LAPACK test routine (version 3.2) --
@@ -107,8 +106,8 @@
 *  This routine will not function correctly if it is converted to all
 *  lower case.  Converting it to all upper case is allowed.
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *  ISPEC   (input) INTEGER
 *          Specifies the parameter to be returned as the value of
@@ -640,8 +639,8 @@
 *  IEEECK is called from the ILAENV to verify that Inifinity and 
 *  possibly NaN arithmetic is safe (i.e. will not trap).
 *
-*  Arguments
-*  =========
+*  Arguments:
+*  ==========
 *
 *  ISPEC   (input) INTEGER
 *          Specifies whether to test just for inifinity arithmetic