I'm using the doxygen 1.2.8.1 to document some C source.
I tried to attach detailed documentation to structure member outside of
the structure definition by using \var, but during compilation doxygen
complains:
/x.h:95-Warning: documented function `agent_entry_s name Name of the
agent s child The value is used for invoking the child' was not defined.
<and likewise for other \var s.>
The piece of code is attached here:
/** structure for keeping the information about agent's child */
struct agent_entry_s{
char name [MAX_AGENT_NAME]; /**< \brief agent's name */
char fifo[MAX_AGENT_FIFO]; /**< \brief agent's fifo */
char dir[MAX_AGENT_DIR]; /**< \brief agent's directory*/
};
/** \var agent_entry_s::name Name of the agent's child. The value is
used for invoking the child
*/
/** \var agent_entry_s::fifo Name of the agent's fifo. The agents child
uses this name to communicate with the agent.
*/
/** \var agent_entry_s::dir The directory where the child is executed
*/
How can i do this?
Thanks
Honza
|