Commit 89dc29d9 authored by Chong Yidong's avatar Chong Yidong
Browse files

* rmail.texi (Rmail Display): Edit for grammar and conciseness.

parent 0bf6f919
2010-12-30 Chong Yidong <cyd@stupidchicken.com>
* rmail.texi (Rmail Display): Edit for grammar and conciseness.
2010-12-27 Kenichi Handa <handa@m17n.org> 2010-12-27 Kenichi Handa <handa@m17n.org>
* rmail.texi (Rmail Display): Describe new features of Rmail in Info. * rmail.texi (Rmail Display): Describe new features of Rmail in Info.
......
...@@ -1101,108 +1101,101 @@ buffer before sorting it. ...@@ -1101,108 +1101,101 @@ buffer before sorting it.
@node Rmail Display @node Rmail Display
@section Display of Messages @section Display of Messages
Rmail reformats the header of each message before displaying it for This section describes how Rmail displays mail headers,
the first time. Reformatting hides uninteresting header fields to @acronym{MIME} sections and attachments, and URLs.
reduce clutter. You can use the @kbd{t} command to show the entire
header or to repeat the header reformatting operation.
@table @kbd @table @kbd
@item t @item t
Toggle display of complete header (@code{rmail-toggle-header}). Toggle display of complete header (@code{rmail-toggle-header}).
@end table @end table
@vindex rmail-ignored-headers
@vindex rmail-nonignored-headers
Reformatting the header involves deleting most header fields, on the
grounds that they are not interesting. The variable
@code{rmail-ignored-headers} holds a regular expression that specifies
which header fields to hide in this way---if it matches the beginning
of a header field, that whole field is hidden. However, the variable
@code{rmail-nonignored-headers} provides a further override: a header
matching that regular expression is shown even if it matches
@code{rmail-ignored-headers} too.
@vindex rmail-displayed-headers
As an alternative to the previous two variables, you can set
@code{rmail-displayed-headers} instead. If non-@code{nil}, this should
be a regular expression specifying which headers to display.
@kindex t @r{(Rmail)} @kindex t @r{(Rmail)}
@findex rmail-toggle-header @findex rmail-toggle-header
To see the complete, original header, use the @kbd{t} command Before displaying each message for the first time, Rmail reformats
(@code{rmail-toggle-header}). This discards the reformatted headers of its header, hiding uninteresting header fields to reduce clutter. The
the current message and displays it with the original header. Repeating @kbd{t} (@code{rmail-toggle-header}) command toggles this, switching
@kbd{t} reformats the message again, which shows only the interesting between showing the reformatted header fields and showing the
headers according to the current values of the above variables. complete, original header. With a positive prefix argument, the
Selecting the message again also reformats it if necessary. command shows the reformatted header; with a zero or negative prefix
argument, it shows the full header. Selecting the message again also
reformats it if necessary.
When the @kbd{t} command has a prefix argument, a positive argument @vindex rmail-ignored-headers
means to show the reformatted header, and a zero or negative argument @vindex rmail-displayed-headers
means to show the full header. @vindex rmail-nonignored-headers
The variable @code{rmail-ignored-headers} holds a regular expression
specifying the header fields to hide; any matching header line will be
hidden. The variable @code{rmail-nonignored-headers} overrides this:
any header field matching that regular expression is shown even if it
matches @code{rmail-ignored-headers} too. The variable
@code{rmail-displayed-headers} is an alternative to these two
variables; if non-@code{nil}, this should be a regular expression
specifying which headers to display (the default is @code{nil}).
@vindex rmail-highlighted-headers @vindex rmail-highlighted-headers
Rmail highlights certain header fields that are especially Rmail highlights certain header fields that are especially
interesting---by default, the @samp{From} and @samp{Subject} fields. interesting---by default, the @samp{From} and @samp{Subject} fields.
The variable @code{rmail-highlighted-headers} holds a regular expression This highlighting uses the @code{rmail-highlight} face. The variable
that specifies the header fields to highlight; if it matches the @code{rmail-highlighted-headers} holds a regular expression specifying
beginning of a header field, that whole field is highlighted. To turn the header fields to highlight; if it matches the beginning of a
off this feature, set @code{rmail-highlighted-headers} to @code{nil}. header field, that whole field is highlighted. To disable this
Customize the face @code{rmail-highlight} to adjust the style of the feature, set @code{rmail-highlighted-headers} to @code{nil}.
highlighting.
You can highlight and activate URLs in incoming messages using
Goto Address mode:
@c FIXME goto-addr.el commentary says to use goto-address instead.
@smallexample
(add-hook 'rmail-show-message-hook (lambda () (goto-address-mode 1)))
@end smallexample
@noindent
Then you can browse these URLs by clicking on them with @kbd{Mouse-2}
(or @kbd{Mouse-1} quickly) or by moving to one and typing @kbd{C-c
@key{RET}}. @xref{Goto Address mode, Activating URLs, Activating URLs}.
@cindex MIME messages (Rmail) @cindex MIME messages (Rmail)
@vindex rmail-enable-mime @vindex rmail-enable-mime
Rmail, by default, decodes a MIME message and display the body By default, Rmail automatically decodes @acronym{MIME} (Multipurpose
part(s) in a humar readable way. If the message contains multiple Internet Mail Extensions) messages. If the message contains multiple
parts (entities), each part has an additional single tagline that parts (@acronym{MIME} entities), each part is represented by a tagline
contains the information about depth, index, and type of the part. It in the Rmail buffer. The tagline summarizes the part's depth, index,
may also contain buttons to handle the part (for saving or and type, and may also contain a button for handling it, e.g. saving
image-showing). it to a file or displaying it as an image in the Rmail buffer.
If you customize @code{rmail-enable-mime} to @code{nil} (the default
is @code{t}), Rmail does not show MIME decoded message until a user
explicitly requires it.
@table @kbd @table @kbd
@findex rmail-mime-toggle-hidden @findex rmail-mime-toggle-hidden
@item @key{RET} @item @key{RET}
Hide or show the body of a MIME entity at point. Hide or show the @acronym{MIME} part at point
(@code{rmail-mime-toggle-hidden}).
@findex rmail-mime-next-item @findex rmail-mime-next-item
@item @key{TAB} @item @key{TAB}
Move point to the next displayed item of MIME entity (part). Move point to the next @acronym{MIME} part
(@code{rmail-mime-next-item}).
@findex rmail-mime-previous-item @findex rmail-mime-previous-item
@item @key{BackTab} @item @key{BackTab}
Move point to the previous displayed item of MIME entity (part). Move point to the previous @acronym{MIME} part
(@code{rmail-mime-previous-item}).
@findex rmail-mime @findex rmail-mime
@item v @item v
@kindex v @r{(Rmail)} @kindex v @r{(Rmail)}
The @kbd{v} (@code{rmail-mime}) command toggles the display of a Toggle between @acronym{MIME} display and raw message
MIME message between the raw mode and the default mode. In the raw (@code{rmail-mime}).
mode, the undecoded MIME data is displayed. With a prefix argument,
it toggles the display of only an entity at point.
But, if the variable @code{rmail-enable-mime} is @code{nil}, the
command creates a temporary buffer displaying the current MIME
message. By default, it displays plain text and multipart messages,
and offers buttons to save attachments.
@end table @end table
The @kbd{v} (@code{rmail-mime}) command toggles between the default
@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.
To prevent Rmail from handling MIME decoded messages, change the
variable @code{rmail-enable-mime} to @code{nil}. When this is the
case, the @kbd{v} (@code{rmail-mime}) command instead creates a
temporary buffer to display the current @acronym{MIME} message.
You can highlight and activate URLs in the Rmail buffer using Goto
Address mode:
@c FIXME goto-addr.el commentary says to use goto-address instead.
@smallexample
(add-hook 'rmail-show-message-hook (lambda () (goto-address-mode 1)))
@end smallexample
@noindent
Then you can browse these URLs by clicking on them with @kbd{Mouse-2}
(or @kbd{Mouse-1} quickly) or by moving to one and typing @kbd{C-c
@key{RET}}. @xref{Goto Address mode, Activating URLs, Activating URLs}.
@node Rmail Coding @node Rmail Coding
@section Rmail and Coding Systems @section Rmail and Coding Systems
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment