Re: [docbook] Function prototype comments

From
Thomas Schraitle <>
Date
2005-10-16T16:03:26+00:00
ID
Thread
Re: [docbook] Function prototype comments
On Sunday 16 October 2005 17:47, Russell Shaw wrote:
> [...]
>
> How evolving is the docbook standard? Could new things be added like:
>
> <funcprototype>
>    <paramdef>char *<parameter>a</parameter>[]</paramdef>/* comment */
>    <paramdef>char *<parameter>a</parameter>[]</paramdef><para>/* para
> comment */</para> </funcprototype>

According to [1] the content modell doesn't allow this:

funcprototype ::=
(modifier*,funcdef,
 (void|varargs|
  (paramdef+,varargs?)),
 modifier*)


However, if you use DocBook NG you could use the attribute annotations in 
paramdef to insert your comment. But you need probably customize the 
stylesheets.

Tom


------------
[1] http://www.docbook.org/tdg/en/html/funcprototype.html

-- 
Thomas Schraitle