[Emacs-diffs] emacs/doc/misc calc.texi

[Jay Belanger]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Jay Belanger <jpb>      09/07/30 04:37:52

Modified files:
        doc/misc       : calc.texi 

Log message:
        (Vector/Matrix Functions): Add index entries for both "v" and "V" key
        bindings.  Mention that `calc-matrix-brackets' only affects matrices
        with more than one row.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/calc.texi?cvsroot=emacs&r1=1.35&r2=1.36

Patches:
Index: calc.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/misc/calc.texi,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -b -r1.35 -r1.36
--- calc.texi   29 Jul 2009 03:43:52 -0000      1.35
+++ calc.texi   30 Jul 2009 04:37:51 -0000      1.36
@@ -16553,6 +16553,7 @@
 @mindex v p
 @end ignore
 @kindex v p (complex)
address@hidden V p (complex)
 @pindex calc-pack
 The @kbd{v p} (@code{calc-pack}) command can pack the top two numbers on
 the stack into a composite object such as a complex number.  With
@@ -16564,6 +16565,7 @@
 @mindex v u
 @end ignore
 @kindex v u (complex)
address@hidden V u (complex)
 @pindex calc-unpack
 The @kbd{v u} (@code{calc-unpack}) command takes the complex number
 (or other composite object) on the top of the stack and unpacks it
@@ -19365,6 +19367,7 @@
 vectors.
 
 @kindex v p
address@hidden V p
 @pindex calc-pack
 The @kbd{v p} (@code{calc-pack}) address@hidden command collects several
 elements from the stack into a matrix, complex number, HMS form, error
@@ -19497,6 +19500,7 @@
 by the mode.
 
 @kindex v u
address@hidden V u
 @pindex calc-unpack
 The @kbd{v u} (@code{calc-unpack}) command takes the vector, complex
 number, HMS form, or other composite object on the top of the stack and
@@ -19614,6 +19618,7 @@
 to @address@hidden |}, but possibly more convenient and also a bit faster.
 
 @kindex v d
address@hidden V d
 @pindex calc-diag
 @tindex diag
 The @kbd{v d} (@code{calc-diag}) address@hidden function builds a diagonal
@@ -19632,6 +19637,7 @@
 alternative would be to use @kbd{v b} and @kbd{v a}; see below.)
 
 @kindex v i
address@hidden V i
 @pindex calc-ident
 @tindex idn
 The @kbd{v i} (@code{calc-ident}) address@hidden function builds an identity
@@ -19652,6 +19658,7 @@
 dimensions.
 
 @kindex v x
address@hidden V x
 @pindex calc-index
 @tindex index
 The @kbd{v x} (@code{calc-index}) address@hidden function builds a vector
@@ -19676,6 +19683,7 @@
 is one for positive @var{n} or two for negative @var{n}.
 
 @kindex v b
address@hidden V b
 @pindex calc-build-vector
 @tindex cvec
 The @kbd{v b} (@code{calc-build-vector}) address@hidden function builds a
@@ -19686,7 +19694,9 @@
 to build a matrix of copies of that row.)
 
 @kindex v h
address@hidden V h
 @kindex I v h
address@hidden I V h
 @pindex calc-head
 @pindex calc-tail
 @tindex head
@@ -19697,6 +19707,7 @@
 cases, the argument must be a non-empty vector.
 
 @kindex v k
address@hidden V k
 @pindex calc-cons
 @tindex cons
 The @kbd{v k} (@code{calc-cons}) address@hidden function takes a value @var{h}
@@ -19706,15 +19717,18 @@
 whereas @code{cons} will insert @var{h} at the front of the vector @var{t}.
 
 @kindex H v h
address@hidden H V h
 @tindex rhead
 @ignore
 @mindex @idots
 @end ignore
 @kindex H I v h
address@hidden H I V h
 @ignore
 @mindex @null
 @end ignore
 @kindex H v k
address@hidden H V k
 @ignore
 @mindex @null
 @end ignore
@@ -19736,6 +19750,7 @@
 
 @noindent
 @kindex v r
address@hidden V r
 @pindex calc-mrow
 @tindex mrow
 The @kbd{v r} (@code{calc-mrow}) address@hidden command extracts one row of
@@ -19786,6 +19801,7 @@
 function is called @code{getdiag}.
 
 @kindex v c
address@hidden V c
 @pindex calc-mcol
 @tindex mcol
 @tindex mrcol
@@ -19803,6 +19819,7 @@
 of matrix @expr{m}.
 
 @kindex v s
address@hidden V s
 @pindex calc-subvector
 @tindex subvec
 The @kbd{v s} (@code{calc-subvector}) address@hidden command extracts
@@ -19823,6 +19840,7 @@
 has this effect when used as the ending index.
 
 @kindex I v s
address@hidden I V s
 @tindex rsubvec
 With the Inverse flag, @kbd{I v s} address@hidden removes a subvector
 from a vector.  The arguments are interpreted the same as for the
@@ -19838,6 +19856,7 @@
 
 @noindent
 @kindex v l
address@hidden V l
 @pindex calc-vlength
 @tindex vlen
 The @kbd{v l} (@code{calc-vlength}) address@hidden command computes the
@@ -19846,6 +19865,7 @@
 command.
 
 @kindex H v l
address@hidden H V l
 @tindex mdims
 With the Hyperbolic flag, @kbd{H v l} address@hidden computes a vector
 of the dimensions of a vector, matrix, or higher-order object.  For
@@ -19856,6 +19876,7 @@
 matrix.
 
 @kindex v f
address@hidden V f
 @pindex calc-vector-find
 @tindex find
 The @kbd{v f} (@code{calc-vector-find}) address@hidden command searches
@@ -19866,6 +19887,7 @@
 allows you to select any starting index for the search.
 
 @kindex v a
address@hidden V a
 @pindex calc-arrange-vector
 @tindex arrange
 @cindex Arranging a matrix
@@ -19896,7 +19918,9 @@
 @samp{[1, 2, @w{3, 4}]}.
 
 @cindex Sorting data
address@hidden v S
 @kindex V S
address@hidden I v S
 @kindex I V S
 @pindex calc-sort
 @tindex sort
@@ -19919,7 +19943,9 @@
 @cindex Inverse of permutation
 @cindex Index tables
 @cindex Rank tables
address@hidden v G
 @kindex V G
address@hidden I v G
 @kindex I V G
 @pindex calc-grade
 @tindex grade
@@ -19951,6 +19977,7 @@
 phone numbers will remain sorted by name even after the second sort.
 
 @cindex Histograms
address@hidden v H
 @kindex V H
 @pindex calc-histogram
 @ignore
@@ -19968,6 +19995,7 @@
 that the counts in the result vector don't add up to the length of the
 input vector.)
 
address@hidden H v H
 @kindex H V H
 With the Hyperbolic flag, @kbd{H V H} pulls two vectors from the stack.
 The second-to-top vector is the list of numbers as before.  The top
@@ -19977,6 +20005,7 @@
 vector.  Without the hyperbolic flag, every element has a weight of one.
 
 @kindex v t
address@hidden V t
 @pindex calc-transpose
 @tindex trn
 The @kbd{v t} (@code{calc-transpose}) address@hidden command computes
@@ -19985,6 +20014,7 @@
 a one-column matrix.
 
 @kindex v v
address@hidden V v
 @pindex calc-reverse-vector
 @tindex rev
 The @kbd{v v} (@code{calc-reverse-vector}) address@hidden command reverses
@@ -19994,6 +20024,7 @@
 a matrix.)
 
 @kindex v m
address@hidden V m
 @pindex calc-mask-vector
 @tindex vmask
 The @kbd{v m} (@code{calc-mask-vector}) address@hidden command uses
@@ -20006,6 +20037,7 @@
 @xref{Logical Operations}.
 
 @kindex v e
address@hidden V e
 @pindex calc-expand-vector
 @tindex vexp
 The @kbd{v e} (@code{calc-expand-vector}) address@hidden command
@@ -20019,6 +20051,7 @@
 produces @samp{[a, 0, b, 0, 7]}.
 
 @kindex H v e
address@hidden H V e
 With the Hyperbolic flag, @kbd{H v e} takes a filler value from the
 top of the stack; the mask and target vectors come from the third and
 second elements of the stack.  This filler is used where the mask is
@@ -20051,6 +20084,7 @@
 @code{re}, @code{im}, @code{polar}, @code{rect}, @code{clean},
 @code{float}, @code{frac}.  @xref{Function Index}.
 
address@hidden v J
 @kindex V J
 @pindex calc-conj-transpose
 @tindex ctrn
@@ -20074,6 +20108,7 @@
 from that point to the origin.
 
 @kindex v n
address@hidden V n
 @pindex calc-rnorm
 @tindex rnorm
 The @kbd{v n} (@code{calc-rnorm}) address@hidden command computes the
@@ -20082,6 +20117,7 @@
 a matrix, this is the maximum of the row-absolute-value-sums, i.e., of
 the sums of the absolute values of the elements along the various rows.
 
address@hidden v N
 @kindex V N
 @pindex calc-cnorm
 @tindex cnorm
@@ -20093,6 +20129,7 @@
 not provided.  However, the 2-norm (or Frobenius norm) is provided for
 vectors by the @kbd{A} (@code{calc-abs}) command.
 
address@hidden v C
 @kindex V C
 @pindex calc-cross
 @tindex cross
@@ -20121,12 +20158,14 @@
 @samp{/} operator also does a matrix inversion when dividing one
 by a matrix.
 
address@hidden v D
 @kindex V D
 @pindex calc-mdet
 @tindex det
 The @kbd{V D} (@code{calc-mdet}) address@hidden command computes the
 determinant of a square matrix.
 
address@hidden v L
 @kindex V L
 @pindex calc-mlud
 @tindex lud
@@ -20137,6 +20176,7 @@
 algorithm, the second is lower-triangular with ones on the diagonal,
 and the third is upper-triangular.
 
address@hidden v T
 @kindex V T
 @pindex calc-mtrace
 @tindex tr
@@ -20144,6 +20184,7 @@
 trace of a square matrix.  This is defined as the sum of the diagonal
 elements of the matrix.
 
address@hidden v K
 @kindex V K
 @pindex calc-kron
 @tindex kron
@@ -20184,6 +20225,7 @@
 a certain value is a member of a given set.  To test if the set @expr{A}
 is a subset of the set @expr{B}, use @samp{vdiff(A, B) = []}.
 
address@hidden v +
 @kindex V +
 @pindex calc-remove-duplicates
 @tindex rdup
@@ -20196,6 +20238,7 @@
 other set-based commands apply @kbd{V +} to their inputs before using
 them.
 
address@hidden v V
 @kindex V V
 @pindex calc-set-union
 @tindex vunion
@@ -20205,6 +20248,7 @@
 accomplish the same thing by concatenating the sets with @kbd{|},
 then using @kbd{V +}.)
 
address@hidden v ^
 @kindex V ^
 @pindex calc-set-intersect
 @tindex vint
@@ -20221,6 +20265,7 @@
 @texline address@hidden(@math{A \cap B}).
 @infoline intersection.
 
address@hidden v -
 @kindex V -
 @pindex calc-set-difference
 @tindex vdiff
@@ -20235,6 +20280,7 @@
 your problem is small enough to list in a Calc vector (or simple
 enough to express in a few intervals).
 
address@hidden v X
 @kindex V X
 @pindex calc-set-xor
 @tindex vxor
@@ -20244,6 +20290,7 @@
 if it is in one, but @emph{not} both, of the sets.  Objects that
 occur in both sets ``cancel out.''
 
address@hidden v ~
 @kindex V ~
 @pindex calc-set-complement
 @tindex vcompl
@@ -20253,6 +20300,7 @@
 For example, @samp{vcompl([2, (3 .. 4]])} evaluates to
 @samp{[[-inf .. 2), (2 .. 3], (4 .. inf]]}.
 
address@hidden v F
 @kindex V F
 @pindex calc-set-floor
 @tindex vfloor
@@ -20265,6 +20313,7 @@
 the complement with respect to the set of integers you could type
 @kbd{V ~ V F} to get @samp{[[-inf .. 1], [3 .. 5], [9 .. inf]]}.
 
address@hidden v E
 @kindex V E
 @pindex calc-set-enumerate
 @tindex venum
@@ -20274,6 +20323,7 @@
 the intervals.  This only works for finite sets (i.e., sets which
 do not involve @samp{-inf} or @samp{inf}).
 
address@hidden v :
 @kindex V :
 @pindex calc-set-span
 @tindex vspan
@@ -20283,6 +20333,7 @@
 limit will be the largest element.  For an empty set, @samp{vspan([])}
 returns the empty interval @address@hidden .. 0)}}.
 
address@hidden v #
 @kindex V #
 @pindex calc-set-cardinality
 @tindex vcard
@@ -20702,6 +20753,7 @@
 The commands in this section allow for more general operations on the
 elements of vectors.
 
address@hidden v A
 @kindex V A
 @pindex calc-apply
 @tindex apply
@@ -20879,6 +20931,7 @@
 @subsection Mapping
 
 @noindent
address@hidden v M
 @kindex V M
 @pindex calc-map
 @tindex map
@@ -20975,6 +21028,7 @@
 @subsection Reducing
 
 @noindent
address@hidden v R
 @kindex V R
 @pindex calc-reduce
 @tindex reduce
@@ -20987,6 +21041,7 @@
 and so on.  In general, reducing @code{f} over the vector @samp{[a, b, c, d]}
 produces @samp{f(f(f(a, b), c), d)}.
 
address@hidden I v R
 @kindex I V R
 @tindex rreduce
 The @kbd{I V R} address@hidden command is similar to @kbd{V R} except
@@ -20996,6 +21051,7 @@
 or @samp{a - b + c - d}.  This ``alternating sum'' occurs frequently
 in power series expansions.
 
address@hidden v U
 @kindex V U
 @tindex accum
 The @kbd{V U} (@code{calc-accumulate}) address@hidden command does an
@@ -21005,6 +21061,7 @@
 the vector @samp{[a, b, c, d]} produces the vector
 @samp{[a, a + b, a + b + c, a + b + c + d]}.
 
address@hidden I v U
 @kindex I V U
 @tindex raccum
 The @kbd{I V U} address@hidden command does a right-to-left accumulation.
@@ -21052,6 +21109,7 @@
 @subsection Nesting and Fixed Points
 
 @noindent
address@hidden H v R
 @kindex H V R
 @tindex nest
 The @kbd{H V R} address@hidden command applies a function to a given
@@ -21062,6 +21120,7 @@
 negative if Calc knows an inverse for the function @samp{f}; for
 example, @samp{nest(sin, a, -2)} returns @samp{arcsin(arcsin(a))}.
 
address@hidden H v U
 @kindex H V U
 @tindex anest
 The @kbd{H V U} address@hidden command is an accumulating version of
@@ -21070,6 +21129,7 @@
 @samp{F} is the inverse of @samp{f}, then the result is of the
 form @samp{[a, F(a), F(F(a)), F(F(F(a)))]}.
 
address@hidden H I v R
 @kindex H I V R
 @tindex fixp
 @cindex Fixed points
@@ -21078,6 +21138,7 @@
 applied until it reaches a ``fixed point,'' i.e., until the result
 no longer changes.
 
address@hidden H I v U
 @kindex H I V U
 @tindex afixp
 The @kbd{H I V U} address@hidden command is an accumulating @code{fixp}.
@@ -21127,6 +21188,7 @@
 @node Generalized Products,  , Nesting and Fixed Points, Reducing and Mapping
 @subsection Generalized Products
 
address@hidden v O
 @kindex V O
 @pindex calc-outer-product
 @tindex outer
@@ -21138,6 +21200,7 @@
 the result matrix is obtained by applying the operator to element @var{r}
 of the lefthand vector and element @var{c} of the righthand vector.
 
address@hidden v I
 @kindex V I
 @pindex calc-inner-product
 @tindex inner
@@ -21170,10 +21233,13 @@
 influenced by the @kbd{d O} (@code{calc-flat-language}) mode;
 @pxref{Normal Language Modes}.
 
address@hidden v <
 @kindex V <
 @pindex calc-matrix-left-justify
address@hidden v =
 @kindex V =
 @pindex calc-matrix-center-justify
address@hidden v >
 @kindex V >
 @pindex calc-matrix-right-justify
 The commands @kbd{v <} (@code{calc-matrix-left-justify}), @kbd{v >}
@@ -21181,10 +21247,13 @@
 (@code{calc-matrix-center-justify}) control whether matrix elements
 are justified to the left, right, or center of their columns.
 
address@hidden v [
 @kindex V [
 @pindex calc-vector-brackets
address@hidden v @{
 @kindex V @{
 @pindex calc-vector-braces
address@hidden v (
 @kindex V (
 @pindex calc-vector-parens
 The @kbd{v [} (@code{calc-vector-brackets}) command turns the square
@@ -21199,15 +21268,21 @@
 and parentheses may never be used for this purpose.
 
 @kindex V ]
address@hidden v ]
address@hidden V )
address@hidden v )
address@hidden V @}
address@hidden v @}
 @pindex calc-matrix-brackets
 The @kbd{v ]} (@code{calc-matrix-brackets}) command controls the
-``big'' style display of matrices.  It prompts for a string of code
-letters; currently implemented letters are @code{R}, which enables
-brackets on each row of the matrix; @code{O}, which enables outer
-brackets in opposite corners of the matrix; and @code{C}, which
-enables commas or semicolons at the ends of all rows but the last.
-The default format is @samp{RO}.  (Before Calc 2.00, the format
-was fixed at @samp{ROC}.)  Here are some example matrices:
+``big'' style display of matrices, for matrices which have more than
+one row.  It prompts for a string of code letters; currently
+implemented letters are @code{R}, which enables brackets on each row
+of the matrix; @code{O}, which enables outer brackets in opposite
+corners of the matrix; and @code{C}, which enables commas or
+semicolons at the ends of all rows but the last.  The default format
+is @samp{RO}.  (Before Calc 2.00, the format was fixed at @samp{ROC}.)
+Here are some example matrices:
 
 @example
 @group
@@ -21246,6 +21321,7 @@
 @samp{OC} are all recognized as matrices during reading, while
 the others are useful for display only.
 
address@hidden v ,
 @kindex V ,
 @pindex calc-vector-commas
 The @kbd{v ,} (@code{calc-vector-commas}) command turns commas on and
@@ -21261,6 +21337,7 @@
 ambiguity) by adding the letter @code{P} to the control string you
 give to @kbd{v ]} (as described above).
 
address@hidden v .
 @kindex V .
 @pindex calc-full-vectors
 The @kbd{v .} (@code{calc-full-vectors}) command turns abbreviated
@@ -21282,6 +21359,7 @@
 large vectors, this mode will improve the speed of all operations
 that involve the trail.
 
address@hidden v /
 @kindex V /
 @pindex calc-break-vectors
 The @kbd{v /} (@code{calc-break-vectors}) command turns multi-line