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

[Glenn Morris]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       09/03/01 01:00:47

Modified files:
        doc/emacs      : ChangeLog rmail.texi 

Log message:
        (Rmail): Fix some typos.
        (Rmail Motion): - M-s searches from the end of messages.
        (Rmail Deletion): Minor clarification.  Fix numeric argument
        description.
        (Rmail Inbox): Fix default inbox description.  Mention `mbox' by name.
        newmail and RMAILOSE files need not be in home-directory.
        (Rmail Files): Mention I/O menus are unselectable if no files match.
        Mention `MAIL' env-var.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/ChangeLog?cvsroot=emacs&r1=1.290&r2=1.291
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/rmail.texi?cvsroot=emacs&r1=1.10&r2=1.11

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/ChangeLog,v
retrieving revision 1.290
retrieving revision 1.291
diff -u -b -r1.290 -r1.291
--- ChangeLog   24 Feb 2009 13:42:02 -0000      1.290
+++ ChangeLog   1 Mar 2009 01:00:47 -0000       1.291
@@ -1,3 +1,14 @@
+2009-03-01  Glenn Morris  <address@hidden>
+
+       * rmail.texi (Rmail): Fix some typos.
+       (Rmail Motion): - M-s searches from the end of messages.
+       (Rmail Deletion): Minor clarification.  Fix numeric argument
+       description.
+       (Rmail Inbox): Fix default inbox description.  Mention `mbox' by name.
+       newmail and RMAILOSE files need not be in home-directory.
+       (Rmail Files): Mention I/O menus are unselectable if no files match.
+       Mention `MAIL' env-var.
+
 2009-02-24  Jason Rumney  <address@hidden>
 
        * mule.texi (Fontsets): Mention fontset-default, font specs and

Index: rmail.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/rmail.texi,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- rmail.texi  20 Feb 2009 06:18:52 -0000      1.10
+++ rmail.texi  1 Mar 2009 01:00:47 -0000       1.11
@@ -12,7 +12,7 @@
 
   Rmail is an Emacs subsystem for reading and disposing of mail that
 you receive.  Rmail stores mail messages in files called Rmail files.
-Reading the message in an Rmail file is done in a special major mode,
+Reading the messages in an Rmail file is done in a special major mode,
 Rmail mode, which redefines most letters to run commands for managing mail.
 @menu
 * Basic: Rmail Basics.       Basic concepts of Rmail, and simple use.
@@ -21,7 +21,7 @@
 * Deletion: Rmail Deletion.  Deleting and expunging messages.
 * Inbox: Rmail Inbox.        How mail gets into the Rmail file.
 * Files: Rmail Files.        Using multiple Rmail files.
-* Output: Rmail Output.             Copying message out to files.
+* Output: Rmail Output.             Copying messages out to files.
 * Labels: Rmail Labels.      Classifying messages by labeling them.
 * Attrs: Rmail Attributes.   Certain standard labels, called attributes.
 * Reply: Rmail Reply.        Sending replies to messages you are viewing.
@@ -35,7 +35,7 @@
 * Movemail::                 More details of fetching new mail.
 * Remote Mailboxes::         Retrieving Mail from Remote Mailboxes.
 * Other Mailbox Formats::    Retrieving Mail from Local Mailboxes in
-                             Various Formats
+                             Various Formats.
 @end menu
 
 @node Rmail Basics
@@ -125,6 +125,8 @@
 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.
address@hidden The comment about buffer boundaries is still true in mbox Rmail, 
if
address@hidden less likely to be relevant.
 
 @node Rmail Motion
 @section Moving Among Messages
@@ -202,7 +204,8 @@
 used the previous time.
 
   To search backward in the file for another message, give @kbd{M-s} a
-negative argument.  In Rmail you can do this with @kbd{- M-s}.
+negative argument.  In Rmail you can do this with @kbd{- M-s}.  This
+begins searching from the end of the previous message.
 
   It is also possible to search for a message based on labels.
 @xref{Rmail Labels}.
@@ -242,8 +245,8 @@
 Delete the current message, and move to the previous nondeleted
 message (@code{rmail-delete-backward}).
 @item u
-Undelete the current message, or move back to a deleted message and
-undelete it (@code{rmail-undelete-previous-message}).
+Undelete the current message, or move back to the previous deleted
+message and undelete it (@code{rmail-undelete-previous-message}).
 @item x
 Expunge the Rmail file (@code{rmail-expunge}).
 @end table
@@ -257,10 +260,12 @@
 (@code{rmail-delete-forward}) moves to the following message, skipping
 messages already deleted, while @kbd{C-d} (@code{rmail-delete-backward})
 moves to the previous nondeleted message.  If there is no nondeleted
-message to move to in the specified direction, the message that was just
-deleted remains current.  @kbd{d} with a numeric argument is
-equivalent to @kbd{C-d}.
+message to move to in the specified direction, these commands move to
+the last or first message.  With a numeric argument, these commands
+delete the specified number of messages.  @kbd{d} with a negative
+numeric argument is equivalent to @kbd{C-d}, and vice versa.
 
address@hidden mention other hooks, eg show message hook?
 @vindex rmail-delete-message-hook
   Whenever Rmail deletes a message, it runs the hook
 @code{rmail-delete-message-hook}.  When the hook functions are invoked,
