procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

More proofreading of the Emacs manual

Browse source 
* 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".
This commit is contained in:
Eli Zaretskii 2018-03-19 17:18:47 +02:00
parent a776ce7be6
commit fb3dc0e8aa
2 changed files with 107 additions and 80 deletions
Download patch file Download diff file Expand all files Collapse all files

14
doc/emacs/macos.texi
View file

@ -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, was an application interface released by NeXT Inc.@: during the 1980s,
of which Cocoa is a direct descendant. Apart from Cocoa, there is of which Cocoa is a direct descendant. Apart from Cocoa, there is
another NeXTstep-style system: GNUstep, which is free software. As of 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. Support}), but we hope to improve it in the future.
@menu @menu
@ -34,6 +34,7 @@ Support}), but we hope to improve it in the future.
@node Mac / GNUstep Basics @node Mac / GNUstep Basics
@section Basic Emacs usage under macOS and GNUstep @section Basic Emacs usage under macOS and GNUstep
@cindex modifier keys (macOS)
By default, the @key{Alt} and @key{Option} keys are the same as 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 @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 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 behave like the left-hand keys if the value is @code{left} (the
default). A value of @code{control}, @code{meta}, @code{alt}, default). A value of @code{control}, @code{meta}, @code{alt},
@code{super}, or @code{hyper} makes them behave like the corresponding @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 @code{ns-alternate-modifier}; a value of @code{none} tells Emacs to
ignore them, in which case you get the default behavior of macOS ignore them, in which case you get the default behavior of macOS
accentuation system from the right option key. 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 sequences, such as @kbd{C-x C-f}, Emacs uses the minibuffer to read
file names. file names.
@cindex copy/paste to/from primary selection (macOS)
On GNUstep, in an X-windows environment you need to use @kbd{Cmd-c} 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 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 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 How is this any different to launching from a window manager menu
@c in GNU/Linux? These are sometimes not login shells either. @c in GNU/Linux? These are sometimes not login shells either.
@cindex environment variables (macOS)
Many programs which may run under Emacs, like latex or man, depend on the 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 settings of environment variables. If Emacs is launched from the shell, it
will automatically inherit these environment variables and its subprocesses 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 @subsection Font and Color Panels
@findex ns-popup-font-panel
The standard Mac / GNUstep font and color panels are accessible via The standard Mac / GNUstep font and color panels are accessible via
Lisp commands. The Font Panel may be accessed with @kbd{M-x 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 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 To make the setting permanent, use @samp{Save Options} in the
@c Options menu, or run @code{menu-bar-options-save}. @c Options menu, or run @code{menu-bar-options-save}.
@findex ns-popup-color-panel
You can bring up a color panel with @kbd{M-x ns-popup-color-panel} and 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 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 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}. @kbd{M-x list-faces-display}.
@cindex Core Text, on macOS @cindex Core Text, on macOS
@cindex font backend, on macOS
In macOS, Emacs uses a Core Text based font backend In macOS, Emacs uses a Core Text based font backend
by default. If you prefer the older font style, enter the following by default. If you prefer the older font style, enter the following
at the command-line before starting Emacs: at the command-line before starting Emacs:
@ -130,6 +136,7 @@ at the command-line before starting Emacs:
@node Mac / GNUstep Events @node Mac / GNUstep Events
@section Windowing System Events under macOS / GNUstep @section Windowing System Events under macOS / GNUstep
@cindex events on macOS
Nextstep applications receive a number of special events which have Nextstep applications receive a number of special events which have
no X equivalent. These are sent as specially defined key events, which 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, changing the variable @code{ns-pop-up-frames}. Its default value,
@samp{fresh}, is what we have just described. A value of @code{t} @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 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 @item ns-open-temp-file
This event occurs when another application requests that Emacs open a 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. The default behavior is to save all file-visiting buffers.
@end table @end table
@cindex using Nextstep services (macOS)
Emacs also allows users to make use of Nextstep services, via a set 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 of commands whose names begin with @samp{ns-service-} and end with the
name of the service. Type @kbd{M-x ns-service-@key{TAB}} to name of the service. Type @kbd{M-x ns-service-@key{TAB}} to

