This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
RFE #582822: VARARG and FUNCDEF together
- From: Norman Walsh <ndw at nwalsh dot com>
- To: docbook at lists dot oasis-open dot org
- Date: Tue, 17 Sep 2002 12:46:51 -0400
- Subject: DOCBOOK: RFE #582822: VARARG and FUNCDEF together
This RFE points out that:
Currently <FUNCPROTOTYPE> does not allow both <PARAMDEF> and
<VARARG> in the same instance. This limitation is documented in
DocBook TDG in <FUNSYNOPSIS>. This makes it quite awkward to markup
certain types of C function calls.
The current definition of funcprototype
funcprototype ::=
(funcdef,
(void|varargs|paramdef+))
is an historical legacy (bound up in the way C compilers worked a
decade ago) more than a designed constraint.
The TC proposes to solve RFE #582822 by changing the funcprototype
in the following backwards-compatible way:
funcprototype ::=
(funcdef,
(void|(paramdef*, varargs?)))
Comments?
Be seeing you,
norm
--
Norman Walsh <ndw@nwalsh.com> | Mankind are always happy for
http://www.oasis-open.org/docbook/ | having been happy; so that if you
Chair, DocBook Technical Committee | make them happy now, you make them
| happy twenty years hence by the
| memory of it.--Sydney Smith