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

[Jay Belanger]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Jay Belanger <jpb>      09/07/29 03:43:53

Modified files:
        doc/misc       : calc.texi 

Log message:
        (Stack Manipulation Commands): Add documentation for
        `calc-transpose-lines' 

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

Patches:
Index: calc.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/misc/calc.texi,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -b -r1.34 -r1.35
--- calc.texi   21 Jul 2009 18:58:34 -0000      1.34
+++ calc.texi   29 Jul 2009 03:43:52 -0000      1.35
@@ -11845,12 +11845,29 @@
 With a negative argument @address@hidden, @key{TAB} rotates the stack
 to move the object in level @var{n} to the deepest place in the
 stack, and the object in level @address@hidden to the top.  @address@hidden
-rotates the deepest stack element to be in level @mathit{n}, also
+rotates the deepest stack element to be in level @var{n}, also
 putting the top stack element in level @address@hidden
 
 @xref{Selecting Subformulas}, for a way to apply these commands to
 any portion of a vector or formula on the stack.
 
address@hidden C-xC-t
address@hidden calc-transpose-lines
address@hidden Moving stack entries
+The command @kbd{C-x C-t} (@code{calc-transpose-lines}) will transpose
+the stack object determined by the point with the stack object at the
+next higher level. For example, with @samp{10 20 30 40 50} on the
+stack and the point on the line containing @samp{30}, @kbd{C-x C-t}
+creates @samp{10 20 40 30 50}.  More generally, @kbd{C-x C-t} acts on
+the stack objects determined by the current point (and mark) similar
+to how the text-mode command @code{transpose-lines} acts on 
+lines.  With argument @var{n}, @kbd{C-x C-t} will move the stack object
+at the level above the current point and move it past N other objects;
+for example, with @samp{10 20 30 40 50} on the stack and the point on
+the line containing @samp{30}, @kbd{C-u 2 C-x C-t} creates 
address@hidden 40 20 30 50}. With an argument of 0, @kbd{C-x C-t} will switch
+the stack objects at the levels determined by the point and the mark. 
+
 @node Editing Stack Entries, Trail Commands, Stack Manipulation, Stack and 
Trail
 @section Editing Stack Entries