Subject: dgeev and dgesvd arguments and return values
From: Robert Dodier
Date: Mon, 22 Oct 2007 08:41:42 -0600
On 10/22/07, Raymond Toy (RT/EUS) <raymond.toy at ericsson.com> wrote:
> I'll make the change shortly. I have also been lazy with documentation
> since I was hoping someone could propose something better than the
> underlying LAPACK names. But perhaps that's the right name. It makes
> it easier for someone to find things, if they're already familiar with
> LAPACK. (Harder, if you're not. You probably couldn't figure out dgeev
> produces eigenvalues/vectors. You could probably find dgesvd for SVD.)
I'm guessing that most Maxima users who want to use the lapack
functions will be aware of LAPACK but not familiar with each function.
I think names like lapack_general_eigenvalues and lapack_general_svd
would be OK. (Or maybe lapack_eigenvalues, lapack_svd.)
About helping users find the functions if the names are unchanged,
we can throw @fnindex FOO into the Texinfo; then ?? FOO would find it.
Also I am working on a documentation category system which
will be ready RSN.
FWIW
Robert Dodier