[Doxygen-users] structures with attributes

[Thomas N. <nem...@gm...>]

    Hi.

    I'm documenting some structures that looks like this :

/*! Dataset for status data. */
typedef struct __attribute__ ((__packed__)) {
        UINT16 outputs; /*!< Board outputs. */
        UINT32 inputs;  /*!< Board inputs. */
        UINT16 status;  /*!< Board status. */
        UINT16 errors;  /*!< Internal errors (bits field). */
} dataset_status;

    And here is the error message from doxygen :

pdtask.c:65: warning: Member dataset_status (variable) of group iptstr is
not documented.
[...]
pdtask.c:74: warning: return type of member __attribute__ is not documented

    How could I document such a structure so that not only there is
    no error message from doxygen, but also so that the produced
    documentation is correct.

    Actually that produces something like, for the file in question :

[...]
Functions
   struct __attribute__ ((__packed__))
[...other functions...]

    I could have a named structure, however no only I prefer the
    compactness of this kind of defintion, but also, I'm not sure
    it wouldn't produce the same result...


T.

-- 
| A: Yes.
| >Q: Are you sure?
| >>A: Because it reverses the logical flow of conversation.
| >>>Q: Why is top posting frowned upon?