Re: [docbook] Encoding programming statements

[Michael Smith <smith at xml-doc dot org>]

BigSmoke <bigsmoke@home.nl> writes:

> Hi,
> 
> What is 'the right way' to encode a programming statement. For example:
> 
> <para>
>   Both the <unknown>return</unknown> and <unknown>if</unknown>
>   statement are impossible to mark-up properly if you can't find suitable
>   elements in the TDG.
> </para>

I guess there is currently no 'right' element in DocBook specifically
for marking up programming statements. If you reckon that to be a
deficiency, please file an RFE. In the mean time, maybe you could do:

  <para>
    Both the <literal role='programmingStatement'>return</literal> and
    <literal role='programmingStatement'>if</unknown> statements are
    impossible to mark-up properly if you can't find suitable elements
    in the TDG.
  </para>

Though for 'return' it seems like <function>return</function> would do.

Attachment: pgp00000.pgp
Description: PGP signature