[prev in list] [next in list] [prev in thread] [next in thread] 

List:       doxygen-users
Subject:    Re: [Doxygen-users] Fwd: Function pointer declaration problem
From:       Dimitri van Heesch <dimitri () stack ! nl>
Date:       2005-07-20 12:27:36
Message-ID: 20050720122736.GB32710 () stack ! nl
[Download RAW message or body]

On Tue, Jul 19, 2005 at 08:31:25AM -0700, Ram Viswanadha wrote:
> Hi,
> If the function pointers are declared and commented as shown below,
> Doxygen gets confused and treats "void" as the name of the function.
> This results in wrong documentation being produced. Please see:
> http://icu.sourceforge.net/apiref/icu4c/ucnv_8h.html#a60
> 
> /**
>  * Function pointer for error callback in the codepage to unicode
> direction.
>  * Called when an error has occured in conversion to unicode, or on
> open/close of the callback (see reason).
> ...
>  * @see ucnv_setToUCallBack
>  * @see UConverterToUnicodeArgs
>  * @stable ICU 2.0
>  */
> typedef void (U_EXPORT2 *UConverterToUCallback) (
>                  const void* context,
>        ...
>                  UErrorCode *pErrorCode);
> 
> /**
>  * Function pointer for error callback in the unicode to codepage
> direction.
>  * Called when an error has occured in conversion from unicode, or on
> open/close of the callback (see reason).
> ...
>  * @see ucnv_setFromUCallBack
>  * @stable ICU 2.0
>  */
> typedef void (U_EXPORT2 *UConverterFromUCallback) (
>                    const void* context,
>        ...
>                    UErrorCode *pErrorCode);
> 
> Is there a work around for this problem? Should I submit a bug for this?

You need to program doxygen's C-preprocessor to remove the U_EXPORT2 stuff,
i.e. use these settings:

ENABLE_PREPROCESSING   = YES
MACRO_EXPANSION        = YES
EXPAND_ONLY_PREDEF     = YES
PREDEFINED             = U_EXPORT2=

Regards,
  Dimitri



-------------------------------------------------------
SF.Net email is sponsored by: Discover Easy Linux Migration Strategies
from IBM. Find simple to follow Roadmaps, straightforward articles,
informative Webcasts and more! Get everything you need to get up to
speed, fast. http://ads.osdn.com/?ad_id=7477&alloc_id=16492&op=click
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
[prev in list] [next in list] [prev in thread] [next in thread]