comparison man/regs.texi @ 40267:dca37162945a

(RegText): Document append-to-register and prepend-to-register. Suggested by Philip Lijnzaad <[e-mail]>. Add index entries to all sections of the Registers chapter.

40266:b3ad4265c0eb

* Bookmarks::                 Bookmarks are like registers, but persistent.
@end menu

@node RegPos
@section Saving Positions in Registers

  Saving a position records a place in a buffer so that you can move
back there later.  Moving to a saved position switches to that buffer
and moves point to that place in it.

again by visiting the same file.  Of course, this works only for buffers
that were visiting files.

@node RegText
@section Saving Text in Registers

  When you want to insert a copy of the same piece of text several
times, it may be inconvenient to yank it from the kill ring, since each
subsequent kill moves that entry further down the ring.  An alternative
is to store the text in a register and later retrieve it.

@table @kbd
@item C-x r s @var{r}
Copy region into register @var{r} (@code{copy-to-register}).
@item C-x r i @var{r}
Insert text from register @var{r} (@code{insert-register}).
@end table

@kindex C-x r s
@kindex C-x r i
@findex copy-to-register

  @kbd{C-x r s @var{r}} stores a copy of the text of the region into
the register named @var{r}.  @kbd{C-u C-x r s @var{r}}, the same
command with a numeric argument, deletes the text from the buffer as
well; you can think of this as ``moving'' the region text into the register.

  @kbd{C-x r i @var{r}} inserts in the buffer the text from register
@var{r}.  Normally it leaves point before the text and places the mark
after, but with a numeric argument (@kbd{C-u}) it puts point after the
text and the mark before.

@node RegRect
@section Saving Rectangles in Registers

  A register can contain a rectangle instead of linear text.  The
rectangle is represented as a list of strings.  @xref{Rectangles}, for
basic information on how to specify a rectangle in the buffer.

  See also the command @code{sort-columns}, which you can think of
as sorting a rectangle.  @xref{Sorting}.

@node RegConfig
@section Saving Window Configurations in Registers

@findex window-configuration-to-register
@findex frame-configuration-to-register
@kindex C-x r w
@kindex C-x r f

configuration become invisible.  If you wish to delete these frames
instead, use @kbd{C-u C-x r j @var{r}}.

@node RegNumbers
@section Keeping Numbers in Registers

  There are commands to store a number in a register, to insert
the number in the buffer in decimal, and to increment it.  These commands
can be useful in keyboard macros (@pxref{Keyboard Macros}).

argument increments the register value by 1; @kbd{C-x r n} with no
numeric argument stores zero in the register.

@node RegFiles
@section Keeping File Names in Registers

  If you visit certain file names frequently, you can visit them more
conveniently if you put their names in registers.  Here's the Lisp code
used to put a file name in a register:

40267:dca37162945a

* Bookmarks::                 Bookmarks are like registers, but persistent.
@end menu

@node RegPos
@section Saving Positions in Registers
@cindex saving position in a register

  Saving a position records a place in a buffer so that you can move
back there later.  Moving to a saved position switches to that buffer
and moves point to that place in it.

again by visiting the same file.  Of course, this works only for buffers
that were visiting files.

@node RegText
@section Saving Text in Registers
@cindex saving text in a register

  When you want to insert a copy of the same piece of text several
times, it may be inconvenient to yank it from the kill ring, since each
subsequent kill moves that entry further down the ring.  An alternative
is to store the text in a register and later retrieve it.

@table @kbd
@item C-x r s @var{r}
Copy region into register @var{r} (@code{copy-to-register}).
@item C-x r i @var{r}
Insert text from register @var{r} (@code{insert-register}).
@item M-x append-to-register @key{RET} @var{r}
Append region to text in register @var{r}.
@item M-x prepend-to-register @key{RET} @var{r}
Prepend region to text in register @var{r}.
@end table

@kindex C-x r s
@kindex C-x r i
@findex copy-to-register

  @kbd{C-x r s @var{r}} stores a copy of the text of the region into
the register named @var{r}.  @kbd{C-u C-x r s @var{r}}, the same
command with a numeric argument, deletes the text from the buffer as
well; you can think of this as ``moving'' the region text into the register.

@findex append-to-register
@findex prepend-to-register
  @kbd{M-x append-to-register @key{RET} @var{r}} appends the copy of
the text in the region to the text already stored in the register
named @var{r}.  If invoked with a numeric argument, it deletes the
region after appending it to the register.  A similar command
@code{prepend-to-register} works the same, except that it
@emph{prepends} the region text to the text in the register, rather
than @emph{appending} it.

  @kbd{C-x r i @var{r}} inserts in the buffer the text from register
@var{r}.  Normally it leaves point before the text and places the mark
after, but with a numeric argument (@kbd{C-u}) it puts point after the
text and the mark before.

@node RegRect
@section Saving Rectangles in Registers
@cindex saving rectangle in a register

  A register can contain a rectangle instead of linear text.  The
rectangle is represented as a list of strings.  @xref{Rectangles}, for
basic information on how to specify a rectangle in the buffer.

  See also the command @code{sort-columns}, which you can think of
as sorting a rectangle.  @xref{Sorting}.

@node RegConfig
@section Saving Window Configurations in Registers
@cindex saving window configuration in a register

@findex window-configuration-to-register
@findex frame-configuration-to-register
@kindex C-x r w
@kindex C-x r f

configuration become invisible.  If you wish to delete these frames
instead, use @kbd{C-u C-x r j @var{r}}.

@node RegNumbers
@section Keeping Numbers in Registers
@cindex saving number in a register

  There are commands to store a number in a register, to insert
the number in the buffer in decimal, and to increment it.  These commands
can be useful in keyboard macros (@pxref{Keyboard Macros}).

argument increments the register value by 1; @kbd{C-x r n} with no
numeric argument stores zero in the register.

@node RegFiles
@section Keeping File Names in Registers
@cindex saving fuile name in a register

  If you visit certain file names frequently, you can visit them more
conveniently if you put their names in registers.  Here's the Lisp code
used to put a file name in a register: