Mercurial > hg > xemacs-beta

comparison man/xemacs/regs.texi @ 0:376386a54a3c r19-14

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r19-14
author cvs
date Mon, 13 Aug 2007 08:45:50 +0200
parents
children 74fd4e045ea6
comparison
equal deleted inserted replaced
-1:000000000000 0:376386a54a3c
1
2 @node Registers, Display, Rectangles, Top
3 @chapter Registers
4 @cindex registers
5
6 Emacs @dfn{registers} are places in which you can save text or
7 positions for later use. Text saved in a register can be copied into
8 the buffer once or many times; a position saved in a register is used by
9 moving point to that position. Rectangles can also be copied into and
10 out of registers (@pxref{Rectangles}).
11
12 Each register has a name, which is a single character. A register can
13 store either a piece of text, a position, or a rectangle, but only one
14 thing at any given time. Whatever you store in a register remains
15 there until you store something else in that register.
16
17 @menu
18 * RegPos:: Saving positions in registers.
19 * RegText:: Saving text in registers.
20 * RegRect:: Saving rectangles in registers.
21 @end menu
22
23 @table @kbd
24 @item M-x view-register @key{RET} @var{r}
25 Display a description of what register @var{r} contains.
26 @end table
27
28 @findex view-register
29 @kbd{M-x view-register} reads a register name as an argument and then
30 displays the contents of the specified register.
31
32 @node RegPos, RegText, Registers, Registers
33 @section Saving Positions in Registers
34
35 Saving a position records a spot in a buffer so you can move
36 back there later. Moving to a saved position re-selects the buffer
37 and moves point to the spot.
38
39 @table @kbd
40 @item C-x r SPC @var{r}
41 Save the location of point in register @var{r} (@code{point-to-register}).
42 @item C-x r j @var{r}
43 Jump to the location saved in register @var{r} (@code{register-to-point}).
44 @end table
45
46 @kindex C-x r SPC
47 @findex point-to-register
48 To save the current location of point in a register, choose a name
49 @var{r} and type @kbd{C-x r SPC @var{r}}. The register @var{r} retains
50 the location thus saved until you store something else in that
51 register.@refill
52
53 @kindex C-x r j
54 @findex register-to-point
55 The command @kbd{C-x r j @var{r}} moves point to the location recorded
56 in register @var{r}. The register is not affected; it continues to
57 record the same location. You can jump to the same position using the
58 same register as often as you want.
59
60 @node RegText, RegRect, RegPos, Registers
61 @section Saving Text in Registers
62
63 When you want to insert a copy of the same piece of text many times, it
64 can be impractical to use the kill ring, since each subsequent kill moves
65 the piece of text further down on the ring. It becomes hard to keep
66 track of the argument needed to retrieve the same text with @kbd{C-y}. An
67 alternative is to store the text in a register with @kbd{C-x r s}
68 (@code{copy-to-register}) and then retrieve it with @kbd{C-x r g}
69 (@code{insert-register}).
70
71 @table @kbd
72 @item C-x r s @var{r}
73 Copy region into register @var{r} (@code{copy-to-register}).
74 @item C-x r g @var{r}
75 Insert text contents of register @var{r} (@code{insert-register}).
76 @end table
77
78 @kindex C-x r s
79 @kindex C-x r g
80 @findex copy-to-register
81 @findex insert-register
82 @kbd{C-x r s @var{r}} stores a copy of the text of the region into the
83 register named @var{r}. Given a numeric argument, @kbd{C-x r s} deletes the
84 text from the buffer as well.
85
86 @kbd{C-x r g @var{r}} inserts the text from register @var{r} in the buffer.
87 By default it leaves point before the text and places the mark after it.
88 With a numeric argument, it puts point after the text and the mark
89 before it.
90
91 @node RegRect,, RegText, Registers
92 @section Saving Rectangles in Registers
93 @cindex rectangle
94 @findex copy-region-to-rectangle
95
96 A register can contain a rectangle instead of lines of text. The rectangle
97 is represented as a list of strings. @xref{Rectangles}, for basic
98 information on rectangles and how to specify rectangles in a buffer.
99
100 @table @kbd
101 @item C-x r r @var{r}
102 Copy the region-rectangle into register @var{r}(@code{copy-rectangle-to-register}).
103 With a numeric argument, delete it as well.
104 @item C-x r g @var{r}
105 Insert the rectangle stored in register @var{r} (if it contains a
106 rectangle) (@code{insert-register}).
107 @end table
108
109 The @kbd{C-x r g} command inserts linear text if the register contains
110 that, or inserts a rectangle if the register contains one.