DOCBOOK: Code markup.

["Dave Pawson" <dave dot pawson at virgin dot net>]

In one of the documents I'm doing, I have 'descriptions'
of whats happening.
E.g.
 <p><tt>Bool xf86GetFlipPixels()</tt></p>
       <p>Returns <tt>TRUE</tt> if <tt>-flippixels</tt> is
      present on the command line, and <tt>FALSE</tt> otherwise.</p>
   <p><tt>const char *xf86GetServerName()</tt></p>
       <p>Returns the name of the X server from the command line.</p>

This is marked up ~according to the linuxdoc DTD :-)

I've no intention of working on it in this DTD,
but when I get it across to docbook (x)
I'd like to know how it should be marked up.

funcdef ok for the function names,
funcparams for -flippixels is my initial guess, I'd like it
confirming please.
I have the distinct feeling that they are related to function
definitions rather than descriptions since they are part of funcsynopsis
, or am I being too pedantic?

Any assistance appreciated.