[Emacs-diffs] emacs/doc/emacs ChangeLog rmail.texi

[Glenn Morris]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       09/03/05 07:08:36

Modified files:
        doc/emacs      : ChangeLog rmail.texi 

Log message:
        (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.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/ChangeLog?cvsroot=emacs&r1=1.298&r2=1.299
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/rmail.texi?cvsroot=emacs&r1=1.18&r2=1.19

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/ChangeLog,v
retrieving revision 1.298
retrieving revision 1.299
diff -u -b -r1.298 -r1.299
--- ChangeLog   5 Mar 2009 03:40:00 -0000       1.298
+++ ChangeLog   5 Mar 2009 07:08:36 -0000       1.299
@@ -1,6 +1,12 @@
 2009-03-05  Glenn Morris  <address@hidden>
 
-       * rmail.texi (Rmail Motion): Mention rmail-next-same-subject.
+       * rmail.texi (Rmail Basics): Add reference to sorting.
+       (Rmail Scrolling, Rmail Motion, Rmail Reply, Rmail Display):
+       Minor re-wordings.
+       (Rmail Motion): Mention rmail-next-same-subject.
+       (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.
        (Rmail Display): Mention rmail-mime.
 
 2009-03-04  Glenn Morris  <address@hidden>

Index: rmail.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/rmail.texi,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -b -r1.18 -r1.19
--- rmail.texi  5 Mar 2009 06:25:35 -0000       1.18
+++ rmail.texi  5 Mar 2009 07:08:36 -0000       1.19
@@ -59,12 +59,12 @@
 
 @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}).
+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
@@ -122,7 +122,7 @@
   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,
+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
@@ -225,7 +225,7 @@
 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.
+commands ignore the prefixes typically added to the subjects of replies.
 
 @kindex j @r{(Rmail)}
 @kindex > @r{(Rmail)}
@@ -250,9 +250,11 @@
 
 @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}).
+The remaining messages are renumbered consecutively.
address@hidden The following is neither true (there is also unforward, sorting,
address@hidden etc), nor especially interesting.
address@hidden Expunging is the only action that changes the message number of 
any
address@hidden message, except for undigestifying (@pxref{Rmail Digest}).
 
 @table @kbd
 @item d
@@ -612,7 +614,7 @@
 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.
+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)}
@@ -636,6 +638,8 @@
 @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
 
@@ -781,7 +785,7 @@
   @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
address@hidden and @samp{Resent-To} to indicate that it came via
+(@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.)
@@ -997,6 +1001,13 @@
 @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}).
address@hidden 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.
address@hidden 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
@@ -1117,13 +1128,12 @@
 
 @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.
+  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
address@hidden 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