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,FREEMAIL_FROM
	autolearn=ham autolearn_force=no version=3.4.4
X-Google-Thread: a07f3367d7,9124c8b7efcea462
X-Google-Attributes: gida07f3367d7,public,usenet
X-Google-NewGroupId: yes
X-Google-Language: ENGLISH,ASCII
Path: 
 g2news1.google.com!postnews.google.com!k18g2000prf.googlegroups.com!not-for-mail
From: Marco <prenom_nomus@yahoo.com>
Newsgroups: comp.lang.ada
Subject: Re: Ada and Doxygen
Date: Thu, 25 Feb 2010 05:31:47 -0800 (PST)
Organization: http://groups.google.com
Message-ID: 
 <3fce72e0-ac88-4900-80bc-4a15ac607cfd@k18g2000prf.googlegroups.com>
References: <op.u8mib9tdvwnd5a@garhos>
 <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net>
	<op.u8mpsskzvwnd5a@garhos> <u7hq1y0e5.fsf@stephe-leake.org>
NNTP-Posting-Host: 71.33.73.74
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
X-Trace: posting.google.com 1267104708 13039 127.0.0.1 (25 Feb 2010 13:31:48
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Thu, 25 Feb 2010 13:31:48 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: k18g2000prf.googlegroups.com; posting-host=71.33.73.74;
	posting-account=WITAxQkAAAAHjnLda9Lofpqp8mERTWL4
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.9.2)
	Gecko/20100115 Firefox/3.6,gzip(gfe),gzip(gfe)
Xref: g2news1.google.com comp.lang.ada:9320
Date: 2010-02-25T05:31:47-08:00
List-Id: <comp.lang.ada>

On Feb 25, 5:18=A0am, Stephen Leake <stephen_le...@stephe-leake.org>
wrote:
> "Hibou57 (Yannick Duch=EAne)" <yannick_duch...@yahoo.fr> writes:

>
> "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.

  Yes for all but the most trivial applications (the term program is
too simplistic) some sort of external documentation is needed. Can
this some-how be tied to the code so a simple refactor of a package
name or public parameter would just be updated automatically?