[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [help-gengetopt] [feature request] Doxygen comments for parser files

From: Andre Noll
Subject: Re: [help-gengetopt] [feature request] Doxygen comments for parser files
Date: Wed, 20 Jun 2007 14:59:50 +0200
User-agent: Mutt/1.5.9i

On 14:31, Lorenzo Bettini wrote:

> so you wouldn't comment static functions, right?

Yes, I don't use doxygen comments for static functions. If something
in a static function needs commenting, I use the "usual" comments
instead, these are ignored by doxygen. But of course that's only my
personal taste.

OTOH, there's also the EXTRACT_STATIC option of doxygen that skips
static functions entirely when set to "NO", so they don't show up
anywhere, documented or not.

> and for the main parser functions, would it be better to be commented on 
> the .h file or in the .c file?

AFAIK doxygen doesn't care. I prefer the .c file because I can look at
the code while writing the documentation. That's probably irrelevant
for automatically generated comments though ;)

> Moreover, the few times I used doxygen, I used to use the @param and 
> @return (as in javadoc), while from the sources on paraslash it looks 
> like \param and \return should be used?

Both variants are possible, there's no difference in functionality.

Doxygen is well documented, btw:

The only person who always got his work done by Friday was Robinson Crusoe

Attachment: signature.asc
Description: Digital signature

reply via email to

[Prev in Thread] Current Thread [Next in Thread]