[Emacs-diffs] emacs-26 fb3dc0e: More proofreading of the Emacs manual

[Eli Zaretskii]

branch: emacs-26
commit fb3dc0e8aa9ce8514cd6ee0e33a91a34ee0d5756
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    More proofreading of the Emacs manual
    
    * doc/emacs/macos.texi (Mac / GNUstep Basics): Fix typos.  Improve
    indexing.
    (Mac / GNUstep Basics, Mac / GNUstep Customization)
    (Mac / GNUstep Events): Improve indexing.
    
    * doc/emacs/rmail.texi (Rmail): Mention Gnus.
    (Rmail Basics, Rmail Scrolling): Improve cross-references and
    indexing.
    (Rmail Motion): Minor improvements.
    (Rmail Inbox): Remove outdated text about Babyl format.
    (Rmail Files): Formatting changes.  Comment out
    set-rmail-inbox-list in the table of commands, as it is commented
    out in the text that follows.
    (Rmail Output, Rmail Labels, Rmail Reply, Rmail Make Summary):
    Minor copyedits.
    (Rmail Summary Edit): Document
    rmail-summary-scroll-between-messages.
    (Rmail Editing): Improve indexing.
    (Movemail): Fix typos.
    (Remote Mailboxes): Use "POP3" rather than "POP".
---
 doc/emacs/macos.texi |  14 ++++-
 doc/emacs/rmail.texi | 173 ++++++++++++++++++++++++++++-----------------------
 2 files changed, 107 insertions(+), 80 deletions(-)

diff --git a/doc/emacs/macos.texi b/doc/emacs/macos.texi
index 4982c78..e669eaa 100644
--- a/doc/emacs/macos.texi
+++ b/doc/emacs/macos.texi
@@ -21,7 +21,7 @@ begin with @samp{ns-}, which is short for @samp{Nextstep}.  
NeXTstep
 was an application interface released by NeXT Inc.@: during the 1980s,
 of which Cocoa is a direct descendant.  Apart from Cocoa, there is
 another NeXTstep-style system: GNUstep, which is free software.  As of
-this writing, Emacs GNUstep support is alpha status (@pxref{GNUstep
+this writing, Emacs GNUstep support is in alpha status (@pxref{GNUstep
 Support}), but we hope to improve it in the future.
 
 @menu
@@ -34,6 +34,7 @@ Support}), but we hope to improve it in the future.
 @node Mac / GNUstep Basics
 @section Basic Emacs usage under macOS and GNUstep
 
address@hidden modifier keys (macOS)
   By default, the @key{Alt} and @key{Option} keys are the same as
 @key{Meta}.  The Mac @key{Cmd} key is the same as @key{Super}, and
 Emacs provides a set of key bindings using this modifier key that mimic
@@ -47,7 +48,7 @@ behavior of the right @key{Alt} and @key{Option} keys.  These 
keys
 behave like the left-hand keys if the value is @code{left} (the
 default).  A value of @code{control}, @code{meta}, @code{alt},
 @code{super}, or @code{hyper} makes them behave like the corresponding
-modifier keys; a value to @code{left} means be the same key as
+modifier keys; a value of @code{left} means be the same key as
 @code{ns-alternate-modifier}; a value of @code{none} tells Emacs to
 ignore them, in which case you get the default behavior of macOS
 accentuation system from the right option key.
@@ -64,6 +65,7 @@ dialogs to read file names.  However, if you use the regular 
Emacs key
 sequences, such as @kbd{C-x C-f}, Emacs uses the minibuffer to read
 file names.
 
address@hidden copy/paste to/from primary selection (macOS)
   On GNUstep, in an X-windows environment you need to use @kbd{Cmd-c}
 instead of one of the @kbd{C-w} or @kbd{M-w} commands to transfer text
 to the X primary selection; otherwise, Emacs will use the
@@ -76,6 +78,7 @@ clipboard.
 
 @c How is this any different to launching from a window manager menu
 @c in GNU/Linux?  These are sometimes not login shells either.
