Macro generation help

[Jim Kingdon]

> Are there any macro experts in the group?  I don't know if it's possible
> for macros to generate comments

You are out of luck.  Comments are stripped in translation phase 3,
and macros are not expanded until translation phase 4.  See
http://ou800doc.caldera.com/SDK_cprog/_ANSI_C_Translation_Phases.html

I think you can probably put something like the following in the .def
file:

/** @var acpmax
 * Maximum acp that can be accumulated from turn to turn
 */
DEF_UPROP_I("acp-max", u_acp_max,
		       "maximum acp that can be accumulated from turn
		       to turn",
		       acpmax, -1, -1, PROPHI)

But I don't know if there is a way to avoid duplicating the doc, short
of writing some kind of custom tool (which is hardly the ideal
solution from a variety of viewpoints).