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!news3.google.com!feeder.news-service.com!newsfeed.straub-nv.de!news.mixmin.net!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: Thu, 25 Feb 2010 15:56:55 +0100 Organization: At Home Message-ID: References: <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net> NNTP-Posting-Host: LgmlzkxO8f1oyw4OqQt/kw.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:9322 Date: 2010-02-25T15:56:55+01:00 List-Id: Le Thu, 25 Feb 2010 13:18:10 +0100, Stephen Leake = a =E9crit: > "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. > Seems you are reading in my mind : that's what LP (Literate Programming)= = is for ;) (TBH, I'm thinking about something different, while still afte= r = that, let say that LP is a convenient picture for me). Note : I was not to advertise for Doxygen, I was just prospecting about = = possible requests for it, because I first though about it as a possible = = solution for something else, and on the way, found peoples who were = complaining there is no support for Ada in Doxygen. I understand this al= so = vary from people to people (and also note Doxygen was not created with A= da = in mind anyway and it's probably far to be its first target). > Browsing is better for Ada in GPS or Emacs Ada mode; you can get to > _all_ of the source, not just what the Doxygen viewer has access to. If I may have a comment about a "detail" : while GPS provides some way t= o = travel across sources, this does not compare to a browsable set of = document which are browsable by nature (is it the good word for the fren= ch = "par essence" ?) and where links are managed and edited as part of the = content, just like words and sentences are. If the content of a document= = and its interpretation depends on the application you use to view it, th= en = this is no more a document (I mean, links are not really part of this = "document" and don't takes part of it). And indeed, it depends (after yo= ur = 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) Further more, this kind of browsing does not allow pre-designed navigati= on = paths (this is mainly random browsing -- random here, has the same meani= ng = as with random file access), still because browsing in not a first = property of sources, and this will never be, because this does not have = to = be, just because documents and sources are different things with differe= nt = purposes. -- = No-no, this isn't an oops ...or I hope (TM) - Don't blame me... I'm just= = not lucky