Re: [avr-libc-dev] [RFC] setjmp.h dox

[Joerg Wunsch]

As Theodore A. Roth wrote:

> Fair enough. Looking through /usr/include/stdlib.h I see this:
> 
>   /* Convert a string to an integer.  */
>   extern int atoi (__const char *__nptr) __THROW __attribute_pure__;
> 
> while the man page uses:
> 
>   int atoi(const char *nptr);

Yep, while working on documenting that file, i already started to
convert all of them...

> Well, here one way to work around it (althought it's _very_ sub-optimal):
> 
>   #if defined(DOXYGEN)
>   extern int setjmp(jmp_buf jmpb);
>   #else
>   extern int setjmp(jmp_buf __jmpb);

In that case, you can even write "extern int setjmp(jmp_buf);" and are
done.

But i agree that this sucks.

Perhaps i'll look into doxygen to add a feature where one could
make \fn work in that case to supply an alternate form of the
synopsis just for the documentation.

-- 
J"org Wunsch                                           Unix support engineer
address@hidden        http://www.interface-systems.de/~j/