[Emacs-diffs] Changes to emacs/doc/misc/calc.texi,v

[Jay Belanger]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Jay Belanger <jpb>      08/05/18 21:15:53

Index: calc.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/misc/calc.texi,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -b -r1.16 -r1.17
--- calc.texi   11 Apr 2008 22:36:49 -0000      1.16
+++ calc.texi   18 May 2008 21:15:51 -0000      1.17
@@ -28178,8 +28178,7 @@
 
 @kindex r 0-9
 The @kbd{r} prefix may be followed by a digit, so that @kbd{r 9} is
-equivalent to @kbd{s r 9}.  (The @kbd{r} prefix is otherwise unused
-in the current version of Calc.)
+equivalent to @kbd{s r 9}.
 
 @node Operations on Variables, Let Command, Recalling Variables, Store and 
Recall
 @section Other Operations on Variables
@@ -29210,6 +29209,8 @@
 @menu
 * Killing From Stack::
 * Yanking Into Stack::
+* Saving Into Registers::
+* Inserting From Registers::
 * Grabbing From Buffers::
 * Yanking Into Buffers::
 * X Cut and Paste::
@@ -29255,7 +29256,7 @@
 @kbd{C-k} with a prefix argument of 1 copies the number with its trailing
 newline.
 
address@hidden Yanking Into Stack, Grabbing From Buffers, Killing From Stack, 
Kill and Yank
address@hidden Yanking Into Stack, Saving Into Registers, Killing From Stack, 
Kill and Yank
 @section Yanking into the Stack
 
 @noindent
@@ -29274,7 +29275,53 @@
 show all objects to their full precision, this feature normally makes no
 difference.)
 
address@hidden Grabbing From Buffers, Yanking Into Buffers, Yanking Into Stack, 
Kill and Yank
address@hidden Saving Into Registers, Inserting From Registers, Yanking Into 
Stack, Kill and Yank
address@hidden Saving into Registers
+
address@hidden
address@hidden r s
address@hidden calc-copy-to-register
address@hidden calc-prepend-to-register
address@hidden calc-append-to-register
address@hidden Registers
+An alternative to killing and yanking stack entries is using 
+registers in Calc.  Saving stack entries in registers is like
+saving text in normal Emacs registers; although, like Calc's kill
+commands, register commands always operate on whole stack
+entries.
+
+Registers in Calc are places to store stack entries for later use;
+each register is indexed by a single character.  To store the current
+region (rounded up, of course, to include full stack entries) into a
+register, use the command @kbd{r s} (@code{calc-copy-to-register}).
+You will then be prompted for a register to use, the next character
+you type will be the index for the register.  To store the region in
+register @var{r}, the full command will be @kbd{r s @var{r}}.  With an
+argument, @kbd{C-u r s @var{r}}, the region being copied to the
+register will be deleted from the Calc buffer.
+
+It is possible to add additional stack entries to a register.  The
+command @kbd{M-x calc-append-to-register} will prompt for a register,
+then add the stack entries in the region to the end of the register
+contents. The command @kbd{M-x calc-prepend-to-register} will
+similarly prompt for a register and add  the stack entries in the
+region to the beginning of the register contents.  Both commands take
address@hidden arguments, which will cause the region to be deleted after being
+added to the register.
+
address@hidden Inserting From Registers, Grabbing From Buffers, Saving Into 
Registers, Kill and Yank
address@hidden Inserting from Registers
address@hidden
address@hidden r i
address@hidden calc-insert-register
+The command @kbd{r i} (@code{calc-insert-register}) will prompt for a
+register, then insert the contents of that register into the
+Calculator.  If the contents of the register were placed there from
+within Calc, then the full internal structure of the contents will be
+inserted into the Calculator, otherwise whatever text is in the
+register is reparsed and then inserted into the Calculator.
+
address@hidden Grabbing From Buffers, Yanking Into Buffers, Inserting From 
Registers, Kill and Yank
 @section Grabbing from Other Buffers
 
 @noindent
@@ -35610,6 +35657,10 @@
 @r{       @:      m U   @:             @:    12  @:calc-units-simplify-mode@:}
 
 @c
address@hidden       @:      r s   @:register     @:    27  
@:calc-copy-to-register@:}
address@hidden       @:      r i   @:register     @:        
@:calc-insert-register@:}
+
address@hidden
 @r{       @:      s c   @:var1, var2   @:    29  @:calc-copy-variable@:}
 @r{       @:      s d   @:var, decl    @:        @:calc-declare-variable@:}
 @r{       @:      s e   @:var, editing @: 29,30  @:calc-edit-variable@:}