% title page for 6.003 manual

\begin{titlepage}

\begin{center}
{\bf Massachusetts Institute of Technology \\
Department of Electrical Engineering and Computer Science}
\end{center}

\vspace{.5 in}

\begin{center}
{\Large\bf A 6.003 User's Guide to the Bobcat System \\
Spring Semester 1987 \\}


\end{center}

\vspace{.2 in}

\begin{center}
{\huge\bf Go ahead---Panic}
\end{center}

\vspace{.5 in}

This manual is an introduction to the Scheme system implemented on the
Hewlett-Packard 300 computer, affectionately called the ``Bobcat.''
It is intended for students in 6.003.\footnote{Parts of this manual
are adapted from a manual for the 6.001 Chipmunk system written by
Todd Cass, from the {\it Revised$\,^3$ Report on
Scheme}~\cite{RRRS} edited by Jonathan Rees and William Clinger, and
from the {\it Gnu Emacs Manual}~\cite{GnuEmacs} by Richard Stallman.}
We strongly suggest that you take time to glance through this manual
at the beginning of the semester, in order to get a general overview
of the system. Bring the manual with you to use as a reference guide
while working on 6.003 computer assignments.

\end{titlepage}

\vspace*{1 in}
\begin{center}
{\huge\bf Important}
\end{center}
\medskip

\noindent
{\Large\bf Do not power down a 6.003 computer!} The Bobcat
installations run the Unix timesharing system.  Powering down a
running Unix can make it confused and angry, and lead it to mangle its
disk files and perform other antisocial acts.  If your computer seems
hung, do {\it not} try fix to things by power cycling the machine.

\bigskip

\noindent
{\Large\bf Be sure to log out} when you are through using the computer.
The files you create are not saved on your floppy disk until you log out.

\vspace*{\fill}

\pagebreak

\vspace*{1 in}
\begin{center}
{\large\bf What parts of this manual to read for 6.003}
\end{center}
\medskip

You should skim through chapters~\ref{overview}
and~\ref{interface}---these describe the general setup of the Scheme
system on the Bobcat.  Chapter~\ref{toolbox} lists the special-purpose
``Toolbox'' procedures for working with signals and systems that have
been added to Scheme for use in 6.003.  You should skim this before
trying to use Scheme in problem sets.  Chapter~\ref{editor} is a
reference manual for Emacs---you needn't do more than glance at it
now, especially if you have used Emacs on Project Athena workstations
or the NMode editor in 6.001.  Chapter~\ref{debugging} describes the
debugging facilities in Scheme.  You should look at the introduction
to the chapter, but you can avoid the rest, at least until you really
get into programming.  Chapter~\ref{scmref} is a Scheme reference
manual.  You might glance at it as a way of refreshing yourself on
Scheme, but there's little point trying to read it through.

\vspace*{\fill}
\pagebreak

\noindent
{\bf Conventions:} The following symbols, conventions, and terms are
used throughout this manual:

\begin{description}
\item[\ctlarrow ] This represents the {\sc ctl} (control) key, located
at the left of the keyboard.  {\sc ctl} behaves like an alternate {\sc
shift} key.
The symbol \ctlarrow{} indicates that the
{\sc ctl} key should be held down while the character immediately
following the \ctlarrow{} symbol is typed.  This rule applies only to
the first character following the \ctlarrow.  For example, to type
\ctl{x} you should hold down the {\sc ctl} key and type {\tt X}.  To
type \ctlx{S} you should hold down the {\sc ctl} key and type
{\tt x}, then release the {\sc ctl} key and type {\tt S}.  To type
\ctlxctl{S} you should hold down the {\sc ctl} key and type {\tt x}
and {\tt S}. Characters generated while the {\sc ctl} key is depressed
are called {\em control characters}.  Do not confuse the uparrow
symbol on the keyboard (shift-6) with the symbol \ctlarrow{} for control
characters.  In all Scheme and Emacs commands, case is not significant
in control characters, e.g., \ctl{X} is the same as \ctl{x}.
\mainindex{control character}

\item[\esckey] This represents an {\em escape character}, sometimes
also called a {\em meta character}.\index{escape character}\index{meta
character}  There are two ways to type an escape character.  One is
to use the {\sc esc} key, located at the upper left of the keyboard.
{\sc esc} is a {\em prefix key}.  Thus, to type \esc{X}, type {sc esc}
and then (after releasing {\sc esc}) type {\tt X}.  An alternate
(somewhat more convenient) way to type escape characters is to use an
{\sc extend char} key, located at either side of the space bar. {\sc
extend char} acts like an alternate {\sc shift key}.  Thus, to type
\esc{X} hold down {\sc extend char} and type {\tt X}.  Case is not
significant in escape characters, e.g., \esc{X} is the same as
\esc{x}.

\item[{\esc{\ctlarrow}}] This represents an {\em escape-control
character}.  You can type this either by using {\sc esc} and {\sc ctl}
or by using {\sc extend} and {\sc ctl}.  Thus, one way to type
\escctl{X} is to type {\sc esc} and then (after releasing {\sc esc})
to hold down {\sc ctl} and type {\tt X}.  An alternative way is to
hold down {\em both} {\sc ctl} and {\sc extend} and type {\tt X}.

\item[{\sc return}] Indicates pressing the {\sc return} key at the
right of the keyboard.

\item[{\sc backspace}] Indicates pressing the {\sc backspace} key at
the upper right of the keyboard.

\item[cursor] The cursor is the flashing mark that indicates
where the next character typed will be displayed.\mainindex{cursor}

\end{description}
