text.tex

早期freebsd实现

address.
It is customary, but not required, to put your own address
here so that you get a copy of the message when it is sent.

To put more than one address in the \arg{To:} and
\arg{cc:} components,
just use a comma (``,'') between each address on a line.

{\bf Subject:}
The third prompt is for the \arg{Subject:} component.
Here a line of any descriptive text will do.
Once you have typed a line of text, a dashed line is printed,
and you are then expected to type the body of the message.
End the body with EOT (usually CTRL-D).

An example of a complete message draft, as it appears on your screen,
might be:
\example
    To: News\\
    cc: farber, mrose\\
    Subject: UCI Software Talk\\
    --------\\
    A presentation on the UCI software suite, including\\
    the Rand/UCI Mail Handling System (MH), will be given\\
    in CS220 on October 31st at 2:30 PM.  Refreshments\\
    will be served afterward.\\\\
    /mtr\\
    \^{}D
\endexample
(The ``\^{}D'' does not appear in the draft.)

At this point, you are asked
\example What\ now?\endexample
This is known as being at \whatnow/ level.
For now, there are probably only four options that will interest you:
\smallskip
{\advance\leftskip by\parindent
\item{\pgm{edit}} - edit the draft
\item{\pgm{list}} - list the draft on your screen
\item{\pgm{quit}} - quit, without sending the draft
\item{\pgm{send}} - send the draft, then quit
\medskip}
\noindent
All of these options take various arguments,
but only \pgm{edit} really needs an argument.

{\bf Edit:}
The \pgm{edit} option will let you edit the draft before sending it.
If your favorite text editor is \pgm{vi},
then you would use the \pgm{edit} option as:
\example edit\ vi\endexample
Just specifying \pgm{edit} with no argument
will only let you append text to the body of the
message draft.
Another editor (e.g. \pgm{vi}, \pgm{ex}, \pgm{emacs\/})
should really be run to finish the draft up.
When you leave the editor, you will come back to the \whatnow/ level,
where you can re-edit the draft, send it, list it, or simply quit
without sending the draft at all.

Caution: while in the editor,
you should not delete colons in the headers
or change the spelling of \arg{To:}, \arg{cc:}, or \arg{Subject:};
and do not leave blank lines between these lines.
Feel free to change the addresses that you typed previously,
or to add these lines if they are missing.
Do not delete the dashes that separate the header lines from
the text of the message.
You should not add additional header lines unless you understand
precisely what you are doing.  
This means particularly that you should not type or fill in a \arg{From:}
line.
When the message is sent, the system automatically adds this line.
Also, you should not type a \arg{Date:} line in the header.
When the message is sent, the system automatically adds the current
date and time.

{\bf Quit:}
If you \pgm{quit} without sending the draft,
the draft is saved in a file called \file{Mail/draft} under your
home directory.
This file can be recalled later using the \arg{-use} argument
to \pgm{comp}:
\example comp\ -use\endexample
The \whatnow/ level will permit you to do further editing
and to send the final draft when you are ready.

{\bf Send:}
When it is time to send the draft on its way,
use the \pgm{send} option by itself.
If there are any problems with the draft 
(for example,
if one or more of the people whom you specified in the \arg{To:} and \arg{cc:}
components do not exist)
then you will be notified at this time.

\subsection{Replying to Messages}
To reply to a message,
use the \pgm{repl} command.
For example,
\example repl\endexample
creates a reply to the current message.
You may also reply to a specific message (other than the current one)
by giving a {\it message number} (e.g. \arg{1}, \arg{4}, etc.)
or a {\it message name} (e.g. \arg{first}, \arg{last}, \arg{prev}):
\example repl\ prev\endexample
We haven't really introduced message numbers yet.
They will be discussed in the next section.

The process of replying to a message is very similar to composing
a message from scratch (see the previous section),
but \pgm{repl} conveniently constructs and displays the header
of the reply draft for you.
You need only type in the text of the reply.
An EOT (usually CTRL-D) indicates that you are done typing.
If you make a mistake, you may correct it later with a text editor.
The draft will be sent only if you give an explicit \pgm{send} command,
so you do not have to worry about the draft getting away from you
prematurely.

An example of a complete reply draft, as it appears on your screen might be:
\example
    To: MRose\\
    cc: JSweet\\
    Subject: Re: UCI Software Talk\\
    In-reply-to: Your message of 10 Oct 84 18:15:08 PDT (Wed).\\
    --------\\
    I'll be there.\\
    -jns\\
    \^{}D	
\endexample
(The ``\^{}D'' does not appear in the draft.)

At this point, you are asked
\example What\ now?\endexample
This is known as being at \whatnow/ level.
Refer to the previous section regarding how to edit,
display, or send the draft at this point.

