comparison doc/emacs/rmail.texi @ 102411:76ba505784ee

(Rmail Basics): Add reference to sorting. (Rmail Scrolling, Rmail Motion, Rmail Reply, Rmail Display): Minor re-wordings. (Rmail Deletion): Expunging is not the only way to change the numbers. (Rmail Labels): Labels can also be used in sorting. (Rmail Summary Edit): Mention rmail-summary-next-same-subject.

102410:6afe784c0226

message.  You can also create multiple Rmail files and use Rmail to move
messages between them.

@cindex message number
  Within the Rmail file, messages are normally arranged sequentially in
order of receipt; you can specify other ways to sort them.  Messages are
identified by consecutive integers which are their @dfn{message numbers}.
The number of the current message is displayed in Rmail's mode line,
followed by the total number of messages in the file.  You can move to
a message by specifying its message number with the @kbd{j} key
(@pxref{Rmail Motion}).

@kindex s @r{(Rmail)}
@findex rmail-expunge-and-save
  Following the usual conventions of Emacs, changes in an Rmail file
become permanent only when you save the file.  You can save it with

@findex rmail-beginning-of-message
@findex rmail-end-of-message
  The command @kbd{.} (@code{rmail-beginning-of-message}) scrolls back to the
beginning of the selected message.  This is not quite the same as @kbd{M-<}:
for one thing, it does not set the mark; for another, it resets the buffer
boundaries to the current message if you have changed them.  Similarly,
the command @kbd{/} (@code{rmail-end-of-message}) scrolls forward to the end
of the selected message.
@c The comment about buffer boundaries is still true in mbox Rmail, if
@c less likely to be relevant.

  The @kbd{C-c C-n} (@code{rmail-next-same-subject}) command moves to
the next message with the same subject as the current one.  A prefix
argument serves as a repeat count.  With a negative argument, this
command moves backward, acting like @kbd{C-c C-p}
(@code{rmail-previous-same-subject}).  When comparing subjects, these
commands ignore the typical prefixes added to the subjects of replies.

@kindex j @r{(Rmail)}
@kindex > @r{(Rmail)}
@kindex < @r{(Rmail)}
@findex rmail-show-message

present; but it still has its place in the Rmail file, and still has its
message number.

@cindex expunging (Rmail)
  @dfn{Expunging} the Rmail file actually removes the deleted messages.
The remaining messages are renumbered consecutively.  Expunging is the only
action that changes the message number of any message, except for
undigestifying (@pxref{Rmail Digest}).

@table @kbd
@item d
Delete the current message, and move to the next nondeleted message
(@code{rmail-delete-forward}).

label on the current message.  If the @var{label} argument is empty, it
means to assign or remove the same label most recently assigned or
removed.

  Once you have given messages labels to classify them as you wish, there
are two ways to use the labels: in moving and in summaries.

@kindex C-M-n @r{(Rmail)}
@kindex C-M-p @r{(Rmail)}
@findex rmail-next-labeled-message
@findex rmail-previous-labeled-message

@xref{Rmail Summary}, for information on summaries.

  If the @var{labels} argument to @kbd{C-M-n}, @kbd{C-M-p} or
@kbd{C-M-l} is empty, it means to use the last set of labels specified
for any of these commands.

@node Rmail Attributes
@section Rmail Attributes

  Some labels such as @samp{deleted} and @samp{filed} have built-in

@findex rmail-resend
  @dfn{Resending} is an alternative similar to forwarding; the
difference is that resending sends a message that is ``from'' the
original sender, just as it reached you---with a few added header fields
@samp{Resent-From} and @samp{Resent-To} to indicate that it came via
you.  To resend a message in Rmail, use @kbd{C-u f}.  (@kbd{f} runs
@code{rmail-forward}, which invokes @code{rmail-resend} if you provide a
numeric argument.)

@kindex m @r{(Rmail)}

comma-separated list of labels.  A prefix argument acts as a repeat
count.
@item C-M-p @var{labels} @key{RET}
Move to the previous message with at least one of the specified labels
(@code{rmail-summary-previous-labeled-message}).
@end table

@vindex rmail-redisplay-summary
  Deletion, undeletion, and getting new mail, and even selection of a
different message all update the summary buffer when you do them in the

@code{rmail-displayed-headers} instead.  If non-@code{nil}, this should
be a regular expression specifying which headers to display.

@kindex t @r{(Rmail)}
@findex rmail-toggle-header
  Rmail saves the complete original header before reformatting; to see
it, use the @kbd{t} command (@code{rmail-toggle-header}).  This
discards the reformatted headers of the current message and displays
it with the original header.  Repeating @kbd{t} reformats the message
again, which shows only the interesting headers according to the
current values of the above variables.  Selecting the message again also
reformats it if necessary.

  When the @kbd{t} command has a prefix argument, a positive argument
means to show the reformatted header, and a zero or negative argument
means to show the full header.

102411:76ba505784ee

