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=-1.9 required=5.0 tests=BAYES_00 autolearn=ham
	autolearn_force=no version=3.4.4
X-Google-Thread: 103376,e44790cdcea9da82
X-Google-Attributes: gid103376,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!news1.google.com!news.glorb.com!news.agarik.com!usenet-fr.net!proxad.net!feeder2-1.proxad.net!news13-e.free.fr!not-for-mail
Date: Tue, 12 Oct 2004 00:53:16 +0200
From: Lionel Draghi <Lionel.nospam.Draghi@Ada-France.org>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; fr-FR;
 rv:1.7.3) Gecko/20041007 Debian/1.7.3-5
X-Accept-Language: en-us, it
MIME-Version: 1.0
Newsgroups: comp.lang.ada
Subject: Re: Javadoc-like for Ada
References: <41651D37.4030805@mailinator.com>
In-Reply-To: <41651D37.4030805@mailinator.com>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Message-ID: <416b0f25$0$1177$626a14ce@news.free.fr>
Organization: Guest of ProXad - France
NNTP-Posting-Date: 12 Oct 2004 00:54:33 MEST
NNTP-Posting-Host: 82.65.180.151
X-Trace: 1097535273 news13-e.free.fr 1177 82.65.180.151:52235
X-Complaints-To: abuse@proxad.net
Xref: g2news1.google.com comp.lang.ada:5057
Date: 2004-10-12T00:54:33+02:00
List-Id: <comp.lang.ada>

Alex R. Mosteo wrote:
> Hi,
> 
> I'm insterested in some doc generation tool ala javadoc; i.e. that not 
> only creates a listing like gnathtml but also capable of extracting 
> explanations from properly formatted comments in the specification.
> 
> I've heard good things about doxygen and I'm going to review it to see 
> if it's suitable for Ada.
> 
> Any other options I should consider?

http://www.naturaldocs.org/ don't require neither special tags in the 
code, nor ASIS.
Building a doc from your sources, or whatever file that can be displayed 
in a brower is easy.

NaturalDocs is far from being as good as gnathtml/AdaDoc/AdaBrowse to 
extract procedure parameters and so on, but as this is clearly one of 
the most uninterresting thing to put in a doc, I don't care. I can use 
emacs or GPS for this kind of navigation.

On the other hand, NaturalDocs is very good at extracting explanations 
from comments, and this seems generaly much more interresting to me.

-- 
Lionel