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.

12 files changed, 120 insertions, 144 deletions

diff --git a/BLAS/TESTING/cblat1.f b/BLAS/TESTING/cblat1.f
index c8be436f..450df9e3 100644
--- a/BLAS/TESTING/cblat1.f
+++ b/BLAS/TESTING/cblat1.f
@@ -5,26 +5,25 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM CBLAT1
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>    Test program for the COMPLEX Level 1 BLAS.
 *>    Based upon the original BLAS test routine together with:
 *>
 *>    F06GAF Example Program Text
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -35,8 +34,7 @@
 *
 *> \ingroup complex_blas_testing
 *
-*  =====================================================================
-      PROGRAM CBLAT1
+*  =====================================================================      PROGRAM CBLAT1
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/cblat2.f b/BLAS/TESTING/cblat2.f
index 35f76afa..e8467d25 100644
--- a/BLAS/TESTING/cblat2.f
+++ b/BLAS/TESTING/cblat2.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM CBLAT2
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the COMPLEX          Level 2 Blas.
 *>
@@ -86,11 +86,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -101,8 +100,7 @@
 *
 *> \ingroup complex_blas_testing
 *
-*  =====================================================================
-      PROGRAM CBLAT2
+*  =====================================================================      PROGRAM CBLAT2
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/cblat3.f b/BLAS/TESTING/cblat3.f
index a84229ee..25bc741c 100644
--- a/BLAS/TESTING/cblat3.f
+++ b/BLAS/TESTING/cblat3.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM CBLAT3
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the COMPLEX          Level 3 Blas.
 *>
@@ -68,11 +68,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -83,8 +82,7 @@
 *
 *> \ingroup complex_blas_testing
 *
-*  =====================================================================
-      PROGRAM CBLAT3
+*  =====================================================================      PROGRAM CBLAT3
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/dblat1.f b/BLAS/TESTING/dblat1.f
index 568160a3..bda7aa78 100644
--- a/BLAS/TESTING/dblat1.f
+++ b/BLAS/TESTING/dblat1.f
@@ -5,26 +5,25 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM DBLAT1
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>    Test program for the DOUBLE PRECISION Level 1 BLAS.
 *>
 *>    Based upon the original BLAS test routine together with:
 *>    F06EAF Example Program Text
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -35,8 +34,7 @@
 *
 *> \ingroup double_blas_testing
 *
-*  =====================================================================
-      PROGRAM DBLAT1
+*  =====================================================================      PROGRAM DBLAT1
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/dblat2.f b/BLAS/TESTING/dblat2.f
index 5e07e2ab..52eefcc6 100644
--- a/BLAS/TESTING/dblat2.f
+++ b/BLAS/TESTING/dblat2.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM DBLAT2
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the DOUBLE PRECISION Level 2 Blas.
 *>
@@ -85,11 +85,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -100,8 +99,7 @@
 *
 *> \ingroup double_blas_testing
 *
-*  =====================================================================
-      PROGRAM DBLAT2
+*  =====================================================================      PROGRAM DBLAT2
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/dblat3.f b/BLAS/TESTING/dblat3.f
index 87a3e09d..d716f1ec 100644
--- a/BLAS/TESTING/dblat3.f
+++ b/BLAS/TESTING/dblat3.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM DBLAT3
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the DOUBLE PRECISION Level 3 Blas.
 *>
@@ -65,11 +65,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -80,8 +79,7 @@
 *
 *> \ingroup double_blas_testing
 *
-*  =====================================================================
-      PROGRAM DBLAT3
+*  =====================================================================      PROGRAM DBLAT3
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/sblat1.f b/BLAS/TESTING/sblat1.f
index c465f630..744f2d9e 100644
--- a/BLAS/TESTING/sblat1.f
+++ b/BLAS/TESTING/sblat1.f
@@ -5,26 +5,25 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM SBLAT1
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>    Test program for the REAL Level 1 BLAS.
 *>
 *>    Based upon the original BLAS test routine together with:
 *>    F06EAF Example Program Text
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -35,8 +34,7 @@
 *
 *> \ingroup single_blas_testing
 *
