diff options
author | julie <julielangou@users.noreply.github.com> | 2011-11-03 20:32:56 +0000 |
---|---|---|
committer | julie <julielangou@users.noreply.github.com> | 2011-11-03 20:32:56 +0000 |
commit | 1c3ba600671a59785b0c647d400226b4cc19a11f (patch) | |
tree | 2af647fcff119db522016721e10b5ee7768d22bb /SRC/ctgsen.f | |
parent | d5c30c90bdecf38da1064e2ed52583634573e741 (diff) | |
download | lapack-1c3ba600671a59785b0c647d400226b4cc19a11f.tar.gz lapack-1c3ba600671a59785b0c647d400226b4cc19a11f.tar.bz2 lapack-1c3ba600671a59785b0c647d400226b4cc19a11f.zip |
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/ctgsen.f')
-rw-r--r-- | SRC/ctgsen.f | 48 |
1 files changed, 23 insertions, 25 deletions
diff --git a/SRC/ctgsen.f b/SRC/ctgsen.f index b9a17569..491f6b49 100644 --- a/SRC/ctgsen.f +++ b/SRC/ctgsen.f @@ -15,8 +15,8 @@ *> [TXT]</a> *> \endhtmlonly * -* Definition -* ========== +* Definition: +* =========== * * SUBROUTINE CTGSEN( IJOB, WANTQ, WANTZ, SELECT, N, A, LDA, B, LDB, * ALPHA, BETA, Q, LDQ, Z, LDZ, M, PL, PR, DIF, @@ -36,11 +36,11 @@ * $ BETA( * ), Q( LDQ, * ), WORK( * ), Z( LDZ, * ) * .. * -* Purpose -* ======= * -*>\details \b Purpose: -*>\verbatim +*> \par Purpose: +* ============= +*> +*> \verbatim *> *> CTGSEN reorders the generalized Schur decomposition of a complex *> matrix pair (A, B) (in terms of an unitary equivalence trans- @@ -65,11 +65,10 @@ *> and norms of "projections" onto left and right eigenspaces w.r.t. *> the selected cluster in the (1,1)-block. *> -*> -*>\endverbatim +*> \endverbatim * -* Arguments -* ========= +* Arguments: +* ========== * *> \param[in] IJOB *> \verbatim @@ -282,10 +281,9 @@ *> (A, B) may have been partially reordered. *> If requested, 0 is returned in DIF(*), PL and PR. *> \endverbatim -*> * -* Authors -* ======= +* Authors: +* ======== * *> \author Univ. of Tennessee *> \author Univ. of California Berkeley @@ -296,10 +294,9 @@ * *> \ingroup complexOTHERcomputational * -* -* Further Details -* =============== -*>\details \b Further \b Details +*> \par Further Details: +* ===================== +*> *> \verbatim *> *> CTGSEN first collects the selected eigenvalues by computing unitary @@ -400,26 +397,29 @@ *> based estimate DIF is not wanted (see CLATDF), then the parameter *> IDIFJB (see below) should be changed from 3 to 4 (routine CLATDF *> (IJOB = 2 will be used)). See CTGSYL for more details. +*> \endverbatim +* +*> \par Contributors: +* ================== *> -*> Based on contributions by *> Bo Kagstrom and Peter Poromaa, Department of Computing Science, *> Umea University, S-901 87 Umea, Sweden. -*> -*> References -*> ========== +* +*> \par References: +* ================ *> *> [1] B. Kagstrom; A Direct Method for Reordering Eigenvalues in the *> Generalized Real Schur Form of a Regular Matrix Pair (A, B), in *> M.S. Moonen et al (eds), Linear Algebra for Large Scale and *> Real-Time Applications, Kluwer Academic Publ. 1993, pp 195-218. -*> +*> \n *> [2] B. Kagstrom and P. Poromaa; Computing Eigenspaces with Specified *> Eigenvalues of a Regular Matrix Pair (A, B) and Condition *> Estimation: Theory, Algorithms and Software, Report *> UMINF - 94.04, Department of Computing Science, Umea University, *> S-901 87 Umea, Sweden, 1994. Also as LAPACK Working Note 87. *> To appear in Numerical Algorithms, 1996. -*> +*> \n *> [3] B. Kagstrom and P. Poromaa, LAPACK-Style Algorithms and Software *> for Solving the Generalized Sylvester Equation and Estimating the *> Separation between Regular Matrix Pairs, Report UMINF - 93.23, @@ -428,8 +428,6 @@ *> Note 75. To appear in ACM Trans. on Math. Software, Vol 22, No 1, *> 1996. *> -*> \endverbatim -*> * ===================================================================== SUBROUTINE CTGSEN( IJOB, WANTQ, WANTZ, SELECT, N, A, LDA, B, LDB, $ ALPHA, BETA, Q, LDQ, Z, LDZ, M, PL, PR, DIF, |