PrevKDE DocBook ReferenceNext

The synopsis elements

<cmdsynopsis>

Example A.10. How to markup a command synopsis


<cmdsynopsis>
<command>more</command>
<group choice="opt"><option>-d</option>
<option>l</option><option>f</option>
<option>p</option><option>c</option>
<option>s</option><option>u</option>
</group>
<arg>-num</arg>
<arg>+/ pattern</arg>
<arg>+ linenum</arg>
<arg rep="repeat"><replaceable>file</replaceable></arg>
</cmdsynopsis>

This should generate:

more [-dlfpcsu] [-num] [+/ pattern] [+ linenum] [file...]

There are several very nice examples in the Duck book at www.docbook.org


<funcsynopsis>

Example A.11. How to markup a function synopsis


<funcsynopsis>
<funcprototype>
<funcdef>void <function>setFile</function></funcdef>
<paramdef>QString <parameter>file</parameter></paramdef>
</funcprototype>
</funcsynopsis>

<funcsynopsis>
<funcprototype>
<funcdef>void <function>setAutoResize</function></funcdef>
<paramdef>bool <parameter><replaceable>val</replaceable></parameter></paramdef>
</funcprototype>
</funcsynopsis>

<funcsynopsis>
<funcprototype>
<funcdef>QString <function>getVideoCodec</function></funcdef><void/>
</funcprototype>
</funcsynopsis>

These would generate the following, respectively.

void setFile(file); 
QString file;
 
void setAutoResize(val); 
bool val;
 
QString getVideoCodec(); 
 

A function synopsis can contain the following:

<funcprototype>

Contains a prototype of the function. It can contain <void>, <varargs>, <paramdef> or most commonly, a <funcdef> which actually defines the function.

<funcdef>

A function and its return type.

<funcparams>

Contains the list of parameters for the function.

<paramdef>

Information about the parameters of a function.

<void>

An empty element in a function indicating there are no arguments.

<varargs>

An empty element in a function indicating there are multiple arguments, without specifically listing them. This is generally represented with an ellipsis (...). For example int max(...);

<funcsynopsisinfo>

Not used in KDE documentation.

<arg>

Used inside <cmdsynopsis>. Since most KDE applications are GUI only, you will not see this very often. See the entry for <cmdsynopsis> for a full explanation and example.

<group>

Group

<sbr>

sbr

<synopfragment>

synopfragment

<modifier>

A modifier modifies a class, field, or method synopsis. Examples are the words “public”, “private” or “virtual”

<fieldsynopsis>

A field synopsis.