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=-2.9 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI autolearn=unavailable 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-17 13:19:22 PST Path: supernews.google.com!sn-xit-02!supernews.com!isdnet!enst!enst.fr!not-for-mail From: "Robert C. Leif, Ph.D." Newsgroups: comp.lang.ada Subject: RE: Examples in Docs Date: Wed, 17 Jan 2001 13:17:19 -0800 Organization: ENST, France Sender: comp.lang.ada-admin@ada.eu.org Message-ID: Reply-To: comp.lang.ada@ada.eu.org NNTP-Posting-Host: marvin.enst.fr Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Trace: avanie.enst.fr 979766361 11265 137.194.161.2 (17 Jan 2001 21:19:21 GMT) X-Complaints-To: usenet@enst.fr NNTP-Posting-Date: Wed, 17 Jan 2001 21:19:21 +0000 (UTC) To: Return-Path: X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2911.0) Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4522.1200 In-Reply-To: <9430s1$tae$1@nnrp1.deja.com> Errors-To: comp.lang.ada-admin@ada.eu.org X-BeenThere: comp.lang.ada@ada.eu.org X-Mailman-Version: 2.0 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: comp.lang.ada mail<->news gateway List-Unsubscribe: , List-Archive: Errors-To: comp.lang.ada-admin@ada.eu.org X-BeenThere: comp.lang.ada@ada.eu.org Xref: supernews.google.com comp.lang.ada:4119 Date: 2001-01-17T13:17:19-08:00 From: Bob Leif To: Robert Dewar et al. Although, the RM contains the disclaimer you cited, the very fact that these examples were included in the document encourages belief that they are gospel. How about, "The material in each of the hypertext linked examples is only informative, does not have the same authorship, and is not to be construed as part of this document." -----Original Message----- From: comp.lang.ada-admin@ada.eu.org [mailto:comp.lang.ada-admin@ada.eu.org]On Behalf Of Robert Dewar Sent: Tuesday, January 16, 2001 6:43 PM To: comp.lang.ada@ada.eu.org Subject: RE: Examples in Docs 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/