\chapter{Documentation}

\newcommand{\iLaTeX}{{\rm\em L\kern -.25em\raise .3ex\hbox {\sc a}\kern -.26em
T\kern -.1667em\lower.7ex\hbox {E}\kern -.125emX}}

The SIPB provides a variety of documentaion to users.  Some we've
purchased, some we've copied out of other manuals, and some are from


\section{SIPB-Written Documents}

% Info about copyrights on sipb-written docs should go here, and the
% following lines modified apropriately

The Board has written several introductory documents, all of which are
given free to users who need them.  

{\em An Inessential Quick Reference to Athena} is a one sheet manual
that contains the least you need to know to use Athena.  For more
detail, see {\em Getting Started on Athena}, available at Graphic Arts
for free.

The {\em Inessential Guide to Athena} provides a catalog of the
less-publicized commands and capabilities of the Athena system of
people who have learned the basics of Unix.  This document is for more
experienced Unix users.  Beginners should refer to {\em An Essential
Guide to Athena}.

{\em Inessential \iLaTeX{}} is a short guide to the more commonly used
features of this typesetting system.  Currently, \LaTeX{} is one of
the two supported text-processing systems, and the only one both
powerfull and stable enough for thesis work.  Athena itself provides
several documents on \LaTeX{} through Graphic Arts, and full manuals
are available in the office.

{\em Netnews: A One-Page Guide to the Usenet} is intended to provide
the absolute minimum information required to keep things working
smoothly for users of the Usenet.  For more details, you should see
the newsgroup {\tt news.announce.newusers}.

{\em How to Use Xdvi} is a short guide to using the program {\tt
xdvi}, which can be used to view DVI files such as those produced by
\LaTeX{}.  

{\em Discuss - Using Discuss} is a guide to using Discuss, a networked
electronic conferencing system.  For more details, see the office
manual under {em Discuss}.  

{\em Inessential AFS} describes the Andrew File System and how it is
used.  AFS is a network file system or a distributed file system.
This means that the files you gain access to through AFS do not
actually reside on the workstation you are using.

\section{How to Make More Documentation}
	If you want to write a new SIPB document, simply tell people
(so as to avoid duplicating work, and possibly get suggestions) and
start doing it. Once you've got a draft, /afs/sipb/project/doc is a
good place to put it (usually in its own subdirectory.) Be sure to put
draft copies around the office so that people ``bleed'' on them, ie.
scribble on them with comments one what they think is wrong, poor, or
badly typeset. (Don't get discouraged by it -- would you rather have
thousands of users notice instead?)

	Once a document is useful enough to be handed out to people,
we need to make sure copies exist. Survey of in-stock documents is
done during the ``Documentation Report'' section of the weekly
meeting: the document racks at the front of the office are checked
first, and if there's none (or little) there, the documentation drawer
in one of the filing cabinets at the back of the office is checked for
extras.  If anything is critically low, make a motion of the form
``Move to allocate up to $x$ dollars for $y$ copies of $foo$,'' and
volunteer to deal. To deal, take a newly printed double-sided copy of the
document to CopyTech (11-004).  There you will need to fill out a Monthly
Account form.  The monthly account number is 68, and copies should be
double-sided and stapled.  (Make sure you specify the number of copies and
that copies should be delivered to the SIPB office, W20-557.)

We also stock some Athena documentation such as cluster cards, Athena
reference cards, and Emacs reference cards. To restock these, just
send mail to sendpubs requesting what you want, and cc: sipb-office so
that people know the documentation is on the way.