173
doc/emacs/rmail.texi
View file

@ -14,6 +14,12 @@
you receive. Rmail stores mail messages in files called Rmail files. 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, 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. 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 @menu
* Basic: Rmail Basics. Basic concepts of Rmail, and simple use. * Basic: Rmail Basics. Basic concepts of Rmail, and simple use.
* Scroll: Rmail Scrolling. Scrolling through a message. * 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 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. @code{rmail-file-name} specifies the name of the primary Rmail file.
@cindex current message (Rmail)
Rmail displays only one message in the Rmail file at a time. Rmail displays only one message in the Rmail file at a time.
The message that is shown is called the @dfn{current message}. Rmail The message that is shown is called the @dfn{current message}. Rmail
mode's special commands can do such things as delete the current 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, 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 message. You can also create multiple Rmail files (@pxref{Files}) and
messages between them. use Rmail to move messages between them (@pxref{Output}).
@cindex message number @cindex message number (Rmail)
Within the Rmail file, messages are normally arranged sequentially in Within the Rmail file, messages are normally arranged sequentially in
order of receipt; you can specify other ways to sort them (@pxref{Rmail order of receipt; you can specify other ways to sort them (@pxref{Rmail
Sorting}). Messages are identified by consecutive integers which are 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 become permanent only when you save the file. You can save it with
@kbd{s} (@code{rmail-expunge-and-save}), which also expunges deleted @kbd{s} (@code{rmail-expunge-and-save}), which also expunges deleted
messages from the file first (@pxref{Rmail Deletion}). To save the 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 without expunging, use @kbd{C-x C-s}. Rmail automatically saves
file after merging new mail from an inbox file (@pxref{Rmail Inbox}). the Rmail file after merging new mail from an inbox file (@pxref{Rmail
Inbox}).
@kindex q @r{(Rmail)} @kindex q @r{(Rmail)}
@findex rmail-quit @findex rmail-quit
@ -93,9 +101,10 @@ Rmail buffer and its summary without expunging and saving the Rmail file.
@section Scrolling Within a Message @section Scrolling Within a Message
When Rmail displays a message that does not fit on the screen, you 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 must scroll through it to read the rest. You could do this with the
@kbd{C-v}, @kbd{M-v} and @kbd{M-<}, but in Rmail scrolling is so usual scrolling commands: @kbd{C-v}, @kbd{M-v} and @kbd{M-<}
frequent that it deserves to be easier. (@pxref{Scrolling}), but in Rmail scrolling is so frequent that it
deserves to be easier.
@table @kbd @table @kbd
@item @key{SPC} @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 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-<}: 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 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, boundaries of the current message if you have changed them (e.g., by
the command @kbd{/} (@code{rmail-end-of-message}) scrolls forward to the end editing, @pxref{Rmail Editing}). Similarly, the command @kbd{/}
of the selected message. (@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 The comment about buffer boundaries is still true in mbox Rmail, if
@c less likely to be relevant. @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}). Move to the last message (@code{rmail-last-message}).
@item < @item <
Move to the first message (@code{rmail-first-message}). Move to the first message (@code{rmail-first-message}).
@item M-s @var{regexp} @key{RET} @item M-s @var{regexp} @key{RET}
Move to the next message containing a match for @var{regexp} Move to the next message containing a match for @var{regexp}
(@code{rmail-search}). (@code{rmail-search}).
@item - M-s @var{regexp} @key{RET} @item - M-s @var{regexp} @key{RET}
Move to the previous message containing a match for @var{regexp}. Move to the previous message containing a match for @var{regexp}.
(This is @kbd{M-s} with a negative argument.) (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. count.
In Rmail, you can specify a numeric argument by typing just the 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)} @kindex M-s @r{(Rmail)}
@findex rmail-search @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 argument serves as a repeat count. With a negative argument, this
command moves backward, acting like @kbd{C-c C-p} command moves backward, acting like @kbd{C-c C-p}
(@code{rmail-previous-same-subject}). When comparing subjects, these (@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 j @r{(Rmail)}
@kindex > @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 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 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 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 also contains other messages saved from previous Rmail sessions. It
is in this file that you actually read the mail with Rmail. This 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 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. the rest of Rmail, since only Rmail operates on the Rmail file.
@end enumerate @end enumerate
@c FIXME remove this in Emacs 25; won't be relevant any more.
@cindex Babyl files
@cindex mbox 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.
@c But this bit should stay in some form.
@vindex rmail-mbox-format @vindex rmail-mbox-format
(In fact, there are a few slightly different mbox formats. Rmail uses the standard @samp{mbox} format, introduced by Unix and
The differences are not very important, but you can set the variable 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. @code{rmail-mbox-format} to tell Rmail which form your system uses.
See that variable's documentation for more details.) See that variable's documentation for more details.)
@ -395,7 +399,8 @@ lose mail. If @code{rmail-preserve-inbox} is non-@code{nil}, then
Rmail does not clear out the inbox file when it gets new mail. You 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 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 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 In some cases, Rmail copies the new mail from the inbox file
indirectly. First it runs the @command{movemail} program to move the mail 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 @table @kbd
@item i @var{file} @key{RET} @item i @var{file} @key{RET}
Read @var{file} into Emacs and run Rmail on it (@code{rmail-input}). Read @var{file} into Emacs and run Rmail on it (@code{rmail-input}).
@ignore
@item M-x set-rmail-inbox-list @key{RET} @var{files} @key{RET} @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. Specify inbox file names for current Rmail file to get mail from.
@end ignore
@item g @item g
Merge new mail from current Rmail file's inboxes Merge new mail from current Rmail file's inboxes
(@code{rmail-get-new-mail}). (@code{rmail-get-new-mail}).
@item C-u g @var{file} @key{RET} @item C-u g @var{file} @key{RET}
Merge new mail from inbox file @var{file}. Merge new mail from inbox file @var{file}.
@end table @end table
@ -468,6 +472,8 @@ item. These variables also apply to choosing a file for output
(@pxref{Rmail Output}). (@pxref{Rmail Output}).
@c FIXME matches only checked when Rmail file first visited? @c FIXME matches only checked when Rmail file first visited?
@c This is commented out because we want to advertise rmail-inbox-list
@c instead.
@ignore @ignore
@findex set-rmail-inbox-list @findex set-rmail-inbox-list
Each Rmail file can contain a list of inbox file names; you can specify 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 inboxes, @kbd{g} does nothing. The command @kbd{M-x rmail} also
merges new mail into your primary Rmail file. merges new mail into your primary Rmail file.
@cindex merge mail from file (Rmail)
To merge mail from a file that is not the usual inbox, give the 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 @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 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 @end table
@kindex o @r{(Rmail)} @kindex o @r{(Rmail)}
@findex rmail-output-as-seen
@kindex C-o @r{(Rmail)}
@findex rmail-output @findex rmail-output
@kindex C-o @r{(Rmail)}
@findex rmail-output-as-seen
The commands @kbd{o} and @kbd{C-o} copy the current message into a 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 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 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 @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} version 22 and before) if the file is in Babyl format; @kbd{C-o}
cannot output to Babyl files at all. cannot output to Babyl files at all.
@c FIXME remove BABYL mention in Emacs 25? @c FIXME remove BABYL mention in some future version?
If the output file is currently visited in an Emacs buffer, the 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 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 with the @kbd{w} command (@code{rmail-output-body-to-file}). Often
these messages contain the intended file name in the @samp{Subject} these messages contain the intended file name in the @samp{Subject}
field, so the @kbd{w} command uses the @samp{Subject} field as the 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 default for the output file name (after replacing some characters that
the minibuffer, so you can specify a different name if you wish. 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. 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 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 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 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 @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
@ref{Rmail Deletion}.)
@vindex rmail-output-file-alist @vindex rmail-output-file-alist
The variable @code{rmail-output-file-alist} lets you specify 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 match the message, the first matching element decides the default file
name. The subexpression @var{name-exp} may be a string constant giving 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 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}. applies to both @kbd{o} and @kbd{C-o}.
@vindex rmail-automatic-folder-directives @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} The @kbd{a} (@code{rmail-add-label}) and @kbd{k}
(@code{rmail-kill-label}) commands allow you to assign or remove any (@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 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 means to assign or remove the label most recently assigned or removed.
removed.
Once you have given messages labels to classify them as you wish, there 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. 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 Rmail has several commands to send outgoing mail. @xref{Sending
Mail}, for information on using Message mode, including certain Mail}, for information on using Message mode, including certain
features meant to work with Rmail. What this section documents are features meant to work with Rmail. What this section documents are
the special commands of Rmail for entering the mail buffer. Note that the special commands of Rmail for entering the mail buffer used to
the usual keys for sending mail---@kbd{C-x m}, @kbd{C-x 4 m}, and compose the outgoing message. Note that the usual keys for sending
@kbd{C-x 5 m}---also work normally in Rmail mode. mail---@kbd{C-x m}, @kbd{C-x 4 m}, and @kbd{C-x 5 m}---also work
normally in Rmail mode.
@table @kbd @table @kbd
@item m @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 variable is @code{nil}, then the first time you compose a reply it is
initialized to a default value that matches your own address. 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}. 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 Once the mail composition buffer has been initialized, editing and
sending the mail goes as usual (@pxref{Sending Mail}). You can edit 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 makes a partial summary mentioning only the messages that have one or
more recipients matching the regular expression @var{rcpts}. This is matched more recipients matching the regular expression @var{rcpts}. This is matched
against the @samp{To}, @samp{From}, and @samp{CC} headers (supply a prefix 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)} @kindex C-M-t @r{(Rmail)}
@findex rmail-summary-by-topic @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 point; whichever line point is on at the end of the command, that
message is selected in the Rmail buffer. message is selected in the Rmail buffer.
@vindex rmail-summary-scroll-between-messages
Almost all Rmail commands work in the summary buffer as well as in 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 the Rmail buffer. Thus, @kbd{d} in the summary buffer deletes the
current message, @kbd{u} undeletes, and @kbd{x} expunges. (However, 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 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 @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 to it; etc. You can scroll the current message while remaining in the
summary buffer using @key{SPC} and @key{DEL}. summary buffer using @key{SPC} and @key{DEL}. However, in the summary
@c rmail-summary-scroll-between-messages not mentioned. buffer scrolling past the end or the beginning of a message with
@key{SPC} or @key{DEL} goes, respectively, to the next or previous
undeleted message. Customize the
@code{rmail-summary-scroll-between-messages} option to nil to disable
scrolling to next/previous messages.
@findex rmail-summary-undelete-many @findex rmail-summary-undelete-many
@kbd{M-u} (@code{rmail-summary-undelete-many}) undeletes all deleted @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 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}. 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 These commands always sort the whole Rmail buffer, even if the summary
summary is only showing a subset of messages. is only showing a subset of messages.
Note that you cannot undo a sort, so you may wish to save the Rmail Note that you cannot undo a sort, so you may wish to save the Rmail
buffer before sorting it. buffer before sorting it.
@ -1210,14 +1225,15 @@ Toggle between @acronym{MIME} display and raw message
@end table @end table
Each plain-text @acronym{MIME} part is initially displayed Each plain-text @acronym{MIME} part is initially displayed
immediately after its tagline, as part of the Rmail buffer, while immediately after its tagline, as part of the Rmail buffer (unless the
@acronym{MIME} parts of other types are represented only by their message has an @acronym{HTML} part, see below), while @acronym{MIME}
taglines, with their actual contents hidden. In either case, you can parts of other types are represented only by their taglines, with
toggle a @acronym{MIME} part between its displayed and hidden their actual contents hidden. In either case, you can toggle a
states by typing @key{RET} anywhere in the part---or anywhere in its @acronym{MIME} part between its displayed and hidden states by typing
tagline (except for buttons for other actions, if there are any). Type @key{RET} anywhere in the part---or anywhere in its tagline (except
@key{RET} (or click with the mouse) to activate a tagline button, and for buttons for other actions, if there are any). Type @key{RET} (or
@key{TAB} to cycle point between tagline buttons. 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 The @kbd{v} (@code{rmail-mime}) command toggles between the default
@acronym{MIME} display described above, and a raw display showing @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 Rmail mode into Rmail Edit mode, another major mode which is nearly the
same as Text mode. The mode line indicates this change. same as Text mode. The mode line indicates this change.
@findex rmail-cease-edit
@findex rmail-abort-edit
In Rmail Edit mode, letters insert themselves as usual and the Rmail In Rmail Edit mode, letters insert themselves as usual and the Rmail
commands are not available. You can edit the message body and header 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} 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 (@code{rmail-cease-edit}) to switch back to Rmail mode.
mode but cancel any editing that you have done, by typing @kbd{C-c C-]}. 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 @vindex rmail-edit-mode-hook
Entering Rmail Edit mode runs the hook @code{text-mode-hook}; then Entering Rmail Edit mode runs the hook @code{text-mode-hook}; then
it runs the hook @code{rmail-edit-mode-hook} (@pxref{Hooks}). it runs the hook @code{rmail-edit-mode-hook} (@pxref{Hooks}).
Returning to ordinary Rmail mode adds the attribute @samp{edited} to 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 @node Rmail Digest
@section Digest Messages @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}), GNU Mailutils version (@pxref{movemail,,,mailutils,GNU mailutils}),
and an Emacs-specific version that is built and installed unless Emacs and an Emacs-specific version that is built and installed unless Emacs
was configured @option{--with-mailutils} in effect. 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 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 The Emacs version of @command{movemail} can retrieve mail from the
usual Unix mailbox formats. @strong{Warning}: Although it can also use the POP3 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}. @code{maildir:///mail/inbox}.
@item file @item file
Any local mailbox format. Its actual format is detected automatically Any local file in mailbox format. Its actual format is detected
by @command{movemail}. automatically by @command{movemail}.
@item pop @item pop
@itemx pops @itemx pops
@ -1495,19 +1514,19 @@ listed in @code{rmail-movemail-search-path}, then in @code{exec-path}
@section Retrieving Mail from Remote Mailboxes @section Retrieving Mail from Remote Mailboxes
@pindex movemail @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 instead of storing the data in inbox files. The Mailutils
@command{movemail} by default supports POP with TLS encryption. @command{movemail} by default supports POP3 with TLS encryption.
@strong{Warning:} Although the @command{Emacs movemail} supports POP, @strong{Warning:} Although the @command{Emacs movemail} supports POP3,
its use for this is not recommended since it does not support encrypted its use for this is not recommended since it does not support encrypted
connections---the Mailutils version does. connections---the Mailutils version does.
Both versions of @command{movemail} work only with POP3, not with Both versions of @command{movemail} work only with POP3, not with
older versions of POP. older versions of POP3.
@cindex @env{MAILHOST} environment variable @cindex @env{MAILHOST} environment variable
@cindex POP mailboxes @cindex POP3 mailboxes
You can specify 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 @acronym{URL} is of the form
@samp{pop://@var{username}@@@var{hostname}:@var{port}}, where @samp{pop://@var{username}@@@var{hostname}:@var{port}}, where
@var{hostname} and @var{port} are the host name (or IP address) @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}. @samp{pops} in place of @samp{pop}.
For backward compatibility, Rmail also supports an alternative way of 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{po:@var{username}:@var{hostname}:@var{port}} is equivalent to
@samp{pop://@var{username}@@@var{hostname}:@var{port}}. If you omit the @samp{pop://@var{username}@@@var{hostname}:@var{port}}. If you omit the
@var{:hostname} part, the @env{MAILHOST} environment variable specifies @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 @cindex IMAP mailboxes
Another method for accessing remote mailboxes is IMAP@. This method is Another method for accessing remote mailboxes is IMAP@. 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 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. preserve your inbox contents; use @code{rmail-preserve-inbox} instead.
@cindex Kerberos POP authentication @cindex Kerberos POP3 authentication
The @command{movemail} program installed at your site may support The @command{movemail} program installed at your site may support
Kerberos authentication. If it is supported, it is used by default 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} @code{rmail-remote-password} and @code{rmail-remote-password-required}
are unset. are unset.
@cindex reverse order in POP inboxes @cindex reverse order in POP3 inboxes
Some POP servers store messages in reverse order. If your server does 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 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 received, you can tell @command{movemail} to reverse the order of
downloaded messages by adding the @samp{-r} flag to downloaded messages by adding the @samp{-r} flag to