@c =============================================================
@c = $B85(B $BK](B $BLu(B: $BGt@n@5=<!w$*Cc$N?e=w;RBg3X(B
@c = $B2CI.=$@5(B: $BBgLZFXM:!wBgDM(B.$BC^GHBg3X(B = 1998/11/25
@c = 20.4$B2~D{(B: $BBgLZFXM:!wBgDM(B.$BC^GHBg3X(B = 1999/09/12
@c =============================================================
@c This is part of the Emacs manual.
@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Rmail, Dired, Sending Mail, Top
@c @chapter Reading Mail with Rmail
@chapter $B%a%$%k$N1\Mw(Brmail
@c @cindex Rmail
@cindex rmail
@c @cindex reading mail
@cindex $B%a%$%k$rFI$`(B
@findex rmail
@findex rmail-mode
@vindex rmail-mode-hook

@c   Rmail is an Emacs subsystem for reading and disposing of mail that you
@c receive.  Rmail stores mail messages in files called Rmail files.
@c Reading the message in an Rmail file is done in a special major mode,
@c Rmail mode, which redefines most letters to run commands for managing
@c mail.  The command @code{rmail-mode} is used to switch into Rmail mode,
@c and it runs the hook @code{rmail-mode-hook} as usual, but don't run this
@c command by hand; it can't do a reasonable job unless the buffer is
@c visiting a proper Rmail file.
rmail$B$O!"<u$1<h$C$?%a%$%k$rFI$s$@$j=hM}$7$?$j$9$k$?$a$N(BEmacs$B$N(B
$B%5%V%7%9%F%`$G$9!#(B
rmail$B$O!"%a%$%k%a%C%;!<%8$r(Brmail$B%U%!%$%k$H8F$P$l$k%U%!%$%k$K3JG<$7$^$9!#(B
rmail$B%U%!%$%kFb$N%a%C%;!<%8$rFI$`$K$O!"(B
rmail$B%b!<%I$H$$$&FCJL$J%a%8%c!<%b!<%I$G9T$$$^$9!#(B
$B$3$N%b!<%I$G$O!"%a%$%k$r<h$j07$&%3%^%s%I$r<B9T$9$k$h$&$K(B
$B$[$H$s$I$N%"%k%U%!%Y%C%HJ8;z$r:FDj5A$7$F$$$^$9!#(B
$B%3%^%s%I(B@code{rmail-mode}$B$G(Brmail$B%b!<%I$K@Z$jBX$($^$9!#(B
$B$9$k$H$$$D$b$N$h$&$K%U%C%/(B@code{rmail-mode-hook}$B$,<B9T$5$l$^$9!#(B
$B$7$+$7!"$3$N%3%^%s%I$rD>@\<B9T$7$J$$$G$/$@$5$$!#(B
$B@5$7$$(Brmail$B%U%!%$%k$rK,Ld$7$F$$$k%P%C%U%!$G$J$$8B$j!"(B
$B$3$N%3%^%s%I$O$^$H$b$KF0$-$^$;$s!#(B

@menu
* Basic: Rmail Basics.       Basic concepts of Rmail, and simple use.
* Scroll: Rmail Scrolling.   Scrolling through a message.
* Motion: Rmail Motion.      Moving to another message.
* 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.
* 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.
* Summary: Rmail Summary.    Summaries show brief info on many messages.
* Sort: Rmail Sorting.       Sorting messages in Rmail.
* Display: Rmail Display.    How Rmail displays a message; customization.
* Editing: Rmail Editing.    Editing message text and headers in Rmail.
* Digest: Rmail Digest.      Extracting the messages from a digest message.
* Out of Rmail::	     Converting an Rmail file to mailbox format.
* Rot13: Rmail Rot13.	     Reading messages encoded in the rot13 code.
* Movemail: Movemail.        More details of fetching new mail.
@end menu

@node Rmail Basics
@c @section Basic Concepts of Rmail
@section rmail$B$N4pK\35G0(B

@c @cindex primary Rmail file
@cindex $B<g(Brmail$B%U%!%$%k(B
@vindex rmail-file-name
@c   Using Rmail in the simplest fashion, you have one Rmail file
@c @file{~/RMAIL} in which all of your mail is saved.  It is called your
@c @dfn{primary Rmail file}.  The command @kbd{M-x rmail} reads your primary
@c Rmail file, merges new mail in from your inboxes, displays the first
@c message you haven't read yet, and lets you begin reading.  The variable
@c @code{rmail-file-name} specifies the name of the primary Rmail file.
$B$b$C$H$b4JC1$J(Brmail$B$N;H$$J}$G$O!"(B
@file{~/RMAIL}$B$H$$$&(B1$B$D$N(Brmail$B%U%!%$%k$K$9$Y$F$N%a%$%k$rJ]B8$7$^$9!#(B
$B$3$l$r(B@dfn{$B<g(Brmail$B%U%!%$%k(B}$B!J(Bprimary Rmail file$B!K$H$$$$$^$9!#(B
$B%3%^%s%I(B@kbd{M-x rmail}$B$O!"<g(Brmail$B%U%!%$%k$rFI$_9~$_!"(Binbox
@footnote{$B!ZLuCm![(B
$B%7%9%F%`$,E~Ce%a%$%k$r3JG<$9$k%U%!%$%k$N$3$H!#(B
$B<B:]$N%U%!%$%kL>$O%7%9%F%`$K0MB8$9$k!#(B}
$BFb$N?7$7$$%a%$%k$rJ;9g$7$F!":G=i$NL$FI%a%C%;!<%8$rI=<($7$F(B
$B%a%$%k$rFI$_;O$a$i$l$k$h$&$K$7$^$9!#(B
$BJQ?t(B@code{rmail-file-name}$B$G!"<g(Brmail$B%U%!%$%k$NL>A0$r;XDj$7$^$9!#(B

@c   Rmail uses narrowing to hide all but one message in the Rmail file.
@c The message that is shown is called the @dfn{current message}.  Rmail
@c mode's special commands can do such things as delete the current
@c message, copy it into another file, send a reply, or move to another
@c message.  You can also create multiple Rmail files and use Rmail to move
@c messages between them.
rmail$B$O!"(Brmail$B%U%!%$%k$N(B1$B$D$N%a%C%;!<%8$@$1$,8+$($k$h$&$K%J%m%$%s%0$7$^$9!#(B
$BI=<($5$l$F$$$k%a%C%;!<%8$r(B@dfn{$B%+%l%s%H%a%C%;!<%8(B}$B!J(Bcurrent message$B!K$H(B
$B8F$S$^$9!#(B
rmail$B%b!<%I$NFCJL$J%3%^%s%I$r;H$($P!"(B
$B%+%l%s%H%a%C%;!<%8$r:o=|(B@footnote{$B!ZLuCm![(B
$B$"$H$G@bL@$5$l$k$h$&$K!"(B
$B!V:o=|!W$H$$$C$F$b<B:]$K$O!V:o=|0u!W$rIU$1$k$@$1!#(B}
$B$9$k!"JL$N%U%!%$%k$X%3%T!<$9$k!"JV?.$rAw$k!"(B
$BJL$N%a%C%;!<%8$X0\F0$9$k$3$H$,$G$-$^$9!#(B
$B$^$?!"J#?t$N(Brmail$B%U%!%$%k$r:n$C$F!"(B
$B$=$l$i$N$"$$$@$G%a%C%;!<%8$r0\$9$3$H$b$G$-$^$9!#(B

@c @cindex message number
@cindex $B%a%C%;!<%8HV9f(B
@c   Within the Rmail file, messages are normally arranged sequentially in
@c order of receipt; you can specify other ways to sort them.  Messages are
@c assigned consecutive integers as their @dfn{message numbers}.  The
@c number of the current message is displayed in Rmail's mode line,
@c followed by the total number of messages in the file.  You can move to a
@c message by specifying its message number with the @kbd{j} key
@c (@pxref{Rmail Motion}).
rmail$B%U%!%$%kFb$G$O!"0lHL$K%a%C%;!<%8$O<u$1<h$C$?=g$KJB$Y$i$l$^$9!#(B
$BJL$N=g=x$K%=!<%H$9$k$3$H$b$G$-$^$9!#(B
$B%a%C%;!<%8$K$O(B@dfn{$B%a%C%;!<%8HV9f(B}$B!J(Bmessage numbers$B!K(B
$B$H$7$FO"B3$7$?@0?t$,3d$j?6$i$l$^$9!#(B
$B%+%l%s%H%a%C%;!<%8$NHV9f$O!"(Brmail$B$N%b!<%I9T$KI=<($5$l!"(B
$B$=$N$"$H$K%U%!%$%kFb$NAm%a%C%;!<%8?t$bI=<($5$l$^$9!#(B
@kbd{j}$B%-!<$K%a%C%;!<%8HV9f$r;XDj$9$l$P!"$=$NHV9f$N%a%C%;!<%8$K0\F0$G$-$^$9(B
$B!J(B@pxref{Rmail Motion}$B!K!#(B

@c @kindex s @r{(Rmail)}
@kindex s @r{$B!J(Brmail$B!K(B}
@findex rmail-save
@c   Following the usual conventions of Emacs, changes in an Rmail file
@c become permanent only when the file is saved.  You can save it with
@c @kbd{s} (@code{rmail-save}), which also expunges deleted messages from
@c the file first (@pxref{Rmail Deletion}).  To save the file without
@c expunging, use @kbd{C-x C-s}.  Rmail also saves the Rmail file after
@c merging new mail from an inbox file (@pxref{Rmail Inbox}).
Emacs$B$N=,47$K=>$C$F!"(Brmail$B%U%!%$%k$NJQ99$O(B
$B%U%!%$%k$rJ]B8$7$?$H$-$K$@$1H?1G$5$l$^$9!#(B
@kbd{s}$B!J(B@code{rmail-save}$B!K$GJ]B8$7$^$9$,!"(B
$B:o=|!J(B@pxref{Rmail Deletion}$B!K$H(B
$B;XDj$5$l$?%a%C%;!<%8$r%U%!%$%k$+$i$^$:Ku>C$7$^$9!#(B
$BKu>C$;$:$K%U%!%$%k$rJ]B8$9$k$K$O!"(B@kbd{C-x C-s}$B$r;H$$$^$9!#(B
$B$5$i$K!"(Binbox$B$+$i?7Ce%a%$%k$rJ;9g$7$?$"$H$K$b(B
rmail$B%U%!%$%k$rJ]B8$7$^$9(B
$B!J(B@pxref{Rmail Inbox}$B!K!#(B

@c @kindex q @r{(Rmail)}
@kindex q @r{$B!J(Brmail$B!K(B}
@findex rmail-quit
@c @kindex b @r{(Rmail)}
@kindex b @r{$B!J(Brmail$B!K(B}
@findex rmail-bury
@c   You can exit Rmail with @kbd{q} (@code{rmail-quit}); this expunges and
@c saves the Rmail file and then switches to another buffer.  But there is
@c no need to `exit' formally.  If you switch from Rmail to editing in
@c other buffers, and never happen to switch back, you have exited.  (The
@c Rmail command @kbd{b}, @code{rmail-bury}, does this for you.)  Just make
@c sure to save the Rmail file eventually (like any other file you have
@c changed).  @kbd{C-x s} is a good enough way to do this
@c (@pxref{Saving}).
rmail$B$r=*N;$9$k$K$O(B@kbd{q}$B!J(B@code{rmail-quit}$B!K$r;H$$$^$9!#(B
$B!J%a%C%;!<%8$r!KKu>C$7(Brmail$B%U%!%$%k$rJ]B8$7$F$+$i!"(B
$BJL$N%P%C%U%!$K@Z$jBX$($^$9!#(B
$B$7$+$7!"@5$7$/!V=*N;!W$9$kI,MW$O$"$j$^$;$s!#(B
rmail$B$+$iJL$N%P%C%U%!$X@Z$jBX$($F!"(B
$B$=$N$"$HLa$i$J$1$l$P=*N;$7$?$3$H$K$J$j$^$9!#(B
$B!J(Brmail$B%3%^%s%I(B@kbd{b}$B!"(B@code{rmail-bury}$B$,$3$l$r9T$&!#!K(B
$B!JJQ99$7$?%U%!%$%k$K$9$k$N$HF1MM$K!K(B
rmail$B%U%!%$%k$r3N<B$KJ]B8$9$k$h$&$K$7$F$/$@$5$$!#(B
$B$3$l$K$O!"(B@kbd{C-x s}$B$,$h$$$G$7$g$&(B
$B!J(B@pxref{Saving}$B!K!#(B

@node Rmail Scrolling
@c @section Scrolling Within a Message
@section $B%a%C%;!<%8$r%9%/%m!<%k$9$k(B

@c   When Rmail displays a message that does not fit on the screen, you
@c must scroll through it to read the rest.  You could do this with 
@c @kbd{C-v}, @kbd{M-v} and @kbd{M-<}, but in Rmail scrolling is so
@c frequent that it deserves to be easier to type.
rmail$B$,I=<($9$k%a%C%;!<%8$,2hLL$KF~$j$-$i$J$$$H$-!"(B
$B;D$j$NItJ,$rFI$`$K$O%9%/%m!<%k$9$kI,MW$,$"$j$^$9!#(B
$B$3$l$K$O!"(B@kbd{C-v}$B!"(B@kbd{M-v}$B!"(B@kbd{M-<}$B$r;H$$$^$9$,!"(B
rmail$B$G$O%9%/%m!<%k$rIQHK$K9T$&$N$G!"$b$C$H4JC1$JA`:n$rMQ0U$7$F$"$j$^$9!#(B

@table @kbd
@item @key{SPC}
@c Scroll forward (@code{scroll-up}).
$B@h$X?J$a$k!J(B@code{scroll-up}$B!K!#(B
@item @key{DEL}
@c Scroll backward (@code{scroll-down}).
$B$^$($XLa$9!J(B@code{scroll-down}$B!K!#(B
@item .
@c Scroll to start of message (@code{rmail-beginning-of-message}).
$B%a%C%;!<%8$N@hF,$XLa$k!J(B@code{rmail-beginning-of-message}$B!K!#(B
@end table

@c @kindex SPC @r{(Rmail)}
@c @kindex DEL @r{(Rmail)}
@kindex SPC @r{$B!J(Brmail$B!K(B}
@kindex DEL @r{$B!J(Brmail$B!K(B}
@c   Since the most common thing to do while reading a message is to scroll
@c through it by screenfuls, Rmail makes @key{SPC} and @key{DEL} synonyms of
@c @kbd{C-v} (@code{scroll-up}) and @kbd{M-v} (@code{scroll-down})
$B%a%C%;!<%8$rFI$`$H$-$b$C$H$bB?$/9T$&$3$H$O(B
$B2hLLC10L$G$N%9%/%m!<%k$J$N$G!"(B
rmail$B$G$O!"(B@key{SPC}$B$H(B@key{DEL}$B$O!"$=$l$>$l!"(B
@kbd{C-v}$B!J(B@code{scroll-up}$B!K$H(B@kbd{M-v}$B!J(B@code{scroll-down}$B!K$N(B
$BF15A$K$J$C$F$$$^$9!#(B

@c @kindex . @r{(Rmail)}
@kindex . @r{$B!J(Brmail$B!K(B}
@findex rmail-beginning-of-message
@c   The command @kbd{.} (@code{rmail-beginning-of-message}) scrolls back to the
@c beginning of the selected message.  This is not quite the same as @kbd{M-<}:
@c for one thing, it does not set the mark; for another, it resets the buffer
@c boundaries to the current message if you have changed them.
$B%3%^%s%I(B@kbd{.}$B!J(B@code{rmail-beginning-of-message}$B!K$O!"(B
$BA*Br$5$l$F$$$k%a%C%;!<%8$N@hF,$K0\F0$7$^$9!#(B
$B$3$N%3%^%s%I$O(B@kbd{M-<}$B$H$^$C$?$/F1$8$H$$$&$o$1$G$O$"$j$^$;$s!#(B
$B$^$:!"%^!<%/$r@_Dj$7$^$;$s!#(B
$B$5$i$K!"%+%l%s%H%a%C%;!<%8$rJQ99$7$F$"$k$H%P%C%U%!$N6-3&$r:F@_Dj$7$^$9!#(B

@node Rmail Motion
@c @section Moving Among Messages
@section $B%a%C%;!<%84V$G$N0\F0(B

@c   The most basic thing to do with a message is to read it.  The way to
@c do this in Rmail is to make the message current.  The usual practice is
@c to move sequentially through the file, since this is the order of
@c receipt of messages.  When you enter Rmail, you are positioned at the
@c first message that you have not yet made current (that is, the first one
@c that has the @samp{unseen} attribute; @pxref{Rmail Attributes}).  Move
@c forward to see the other new messages; move backward to reexamine old
@c messages.
$B$b$C$H$b4pK\E*$JA`:n$O!"%a%C%;!<%8$rFI$`$3$H$G$9!#(B
rmail$B$G$3$l$r9T$&$K$O!"%a%C%;!<%8$r%+%l%s%H%a%C%;!<%8$K$7$^$9!#(B
$B%a%C%;!<%8$O<u$1<h$C$?=g$KJB$s$G$$$k$N$G!"(B
$BDL>o$O%U%!%$%k$NCf$r=g$K0\F0$7$FFI$s$G$$$-$^$9!#(B
rmail$B$KF~$k$H!"%+%l%s%H%a%C%;!<%8$K$7$?$3$H$,$J$$:G=i$N%a%C%;!<%8$+$i;O$^$j$^$9(B
$B!J$D$^$j!"L$FI$r0UL#$9$k(B@samp{unseen}$BB0@-$,IU$$$F$$$k:G=i$N$b$N!#(B
@pxref{Rmail Attributes}$B!K!#(B
$B@h$X?J$a$PB>$N?7$7$$%a%C%;!<%8$rFI$a$^$9!#(B
$B$^$($XLa$l$P8E$$%a%C%;!<%8$rFI$_D>$;$^$9!#(B

@table @kbd
@item n
@c Move to the next nondeleted message, skipping any intervening deleted
@c messages (@code{rmail-next-undeleted-message}).
$B:o=|$5$l$?%a%C%;!<%8$rHt$P$7$F!"(B
$B:o=|$5$l$F$$$J$$$D$.$N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-next-undeleted-message}$B!K!#(B
@item p
@c Move to the previous nondeleted message
@c (@code{rmail-previous-undeleted-message}).
$B:o=|$5$l$F$$$J$$$^$($N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-previous-undeleted-message}$B!K!#(B
@item M-n
@c Move to the next message, including deleted messages
@c (@code{rmail-next-message}).
$B:o=|$5$l$?%a%C%;!<%8$b4^$a$F$D$.$N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-next-message}$B!K!#(B
@item M-p
@c Move to the previous message, including deleted messages
@c (@code{rmail-previous-message}).
$B:o=|$5$l$?%a%C%;!<%8$b4^$a$F$^$($N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-previous-message}$B!K!#(B
@item j
@c Move to the first message.  With argument @var{n}, move to
@c message number @var{n} (@code{rmail-show-message}).
$B:G=i$N%a%C%;!<%8$X0\F0$9$k!#(B
$B?t0z?t(B@var{n}$B$r;XDj$9$k$H!"%a%C%;!<%8HV9f(B@var{n}$B$N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-show-message}$B!K!#(B
@item >
@c Move to the last message (@code{rmail-last-message}).
$B:G8e$N%a%C%;!<%8$X0\F0$9$k!J(B@code{rmail-last-message}$B!K!#(B
@item <
@c Move to the first message (@code{rmail-first-message}).
$B:G=i$N%a%C%;!<%8$X0\F0$9$k!J(B@code{rmail-first-message}$B!K!#(B

@item M-s @var{regexp} @key{RET}
@c Move to the next message containing a match for @var{regexp}
@c (@code{rmail-search}).
$B@55,I=8=(B@var{regexp}$B$K0lCW$9$k$D$.$N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-search}$B!K!#(B

@item - M-s @var{regexp} @key{RET}
@c Move to the previous message containing a match for @var{regexp}.
$B@55,I=8=(B@var{regexp}$B$K0lCW$9$k$^$($N%a%C%;!<%8$X0\F0$9$k!#(B
@end table

@c @kindex n @r{(Rmail)}
@c @kindex p @r{(Rmail)}
@c @kindex M-n @r{(Rmail)}
@c @kindex M-p @r{(Rmail)}
@kindex n @r{$B!J(Brmail$B!K(B}
@kindex p @r{$B!J(Brmail$B!K(B}
@kindex M-n @r{$B!J(Brmail$B!K(B}
@kindex M-p @r{$B!J(Brmail$B!K(B}
@findex rmail-next-undeleted-message
@findex rmail-previous-undeleted-message
@findex rmail-next-message
@findex rmail-previous-message
@c   @kbd{n} and @kbd{p} are the usual way of moving among messages in
@c Rmail.  They move through the messages sequentially, but skip over
@c deleted messages, which is usually what you want to do.  Their command
@c definitions are named @code{rmail-next-undeleted-message} and
@c @code{rmail-previous-undeleted-message}.  If you do not want to skip
@c deleted messages---for example, if you want to move to a message to
@c undelete it---use the variants @kbd{M-n} and @kbd{M-p}
@c (@code{rmail-next-message} and @code{rmail-previous-message}).  A
@c numeric argument to any of these commands serves as a repeat
@c count.@refill
@kbd{n}$B$H(B@kbd{p}$B$O!"(Brmail$B$G%a%C%;!<%84V$r0\F0$9$kIaDL$NJ}K!$G$9!#(B
$B$3$l$i$N%3%^%s%I$O!"%a%C%;!<%84V$r=g!9$K0\F0$7$F$$$-$^$9$,!"(B
$B4|BT$I$*$j$K:o=|$5$l$?%a%C%;!<%8$OHt$S1[$($^$9!#(B
$B%3%^%s%I$NDj5AL>$O(B@code{rmail-next-undeleted-message}$B$H(B
@code{rmail-previous-undeleted-message}$B$G$9!#(B
$B:o=|$5$l$?%a%C%;!<%8$rHt$S1[$7$?$/$J$$>l9g!"(B
$B$?$H$($P!":o=|$5$l$?%a%C%;!<%8$r%"%s%G%j!<%H(B@footnote{$B!ZLuCm![(B
$B%a%C%;!<%8$KIU$1$?:o=|0u$r>C$9$3$H!#(B}$B$7$?$$$H$-$O!"(B
$B!J(B@kbd{n}$B$d(B@kbd{p}$B$N!KJQ7A$G$"$k(B
@kbd{M-n}$B$d(B@kbd{M-p}$B!J(B@code{rmail-next-message}$B!"(B
@code{rmail-previous-message}$B!K$r;H$$$^$9!#(B
$B$3$l$i$N%3%^%s%I$K?t0z?t$r;XDj$9$k$H!"H?I|2s?t$H$_$J$7$^$9!#(B

@c   In Rmail, you can specify a numeric argument by typing just the
@c digits.  You don't need to type @kbd{C-u} first.
rmail$B$G$O!"?t;z$rBG$D$@$1$G?t0z?t$r;XDj$G$-$^$9!#(B
$B;O$a$K(B@kbd{C-u}$B$rBG$DI,MW$O$"$j$^$;$s!#(B

@c @kindex M-s @r{(Rmail)}
@kindex M-s @r{$B!J(Brmail$B!K(B}
@findex rmail-search
@c @cindex searching in Rmail
@cindex rmail$B$NC5:w(B
@c   The @kbd{M-s} (@code{rmail-search}) command is Rmail's version of
@c search.  The usual incremental search command @kbd{C-s} works in Rmail,
@c but it searches only within the current message.  The purpose of
@c @kbd{M-s} is to search for another message.  It reads a regular
@c expression (@pxref{Regexps}) nonincrementally, then searches starting at
@c the beginning of the following message for a match.  It then selects
@c that message.  If @var{regexp} is empty, @kbd{M-s} reuses the regexp
@c used the previous time.
@kbd{M-s}$B!J(B@code{rmail-search}$B!K%3%^%s%I$O!"(Brmail$B$K$*$1$kC5:w$r9T$$$^$9!#(B
$BDL>o$N%$%s%/%j%a%s%?%k%5!<%A%3%^%s%I(B@kbd{C-s}$B$b(Brmail$B$G;H$($^$9$,!"(B
$B$3$l$O%+%l%s%H%a%C%;!<%8$NCf$@$1$rC5:w$7$^$9!#(B
@kbd{M-s}$B%3%^%s%I$NL\E*$O!"B>$N%a%C%;!<%8$rC5$9$3$H$G$9!#(B
$B@55,I=8=!J(B@pxref{Regexps}$B!K$rFI$_=*$($F$+$i!"(B
$B$D$.$N%a%C%;!<%8$N@hF,$+$i0lCW$9$k$b$N$rC5$7;O$a$^$9!#(B
$B$=$7$F$_$D$+$C$?%a%C%;!<%8$rA*Br$7$^$9!#(B
@var{regexp}$B$,6u$@$H(B@kbd{M-s}$B$O:G8e$K;H$C$?@55,I=8=$r:F;HMQ$7$^$9!#(B

@c   To search backward in the file for another message, give @kbd{M-s} a
@c negative argument.  In Rmail you can do this with @kbd{- M-s}.
$B%U%!%$%kFb$G5U8~$-$KB>$N%a%C%;!<%8$rC5:w$9$k$K$O!"(B
@kbd{M-s}$B$KIi$N?t0z?t$r;XDj$7$^$9!#(B
rmail$B$G$O!"(B@kbd{- M-s}$B$HBG$F$P$h$$$N$G$9!#(B

@c   It is also possible to search for a message based on labels.
@c @xref{Rmail Labels}.
$B%i%Y%k$r$b$H$K%a%C%;!<%8$rC5:w$9$k$3$H$b$G$-$^$9!#(B
@xref{Rmail Labels}$B!#(B

@c @kindex j @r{(Rmail)}
@c @kindex > @r{(Rmail)}
@c @kindex < @r{(Rmail)}
@kindex j @r{$B!J(Brmail$B!K(B}
@kindex > @r{$B!J(Brmail$B!K(B}
@kindex < @r{$B!J(Brmail$B!K(B}
@findex rmail-show-message
@findex rmail-last-message
@findex rmail-first-message
@c   To move to a message specified by absolute message number, use @kbd{j}
@c (@code{rmail-show-message}) with the message number as argument.  With
@c no argument, @kbd{j} selects the first message.  @kbd{<}
@c (@code{rmail-first-message}) also selects the first message.  @kbd{>}
@c (@code{rmail-last-message}) selects the last message.
$B%a%C%;!<%8HV9f$r;XDj$7$F%a%C%;!<%8$X0\F0$9$k$K$O!"(B
$B%a%C%;!<%8HV9f$r0z?t$H$7$F(B@kbd{j}$B!J(B@code{rmail-show-message}$B!K$r;H$$$^$9!#(B
$B0z?t$,$J$$$H(B@kbd{j}$B$O:G=i$N%a%C%;!<%8$rA*Br$7$^$9!#(B
@kbd{<}$B!J(B@code{rmail-first-message}$B!K$b:G=i$N%a%C%;!<%8$rA*Br$7$^$9!#(B 
@kbd{>}$B!J(B@code{rmail-last-message}$B!K$O:G8e$N%a%C%;!<%8$rA*Br$7$^$9!#(B

@node Rmail Deletion
@c @section Deleting Messages
@section $B%a%C%;!<%8$N:o=|(B

@c @cindex deletion (Rmail)
@cindex $B:o=|!J(Brmail$B!K(B
@c   When you no longer need to keep a message, you can @dfn{delete} it.  This
@c flags it as ignorable, and some Rmail commands pretend it is no longer
@c present; but it still has its place in the Rmail file, and still has its
@c message number.
$B%a%C%;!<%8$rJ]B8$7$F$*$/I,MW$,$J$/$J$C$?$i!"(B
$B$=$N%a%C%;!<%8$r(B@dfn{$B:o=|(B}$B!J(Bdelete$B!K$G$-$^$9!#(B
$B!VL5;k$;$h!W$H$$$&0UL#$N:o=|0u$r%a%C%;!<%8$KIU$1$^$9!#(B
$B$9$k$H!"$$$/$D$+$N(Brmail$B%3%^%s%I$O$=$N%a%C%;!<%8$,B8:_$7$J$$$b$N$H$7$F07$$$^$9!#(B
$B$7$+$7!"$=$N%a%C%;!<%8$O$^$@(Brmail$B%U%!%$%k$NCf$K$"$C$F!"(B
$B%a%C%;!<%8HV9f$bIU$$$F$$$^$9!#(B

@c @cindex expunging (Rmail)
@cindex $BKu>C!J(Brmail$B!K(B
@c   @dfn{Expunging} the Rmail file actually removes the deleted messages.
@c The remaining messages are renumbered consecutively.  Expunging is the only
@c action that changes the message number of any message, except for
@c undigestifying (@pxref{Rmail Digest}).
rmail$B%U%!%$%k$r(B@dfn{$BKu>C(B}$B!J(Bexpunging$B!K$9$k$H!"(B
$B:o=|0u$,IU$$$?%a%C%;!<%8$rK\Ev$K>C$75n$j$^$9!#(B
$B;D$C$?%a%C%;!<%8$K$OHV9f$r=g$K?6$jD>$7$^$9!#(B
$BKu>C$O!"%"%s%@%$%8%'%9%H!J(B@pxref{Rmail Digest}$B!K$r=|$$$F!"(B
$B%a%C%;!<%8HV9f$rJQ99$9$kM#0l$NF0:n$G$9!#(B

@table @kbd
@item d
@c Delete the current message, and move to the next nondeleted message
@c (@code{rmail-delete-forward}).
$B%+%l%s%H%a%C%;!<%8$r:o=|$7!"(B
$B:o=|$5$l$F$$$J$$$D$.$N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-delete-forward}$B!K!#(B
@item C-d
@c Delete the current message, and move to the previous nondeleted
@c message (@code{rmail-delete-backward}).
$B%+%l%s%H%a%C%;!<%8$r:o=|$7!"(B
$B:o=|$5$l$F$$$J$$$^$($N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-delete-backward}$B!K!#(B
@item u
@c Undelete the current message, or move back to a deleted message and
@c undelete it (@code{rmail-undelete-previous-message}).
$B%+%l%s%H%a%C%;!<%8$r%"%s%G%j!<%H$9$k!"$"$k$$$O!"(B
$B:o=|$5$l$?$^$($N%a%C%;!<%8$XLa$C$F%"%s%G%j!<%H$9$k(B
$B!J(B@code{rmail-undelete-previous-message}$B!K!#(B
@item x
@c Expunge the Rmail file (@code{rmail-expunge}).
rmail$B%U%!%$%k!J$N:o=|$NIU$$$?%a%C%;!<%8!K$rKu>C$9$k(B
$B!J(B@code{rmail-expunge}$B!K!#(B
@end table

@c @kindex d @r{(Rmail)}
@c @kindex C-d @r{(Rmail)}
@kindex d @r{$B!J(Brmail$B!K(B}
@kindex C-d @r{$B!J(Brmail$B!K(B}
@findex rmail-delete-forward
@findex rmail-delete-backward
@c   There are two Rmail commands for deleting messages.  Both delete the
@c current message and select another message.  @kbd{d}
@c (@code{rmail-delete-forward}) moves to the following message, skipping
@c messages already deleted, while @kbd{C-d} (@code{rmail-delete-backward})
@c moves to the previous nondeleted message.  If there is no nondeleted
@c message to move to in the specified direction, the message that was just
@c deleted remains current.  A numeric argument to either command reverses
@c the direction of motion after deletion.
rmail$B$K$O%a%C%;!<%8$r:o=|$9$k%3%^%s%I$,(B2$B$D$"$j$^$9!#(B
$B$I$A$i$b%+%l%s%H%a%C%;!<%8$r:o=|$7!"JL$N%a%C%;!<%8$rA*Br$7$^$9!#(B
@kbd{d}$B!J(B@code{rmail-delete-forward}$B!K$O(B
$B$9$G$K:o=|$7$?%a%C%;!<%8$rHt$P$7$F$D$.$N%a%C%;!<%8$X0\F0$7$^$9$,!"(B
@kbd{C-d}$B!J(B@code{rmail-delete-backward}$B!K$O$^$($N%a%C%;!<%8$X0\F0$7$^$9!#(B
$B;XDj$7$?J}8~$K:o=|$5$l$F$$$J$$%a%C%;!<%8$,$J$$$H$-$O!"(B
$B:o=|$7$?$P$+$j$N%a%C%;!<%8$,%+%l%s%H%a%C%;!<%8$N$^$^$G$9!#(B
$B$I$A$i$N%3%^%s%I$KBP$7$F$b!"?t0z?t$r;XDj$9$k$H!"(B
$B:o=|8e$N0\F0J}8~$rH?E>$7$^$9!#(B

@vindex rmail-delete-message-hook
@c   Whenever Rmail deletes a message, it invokes the function(s) listed in
@c @code{rmail-delete-message-hook}.  When the hook functions are invoked,
@c the message has been marked deleted, but it is still the current message
@c in the Rmail buffer.
rmail$B$,%a%C%;!<%8$r:o=|$9$k$H$-$O$$$D$G$b!"(B
@code{rmail-delete-message-hook}$B$KEPO?$5$l$F$$$k4X?t!J72!K$r5/F0$7$^$9!#(B
$B%U%C%/4X?t$,5/F0$5$l$k$H$-$K$O!"%a%C%;!<%8$K:o=|0u$,IU$$$F$$$^$9$,!"(B
rmail$B%P%C%U%!$G$O$=$N%a%C%;!<%8$O%+%l%s%H%a%C%;!<%8$N$^$^$G$9!#(B

@c @cindex undeletion (Rmail)
@cindex $B%"%s%G%j!<%H!J(Brmail$B!K(B
@c @kindex x @r{(Rmail)}
@kindex x @r{$B!J(Brmail$B!K(B}
@findex rmail-expunge
@c @kindex u @r{(Rmail)}
@kindex u @r{$B!J(Brmail$B!K(B}
@findex rmail-undelete-previous-message
@c   To make all the deleted messages finally vanish from the Rmail file,
@c type @kbd{x} (@code{rmail-expunge}).  Until you do this, you can still
@c @dfn{undelete} the deleted messages.  The undeletion command, @kbd{u}
@c (@code{rmail-undelete-previous-message}), is designed to cancel the
@c effect of a @kbd{d} command in most cases.  It undeletes the current
@c message if the current message is deleted.  Otherwise it moves backward
@c to previous messages until a deleted message is found, and undeletes
@c that message.
$B:o=|$7$?$9$Y$F$N%a%C%;!<%8$r(Brmail$B%U%!%$%k$+$iK\Ev$K>C$9$K$O(B
@kbd{x}$B!J(B@code{rmail-expunge}$B!K$HBG$A$^$9!#(B
$B$3$l$r<B9T$9$k$^$($J$i$P!"(B@dfn{$B%"%s%G%j!<%H(B}$B!J(Bundelete$B!K!"$D$^$j!"(B
$B%a%C%;!<%8$N:o=|0u$r>C$9$3$H$,$G$-$^$9!#(B
$B%"%s%G%j!<%H%3%^%s%I!"(B@kbd{u}$B!J(B@code{rmail-undelete-previous-message}$B!K$O(B
@kbd{d}$B%3%^%s%I$N8z2L$r$[$H$s$I$N>l9gBG$A>C$7$^$9!#(B
$B%+%l%s%H%a%C%;!<%8$,:o=|$5$l$F$$$l$P!"(B
$B%+%l%s%H%a%C%;!<%8$r%"%s%G%j!<%H$7$^$9!#(B
$B$=$&$G$J$1$l$P!":o=|$5$l$?%a%C%;!<%8$,(B
$B$_$D$+$k$^$G$^$($XLa$j!"$=$N%a%C%;!<%8$r%"%s%G%j!<%H$7$^$9!#(B

@c   You can usually undo a @kbd{d} with a @kbd{u} because the @kbd{u}
@c moves back to and undeletes the message that the @kbd{d} deleted.  But
@c this does not work when the @kbd{d} skips a few already-deleted messages
@c that follow the message being deleted; then the @kbd{u} command
@c undeletes the last of the messages that were skipped.  There is no clean
@c way to avoid this problem.  However, by repeating the @kbd{u} command,
@c you can eventually get back to the message that you intend to
@c undelete.  You can also select a particular deleted message with
@c the @kbd{M-p} command, then type @kbd{u} to undelete it.
$BIaDL$O(B@kbd{u}$B$G(B@kbd{d}$B$r%"%s%I%%$G$-$^$9!#(B
$B$J$<$J$i!"(B@kbd{d}$B$G:o=|$7$?%a%C%;!<%8$r(B
$B$^$($XLa$C$FC5$7$F$=$N%a%C%;!<%8$r(B@kbd{u}$B$,%"%s%G%j!<%H$9$k$+$i$G$9!#(B
$B$7$+$7!"(B@kbd{d}$B$,%a%C%;!<%8$r:o=|$7$F$+$i(B
$B8eB3$N$9$G$K:o=|$5$l$?%a%C%;!<%8$rHt$S1[$9>l9g$K$O!"(B
$B$&$^$/$$$-$^$;$s!#(B
$B$3$N>l9g!"(B@kbd{u}$B%3%^%s%I$OHt$S1[$7$?%a%C%;!<%8$N$&$A$N(B
$B:G8e$N$b$N$r%"%s%G%j!<%H$7$^$9!#(B
$B$3$NLdBj$r2sHr$9$k4JC1$JJ}K!$O$"$j$^$;$s!#(B
$B$G$9$,!"(B@kbd{u}$B%3%^%s%I$r7+$jJV$;$P!"(B
$B:G=*E*$K$O%"%s%G%j!<%H$7$?$$%a%C%;!<%8$KC)$jCe$-$^$9!#(B
$B$"$k$$$O!"(B@kbd{M-p}$B%3%^%s%I$GL\E*$N:o=|$5$l$?%a%C%;!<%8$K0\F0$7$F$+$i(B
@kbd{u}$B$rBG$C$F%"%s%G%j!<%H$7$^$9!#(B

@c   A deleted message has the @samp{deleted} attribute, and as a result
@c @samp{deleted} appears in the mode line when the current message is
@c deleted.  In fact, deleting or undeleting a message is nothing more than
@c adding or removing this attribute.  @xref{Rmail Attributes}.
$B:o=|$5$l$?%a%C%;!<%8$K$O!"(B@samp{deleted}$B$H$$$&B0@-$,IU$-$^$9!#(B
$B$=$N7k2L!"%+%l%s%H%a%C%;!<%8$,:o=|$5$l$F$$$k$H(B
$B%b!<%I9T$K(B@samp{deleted}$B$HI=<($5$l$^$9!#(B
$B%a%C%;!<%8$r:o=|$9$k!"$"$k$$$O!"%"%s%G%j!<%H$9$k$H!"(B
$B<B:]$K$O!"%a%C%;!<%8$K$3$NB0@-$rIU2C$9$k!"$"$k$$$O!"<h$j5n$k$@$1$G$9!#(B
@xref{Rmail Attributes}$B!#(B

@node Rmail Inbox
@c @section Rmail Files and Inboxes
@section rmail$B%U%!%$%k$H(Binbox
@c @cindex inbox file
@cindex inbox$B%U%!%$%k(B

@c   The operating system places incoming mail for you in a file that we
@c call your @dfn{inbox}.  When you start up Rmail, it runs a C program
@c called @code{movemail} to copy the new messages from your inbox into
@c your primary Rmail file, which also contains other messages saved from
@c previous Rmail sessions.  It is in this file that you actually read the
@c mail with Rmail.  This operation is called @dfn{getting new mail}.  You
@c can get new mail at any time in Rmail by typing @kbd{g}.
$B%*%Z%l!<%F%#%s%0%7%9%F%`$O!"(B@dfn{inbox}$B$H8F$P$l$k%U%!%$%k$K(B
$BE~Ce$7$?%a%$%k$r3JG<$7$^$9!#(B
rmail$B$r5/F0$9$k$H!"(B@code{movemail}$B$H8F$P$l$k(BC$B%W%m%0%i%`$,Av$j!"(B
inbox$B$+$i<g(Brmail$B%U%!%$%k$X?7Ce%a%C%;!<%8$r%3%T!<$7$^$9!#(B
$B$?$@$7!"<g(Brmail$B%U%!%$%k$K$O!"0JA0$N(Brmail$B%;%C%7%g%s$GJ]B8$7$?%a%C%;!<%8$b(B
$BF~$C$F$$$^$9!#(B
$B<B:]$K(Brmail$B$GFI$`%a%$%k$O$3$N%U%!%$%k$NCf$K$"$k$N$G$9!#(B
$B$3$NA`:n$r!"(B@dfn{$B?7Ce%a%$%k$N<hF@(B}$B$H$$$$$^$9!#(B
rmail$BFb$G(B@kbd{g}$B$HBG$F$P!"$$$D$G$b?7Ce%a%$%k$r<hF@$G$-$^$9!#(B

@vindex rmail-primary-inbox-list
@c @cindex @code{MAIL} environment variable
@cindex $B4D6-JQ?t(B@code{MAIL}
@cindex @code{MAIL}$B!J4D6-JQ?t!K(B
@c   The variable @code{rmail-primary-inbox-list} contains a list of the
@c files which are inboxes for your primary Rmail file.  If you don't set
@c this variable explicitly, it is initialized from the @code{MAIL}
@c environment variable, or, as a last resort, set to @code{nil}, which
@c means to use the default inbox.  The default inbox is
@c @file{/var/mail/@var{username}}, @file{/usr/spool/mail/@var{username}},
@c or @file{/usr/mail/@var{username}}, depending on your operating system.
$BJQ?t(B@code{rmail-primary-inbox-list}$B$K$O!"(B
$B<g(Brmail$B%U%!%$%k$N(Binbox$B$H$J$k%U%!%$%k$N%j%9%H$r3JG<$7$^$9!#(B
$B$3$NJQ?t$rL@<(E*$K@_Dj$7$J$1$l$P!"(B
$B4D6-JQ?t(B@code{MAIL}$B$G=i4|2=$9$k$+!"$"$k$$$O!"(B
$B:G8e$N<jCJ$H$7$F!"%G%U%)%k%H$N(Binbox$B$r;H$&$3$H$r0UL#$9$k(B
@code{nil}$B$K@_Dj$7$^$9!#(B
$B%G%U%)%k%H$N(Binbox$B$O%*%Z%l!<%F%#%s%0%7%9%F%`$K0MB8$7$F!"(B
@file{/var/mail/@var{username}}$B!"(B@file{/usr/spool/mail/@var{username}}$B!"(B
@file{/usr/mail/@var{username}}$B$K$J$j$^$9!#(B

@c   To see what the default is on your system, use @kbd{C-h v
@c rmail-primary-inbox @key{RET}}.  You can specify the inbox file(s) for
@c any Rmail file with the command @code{set-rmail-inbox-list}; see
@c @ref{Rmail Files}.
$B%7%9%F%`$N%G%U%)%k%H$rD4$Y$k$K$O!"(B
@kbd{C-h v rmail-primary-inbox @key{RET}}$B$r;H$$$^$9!#(B
$B%3%^%s%I(B@code{set-rmail-inbox-list}$B$G!"(B
$BG$0U$N(Brmail$B%U%!%$%k$KBP$7$F;H$&(Binbox$B%U%!%$%k$r;XDj$G$-$^$9!#(B
@ref{Rmail Files}$B$r;2>H$7$F$/$@$5$$!#(B

@c   There are two reasons for having separate Rmail files and inboxes.
rmail$B%U%!%$%k$H(Binbox$B$KJ,$1$kM}M3$O(B2$B$D$"$j$^$9!#(B

@enumerate
@item
@c The inbox file format varies between operating systems and according to
@c the other mail software in use.  Only one part of Rmail needs to know
@c about the alternatives, and it need only understand how to convert all
@c of them to Rmail's own format.
inbox$B$N%U%!%$%k7A<0$O!"%*%Z%l!<%F%#%s%0%7%9%F%`$d(B
$B;HMQ$9$k%a%$%k%=%U%H$K0MB8$7$F0[$J$k!#(B
rmail$B$N0lItJ,$@$1$,0c$$$rCN$C$F$$$l$P$h$/!"(B
$B$7$+$b!"(Brmail$BFH<+$N7A<0$X$NJQ49J}K!$@$1$rCN$C$F$$$l$P$h$$!#(B

@item
@c It is very cumbersome to access an inbox file without danger of losing
@c mail, because it is necessary to interlock with mail delivery.
@c Moreover, different operating systems use different interlocking
@c techniques.  The strategy of moving mail out of the inbox once and for
@c all into a separate Rmail file avoids the need for interlocking in all
@c the rest of Rmail, since only Rmail operates on the Rmail file.
$B%a%$%kJ6<:$H$$$&4m81$rHH$5$:$K(Binbox$B$r;2>H$9$k$N$O$?$$$X$sLq2p$G$"$k!#(B
$B$H$$$&$N$O!"%a%$%kG[Aw%W%m%0%i%`$HAj8_GS=|$r9T$&I,MW$,$"$k$+$i!#(B
$B$5$i$K!"%*%Z%l!<%F%#%s%0%7%9%F%`$4$H$KAj8_GS=|$N<jK!$,0[$J$k!#(B
$B$$$C$?$s(Binbox$B$+$i%a%$%k$r<h$j=P$7!"$"$H$OJL$N(Brmail$B%U%!%$%k$r;H$&J}<0$G$O!"(B
rmail$B%U%!%$%k$7$+07$o$J$$$N$G(Brmail$B$N3F=j$GAj8_GS=|$9$kI,MW$,$J$/$J$k!#(B
@end enumerate

@c   Rmail was written to use Babyl format as its internal format.  Since
@c then, we have recognized that the usual inbox format on Unix and GNU
@c systems is adequate for the job, and we plan to change Rmail to use that
@c as its internal format.  However, the Rmail file will still be separate
@c from the inbox file, even on systems where their format is the same.
rmail$B$G$OFH<+$NFbIt7A<0!J(BBabyl$B7A<0!K$r;H$C$F$$$^$9!#(B
$BEv=i$+$i(BUNIX$B$d(BGNU$B%7%9%F%`$NIaDL$N(Binbox$B7A<0$G==J,$G$"$k$H5$$E$$$F$$$F!"(B
inbox$B7A<0$rFbIt7A<0$H$7$F;H$*$&$H7W2h$7$F$$$^$9!#(B
$B$7$+$7!"$?$H$(%U%!%$%k$N7A<0$,F10l$G$"$C$F$b!"(B
rmail$B%U%!%$%k$O(Binbox$B%U%!%$%k$H$OFHN)$7$FB8:_$7B3$1$k$G$7$g$&!#(B

@node Rmail Files
@c @section Multiple Rmail Files
@section $BJ#?t$N(Brmail$B%U%!%$%k$N07$$J}(B

@c   Rmail operates by default on your @dfn{primary Rmail file}, which is named
@c @file{~/RMAIL} and receives your incoming mail from your system inbox file.
@c But you can also have other Rmail files and edit them with Rmail.  These
@c files can receive mail through their own inboxes, or you can move messages
@c into them with explicit Rmail commands (@pxref{Rmail Output}).
rmail$B$O%G%U%)%k%H$G$O8D?M$N<g(Brmail$B%U%!%$%k$rA`:n$7$^$9!#(B
$B$3$N%U%!%$%k$O!"(B@file{~/RMAIL}$B$H$$$&L>A0$G!"(B
$B%7%9%F%`$N(Binbox$B%U%!%$%k$+$iE~Ce%a%$%k$r<u$1<h$j$^$9!#(B
$B$7$+$7!"JL$N(Brmail$B%U%!%$%k$r:n$C$F$=$l$r(Brmail$B$GJT=8$9$k$3$H$b$G$-$^$9!#(B
$B$3$l$i$N%U%!%$%k$O$=$l$>$lFH<+$N(Binbox$B$+$i%a%$%k$r<u$1<h$C$?$j!"(B
$B$"$k$$$O!"(Brmail$B%3%^%s%I$G$=$l$i$N$"$$$@$G%a%C%;!<%8$r0\$;$^$9(B
$B!J(B@pxref{Rmail Output}$B!K!#(B

@table @kbd
@item i @var{file} @key{RET}
@c Read @var{file} into Emacs and run Rmail on it (@code{rmail-input}).
@var{file}$B$r(BEmacs$B$KFI$_9~$_!"$=$l$KBP$7$F(Brmail$B$r<B9T$9$k(B
$B!J(B@code{rmail-input}$B!K!#(B

@item M-x set-rmail-inbox-list @key{RET} @var{files} @key{RET}
@c Specify inbox file names for current Rmail file to get mail from.
$B8=:_$N(Brmail$B%U%!%$%k$KBP$7$F%a%$%k$r<h$j9~$`(Binbox$B%U%!%$%k$r;XDj$9$k!#(B

@item g
@c Merge new mail from current Rmail file's inboxes
@c (@code{rmail-get-new-mail}).
$B8=:_$N(Brmail$B%U%!%$%k$N(Binbox$B$+$i?7Ce%a%$%k$r<hF@$9$k(B
$B!J(B@code{rmail-get-new-mail}$B!K!#(B

@item C-u g @var{file} @key{RET}
@c Merge new mail from inbox file @var{file}.
inbox$B%U%!%$%k(B@var{file}$B$+$i?7Ce%a%$%k$r<hF@$9$k!#(B
@end table

@c @kindex i @r{(Rmail)}
@kindex i @r{$B!J(Brmail$B!K(B}
@findex rmail-input
@c   To run Rmail on a file other than your primary Rmail file, you may use
@c the @kbd{i} (@code{rmail-input}) command in Rmail.  This visits the file
@c in Rmail mode.  You can use @kbd{M-x rmail-input} even when not in
@c Rmail.
$B<g(Brmail$B%U%!%$%k0J30$N%U%!%$%k$KBP$7$F(Brmail$B$r<B9T$9$k$K$O!"(B
rmail$B$G(B@kbd{i}$B!J(B@code{rmail-input}$B!K%3%^%s%I$r;H$$$^$9!#(B
$B$3$N%3%^%s%I$O!";XDj$5$l$?%U%!%$%k$r(Brmail$B%b!<%I$GK,Ld$7$^$9!#(B
rmail$B$N30$+$i$G$b(B@kbd{M-x rmail-input}$B$r;H$($^$9!#(B

@c   The file you read with @kbd{i} should normally be a valid Rmail file.
@c If it is not, Rmail tries to decompose it into a stream of messages in
@c various known formats.  If it succeeds, it converts the whole file to an
@c Rmail file.  If you specify a file name that doesn't exist, @kbd{i}
@c initializes a new buffer for creating a new Rmail file.
@kbd{i}$B$GFI$_9~$`%U%!%$%k$O!"(B  $BDL>o!"@5$7$$(Brmail$B%U%!%$%k$G$"$k$Y$-$G$9!#(B
$B$=$&$G$J$1$l$P!"(Brmail$B$O4{CN$N$5$^$6$^$J7A<0$rMQ$$$F(B
$B%a%C%;!<%8$KJ,2r$7$h$&$H;n$_$^$9!#(B
$B$=$l$K@.8y$9$l$P!"%U%!%$%kA4BN$r(Brmail$B%U%!%$%k$KJQ49$7$^$9!#(B
$BB8:_$7$J$$%U%!%$%kL>$r;XDj$9$k$H!"(B
@kbd{i}$B%3%^%s%I$O?7$?$J(Brmail$B%U%!%$%kMQ$N?7$7$$%P%C%U%!$r=i4|2=$7$^$9!#(B

@vindex rmail-secondary-file-directory
@vindex rmail-secondary-file-regexp
@c   You can also select an Rmail file from a menu.  Choose first the menu
@c bar Classify item, then from the Classify menu choose the Input Rmail
@c File item; then choose the Rmail file you want.  The variables
@c @code{rmail-secondary-file-directory} and
@c @code{rmail-secondary-file-regexp} specify which files to offer in the
@c menu: the first variable says which directory to find them in; the
@c second says which files in that directory to offer (all those that match
@c the regular expression).  These variables also apply to choosing a file
@c for output (@pxref{Rmail Output}).
$B%a%K%e!<$+$i(Brmail$B%U%!%$%k$rA*Br$9$k$3$H$b$G$-$^$9!#(B
$B$^$:!"%a%K%e!<%P!<$+$i9`L\(BClassify$B$rA*$S$^$9!#(B
$BB3$$$F!"(BClassify$B%a%K%e!<$+$i9`L\(BInput Rmail File$B$rA*$S$^$9!#(B
$B$=$7$F!"K>$_$N(Brmail$B%U%!%$%k$rA*Br$7$^$9!#(B
$BJQ?t(B@code{rmail-secondary-file-directory}$B$H(B 
$BJQ?t(B@code{rmail-secondary-file-regexp}$B$G!"(B
$B%a%K%e!<$K4^$a$k$Y$-%U%!%$%k$r;XDj$7$^$9!#(B
$B:G=i$NJQ?t$G$OC5$9$Y$-%G%#%l%/%H%j$r;XDj$7!"(B
2$BHVL\$NJQ?t$G$O%G%#%l%/%H%jCf$N$I$N%U%!%$%k$+(B
$B!J@55,I=8=$K0lCW$9$k$b$N!K$r;XDj$7$^$9!#(B
$B$3$l$i$NJQ?t$O=PNOMQ$N%U%!%$%k$rA*Br$9$k$H$-$K$b;H$o$l$^$9!#(B

@findex set-rmail-inbox-list
@c   Each Rmail file can contain a list of inbox file names; you can specify
@c this list with @kbd{M-x set-rmail-inbox-list @key{RET} @var{files}
@c @key{RET}}.  The argument can contain any number of file names, separated
@c by commas.  It can also be empty, which specifies that this file should
@c have no inboxes.  Once a list of inboxes is specified, the Rmail file
@c remembers it permanently until you specify a different list.
$B3F(Brmail$B%U%!%$%k$K$O!"(Binbox$B%U%!%$%kL>$N0lMw$r;}$?$;$k$3$H$,$G$-$^$9!#(B
$B$3$N0lMw$O!"(B@kbd{M-x set-rmail-inbox-list @key{RET}
@var{files} @key{RET}}$B$G;XDj$7$^$9!#(B
$B0z?t$K$O!"%3%s%^$G6h@Z$C$F$$$/$D$b%U%!%$%kL>$r=q$1$^$9!#(B
$B0z?t$,6u$G$b$+$^$$$^$;$s$,!"$=$N>l9g!"(B
$B$=$N%U%!%$%k$K$O(Binbox$B$,$J$$$H$$$&;XDj$K$J$j$^$9!#(B
$B$$$C$?$s(Binbox$B$N0lMw$r;XDj$9$l$P!"?7$?$K;XDj$7D>$5$J$$8B$j!"(B
rmail$B%U%!%$%k$O$=$l$r3P$($F$$$^$9!#(B

@c   As a special exception, if your primary Rmail file does not specify any
@c inbox files, it uses your standard system inbox.
$BFCJL$JNc30$H$7$F!"<g(Brmail$B%U%!%$%k$K(Binbox$B%U%!%$%k$r;XDj$7$J$$$H!"(B
$B%7%9%F%`I8=`$N(Binbox$B$r;HMQ$7$^$9!#(B

@c @kindex g @r{(Rmail)}
@kindex g @r{$B!J(Brmail$B!K(B}
@findex rmail-get-new-mail
@c   The @kbd{g} command (@code{rmail-get-new-mail}) merges mail into the
@c current Rmail file from its specified inboxes.  If the Rmail file
@c has no inboxes, @kbd{g} does nothing.  The command @kbd{M-x rmail}
@c also merges new mail into your primary Rmail file.
@kbd{g}$B!J(B@code{rmail-get-new-mail}$B!K%3%^%s%I$O!"(B
$B;XDj$5$l$?(Binbox$B$+$i8=:_$N(Brmail$B%U%!%$%k$K%a%$%k$rJ;9g$7$^$9!#(B
rmail$B%U%!%$%k$K(Binbox$B$,;XDj$5$l$F$$$J$1$l$P!"(B@kbd{g}$B$O2?$b$7$^$;$s!#(B
$B%3%^%s%I(B@kbd{M-x rmail}$B$b!"<g(Brmail$B%U%!%$%k$K?7Ce%a%$%k$rJ;9g$7$^$9!#(B

@c   To merge mail from a file that is not the usual inbox, give the
@c @kbd{g} key a numeric argument, as in @kbd{C-u g}.  Then it reads a file
@c name and merges mail from that file.  The inbox file is not deleted or
@c changed in any way when @kbd{g} with an argument is used.  This is,
@c therefore, a general way of merging one file of messages into another.
$BIaDL$N(Binbox$B$G$J$$%U%!%$%k$+$i%a%$%k$rJ;9g$9$k$K$O!"(B
@kbd{C-u g}$B$N$h$&$K(B@kbd{g}$B%-!<$K?t0z?t$r;XDj$7$^$9!#(B
$B$9$k$H!"%U%!%$%kL>$rFI$_<h$j!"$=$N%U%!%$%k$+$i%a%$%k$rJ;9g$7$^$9!#(B
@kbd{g}$B$K0z?t$r;XDj$7$?$H$-$K$O!"(B
inbox$B%U%!%$%k$r:o=|$7$?$jJQ99$7$?$j$7$^$;$s!#(B
$B$7$?$,$C$F!"$3$l$O!"%a%C%;!<%8%U%!%$%k$rJL$N%a%C%;!<%8%U%!%$%k$X(B
$BJ;9g$9$k0lHLE*$JJ}K!$G$9!#(B

@node Rmail Output
@c @section Copying Messages Out to Files
@section $B%U%!%$%k$X$N%a%C%;!<%8$N%3%T!<(B

@c   These commands copy messages from an Rmail file into another file.
$B0J2<$N%3%^%s%I$G!"(Brmail$B%U%!%$%k$+$iJL$N%U%!%$%k$X%a%C%;!<%8$r%3%T!<$G$-$^$9!#(B

@table @kbd
@item o @var{file} @key{RET}
@c Append a copy of the current message to the file @var{file}, using Rmail
@c file format by default (@code{rmail-output-to-rmail-file}).
$B%G%U%)%k%H$G$O(Brmail$B%U%!%$%k7A<0$rMQ$$$F!"(B
$B%+%l%s%H%a%C%;!<%8$N%3%T!<$r%U%!%$%k(B@var{file}$B$XDI2C$9$k!#(B
$B!J(B@code{rmail-output-to-rmail-file}$B!K!#(B

@item C-o @var{file} @key{RET}
@c Append a copy of the current message to the file @var{file}, using
@c system inbox file format by default (@code{rmail-output}).
$B%G%U%)%k%H$G$O%7%9%F%`$N(Binbox$B%U%!%$%k7A<0$rMQ$$$F!"(B
$B%+%l%s%H%a%C%;!<%8$N%3%T!<$r%U%!%$%k(B@var{file}$B$XDI2C$9$k!#(B

@item w @var{file} @key{RET}
@c Output just the message body to the file @var{file}, taking the default
@c file name from the message @samp{Subject} header.
$B%a%C%;!<%8$N%X%C%@(B@samp{Subject}$B$+$i%G%U%)%k%H$N%U%!%$%kL>$r:n$j!"(B
$B%a%C%;!<%8$NK\J8$@$1$r%U%!%$%k(B@var{file}$B$K=q$-=P$9!#(B
@end table

@c @kindex o @r{(Rmail)}
@kindex o @r{$B!J(Brmail$B!K(B}
@findex rmail-output-to-rmail-file
@c @kindex C-o @r{(Rmail)}
@kindex C-o @r{$B!J(Brmail$B!K(B}
@findex rmail-output
@c   The commands @kbd{o} and @kbd{C-o} copy the current message into a
@c specified file.  This file may be an Rmail file or it may be in system
@c inbox format; the output commands ascertain the file's format and write
@c the copied message in that format.
$B%3%^%s%I(B@kbd{o}$B$H(B@kbd{C-o}$B$O!"(B
$B%+%l%s%H%a%C%;!<%8$r;XDj$7$?%U%!%$%k$X%3%T!<$7$^$9!#(B
$B$=$N%U%!%$%k$O!"(Brmail$B%U%!%$%k$G$b%7%9%F%`$N(Binbox$B7A<0$G$b$+$^$$$^$;$s!#(B
$B=PNO%3%^%s%I$O!"%U%!%$%k$N7A<0$r3N$+$a$=$N7A<0$K=>$C$F(B
$B%a%C%;!<%8$N%3%T!<$r=q$-9~$_$^$9!#(B

@c   When copying a message to a file in Unix mail file format, these
@c commands include whichever header fields are currently visible.  Use the
@c @kbd{t} command first, if you wish, to specify which headers to show
@c (and copy).
$B%a%C%;!<%8$r(BUNIX$B$N(Bmail$B%U%!%$%k7A<0$N%U%!%$%k$K%3%T!<$9$k>l9g!"(B
$B$3$l$i$N%3%^%s%I$O8=:_I=<($7$F$$$k%X%C%@$b%3%T!<$7$^$9!#(B
$BI=<(!J$7%3%T!<!K$9$k%X%C%@$r;XDj$7$?$$>l9g$K$O!"(B
$B$"$i$+$8$a(B@kbd{t}$B%3%^%s%I$r;H$C$F$/$@$5$$!#(B

@c   The @kbd{o} and @kbd{C-o} commands differ in two ways: each has its
@c own separate default file name, and each specifies a choice of format to
@c use when the file does not already exist.  The @kbd{o} command uses
@c Rmail format when it creates a new file, while @kbd{C-o} uses system
@c inbox format for a new file.  The default file name for @kbd{o} is the
@c file name used last with @kbd{o}, and the default file name for
@c @kbd{C-o} is the file name used last with @kbd{C-o}.
$B%3%^%s%I(B@kbd{o}$B$H(B@kbd{C-o}$B$O(B2$B$D$NE@$G0[$j$^$9!#(B
$B$=$l$>$l!"FH<+$N%G%U%)%k%H$N%U%!%$%kL>$r;}$A!"(B
$B%U%!%$%k$,4{B8$G$J$$>l9g$K;HMQ$9$k7A<0$bJL$G$9!#(B
$B?7$?$K%U%!%$%k$r:n@.$9$k$H$-!"(B
@kbd{o}$B%3%^%s%I$O(Brmail$B7A<0$r;H$$$^$9$,!"(B
@kbd{C-o}$B%3%^%s%I$O%7%9%F%`$N(Binbox$B7A<0$r;H$$$^$9!#(B
$B%G%U%)%k%H$N%U%!%$%kL>$O!"(B
@kbd{o}$B$G$O:G8e$K(B@kbd{o}$B$G;H$C$?$b$N$K$J$j!"(B
@kbd{C-o}$B$b:G8e$K(B@kbd{C-o}$B$G;H$C$?$b$N$G$9!#(B

@c   If the output file is an Rmail file currently visited in an Emacs buffer,
@c the output commands copy the message into that buffer.  It is up to you
@c to save the buffer eventually in its file.
$B=PNO%U%!%$%k$,!"8=:_(BEmacs$B%P%C%U%!$GK,$l$F$$$k(Brmail$B%U%!%$%k$N$H$-$K$O!"(B
$B=PNO%3%^%s%I$O%a%C%;!<%8$r%P%C%U%!$K%3%T!<$7$^$9!#(B
$B$=$N%P%C%U%!$r%U%!%$%k$KJ]B8$9$k$N$O%f!<%6!<$N@UG$$G$9!#(B

@c @kindex w @r{(Rmail)}
@kindex w @r{$B!J(Brmail$B!K(B}
@findex rmail-output-body-to-file
@c   Sometimes you may receive a message whose body holds the contents of a
@c file.  You can save the body to a file (excluding the message header)
@c with the @kbd{w} command (@code{rmail-output-body-to-file}).  Often
@c these messages contain the intended file name in the @samp{Subject}
@c field, so the @kbd{w} command uses the @samp{Subject} field as the
@c default for the output file name.  However, the file name is read using
@c the minibuffer, so you can specify a different name if you wish.
$B$H$-$I$-!"%U%!%$%k$NFbMF$r$=$N$^$^K\J8$K$7$?$h$&$J%a%C%;!<%8$r(B
$B<u$1<h$k$3$H$b$"$k$G$7$g$&!#(B
@kbd{w}$B!J(B@code{rmail-output-body-to-file}$B!K%3%^%s%I$G!"(B
$B!J%a%C%;!<%8$N%X%C%@$r=|$$$F!KK\J8$r%U%!%$%k$KJ]B8$G$-$^$9!#(B
$B$3$&$7$?%a%C%;!<%8$G$O!"(B@samp{Subject}$B%U%#!<%k%I$K0U?^$9$k%U%!%$%kL>$,(B
$BF~$l$F$$$k$3$H$,$^$^$"$k$N$G!"(B
@kbd{w}$B%3%^%s%I$O%G%U%)%k%H$N=PNO%U%!%$%kL>$K(B
@samp{Subject}$B%U%#!<%k%I$r;H$$$^$9!#(B
$B$7$+$7!"%_%K%P%C%U%!$G%U%!%$%kL>$rFI$_<h$k$N$G!"(B
$B9%$-$J%U%!%$%kL>$r;XDj$G$-$^$9!#(B

@c   You can also output a message to an Rmail file chosen with a menu.
@c Choose first the menu bar Classify item, then from the Classify menu
@c choose the Output Rmail File menu item; then choose the Rmail file you want.
@c This outputs the current message to that file, like the @kbd{o} command.
@c The variables @code{rmail-secondary-file-directory} and
@c @code{rmail-secondary-file-regexp} specify which files to offer in the
@c menu: the first variable says which directory to find them in; the
@c second says which files in that directory to offer (all those that match
@c the regular expression).
$B%a%K%e!<$r;H$C$F(Brmail$B%U%!%$%k$K%a%C%;!<%8$r=PNO$9$k$3$H$b$G$-$^$9!#(B
$B$^$:!"%a%K%e!<%P!<$N9`L\(BClassify$B$rA*Br$7!"(B
Classify$B%a%K%e!<$+$i9`L\(BOutput Rmail File Menu$B$rA*Br$7$^$9!#(B
$B$=$7$F!"K>$`(Brmail$B%U%!%$%k$rA*Br$7$^$9!#(B
$B$3$l$O!"(B@kbd{o}$B%3%^%s%I$N$h$&$K!"(B
$B%+%l%s%H%a%C%;!<%8$r$=$N%U%!%$%k$K=PNO$7$^$9!#(B
$BJQ?t(B@code{rmail-secondary-file-directory}$B$H(B 
$BJQ?t(B@code{rmail-secondary-file-regexp}$B$G!"(B
$B%a%K%e!<$K4^$a$k$Y$-%U%!%$%kL>$rA*Br$7$^$9!#(B
$B:G=i$NJQ?t$G$OC5$9$Y$-%G%#%l%/%H%j$r;XDj$7!"(B
2$BHVL\$NJQ?t$G$O%G%#%l%/%H%jCf$N$I$N%U%!%$%k$+(B
$B!J@55,I=8=$K0lCW$9$k$b$N!K$r;XDj$7$^$9!#(B

@vindex rmail-delete-after-output
@c   Copying a message gives the original copy of the message the
@c @samp{filed} attribute, so that @samp{filed} appears in the mode line
@c when such a message is current.  If you like to keep just a single copy
@c of every mail message, set the variable @code{rmail-delete-after-output}
@c to @code{t}; then the @kbd{o} and @kbd{C-o} commands delete the original
@c message after copying it.  (You can undelete the original afterward if
@c you wish.)
$B%a%C%;!<%8$r%3%T!<$9$k$H!"$b$H$N%a%C%;!<%8$K$O(B@samp{filed}$BB0@-$,IU$-$^$9!#(B
$B$=$N%a%C%;!<%8$,%+%l%s%H%a%C%;!<%8$K$J$k$H!"(B
$B%b!<%I9T$K(B@samp{filed}$B$HI=<($5$l$^$9!#(B
$B%a%$%k%a%C%;!<%8$r$=$l$>$l(B1$B8D$@$1$K$7$F$*$-$?$$>l9g$K$O!"(B
$BJQ?t(B@code{rmail-delete-after-output}$B$K(B@code{t}$B$r@_Dj$7$^$9!#(B 
$B$9$k$H!"%3%^%s%I(B@kbd{o}$B$H(B@kbd{C-o}$B$O!"%a%C%;!<%8$r%3%T!<$9$k$H(B
$B$b$H$N%a%C%;!<%8$r:o=|$7$^$9!#(B
$B!JI,MW$J$i$P!"$b$H$N%a%C%;!<%8$r%"%s%G%j!<%H$G$-$^$9!#!K(B

@c   Copying messages into files in system inbox format uses the header
@c fields that are displayed in Rmail at the time.  Thus, if you use the
@c @kbd{t} command to view the entire header and then copy the message, the
@c entire header is copied.  @xref{Rmail Display}.
$B%7%9%F%`$N(Binbox$B7A<0$G%U%!%$%k$K%a%C%;!<%8$r%3%T!<$9$k$H$-$K$O!"(B
rmail$B$G:#I=<($7$F$$$k%X%C%@%U%#!<%k%I$r;H$$$^$9!#(B
$B$7$?$,$C$F!"(B@kbd{t}$B%3%^%s%I$r;H$C$F%X%C%@A4BN$r8+$($k$h$&$K$7$F$+$i(B
$B%a%C%;!<%8$r%3%T!<$9$k$H!"%X%C%@A4BN$,%3%T!<$5$l$^$9!#(B
@xref{Rmail Display}$B!#(B

@vindex rmail-output-file-alist
@c   The variable @code{rmail-output-file-alist} lets you specify
@c intelligent defaults for the output file, based on the contents of the
@c current message.  The value should be a list whose elements have this
@c form:
$BJQ?t(B@code{rmail-output-file-alist}$B$r;H$&$H!"(B
$B%+%l%s%H%a%C%;!<%8$NFbMF$K4p$E$$$F(B
$B%G%U%)%k%H$N=PNO%U%!%$%k$r8-$/;XDj$G$-$^$9!#(B
$BCM$O$D$.$N7A<0$NMWAG$+$i@.$k%j%9%H$G$"$kI,MW$,$"$j$^$9!#(B

@example
(@var{regexp} . @var{name-exp})
@end example

@noindent
@c If there's a match for @var{regexp} in the current message, then the
@c default file name for output is @var{name-exp}.  If multiple elements
@c match the message, the first matching element decides the default file
@c name.  The subexpression @var{name-exp} may be a string constant giving
@c the file name to use, or more generally it may be any Lisp expression
@c that returns a file name as a string.  @code{rmail-output-file-alist}
@c applies to both @kbd{o} and @kbd{C-o}.
$B%+%l%s%H%a%C%;!<%8$,(B@var{regexp}$B$G;XDj$5$l$k%Q%?!<%s$K0lCW$9$k$H!"(B
$B%G%U%)%k%H$N=PNO%U%!%$%kL>$O(B@var{name-exp}$B$K$J$j$^$9!#(B
$BJ#?t$NMWAG$,%a%C%;!<%8$K0lCW$9$k>l9g$O!"(B
$B:G=i$K0lCW$7$?MWAG$,%G%U%)%k%H$N%U%!%$%kL>$K$J$j$^$9!#(B
$BItJ,MWAG(B@var{name-exp}$B$O!"%U%!%$%kL>$r;XDj$9$kJ8;zNs$+!"(B
$B$h$j0lHLE*$K$O!"J8;zNs$H$7$F%U%!%$%kL>$rJV$9(BLisp$B<0$G$9!#(B
$BJQ?t(B@code{rmail-output-file-alist}$B$O!"(B
@kbd{o}$B$H(B@kbd{C-o}$B$NN>J}$KE,MQ$5$l$^$9!#(B

@node Rmail Labels
@c @section Labels
@section $B%i%Y%k(B
@c @cindex label (Rmail)
@c @cindex attribute (Rmail)
@cindex $B%i%Y%k!J(Brmail$B!K(B
@cindex $BB0@-!J(Brmail$B!K(B

@c   Each message can have various @dfn{labels} assigned to it as a means
@c of classification.  Each label has a name; different names are different
@c labels.  Any given label is either present or absent on a particular
@c message.  A few label names have standard meanings and are given to
@c messages automatically by Rmail when appropriate; these special labels
@c are called @dfn{attributes}.
$B3F%a%C%;!<%8$K$OJ,N`$N$?$a$K$$$m$$$m$J(B@dfn{$B%i%Y%k(B}$B!J(Blabel$B!K$,IU$-$^$9!#(B
$B3F%i%Y%k$K$OL>A0$,$"$C$F!"L>A0$,0[$J$l$PJL$N%i%Y%k$G$9!#(B
$B$I$N%i%Y%k$b%a%C%;!<%8$KIU$$$F$$$k$+IU$$$F$$$J$$$+$N$I$A$i$+$G$9!#(B
$B>/?t$N%i%Y%kL>$K$OI8=`E*$J0UL#$,$"$j!"(B
$BE,@Z$J>l9g$K$O(Brmail$B$,<+F0E*$K%a%C%;!<%8$KIU$1$^$9!#(B
$B$3$l$i$NFCJL$J%i%Y%k$r(B@dfn{$BB0@-(B}$B!J(Battribute$B!K$H8F$S$^$9!#(B
@ifinfo
@c (@xref{Rmail Attributes}.)
$B!J(B@pxref{Rmail Attributes}$B!#!K(B
@end ifinfo
@c All other labels are assigned only by users.
$B$=$l0J30$N$9$Y$F$N%i%Y%k$O%f!<%6!<$@$1$,IU$1$^$9!#(B

@table @kbd
@item a @var{label} @key{RET}
@c Assign the label @var{label} to the current message (@code{rmail-add-label}).
$B%+%l%s%H%a%C%;!<%8$K%i%Y%k(B@var{label}$B$rIU$1$k(B
$B!J(B@code{rmail-add-label}$B!K!#(B
@item k @var{label} @key{RET}
@c Remove the label @var{label} from the current message (@code{rmail-kill-label}).
$B%+%l%s%H%a%C%;!<%8$+$i%i%Y%k(B@var{label}$B$r<h$j5n$k(B
$B!J(B@code{rmail-kill-label}$B!K!#(B
@item C-M-n @var{labels} @key{RET}
@c Move to the next message that has one of the labels @var{labels}
@c (@code{rmail-next-labeled-message}).
$B%i%Y%k72(B@var{labels}$B$N$I$l$+(B1$B$D$r;}$D$D$.$N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-next-labeled-message}$B!K!#(B
@item C-M-p @var{labels} @key{RET}
@c Move to the previous message that has one of the labels @var{labels}
@c (@code{rmail-previous-labeled-message}).
$B%i%Y%k72(B@var{labels}$B$N$I$l$+(B1$B$D$r;}$D$^$($N%a%C%;!<%8$X0\F0$9$k(B
$B!J(B@code{rmail-previous-labeled-message}$B!K!#(B
@item C-M-l @var{labels} @key{RET}
@c Make a summary of all messages containing any of the labels @var{labels}
@c (@code{rmail-summary-by-labels}).
$B%i%Y%k72(B@var{labels}$B$N$I$l$+$r;}$D$9$Y$F$N(B
$B%a%C%;!<%8$N%5%^%j$r:n@.$9$k(B
$B!J(B@code{rmail-summary-by-labels}$B!K!#(B
@end table

@c @kindex a @r{(Rmail)}
@c @kindex k @r{(Rmail)}
@kindex a @r{$B!J(Brmail$B!K(B}
@kindex k @r{$B!J(Brmail$B!K(B}
@findex rmail-add-label
@findex rmail-kill-label
@c   The @kbd{a} (@code{rmail-add-label}) and @kbd{k}
@c (@code{rmail-kill-label}) commands allow you to assign or remove any
@c label on the current message.  If the @var{label} argument is empty, it
@c means to assign or remove the same label most recently assigned or
@c removed.
$B%3%^%s%I(B@kbd{a}$B!J(B@code{rmail-add-label}$B!K$H(B
@kbd{k}$B!J(B@code{rmail-kill-label}$B!K$G!"(B
$B%+%l%s%H%a%C%;!<%8$KG$0U$N%i%Y%k$rIU$1$?$j<h$j5n$C$?$j$G$-$^$9!#(B
$B0z?t$,6u$N>l9g$O!"$b$C$H$b:G6a$KIU$1$?$j<h$j5n$C$?$j$7$?$b$N$H(B
$BF1$8%i%Y%k$r0UL#$7$^$9!#(B

@c   Once you have given messages labels to classify them as you wish, there
@c are two ways to use the labels: in moving and in summaries.
$BJ,N`$9$k$?$a$N%i%Y%k$r%a%C%;!<%8$K$$$C$?$sIU$1$l$P!"(B
$B$=$N%i%Y%k$r;H$C$F(B2$B$D$N$3$H!"$D$^$j!"0\F0$H%5%^%j:n@.$,$G$-$^$9!#(B

@c @kindex C-M-n @r{(Rmail)}
@c @kindex C-M-p @r{(Rmail)}
@kindex C-M-n @r{$B!J(Brmail$B!K(B}
@kindex C-M-p @r{$B!J(Brmail$B!K(B}
@findex rmail-next-labeled-message
@findex rmail-previous-labeled-message
@c   The command @kbd{C-M-n @var{labels} @key{RET}}
@c (@code{rmail-next-labeled-message}) moves to the next message that has
@c one of the labels @var{labels}.  The argument @var{labels} specifies one
@c or more label names, separated by commas.  @kbd{C-M-p}
@c (@code{rmail-previous-labeled-message}) is similar, but moves backwards
@c to previous messages.  A numeric argument to either command serves as a
@c repeat count.
$B%3%^%s%I(B@kbd{C-M-n @var{labels} @key{RET}}$B!J(B@code{rmail-next-labeled-message}$B!K(B
$B$O!"%i%Y%k72(B@var{labels}$B$N$I$l$+(B1$B$D$r;}$D$D$.$N%a%C%;!<%8$X0\F0$7$^$9!#(B
$B0z?t(B@var{labels}$B$K$O!"(B1$B$D$N%i%Y%kL>!"$"$k$$$O!"(B
$B%3%s%^$G6h@Z$C$FJ#?t$N%i%Y%kL>$r;XDj$7$^$9!#(B
@kbd{C-M-p}$B!J(B@code{rmail-previous-labeled-message}$B!K$bF1MM$G$9$,!"(B
$B$^$($N%a%C%;!<%8$X8~$+$C$F5U8~$-$K0\F0$7$^$9!#(B
$B$3$l$i$N%3%^%s%I$KBP$9$k?t0z?t$O!"H?I|2s?t$K$J$j$^$9!#(B

@c   The command @kbd{C-M-l @var{labels} @key{RET}}
@c (@code{rmail-summary-by-labels}) displays a summary containing only the
@c messages that have at least one of a specified set of labels.  The
@c argument @var{labels} is one or more label names, separated by commas.
@c @xref{Rmail Summary}, for information on summaries.@refill
$B%3%^%s%I(B@kbd{C-M-l @var{labels} @key{RET}}$B!J(B@code{rmail-summary-by-labels}$B!K(B
$B$O!";XDj$7$?%i%Y%k$N=8$^$j$NCf$N>/$J$/$H$b(B1$B$D$N%i%Y%k$r;}$D$h$&$J(B
$B%a%C%;!<%8$+$i$J$k%5%^%j$rI=<($7$^$9!#(B
$B0z?t(B@var{labels}$B$O!"(B1$B$D$N%i%Y%kL>!"$"$k$$$O!"(B
$B%3%s%^$G6h@Z$C$?J#?t$N%i%Y%kL>$G$9!#(B
$B%5%^%j$K$D$$$F$O!"(B@xref{Rmail Summary}$B!#(B

@c   If the @var{labels} argument to @kbd{C-M-n}, @kbd{C-M-p} or
@c @kbd{C-M-l} is empty, it means to use the last set of labels specified
@c for any of these commands.
@kbd{C-M-n}$B!"(B@kbd{C-M-p}$B!"(B@kbd{C-M-l}$B$KBP$9$k0z?t(B@var{labels}$B$,6u$N>l9g$K$O!"(B
$B$3$l$i$N%3%^%s%I$N$I$l$+$K$b$C$H$b:G6a$K;XDj$7$?%i%Y%k$N=8$^$j$r0UL#$7$^$9!#(B

@node Rmail Attributes
@c @section Rmail Attributes
@section rmail$B$NB0@-(B

@c   Some labels such as @samp{deleted} and @samp{filed} have built-in
@c meanings and are assigned to or removed from messages automatically at
@c appropriate times; these labels are called @dfn{attributes}.  Here is a
@c list of Rmail attributes:
@samp{deleted}$B$d(B@samp{filed}$B$N$h$&$J%i%Y%k$N$$$/$D$+$K$O(B
$BAH$_9~$_$N0UL#IU$1$,$"$j!"(B
$BE,@Z$J$H$-$K<+F0E*$K%a%C%;!<%8$KIU$1$i$l$?$j<h$j5n$i$l$?$j$7$^$9!#(B
$B$3$N$h$&$J%i%Y%k$r(B@dfn{$BB0@-(B}$B!J(Battribute$B!K$H8F$S$^$9!#(B
$B0J2<$O(Brmail$B$NB0@-$N0lMw$G$9!#(B

@table @samp
@item unseen
@c Means the message has never been current.  Assigned to messages when
@c they come from an inbox file, and removed when a message is made
@c current.  When you start Rmail, it initially shows the first message
@c that has this attribute.
$B%a%C%;!<%8$,0lEY$b%+%l%s%H%a%C%;!<%8$K$J$C$?$3$H$,$J$$$3$H$r0UL#$9$k!#(B
inbox$B%U%!%$%k$+$i<h$j9~$^$?$H$-$K%a%C%;!<%8$KIU$1$i$l!"(B
$B%a%C%;!<%8$,%+%l%s%H%a%C%;!<%8$K$J$k$H<h$j5n$i$l$k!#(B
rmail$B$r5/F0$9$k$H!"$^$:$3$NB0@-$r;}$D:G=i$N%a%C%;!<%8$,I=<($5$l$k!#(B
@item deleted
@c Means the message is deleted.  Assigned by deletion commands and
@c removed by undeletion commands (@pxref{Rmail Deletion}).
$B%a%C%;!<%8$,:o=|$5$l$?$3$H$r0UL#$9$k!#(B
$B:o=|%3%^%s%I$,IU$1!"%"%s%G%j!<%H%3%^%s%I$,<h$j5n$k(B
$B!J(B@pxref{Rmail Deletion}$B!K!#(B
@item filed
@c Means the message has been copied to some other file.  Assigned by the
@c file output commands (@pxref{Rmail Files}).
$B%a%C%;!<%8$OB>$N%U%!%$%k$X%3%T!<$5$l$?$3$H$r0UL#$9$k!#(B
$B%U%!%$%k=PNO%3%^%s%I$,IU$1$k(B
$B!J(B@pxref{Rmail Files}$B!K!#(B
@item answered
@c Means you have mailed an answer to the message.  Assigned by the @kbd{r}
@c command (@code{rmail-reply}).  @xref{Rmail Reply}.
$B%a%C%;!<%8$KJV?.$7$?$3$H$r0UL#$9$k!#(B
@kbd{r}$B!J(B@code{rmail-reply}$B!K%3%^%s%I$,IU$1$k!#(B
@pxref{Rmail Reply}$B!#(B
@item forwarded
@c Means you have forwarded the message.  Assigned by the @kbd{f} command
@c (@code{rmail-forward}).  @xref{Rmail Reply}.
$B%a%C%;!<%8$rB><T$KE>Aw$7$?$3$H$r0UL#$9$k!#(B
@kbd{f}$B!J(B@code{rmail-forward}$B!K%3%^%s%I$,IU$1$k!#(B
@pxref{Rmail Reply}$B!#(B
@item edited
@c Means you have edited the text of the message within Rmail.
@c @xref{Rmail Editing}.
rmail$BFb$G%a%C%;!<%8$N%F%-%9%H$rJT=8$7$?$3$H$r0UL#$9$k!#(B
@pxref{Rmail Editing}$B!#(B
@item resent
@c Means you have resent the message.  Assigned by the command @kbd{M-x
@c rmail-resend}.  @xref{Rmail Reply}.
$B%a%C%;!<%8$r:FAw?.$7$?$3$H$r0UL#$9$k!#(B
@kbd{M-xrmail-resend}$B%3%^%s%I$,IU$1$k!#(B
@pxref{Rmail Reply}$B!#(B
@end table

@c   All other labels are assigned or removed only by the user, and have no
@c standard meaning.
$B$3$l$i0J30$N$9$Y$F$N%i%Y%k$O%f!<%6!<$@$1$,IU$1$?$j<h$j5n$C$?$j$9$k$N$G$"$C$F!"(B
$BI8=`E*$J0UL#$O$^$C$?$/$"$j$^$;$s!#(B

@node Rmail Reply
@c @section Sending Replies
@section $BJV;v$NAw?.(B

@c   Rmail has several commands that use Mail mode to send outgoing mail.
@c @xref{Sending Mail}, for information on using Mail mode, including
@c certain features meant to work with Rmail.  What this section documents
@c are the special commands of Rmail for entering Mail mode.  Note that the
@c usual keys for sending mail---@kbd{C-x m}, @kbd{C-x 4 m}, and @kbd{C-x 5
@c m}---are available in Rmail mode and work just as they usually do.
rmail$B$K$O!"%a%$%k$NAw?.$K%a%$%k!J(Bmail$B!K%b!<%I$r;H$&%3%^%s%I$,(B
$B$$$/$D$+$"$j$^$9!#(B
$B%a%$%k!J(Bmail$B!K%b!<%I$N;HMQJ}K!$K$D$$$F$O!"(Brmail$B$+$i;H$($k$"$k<o$N5!G=$b4^$a$F!"(B
@xref{Sending Mail}$B!#(B
$BK\@a$G$O!"%a%$%k!J(Bmail$B!K%b!<%I$XF~$k(Brmail$B$KFCM-$N%3%^%s%I$r@bL@$7$^$9!#(B
$B%a%$%kAw?.$N$?$a$NDL>o$N%-!<!"(B
@kbd{C-x m}$B!"(B@kbd{C-x 4 m}$B!"(B@kbd{C-x 5 m}$B$O!"(B
rmail$B%b!<%I$G$b;H$(!"$=$NF0:n$b$^$C$?$/F1$8$G$"$k$3$H$KCm0U$7$F$/$@$5$$!#(B

@table @kbd
@item m
@c Send a message (@code{rmail-mail}).
$B%a%C%;!<%8$rAw?.$9$k!J(B@code{rmail-mail}$B!K!#(B
@item c
@c Continue editing the already started outgoing message (@code{rmail-continue}).
$B=q$-;O$a$?%a%C%;!<%8$NJT=8$r:F3+$9$k!J(B@code{rmail-continue}$B!K!#(B
@item r
@c Send a reply to the current Rmail message (@code{rmail-reply}).
$B%+%l%s%H%a%C%;!<%8$KBP$9$kJV;v$rAw?.$9$k!J(B@code{rmail-reply}$B!K!#(B
@item f
@c Forward the current message to other users (@code{rmail-forward}).
$B%+%l%s%H%a%C%;!<%8$rB>$N%f!<%6!<$KE>Aw$9$k!J(B@code{rmail-forward}$B!K!#(B
@item C-u f
@c Resend the current message to other users (@code{rmail-resend}).
$B%+%l%s%H%a%C%;!<%8$rB>$N%f!<%6!<$K:FAw?.$9$k!J(B@code{rmail-resend}$B!K!#(B
@item M-m
@c Try sending a bounced message a second time (@code{rmail-retry-failure}).
$BAw?.$G$-$:$KLa$C$F$-$?%a%C%;!<%8$r:FEYAw?.$9$k(B
$B!J(B@code{rmail-retry-failure}$B!K!#(B
@end table

@c @kindex r @r{(Rmail)}
@kindex r @r{$B!J(Brmail$B!K(B}
@findex rmail-reply
@c @cindex reply to a message
@cindex $B%a%C%;!<%8$X$NJV?.(B
@c   The most common reason to send a message while in Rmail is to reply to
@c the message you are reading.  To do this, type @kbd{r}
@c (@code{rmail-reply}).  This displays the @samp{*mail*} buffer in another
@c window, much like @kbd{C-x 4 m}, but preinitializes the @samp{Subject},
@c @samp{To}, @samp{CC} and @samp{In-reply-to} header fields based on the
@c message you are replying to.  The @samp{To} field starts out as the
@c address of the person who sent the message you received, and the
@c @samp{CC} field starts out with all the other recipients of that
@c message.
rmail$B$+$i%a%C%;!<%8$rAw?.$9$k$N$O!"$[$H$s$I$N>l9g!"(B
$BFI$s$G$$$k%a%C%;!<%8$KJV?.$9$k$?$a$G$7$g$&!#(B
$B$=$l$K$O!"(B@kbd{r}$B!J(B@code{rmail-reply}$B!K$HBG$A$^$9!#(B
$B$9$k$H!"(B@kbd{C-x 4 m}$B$N$h$&$K(B
$BJL$N%&%#%s%I%&$K(B@samp{*mail*}$B%P%C%U%!$,I=<($5$l$^$9$,!"(B
$BJV;v$r=P$=$&$H$9$k%a%C%;!<%8$K4p$E$$$F(B
@samp{Subject}$B!"(B@samp{To}$B!"(B@samp{CC}$B!"(B@samp{In-reply-to}$B$N(B
$B%X%C%@%U%#!<%k%I$,$"$i$+$8$aKd$a$i$l$F$$$^$9!#(B
@samp{To}$B%U%#!<%k%I$K$O$=$N%a%C%;!<%8$NAw?.<T$,=q$+$l!"(B
@samp{CC}$B%U%#!<%k%I$K$O$=$N%a%C%;!<%8$N$9$Y$F$N<u?.<T$,=q$+$l$^$9!#(B

@vindex rmail-dont-reply-to-names
@c   You can exclude certain recipients from being placed automatically in
@c the @samp{CC}, using the variable @code{rmail-dont-reply-to-names}.  Its
@c value should be a regular expression (as a string); any recipient that
@c the regular expression matches, is excluded from the @samp{CC} field.
@c The default value matches your own name, and any name starting with
@c @samp{info-}.  (Those names are excluded because there is a convention
@c of using them for large mailing lists to broadcast announcements.)
$BJQ?t(B@code{rmail-dont-reply-to-names}$B$r;H$&$H!"(B
@samp{CC}$B$K<+F0E*$K4^$^$l$k<u?.<T$+$iFCDj$N<u?.<T$r=|$/$3$H$,$G$-$^$9!#(B
$B$3$NJQ?t$NCM$O!JJ8;zNs$GI=$7$?!K@55,I=8=$G$"$kI,MW$,$"$j$^$9!#(B
$B$3$N@55,I=8=$K0lCW$9$k<u?.<T$O(B@samp{CC}$B%U%#!<%k%I$+$i=|$+$l$^$9!#(B
$B%G%U%)%k%H$NCM$O!"$"$J$?<+?H$NL>A0$H(B@samp{info-}$B$G;O$^$kL>A0$G$9!#(B
$B!J$3$N$h$&$JL>A0$O!"(B
$BBg5,LO$J%a%$%j%s%0%j%9%H$GA40w$KAw?.$9$k$?$a$K;H$&=,47$,$"$k$+$i!#!K(B

@c   To omit the @samp{CC} field completely for a particular reply, enter
@c the reply command with a numeric argument: @kbd{C-u r} or @kbd{1 r}.
@samp{CC}$B%U%#!<%k%I$r40A4$K>J$$$FJV?.$7$?$$$H$-$K$O!"(B
$B?t0z?t$r;XDj$7$FJV?.%3%^%s%I$rF~NO$7$^$9!#(B
$B$D$^$j!"(B@kbd{C-u r}$B$d(B@kbd{1 r}$B$G$9!#(B

@c   Once the @samp{*mail*} buffer has been initialized, editing and
@c sending the mail goes as usual (@pxref{Sending Mail}).  You can edit the
@c presupplied header fields if they are not right for you.  You can also
@c use the commands of Mail mode (@pxref{Mail Mode}), including @kbd{C-c
@c C-y} which yanks in the message that you are replying to.  You can
@c switch to the Rmail buffer, select a different message there, switch
@c back, and yank the new current message.
$B$R$H$?$S(B@samp{*mail*}$B%P%C%U%!$,=i4|2=$5$l$l$P!"(B
$B%a%$%k$NJT=8$dAw?.$ODL>o$I$*$j$G$9(B
$B!J(B@pxref{Sending Mail}$B!K!#(B
$B$"$i$+$8$aMQ0U$5$l$?%X%C%@%U%#!<%k%I$,E,@Z$G$J$1$l$P!"(B
$BJT=8$7$F$+$^$$$^$;$s!#(B
$B$^$?!"%a%$%k!J(Bmail$B!K%b!<%I$N%3%^%s%I$r;H$&$3$H$b$G$-(B
$B!J(B@pxref{Mail Mode}$B!K!"(B
@kbd{C-c C-y}$B%3%^%s%I$G$b$H$NJV?.%a%C%;!<%8$r%d%s%/$9$k$3$H$b$G$-$^$9!#(B
rmail$B%P%C%U%!$K@Z$jBX$($F$+$iJL$N%a%C%;!<%8$rA*Br$7!"(B
$B$b$H$KLa$C$F?7$7$$%+%l%s%H%a%C%;!<%8$r%d%s%/$7$F$b$+$^$$$^$;$s!#(B

@c @kindex M-m @r{(Rmail)}
@kindex M-m @r{$B!J(Brmail$B!K(B}
@findex rmail-retry-failure
@c @cindex retrying a failed message
@cindex $B<:GT$7$?%a%C%;!<%8$N:FAw?.(B
@vindex rmail-retry-ignored-headers
@c   Sometimes a message does not reach its destination.  Mailers usually
@c send the failed message back to you, enclosed in a @dfn{failure
@c message}.  The Rmail command @kbd{M-m} (@code{rmail-retry-failure})
@c prepares to send the same message a second time: it sets up a
@c @samp{*mail*} buffer with the same text and header fields as before.  If
@c you type @kbd{C-c C-c} right away, you send the message again exactly
@c the same as the first time.  Alternatively, you can edit the text or
@c headers and then send it.  The variable
@c @code{rmail-retry-ignored-headers}, in the same format as
@c @code{rmail-ignored-headers} (@pxref{Rmail Display}), controls which
@c headers are stripped from the failed message when retrying it; it
@c defaults to @code{nil}.
$B%a%C%;!<%8$,Aj<j@h$XFO$+$J$$>l9g$,$"$j$^$9!#(B
$B%a%$%kG[Aw%W%m%0%i%`$O!"DL>o!"(B
$B<:GT$7$?%a%C%;!<%8$r(B@dfn{$B<:GT%a%C%;!<%8(B}$B$KF1Iu$7$F(B
$BH/?.<T$KAw$jJV$7$^$9!#(B
rmail$B$N%3%^%s%I(B@kbd{M-m}$B!J(B@code{rmail-retry-failure}$B!K$O!"(B
$BF1$8%a%C%;!<%8$r:FAw$9$k=`Hw$r$7$^$9!#(B
$BA02s$HF1$8K\J8$H%X%C%@%U%#!<%k%I$G(B@samp{*mail*}$B%P%C%U%!$rN)$A>e$2$^$9!#(B
$B$9$0$K(B@kbd{C-c C-c}$B$HBG$D$H!"(B
$BA02s$H$^$C$?$/F1MM$K%a%C%;!<%8$r:FAw?.$7$^$9!#(B
$B$"$k$$$O!"K\J8$d%X%C%@$rJT=8$7$F$+$iAw?.$9$k$3$H$b$G$-$^$9!#(B
$BJQ?t(B@code{rmail-ignored-headers}$B!J(B@pxref{Rmail Display}$B!K$HF1$87A<0$N(B
$BJQ?t(B@code{rmail-retry-ignored-headers}$B$O!"(B
$B:FAw?.$9$k$H$-$KAw?.$K<:GT$7$?%a%C%;!<%8$+$i<h$j=|$/%X%C%@$r@)8f$7$^$9!#(B
$B%G%U%)%k%H$G$O(B@code{nil}$B$G$9!#(B

@c @kindex f @r{(Rmail)}
@kindex f @r{$B!J(Brmail$B!K(B}
@findex rmail-forward
@c @cindex forwarding a message
@cindex $B%a%C%;!<%8$NE>Aw(B
@c   Another frequent reason to send mail in Rmail is to @dfn{forward} the
@c current message to other users.  @kbd{f} (@code{rmail-forward}) makes
@c this easy by preinitializing the @samp{*mail*} buffer with the current
@c message as the text, and a subject designating a forwarded message.  All
@c you have to do is fill in the recipients and send.  When you forward a
@c message, recipients get a message which is ``from'' you, and which has
@c the original message in its contents.
rmail$B$+$i%a%C%;!<%8$rAw?.$9$kJL$N>lLL$O!"(B
$BB>$N%f!<%6!<$K%a%C%;!<%8$r(B@dfn{$BE>Aw(B}$B!J(Bforward$B!K$9$k$3$H$G$7$g$&!#(B
@kbd{f}$B!J(B@code{rmail-forward}$B!K$O$3$l$r4JC1$K9T$($k$h$&$K$7$^$9!#(B
$B$D$^$j!"%+%l%s%H%a%C%;!<%8$r%F%-%9%H$H$7$F(B@samp{*mail*}$B%P%C%U%!$r=i4|2=$7!"(B
@samp{Subject}$B$bE>Aw%a%C%;!<%8$G$"$k;]$N=i4|2=$r$7$^$9!#(B
$B$"$H$O!"<u?.<T$rKd$a9~$s$GAw?.$9$k$@$1$G$9!#(B
$B%a%C%;!<%8$rE>Aw$7$?$H$-!"<u?.<T$O$"$J$?!X$+$i!Y%a%C%;!<%8$r<u$1<h$j$^$9$,!"(B
$BFbMF$O$b$H$N%a%C%;!<%8$N$^$^$G$9!#(B

@findex unforward-rmail-message
@c   Forwarding a message encloses it between two delimiter lines.  It also
@c modifies every line that starts with a dash, by inserting @w{@samp{- }}
@c at the start of the line.  When you receive a forwarded message, if it
@c contains something besides ordinary text---for example, program source
@c code---you might find it useful to undo that transformation.  You can do
@c this by selecting the forwarded message and typing @kbd{M-x
@c unforward-rmail-message}.  This command extracts the original forwarded
@c message, deleting the inserted @w{@samp{- }} strings, and inserts it
@c into the Rmail file as a separate message immediately following the
@c current one.
$BE>Aw$5$l$k%a%C%;!<%8$O!"(B2$B$D$N6h@Z$j9T$K64$^$l$F$$$^$9!#(B
$B$^$?!"3F9T$O!"9TF,$K(B@w{@samp{- }}$B$rA^F~$7$F%O%$%U%s$G;O$^$k$h$&$K(B
$B=$@5$5$l$^$9!#(B
$BE>Aw%a%C%;!<%8$r<u$1<h$C$F!"$?$H$($P%W%m%0%i%`$N%=!<%9%3!<%I$N$h$&$K(B
$BJ8=q0J30$K2?$+LrN)$D$h$&$J$b$N$,4^$^$l$F$$$k$H$-$K$O!"(B
$B$3$N$h$&$JJQ99$r$b$H$KLa$;$?$iJXMx$G$9!#(B
$B$3$l$r9T$&$K$O!"E>Aw%a%C%;!<%8$rA*Br$7$F(B
@kbd{M-x unforward-rmail-message}$B$HBG$A$^$9!#(B
$B$3$N%3%^%s%I$O!"A^F~$5$l$?(B@w{@samp{- }}$B$r:o=|$7$F$b$H$N%a%C%;!<%8$r<h$j=P$7!"(B
$B$=$l$r(Brmail$B%U%!%$%k$N%+%l%s%H%a%C%;!<%8$ND>8e$KJL$N%a%C%;!<%8$H$7$FA^F~$7$^$9!#(B

@findex rmail-resend
@c   @dfn{Resending} is an alternative similar to forwarding; the
@c difference is that resending sends a message that is ``from'' the
@c original sender, just as it reached you---with a few added header fields
@c @samp{Resent-from} and @samp{Resent-to} to indicate that it came via
@c you.  To resend a message in Rmail, use @kbd{C-u f}.  (@kbd{f} runs
@c @code{rmail-forward}, which is programmed to invoke @code{rmail-resend}
@c if you provide a numeric argument.)
@dfn{$B:FAw(B}$B!J(Bresending$B!K$OE>Aw$K;w$F$$$kJL$N<jCJ$G$9!#(B
$B0[$J$kE@$O!":FAw$O$b$H$b$H$NAw?.<T!X$+$i!Y%a%C%;!<%8$r$b$&0lEYAw$k$3$H$G$9!#(B
$B$^$?!"$"$J$?$+$iAw$i$l$?$3$H$r<($9$?$a$K(B
@samp{Resent-from}$B$H(B@samp{Resent-to}$B$N%X%C%@%U%#!<%k%I$,IU2C$5$l$^$9!#(B
rmail$B$G%a%C%;!<%8$r:FAw$9$k$K$O!"(B@kbd{C-u f}$B$r;H$$$^$9!#(B
$B!J(B@kbd{f}$B$O(B@code{rmail-forward}$B$r<B9T$9$k$,!"(B
$B?t0z?t$r;XDj$9$k$H(B@code{rmail-resend}$B$r<B9T$9$k$h$&$K$J$C$F$$$k!#!K(B

@c @kindex m @r{(Rmail)}
@kindex m @r{$B!J(Brmail$B!K(B}
@findex rmail-mail
@c   The @kbd{m} (@code{rmail-mail}) command is used to start editing an
@c outgoing message that is not a reply.  It leaves the header fields empty.
@c Its only difference from @kbd{C-x 4 m} is that it makes the Rmail buffer
@c accessible for @kbd{C-c C-y}, just as @kbd{r} does.  Thus, @kbd{m} can be
@c used to reply to or forward a message; it can do anything @kbd{r} or @kbd{f}
@c can do.@refill
@kbd{m}$B!J(B@code{rmail-mail}$B!K%3%^%s%I$O!"(B
$BJV?.$G$O$J$$Aw?.%a%C%;!<%8$rJT=8$7;O$a$k$N$K;H$$$^$9!#(B
$B%X%C%@%U%#!<%k%I$O6u$N$^$^$G$9!#(B
$B$3$N%3%^%s%I$H(B@kbd{C-x 4 m}$B$H$NM#0l$N0c$$$O!"(B
$B$A$g$&$I(B@kbd{r}$B$,$9$k$h$&$K(B
@kbd{C-c C-y}$B$G(Brmail$B%P%C%U%!$r;2>H$G$-$k$h$&$K$9$k$3$H$G$9!#(B
$B$7$?$,$C$F!"(B@kbd{m}$B%3%^%s%I$G%a%C%;!<%8$KJV?.$7$?$jE>Aw$7$?$j$G$-$^$9!#(B
@kbd{r}$B$d(B@kbd{f}$B$G$G$-$k$3$H$O2?$G$b$G$-$^$9!#(B

@c @kindex c @r{(Rmail)}
@kindex c @r{$B!J(Brmail$B!K(B}
@findex rmail-continue
@c   The @kbd{c} (@code{rmail-continue}) command resumes editing the
@c @samp{*mail*} buffer, to finish editing an outgoing message you were
@c already composing, or to alter a message you have sent.@refill
@kbd{c}$B!J(B@code{rmail-continue}$B!K%3%^%s%I$O!"(B
$B=q$-$+$1$N%a%C%;!<%8$NJT=8$r40N;$7$?$j!"(B
$BAw?.$7$?%a%C%;!<%8$rJQ99$7$?$j$9$k$?$a$K(B
@samp{*mail*}$B%P%C%U%!$NJT=8$r:F3+$7$^$9!#(B

@vindex rmail-mail-new-frame
@c   If you set the variable @code{rmail-mail-new-frame} to a
@c non-@code{nil} value, then all the Rmail commands to start sending a
@c message create a new frame to edit it in.  This frame is deleted when
@c you send the message, or when you use the @samp{Don't Send} item in the
@c @samp{Mail} menu.
$BJQ?t(B@code{rmail-mail-new-frame}$B$K(B@code{nil}$B0J30$NCM$r@_Dj$9$k$H!"(B
$B%a%C%;!<%8$NAw?.$r;O$a$k$9$Y$F$N(Brmail$B%3%^%s%I$OJT=8MQ$K?7$7$$%U%l!<%`$r(B
$B:n$j$^$9!#(B
$B%a%C%;!<%8$rAw?.$7$?$j(B@samp{Mail}$B%a%K%e!<$N9`L\(B@samp{Don't Send}$B$r;H$&$H!"(B
$B$3$N%U%l!<%`$O:o=|$5$l$^$9!#(B

@c   All the Rmail commands to send a message use the mail-composition
@c method that you have chosen (@pxref{Mail Methods}).
$B%a%C%;!<%8$rAw?.$9$k$?$a$9$Y$F$N(Brmail$B%3%^%s%I$O!"(B
$B$"$J$?$,A*Br$7$?%a%$%k:n@.J}<0$r;H$$$^$9(B
$B!J(B@pxref{Mail Methods}$B!K!#(B

@node Rmail Summary
@c @section Summaries
@section rmail$B$N%5%^%j5!G=(B
@c @cindex summary (Rmail)
@cindex $B%5%^%j!J(Brmail$B!K(B

@c   A @dfn{summary} is a buffer containing one line per message to give
@c you an overview of the mail in an Rmail file.  Each line shows the
@c message number, the sender, the labels, and the subject.  Almost all
@c Rmail commands are valid in the summary buffer also; these apply to the
@c message described by the current line of the summary.  Moving point in
@c the summary buffer selects messages as you move to their summary lines.
@dfn{$B%5%^%j(B}$B!J(Bsummary$B!K$H$O!"(B
rmail$B%U%!%$%k$K$"$k%a%$%k$N35MW$r<($9$?$a$K(B
1$B%a%C%;!<%8$K$D$-(B1$B9T$N>pJs$r<}$a$?%P%C%U%!$G$9!#(B
$B3F9T$K$O!"%a%C%;!<%8HV9f!"Aw?.<T!"%i%Y%k!"(B
$B%5%V%8%'%/%H!J(B@samp{Subject}$B$NFbMF!K$,I=<($5$l$^$9!#(B
$B$[$H$s$I$9$Y$F$N(Brmail$B%3%^%s%I$O%5%^%j%P%C%U%!$G$bM-8z$G!"(B
$B%5%^%j$N8=:_9T$,;X$9%a%C%;!<%8$KE,MQ$5$l$^$9!#(B
$B%5%^%j%P%C%U%!$G%]%$%s%H$rF0$+$9$H!"(B
$B%]%$%s%H$,$"$k9T$,;X$9%a%C%;!<%8$rA*Br$7$^$9!#(B

@c   A summary buffer applies to a single Rmail file only; if you are
@c editing multiple Rmail files, each one can have its own summary buffer.
@c The summary buffer name is made by appending @samp{-summary} to the
@c Rmail buffer's name.  Normally only one summary buffer is displayed at a
@c time.
1$B$D$N%5%^%j%P%C%U%!$O!"$=$l$KBP1~$7$?(B1$B$D$N(Brmail$B%U%!%$%k$K$7$+E,MQ$5$l$^$;$s!#(B
$BJ#?t$N(Brmail$B%U%!%$%k$rJT=8$7$F$$$k>l9g$K$O!"(B
$B$=$l$>$l$K@lMQ$N%5%^%j%P%C%U%!$r:n$l$^$9!#(B
$B%5%^%j%P%C%U%!$NL>A0$O!"(Brmail$B%P%C%U%!$NL>A0$K(B@samp{-summary}$B$r(B
$BIU$12C$($?$b$N$G$9!#(B
$BDL>o!"0lEY$KI=<($5$l$k%5%^%j%P%C%U%!$O(B1$B$D$@$1$G$9!#(B

@menu
* Rmail Make Summary::	     Making various sorts of summaries.
* Rmail Summary Edit::	     Manipulating messages from the summary.
@end menu

@node Rmail Make Summary
@c @subsection Making Summaries
@subsection $B%5%^%j$N:n@.(B

@c   Here are the commands to create a summary for the current Rmail file.
@c Once the Rmail file has a summary buffer, changes in the Rmail file
@c (such as deleting or expunging messages, and getting new mail)
@c automatically update the summary.
$B8=:_$N(Brmail$B%U%!%$%k$N%5%^%j$r:n@.$9$k%3%^%s%I$r@bL@$7$^$9!#(B
$B$$$C$?$s(Brmail$B%U%!%$%k$KBP$9$k%5%^%j%P%C%U%!$r:n$C$F$*$/$H!"(B
$B!J%a%C%;!<%8$N:o=|!?Ku>C!"?7Ce%a%$%k$N<hF@$J$I$G!K(B
rmail$B%U%!%$%k$,JQ99$5$l$k$H<+F0E*$K%5%^%j$b99?7$5$l$^$9!#(B

@table @kbd
@item h
@itemx C-M-h
@c Summarize all messages (@code{rmail-summary}).
$B$9$Y$F$N%a%C%;!<%8$N%5%^%j$r:n@.$9$k!J(B@code{rmail-summary}$B!K!#(B
@item l @var{labels} @key{RET}
@itemx C-M-l @var{labels} @key{RET}
@c Summarize messages that have one or more of the specified labels
@c (@code{rmail-summary-by-labels}).
$B;XDj$7$?%i%Y%k$N$$$:$l$+$r4^$`%a%C%;!<%8$N%5%^%j$r:n@.$9$k(B
$B!J(B@code{rmail-summary-by-labels}$B!K!#(B
@item C-M-r @var{rcpts} @key{RET}
@c Summarize messages that have one or more of the specified recipients
@c (@code{rmail-summary-by-recipients}).
$B;XDj$7$?<u?.<TL>$N$$$:$l$+$r4^$`%a%C%;!<%8$N%5%^%j$r:n@.$9$k(B
$B!J(B@code{rmail-summary-by-recipients}$B!K!#(B
@item C-M-t @var{topic} @key{RET}
@c Summarize messages that have a match for the specified regexp
@c @var{topic} in their subjects (@code{rmail-summary-by-topic}).
$B;XDj$7$?@55,I=8=(B@var{topic}$B$K0lCW$9$k%5%V%8%'%/%H$r;}$D(B
$B%a%C%;!<%8$N%5%^%j$r:n@.$9$k!J(B@code{rmail-summary-by-topic}$B!K!#(B
@end table

@c @kindex h @r{(Rmail)}
@kindex h @r{$B!J(Brmail$B!K(B}
@findex rmail-summary
@c   The @kbd{h} or @kbd{C-M-h} (@code{rmail-summary}) command fills the summary buffer
@c for the current Rmail file with a summary of all the messages in the file.
@c It then displays and selects the summary buffer in another window.
$B%3%^%s%I(B@kbd{h}$B$d(B@kbd{C-M-h}$B!J(B@code{rmail-summary}$B!K$O!"(B
$B8=:_$N(Brmail$B%U%!%$%k$N%5%^%j%P%C%U%!$r(B
$B$3$N%U%!%$%k$NA4%a%C%;!<%8$N%5%^%j$GK~$?$7$^$9!#(B
$B$=$7$F!"JL$N%&%#%s%I%&$K%5%^%j%P%C%U%!$rI=<($7A*Br$7$^$9!#(B

@c @kindex l @r{(Rmail)}
@c @kindex C-M-l @r{(Rmail)}
@kindex l @r{$B!J(Brmail$B!K(B}
@kindex C-M-l @r{$B!J(Brmail$B!K(B}
@findex rmail-summary-by-labels
@c   @kbd{C-M-l @var{labels} @key{RET}} (@code{rmail-summary-by-labels}) makes
@c a partial summary mentioning only the messages that have one or more of the
@c labels @var{labels}.  @var{labels} should contain label names separated by
@c commas.@refill
@kbd{C-M-l @var{labels} @key{RET}}$B!J(B@code{rmail-summary-by-labels}$B!K$O!"(B
$B%i%Y%k(B@var{labels}$B$N$$$:$l$+$r4^$`%a%C%;!<%8$KBP$9$kItJ,E*$J%5%^%j$r:n$j$^$9!#(B
@var{labels}$B$O%i%Y%kL>$r%3%s%^$G6h@Z$C$?$b$N$G$"$kI,MW$,$"$j$^$9!#(B

@c @kindex C-M-r @r{(Rmail)}
@kindex C-M-r @r{$B!J(Brmail$B!K(B}
@findex rmail-summary-by-recipients
@c   @kbd{C-M-r @var{rcpts} @key{RET}} (@code{rmail-summary-by-recipients})
@c makes a partial summary mentioning only the messages that have one or more
@c of the recipients @var{rcpts}.  @var{rcpts} should contain mailing
@c addresses separated by commas.@refill
@kbd{C-M-r @var{rcpts} @key{RET}}$B!J(B@code{rmail-summary-by-recipients}$B!K$O!"(B
$B<u?.<TL>(B@var{rcpts}$B$N$$$:$l$+$r4^$`%a%C%;!<%8$KBP$9$kItJ,E*$J(B
$B%5%^%j$r:n$j$^$9!#(B
@var{rcpts}$B$O%a%$%k%"%I%l%9$r%3%s%^$G6h@Z$C$?$b$N$G$"$kI,MW$,$"$j$^$9!#(B

@c @kindex C-M-t @r{(Rmail)}
@kindex C-M-t @r{$B!J(Brmail$B!K(B}
@findex rmail-summary-by-topic
@c   @kbd{C-M-t @var{topic} @key{RET}} (@code{rmail-summary-by-topic})
@c makes a partial summary mentioning only the messages whose subjects have
@c a match for the regular expression @var{topic}.
@kbd{C-M-t @var{topic} @key{RET}}$B!J(B@code{rmail-summary-by-topic}$B!K$O!"(B
$B@55,I=8=(B@var{topic}$B$K0lCW$9$k%5%V%8%'%/%H$r;}$D%a%C%;!<%8$KBP$9$k(B
$BItJ,E*$J%5%^%j$r:n@.$7$^$9!#(B

@c   Note that there is only one summary buffer for any Rmail file; making one
@c kind of summary discards any previously made summary.
$B$I$N(Brmail$B%U%!%$%k$K$b(B1$B$D$N%5%^%j%P%C%U%!$7$+$J$$$3$H$KCm0U$7$F$/$@$5$$!#(B
$B$"$k<oN`$N%5%^%j$r:n@.$9$k$H!"$=$l0JA0$N%5%^%j$O>C$5$l$F$7$^$$$^$9!#(B

@vindex rmail-summary-window-size
@vindex rmail-summary-line-count-flag
@c   The variable @code{rmail-summary-window-size} says how many lines to
@c use for the summary window.  The variable
@c @code{rmail-summary-line-count-flag} controls whether the summary line
@c for a message should include the line count of the message.
$BJQ?t(B@code{rmail-summary-window-size}$B$O!"(B
$B%5%^%j%&%#%s%I%&$K;H$&9T?t$r;XDj$7$^$9!#(B
$BJQ?t(B@code{rmail-summary-line-count-flag} $B$O!"(B
$B3F%a%C%;!<%8$N%5%^%j9T$K%a%C%;!<%8$N9T?t$rI=<($9$k$+$I$&$+$r@)8f$7$^$9!#(B

@node Rmail Summary Edit
@c @subsection Editing in Summaries
@subsection $B%5%^%j$G$NJT=8(B

@c   You can use the Rmail summary buffer to do almost anything you can do
@c in the Rmail buffer itself.  In fact, once you have a summary buffer,
@c there's no need to switch back to the Rmail buffer.
rmail$B%P%C%U%!<+BN$K$G$-$k$3$H$O!"(B
rmail$B%5%^%j%P%C%U%!$G$b$[$H$s$I$G$-$^$9!#(B
$B<B:]!"$$$C$?$s%5%^%j%P%C%U%!$r:n$C$F$*$1$P!"(B
rmail$B%P%C%U%!$K@Z$jBX$($kI,MW$O$"$j$^$;$s!#(B

@c   You can select and display various messages in the Rmail buffer, from
@c the summary buffer, just by moving point in the summary buffer to
@c different lines.  It doesn't matter what Emacs command you use to move
@c point; whichever line point is on at the end of the command, that
@c message is selected in the Rmail buffer.
$B%5%^%j%P%C%U%!>e$G%]%$%s%H$r9T$+$i9T$X0\F0$9$k$@$1$G!"(B
$B%5%^%j%P%C%U%!$+$i(Brmail$B%P%C%U%!$N$5$^$6$^$J%a%C%;!<%8$rA*Br$7I=<($G$-$^$9!#(B
$B$I$s$J(BEmacs$B%3%^%s%I$r;H$C$F%]%$%s%H$r0\F0$7$F$b$+$^$$$^$;$s!#(B
$B%3%^%s%I$r<B9T$7=*$C$?$H$-$K%]%$%s%H$,$"$k9T$,$I$3$G$"$C$F$b!"(B
rmail$B%P%C%U%!$N$=$l$KBP1~$9$k%a%C%;!<%8$,A*Br$5$l$^$9!#(B

@c   Almost all Rmail commands work in the summary buffer as well as in the
@c Rmail buffer.  Thus, @kbd{d} in the summary buffer deletes the current
@c message, @kbd{u} undeletes, and @kbd{x} expunges.  @kbd{o} and @kbd{C-o}
@c output the current message to a file; @kbd{r} starts a reply to it.  You
@c can scroll the current message while remaining in the summary buffer
@c using @key{SPC} and @key{DEL}.
$B$[$H$s$I$9$Y$F$N(Brmail$B%3%^%s%I$O!"(Brmail$B%P%C%U%!$HF1MM$K%5%^%j%P%C%U%!(B
$B$G$b5!G=$7$^$9!#(B
$B$D$^$j!"(B
@kbd{d}$B$O%5%^%j%P%C%U%!$G$b%+%l%s%H%a%C%;!<%8$r:o=|$7!"(B
@kbd{u}$B$O%"%s%G%j!<%H$7!"(B@kbd{x}$B$OKu>C$7$^$9!#(B
@kbd{o}$B$H(B@kbd{C-o}$B$O%+%l%s%H%a%C%;!<%8$r%U%!%$%k$K=q$-9~$_$^$9!#(B
@kbd{r}$B$OJV?.$r3+;O$7$^$9!#(B
$B%5%^%j%P%C%U%!$K$$$F$b!"(B
@key{SPC}$B$H(B@key{DEL}$B$r;H$C$F%+%l%s%H%a%C%;!<%8$r%9%/%m!<%k$G$-$^$9!#(B

@c   The Rmail commands to move between messages also work in the summary
@c buffer, but with a twist: they move through the set of messages included
@c in the summary.  They also ensure the Rmail buffer appears on the screen
@c (unlike cursor motion commands, which update the contents of the Rmail
@c buffer but don't display it in a window unless it already appears).
@c Here is a list of these commands:
$B%a%C%;!<%8$N$"$$$@$r0\F0$9$k(Brmail$B%3%^%s%I$b%5%^%j%P%C%U%!$G;H$($^$9$,!"(B
$B;v>p$,>/!90c$C$F$$$^$9!#(B
$B$D$^$j!"8=:_%5%^%j$,:n$i$l$F$$$k%a%C%;!<%8$N$"$$$@$G$7$+0\F0$G$-$^$;$s!#(B
$B$^$?!"(Brmail$B%P%C%U%!$,I,$:2hLL$KI=<($5$l$k$h$&$K$7$^$9!#(B
$B!J%+!<%=%k0\F0$N%3%^%s%I$O(Brmail$B%P%C%U%!$NFbMF$r99?7$7$^$9$,!"(B
rmail$B%P%C%U%!$,%&%#%s%I%&$KI=<($5$l$F$$$J$1$l$PI=<($5$l$^$;$s!#!K(B
$B0J2<$O$3$l$i$N%3%^%s%I$N0lMw$G$9!#(B

@table @kbd
@item n
@c Move to next line, skipping lines saying `deleted', and select its
@c message.
$B!J:o=|$5$l$?!K!V(Bdeleted$B!W$H$J$C$F$$$k9T$r(B
$BHt$S1[$7$F$D$.$N9T$K0\F0$7!"$=$N%a%C%;!<%8$rA*Br$9$k!#(B
@item p
@c Move to previous line, skipping lines saying `deleted', and select
@c its message.
$B!J:o=|$5$l$?!K!V(Bdeleted$B!W$H$J$C$F$$$k9T$r(B
$BHt$S1[$7$F$^$($N9T$K0\F0$7!"$=$N%a%C%;!<%8$rA*Br$9$k!#(B
@item M-n
@c Move to next line and select its message.
$B$D$.$N9T$K0\F0$7!"$=$N%a%C%;!<%8$rA*Br$9$k!#(B
@item M-p
@c Move to previous line and select its message.
$B$^$($N9T$K0\F0$7!"$=$N%a%C%;!<%8$rA*Br$9$k!#(B
@item >
@c Move to the last line, and select its message.
$B:G8e$N9T$K0\F0$7!"$=$N%a%C%;!<%8$rA*Br$9$k!#(B
@item <
@c Move to the first line, and select its message.
$B:G=i$N9T$K0\F0$7!"$=$N%a%C%;!<%8$rA*Br$9$k!#(B
@item M-s @var{pattern} @key{RET}
@c Search through messages for @var{pattern} starting with the current
@c message; select the message found, and move point in the summary buffer
@c to that message's line.
$B%+%l%s%H%a%C%;!<%8$+$i;O$a$F(B@var{pattern}$B$K0lCW$9$k%a%C%;!<%8$rC5:w$9$k!#(B
$B$_$D$+$C$?%a%C%;!<%8$rA*Br$7!"(B
$B%5%^%j%P%C%U%!Fb$N$=$N%a%C%;!<%8$KBP1~$9$k9T$K%]%$%s%H$r0\F0$9$k!#(B
@end table

@vindex rmail-redisplay-summary
@c   Deletion, undeletion, and getting new mail, and even selection of a
@c different message all update the summary buffer when you do them in the
@c Rmail buffer.  If the variable @code{rmail-redisplay-summary} is
@c non-@code{nil}, these actions also bring the summary buffer back onto
@c the screen.
rmail$B%P%C%U%!$G!":o=|!"%"%s%G%j!<%H!"?7Ce%a%$%k$N<hF@!"(B
$BJL$N%a%C%;!<%8$NA*Br$r<B9T$9$k$H!"%5%^%j%P%C%U%!$rI,$:99?7$7$^$9!#(B
$BJQ?t(B@code{rmail-redisplay-summary}$B$,(B@code{nil}$B0J30$J$i$P!"(B
$B$3$l$i$N%3%^%s%I$r<B9T$9$k$H%5%^%j%P%C%U%!$O2hLL$KI=<($5$l$^$9!#(B

@c @kindex Q @r{(Rmail summary)}
@kindex Q @r{$B!J(Brmail$B%5%^%j!K(B}
@findex rmail-summary-wipe
@c @kindex q @r{(Rmail summary)}
@kindex q @r{$B!J(Brmail$B%5%^%j!K(B}
@findex rmail-summary-quit
@c   When you are finished using the summary, type @kbd{Q}
@c (@code{rmail-summary-wipe}) to delete the summary buffer's window.  You
@c can also exit Rmail while in the summary: @kbd{q}
@c (@code{rmail-summary-quit}) deletes the summary window, then exits from
@c Rmail by saving the Rmail file and switching to another buffer.
$B%5%^%j$r;H$$=*$C$?$i(B@kbd{Q}$B!J(B@code{rmail-summary-wipe}$B!K$HBG$C$F(B
$B%5%^%j%P%C%U%!$N%&%#%s%I%&$r:o=|$7$^$9!#(B
$B%5%^%j$G(Brmail$B$r=*N;$9$k$3$H$b$G$-$^$9!#(B
@kbd{q}$B!J(B@code{rmail-summary-quit}$B!K$O%5%^%j%&%#%s%I%&$r:o=|$7!"(B
rmail$B%U%!%$%k$rJ]B8$7$F(Brmail$B$rH4$1!"JL$N%P%C%U%!$K@Z$jBX$($^$9!#(B

@node Rmail Sorting
@c @section Sorting the Rmail File
@section rmail$B%U%!%$%k$N%=!<%H(B

@table @kbd
@item M-x rmail-sort-by-date
@c Sort messages of current Rmail file by date.
$B8=:_$N(Brmail$B%U%!%$%k$N%a%C%;!<%8$rF|IU=g$K%=!<%H$9$k!#(B

@item M-x rmail-sort-by-subject
@c Sort messages of current Rmail file by subject.
$B8=:_$N(Brmail$B%U%!%$%k$N%a%C%;!<%8$r(B@samp{Subject}$B=g$K%=!<%H$9$k!#(B

@item M-x rmail-sort-by-author
@c Sort messages of current Rmail file by author's name.
$B8=:_$N(Brmail$B%U%!%$%k$N%a%C%;!<%8$rI.<TL>=g$K%=!<%H$9$k!#(B

@item M-x rmail-sort-by-recipient
@c Sort messages of current Rmail file by recipient's names.
$B8=:_$N(Brmail$B%U%!%$%k$N%a%C%;!<%8$r<u$1<jL>=g$K%=!<%H$9$k!#(B

@item M-x rmail-sort-by-correspondent
@c Sort messages of current Rmail file by the name of the other
@c correspondent.
$B8=:_$N(Brmail$B%U%!%$%k$N%a%C%;!<%8$rB>$NJ8DL<TL>=g$K%=!<%H$9$k!#(B

@item M-x rmail-sort-by-lines
@c Sort messages of current Rmail file by size (number of lines).
$B8=:_$N(Brmail$B%U%!%$%k$N%a%C%;!<%8$r9T?t=g$K%=!<%H$9$k!#(B

@item M-x rmail-sort-by-keywords @key{RET} @var{labels} @key{RET}
@c Sort messages of current Rmail file by labels.  The argument
@c @var{labels} should be a comma-separated list of labels.  The order of
@c these labels specifies the order of messages; messages with the first
@c label come first, messages with the second label come second, and so on.
@c Messages which have none of these labels come last.
$B8=:_$N(Brmail$B%U%!%$%k$N%a%C%;!<%8$r%i%Y%k=g$K%=!<%H$9$k!#(B
$B0z?t(B @var{labels}$B$O!"%3%s%^$G6h@Z$i$l$?%i%Y%k$NJB$S$G$"$kI,MW$,$"$k!#(B
$B%i%Y%k$N=g=x$,%a%C%;!<%8$N=g=x$r7h$a$k!#(B
$B:G=i$N%i%Y%k$r;}$D%a%C%;!<%8$,:G=i$K$-$F!"(B
2$BHVL\$N%i%Y%k$r;}$D$b$N$,(B2$BHVL\$K$/$k$H$$$&$h$&$K$J$k!#(B
$B;XDj$7$?%i%Y%k$b;}$?$J$$%a%C%;!<%8$O:G8e$K$/$k!#(B
@end table

@c   The Rmail sort commands perform a @emph{stable sort}: if there is no
@c reason to prefer either one of two messages, their order remains
@c unchanged.  You can use this to sort by more than one criterion.  For
@c example, if you use @code{rmail-sort-by-date} and then
@c @code{rmail-sort-by-author}, messages from the same author appear in
@c order by date.
rmail$B$N%=!<%H%3%^%s%I$O!"(B@emph{$B=g=x$rJ]B8$9$k%=!<%H(B}$B!J(Bstable sort$B!K$r9T$$$^$9!#(B
2$B$D$N%a%C%;!<%8$N$I$A$i$r@h$K$9$k$+L@3N$J4p=`$,$J$$$H$-$K$O!"(B
$B$=$N=g=x4X78$OJ]B8$5$l$^$9!#(B
$B$3$l$rMQ$$$l$P!"J#?t$N4p=`$G%=!<%H$G$-$^$9!#(B
$B$?$H$($P!"(B@code{rmail-sort-by-date}$B$r;H$C$F$+$i(B
@code{rmail-sort-by-author}$B$r;H$&$H!"(B
$BF1$8I.<T$N%a%C%;!<%8$OF|IU=g$KJB$S$^$9!#(B

@c   With a numeric argument, all these commands reverse the order of
@c comparison.  This means they sort messages from newest to oldest, from
@c biggest to smallest, or in reverse alphabetical order.
$B?t0z?t$r;XDj$9$k$H$3$l$i$N$9$Y$F$N%3%^%s%I$O5U=g=x$KJB$Y$^$9!#(B
$B$D$^$j!"?7$7$$$b$N$+$i8E$$$b$N$X!"Bg$-$J$b$N$+$i>.$5$J$b$N$X!"(B
$B%"%k%U%!%Y%C%H$N5U=g$K%a%C%;!<%8$r%=!<%H$7$^$9!#(B

@node Rmail Display
@c @section Display of Messages
@section $B%a%C%;!<%8$NI=<((B

@c   Rmail reformats the header of each message before displaying it for
@c the first time.  Reformatting hides uninteresting header fields to
@c reduce clutter.  You can use the @kbd{t} command to show the entire
@c header or to repeat the header reformatting operation.
$B=i$a$F%a%C%;!<%8$rI=<($9$k$H$-!"(Brmail$B$O%a%C%;!<%8$N%X%C%@$r(B
$B@07A$7D>$7$F$+$iI=<($7$^$9!#(B
$B$`$@$JI=<($r:o$k$?$a$K=EMW$G$J$$%X%C%@%U%#!<%k%I$r1#$7$^$9!#(B
@kbd{t}$B%3%^%s%I$r;H$&$H!"%X%C%@A4BN$rI=<($7$?$j:FEY@07A$9$k$3$H$,$G$-$^$9!#(B

@table @kbd
@item t
@c Toggle display of complete header (@code{rmail-toggle-header}).
$B%X%C%@A4BN$rI=<($9$k$+$I$&$+$r@Z$jBX$($k!J(B@code{rmail-toggle-header}$B!K!#(B
@end table

@vindex rmail-ignored-headers
@c   Reformatting the header involves deleting most header fields, on the
@c grounds that they are not interesting.  The variable
@c @code{rmail-ignored-headers} holds a regular expression that specifies
@c which header fields to hide in this way---if it matches the beginning of
@c a header field, that whole field is hidden.
$B%X%C%@$N@07A$G$O!"3F%X%C%@%U%#!<%k%I$N=EMW@-$K4p$E$$$F(B
$B$[$H$s$I$N%X%C%@%U%#!<%k%I$r:o=|$9$k$3$H$K$J$j$^$9!#(B
$BJQ?t(B@code{rmail-ignored-headers}$B$K$O!"$3$N$h$&$K$7$F1#$9%X%C%@%U%#!<%k%I$r(B
$B;XDj$9$k@55,I=8=$r5-=R$7$^$9!#(B
$B%X%C%@%U%#!<%k%I$N@hF,ItJ,$,$3$N@55,I=8=$K0lCW$9$k$H(B
$B$=$N%U%#!<%k%IA4BN$r1#$7$^$9!#(B

@c @kindex t @r{(Rmail)}
@kindex t @r{$B!J(Brmail$B!K(B}
@findex rmail-toggle-header
@c   Rmail saves the complete original header before reformatting; to see
@c it, use the @kbd{t} command (@code{rmail-toggle-header}).  This
@c discards the reformatted headers of the current message and displays it
@c with the original header.  Repeating @kbd{t} reformats the message
@c again.  Selecting the message again also reformats.
rmail$B$O@07A$r9T$&$^$($K$b$H$N%X%C%@A4BN$rJ]B8$7$^$9!#(B
$B$3$l$r8+$k$K$O(B@kbd{t}$B!J(B@code{rmail-toggle-header}$B!K%3%^%s%I$r;H$$$^$9!#(B
$B%+%l%s%H%a%C%;!<%8$N@07A$5$l$?%X%C%@$r<N$F!"$b$H$N%X%C%@$rI=<($7$^$9!#(B
@kbd{t}$B$r:FEY<B9T$9$k$H!"%a%C%;!<%8$N%X%C%@$r:FEY@07A$7$^$9!#(B
$B%a%C%;!<%8$rA*Br$7D>$7$F$b:FEY@07A$7$^$9!#(B

@c   One consequence of this is that if you edit the reformatted header
@c (using @kbd{e}; @pxref{Rmail Editing}), subsequent use of @kbd{t} will
@c discard your edits.  On the other hand, if you use @kbd{e} after
@c @kbd{t}, to edit the original (unreformatted) header, those changes are
@c permanent.
$B$3$N7k2L$H$7$F!"!J(B@pxref{Rmail Editing}$B!K(B
$B@07A$5$l$?%X%C%@$r!J(B@kbd{e}$B%3%^%s%I$G!KJT=8$7$F$b!"(B
$B$=$N$"$H$K(B@kbd{t}$B$r;H$&$HJT=8$7$?$b$N$OGK4~$5$l$^$9!J(B@pxref{Rmail Editing}$B!K!#(B
$B0lJ}!"(B@kbd{t}$B$N$"$H$K(B@kbd{e}$B$r;H$C$F(B
$B$b$H$N!J@07A$7$F$$$J$$!K%X%C%@$rJT=8$9$k$H!"$=$NJQ99$OJ]B8$5$l$^$9!#(B

@c   When the @kbd{t} command has a prefix argument, a positive argument
@c means to show the reformatted header, and a zero or negative argument
@c means to show the full header.
@kbd{t}$B%3%^%s%I$K?t0z?t$rIU$1$k$H!"(B
$B@5$N0z?t$J$i$O@07A$7$?%X%C%@$rI=<($7!"(B
$B%<%m$+Ii$J$i$P%X%C%@A4BN$rI=<($7$^$9!#(B

@vindex rmail-highlighted-headers
@c   When used with a window system that supports multiple fonts, Rmail
@c highlights certain header fields that are especially interesting---by
@c default, the @samp{From} and @samp{Subject} fields.  The variable
@c @code{rmail-highlighted-headers} holds a regular expression that
@c specifies the header fields to highlight; if it matches the beginning of
@c a header field, that whole field is highlighted.
$BJ#?t$N%U%)%s%H$r;H$($k%&%#%s%I%&%7%9%F%`$G;HMQ$9$k$H!"(B
rmail$B$OFC$K=EMW$J$"$k<o$N%X%C%@%U%#!<%k%I$r6/D4I=<($7$^$9!#(B
$B%G%U%)%k%H$G$O!"(B @samp{From}$B%U%#!<%k%I$H(B@samp{Subject}$B%U%#!<%k%I$G$9!#(B
$BJQ?t(B@code{rmail-highlighted-headers}$B$K$O!"6/D4I=<($7$?$$%X%C%@%U%#!<%k%I$r(B
$B;XDj$9$k@55,I=8=$r5-=R$7$^$9!#(B
$B%X%C%@%U%#!<%k%I$N@hF,ItJ,$,$3$N@55,I=8=$K0lCW$9$k$H(B
$B$=$N%U%#!<%k%IA4BN$r6/D4I=<($7$^$9!#(B

@c   If you specify unusual colors for your text foreground and background,
@c the colors used for highlighting may not go well with them.  If so,
@c specify different colors for the @code{highlight} face.  That is worth
@c doing because the @code{highlight} face is used for other kinds of
@c highlighting as well.  @xref{Faces}, for how to do this.
$B%F%-%9%H$NA07J$dGX7J$KI8=`E*$G$J$$?'$r;XDj$9$k$H!"(B
$B$&$^$/6/D4I=<($G$-$J$$$3$H$b$"$j$^$9!#(B
$B$=$N$h$&$J>l9g$K$O!"(B@code{highlight}$B%U%'%$%9$KJL$N?'$r;XDj$7$^$9!#(B
@code{highlight}$B%U%'%$%9$O(Brmail$B0J30$N6/D4I=<($K$b;H$o$l$k$N$G!"(B
$B;XDj$r9T$&2ACM$,$"$j$^$9!#(B
$BJ}K!$O!"(B@xref{Faces}$B!#(B

@c   To turn off highlighting entirely in Rmail, set
@c @code{rmail-highlighted-headers} to @code{nil}.
rmail$B$N6/D4I=<($r$9$Y$F$d$a$k$K$O!"(B
$BJQ?t(B@code{rmail-highlighted-headers}$B$K(B@code{nil}$B$r@_Dj$7$F$/$@$5$$!#(B

@node Rmail Editing
@c @section Editing Within a Message
@section $B%a%C%;!<%8$NJT=8(B

@c   Most of the usual Emacs commands are available in Rmail mode, though a
@c few, such as @kbd{C-M-n} and @kbd{C-M-h}, are redefined by Rmail for
@c other purposes.  However, the Rmail buffer is normally read only, and
@c most of the letters are redefined as Rmail commands.  If you want to
@c edit the text of a message, you must use the Rmail command @kbd{e}.
rmail$B%b!<%I$G$bDL>o$N(BEmacs$B%3%^%s%I$N$[$H$s$I$r;H$($^$9$,!"(B
@kbd{C-M-n}$B$d(B@kbd{C-M-h}$B$N$h$&$KB>$NL\E*$N$?$a$K(Brmail$B$G:FDj5A$5$l$?(B
$B$b$N$b$$$/$D$+$"$j$^$9!#(B
$B$7$+$7!"(Brmail $B%P%C%U%!$ODL>oFI$_=P$7@lMQ$G$"$j!"(B
$B%"%k%U%!%Y%C%HJ8;z$N$[$H$s$I$b(Brmail$B%3%^%s%I$H$7$F:FDj5A$5$l$F$$$^$9!#(B
$B%a%C%;!<%8$N%F%-%9%H$rJT=8$7$?$$$H$-$K$O!"(B
rmail$B%3%^%s%I(B@kbd{e}$B$r;H$&I,MW$,$"$j$^$9!#(B

@table @kbd
@item e
@c Edit the current message as ordinary text.
$B%+%l%s%H%a%C%;!<%8$rDL>o$N%F%-%9%H$H$7$FJT=8$9$k!#(B
@end table

@c @kindex e @r{(Rmail)}
@kindex e @r{$B!J(Brmail$B!K(B}
@findex rmail-edit-current-message
@c   The @kbd{e} command (@code{rmail-edit-current-message}) switches from
@c Rmail mode into Rmail Edit mode, another major mode which is nearly the
@c same as Text mode.  The mode line indicates this change.
@kbd{e}$B!J(B@code{rmail-edit-current-message}$B!K%3%^%s%I$O!"(B
rmail$B%b!<%I$+$i(Brmail$BJT=8!J(Brmail-edit$B!K%b!<%I$K0\9T$7$^$9!#(B
$B$3$N%b!<%I$O!"%F%-%9%H!J(Btext$B!K%b!<%I$H$[$H$s$IF1$8JL$N%a%8%c!<%b!<%I$G$9!#(B
$B%b!<%I9T$K$3$NJQ2=$,I=<($5$l$^$9!#(B

@c   In Rmail Edit mode, letters insert themselves as usual and the Rmail
@c commands are not available.  When you are finished editing the message and
@c are ready to go back to Rmail, type @kbd{C-c C-c}, which switches back to
@c Rmail mode.  Alternatively, you can return to Rmail mode but cancel all the
@c editing that you have done, by typing @kbd{C-c C-]}.
rmail$BJT=8!J(Brmail-edit$B!K%b!<%I$G$O!"J8;z$ODL>o$I$*$jA^F~$G$-!"(B
rmail$B%3%^%s%I$O;H$($^$;$s!#(B
$B%a%C%;!<%8$rJT=8$7=*$($F(Brmail$B$XLa$k$K$O!"(B
@kbd{C-c C-c}$B$HBG$A$^$9!#(B
$B$9$k$H(Brmail$B%b!<%I$KLa$j$^$9!#(B
$B$"$k$$$O!"9T$C$?JT=8$r$9$Y$F<h$j>C$7$F(Brmail$B%b!<%I$KLa$k$K$O!"(B
@kbd{C-c C-]}$B$HBG$A$^$9!#(B

@vindex rmail-edit-mode-hook
@c   Entering Rmail Edit mode runs the hook @code{text-mode-hook}; then it
@c runs the hook @code{rmail-edit-mode-hook} (@pxref{Hooks}).  It adds the
@c attribute @samp{edited} to the message.  It also displays the full
@c headers of the message, so that you can edit the headers as well as the
@c body of the message, and your changes in the the headers will be
@c permanent.
rmail$BJT=8!J(Brmail-edit$B!K%b!<%I$KF~$k$H$-!"(B
$B%U%C%/(B@code{text-mode-hook}$B$,<B9T$5$l$^$9!#(B
$B$=$l$+$i%U%C%/(B@code{rmail-edit-mode-hook} $B$,<B9T$5$l$^$9(B 
$B!J(B@pxref{Hooks}$B!K!#(B
$B%a%C%;!<%8$K$OB0@-(B@samp{edited} $B$,IU$1$i$l$^$9!#(B
$B$5$i$K!"%a%C%;!<%8$N%X%C%@A4BN$,I=<($5$l$k$N$G!"(B
$B%a%C%;!<%8$NK\J8$HF1MM$K%X%C%@$bJT=8$G$-$^$9!#(B
$B%X%C%@$KBP$9$kJQ99$bJ]B8$5$l$^$9!#(B

@node Rmail Digest
@c @section Digest Messages
@section $B%@%$%8%'%9%H%a%C%;!<%8(B
@c @cindex digest message
@c @cindex undigestify
@cindex $B%@%$%8%'%9%H%a%C%;!<%8(B
@cindex $B%"%s%@%$%8%'%9%H(B

@c   A @dfn{digest message} is a message which exists to contain and carry
@c several other messages.  Digests are used on some moderated mailing
@c lists; all the messages that arrive for the list during a period of time
@c such as one day are put inside a single digest which is then sent to the
@c subscribers.  Transmitting the single digest uses much less computer
@c time than transmitting the individual messages even though the total
@c size is the same, because the per-message overhead in network mail
@c transmission is considerable.
@dfn{$B%@%$%8%'%9%H%a%C%;!<%8(B}$B!J(Bdigest message$B!K$O!"(B
$B?t8D$N%a%C%;!<%8$r$^$H$a$F1?$V$?$a$N%a%C%;!<%8$G$9!#(B
$B%@%$%8%'%9%H$O4IM}?M$N$$$k%a%$%j%s%0%j%9%H>e$G;H$o$l$^$9!#(B
1$BF|C10L$J$I$N0lDj4|4VFb$K%j%9%H08$K<u$1<h$C$?$9$Y$F$N%a%C%;!<%8$r(B
1$B$D$N%@%$%8%'%9%H$K$^$H$a$F2CF~<T$KAw$j$^$9!#(B
$B9g7W$N%5%$%:$,F1$8$G$"$C$?$H$7$F$b!"%@%$%8%'%9%H$K$7$FAw$k$[$&$,(B
$B8D!9$K%a%C%;!<%8$rAw$k$h$j%3%s%T%e!<%?$N;HMQ;~4V$,$:$C$H>/$J$/$F$9$_$^$9!#(B
$B$H$$$&$N$O!"%a%$%kAw?.$KI,MW$J%a%C%;!<%8$"$?$j$N%M%C%H%o!<%/>e$N(B
$B%*!<%P!<%X%C%I$,$H$F$bBg$-$$$+$i$G$9!#(B

@findex undigestify-rmail-message
@c   When you receive a digest message, the most convenient way to read it is
@c to @dfn{undigestify} it: to turn it back into many individual messages.
@c Then you can read and delete the individual messages as it suits you.
$B%@%$%8%'%9%H%a%C%;!<%8$r<u$1<h$C$?$J$i$P!"(B
$B$b$C$H$b4JC1$JFI$_J}$O!"$=$l$r(B@dfn{$B%"%s%@%$%8%'%9%H(B}$B!J(Bundigestify$B!K$7$F(B
$B8D!9$N%a%C%;!<%8$KLa$9$3$H$G$9!#(B
$B$=$&$9$l$P9%$-$J$h$&$K!"8D!9$N%a%C%;!<%8$rFI$s$@$j:o=|$7$?$j$G$-$^$9!#(B

@c   To do this, select the digest message and type the command @kbd{M-x
@c undigestify-rmail-message}.  This extracts the submessages as separate
@c Rmail messages, and inserts them following the digest.  The digest
@c message itself is flagged as deleted.
$B%"%s%@%$%8%'%9%H$9$k$K$O!"%@%$%8%'%9%H%a%C%;!<%8$rA*$S!"(B
$B%3%^%s%I(B@kbd{M-x undigestify-rmail-message}$B$rBG$A$^$9!#(B
$B$3$l$O!"!J%@%$%8%'%9%H%a%C%;!<%8Fb$N!K%5%V%a%C%;!<%8$rJL!9$N(B
rmail$B%a%C%;!<%8$H$7$F<h$j=P$7!"%@%$%8%'%9%H$N$"$H$K(B
$B$=$l$i$N%a%C%;!<%8$rA^F~$7$^$9!#(B
$B%@%$%8%'%9%H%a%C%;!<%8<+BN$O:o=|$5$l$^$9!#(B

@node Out of Rmail
@c @section Converting an Rmail File to Inbox Format
@section rmail$B%U%!%$%k$+$i(Binbox$B7A<0$X$NJQ49(B

@findex unrmail
@c   The command @kbd{M-x unrmail} converts a file in Rmail format to inbox
@c format (also known as the system mailbox format), so that you can use it
@c with other mail-editing tools.  You must specify two arguments, the name
@c of the Rmail file and the name to use for the converted file.  @kbd{M-x
@c unrmail} does not alter the Rmail file itself.
$B%3%^%s%I(B @kbd{M-x unrmail}$B$O!"(Brmail$B7A<0$N%U%!%$%k$r(B
$B!J%7%9%F%`$N%a%$%k%\%C%/%97A<0$H$7$F$bCN$i$l$k!K(Binbox$B7A<0$KJQ49$7$^$9!#(B
$B$3$&$9$k$H!"$=$N%U%!%$%k$rJL$N%a%$%kJT=8%D!<%k$G$b;H$($k$h$&$K$J$j$^$9!#(B
2$B$D$N0z?t!"(Brmail$B%U%!%$%kL>$HJQ498e$N%U%!%$%kL>$r;XDj$9$kI,MW$,$"$j$^$9!#(B
@kbd{M-x unrmail}$B$O(Brmail$B%U%!%$%k<+BN$K$OJQ99$r2C$($^$;$s!#(B

@node Rmail Rot13
@c @section Reading Rot13 Messages
@section rot13$B%a%C%;!<%8$NFI$_J}(B
@c @cindex rot13 code
@cindex rot13$B0E9f(B

@c   Mailing list messages that might offend some readers are sometimes
@c encoded in a simple code called @dfn{rot13}---so named because it
@c rotates the alphabet by 13 letters.  This code is not for secrecy, as it
@c provides none; rather, it enables those who might be offended to avoid
@c ever seeing the real text of the message.
$BFCDj$NFI<T$KIT2w$rM?$($k2DG=@-$,$"$k%a%$%j%s%0%j%9%H$N%a%C%;!<%8$O!"(B
@dfn{rot13}$B$H8F$P$l$kC1=c$JJ}K!$G0E9f2=$7$F$"$k>l9g$,$"$j$^$9!#(B
$B$3$NL>A0$O!"%"%k%U%!%Y%C%H$r(B13$BJ8;zJ,=d2s$5$;$k$3$H$KM3Mh$7$^$9!#(B
$B$3$l$O5!L)J];}$N$?$a$G$O$J$/!"$=$N$h$&$J5!G=$b$"$j$^$;$s!#(B
$BIT2w$K46$8$k$+$b$7$l$J$$FI<T$,(B
$B%a%C%;!<%8$NK\Ev$NK\J8$r8+$J$$$h$&$K$9$k$?$a$K;H$$$^$9!#(B

@findex rot13-other-window
@c   To view a buffer using the rot13 code, use the command @kbd{M-x
@c rot13-other-window}.  This displays the current buffer in another window
@c which applies the code when displaying the text.
rot13$B0E9f$r;H$C$F$$$k%P%C%U%!$r8+$k$K$O!"(B
$B%3%^%s%I(B@kbd{M-x rot13-other-window}$B$r;H$$$^$9!#(B
$B%F%-%9%H$rI=<($9$k$H$-$K0E9f$r2r$$$F(B
$BJL$N%&%#%s%I%&$K%+%l%s%H%P%C%U%!$rI=<($7$^$9!#(B

@node Movemail
@c @section @code{movemail} and POP
@section @code{movemail}$B$H(BPOP
@c @cindex @code{movemail} program
@cindex @code{movemail}$B%W%m%0%i%`(B

@vindex rmail-preserve-inbox
@c   When getting new mail, Rmail first copies the new mail from the inbox
@c file to the Rmail file; then it saves the Rmail file; then it truncates
@c the inbox file.  This way, a system crash may cause duplication of mail
@c between the inbox and the Rmail file, but cannot lose mail.  If
@c @code{rmail-preserve-inbox} is non-@code{nil}, then Rmail will copy new
@c mail from the inbox file to the Rmail file without truncating the inbox
@c file.  You may wish to set this, for example, on a portable computer you
@c use to check your mail via POP while traveling, so that your mail will
@c remain on the server and you can save it later on your workstation.
$B?7Ce%a%$%k$r<hF@$9$k$H$-!"(Brmail$B$O$^$:(Binbox$B%U%!%$%k$+$i(Brmail$B%U%!%$%k$K(B
$B?7Ce%a%$%k$r%3%T!<$7$^$9!#(B
$B$=$l$+$i!"(Brmail$B%U%!%$%k$rJ]B8$7$^$9!#(B
$B$=$7$F!"(Binbox$B%U%!%$%k$NFbMF$r>C$7$^$9!#(B
$B$3$&$9$k$H!"%7%9%F%`$,%/%i%C%7%e$9$k$H(Binbox$B$H(Brmail$B%U%!%$%k$K(B
$B%a%$%k$r=EJ#$7$F;}$D$3$H$K$J$j$^$9$,!"(B
$B%a%$%k$rJ6<:$9$k$3$H$O$"$j$($^$;$s!#(B
$BJQ?t(B@code{rmail-preserve-inbox}$B$,(B@code{nil}$B0J30$J$i$P!"(B
rmail$B$O!"(Binbox$B%U%!%$%k$+$i(Brmail$B%U%!%$%k$K?7Ce%a%$%k$r%3%T!<$7$F$+$i(B
inbox$B%U%!%$%k$NFbMF$r>C$7$^$;$s!#(B
$B$?$H$($P!"N99TCf$O7HBS%3%s%T%e!<%?$G(BPOP$B$r2p$7$F%a%$%k$rD4$Y!"(B
$B%a%$%k$r%5!<%P!<$K;D$7$F$*$$$F$"$H$G%o!<%/%9%F!<%7%g%s$KJ]B8$9$k$h$&$K(B
$B$9$k$K$O!"$3$N$h$&$J@_Dj$r$7$^$9!#(B

@c   In some cases, Rmail copies the new mail from the inbox file
@c indirectly.  First it runs the @code{movemail} program to move the mail
@c from the inbox to an intermediate file called
@c @file{~/.newmail-@var{inboxname}}.  Then Rmail merges the new mail from
@c that file, saves the Rmail file, and only then deletes the intermediate
@c file.  If there is a crash at the wrong time, this file continues to
@c exist, and Rmail will use it again the next time it gets new mail from
@c that inbox.
$B>l9g$K$h$C$F$O!"(Brmail$B$O4V@\E*$K(Binbox$B%U%!%$%k$+$i?7Ce%a%$%k$r%3%T!<$7$^$9!#(B
$B$^$:!"(B@code{movemail}$B%W%m%0%i%`$r<B9T$7$F!"(B
inbox$B$+$i(B@file{~/.newmail-@var{inboxname}}$B$H$$$&Cf4V%U%!%$%k$K(B
$B%a%$%k$r0\F0$7$^$9!#(B
$B$=$l$+$i!"(Brmail$B$OCf4V%U%!%$%k$+$i?7Ce%a%$%k$rJ;9g$7$F(B
rmail$B%U%!%$%k$rJ]B8$7$F$+$iCf4V%U%!%$%k$r:o=|$7$^$9!#(B
$B$3$l$r<B9TCf$NET9g$,0-$$$H$-$K%/%i%C%7%e$9$k$HCf4V%U%!%$%k$,;D$C$F$7$^$$!"(B
rmail$B$,$D$.$K(Binbox$B$+$i?7Ce%a%$%k$r(B
$B<hF@$9$k$H$-$K$^$?$=$N%U%!%$%k$r;H$C$F$7$^$$$^$9!#(B

@pindex movemail
@c   If Rmail is unable to convert the data in
@c @file{~/.newmail-@var{inboxname}} into Babyl format, it renames the file
@c to @file{~/RMAILOSE.@var{n}} (@var{n} is an integer chosen to make the
@c name unique) so that Rmail will not have trouble with the data again.
@c You should look at the file, find whatever message confuses Rmail
@c (probably one that includes the control-underscore character, octal code
@c 037), and delete it.  Then you can use @kbd{1 g} to get new mail from
@c the corrected file.
rmail$B$,(B@file{~/.newmail-@var{inboxname}}$B$N%G!<%?$rFH<+7A<0!J(BBabyl$B7A<0!K(B
$B$KJQ49$G$-$J$$$H!"F1$8%G!<%?$G%H%i%V%k$,:FH/$7$J$$$h$&$K(B
$B%U%!%$%kL>$r(B@file{~/RMAILOSE.@var{n}}
$B!J(B@var{n}$B$OL>A0$,0l0U$K$J$k$h$&$J@0?t!K$KJQ$($^$9!#(B
$B$3$N%U%!%$%k$rD4$Y$F!"(Brmail$B$,2r<a$G$-$J$+$C$?%a%C%;!<%8(B
$B!J$?$V$s!"%3%s%H%m!<%k2<@~$NJ8;z!"(B8$B?J%3!<%I(B037$B$r;H$C$?%a%C%;!<%8$+$b$7$l$J$$!K(B
$B$rC5$7$F$=$l$r:o=|$7$^$9!#(B
$B$=$&$7$F$+$i!"(B@kbd{1 g}$B%3%^%s%I$r;H$C$F=$@5$7$?%U%!%$%k$+$i(B
$B?7Ce%a%$%k$r<h$j9~$_$^$9!#(B

@c   Some sites use a method called POP for accessing users' inbox data
@c instead of storing the data in inbox files.  @code{movemail} can work
@c with POP if you compile it with the macro @code{MAIL_USE_POP} defined.
@c (You can achieve that by specifying @samp{--with-pop} when you run
@c @code{configure} during the installation of Emacs.)
@c @code{movemail} only works with POP3, not with older
@c versions of POP.
inbox$B%U%!%$%k$K%G!<%?$rJ]B8$9$k$+$o$j$K!"(B
POP$B$H8F$P$l$kJ}K!$rMQ$$$F%f!<%6!<$N(Binbox$B$N%G!<%?$r;2>H$9$k(B
$B>l9g$b$"$j$^$9!#(B
@code{movemail}$B$r%3%s%Q%$%k$9$k$H$-$K%^%/%m(B@code{MAIL_USE_POP}$B$rDj5A$7$F(B
$B%3%s%Q%$%k$9$l$P(B@code{movemail}$B$O(BPOP$B$r;H$C$FF0$-$^$9!#(B
$B!J(BEmacs$B$r%$%s%9%H!<%k$9$k$H$-!"(B
@samp{--with-pop}$B$r;XDj$7$F(B@code{configure}$B$r<B9T$9$l$P!"(B
$B$3$N$h$&$K$G$-$k!#!K(B
@code{movemail}$B$O(BPOP3$B$G$7$+F0$+$:!"(BPOP$B$N8E$$%P!<%8%g%s$G$O;H$($^$;$s!#(B

@c @cindex @code{MAILHOST} environment variable
@cindex $B4D6-JQ?t(B@code{MAILHOST}
@cindex @code{MAILHOST}$B!J4D6-JQ?t!K(B
@cindex POP inboxes
@c   Assuming you have compiled and installed @code{movemail}
@c appropriately, you can specify a POP inbox by using a ``file name'' of
@c the form @samp{po:@var{username}}, in the inbox list of an Rmail file.
@c @code{movemail} handles such a name by opening a connection to the POP
@c server.  The @code{MAILHOST} environment variable specifies the machine
@c to look for the server on.
@code{movemail}$B$rE,@Z$K%3%s%Q%$%k$7$F%$%s%9%H!<%k$7$?$H$9$k$H!"(B
rmail$B%U%!%$%k$N(Binbox$B%j%9%H$G!"(B
@samp{po:@var{username}}$B$N7A$N!X%U%!%$%kL>!Y$G(BPOP$B$N(Binbox$B$r;XDj$G$-$^$9!#(B
@code{movemail}$B$O!"$=$N$h$&$JL>A0$KBP$7$F$O!"(B
POP$B%5!<%P!<$KBP$9$k@\B3$r3+$-$^$9!#(B
@code{MAILHOST}$B4D6-JQ?t$G!"$I$N%^%7%s$G%5!<%P!<$rC5$9$+$r;XDj$7$^$9!#(B

@vindex rmail-pop-password
@vindex rmail-pop-password-required
@c   Accessing mail via POP may require a password.  If the variable
@c @code{rmail-pop-password} is non-@code{nil}, it specifies the password
@c to use for POP.  Alternatively, if @code{rmail-pop-password-required} is
@c non-@code{nil}, then Rmail asks you for the password to use.
POP$B7PM3$G%a%$%k$r;2>H$9$k$K$O%Q%9%o!<%I$,I,MW$G$9!#(B
$BJQ?t(B@code{rmail-pop-password}$B$,(B@code{nil}$B0J30$N$H$-$O!"(B
$B$3$l$O(BPOP$B$KBP$7$F$r;H$&%Q%9%o!<%I$r;XDj$7$^$9!#(B
$B$"$k$$$O!"JQ?t(B@code{rmail-pop-password-required}$B$,(B@code{nil}$B0J30$J$i$P!"(B
rmail$B$O%f!<%6!<$K%Q%9%o!<%I$r?R$M$^$9!#(B

@vindex rmail-movemail-flags
@c   If you need to pass additional command-line flags to @code{movemail},
@c set the variable @code{rmail-movemail-flags} a list of the flags you
@c wish to use.  Do not use this variable to pass the @samp{-p} flag to
@c preserve your inbox contents; use @code{rmail-preserve-inbox} instead.
@code{movemail}$B$K%3%^%s%I9T%*%W%7%g%s$rDI2C$9$kI,MW$,$"$k$H$-$K$O!"(B
$BJQ?t(B@code{rmail-movemail-flags}$B$K;XDj$7$?$$%*%W%7%g%s$N%j%9%H$r@_Dj$7$^$9!#(B
inbox$B$NFbMF$rJ]B8$9$k%*%W%7%g%s(B@samp{-p}$B$r;XDj$9$k$?$a$K(B
$B$3$NJQ?t$r;H$o$J$$$G$/$@$5$$!#(B
$B$+$o$j$K(B@code{rmail-preserve-inbox}$B$r;H$C$F$/$@$5$$!#(B

@c @cindex Kerberos POP authentication
@cindex Kerberos POP$BG'>Z(B
@c   The @code{movemail} program installed at your site may support
@c Kerberos authentication.  If it is
@c supported, it is used by default whenever you attempt to retrieve
@c POP mail when @code{rmail-pop-password} and
@c @code{rmail-pop-password-required} are unset.
$BFI<T$N%5%$%H$G%$%s%9%H!<%k$7$?(B@code{movemail}$B%W%m%0%i%`$O!"(B
Kerberos$BG'>Z$r;H$&$+$b$7$l$^$;$s!#(B
$B$=$N>l9g!"(B
@code{rmail-pop-password}$B$H(B@code{rmail-pop-password-required}$B$,@_Dj$5$l$F(B
$B$$$J$1$l$P!"(BPOP$B$G%a%$%k$r<hF@$9$k$H$-$K%G%U%)%k%H$G(B
Kerberos$BG'>Z$r;H$$$^$9!#(B

@c @cindex POP inboxes in reverse order
@cindex $B5U=g=x$N(BPOP inbox
@c   Some POP servers store messages in reverse order.  If your server does
@c this, and you would rather read your mail in the order in which it was
@c received, you can tell @code{movemail} to reverse the order of
@c downloaded messages by adding the @samp{-r} flag to
@c @code{rmail-movemail-flags}.
POP$B%5!<%P!<$K$h$C$F$O%a%C%;!<%8$r5U=g=x$KJ]B8$7$^$9!#(B
$B$=$N$h$&$J%5!<%P!<$G<u?.=g$K%a%$%k$rFI$`$K$O!"(B
@code{rmail-movemail-flags}$B$K%U%i%0(B@samp{-r}$B$rDI2C$7$F!"(B
$B%@%&%s%m!<%I$7$?%a%C%;!<%8$r5U=g$K$9$k$h$&$K(B
@code{movemail}$B$K;X<($7$^$9!#(B