From: Lionel Draghi <Lionel.nospam.Draghi@Ada-France.org>
Subject: Re: Javadoc-like for Ada
Date: Tue, 12 Oct 2004 00:53:16 +0200
Date: 2004-10-12T00:54:33+02:00 [thread overview]
Message-ID: <416b0f25$0$1177$626a14ce@news.free.fr> (raw)
In-Reply-To: <41651D37.4030805@mailinator.com>
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
prev parent reply other threads:[~2004-10-11 22:53 UTC|newest]
Thread overview: 44+ messages / expand[flat|nested] mbox.gz Atom feed top
2004-10-07 10:40 Javadoc-like for Ada Alex R. Mosteo
2004-10-07 11:46 ` stephane richard
2004-10-07 13:05 ` Marc A. Criley
2004-10-07 13:39 ` Alex R. Mosteo
2004-10-07 16:51 ` Problem with -gnatt (was Re: Javadoc-like for Ada) Alex R. Mosteo
2004-10-07 18:43 ` Marc A. Criley
2004-10-07 20:07 ` Björn Persson
2004-10-08 8:40 ` Alex R. Mosteo
2004-10-07 19:21 ` Problem with -gnatt Ludovic Brenta
2004-10-08 8:45 ` Alex R. Mosteo
2004-10-08 9:43 ` Martin Dowie
2004-10-08 13:09 ` Alex R. Mosteo
2004-10-09 14:17 ` Stephen Leake
2004-10-15 20:11 ` Matthew Heaney
2004-10-18 7:59 ` Alex R. Mosteo
2004-10-08 16:52 ` Ludovic Brenta
2004-10-09 14:16 ` Stephen Leake
2004-10-09 14:45 ` Jeff C r e e.m
2004-10-10 12:25 ` Ludovic Brenta
2004-10-10 14:42 ` Stephen Leake
2004-10-15 20:03 ` Matthew Heaney
2004-10-16 13:16 ` Stephen Leake
2004-10-15 20:00 ` Matthew Heaney
2004-10-15 20:06 ` Matthew Heaney
2004-10-18 7:59 ` Alex R. Mosteo
2004-10-18 16:48 ` Matthew Heaney
2004-10-18 18:21 ` Alex R. Mosteo
2004-10-19 0:20 ` Matthew Heaney
2004-10-19 2:41 ` Brian May
2004-10-19 3:08 ` Matthew Heaney
2004-10-19 7:15 ` Alex R. Mosteo
2004-10-19 14:52 ` Matthew Heaney
2004-10-19 15:46 ` Alex R. Mosteo
2004-10-19 20:03 ` Matthew Heaney
2004-10-19 20:38 ` Alex R. Mosteo
2004-10-23 6:28 ` Brian May
2004-10-24 5:45 ` Jeffrey Carter
2004-10-24 8:54 ` Dmitry A. Kazakov
2004-10-20 1:20 ` Jeffrey Carter
2004-10-20 14:48 ` Matthew Heaney
2004-10-19 7:36 ` Alex R. Mosteo
2004-10-20 5:19 ` Simon Wright
2004-10-20 7:59 ` Alex R. Mosteo
2004-10-11 22:53 ` Lionel Draghi [this message]
replies disabled
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox