Re: Ada and Doxygen

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

Le Fri, 26 Feb 2010 19:43:03 +0100, Vadim Godunko <vgodunko@gmail.com> a  
écrit:
> I found Qt's documentation excellent. It is generated by the tool, see
> tools/qdoc3 in source code package.
Is there a way to see that without installing Qt libraries ? I had a quick  
look to read it on the web but found nothing.
Do you know a link ?

> It would be nice to have such tool
> for Ada, but it is not as simple to do as it seems for the first look.

> Some reason are complexity of Ada language, absence of "class" scope,
Side note : do you know the Ada rationale about it is that Ada have  
package scope instead of class scope ? ;)

> existing "good practice". For example, all parts of documentation is
> in the .cpp files in Qt, which makes .h files clean;
I guess I will not be able to understand before I ever have a chance to  
read this docs. However, just right now, I'm a bit surprised to read  
something about mixing .cpp, which is implementation part, with .h, which  
is specification part, from a user point of view. Or may be you're one of  
the Qt implementors ?

> opposite is
> GNAT's style where all comments are around of entities in
> specifications, which makes it simple to process but also makes
> impossible to see all amount of package's entities on one page :-( The
> sadly news is ARG seems to approve GNAT's style for future versions of
> RM :-(
Are you talking about merging all definitions provided in multiple package  
on a single page ? I'm not sure I've understood. Is that it ?

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