From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-0.9 required=5.0 tests=BAYES_00,FORGED_GMAIL_RCVD,
	FREEMAIL_FROM autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news2.google.com!postnews.google.com!c29g2000yqd.googlegroups.com!not-for-mail
From: Maciej Sobczak <see.my.homepage@gmail.com>
Newsgroups: comp.lang.ada
Subject: Re: Doxygen for Ada
Date: Tue, 21 Jul 2009 01:07:07 -0700 (PDT)
Organization: http://groups.google.com
Message-ID: 
 <cd6d6d22-0be7-4646-b3ae-377793c55daa@c29g2000yqd.googlegroups.com>
References: 
 <92ed2215-f451-4ca7-b40d-2cb8bf27ba50@b15g2000yqd.googlegroups.com>
NNTP-Posting-Host: 137.138.182.236
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-Trace: posting.google.com 1248163627 22660 127.0.0.1 (21 Jul 2009 08:07:07
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Tue, 21 Jul 2009 08:07:07 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: c29g2000yqd.googlegroups.com; posting-host=137.138.182.236;
	posting-account=bMuEOQoAAACUUr_ghL3RBIi5neBZ5w_S
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US;
	rv:1.9.0.11) Gecko/2009060214 Firefox/3.0.11,gzip(gfe),gzip(gfe)
Xref: g2news2.google.com comp.lang.ada:7200
Date: 2009-07-21T01:07:07-07:00
List-Id: <comp.lang.ada>

On 20 Lip, 17:38, Pablo <pablit...@gmail.com> wrote:

> Does someone knows some Doxygen documentation script which runs over
> Ada code?

I have written a script that generates pretty nice docs in the Doxygen/
Javadoc/etc. style, but it works differently from other tools. Instead
of analyzing the code on the ASIS level it assumes that the source
code is "well formatted" and processes it based on the vertical and
horizontal whitespace patterns. Due to the regular structure of the
Ada grammar the whole task is reduced to simple regexp crunching
without any serious compile-like analysis - and is therefore blazing
fast.
I don't claim that its language coverage is complete, but it proved to
be very useful.

The script generates a set of HTML pages with indexes and stuff.

As pointed above, it works *only* when the code is "well formatted",
which means that newlines and indentation should be used according to
common conventions. Fortunately, most of the Ada code that was ever
written is well formatted in this sense. I was able to use this script
for the libraries that come with GNAT, and also for AWS, PolyORB, etc.

Please contact me privately (do not use the mail address in this post,
it is just a spam trap - follow the links in the signature instead) if
you are interested in this script. If there will be a wider interest I
will publish it on the web.

--
Maciej Sobczak * www.msobczak.com * www.inspirel.com

Database Access Library for Ada: www.inspirel.com/soci-ada