OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: Re: DOCBOOK: Code markup.


/ "Dave Pawson" <dave.pawson@virgin.net> was heard to say:
[...]
|  <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>
[...]
| 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?

Without more context, I have to admit I'm a little confused. For the
functiony parts, I'd say:

<funcdef>Bool <function>xf86GetFlipPixels</function></funcdef>

But from the description of -flippixels, I think it should be a simple
parameter or option, not a funcparam since it's not a parameter to a
function.

Does that help?

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | If a little knowledge is
http://www.oasis-open.org/docbook/ | dangerous, where is the man who
Chair, DocBook Technical Committee | has so much as to be out of
                                   | danger?--T. H. Huxley


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC