[vsipl++] [patch] Document QR Decomposition

[Stefan Seefeld]

Jules Bergmann wrote:
> Don McCoy wrote:

> 4.5.1.3
> 
> - 'qrd' should be in <code></code>

not <type>qrd</type> ?


> 4.5.1.5
> 
> - Change to "The following fucntions are available only if the /qrd 
> template class is parameterized with the ReturnMechanismType = by_value/"
> 
> Start a new paragraph before the following lines that precede the 4 tables:
>  "For qstorage() == qrd_saveq1",
>  "For qstorage() == qrd_saveq",
> 
> What are the tables showing exactly?  I.e. how should I interpret 
> "Qm,rows(),s"?   "Qm" is the product computed, and "rows(),s" are its size?
> 
> It would help if the tables had captions.

I believe the missing captions are the result of the bug I identified 
recently in our stylesheets, where formal.object.heading is made a noop 
because of issues in some other contexts.


> 
> Final senctence: "Note that the return matrix may have a different block 
> type from Block"

We never explain what 'Blocks' are, and in fact, avoid even mentioning 
blocks throughout the rest of the manual for that reason. I typically 
just mark the return type with 'unspecified' for such cases, for this 
reason.

Thanks,
		Stefan

-- 
Stefan Seefeld
CodeSourcery
stefan at codesourcery.com
(650) 331-3385 x718