address@hidden environment variables (macOS)
 Many programs which may run under Emacs, like latex or man, depend on the
 settings of environment variables.  If Emacs is launched from the shell, it
 will automatically inherit these environment variables and its subprocesses
@@ -98,6 +101,7 @@ keys and the fullscreen behavior.  To see all such options, 
use
 
 @subsection Font and Color Panels
 
address@hidden ns-popup-font-panel
 The standard Mac / GNUstep font and color panels are accessible via
 Lisp commands.  The Font Panel may be accessed with @kbd{M-x
 ns-popup-font-panel}.  It will set the default font in the frame most
@@ -106,6 +110,7 @@ recently used or clicked on.
 @c  To make the setting permanent, use @samp{Save Options} in the
 @c Options menu, or run @code{menu-bar-options-save}.
 
address@hidden ns-popup-color-panel
 You can bring up a color panel with @kbd{M-x ns-popup-color-panel} and
 drag the color you want over the Emacs face you want to change.  Normal
 dragging will alter the foreground color.  Shift dragging will alter the
@@ -119,6 +124,7 @@ Useful in this context is the listing of all faces obtained 
by
 @kbd{M-x list-faces-display}.
 
 @cindex Core Text, on macOS
address@hidden font backend, on macOS
 In macOS, Emacs uses a Core Text based font backend
 by default.  If you prefer the older font style, enter the following
 at the command-line before starting Emacs:
@@ -130,6 +136,7 @@ at the command-line before starting Emacs:
 
 @node Mac / GNUstep Events
 @section Windowing System Events under macOS / GNUstep
address@hidden events on macOS
 
   Nextstep applications receive a number of special events which have
 no X equivalent.  These are sent as specially defined key events, which
@@ -152,7 +159,7 @@ You can change how Emacs responds to a @code{ns-open-file} 
event by
 changing the variable @code{ns-pop-up-frames}.  Its default value,
 @samp{fresh}, is what we have just described.  A value of @code{t}
 means to always visit the file in a new frame.  A value of @code{nil}
-means to always visit the file in an existing frame.
+means to always visit the file in the selected frame.
 
 @item ns-open-temp-file
 This event occurs when another application requests that Emacs open a
@@ -195,6 +202,7 @@ This event occurs when the user logs out and Emacs is still 
running, or when
 The default behavior is to save all file-visiting buffers.
 @end table
 
