Re: Q: Generating Documenation from Ada Sources?

["Ira D. Baxter" <idbaxter@semdesigns.com>]

The DMS Software Reengineering Toolkit
can parse Ada, build ASTs, and then
use custom code to extract what you want.
(It is kind of like ASIS, for a whole
set of langauges; not as complete
as ASIS wrt Ada, but more capable
than ASIS in the DMS can
actually change the source tree
and the prettyprint the changed
result.  The latter capability
isn't needed for documenation
extraction).

Part of the customization process can control
how many syntax faults are acceptable before
it gives up (at the price of getting a
syntax tree with error insertions that
might not make sense, but error
recovery is a tough topic).

For the original poster, who wants to
extract certain information and then
reformat the way he likes,
I'd suggest extracting the information
he needs and dumping as XML text.
One can use XSLT to reshape the
result pretty much as you like.
This decouples extraction from
formatting.

See http://www.semdesigns.com/Products/DMS/DMSToolkit.html.

--
Ira D. Baxter, Ph.D. CTO Semantic Designs, Inc.
http://www.semdesigns.com

<tmoran@acm.org> wrote in message
news:SWxD8.1171$fy5.65482852@newssvr21.news.prodigy.com...
> The tool for Claw only requires the public part of specifications to be
> parsable with an ayacc Ada grammar.  The only semantic requirement I
> recall is that things are assumed to be defined before use.
>
> It would be nice if there was a cut down, highly forgiving, version of
> ASIS to handle incomplete programs or situations where a compiler bug
> prevents compilation and thus prevents use of the current ASIS.