Re: [Doxygen-users] one document paragraph for N types set by typedef struct?

[mathog <ma...@ca...>]

On 25-Nov-2013 12:54, mathog wrote:
Note that when

   DISTRIBUTE_GROUP_DOC = yes

and

/**
     Draw figure
*/
typedef struct foobar {
      U_EMR               emr;                //!< U_EMR
      U_RECTL             rclBounds;          //!< bounding rectangle in
device units
      U_NUM_POINTL        cptl;               //!< Number of points to 
draw
      U_POINTL            aptl[1];            //!< array of points
} U_EMRPOLYBEZIER,
    U_EMRPOLYGON,
    U_EMRPOLYLINE,
    U_EMRPOLYBEZIERTO,
    U_EMRPOLYLINETO;

Doxygen creates this:

typedef struct U_EMRPOLYBEZIER 	U_EMRPOLYGON
typedef struct U_EMRPOLYBEZIER 	U_EMRPOLYLINE
typedef struct U_EMRPOLYBEZIER 	U_EMRPOLYBEZIERTO
typedef struct U_EMRPOLYBEZIER 	U_EMRPOLYLINETO
                 ^ link           ^ plain text

and this

struct  	U_EMRPOLYBEZIER
                  ^ link

which is all fine, but also this:

                  link (back to this location in the file)
#define 	U_EMR_POLYBEZIER   2
  	U_EMRPOLYBEZIER record.
         ^ link to the struct
                 v link (back to this location in the file)
#define 	U_EMR_POLYGON   3
  	U_EMRPOLYGON record.
         ^ text

So Doxygen is seeing the other names for that typedef struct, but it is 
only stuffing the first into some list that it refers to later, 
resulting in the "text" entries that would otherwise be links.

Thanks,

David Mathog
ma...@ca...
Manager, Sequence Analysis Facility, Biology Division, Caltech