[comp.soft-sys.andrew] Andrew Documentation

dmh@GOANNA.CS.RMIT.OZ.AU (Darren Hosking) (03/02/90)

Is there a document somewhere (latex, ditroff, or text file) that gives an
overview of andrew and all its features? I couldn't find anything on the
R4 tapes apart from individual descriptions of ams, atk, and oda. We want
to know exactly what it does before attempting to compile it on our
hybrid SYSV/BSD monster/machine.

	Thanks in advance, dmh

Darren Hosking				ACSnet: dmh@goanna.oz	 
Department Of Computer Science		ARPA:   dmh%goanna.oz.au@uunet.uu.net
RMIT					CSNET:  dmh%goanna.oz.au@australia
GPO Box 2476V				UUCP:   ...!uunet!goanna.oz.au!dmh
Melbourne Vic., Australia 3001

hans@TA.OLIVETTI.COM ("Hans v. Kleist-Retzow") (07/25/90)

In the new Andrew version 3 I am looking for all the documentations
which where included in the previous release. There were e.g. 
    -A Guide to Andrew,
    - The Andrew System
        Programmer's Guide to the Andrew Toolkit
    - etc.

Many of them were postscript files, which included some images and nice
formatting.

Were are they?

ao06+@ANDREW.CMU.EDU (Ayami Ogura) (07/25/90)

The "Guide to Andrew"  and the "Programmer's Guide to the Andrew
ToolKit" no longer exist -- the documentation has become quite large and
instead of one user guide (which was written for the CMU site only) and
a two-volume programmer's guide, each class or application has been
documented in a separate .doc or .help file and stored with the code for
that class/application in the source directories.  General information
and documents on ATK can be found in the atk source directory /doc.

At the present time, we are working on scripts using datacat that will
group and organize all the files and print/store them as volumes for
easier access.  When the scripts are ready, we hope to release them as a
patch. 

_____________________________________

Ayami Ogura
Information Technology Center
Carnegie Mellon University
(412) 268-6798
INET:  ao06+@andrew.cmu.edu
BITNET:  ao06+%andrew.cmu.edu@cmccvb
UUCP:  ...harvard!andrew.cmu.edu!ao06+

cch@mtgzx.att.com (C C Hayden) (07/26/90)

The old manual by Neuwirth and Ogura (Volume II) is far superior to the
current documentation being distributed by the ITC.  I am glad I did not
discard my old reference manual, because it is impossible to find
anything in the new manuals (the pages are not numbered).  Also, most of
what I need to know is not there and there are "no short-term plans for
completing" the documents.  Much of this material WAS in the previous
reference manual, which WAS numbered.  

Andrew cannot become more widespread without an active community of
people contributing useful software, and that cannot happen until there
is adequate documentation.  I consider the example-based exposition
followed by N&O (Volume I) and by Borenstein to be worse than nothing,
because it teaches you bad habbits with respect to software reuse in an
object-oriented system.  At least N&O (Volume II) was neutral -- just
the facts (mostly).  This is another area in which Andrew needs serious
attention.

Charles Hayden  cch@mtgzx.att.com
Bell Labs   MT 3G-408
200 Laurel Ave, Middletown, NJ 07748
(201) 957-5558