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,887292c91e10d3fd
X-Google-NewGroupId: yes
X-Google-Attributes: gida07f3367d7,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news2.google.com!postnews.google.com!35g2000prb.googlegroups.com!not-for-mail
From: AdaMagica <christoph.grein@eurocopter.com>
Newsgroups: comp.lang.ada
Subject: Re: Ada documentation tools.
Date: Mon, 15 Nov 2010 00:14:39 -0800 (PST)
Organization: http://groups.google.com
Message-ID: <c2c16ca4-9833-4947-a549-6de773ef78dc@35g2000prb.googlegroups.com>
References: <s5adnQTW9suR_33RRVn_vwA@giganews.com>
NNTP-Posting-Host: 80.156.44.178
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
X-Trace: posting.google.com 1289808879 26737 127.0.0.1 (15 Nov 2010 08:14:39
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Mon, 15 Nov 2010 08:14:39 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: 35g2000prb.googlegroups.com; posting-host=80.156.44.178;
 posting-account=rmHyLAoAAADSQmMWJF0a_815Fdd96RDf
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 5.2; de; rv:1.9.0.4)
 Gecko/2008102920 Firefox/3.0.4,gzip(gfe)
Xref: g2news2.google.com comp.lang.ada:16468
Date: 2010-11-15T00:14:39-08:00
List-Id: <comp.lang.ada>

Hm, I'm perhaps going to stir up a hornets' nest.

I really cannot understand why anyone would like something like
JavaDoc for Ada code. Java lacks separation of spec and body, thus
JavaDoc is a kludge.

The Ada spec, if written properly, is already the documentation - and
if it isn't, such a tool cannot cure the situation.

I've read (not such a lot) of Ada code documented in this style and
always found that I prefer the Ada spec directly.

So what do you expect from such a tool that the Ada spec does not yet
provide?