Etiquetas DocBook útiles
Aquí están varias etiquetas de DocBook muy útiles al documentar código.
Para enlazar otra sección en GTK docs:
<link linkend="glib-Hash-Tables">Hash Tables</link>
Para referirse a una función externa, ej. una función de C estándar:
<function>...</function>
Para incluir un código de ejemplo:
<example> <title>Using a GHashTable.</title> <programlisting> ... </programlisting> </example>
<informalexample> <programlisting> ... </programlisting> </informalexample>
Para incluir listas de topos:
<itemizedlist> <listitem> <para> ... </para> </listitem> <listitem> <para> ... </para> </listitem> </itemizedlist>
Para incluir una nota que sobresale del texto:
<note> <para> Make sure you free the data after use. </para> </note>
Para referirse a un tipo:
<type>unsigned char</type>
Para referirse a una estructura externa (no una descrita en la documentación de GTK):
<structname>XFontStruct</structname>
Para referirse a un campo o a una estructura:
<structfield>len</structfield>
Para referirse a un nombre de clase, se podría usar:
<classname>GtkWidget</classname>
Para enfatizar un texto:
<emphasis>This is important</emphasis>
Para uso de nombres de archivo:
<filename>/home/user/documents</filename>
Para referirse a claves:
<keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>