aboutsummaryrefslogtreecommitdiff
path: root/SRC/stgsna.f
diff options
context:
space:
mode:
authorjulie <julielangou@users.noreply.github.com>2011-11-03 20:32:56 +0000
committerjulie <julielangou@users.noreply.github.com>2011-11-03 20:32:56 +0000
commit1c3ba600671a59785b0c647d400226b4cc19a11f (patch)
tree2af647fcff119db522016721e10b5ee7768d22bb /SRC/stgsna.f
parentd5c30c90bdecf38da1064e2ed52583634573e741 (diff)
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.
Diffstat (limited to 'SRC/stgsna.f')
-rw-r--r--SRC/stgsna.f43
1 files changed, 22 insertions, 21 deletions
diff --git a/SRC/stgsna.f b/SRC/stgsna.f
index 03f6a9b0..ee04d1ee 100644
--- a/SRC/stgsna.f
+++ b/SRC/stgsna.f
@@ -15,8 +15,8 @@
*> [TXT]</a>
*> \endhtmlonly
*
-* Definition
-* ==========
+* Definition:
+* ===========
*
* SUBROUTINE STGSNA( JOB, HOWMNY, SELECT, N, A, LDA, B, LDB, VL,
* LDVL, VR, LDVR, S, DIF, MM, M, WORK, LWORK,
@@ -33,11 +33,11 @@
* $ VL( LDVL, * ), VR( LDVR, * ), WORK( * )
* ..
*
-* Purpose
-* =======
*
-*>\details \b Purpose:
-*>\verbatim
+*> \par Purpose:
+* =============
+*>
+*> \verbatim
*>
*> STGSNA estimates reciprocal condition numbers for specified
*> eigenvalues and/or eigenvectors of a matrix pair (A, B) in
@@ -49,11 +49,10 @@
*> i.e. A is block upper triangular with 1-by-1 and 2-by-2 diagonal
*> blocks. B is upper triangular.
*>
-*>
-*>\endverbatim
+*> \endverbatim
*
-* Arguments
-* =========
+* Arguments:
+* ==========
*
*> \param[in] JOB
*> \verbatim
@@ -222,10 +221,9 @@
*> =0: Successful exit
*> <0: If INFO = -i, the i-th argument had an illegal value
*> \endverbatim
-*>
*
-* Authors
-* =======
+* Authors:
+* ========
*
*> \author Univ. of Tennessee
*> \author Univ. of California Berkeley
@@ -236,10 +234,9 @@
*
*> \ingroup realOTHERcomputational
*
-*
-* Further Details
-* ===============
-*>\details \b Further \b Details
+*> \par Further Details:
+* =====================
+*>
*> \verbatim
*>
*> The reciprocal of the condition number of a generalized eigenvalue
@@ -345,13 +342,18 @@
*> EPS * norm(A, B) / DIF(i).
*>
*> See ref. [2-3] for more details and further references.
+*> \endverbatim
+*
+*> \par Contributors:
+* ==================
*>
-*> Based on contributions by
*> Bo Kagstrom and Peter Poromaa, Department of Computing Science,
*> Umea University, S-901 87 Umea, Sweden.
+*
+*> \par References:
+* ================
*>
-*> References
-*> ==========
+*> \verbatim
*>
*> [1] B. Kagstrom; A Direct Method for Reordering Eigenvalues in the
*> Generalized Real Schur Form of a Regular Matrix Pair (A, B), in
@@ -372,7 +374,6 @@
*> Sweden, December 1993, Revised April 1994, Also as LAPACK Working
*> Note 75. To appear in ACM Trans. on Math. Software, Vol 22,
*> No 1, 1996.
-*>
*> \endverbatim
*>
* =====================================================================