address@hidden using Nextstep services (macOS)
   Emacs also allows users to make use of Nextstep services, via a set
 of commands whose names begin with @samp{ns-service-} and end with the
 name of the service.  Type @kbd{M-x address@hidden to
diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi
index cb62ce3..a51ded1 100644
--- a/doc/emacs/rmail.texi
+++ b/doc/emacs/rmail.texi
@@ -14,6 +14,12 @@
 you receive.  Rmail stores mail messages in files called Rmail files.
 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.
+
+  Emacs also comes with a much more sophisticated and flexible
+subsystem for reading mail, called Gnus.  Gnus is a very large
+package, and is therefore described in its own manual, see @ref{Top,,,
+gnus, The Gnus Newsreader}.
+
 @menu
 * Basic: Rmail Basics.       Basic concepts of Rmail, and simple use.
 * Scroll: Rmail Scrolling.   Scrolling through a message.
@@ -50,14 +56,15 @@ Rmail file, merges new mail in from your inboxes, displays 
the first
 message you haven't read yet, and lets you begin reading.  The variable
 @code{rmail-file-name} specifies the name of the primary Rmail file.
 
address@hidden current message (Rmail)
   Rmail displays only one message in the Rmail file at a time.
 The message that is shown is called the @dfn{current message}.  Rmail
 mode's special commands can do such things as delete the current
 message, copy it into another file, send a reply, or move to another
-message.  You can also create multiple Rmail files and use Rmail to move
-messages between them.
+message.  You can also create multiple Rmail files (@pxref{Files}) and
+use Rmail to move messages between them (@pxref{Output}).
 
address@hidden message number
address@hidden message number (Rmail)
   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
@@ -72,8 +79,9 @@ with the @kbd{j} key (@pxref{Rmail Motion}).
 become permanent only when you save the file.  You can save it with
 @kbd{s} (@code{rmail-expunge-and-save}), which also expunges deleted
 messages from the file first (@pxref{Rmail Deletion}).  To save the
-file without expunging, use @kbd{C-x C-s}.  Rmail also saves the Rmail
-file after merging new mail from an inbox file (@pxref{Rmail Inbox}).
+file without expunging, use @kbd{C-x C-s}.  Rmail automatically saves
+the Rmail file after merging new mail from an inbox file (@pxref{Rmail
+Inbox}).
 
 @kindex q @r{(Rmail)}
 @findex rmail-quit
@@ -93,9 +101,10 @@ Rmail buffer and its summary without expunging and saving 
the Rmail file.
 @section Scrolling Within a Message
 
   When Rmail displays a message that does not fit on the screen, you
-must scroll through it to read the rest.  You could do this with
address@hidden, @kbd{M-v} and @kbd{M-<}, but in Rmail scrolling is so
-frequent that it deserves to be easier.
+must scroll through it to read the rest.  You could do this with the
+usual scrolling commands: @kbd{C-v}, @kbd{M-v} and @kbd{M-<}
+(@pxref{Scrolling}), but in Rmail scrolling is so frequent that it
+deserves to be easier.
 
 @table @kbd
 @item @key{SPC}
@@ -124,9 +133,10 @@ and @kbd{M-v} (@code{scroll-down-command}) respectively.
   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.
+boundaries of the current message if you have changed them (e.g., by
+editing, @pxref{Rmail Editing}).  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.
 
@@ -168,11 +178,9 @@ message number @var{n} (@code{rmail-show-message}).
 Move to the last message (@code{rmail-last-message}).
 @item <
 Move to the first message (@code{rmail-first-message}).
-
 @item M-s @var{regexp} @key{RET}
 Move to the next message containing a match for @var{regexp}
 (@code{rmail-search}).
-
 @item - M-s @var{regexp} @key{RET}
 Move to the previous message containing a match for @var{regexp}.
 (This is @kbd{M-s} with a negative argument.)
@@ -198,7 +206,8 @@ numeric argument to any of these commands serves as a repeat
 count.
 
   In Rmail, you can specify a numeric argument by typing just the
-digits.  You don't need to type @kbd{C-u} first.
+digits.  You don't need to type @kbd{C-u} first.  You can also specify
+a negative argument by typing just @kbd{-}.
 
 @kindex M-s @r{(Rmail)}
 @findex rmail-search
@@ -228,7 +237,9 @@ 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.
+commands ignore the prefixes typically added to the subjects of
+replies.  These commands are useful for reading all of the messages
+pertaining to the same subject, a.k.a.@: @dfn{thread}.
 
 @kindex j @r{(Rmail)}
 @kindex > @r{(Rmail)}
@@ -331,7 +342,7 @@ adding or removing this attribute.  @xref{Rmail Attributes}.
   When you receive mail locally, the operating system places incoming
 mail for you in a file that we call your @dfn{inbox}.  When you start
 up Rmail, it runs a C program called @command{movemail} to copy the new
-messages from your local inbox into your primary Rmail file, which
+messages from your inbox into your primary Rmail file, which
 also contains other messages saved from previous Rmail sessions.  It
 is in this file that you actually read the mail with Rmail.  This
 operation is called @dfn{getting new mail}.  You can get new mail at
@@ -370,19 +381,12 @@ all into a separate Rmail file avoids the need for 
interlocking in all
 the rest of Rmail, since only Rmail operates on the Rmail file.
 @end enumerate
 
address@hidden FIXME remove this in Emacs 25; won't be relevant any more.
address@hidden Babyl files
 @cindex mbox files
-  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.
address@hidden But this bit should stay in some form.
 @vindex rmail-mbox-format
-(In fact, there are a few slightly different mbox formats.
-The differences are not very important, but you can set the variable
+  Rmail uses the standard @samp{mbox} format, introduced by Unix and
+GNU systems for inbox files, as its internal format of Rmail files.
+(In fact, there are a few slightly different mbox formats.  The
+differences are not very important, but you can set the variable
 @code{rmail-mbox-format} to tell Rmail which form your system uses.
 See that variable's documentation for more details.)
 
@@ -395,7 +399,8 @@ lose mail.  If @code{rmail-preserve-inbox} is 
address@hidden, then
 Rmail does not clear out the inbox file when it gets new mail.  You
 may wish to set this, for example, on a portable computer you use to
 check your mail via POP while traveling, so that your mail will remain
-on the server and you can save it later on your workstation.
+on the server and you can save it later on your main desktop
+workstation.
 
   In some cases, Rmail copies the new mail from the inbox file
 indirectly.  First it runs the @command{movemail} program to move the mail
@@ -427,14 +432,13 @@ into them with explicit Rmail commands (@pxref{Rmail 
Output}).
 @table @kbd
 @item i @var{file} @key{RET}
 Read @var{file} into Emacs and run Rmail on it (@code{rmail-input}).
-
address@hidden
 @item M-x set-rmail-inbox-list @key{RET} @var{files} @key{RET}
 Specify inbox file names for current Rmail file to get mail from.
-
address@hidden ignore
 @item g
 Merge new mail from current Rmail file's inboxes
 (@code{rmail-get-new-mail}).
-
 @item C-u g @var{file} @key{RET}
 Merge new mail from inbox file @var{file}.
 @end table
@@ -468,6 +472,8 @@ item.  These variables also apply to choosing a file for 
output
 (@pxref{Rmail Output}).
 @c FIXME matches only checked when Rmail file first visited?
 
address@hidden This is commented out because we want to advertise 
rmail-inbox-list
address@hidden instead.
 @ignore
 @findex set-rmail-inbox-list
   Each Rmail file can contain a list of inbox file names; you can specify
@@ -492,6 +498,7 @@ current Rmail file from its inboxes.  If the Rmail file has 
no
 inboxes, @kbd{g} does nothing.  The command @kbd{M-x rmail} also
 merges new mail into your primary Rmail file.
 
address@hidden merge mail from file (Rmail)
   To merge mail from a file that is not the usual inbox, give the
 @kbd{g} key a numeric argument, as in @kbd{C-u g}.  Then it reads a file
 name and merges mail from that file.  The inbox file is not deleted or
@@ -518,9 +525,9 @@ file name from the message @samp{Subject} header.
 @end table
 
 @kindex o @r{(Rmail)}
address@hidden rmail-output-as-seen
address@hidden C-o @r{(Rmail)}
 @findex rmail-output
address@hidden C-o @r{(Rmail)}
address@hidden rmail-output-as-seen
   The commands @kbd{o} and @kbd{C-o} copy the current message into a
 specified file, adding it at the end.  The two commands differ mainly
 in how much to copy: @kbd{o} copies the full message headers, even if
@@ -529,7 +536,7 @@ currently displayed and no more.  @xref{Rmail Display}.  In 
addition,
 @kbd{o} converts the message to Babyl format (used by Rmail in Emacs
 version 22 and before) if the file is in Babyl format; @kbd{C-o}
 cannot output to Babyl files at all.
address@hidden FIXME remove BABYL mention in Emacs 25?
address@hidden FIXME remove BABYL mention in some future version?
 
   If the output file is currently visited in an Emacs buffer, the
 output commands append the message to that buffer.  It is up to you to
@@ -542,8 +549,10 @@ file.  You can save the body to a file (excluding the 
message header)
 with the @kbd{w} command (@code{rmail-output-body-to-file}).  Often
 these messages contain the intended file name in the @samp{Subject}
 field, so the @kbd{w} command uses the @samp{Subject} field as the
-default for the output file name.  However, the file name is read using
-the minibuffer, so you can specify a different name if you wish.
+default for the output file name (after replacing some characters that
+cannot be portably used in file names).  However, the file name is
+read using the minibuffer, so you can specify a different name if you
+wish.
 
   You can also output a message to an Rmail file chosen with a menu.
 In the Classify menu, choose the Output Rmail File menu item; then
@@ -564,7 +573,8 @@ appears in the mode line when such a message is current.
   If you like to keep just a single copy of every mail message, set
 the variable @code{rmail-delete-after-output} to @code{t}; then the
 @kbd{o}, @kbd{C-o} and @kbd{w} commands delete the original message
-after copying it.  (You can undelete it afterward if you wish.)
+after copying it.  (You can undelete it afterward if you wish, see
address@hidden Deletion}.)
 
 @vindex rmail-output-file-alist
   The variable @code{rmail-output-file-alist} lets you specify
@@ -582,7 +592,7 @@ default file name for output is @var{name-exp}.  If 
multiple elements
 match the message, the first matching element decides the default file
 name.  The subexpression @var{name-exp} may be a string constant giving
 the file name to use, or more generally it may be any Lisp expression
-that returns a file name as a string.  @code{rmail-output-file-alist}
+that yields a file name as a string.  @code{rmail-output-file-alist}
 applies to both @kbd{o} and @kbd{C-o}.
 
 @vindex rmail-automatic-folder-directives
@@ -641,8 +651,7 @@ Make a summary of all messages containing any of the labels 
@var{labels}
   The @kbd{a} (@code{rmail-add-label}) and @kbd{k}
 (@code{rmail-kill-label}) commands allow you to assign or remove any
 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.
+means to assign or remove the 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.
@@ -717,9 +726,10 @@ standard meaning.
   Rmail has several commands to send outgoing mail.  @xref{Sending
 Mail}, for information on using Message mode, including certain
 features meant to work with Rmail.  What this section documents are
-the special commands of Rmail for entering the mail buffer.  Note that
-the usual keys for sending address@hidden m}, @kbd{C-x 4 m}, and
address@hidden 5 m}---also work normally in Rmail mode.
+the special commands of Rmail for entering the mail buffer used to
+compose the outgoing message.  Note that the usual keys for sending
address@hidden m}, @kbd{C-x 4 m}, and @kbd{C-x 5 m}---also work
+normally in Rmail mode.
 
 @table @kbd
 @item m
