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-Language: ENGLISH,UTF8 X-FeedAbuse: http://nntpfeed.proxad.net/abuse.pl feeded by 88.191.16.109 Path: g2news1.google.com!news4.google.com!feeder1-2.proxad.net!proxad.net!feeder1-1.proxad.net!nntpfeed.proxad.net!nospam.fr.eu.org!usenet-fr.net!gegeweb.org!aioe.org!not-for-mail From: =?utf-8?Q?Hibou57_=28Yannick_Duch=C3=AAne?= =?utf-8?Q?=29?= Newsgroups: comp.lang.ada Subject: Re: Ada and Doxygen Date: Fri, 26 Feb 2010 19:42:08 +0100 Organization: Ada At Home Message-ID: References: <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net> NNTP-Posting-Host: 1p0/iiA1XsOM93crjB9V+Q.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; 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:9331 Date: 2010-02-26T19:42:08+01:00 List-Id: Le Fri, 26 Feb 2010 09:49:12 +0100, Stephen Leake = a =C3=A9crit: > I don't agree. > > What, exactly, is missing in Emacs Ada mode? > > 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. > > If I were to use a tool to produce separate documentation for Ada > source code, I'd start with AdaBrowse > (http://home.datacomm.ch/t_wolf/tw/ada95/adabrowse/); it uses ASIS, so= > it starts with all the information the compiler has. This is kind of dump, that's not what I was talking about (I know = AdaBrowse ...and there are others I forget the name BTW). > For a general "document", I agree. For Ada source code, a tool that > specifically understands the Ada syntax is better; that's what GPS and= > Emacs Ada mode are - they use the cross index information output by > the GNAT Ada compiler. Any way, this is the same principle (same comment as the latter). >> And indeed, it depends (after your example) on GPS or Emacs mode >> (this is inferred from the document, just like would be a list of >> words or an automatic index, which may not be meaningful.... because >> automatic) > > I don't understand your point here. Let me help you to guess with a question : do you use debuggers ? (you m= ay = answer "yes" or "no" and add any comment which comes in your mind about = it) >> Further more, this kind of browsing does not allow pre-designed >> navigation paths (this is mainly random browsing -- random here, has= >> the same meaning as with random file access), > > Well, yes. > > If you want to write a tutorial, that's a separate document, not > source code. That's closer. Why did you use the word =E2=80=9C tutorial =E2=80=9D ? (just want to kn= ow, as this choice = may be potentially relevant) > What is the list of requirements for this hypothetical browsing tool > you want to use? Browsing is not the main purpose. The purpose is at understanding, and = browsing is just a required thing for that. I was trying to tell browsin= g = more or less randomly is not the same as traveling along a path which wa= s = provided on purpose with something in mind. -- = No-no, this isn't an oops ...or I hope (TM) - Don't blame me... I'm just= = not lucky