Path: utzoo!utgpu!jarvis.csri.toronto.edu!mailrus!csd4.milw.wisc.edu!uakari.primate.wisc.edu!indri!ames!vsi1!ubvax!ardent!peck!rap
From: rap@peck.ardent.com (Rob Peck)
Newsgroups: comp.sys.amiga
Subject: Re: My AmigaDOS 1.4 wishlist (one among thousands!)
Message-ID: <7633@ardent.UUCP>
Date: 28 Jul 89 16:22:36 GMT
References: <12878@well.UUCP>
Sender: news@ardent.UUCP
Reply-To: rap@peck.ardent.com (Rob Peck)
Organization: Ardent Computer Corp., Sunnyvale, CA
Lines: 25

In article <12878@well.UUCP> xanthian@well.UUCP (Kent Paul Dolan) writes:
>
>Generically, your command documentation needs much more motivational
>information added.  When I read your docs, I know _how_ to use the commands,
>but neither _why_, _when_, nor _where_.
>
I considered this same situation when I wrote the Amiga Companion.
For those who are interested, it does address Kent's objections here...
the chapters that are provided group commands by function type, allowing
a new-ish user who has some idea what he wants to actually do a pretty
good chance of finding the right command.  And each option of each command
is illustrated by explicit example, here's what you type, here's what you 
see, here's what it means, and here's WHY you are interested in knowing
about it.  (And at COMMODORE's request, I even explained the startup-
sequence "in English".)  The second edition of the Amiga Companion is
now available from IDCG publications (an ad in the back of Amiga
World since about a month ago) and is soon to be available at your local
dealer.  They ARE encouraging dealer orders now.  (WHEW!)  The price
for the second edition remains the same as that of the first edition,
even though the page count has increased by about 50.

First edition purchasers should read the PREFACE for a low-cost update offer.


Rob Peck