From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-1.3 required=5.0 tests=BAYES_00,INVALID_MSGID
	autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,7f0734f2e7653d35
X-Google-Attributes: gid103376,public
From: pitre@n5160d.nrl.navy.mil (Richard Pitre)
Subject: Re: GNAT's gnatchp
Date: 1996/04/02
Message-ID: <4jsb4t$j2u@ra.nrl.navy.mil>#1/1
X-Deja-AN: 145497878
references: <dewar.828333453@schonberg>
organization: Naval Research Laboratory
newsgroups: comp.lang.ada
Date: 1996-04-02T00:00:00+00:00
List-Id: <comp.lang.ada>

In article <dewar.828333453@schonberg> dewar@cs.nyu.edu (Robert Dewar) writes:
> "I have been trying to get the GNAT utility "gnatchp" to work
> without success.
> 
> I have strictly followed the documentation"
> 
> Well that's a nice contradiction. There is no such thing as the
> GNAT utility "gnatchp", so it would be *quite* hard to follow
> the documentation, strictly or otherwise, on gnatchp, since
> there is none.
> 
> Undoubtedly you read the documentation or GNATCHOP, not gnatchp.
> Changing names in commands does not come under the category'
> of strictly following documentation I am afraid :-) :-)
> 
> Nearly all difficulties with GNAT come from not following the
> documentation exactly in our experience (I mean intallation
> difficulties here).
> 
> One of my students in my class wrote a note today saying that books
> in CS were useless, the only way to learn is by example! I replied
> that the ability to read documentation accurately is an important
> skill! I guess this is a nice example :-)

The ability to write documentation that makes simple and obvious
things look simple and obvious is also an important skill.
It sounds like your documentation could use a little rearrangment so that
priority items like installation, got priority billing.

richard