Re: Q: Generating Documenation from Ada Sources?

[tmoran@acm.org]

> > conventions in coding style, so AdaBrowse+ can know which comments are
> > "relevant".
>...
> currently playing around with certain heutistics based on a
> minimal common sense snytax, e.g.

  We went a different way, since most of the source files already
existed, including customer's copies, and we didn't want to change
them.  We have a database of information, for instance every entity
has a Remarks section (which of course may be empty) and a Spec
section.  Subprograms additionally have an Exceptions Raised section,
and so forth.  These are filled in as much as possible by a program
that scans source files for specs, links, comments saying "Raises ..."
directly following a subprogram etc.  But this is viewed as just a
convenience.  We expect most of the text to be entered, or at least
modified by, a human writer.  Syntactic information like the file
something is declared in, the package to "with" for it, any
predefined constants of a type, etc comes from scanning the source
code and is not modified by the documentation writer.