@@ -758,9 +768,9 @@ excluded from the @samp{CC} field.  They are also excluded 
from the
 variable is @code{nil}, then the first time you compose a reply it is
 initialized to a default value that matches your own address.
 
-  To omit the @samp{CC} field completely for a particular reply, enter
+  To reply only to the sender of the original message, enter
 the reply command with a numeric argument: @kbd{C-u r} or @kbd{1 r}.
-This means to reply only to the sender of the original message.
+This omits the @samp{CC} field completely for a particular reply.
 
   Once the mail composition buffer has been initialized, editing and
 sending the mail goes as usual (@pxref{Sending Mail}).  You can edit
@@ -930,7 +940,7 @@ commas.
 makes a partial summary mentioning only the messages that have one or
 more recipients matching the regular expression @var{rcpts}.  This is matched
 against the @samp{To}, @samp{From}, and @samp{CC} headers (supply a prefix
-argument to exclude this header).
+argument to exclude the @samp{CC} header).
 
 @kindex C-M-t @r{(Rmail)}
 @findex rmail-summary-by-topic
@@ -976,6 +986,7 @@ different lines.  It doesn't matter what Emacs command you 
use to move
 point; whichever line point is on at the end of the command, that
 message is selected in the Rmail buffer.
 
address@hidden rmail-summary-scroll-between-messages
   Almost all Rmail commands work in the summary buffer as well as in
 the Rmail buffer.  Thus, @kbd{d} in the summary buffer deletes the
 current message, @kbd{u} undeletes, and @kbd{x} expunges.  (However,
@@ -984,8 +995,12 @@ relevant direction, the delete commands go to the first or 
last
 message, rather than staying on the current message.)  @kbd{o} and
 @kbd{C-o} output the current message to a FILE; @kbd{r} starts a reply
 to it; etc.  You can scroll the current message while remaining in the
