Re: Ada and Doxygen

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

Le Thu, 25 Feb 2010 13:18:10 +0100, Stephen Leake  
<stephen_leake@stephe-leake.org> a écrit:
> "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 after  
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 also  
vary from people to people (and also note Doxygen was not created with Ada  
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 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. 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). 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)

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), 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 different  
purposes.

-- 
No-no, this isn't an oops ...or I hope (TM) - Don't blame me... I'm just  
not lucky