Re: Thoughts on doxygen for internal documentation

[Daniel Egger <degger at fhm dot edu>]

Am Fre, 2003-01-17 um 06.26 schrieb Tony Finch:

> The advantage of doxygen's comment format is that it's based
> on other standards like JavaDoc and Qt. I don't know how well
> it maintains compatibility with them.

I rather dislike JavaDoc. For me it's incomprehensible because 
the interesting information is drown in a sea of declarations
which simply shouldn't matter and if they do, the source itself
is a much better reference (if it isn't it's definitely time
to refactor the code). In short: The concept is sound but the
implementation sucks.

However if it helps others it'd be definitely to support it,
especially if all one has to do is add a single unintrusive 
character per commentblock.

The issue seems to be solved differently however if I read Diegos
mail correctly....

--
Servus,
       Daniel

Attachment: signature.asc
Description: Dies ist ein digital signierter Nachrichtenteil