[Doxygen-develop] Re: [Doxygen-users] Making an Easy and fast readable C Library Manual reference.(TODO-Suggestions)

[Dean P. <po...@ds...>]

<snip>

Let me add a big ditto to most of this.  Doxygen is great, but I find it =

is almost, but not quite there for documenting C code.

>2) * hide Macro definitions body. ( and document them like functions )

You can hide macro body with @hideinitializer.  It would be good to be ab=
le to add =

information about the type of macro parameters and expected returns where=
 =

relevant.  Also it would be nice to be able to abstract the fact that a =

macro is a macro and not a function, as sometimes you want to switch =

between functions and macros.

I also tend to want to give the full definition of a struct when =

documenting it instead of the current approach that just lists out the =

members.

I also really want to be able to generate a single HTML/man page per func=
tion =

with a big alphabetic index.  Haven't been able to find a good way to do =

this.
-- =

Dean Povey,              |em: dp...@we...|  JCSI: Java security =
toolkit
Senior S/W Developer     |ph:  +61 7 3864 5120    | uPKI: Embedded/C PKI =
toolkit
Wedgetail Communications |fax: +61 7 3864 1282    |       uASN.1: ASN.1 C=
ompiler
Brisbane, Australia      |www: www.wedgetail.com  | XML Security: XML Sig=
natures =