[Doxygen-users] typedef problem

[Rob D. <rd...@ce...>]

I am having problems with the HTML output generated from the code below.
Using doxygen-1.2.10 on WIN2000 the first typedef (allocFunc) comes out ok
but the second typedef(freeFunc) is mistakenly documented as a function.
If I remove CALLCONV from the typedefs then the output is ok.

This is a simplified example where CALLCONV is always __cdecl but in my real
project
CALLCONV will vary depending on the platform.



/** @file file.h */

/** @def CALLCONV __cdecl
*/
#define CALLCONV __cdecl

/**  @typedef void* (CALLCONV *allocFunc )( int size, void * const memRef );

   Prototype for the callback function which allocates memory.

Notes:

@param size    [Input]  Number of bytes to allocate.
@param memRef  [Input]  User reference parameter.

@return pointer to allocated memory

*/
typedef  void* (CALLCONV *allocFunc )(
    int size,
    void * const memRef
    );

/**  @typedef void* ( CALLCONV *freeFunc )( void *block, void * const memRef );

   Prototype for the callback function which frees memory.

Notes:

@param block   [Input/Output]  Block to free.
@param memRef  [Input]  User reference parameter.

@return nothing

*/
typedef  void (CALLCONV *freeFunc )(
    void *block,
    void * const memRef
    );

/** @struct MemCallbacks
 * Structure for memory callbacks
 */
struct MemCallbacks
{

    /** memory allocation callback */
    allocFunc malloc;

    /** memory de-allocation callback */
    freeFunc free;

    /** reference for memory callbacks */
    void * memRef;
} MemCallbacks;

/** @typedef struct MemCallbacks MemCallbacks
 * Structure for application callbacks
 */
typedef struct MemCallbacks MemCallbacks;