Ctensor.texi parenthesis adjust



Actually, the closing parenthesis should be after the word 'cmetric'. The
parenthetical remark explains that lg is computed automatically (from the
frame base) when the cmetric() function is called. This step may then
followed by computing ug, which is not computed automatically by cmetric()
when cframe_flag is true.

Years ago, when I spent a lot of time working on the tensor packages, I
updated much (but not all) of the Ctensor/Itensor documentation. At the
time, my goal was simply to make sure that there are no obvious gross
mistakes in the documentation and that all features are described, however
briefly. I also created several tensor examples. I've been meaning to
incorporate these examples into the documentation in some tutorial form. The
difficulty is the usual one: only 24 hours in a day, only 7 days in a
week... Still, I swear I'll do it one of these days :-)


Viktor


-----Original Message-----
From: maxima-bounces at math.utexas.edu [mailto:maxima-bounces at math.utexas.edu]
On Behalf Of Leo Butler
Sent: Sunday, September 29, 2013 10:38 AM
To: Jorge Barros de Abreu
Cc: maxima at math.utexas.edu
Subject: Re: [Maxima] Ctensor.texi parenthesis adjust

>   Date: Sun, 29 Sep 2013 06:23:15 -0300
>   From: Jorge Barros de Abreu <ficmatin10 at gmail.com>
>
>   Hi.
>
>   in Ctensor.texi there is:
>
>   Therefore, a meaningful computation sequence may begin with a frame
>   base, which is then used to compute lg (computed automatically by
cmetric
>   and
>   then ug.
>
>   It is not obvious for me if the better is
>
>   Therefore, a meaningful computation sequence may begin with a frame
>   base, which is then used to compute lg (computed automatically by
cmetric)
>   and
>   then ug.

I believe that the documentation in Ctensor.texi could use a serious
overhaul. The paragraph from which this sentence came is really
unhelpful, and would be better replaced by an example showing what the
author intends. Similarly, the documentation of frame_bracket is
unhelpful, with no example(s) so a user can't turn there to get help,
either.

FWIW, I believe that the parenthetical comment is correctly delimited,
but it should be at the end of the sentence, because it is ug that is
computed by cmetric.

Leo
_______________________________________________
Maxima mailing list
Maxima at math.utexas.edu
http://www.math.utexas.edu/mailman/listinfo/maxima