-summary buffer using @key{SPC} and @key{DEL}.
address@hidden rmail-summary-scroll-between-messages not mentioned.
+summary buffer using @key{SPC} and @key{DEL}.  However, in the summary
+buffer scrolling past the end or the beginning of a message with
address@hidden or @key{DEL} goes, respectively, to the next or previous
+undeleted message.  Customize the
address@hidden option to nil to disable
+scrolling to next/previous messages.
 
 @findex rmail-summary-undelete-many
 @kbd{M-u} (@code{rmail-summary-undelete-many}) undeletes all deleted
@@ -1128,8 +1143,8 @@ biggest to smallest, or in reverse alphabetical order.
 
   The same keys in the summary buffer run similar functions; for
 example, @kbd{C-c C-s C-l} runs @code{rmail-summary-sort-by-lines}.
-Note that these commands always sort the whole Rmail buffer, even if the
-summary is only showing a subset of messages.
+These commands always sort the whole Rmail buffer, even if the summary
+is only showing a subset of messages.
 
   Note that you cannot undo a sort, so you may wish to save the Rmail
 buffer before sorting it.
@@ -1210,14 +1225,15 @@ Toggle between @acronym{MIME} display and raw message
 @end table
 
   Each plain-text @acronym{MIME} part is initially displayed
