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.

1 files changed, 29 insertions, 41 deletions

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