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.7 required=5.0 tests=BAYES_00,MSGID_RANDY autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,e61c8636ef35379d X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2001-01-16 18:52:03 PST Path: supernews.google.com!sn-xit-03!supernews.com!cyclone-sjo1.usenetserver.com!news-out.usenetserver.com!feed2.onemain.com!feed1.onemain.com!news-out.cwix.com!newsfeed.cwix.com!news.maxwell.syr.edu!nntp2.deja.com!nnrp1.deja.com!not-for-mail From: Robert Dewar Newsgroups: comp.lang.ada Subject: RE: Examples in Docs Date: Wed, 17 Jan 2001 02:43:15 GMT Organization: Deja.com Message-ID: <9430s1$tae$1@nnrp1.deja.com> References: NNTP-Posting-Host: 205.232.38.14 X-Article-Creation-Date: Wed Jan 17 02:43:15 2001 GMT X-Http-User-Agent: Mozilla/4.61 [en] (OS/2; U) X-Http-Proxy: 1.0 x63.deja.com:80 (Squid/1.1.22) for client 205.232.38.14 X-MyDeja-Info: XMYDJUIDrobert_dewar Xref: supernews.google.com comp.lang.ada:4079 Date: 2001-01-17T02:43:15+00:00 List-Id: In article , comp.lang.ada@ada.eu.org wrote: > From: Bob Leif > The hypertext document should include a disclaimer and each > example could have a short disclaimer stating that the > example(s) are not part of the official Reference Manual. Perhaps it could use the existing wording in the Ada Reference Manual section 1.1.2 :-) 14 The core language and the Specialized Needs Annexes are normative, except that the material in each of the items listed below is informative: 15 Text under a NOTES or Examples heading. 16 Each clause or subclause whose title starts with the word ``Example'' or ``Examples''. I generally don't think the RM is a very good source for learning anyway, though perhaps a version which was annotated with explanations and extra examples, all hyper-linked could be useful. The old annotated Fortran standard might be an interesting model Sent via Deja.com http://www.deja.com/