-immediately after its tagline, as part of the Rmail buffer, while
address@hidden parts of other types are represented only by their
-taglines, with their actual contents hidden.  In either case, you can
-toggle a @acronym{MIME} part between its displayed and hidden
-states by typing @key{RET} anywhere in the part---or anywhere in its
-tagline (except for buttons for other actions, if there are any).  Type
address@hidden (or click with the mouse) to activate a tagline button, and
address@hidden to cycle point between tagline buttons.
+immediately after its tagline, as part of the Rmail buffer (unless the
+message has an @acronym{HTML} part, see below), while @acronym{MIME}
+parts of other types are represented only by their taglines, with
+their actual contents hidden.  In either case, you can toggle a
address@hidden part between its displayed and hidden states by typing
address@hidden anywhere in the part---or anywhere in its tagline (except
+for buttons for other actions, if there are any).  Type @key{RET} (or
+click with the mouse) to activate a tagline button, and @key{TAB} to
+cycle point between tagline buttons.
 
   The @kbd{v} (@code{rmail-mime}) command toggles between the default
 @acronym{MIME} display described above, and a raw display showing
@@ -1322,17 +1338,20 @@ Edit the current message as ordinary text.
 Rmail mode into Rmail Edit mode, another major mode which is nearly the
 same as Text mode.  The mode line indicates this change.
 
address@hidden rmail-cease-edit
address@hidden rmail-abort-edit
   In Rmail Edit mode, letters insert themselves as usual and the Rmail
 commands are not available.  You can edit the message body and header
 fields.  When you are finished editing the message, type @kbd{C-c C-c}
-to switch back to Rmail mode.  Alternatively, you can return to Rmail
-mode but cancel any editing that you have done, by typing @kbd{C-c C-]}.
+(@code{rmail-cease-edit}) to switch back to Rmail mode.
+Alternatively, you can return to Rmail mode but cancel any editing
+that you have done, by typing @kbd{C-c C-]} (@code{rmail-abort-edit}).
 
 @vindex rmail-edit-mode-hook
   Entering Rmail Edit mode runs the hook @code{text-mode-hook}; then
 it runs the hook @code{rmail-edit-mode-hook} (@pxref{Hooks}).
 Returning to ordinary Rmail mode adds the attribute @samp{edited} to
-the message, if you have made any changes in it.
+the message, if you have made any changes in it (@pxref{Rmail Attributes}).
 
 @node Rmail Digest
 @section Digest Messages
@@ -1384,9 +1403,9 @@ version.  There are two versions of the 
@command{movemail} program: the
 GNU Mailutils version (@pxref{movemail,,,mailutils,GNU mailutils}),
 and an Emacs-specific version that is built and installed unless Emacs
 was configured @option{--with-mailutils} in effect.
