%	This is a cheat sheet for getting on Bonnie and using the
%	mail facilities provided by MH.

\documentstyle{article}

\title{Using Mail On Bonnie}
\author{Karl B. Schwamb}
\date{5 October 1987}

\begin{document}

\maketitle

	This document provides instructions for accessing Bonnie and
	using the mail facilities.  Both local and remote login
	procedures are discussed.

\section{Logging Into Bonnie}

	First, let's consider how to gain remote access via 
	modem\footnote{Full instructions are provided in handouts 
		       available from the Computer Center Consultant in
		       CS 346 (phone: 856-6116).}.
	(If you are using the computer facility
	terminal rooms you may skip to the next 
	paragraph.)  Your terminal emulator should be set to full
	duplex, no local echo, xon/xoff (if possible), 7 or 8 data bits,
	1 stop, and even parity (for 7 bit data) or none (for 8).
	Once setting the terminal characteristics you may dial into
	(714) 856-5601, -5611, or -5621 which adjust to your baud rate
	(300 or 1200)\footnote{A 2400 baud line is available also: -5661}.

	If you are using a terminal in the computer facility, simply
	power it up!  At this point, both local and remote users are
	ready to access Bonnie via the UCI local area network (LAN).
	First, type \underline{\bf rs} to get the attention of the LAN 
	controller\footnote{User input will be shown in {\bf bold} typestyle
			    while computer responses will be shown in
			    {\tt Typewriter} font}.  Your input will not be 
	echoed.  If the LAN controller has seen you, it will answer with
	\underline{\tt Request:}, at which 
	point you enter \underline{\bf bonnie}.  You should
	now be connected to Bonnie.  If you do not receive Bonnie's login
	prompt, just enter a few carriage returns to wake it up.  Now
	you can enter your login name and password\footnote{These are
	provided by the computer facility}.  After jumping these hurdles,
	you are now logged in!

\section{Using the Mail Facilities}

	The mail facility you will be using is called the MH system.
	To introduce you to the mail system, I have edited the following
	material from
	the section of the UNIX Programmer's Manual dealing with MH.
	For a more detailed introduction to MH, see the references.

     MH is the name of a powerful message handling system.
     Rather then being a single comprehensive program, MH consists 
	of a collection of fairly simple single-purpose programs 
	to send, receive, save, and retrieve messages.  The
     user should refer to the MH User's Manual and the pages for
     the MH programs in the Unix Programmers Manual.

     Unlike {\em mail}, 
	the standard UNIX mail user interface program,
     MH is not a closed system which must be explicitly run, then
     exited when you wish to return to the shell.  You may freely
     intersperse MH commands with other shell commands, allowing
     you to read and answer your mail while you have (for example) 
	a compilation running, or search for a file or run programs 
	as needed to find the answer to someone's question
     before answering their mail.

     When you login for the first time, run the \underline{\bf inc} 
	command.  If you've never used
     MH before, it will create the necessary default files and
     directories after asking you if you wish it to do so.

     {\em inc} moves mail from your system maildrop into your MH
     ``+inbox'' folder, breaking it up into separate files and 
	converting it to MH format as it goes.  It prints one line for
     each message it processes, containing the from field, the
     subject field and as much of the first line of the message
     as will fit.  It leaves the first message it processes as
     your current message.  You'll need to run {\em inc} each time you
     wish to incorporate new mail into your MH file.

     {\em scan} prints a list of the messages in your current folder.

     The commands: {\em show}, {\em next}, and {\em prev} 
     are used to read specific
     messages from the current folder.  {\em show} displays the current
     message, or a specific message, which may be specified by
     its number, which you pass as an argument to show.  {\em next} and
     prev display, respectively, the message numerically after or
     before the current message.  In all cases, the message
     displayed becomes the current message.  If there is no
     current message, {\em show} may be called with an argument, or
     {\em next} may be used to advance to the first message.

     {\em rmm} (remove message) deletes the current message.  It may be
     called with message numbers passed as arguments, to delete
     specific messages.

     {\em repl} is used to respond to the current message (by default).
     It places you in the editor with a prototype response form.
     While you're in the editor, you may peruse the item you're
     responding to by reading the file ``@''.  After completing your
     response, type l to review it, or s to send it.

     {\em comp} allows you to compose a message by putting you in the
     editor on a prototype message form, and then lets you send
     it.

     All the MH commands may be run with the single argument:
     `-help', which causes them to print a list of the arguments
     they may be invoked with.


\section{References}

  \begin{enumerate}

     \item The Rand MH Message Handling System: User's Manual
     \item The Rand MH Message Handling System: Tutorial
     \item The Rand MH Message Handling System: The UCI BBoards Facility

  \end{enumerate}

\end{document}