doxygen-users

[Scot W. <sc...@wi...>]

It would be nice to use brief compound members in C programs, but there is no 
in-member brief format starting with the C comment indicator "/*" which fits on 
one line.  The /**< creates a "Detailed" description even for one-liners.

#define   LOCAL_BUFFER_SIZE 4096 /**< HTML has link to one-line detail */
int myfunction(
    char *password,        /**< This is a detailed description */
    char *errormessage     /**< One-liner looks odd in docs. */
) ( ... }

I haven't examined the parser.  Maybe it could handle /**<< for a Brief 
Description?