Path: utzoo!attcan!uunet!samsung!dali.cs.montana.edu!uakari.primate.wisc.edu!sdd.hp.com!ucsd!ucbvax!mtgzx.att.com!cch From: cch@mtgzx.att.com (C C Hayden) Newsgroups: comp.soft-sys.andrew Subject: Re: Andrew Documentation Message-ID: Date: 25 Jul 90 18:13:25 GMT Sender: daemon@ucbvax.BERKELEY.EDU Organization: The Internet Lines: 21 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