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=-0.3 required=5.0 tests=BAYES_00, REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,43f65db68662a705 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 1995-03-23 22:11:15 PST Path: nntp.gmd.de!Germany.EU.net!howland.reston.ans.net!news.cac.psu.edu!news.pop.psu.edu!hudson.lm.com!newsfeed.pitt.edu!dsinc!netnews.upenn.edu!msunews!harbinger.cc.monash.edu.au!bunyip.cc.uq.oz.au!uqcspe.cs.uq.oz.au!cs.uq.oz.au!dan From: dan@cs.uq.oz.au (Dan Johnston D.B.) Newsgroups: comp.lang.ada Subject: Readability of manual (was Re: Top 10 Ada myths) Date: 24 Mar 1995 06:11:15 GMT Organization: Computer Science Dept, University of Queensland Distribution: world Message-ID: <3ktnq3$bqt@uqcspe.cs.uq.oz.au> References: <51286.pukite@daina.com> <3kc5ig$164a@watnews1.watson.ibm.com> <3kr29h$grh@gnat.cs.nyu.edu> Reply-To: dan@cs.uq.oz.au NNTP-Posting-Host: camellia.cs.uq.oz.au Date: 1995-03-24T06:11:15+00:00 List-Id: In eachus@spectre.mitre.org (Robert I. Eachus) writes: > In Ada 95, the approach is different. Tucker did a very good job >of putting all the rules in the RM, and much of the elaboration needed >to understand the rules in the annotated version. As a result, the RM >is somewhat less readable than in 1983, but those who do read it come >away with many fewer misconceptions. Since the rationale is not only >very readable, maintained and printed in parallel, I think that the >net effect of the 95 approach is a major improvement. It appears to me (as a reader only) that there is a difference in the intended audience. The Ada 83 manual seemed to be directed towards the programmer, whereas the Ada 95 manual seems to be directed towards compiler writers and tool developers. I found the Ada 83 manual quite readable. When programming, if I had doubts I could generally go to the manual and find what I wanted. (This was helped, I believe, by the fact that the compilers I used generally reported the number of the reference manual clause in the error messages.) On the other hand, with the Ada-95 manual, I find it very difficult to find (and then understand) the rules. The gnat error messages are generally good but they don't help find the relevent rules in the manual. I don't believe that either the rationale or a text book is a substitute for a good manual. Perhaps if I could get a copy of the annotated manual it might help. (I have ftp'd it but unfortunately it is too large to print on our system.) I know that a lot of programmers like to learn from examples but I don't find that adequate by itself and like to see the rules. I know my brain has slowed down in the intervening 10+ years but I would have hoped that a good knowledge of Ada-83 would have compensated for that in trying to read the Ada-95 manual. Perhaps the origins of Ada-83 in the competitive design process (Green vs Red etc) was an influence in making its manual more readable. dan. Dan Johnston, Dept of Comp Sci, Uni of Queensland, Australia. dan@cs.uq.oz.au