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!news4.google.com!feeder2.cambriumusenet.nl!feed.tweaknews.nl!193.201.147.71.MISMATCH!xlned.com!feeder3.xlned.com!news2.euro.net!newsfeed.freenet.ag!newsfeed.kamp.net!newsfeed.kamp.net!gegeweb.org!aioe.org!not-for-mail From: =?iso-8859-15?Q?Hibou57_=28Yannick_Duch=EAne=29?= Newsgroups: comp.lang.ada Subject: Re: Ada and Doxygen Date: Fri, 26 Feb 2010 20:02:38 +0100 Organization: Ada At Home Message-ID: References: <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net> <45d5f4b8-8e8e-43ef-94df-0558262cd978@g11g2000yqe.googlegroups.com> NNTP-Posting-Host: 1p0/iiA1XsOM93crjB9V+Q.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-15; format=flowed; delsp=yes Content-Transfer-Encoding: Quoted-Printable X-Complaints-To: abuse@aioe.org X-Notice: Filtered by postfilter v. 0.8.2 User-Agent: Opera Mail/10.10 (Win32) Xref: g2news1.google.com comp.lang.ada:9334 Date: 2010-02-26T20:02:38+01:00 List-Id: Le Fri, 26 Feb 2010 19:43:03 +0100, Vadim Godunko a= = =E9crit: > I found Qt's documentation excellent. It is generated by the tool, see= > tools/qdoc3 in source code package. Is there a way to see that without installing Qt libraries ? I had a qui= ck = look to read it on the web but found nothing. Do you know a link ? > 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, Side note : do you know the Ada rationale about it is that Ada have = package scope instead of class scope ? ;) > existing "good practice". For example, all parts of documentation is > in the .cpp files in Qt, which makes .h files clean; I guess I will not be able to understand before I ever have a chance to = = read this docs. However, just right now, I'm a bit surprised to read = something about mixing .cpp, which is implementation part, with .h, whic= h = is specification part, from a user point of view. Or may be you're one o= f = the Qt implementors ? > 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 :-( Are you talking about merging all definitions provided in multiple packa= ge = on a single page ? I'm not sure I've understood. Is that it ? -- = No-no, this isn't an oops ...or I hope (TM) - Don't blame me... I'm just= = not lucky