message.  You can also create multiple Rmail files and use Rmail to move
messages between them.

@cindex message number
  Within the Rmail file, messages are normally arranged sequentially in
order of receipt; you can specify other ways to sort them (@pxref{Rmail
Sorting}).  Messages are identified by consecutive integers which are
their @dfn{message numbers}.  The number of the current message is
displayed in Rmail's mode line, followed by the total number of messages
in the file.  You can move to a message by specifying its message number
with the @kbd{j} key (@pxref{Rmail Motion}).

@kindex s @r{(Rmail)}
@findex rmail-expunge-and-save
  Following the usual conventions of Emacs, changes in an Rmail file
become permanent only when you save the file.  You can save it with

@findex rmail-beginning-of-message
@findex rmail-end-of-message
  The command @kbd{.} (@code{rmail-beginning-of-message}) scrolls back to the
beginning of the selected message.  This is not quite the same as @kbd{M-<}:
for one thing, it does not set the mark; for another, it resets the buffer
boundaries of the current message if you have changed them.  Similarly,
the command @kbd{/} (@code{rmail-end-of-message}) scrolls forward to the end
of the selected message.
@c The comment about buffer boundaries is still true in mbox Rmail, if
@c less likely to be relevant.

  The @kbd{C-c C-n} (@code{rmail-next-same-subject}) command moves to
the next message with the same subject as the current one.  A prefix
argument serves as a repeat count.  With a negative argument, this
command moves backward, acting like @kbd{C-c C-p}
(@code{rmail-previous-same-subject}).  When comparing subjects, these
commands ignore the prefixes typically added to the subjects of replies.

@kindex j @r{(Rmail)}
@kindex > @r{(Rmail)}
@kindex < @r{(Rmail)}
@findex rmail-show-message

present; but it still has its place in the Rmail file, and still has its
message number.

@cindex expunging (Rmail)
  @dfn{Expunging} the Rmail file actually removes the deleted messages.
The remaining messages are renumbered consecutively.
@c The following is neither true (there is also unforward, sorting,
@c etc), nor especially interesting.
@c Expunging is the only action that changes the message number of any
@c message, except for undigestifying (@pxref{Rmail Digest}).

@table @kbd
@item d
Delete the current message, and move to the next nondeleted message
(@code{rmail-delete-forward}).

label on the current message.  If the @var{label} argument is empty, it
means to assign or remove the same label most recently assigned or
removed.

  Once you have given messages labels to classify them as you wish, there
are three ways to use the labels: in moving, in summaries, and in sorting.

@kindex C-M-n @r{(Rmail)}
@kindex C-M-p @r{(Rmail)}
@findex rmail-next-labeled-message
@findex rmail-previous-labeled-message

@xref{Rmail Summary}, for information on summaries.

  If the @var{labels} argument to @kbd{C-M-n}, @kbd{C-M-p} or
@kbd{C-M-l} is empty, it means to use the last set of labels specified
for any of these commands.

  @xref{Rmail Sorting}, for information on sorting messages with labels.

@node Rmail Attributes
@section Rmail Attributes

  Some labels such as @samp{deleted} and @samp{filed} have built-in

@findex rmail-resend
  @dfn{Resending} is an alternative similar to forwarding; the
difference is that resending sends a message that is ``from'' the
original sender, just as it reached you---with a few added header fields
(@samp{Resent-From} and @samp{Resent-To}) to indicate that it came via
you.  To resend a message in Rmail, use @kbd{C-u f}.  (@kbd{f} runs
@code{rmail-forward}, which invokes @code{rmail-resend} if you provide a
numeric argument.)

@kindex m @r{(Rmail)}

comma-separated list of labels.  A prefix argument acts as a repeat
count.
@item C-M-p @var{labels} @key{RET}
Move to the previous message with at least one of the specified labels
(@code{rmail-summary-previous-labeled-message}).
@item C-c C-n @key{RET}
Move to the next message with the same subject as the current message
(@code{rmail-summary-next-same-subject}).  A prefix argument acts as a
repeat count.
@item C-c C-p @key{RET}
Move to the previous message with the same subject as the current message
(@code{rmail-summary-previous-same-subject}).
@end table

@vindex rmail-redisplay-summary
  Deletion, undeletion, and getting new mail, and even selection of a
different message all update the summary buffer when you do them in the

@code{rmail-displayed-headers} instead.  If non-@code{nil}, this should
be a regular expression specifying which headers to display.

@kindex t @r{(Rmail)}
@findex rmail-toggle-header
  To see the complete, original header, use the @kbd{t} command
(@code{rmail-toggle-header}).  This discards the reformatted headers of
the current message and displays it with the original header.  Repeating
@kbd{t} reformats the message again, which shows only the interesting
headers according to the current values of the above variables.
Selecting the message again also reformats it if necessary.

  When the @kbd{t} command has a prefix argument, a positive argument
means to show the reformatted header, and a zero or negative argument
means to show the full header.