RE: Examples in Docs

["Robert C. Leif, Ph.D." <rleif@rleif.com>]

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 <mailman.979661289.9558.comp.lang.ada@ada.eu.org>,
  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/