RE: Building documentation from comments

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

Returning to the title of this thread, "Building documentation from
comments", one might wish to replace the comment with the equivalent of
an XML Annotation or Annotations.Documentation. The Ada translation of
the XML model would be to create an Annotations Package and a
Documentation child package.  These packages would included an
instantiation of a bounded string type of the appropriate size to be a
Copyright(Copyright_Bd). Each package then can have a group of
annotations that include the Copyright_Bd, Author(s) Revision_Dates etc.
These can even have default values or when appropriate point to a URL.
The use of a URL has the advantage of permitting direct access to the
text of large legal documents without cluttering the code.
Bob Leif