Re: Ada and Doxygen

[Vadim Godunko <vgodunko@gmail.com>]

On Feb 26, 11:49 am, Stephen Leake <stephen_le...@stephe-leake.org>
wrote:
>
> 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.
>
I found Qt's documentation excellent. It is generated by the tool, see
tools/qdoc3 in source code package. 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,
existing "good practice". For example, all parts of documentation is
in the .cpp files in Qt, which makes .h files clean; 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 :-(