Frequently asked questions
Vprašanje: No class hierarchy.
Odgovor: The objects xxx_get_type() function has not been entered into the <package>.types file.
Vprašanje: Still no class hierarchy.
Odgovor: Missing or wrong naming in <package>-sections.txt file (see pojasnilo).
Vprašanje: Damn, I have still no class hierarchy.
Odgovor: Is the object name (name of the instance struct, e.g. Gradnik Gtk) part of the normal section (don't put this into Standard or Private subsections).
Vprašanje: No symbol index.
Odgovor: Does the <package>-docs.{xml,sgml} contain a index that xi:includes the generated index?
Vprašanje: Symbols are not linked to their doc-section.
Odgovor: Is the doc-comment using the correct markup (added #,% or ())? Check if the gtkdoc-fixxref warns about unresolvable xrefs.
Vprašanje: A new class does not appear in the docs.
Odgovor: Is the new page xi:included from <package>-docs.{xml,sgml}.
Vprašanje: A new symbol does not appear in the docs.
Odgovor: Is the doc-comment properly formatted. Check for spelling mistakes in the begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable xrefs. Check if the symbol is correctly listed in the <package>-sections.txt in a public subsection.
Vprašanje: A type is missing from the class hierarchy.
Odgovor: If the type is listed in <package>.hierarchy but not in xml/tree_index.sgml then double check that the type is correctly placed in the <package>-sections.txt. If the type instance (e.g. Gradnik Gtk) is not listed or incidentialy makred private it will not be shown.
Vprašanje: I get foldoc links for all gobject annotations.
Odgovor: Check that xml/annotation-glossary.xml is xi:included from <package>-docs.{xml,sgml}.
Vprašanje: Parameter described in source code comment block but does not exist
Odgovor: Check if the prototype in the header has different parameter names as in the source.
Vprašanje: multiple "IDs" for constraint linkend: XYZ
Odgovor: Symbol XYZ appears twice in <package>-sections.txt file.
Vprašanje: Element typename in namespace '' encountered in para, but no template matches.
Odgovor: