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-Language: ENGLISH,UTF8
Path: 
 g2news1.google.com!news2.google.com!npeer03.iad.highwinds-media.com!news.highwinds-media.com!feed-me.highwinds-media.com!post02.iad.highwinds-media.com!news.flashnewsgroups.com-b7.4zTQh5tI3A!not-for-mail
Newsgroups: comp.lang.ada
Subject: Re: Ada and Doxygen
References: <op.u8mib9tdvwnd5a@garhos>
 <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net>
 <op.u8mpsskzvwnd5a@garhos>
From: Stephen Leake <stephen_leake@stephe-leake.org>
Date: Thu, 25 Feb 2010 07:18:10 -0500
Message-ID: <u7hq1y0e5.fsf@stephe-leake.org>
User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.2 (windows-nt)
Cancel-Lock: sha1:fYKS/JW0+F50ztKeRpqidHe6xFg=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Complaints-To: abuse@flashnewsgroups.com
Organization: FlashNewsgroups.com
X-Trace: 380464b866a82e197caa729403
Xref: g2news1.google.com comp.lang.ada:9318
Date: 2010-02-25T07:18:10-05:00
List-Id: <comp.lang.ada>

"Hibou57 (Yannick Duchêne)" <yannick_duchene@yahoo.fr> writes:

> Le Wed, 24 Feb 2010 11:10:16 +0100, Georg Bauhaus
> <rm.dash-bauhaus@futureapps.de> a écrit:
>> Not being a designer, I still think there already
>> is something serving as an even better solution
>> (in terms of real-world usability).
>>
>> Using facilities of AI05-0183,
>>
>>
>>  procedure Pop (Cap : Bottle_of_Beer)
>>    with Brief => "produces the sound of opening a bottle",
>>         Pre'Class => not Is_Open (Bottle);
> We all wait for that, but it is not there, and anyway, it's source and
> source will never have the expected properties of a document (like
> publication, browsing).

Browsing is better for Ada in GPS or Emacs Ada mode; you can get to
_all_ of the source, not just what the Doxygen viewer has access to. 

what do you mean by "publication"?

> I was also seeking for something like this for other purpose I will
> not  talk about for the moment (let say it has to deal with verbosity
> and  contexts which are foreign to sources).

"contexts foreign to sources" requires something much better than
Doxygen can provide. It has to abstract and summarize the whole
program; Doxygen comments are all local.

-- 
-- Stephe