X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/d8ad4d3ff9dcea9c581d72e1e9ec292ea18673b1..dd6346e00c0910b16f1bd195e5e94f6ac1d696ee:/doc/emacs/rmail.texi diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi index 23255e65c7..6e2a60b637 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi @@ -1,6 +1,6 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2012 -@c Free Software Foundation, Inc. +@c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2015 Free Software +@c Foundation, Inc. @c See file emacs.texi for copying conditions. @node Rmail @chapter Reading Mail with Rmail @@ -82,7 +82,7 @@ file after merging new mail from an inbox file (@pxref{Rmail Inbox}). You can exit Rmail with @kbd{q} (@code{rmail-quit}); this expunges and saves the Rmail file, then buries the Rmail buffer as well as its summary buffer, if present (@pxref{Rmail Summary}). But there is no -need to ``exit'' formally. If you switch from Rmail to editing in +need to exit formally. If you switch from Rmail to editing in other buffers, and never switch back, you have exited. Just make sure to save the Rmail file eventually (like any other file you have changed). @kbd{C-x s} is a suitable way to do this (@pxref{Save @@ -101,6 +101,7 @@ frequent that it deserves to be easier. @item @key{SPC} Scroll forward (@code{scroll-up-command}). @item @key{DEL} +@itemx S-@key{SPC} Scroll backward (@code{scroll-down-command}). @item . Scroll to start of message (@code{rmail-beginning-of-message}). @@ -110,10 +111,11 @@ Scroll to end of message (@code{rmail-end-of-message}). @kindex SPC @r{(Rmail)} @kindex DEL @r{(Rmail)} +@kindex S-SPC @r{(Rmail)} Since the most common thing to do while reading a message is to scroll through it by screenfuls, Rmail makes @key{SPC} and @key{DEL} -do the same as @kbd{C-v} (@code{scroll-up-command}) and @kbd{M-v} -(@code{scroll-down-command}) respectively. +(or @kbd{S-@key{SPC}}) do the same as @kbd{C-v} (@code{scroll-up-command}) +and @kbd{M-v} (@code{scroll-down-command}) respectively. @kindex . @r{(Rmail)} @kindex / @r{(Rmail)} @@ -367,12 +369,20 @@ the rest of Rmail, since only Rmail operates on the Rmail file. @end enumerate @c FIXME remove this in Emacs 25; won't be relevant any more. +@cindex 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. +@c 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 +@code{rmail-mbox-format} to tell Rmail which form your system uses. +See that variable's documentation for more details.) @vindex rmail-preserve-inbox When getting new mail, Rmail first copies the new mail from the @@ -743,7 +753,7 @@ in replies, using the variable @code{mail-dont-reply-to-names}. Its value should be a regular expression; any recipients that match are excluded from the @samp{CC} field. They are also excluded from the @samp{To} field, unless this would leave the field empty. If this -variable is 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. To omit the @samp{CC} field completely for a particular reply, enter @@ -784,7 +794,7 @@ message as the text, and a subject of the form @code{[@var{from}: @var{subject}]}, where @var{from} and @var{subject} are the sender and subject of the original message. All you have to do is fill in the recipients and send. When you forward a message, recipients get a -message which is ``from'' you, and which has the original message in +message which is from you, and which has the original message in its contents. @vindex rmail-enable-mime-composing @@ -807,7 +817,7 @@ following the current one. @findex rmail-resend @dfn{Resending} is an alternative similar to forwarding; the -difference is that resending sends a message that is ``from'' 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 @@ -916,8 +926,7 @@ commas. @findex rmail-summary-by-recipients @kbd{C-M-r @var{rcpts} @key{RET}} (@code{rmail-summary-by-recipients}) makes a partial summary mentioning only the messages that have one or -more recipients matching the regular expression @var{rcpts}. You can -use commas to separate multiple regular expressions. These are 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 argument to exclude this header). @@ -925,9 +934,8 @@ argument to exclude this header). @findex rmail-summary-by-topic @kbd{C-M-t @var{topic} @key{RET}} (@code{rmail-summary-by-topic}) makes a partial summary mentioning only the messages whose subjects have -a match for the regular expression @var{topic}. You can use commas to -separate multiple regular expressions. With a prefix argument, the -match is against the whole message, not just the subject. +a match for the regular expression @var{topic}. With a prefix argument, +the match is against the whole message, not just the subject. @kindex C-M-s @r{(Rmail)} @findex rmail-summary-by-regexp @@ -940,8 +948,7 @@ expression @var{regexp}. @findex rmail-summary-by-senders @kbd{C-M-f @var{senders} @key{RET}} (@code{rmail-summary-by-senders}) makes a partial summary that mentions only the messages whose @samp{From} -fields match the regular expression @var{senders}. You can use commas to -separate multiple regular expressions. +fields match the regular expression @var{senders}. Note that there is only one summary buffer for any Rmail buffer; making any kind of summary discards any previous summary. @@ -952,7 +959,7 @@ making any kind of summary discards any previous summary. use for the summary window. The variable @code{rmail-summary-line-count-flag} controls whether the summary line for a message should include the line count of the message. Setting -this option to nil might speed up the generation of summaries. +this option to @code{nil} might speed up the generation of summaries. @node Rmail Summary Edit @subsection Editing in Summaries @@ -994,10 +1001,10 @@ Here is a list of these commands: @table @kbd @item n -Move to next line, skipping lines saying `deleted', and select its +Move to next line, skipping lines saying ``deleted'', and select its message (@code{rmail-summary-next-msg}). @item p -Move to previous line, skipping lines saying `deleted', and select +Move to previous line, skipping lines saying ``deleted'', and select its message (@code{rmail-summary-previous-msg}). @item M-n Move to next line and select its message (@code{rmail-summary-next-all}). @@ -1206,14 +1213,14 @@ Toggle between @acronym{MIME} display and raw message immediately after its tagline, as part of the Rmail buffer, 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 @acronym{MIME} part between its ``displayed'' and ``hidden'' +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 @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 +@acronym{MIME} display described above, and a raw display showing the undecoded @acronym{MIME} data. With a prefix argument, this command toggles the display of only an entity at point. @@ -1274,6 +1281,17 @@ It reads the name of a coding system, and then redecodes the message using the coding system you specified. If you specified the right coding system, the result should be readable. +@vindex rmail-file-coding-system + When you get new mail in Rmail, each message is translated +automatically from the coding system it is written in, as if it were a +separate file. This uses the priority list of coding systems that you +have specified. If a MIME message specifies a character set, Rmail +obeys that specification. For reading and saving Rmail files +themselves, Emacs uses the coding system specified by the variable +@code{rmail-file-coding-system}. The default value is @code{nil}, +which means that Rmail files are not translated (they are read and +written in the Emacs internal character code). + @node Rmail Editing @section Editing Within a Message @@ -1354,8 +1372,8 @@ which applies the code when displaying the text. your Rmail file (@pxref{Rmail Inbox}). When loaded for the first time, Rmail attempts to locate the @code{movemail} program and determine its version. There are two versions of the @code{movemail} program: the -native one, shipped with GNU Emacs (the ``emacs version'') and the one -included in GNU mailutils (the ``mailutils version'', +native one, shipped with GNU Emacs (the Emacs version) and the one +included in GNU mailutils (the mailutils version, @pxref{movemail,,,mailutils,GNU mailutils}). They support the same command line syntax and the same basic subset of options. However, the Mailutils version offers additional features. @@ -1370,6 +1388,7 @@ mailboxes, etc. It is able to access remote mailboxes using the POP3 or IMAP4 protocol, and can retrieve mail from them using a TLS encrypted channel. It also accepts mailbox arguments in @acronym{URL} form. The detailed description of mailbox @acronym{URL}s can be found +@c Note this node seems to be missing in some versions of mailutils.info? in @ref{URL,,,mailutils,Mailbox URL Formats}. In short, a @acronym{URL} is: @@ -1470,7 +1489,7 @@ versions of POP. @cindex POP mailboxes No matter which flavor of @code{movemail} you use, you can specify a POP inbox by using a POP @dfn{URL} (@pxref{Movemail}). A POP -@acronym{URL} is a ``file name'' of the form +@acronym{URL} is of the form @samp{pop://@var{username}@@@var{hostname}}, where @var{hostname} is the host name or IP address of the remote mail server and @var{username} is the user name on that server.