@@ -313,15 +318,16 @@
 @cindex @env{MAIL} environment variable
   The variable @code{rmail-primary-inbox-list} contains a list of the
 files which are inboxes for your primary Rmail file.  If you don't set
-this variable explicitly, it is initialized from the @env{MAIL}
-environment variable, or, as a last resort, set to @code{nil}, which
-means to use the default inbox.  The default inbox file depends on
-your operating system; often it is @file{/var/mail/@var{username}},
address@hidden/usr/spool/mail/@var{username}}, or
address@hidden/usr/mail/@var{username}}.
-
-  You can specify the inbox file(s) for any Rmail file with the
-command @code{set-rmail-inbox-list}; see @ref{Rmail Files}.
+this variable explicitly, Rmail uses the @env{MAIL} environment
+variable, or, as a last resort, a default inbox based on
address@hidden  The default inbox file depends on your
+operating system; often it is @file{/var/mail/@var{username}},
address@hidden/var/spool/mail/@var{username}}, or
address@hidden/usr/spool/mail/@var{username}}.
+
+  You can specify the inbox file(s) for any Rmail file for the current
+session with the command @code{set-rmail-inbox-list}; see @ref{Rmail
+Files}.
 
   There are two reasons for having separate Rmail files and inboxes.
 
@@ -341,11 +347,12 @@
 the rest of Rmail, since only Rmail operates on the Rmail file.
 @end enumerate
 
-  Rmail was originally written to use Babyl as its internal format.
-Since then, we have recognized that the usual inbox format on Unix and
-GNU systems is adequate for the job, and so since Emacs 23 Rmail uses
-that as its internal format.  The Rmail file is still separate from the
-inbox file, even though their format is the same.
+  Rmail was originally written to use the Babyl format as its internal
+format.  Since then, we have recognized that the usual inbox format
+(@samp{mbox}) on Unix and GNU systems is adequate for the job, and so
+since Emacs 23 Rmail uses that as its internal format.  The Rmail file
+is still separate from the inbox file, even though their format is the
+same.
 
 @vindex rmail-preserve-inbox
   When getting new mail, Rmail first copies the new mail from the
@@ -361,20 +368,20 @@
   In some cases, Rmail copies the new mail from the inbox file
 indirectly.  First it runs the @code{movemail} program to move the mail
 from the inbox to an intermediate file called
address@hidden/address@hidden  Then Rmail merges the new mail from
-that file, saves the Rmail file, and only then deletes the intermediate
-file.  If there is a crash at the wrong time, this file continues to
-exist, and Rmail will use it again the next time it gets new mail from
-that inbox.
address@hidden@var{inboxname}}, in the same directory as the Rmail
+file.  Then Rmail merges the new mail from that file, saves the Rmail
+file, and only then deletes the intermediate file.  If there is a crash
+at the wrong time, this file continues to exist, and Rmail will use it
+again the next time it gets new mail from that inbox.
 
   If Rmail is unable to convert the data in
address@hidden/address@hidden into mbox format, it renames the file
-to @file{~/address@hidden (@var{n} is an integer chosen to make the
-name unique) so that Rmail will not have trouble with the data again.
-You should look at the file, find whatever message confuses Rmail
-(probably one that includes the control-underscore character, octal code
-037), and delete it.  Then you can use @kbd{1 g} to get new mail from
-the corrected file.
address@hidden@var{inboxname}} into mbox format, it renames the file to
address@hidden@var{n}} (@var{n} is an integer chosen to make the name
+unique) so that Rmail will not have trouble with the data again.  You
+should look at the file, find whatever message confuses Rmail (probably
+one that includes the control-underscore character, octal code 037), and
+delete it.  Then you can use @kbd{1 g} to get new mail from the
+corrected file.
 
 @node Rmail Files
 @section Multiple Rmail Files
@@ -423,9 +430,10 @@
 The variables @code{rmail-secondary-file-directory} and
 @code{rmail-secondary-file-regexp} specify which files to offer in the
 menu: the first variable says which directory to find them in; the
-second says which files in that directory to offer (all those that
-match the regular expression).  These variables also apply to choosing
-a file for output (@pxref{Rmail Output}).
+second says which files in that directory to offer (all those that match
+the regular expression).  If no files match, you cannot select this menu
+item.  These variables also apply to choosing a file for output
+(@pxref{Rmail Output}).
 
 @ignore
 @findex set-rmail-inbox-list
@@ -440,8 +448,9 @@
 @vindex rmail-inbox-list
   The inbox files to use are specified by the variable
 @code{rmail-inbox-list}, which is buffer-local in Rmail mode.  As a
-special exception, if you have specified no inbox files for your
-primary Rmail file, it uses your standard system inbox.
+special exception, if you have specified no inbox files for your primary
+Rmail file, it uses the @env{MAIL} environment variable, or your
+standard system inbox.
 
 @kindex g @r{(Rmail)}
 @findex rmail-get-new-mail
@@ -510,7 +519,8 @@
 @code{rmail-secondary-file-regexp} specify which files to offer in the
 menu: the first variable says which directory to find them in; the
 second says which files in that directory to offer (all those that
-match the regular expression).
+match the regular expression).  If no files match, you cannot select
+this menu item.
 
 @vindex rmail-delete-after-output
   Copying a message with @kbd{o} or @kbd{C-o} gives the original copy