-*  =====================================================================
-      PROGRAM SBLAT1
+*  =====================================================================      PROGRAM SBLAT1
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/sblat2.f b/BLAS/TESTING/sblat2.f
index 10a0adcb..53f760b4 100644
--- a/BLAS/TESTING/sblat2.f
+++ b/BLAS/TESTING/sblat2.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM SBLAT2
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the REAL Level 2 Blas.
 *>
@@ -85,11 +85,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -100,8 +99,7 @@
 *
 *> \ingroup single_blas_testing
 *
-*  =====================================================================
-      PROGRAM SBLAT2
+*  =====================================================================      PROGRAM SBLAT2
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/sblat3.f b/BLAS/TESTING/sblat3.f
index 535e2e26..a07e8e69 100644
--- a/BLAS/TESTING/sblat3.f
+++ b/BLAS/TESTING/sblat3.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM SBLAT3
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the REAL             Level 3 Blas.
 *>
@@ -65,11 +65,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -80,8 +79,7 @@
 *
 *> \ingroup single_blas_testing
 *
-*  =====================================================================
-      PROGRAM SBLAT3
+*  =====================================================================      PROGRAM SBLAT3
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/zblat1.f b/BLAS/TESTING/zblat1.f
index a8ad681b..3482afa1 100644
--- a/BLAS/TESTING/zblat1.f
+++ b/BLAS/TESTING/zblat1.f
@@ -5,26 +5,25 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM ZBLAT1
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *>    Test program for the COMPLEX*16 Level 1 BLAS.
 *>
 *>    Based upon the original BLAS test routine together with:
 *>    F06GAF Example Program Text
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -35,8 +34,7 @@
 *
 *> \ingroup complex16_blas_testing
 *
-*  =====================================================================
-      PROGRAM ZBLAT1
+*  =====================================================================      PROGRAM ZBLAT1
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/zblat2.f b/BLAS/TESTING/zblat2.f
index 014ed665..71e8c21d 100644
--- a/BLAS/TESTING/zblat2.f
+++ b/BLAS/TESTING/zblat2.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM ZBLAT2
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the COMPLEX*16       Level 2 Blas.
 *>
@@ -86,11 +86,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -101,8 +100,7 @@
 *
 *> \ingroup complex16_blas_testing
 *
-*  =====================================================================
-      PROGRAM ZBLAT2
+*  =====================================================================      PROGRAM ZBLAT2
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
diff --git a/BLAS/TESTING/zblat3.f b/BLAS/TESTING/zblat3.f
index b189e284..18556809 100644
--- a/BLAS/TESTING/zblat3.f
+++ b/BLAS/TESTING/zblat3.f
@@ -5,16 +5,16 @@
 * Online html documentation available at 
 *            http://www.netlib.org/lapack/explore-html/ 
 *
-*  Definition
-*  ==========
+*  Definition:
+*  ===========
 *
 *       PROGRAM ZBLAT3
 * 
-*  Purpose
-*  =======
 *
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+*  =============
+*>
+*> \verbatim
 *>
 *> Test program for the COMPLEX*16       Level 3 Blas.
 *>
@@ -69,11 +69,10 @@
 *>    10-9-00:  Change STATUS='NEW' to 'UNKNOWN' so that the testers
 *>              can be run multiple times without deleting generated
 *>              output files (susan)
-*>
-*>\endverbatim
+*> \endverbatim
 *
-*  Authors
-*  =======
+*  Authors:
+*  ========
 *
 *> \author Univ. of Tennessee 
 *> \author Univ. of California Berkeley 
@@ -84,8 +83,7 @@
 *
 *> \ingroup complex16_blas_testing
 *
-*  =====================================================================
-      PROGRAM ZBLAT3
+*  =====================================================================      PROGRAM ZBLAT3
 *
 *  -- Reference BLAS test routine (version 3.4.0) --
 *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --