Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r63174 - in sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack: . auxiliary computational driver
From: thomas.klimpel_at_[hidden]
Date: 2010-06-20 17:16:14


Author: klimpel
Date: 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
New Revision: 63174
URL: http://svn.boost.org/trac/boost/changeset/63174

Log:
regenerated regenerated .qbk (=quickbook) files:
- improved classification of the auxiliary routines of lapack
- sections for "Driver Routines", "Computational Routines" and "Auxiliary Routines" in the Reference documentation for lapack
Added:
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/labrd.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/labrd.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacgv.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lacgv.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacon.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/lacon.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/laebz.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/laebz.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lalsd.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lalsd.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/larz.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/larz.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrd.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrd.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrs.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrs.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrz.qbk
      - copied, changed from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrz.qbk
Removed:
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/labrd.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/lacon.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/laebz.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/larz.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrd.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrs.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrz.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lacgv.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lalsd.qbk
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/largv.qbk
Text files modified:
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary.qbk | 13 +++++++++++++
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/labrd.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacgv.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacon.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/laebz.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lalsd.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/larz.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrd.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrs.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrz.qbk | 2 +-
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational.qbk | 10 +++-------
   sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver.qbk | 6 +++---
   12 files changed, 28 insertions(+), 19 deletions(-)

Modified: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -4,6 +4,8 @@
 
 ]
 
+[section Auxiliary Routines]
+
 [include auxiliary/larf.qbk]
 [include auxiliary/larfb.qbk]
 [include auxiliary/larfg.qbk]
@@ -25,5 +27,16 @@
 [include auxiliary/lantb.qbk]
 [include auxiliary/lantp.qbk]
 [include auxiliary/lantr.qbk]
+[include auxiliary/labrd.qbk]
+[include auxiliary/lacgv.qbk]
+[include auxiliary/lacon.qbk]
+[include auxiliary/laebz.qbk]
+[include auxiliary/lalsd.qbk]
+[include auxiliary/largv.qbk]
+[include auxiliary/larz.qbk]
+[include auxiliary/latrd.qbk]
+[include auxiliary/latrs.qbk]
+[include auxiliary/latrz.qbk]
 
 
+[endsect]

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/labrd.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/labrd.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/labrd.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/labrd.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -16,7 +16,7 @@
 
 [heading Description]
 
-`labrd` (short for $FRIENDLY_NAME) provides a C++
+`labrd` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines SLABRD, DLABRD, CLABRD, and ZLABRD.
 `labrd` reduces the first NB rows and columns of a complex general
 m by n matrix A to upper or lower real bidiagonal form by a unitary

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacgv.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lacgv.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lacgv.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacgv.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -16,7 +16,7 @@
 
 [heading Description]
 
-`lacgv` (short for $FRIENDLY_NAME) provides a C++
+`lacgv` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines CLACGV and ZLACGV.
 `lacgv` conjugates a complex vector of length N.
 

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacon.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/lacon.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/lacon.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lacon.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -16,7 +16,7 @@
 
 [heading Description]
 
-`lacon` (short for $FRIENDLY_NAME) provides a C++
+`lacon` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines SLACON, DLACON, CLACON, and ZLACON.
 `lacon` estimates the 1-norm of a square, complex matrix A.
 Reverse communication is used for evaluating matrix-vector products.

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/laebz.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/laebz.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/laebz.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/laebz.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -20,7 +20,7 @@
 
 [heading Description]
 
-`laebz` (short for $FRIENDLY_NAME) provides a C++
+`laebz` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines SLAEBZ and DLAEBZ.
 `laebz` contains the iteration loops which compute and use the
 function N(w), which is the count of eigenvalues of a symmetric

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lalsd.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lalsd.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lalsd.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/lalsd.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -17,7 +17,7 @@
 
 [heading Description]
 
-`lalsd` (short for $FRIENDLY_NAME) provides a C++
+`lalsd` (short for LAPACK auxiliary routine, linear least squares, using d&c SVD) provides a C++
 interface to LAPACK routines SLALSD, DLALSD, CLALSD, and ZLALSD.
 `lalsd` uses the singular value decomposition of A to solve the least
 squares problem of finding X to minimize the Euclidean norm of each

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/larz.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/larz.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/larz.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/larz.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -21,7 +21,7 @@
 
 [heading Description]
 
-`larz` (short for $FRIENDLY_NAME) provides a C++
+`larz` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines SLARZ, DLARZ, CLARZ, and ZLARZ.
 `larz` applies a complex elementary reflector H to a complex
 M-by-N matrix C, from either the left or the right. H is represented

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrd.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrd.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrd.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrd.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -16,7 +16,7 @@
 
 [heading Description]
 
-`latrd` (short for $FRIENDLY_NAME) provides a C++
+`latrd` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines SLATRD, DLATRD, CLATRD, and ZLATRD.
 `latrd` reduces NB rows and columns of a complex Hermitian matrix A to
 Hermitian tridiagonal form by a unitary similarity

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrs.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrs.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrs.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrs.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -16,7 +16,7 @@
 
 [heading Description]
 
-`latrs` (short for $FRIENDLY_NAME) provides a C++
+`latrs` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines SLATRS, DLATRS, CLATRS, and ZLATRS.
 `latrs` solves one of the triangular systems
 

Copied: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrz.qbk (from r63171, /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrz.qbk)
==============================================================================
--- /sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrz.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/auxiliary/latrz.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -15,7 +15,7 @@
 
 [heading Description]
 
-`latrz` (short for $FRIENDLY_NAME) provides a C++
+`latrz` (short for LAPACK auxiliary routine, TODO) provides a C++
 interface to LAPACK routines SLATRZ, DLATRZ, CLATRZ, and ZLATRZ.
 `latrz` factors the M-by-(M+L) complex upper trapezoidal matrix
 [ A1 A2 ] = [ A(1:M,1:M) A(1:M,N-L+1:N) ] as ( R 0 ) * Z by means

Modified: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -4,6 +4,8 @@
 
 ]
 
+[section Computational Routines]
+
 [include computational/hbgst.qbk]
 [include computational/hegst.qbk]
 [include computational/pbstf.qbk]
@@ -16,8 +18,6 @@
 [include computational/geqp3.qbk]
 [include computational/geqrf.qbk]
 [include computational/gerqf.qbk]
-[include computational/larz.qbk]
-[include computational/latrz.qbk]
 [include computational/orglq.qbk]
 [include computational/orgql.qbk]
 [include computational/orgqr.qbk]
@@ -41,7 +41,6 @@
 [include computational/bdsqr.qbk]
 [include computational/gbbrd.qbk]
 [include computational/gebrd.qbk]
-[include computational/labrd.qbk]
 [include computational/orgbr.qbk]
 [include computational/ormbr.qbk]
 [include computational/ungbr.qbk]
@@ -83,8 +82,6 @@
 [include computational/hptrf.qbk]
 [include computational/hptri.qbk]
 [include computational/hptrs.qbk]
-[include computational/lacon.qbk]
-[include computational/latrs.qbk]
 [include computational/pbcon.qbk]
 [include computational/pbequ.qbk]
 [include computational/pbrfs.qbk]
@@ -131,8 +128,6 @@
 [include computational/hbtrd.qbk]
 [include computational/hetrd.qbk]
 [include computational/hptrd.qbk]
-[include computational/laebz.qbk]
-[include computational/latrd.qbk]
 [include computational/opgtr.qbk]
 [include computational/opmtr.qbk]
 [include computational/orgtr.qbk]
@@ -165,3 +160,4 @@
 [include computational/tgsja.qbk]
 
 
+[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/labrd.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/labrd.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,92 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section labrd]
-
-[heading Prototype]
-There is one prototype of `labrd` available, please see below.
-``
-labrd( MatrixA& a, VectorD& d, VectorE& e, VectorTAUQ& tauq,
- VectorTAUP& taup, MatrixX& x, MatrixY& y );
-``
-
-
-[heading Description]
-
-`labrd` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLABRD, DLABRD, CLABRD, and ZLABRD.
-`labrd` reduces the first NB rows and columns of a complex general
-m by n matrix A to upper or lower real bidiagonal form by a unitary
-transformation Q' * A * P, and returns the matrices X and Y which
-are needed to apply the transformation to the unreduced part of A.
-
-If m >= n, A is reduced to upper bidiagonal form; if m < n, to lower
-bidiagonal form.
-
-This is an auxiliary routine called by ZGEBRD
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `MatrixA`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<MatrixA>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of labrd
-[ [ Value type of MatrixA ] [LAPACK routine] ]
-[ [`float`][SLABRD] ]
-[ [`double`][DLABRD] ]
-[ [`complex<float>`][CLABRD] ]
-[ [`complex<double>`][ZLABRD] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/computational/labrd.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/computational/labrd.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::labrd( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slabrd.f.html slabrd.f], [@http://www.netlib.org/lapack/explore-html/dlabrd.f.html dlabrd.f], [@http://www.netlib.org/lapack/explore-html/clabrd.f.html clabrd.f], and [@http://www.netlib.org/lapack/explore-html/zlabrd.f.html zlabrd.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/lacon.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/lacon.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,85 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section lacon]
-
-[heading Prototype]
-There is one prototype of `lacon` available, please see below.
-``
-lacon( const int_t n, VectorX& x, Scalar >,
- int_t& kase );
-``
-
-
-[heading Description]
-
-`lacon` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLACON, DLACON, CLACON, and ZLACON.
-`lacon` estimates the 1-norm of a square, complex matrix A.
-Reverse communication is used for evaluating matrix-vector products.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `VectorX`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<VectorX>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of lacon
-[ [ Value type of VectorX ] [LAPACK routine] ]
-[ [`float`][SLACON] ]
-[ [`double`][DLACON] ]
-[ [`complex<float>`][CLACON] ]
-[ [`complex<double>`][ZLACON] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/computational/lacon.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/computational/lacon.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::lacon( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slacon.f.html slacon.f], [@http://www.netlib.org/lapack/explore-html/dlacon.f.html dlacon.f], [@http://www.netlib.org/lapack/explore-html/clacon.f.html clacon.f], and [@http://www.netlib.org/lapack/explore-html/zlacon.f.html zlacon.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/laebz.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/laebz.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,122 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section laebz]
-
-[heading Prototype]
-There is one prototype of `laebz` available, please see below.
-``
-laebz( const int_t ijob, const int_t nitmax,
- const int_t n, const int_t minp,
- const int_t nbmin, const Scalar >, const Scalar >,
- const Scalar >, const VectorD& d, const VectorE& e,
- const VectorE2& e2, VectorNVAL& nval, MatrixAB& ab, VectorC& c,
- int_t& mout, MatrixNAB& nab );
-``
-
-
-[heading Description]
-
-`laebz` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLAEBZ and DLAEBZ.
-`laebz` contains the iteration loops which compute and use the
-function N(w), which is the count of eigenvalues of a symmetric
-tridiagonal matrix T less than or equal to its argument w. It
-performs a choice of two types of loops:
-
-IJOB=1, followed by
-IJOB=2: It takes as input a list of intervals and returns a list of
-sufficiently small intervals whose union contains the same
-eigenvalues as the union of the original intervals.
-The input intervals are (AB(j,1),AB(j,2)], j=1,...,MINP.
-The output interval (AB(j,1),AB(j,2)] will contain
-eigenvalues NAB(j,1)+1,...,NAB(j,2), where 1 <= j <= MOUT.
-
-IJOB=3: It performs a binary search in each input interval
-(AB(j,1),AB(j,2)] for a point w(j) such that
-N(w(j))=NVAL(j), and uses C(j) as the starting point of
-the search. If such a w(j) is found, then on output
-AB(j,1)=AB(j,2)=w. If no such w(j) is found, then on output
-(AB(j,1),AB(j,2)] will be a small interval containing the
-point where N(w) jumps through NVAL(j), unless that point
-lies outside the initial interval.
-
-Note that the intervals are in all cases half-open intervals,
-i.e., of the form (a,b] , which includes b but not a .
-
-To avoid underflow, the matrix should be scaled so that its largest
-element is no greater than overflow**(1/2) * underflow**(1/4)
-in absolute value. To assure the most accurate computation
-of small eigenvalues, the matrix should be scaled to be
-not much smaller than that, either.
-
-See W. Kahan "Accurate Eigenvalues of a Symmetric Tridiagonal
-Matrix", Report CS41, Computer Science Dept., Stanford
-University, July 21, 1966
-
-Note: the arguments are, in general, *not* checked for unreasonable
-values.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `VectorD`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<VectorD>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of laebz
-[ [ Value type of VectorD ] [LAPACK routine] ]
-[ [`float`][SLAEBZ] ]
-[ [`double`][DLAEBZ] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/computational/laebz.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/computational/laebz.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::laebz( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slaebz.f.html slaebz.f] and [@http://www.netlib.org/lapack/explore-html/dlaebz.f.html dlaebz.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/larz.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/larz.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,102 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section larz]
-
-[heading Prototype]
-There are two prototypes of `larz` available, please see below.
-``
-larz( const Side side, const int_t l, const VectorViewV& v,
- const Scalar >, MatrixC& c );
-``
-
-``
-larz( const Side side, const int_t l, const VectorViewV& v,
- const Scalar tau, MatrixC& c );
-``
-
-
-[heading Description]
-
-`larz` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLARZ, DLARZ, CLARZ, and ZLARZ.
-`larz` applies a complex elementary reflector H to a complex
-M-by-N matrix C, from either the left or the right. H is represented
-in the form
-
-H = I - tau * v * v'
-
-where tau is a complex scalar and v is a complex vector.
-
-If tau = 0, then H is taken to be the unit matrix.
-
-To apply H' (the conjugate transpose of H), supply conjg(tau) instead
-tau.
-
-H is a product of k elementary reflectors as returned by ZTZRZF.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `VectorViewV`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<VectorViewV>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of larz
-[ [ Value type of VectorViewV ] [LAPACK routine] ]
-[ [`float`][SLARZ] ]
-[ [`double`][DLARZ] ]
-[ [`complex<float>`][CLARZ] ]
-[ [`complex<double>`][ZLARZ] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/computational/larz.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/computational/larz.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::larz( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slarz.f.html slarz.f], [@http://www.netlib.org/lapack/explore-html/dlarz.f.html dlarz.f], [@http://www.netlib.org/lapack/explore-html/clarz.f.html clarz.f], and [@http://www.netlib.org/lapack/explore-html/zlarz.f.html zlarz.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrd.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrd.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,94 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section latrd]
-
-[heading Prototype]
-There is one prototype of `latrd` available, please see below.
-``
-latrd( const int_t nb, MatrixA& a, VectorE& e,
- VectorTAU& tau, MatrixW& w );
-``
-
-
-[heading Description]
-
-`latrd` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLATRD, DLATRD, CLATRD, and ZLATRD.
-`latrd` reduces NB rows and columns of a complex Hermitian matrix A to
-Hermitian tridiagonal form by a unitary similarity
-transformation Q' * A * Q, and returns the matrices V and W which are
-needed to apply the transformation to the unreduced part of A.
-
-If UPLO = 'U', `latrd` reduces the last NB rows and columns of a
-matrix, of which the upper triangle is supplied;
-if UPLO = 'L', `latrd` reduces the first NB rows and columns of a
-matrix, of which the lower triangle is supplied.
-
-This is an auxiliary routine called by ZHETRD.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `MatrixA`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<MatrixA>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of latrd
-[ [ Value type of MatrixA ] [LAPACK routine] ]
-[ [`float`][SLATRD] ]
-[ [`double`][DLATRD] ]
-[ [`complex<float>`][CLATRD] ]
-[ [`complex<double>`][ZLATRD] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/computational/latrd.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/computational/latrd.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::latrd( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slatrd.f.html slatrd.f], [@http://www.netlib.org/lapack/explore-html/dlatrd.f.html dlatrd.f], [@http://www.netlib.org/lapack/explore-html/clatrd.f.html clatrd.f], and [@http://www.netlib.org/lapack/explore-html/zlatrd.f.html zlatrd.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrs.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrs.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,95 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section latrs]
-
-[heading Prototype]
-There is one prototype of `latrs` available, please see below.
-``
-latrs( const char uplo, const char normin, const MatrixA& a, VectorX& x,
- Scalar >, VectorCNORM& cnorm );
-``
-
-
-[heading Description]
-
-`latrs` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLATRS, DLATRS, CLATRS, and ZLATRS.
-`latrs` solves one of the triangular systems
-
-A * x = s*b, A**T * x = s*b, or A**H * x = s*b,
-
-with scaling to prevent overflow. Here A is an upper or lower
-triangular matrix, A**T denotes the transpose of A, A**H denotes the
-conjugate transpose of A, x and b are n-element vectors, and s is a
-scaling factor, usually less than or equal to 1, chosen so that the
-components of x will be less than the overflow threshold. If the
-unscaled problem will not cause overflow, the Level 2 BLAS routine
-ZTRSV is called. If the matrix A is singular (A(j,j) = 0 for some j),
-then s is set to 0 and a non-trivial solution to A*x = 0 is returned.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `MatrixA`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<MatrixA>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of latrs
-[ [ Value type of MatrixA ] [LAPACK routine] ]
-[ [`float`][SLATRS] ]
-[ [`double`][DLATRS] ]
-[ [`complex<float>`][CLATRS] ]
-[ [`complex<double>`][ZLATRS] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/computational/latrs.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/computational/latrs.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::latrs( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slatrs.f.html slatrs.f], [@http://www.netlib.org/lapack/explore-html/dlatrs.f.html dlatrs.f], [@http://www.netlib.org/lapack/explore-html/clatrs.f.html clatrs.f], and [@http://www.netlib.org/lapack/explore-html/zlatrs.f.html zlatrs.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrz.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/computational/latrz.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,86 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section latrz]
-
-[heading Prototype]
-There is one prototype of `latrz` available, please see below.
-``
-latrz( MatrixA& a, VectorTAU& tau );
-``
-
-
-[heading Description]
-
-`latrz` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLATRZ, DLATRZ, CLATRZ, and ZLATRZ.
-`latrz` factors the M-by-(M+L) complex upper trapezoidal matrix
-[ A1 A2 ] = [ A(1:M,1:M) A(1:M,N-L+1:N) ] as ( R 0 ) * Z by means
-of unitary transformations, where Z is an (M+L)-by-(M+L) unitary
-matrix and, R and A1 are M-by-M upper triangular matrices.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `MatrixA`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<MatrixA>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of latrz
-[ [ Value type of MatrixA ] [LAPACK routine] ]
-[ [`float`][SLATRZ] ]
-[ [`double`][DLATRZ] ]
-[ [`complex<float>`][CLATRZ] ]
-[ [`complex<double>`][ZLATRZ] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/computational/latrz.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/computational/latrz.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::latrz( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slatrz.f.html slatrz.f], [@http://www.netlib.org/lapack/explore-html/dlatrz.f.html dlatrz.f], [@http://www.netlib.org/lapack/explore-html/clatrz.f.html clatrz.f], and [@http://www.netlib.org/lapack/explore-html/zlatrz.f.html zlatrz.f] at Netlib.
-
-[endsect]

Modified: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver.qbk (original)
+++ sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
@@ -4,6 +4,8 @@
 
 ]
 
+[section Driver Routines]
+
 [include driver/gegv.qbk]
 [include driver/gges.qbk]
 [include driver/ggesx.qbk]
@@ -19,8 +21,6 @@
 [include driver/hpgv.qbk]
 [include driver/hpgvd.qbk]
 [include driver/hpgvx.qbk]
-[include driver/lacgv.qbk]
-[include driver/largv.qbk]
 [include driver/sbgv.qbk]
 [include driver/sbgvd.qbk]
 [include driver/sbgvx.qbk]
@@ -91,6 +91,6 @@
 [include driver/gelsd.qbk]
 [include driver/gelss.qbk]
 [include driver/gelsy.qbk]
-[include driver/lalsd.qbk]
 
 
+[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lacgv.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lacgv.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,82 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section lacgv]
-
-[heading Prototype]
-There is one prototype of `lacgv` available, please see below.
-``
-lacgv( const int_t n, VectorX& x,
- const int_t incx );
-``
-
-
-[heading Description]
-
-`lacgv` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines CLACGV and ZLACGV.
-`lacgv` conjugates a complex vector of length N.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `VectorX`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<VectorX>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of lacgv
-[ [ Value type of VectorX ] [LAPACK routine] ]
-[ [`complex<float>`][CLACGV] ]
-[ [`complex<double>`][ZLACGV] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/driver/lacgv.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/driver/lacgv.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::lacgv( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/clacgv.f.html clacgv.f] and [@http://www.netlib.org/lapack/explore-html/zlacgv.f.html zlacgv.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lalsd.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/lalsd.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,100 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section lalsd]
-
-[heading Prototype]
-There is one prototype of `lalsd` available, please see below.
-``
-lalsd( const char uplo, const int_t smlsiz,
- const int_t n, VectorD& d, VectorE& e, MatrixB& b,
- const Scalar >, int_t& rank );
-``
-
-
-[heading Description]
-
-`lalsd` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLALSD, DLALSD, CLALSD, and ZLALSD.
-`lalsd` uses the singular value decomposition of A to solve the least
-squares problem of finding X to minimize the Euclidean norm of each
-column of A*X-B, where A is N-by-N upper bidiagonal, and X and B
-are N-by-NRHS. The solution X overwrites B.
-
-The singular values of A smaller than RCOND times the largest
-singular value are treated as zero in solving the least squares
-problem; in this case a minimum norm solution is returned.
-The actual singular values are returned in D in ascending order.
-
-This code makes very mild assumptions about floating point
-arithmetic. It will work on machines with a guard digit in
-add/subtract, or on those binary machines without guard digits
-which subtract like the Cray XMP, Cray YMP, Cray C 90, or Cray 2.
-It could conceivably fail on hexadecimal or decimal machines
-without guard digits, but we know of none.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `VectorD`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<VectorD>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of lalsd
-[ [ Value type of VectorD ] [LAPACK routine] ]
-[ [`float`][SLALSD] ]
-[ [`double`][DLALSD] ]
-[ [`complex<float>`][CLALSD] ]
-[ [`complex<double>`][ZLALSD] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/driver/lalsd.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/driver/lalsd.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::lalsd( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slalsd.f.html slalsd.f], [@http://www.netlib.org/lapack/explore-html/dlalsd.f.html dlalsd.f], [@http://www.netlib.org/lapack/explore-html/clalsd.f.html clalsd.f], and [@http://www.netlib.org/lapack/explore-html/zlalsd.f.html zlalsd.f] at Netlib.
-
-[endsect]

Deleted: sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/largv.qbk
==============================================================================
--- sandbox/numeric_bindings/libs/numeric/bindings/doc/lapack/driver/largv.qbk 2010-06-20 17:16:10 EDT (Sun, 20 Jun 2010)
+++ (empty file)
@@ -1,96 +0,0 @@
-[/
-
-THIS FILE IS AUTOMATICALLY GENERATED, PLEASE DO NOT EDIT!
-
-]
-
-[section largv]
-
-[heading Prototype]
-There is one prototype of `largv` available, please see below.
-``
-largv( const int_t n, VectorViewX& x, VectorViewY& y,
- VectorViewC& c );
-``
-
-
-[heading Description]
-
-`largv` (short for $FRIENDLY_NAME) provides a C++
-interface to LAPACK routines SLARGV, DLARGV, CLARGV, and ZLARGV.
-`largv` generates a vector of complex plane rotations with real
-cosines, determined by elements of the complex vectors x and y.
-For i = 1,2,...,n
-
-( c(i) s(i) ) ( x(i) ) = ( r(i) )
-( -conjg(s(i)) c(i) ) ( y(i) ) = ( 0 )
-
-where c(i)**2 + ABS(s(i))**2 = 1
-
-The following conventions are used (these are the same as in ZLARTG,
-but differ from the BLAS1 routine ZROTG):
-If y(i)=0, then c(i)=1 and s(i)=0.
-If x(i)=0, then c(i)=0 and s(i) is chosen so that r(i) is real.
-
-The selection of the LAPACK routine is done during compile-time,
-and is determined by the type of values contained in type `VectorViewX`.
-The type of values is obtained through the `value_type` meta-function
- `typename value_type<VectorViewX>::type`.
-The dispatching table below illustrates to which specific routine
-the code path will be generated.
-
-[table Dispatching of largv
-[ [ Value type of VectorViewX ] [LAPACK routine] ]
-[ [`float`][SLARGV] ]
-[ [`double`][DLARGV] ]
-[ [`complex<float>`][CLARGV] ]
-[ [`complex<double>`][ZLARGV] ]
-
-]
-
-
-[heading Definition]
-Defined in header [headerref boost/numeric/bindings/lapack/driver/largv.hpp].
-
-
-[heading Parameters or Requirements on Types]
-
-[variablelist Parameters
- [[MatrixA] [The definition of term 1]]
- [[MatrixB] [The definition of term 2]]
- [[MatrixC] [
- The definition of term 3.
-
- Definitions may contain paragraphs.
- ]]
-]
-
-
-[heading Complexity]
-
-
-[heading Example]
-``
-#include <boost/numeric/bindings/lapack/driver/largv.hpp>
-using namespace boost::numeric::bindings;
-
-lapack::largv( x, y, z );
-
-``
-
-this will output
-
-``
-[5] 0 1 2 3 4 5
-``
-
-
-
-[heading Notes]
-
-
-[heading See Also]
-
-* Originating Fortran source files [@http://www.netlib.org/lapack/explore-html/slargv.f.html slargv.f], [@http://www.netlib.org/lapack/explore-html/dlargv.f.html dlargv.f], [@http://www.netlib.org/lapack/explore-html/clargv.f.html clargv.f], and [@http://www.netlib.org/lapack/explore-html/zlargv.f.html zlargv.f] at Netlib.
-
-[endsect]


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk