@make(report)
@Counter(Section,Within Chapter,TitleEnv HD2,ContentsEnv tc2,
          Numbered [@#@:.@1 ],Referenced [@#@:.@1],IncrementedBy
          Use,Announced)
@Style(Spacing 1, indent 0)
@Style(leftmargin 1.0inch)
@Style(justification yes)
@Style(TopMargin 1.5inch)
@Style(BottomMargin 1.0inch)
@Style(ChangeBarLocation Right)
@Style(ChangeBars=off)
@style(date "March 8, 1952")
@pageheading(immediate)
@pagefooting(left="MIT Project Athena",
center="@value(page)",right="Version A, November 1987")

@center[ESSENTIALLY ONLINE]
@blankspace [2 lines]

You're at an Athena cluster, finishing a paper just minutes before
it's due.  You'd like to format it so that it will look nice, but
there aren't any copies of Athena's scribe documentation for you to
read.  Annoying?  Not any more.  Now you can read Athena's
documentation at your workstation any time that you want.

@section[How to Use Athenadoc]

Athena now keeps special versions of its documentation available
online.  Everything is in the NFS filesystem @p[athenadoc], and you
can read it with the PostScript previewer, @b[postps].  The previewer
is still in the experimental phase; it has bugs and is not yet
supported software.@foot[This means that Consultants are not required
to know about it and may not be able to answer your questions.  It
also means that any bugs in the program may or may not be fixed.]
What does this mean to you?  When @i[postps] doesn't work, you have to
live with it.  Many of the problems are cosmetic and will not stop you
from reading documentation; others are more serious and could prevent
you from being able to read a document.  See Section 3, below.

Looking at any document is a simple, three-step process.  First,
@i[attach] the athenadoc NFS locker, then @i[cd] into it.  Here's how:

@begin [example]
% @b[attach athenadoc]

athenadoc: NFS mounted odysseus.MIT.EDU:/u2/athenadoc on 
/mit/athenadoc (read-only)

% @b[cd /mit/athenadoc]
@end [example]


@newpage
Once you are in @i[athenadoc], you can check document names using
@i[ls] (or see the list of documents in Section 2).  When you know the
name of whatever you want to see, use @i[postps].  

@begin [example]
% @b[postps] @i[filename.PS] 
@end [example]

@i[postps] creates a page-sized window where it displays text.  When
you get the "rubber-band" cursor, move the cursor to the upper
lefthand corner, because the window is as tall as the screen and as
wide as a sheet of paper.  Then, hit either the left or right mouse
key to create the window.

With @i[postps], you can move through a document using the mouse, the
onscreen menu, or the keys.

@begin [group, spacing 0.75]
@TabClear()
@TabDivide [4]


@\@u[Mouse]@\@u[Menu]@\@u[Keys]

Forward@\Right Key@\@i[Next] Box@\Spacebar

Back@\Left Key@\@i[Prev] Box@\Backspace

Exit@\Middle Key@\@i[Exit] Box@\CTRL-C
@end [group]


@section [@i(Ess) is not @i[More]: File Names]

Most documents in @i[athenadoc] cover basic topics and are either from the
@i[Essential] or @i[More] series; they have names like
@i[emacs.ess.PS] (@p[Essential Emacs]) or @i[c.more.PS] (@p[More C]).

@p[Athena Workstation], which covers the basics of getting around
Project Athena, is also in @i[athenadoc].  There are also some
documents on specific topics, such as @p[Programming the RT
Workstation] and @p[An Athena Guide to Penplot]; these have names
which describe their subject, (@i[rt.programming.PS] and
@i[penplot.athena.PS]).  For a complete list, see the next page.

@newpage
@begin [format]
@TabClear()
@TabDivide [2]
@begin [group, spacing 1.4]
@b[Document Name]@\@b[File Name]
Short List of Athena Documents*@\athena.doc.shortlist.PS
@end [group]
Athena Principles@\athena.principles.PS

Athena Workstation*@\athena.workstation.PS

Essential Athena*@\athena.ess.PS
Essential C*@\c.ess.PS
Essential Emacs*@\emacs.ess.PS
Essential Fortran*@\fortran.ess.PS
Essential Mail*@\mail.ess.PS
Essential RS/1*@\rs1.ess.PS
Essential Scribe*@\scribe.ess.PS

More C*@\c.more.PS
More Emacs*@\emacs.more.PS
More Scribe: Report*@\scribe.more.report.PS
More Scribe: Resume*@\scribe.more.resume.PS
More Scribe: MIT Thesis*@\scribe.more.thesis.PS
More Unix: The C Shell*@\unix.more.cshell.PS

An Athena Guide to Penplot @\penplot.athena.PS
Penplot: QPICTR@\penplot.qpictr.PS

Programming the RT Workstation*@\rt.programming.PS

@end [format]
*Free printed copies available in 11-112, behind the "Fishbowl."


Copies of most of these documents are available for reference in
documentation racks in all the clusters.

@section (Problems with @i[postps])

Because @i[postps] is very new software, there are still some bugs in
it.  Here are some of the snags which you may hit:

@begin [itemize]

Underlining, italics, and boldface might look sloppy.

Examples, tables, and diagrams may not line up cleanly.

Sometimes, the @i[postps] window disappears as you attempt change
pages.  You will see the following message: @example
(Sysmsg: Postscript Stack Overflow.)  This means that the @i[stack],
which fills as the processor encounters errors, has too much
information in it and has aborted the program.  (The stack is more
likely to overflow when you flip back and forth between pages.)  If
this happens, you can still read the document, but you will have to
start the previewer again.

@end [itemize]

If you want to make comments or report bugs which aren't mentioned
here, send a note to @b[docreqst].  Please do @p[NOT] send mail to
@b[bugs].

@section [Final Notes]

If you are finished with @i[athenadoc], you may want to detach the
filesystem.  First, @i[cd] to another directory, and then type
@example[% @b(detach athenadoc)]  If you try to detach the locker and
get the following message

@begin [example]
% @b[detach athenadoc]
/mit/athenadoc: Device busy
Can't unmount athenadoc.
@end [example]

don't worry.  @i[athenadoc] will be detached when you log out.