Re: Ada and Doxygen

["Hibou57 (Yannick Duchêne)" <yannick_duchene@yahoo.fr>]

Le Fri, 26 Feb 2010 09:49:12 +0100, Stephen Leake  
<stephen_leake@stephe-leake.org> a écrit:
> 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 may  
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 “ tutorial ” ? (just want to know, 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 browsing  
more or less randomly is not the same as traveling along a path which was  
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