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: a07f3367d7,9124c8b7efcea462 X-Google-Attributes: gida07f3367d7,public,usenet X-Google-NewGroupId: yes X-Google-Language: ENGLISH,UTF8 Path: g2news1.google.com!news1.google.com!npeer01.iad.highwinds-media.com!news.highwinds-media.com!feed-me.highwinds-media.com!post02.iad.highwinds-media.com!news.flashnewsgroups.com-b7.4zTQh5tI3A!not-for-mail Newsgroups: comp.lang.ada Subject: Re: Ada and Doxygen References: <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net> From: Stephen Leake Date: Fri, 26 Feb 2010 03:49:12 -0500 Message-ID: User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.2 (windows-nt) Cancel-Lock: sha1:TOsUhyZnbWonY65O3VBeqSq16yU= MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Complaints-To: abuse@flashnewsgroups.com Organization: FlashNewsgroups.com X-Trace: 5f2ab4b878b06e197caa731076 Xref: g2news1.google.com comp.lang.ada:9327 Date: 2010-02-26T03:49:12-05:00 List-Id: "Hibou57 (Yannick Duchêne)" writes: > a écrit: > >> 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 > to 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 > french "par essence" ?) and where links are managed and edited as > part of the content, just like words and sentences are. 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. > If the content of a document and its interpretation depends on the > application you use to view it, then this is no more a document (I > mean, links are not really part of this "document" and don't takes > part of it). 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. > 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. > 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. > still because browsing in not a first property of sources, "Browsing" is heavily overloaded. A "source code browser" uses only information in the sources to generate the browsing links; in that case, I think it is fair to say "source code browsing information is a first property of sources". Of course, Ada provides much better browsing information than C or Assembler. > and this will never be, because this does not have to be, just > because documents and sources are different things with different > purposes. What is the list of requirements for this hypothetical browsing tool you want to use? -- -- Stephe