-The two @command{mailtool} versions support the same
+The two @command{movemail} versions support the same
 command line syntax and the same basic subset of options.  However, the
-Mailutils version offers additional features.
+Mailutils version offers additional features and is more secure.
 
   The Emacs version of @command{movemail} can retrieve mail from the
 usual Unix mailbox formats.  @strong{Warning}: Although it can also use the 
POP3
@@ -1451,8 +1470,8 @@ denotes the name of @code{maildir} mailbox, e.g.,
 @code{maildir:///mail/inbox}.
 
 @item file
-Any local mailbox format.  Its actual format is detected automatically
-by @command{movemail}.
+Any local file in mailbox format.  Its actual format is detected
+automatically by @command{movemail}.
 
 @item pop
 @itemx pops
@@ -1495,19 +1514,19 @@ listed in @code{rmail-movemail-search-path}, then in 
@code{exec-path}
 @section Retrieving Mail from Remote Mailboxes
 @pindex movemail
 
-  Some sites use a method called POP for accessing users' inbox data
+  Some sites use a method called POP3 for accessing users' inbox data
 instead of storing the data in inbox files.  The Mailutils
address@hidden by default supports POP with TLS encryption.
address@hidden:} Although the @command{Emacs movemail} supports POP,
address@hidden by default supports POP3 with TLS encryption.
address@hidden:} Although the @command{Emacs movemail} supports POP3,
 its use for this is not recommended since it does not support encrypted
 connections---the Mailutils version does.
 Both versions of @command{movemail} work only with POP3, not with
-older versions of POP.
+older versions of POP3.
 
 @cindex @env{MAILHOST} environment variable
address@hidden POP mailboxes
address@hidden POP3 mailboxes
   You can specify
-a POP inbox by using a POP @dfn{URL} (@pxref{Movemail}).  A POP
+a POP3 inbox by using a POP3 @dfn{URL} (@pxref{Movemail}).  A POP3
 @acronym{URL} is of the form
 @samp{pop://@var{username}@@@var{hostname}:@var{port}}, where
 @var{hostname} and @var{port} are the host name (or IP address)
@@ -1522,11 +1541,11 @@ If using Mailutils @command{movemail}, you may wish to 
use
 @samp{pops} in place of @samp{pop}.
 
   For backward compatibility, Rmail also supports an alternative way of
-specifying remote POP mailboxes.  Specifying an inbox name in the form
+specifying remote POP3 mailboxes.  Specifying an inbox name in the form
 @samp{po:@var{username}:@var{hostname}:@var{port}} is equivalent to
 @samp{pop://@var{username}@@@var{hostname}:@var{port}}.  If you omit the
 @var{:hostname} part, the @env{MAILHOST} environment variable specifies
-the machine on which to look for the POP server.
+the machine on which to look for the POP3 server.
 
 @cindex IMAP mailboxes
   Another method for accessing remote mailboxes is address@hidden  This method 
is
@@ -1561,15 +1580,15 @@ set the variable @code{rmail-movemail-flags} a list of 
the flags you
 wish to use.  Do not use this variable to pass the @samp{-p} flag to
 preserve your inbox contents; use @code{rmail-preserve-inbox} instead.
 
address@hidden Kerberos POP authentication
address@hidden Kerberos POP3 authentication
   The @command{movemail} program installed at your site may support
 Kerberos authentication.  If it is supported, it is used by default
-whenever you attempt to retrieve POP mail when
+whenever you attempt to retrieve POP3 mail when
 @code{rmail-remote-password} and @code{rmail-remote-password-required}
 are unset.
 
address@hidden reverse order in POP inboxes
-  Some POP servers store messages in reverse order.  If your server does
address@hidden reverse order in POP3 inboxes
+  Some POP3 servers store messages in reverse order.  If your server does
 this, and you would rather read your mail in the order in which it was
 received, you can tell @command{movemail} to reverse the order of
 downloaded messages by adding the @samp{-r} flag to