typedef enum {
/* address mode         parameter representation    */
/* ------------         ------------------------    */
    XtAddress,          /* address                  */
    XtBaseOffset,       /* offset                   */
    XtImmediate,        /* constant                 */
    XtResourceString,   /* resource name string     */
    XtResourceQuark,    /* resource name quark      */
    XtWidgetBaseOffset, /* offset from ancestor     */
    XtProcedureArg,     /* procedure to invoke      */

    /* and here's one I added just for fun */
    XtVomit,            /* X11 is likely to induce this */
} XtAddressMode;

/* function documenting an enum that's hard to get along with */
void commentenum(XtAddressMode mode);


syntax highlighted by Code2HTML, v. 0.9.1