RE: Examples in Docs

[Robert Dewar <robert_dewar@my-deja.com>]

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/