\section{The Andrew Toolkit}

The Andrew Toolkit is a graphical user interface and application development 
environment developed at Carnegie Mellon University.  

Athena is offering Andrew applications and the toolkit development
environment on an AS-IS experimental basis.  The {\bf ez} multi-media
document preparation application, and its affiliated
media-manipulation objects, are being considered for inclusion as
Athena supported document preparation tools.

Also of interest to Athena users are: the {\bf messages} multi-media
electronic mail system and the group of program development tools
collectively refered to as {\bf ADEW} for the Andrew Development
Environment Workbench.

\subsection{Overview}
With the Andrew software we get a text editor (called {\bf ez}) that
supports multiple fonts and some formatting, a spreadsheet program
(called {\bf table}), an equation editor/formatter (called {\bf eq}),
a bit image editor (called {\bf raster}), a line drawing editor
(called {\bf zip}), and a variety of other subsystems.

The beauty of the system is in {\bf ez}'s support of {\em insets\/}.
In the middle of your formatted text you can place, for example, a
{\bf table} inset. You do this from within {\bf ez}.  When you click
your mouse in the text, you get the text editor commands.  When you
click your mouse in the table you get the {\bf table} commands.  All
of the subsystems named above can be insets under {\bf ez}.

People interested in experimenting with multi-media electronic mail
should look at {\bf messages}.  The Andrew on-line help system
(mentioned below) contains lots of information about {\bf messages}
under that same topic name.  The {\bf messages} program has a
bewildering array of features.  Reading Athena mail with Andrew {\bf
messages} is turned off by default.  To turn it on, follow the
directions in the file {\tt /mit/andrew/MSGS\_TURNON}.

People interested in writing applications that use the Andrew toolkit
should look at {\bf ADEW}, a rapid prototyping and program generating
system.  The Andrew on-line help system (mentioned below) contains a
terse introduction to {\bf ADEW} under the topic {\bf adew}.  From within
that document one can ask to view Overview, Tutorial, and Reference
documents.

It is also possible to write applications directly in the Andrew
Toolkit.  The Andrew Toolkit is not compatible with the {\em Motif\/}
or {\em Athena Widget\/} toolkits.  However, it does many things that
neither of these toolkits are able to do at the present time.

\subsection{Getting started}

To use Andrew on any Athena workstation, execute the following two
commands:

\begin{verbatim}
attach andrew
source /mit/andrew/.attachrc
\end{verbatim}

This creates a configuration file in your home directory called {\em
preferences\/}, and also puts {\em /mit/andrew/\$hosttype/bin\/} at
the end of your search path.

You can source {\em /mit/andrew/.attachrc\/} every time you log in, or
you can incorporate the features of {\em .attachrc\/} into your dot
files by following the directions in the file {\em
/mit/andrew/DOTMODS\/}.

The Andrew help system contains overviews and well-written on-line 
documentation.  Run it by typing:

\begin{verbatim}
ahelp
\end{verbatim}

The multi-media editor (the star of the Andrew show) is run by typing:

\begin{verbatim}
ez
\end{verbatim}

\subsection{Caveats}

Much of the documentation has just been copied in from Carnegie Mellon
University without changing naming conventions to be compatible with
those of Athena.  For example, wherever documentation mentions
directory paths begining with {\em /usr/andrew\/}, Athena users have to
remember it means {\em /mit/andrew/rt\/} or {\em /mit/andrew/vax\/}
depending on the kind of hardware they are logged into at the time.  A
document on these differences is expected shortly.  If Andrew becomes
supported as Athena software, the documentation will be carefully
revised.

\subsection{Getting more information}

The best source of documentation on Andrew applications is the {\bf
ahelp} program mentioned above.

Athena offers a mini-course on {\bf ez}.  It covers basic editing and
formatting.  Consult the Athena Minicourse Schedule for dates and
times.

The file {\tt /mit/andrew/NEWS} contains up to the minute news of
changes to the Andrew Toolkit and Applications.  It is a good idea to
read this often.

\subsubsection{Mailing lists and discuss meetings}

\begin{itemize}
\item{\bf andrew-news}
receives periodic news about Andrew of interest to all Athena Andrew
users.
\item{\bf andrew-comments}
is for users to send comments, questions and suggestions.
\item{\bf andrew-toolkit}
is for in-depth discussion of issues raised by {\bf andrew-comments}.
\item{\bf andrew-bugs}
is where users send reports of bugs and documentation errors.
\item{\bf Andrew-Toolkit (atk)}
is a Discuss feed of the {\bf andrew-toolkit} mailing list.
\end{itemize}

\subsubsection{A person to contact}
If you are interested in more information or encounter problems using
Athena Andrew, you can contact Bill Cattey at {\tt
wdc@athena.mit.edu}.

He is in charge of making Andrew do what Athena users want.  He can answer 
questions about MIT specific changes that have been made, or should be made. 
He can also answer questions about {\bf ADEW} and {\bf messages}.