As with \pgm{comp}, 
if you \pgm{quit} without sending the reply draft,
the draft is saved in a file called \file{Mail/draft} under your
home directory.
This file can be recalled later using the \arg{-use} argument
to \pgm{comp}:
\example comp\ -use\endexample
The \whatnow/ level will permit you to do further editing
and to send the final draft when you are ready.

\section{Scanning Messages}
The scan listing created by \pgm{inc} shows the {\it message number},
the date on which the message was sent,
the sender,
and the subject of the message.
If there is sufficient space remaining on the line,
the beginning of the text of the message is displayed as well,
preceded by two left angle brackets (``{\tenpoint\tx$<<$\/}'').
An example of a scan listing is:
$$\vbox{\tenpoint\tx\halign{\hfil#&#\hfil&&	\quad#\hfil\cr
1&+&	10/10&	WESTINE\%USC-ISIF&	RFC 916 Now Available&
					<<A new Request for Co\cr
2&&	10/10&	G B Reilly&		Gosling EMACS manual&
					<<Marshall, I am lookin\cr
3&&	10/11&	WESTINE\%USC-ISIF&	Internet Monthly Report&\cr
}}$$
Note that all messages have message numbers.

To generate your own scan listing, use the \pgm{scan} program.
Typing simply
\example scan\endexample
will list all the messages in the current folder.
To scan a subset of these messages,
you can specify the numbers of the messages that you consider interesting,
e.g.,
\example scan\ 2\ 3\endexample
Message names may be specified in addition to discrete message numbers.
The built-in message names recognized by \MH/ are:
\smallskip
{\advance\leftskip by\parindent
\item{\underbar{all}:}	all messages in the folder (\arg{first-last})
\item{\underbar{first}:}	the first message in the folder
\item{\underbar{last}:}	the last message in the folder
\item{\underbar{prev}:}	the message immediately before the current message
\item{\underbar{cur}:}	the current message
\item{\underbar{next}:}	the message immediately after the current message
\medskip}
\noindent

Message ranges may be specified in addition to discrete message numbers
or names by separating the beginning
and final message numbers with a dash (``-'').
For example,
\example scan\ 5-10\endexample
scans messages~5 through~10 inclusive.
A range of messages may also be specified by separating a beginning
message number and a relative number of messages with
a colon (``:'').
For example,
\example scan\ last:3\endexample
scans the last three messages in the folder.
Similarly,
\example scan\ first:3\endexample
scans the first three messages in the folder;
\example scan\ next:3\endexample
scans the next three messages;
\example scan\ cur:3\endexample
scans the three messages beginning from the current message;
\example scan\ 100:4\endexample
scans four messages beginning from message number 100.

To summarize, the important concepts that have been discussed
in the section are:
{\it message ranges},
{\it message numbers},
and {\it message names}.
When an \MH/ command is described as taking a \arg{msg} argument,
it accepts either a message name or a message number.
Most \MH/ commands are described as taking \arg{msgs} arguments,
meaning that more than one message or message range is accepted.

\section{Deleting Messages}
To delete a message, use the \pgm{rmm} program.
By default, \pgm{rmm} deletes the current message,
but you can give \pgm{rmm} a list of messages to be removed as well.
There is no corresponding ``\pgm{unrmm}'' program,
but clever users with a need will find out how to change the way \pgm{rmm}
works so that it simply moves messages to another folder
(say, \arg{+wastebasket}).

\section{Filing Messages}
The possibility of having folders other than \eg{+inbox} has been mentioned
previously.
The methods for moving messages between folders and manipulating folders
are discussed here.

The \pgm{refile} command moves messages from a {\it source folder} to one or
more {\it destination folders}.
By default, the current message is moved from the {\it current folder} 
(typically \arg{+inbox}) to another folder specified as an
argument to \pgm{refile}.
For example,
\example refile\ +todo\endexample
moves the current message from the current folder to the folder \eg{+todo}.
To move messages from a folder other than the current folder,
use the \switch{src +folder} switch, as in
\example refile\ -src\ +todo\ last\ +save\ +notes\endexample
which moves the last message in the \eg{+todo} folder to the folders
\eg{+save} and \eg{+notes}.
Note that this operation is a {\it move}, not a {\it copy};
it removes the message from the source folder.
To keep a copy in the source folder as well, use the \switch{link} switch
\example refile\ -link\ -src\ +todo\ last\ +save\ +notes\endexample

Whenever a folder argument is given to an \MH/ command,
that folder becomes the {\it current folder}.
To find out which folder is current, use the command
\example folder\endexample
The \pgm{inc} command sets the current folder back to \arg{+inbox}
by default.
To find out about all of a user's folders, use the command
\example folders\endexample
Since folders can contain other folders,
the command
\example folders\ -recurse\endexample
will recursively examine each folder for you.

To set the current folder, without doing anything else,
use the \pgm{folder} program with a folder argument.