Re: Doxygen messes up with PRINTF_ATTRIBUTES macro

Hi Andreas,

On 7 mei 2010, at 10:32, Andreas Schneider wrote:

> Hi,
>
> I've created API documentation for talloc.samba.org. Doxygen has a  
> problem
> correctly creating documentation for a function which has a printf  
> attribute
> checking at the end using a macro.
>
> #define PRINTF_ATTRIBUTE(a1, a2) __attribute__ ((format (__printf__,  
> a1, a2)))
> #else
> #define PRINTF_ATTRIBUTE(a1, a2)
> #endif
> #endif
>
> void *talloc_init(const char *fmt, ...) PRINTF_ATTRIBUTE(1,2);
>
> It adds the return value of this function to the output of the next.
>
> void * 	talloc_init (const char *fmt,...) PRINTF_ATTRIBUTE(1
> 	Create a new top level talloc context.
>
> void *int 	talloc_free (void *ptr)
> 	Free a chunk of talloc memory.
>
>
> See http://talloc.samba.org/talloc/doc/html/group__talloc.html
>
> I can work around the problem using #ifdef DOXYGEN but I think it  
> should be
> fixed in doxygen.

You can configure doxygen's preprocessor such that no #ifdef's are  
needed to
parse the code properly.

Regards,
   Dimitri


------------------------------------------------------------------------------