Re: Help with Doxygen and C structs



On Mon, 23 Jul 2007 21:32:01 -0700
"J. Bourne" <none@xxxxxxxx> wrote:

Hello,

I'm trying to use Doxygen to document the source of a project I'm
working on in C. The problem I'm having is correctly documenting
self-referential structs. For instance, we have a struct like the
following:

typedef struct _User {
/* ... stuff ... */
struct _User *next_user;
} User;

When documenting the struct and its variables, Doxygen calls the
structure "_User" in the output, instead of the prefered "User".
Is there a way to force Doxygen to identify the struct as "User"
instead of "_User"?


[snip]

Well, it occurred to me: why not replace "typedef struct _User" with
"typedef struct User", and change the variable to type "struct
User"? Well, sure enough, that fixed my problem.

Thanks anyway,
JB
.



Relevant Pages

  • Re: [patch 6/13] signal/timer/event fds v8 - timerfd core ...
    ... no. Gain is not worth the plug into the structure design IMO. ... payoff in putting work into documenting the struct, its fields, the ... relationship between this struct and other structs, ... the patch description describes the API ...
    (Linux-Kernel)
  • Help with Doxygen and C structs
    ... The problem I'm having is correctly documenting ... self-referential structs. ... we have a struct like the ... When documenting the struct and its variables, ...
    (comp.programming)
  • Re: [patch] Re: newer version of HTC Dream support
    ... new file mode 100644 ... without even the implied warranty of ... +struct rpcsvr_platform_device ...
    (Linux-Kernel)
  • Re: [PATCH 1/4] staging: cpc-usb: convert comment style in cpc.h
    ... -// representation of the CAN parameters for the PCA82C200 controller ... typedef struct CPC_PCA82C200_PARAMS { ... -// In general two types of overrun may occur. ...
    (Linux-Kernel)
  • Re: Variable array sizes as members ?
    ... space for an object of type struct tag_lb. ... Sorry Barry, excuse my ignorance, but its the first time I see malloc being ... Barry and Scott have talked about making my array member a pointer so it can ... typedef struct tag_list60 ...
    (microsoft.public.vc.language)