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=-0.9 required=5.0 tests=BAYES_00,FORGED_GMAIL_RCVD,
	FREEMAIL_FROM autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII
Path: 
 g2news1.google.com!postnews.google.com!g11g2000yqe.googlegroups.com!not-for-mail
From: Vadim Godunko <vgodunko@gmail.com>
Newsgroups: comp.lang.ada
Subject: Re: Ada and Doxygen
Date: Fri, 26 Feb 2010 10:43:03 -0800 (PST)
Organization: http://groups.google.com
Message-ID: 
 <45d5f4b8-8e8e-43ef-94df-0558262cd978@g11g2000yqe.googlegroups.com>
References: <op.u8mib9tdvwnd5a@garhos>
 <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net>
	<op.u8mpsskzvwnd5a@garhos> <u7hq1y0e5.fsf@stephe-leake.org>
	<op.u8oug5xjvwnd5a@garhos> <umxywwfef.fsf@stephe-leake.org>
NNTP-Posting-Host: 87.117.14.103
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
X-Trace: posting.google.com 1267209783 31561 127.0.0.1 (26 Feb 2010 18:43:03
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Fri, 26 Feb 2010 18:43:03 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: g11g2000yqe.googlegroups.com; posting-host=87.117.14.103;
	posting-account=niG3UgoAAAD7iQ3takWjEn_gw6D9X3ww
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8)
	Gecko/20100204 SUSE/3.5.8-0.1.1 Firefox/3.5.8,gzip(gfe),gzip(gfe)
Xref: g2news1.google.com comp.lang.ada:9332
Date: 2010-02-26T10:43:03-08:00
List-Id: <comp.lang.ada>

On Feb 26, 11:49=A0am, Stephen Leake <stephen_le...@stephe-leake.org>
wrote:
>
> Actually, I have one item; an easy way to see the inherited operations
> of a type. For example, the Qt manuals show that. I have no idea
> whether the Qt manuals are produced by a tool.
>
I found Qt's documentation excellent. It is generated by the tool, see
tools/qdoc3 in source code package. It would be nice to have such tool
for Ada, but it is not as simple to do as it seems for the first look.
Some reason are complexity of Ada language, absence of "class" scope,
existing "good practice". For example, all parts of documentation is
in the .cpp files in Qt, which makes .h files clean; opposite is
GNAT's style where all comments are around of entities in
specifications, which makes it simple to process but also makes
impossible to see all amount of package's entities on one page :-( The
sadly news is ARG seems to approve GNAT's style for future versions of
RM :-(