Häufig gestellte Fragen

Frage: Keine Klassenhierarchie.

Antwort: Die xxx_get_type()-Funktion des Objekts wurde nicht in die Datei <package>.types eingegeben.

Frage: Noch immer keine Klassenhierarchie.

Antwort: Falsche oder fehlende Benennung in der Datei <package>-sections.txt (siehe Erklärung).

Frage: Verdammt, ich habe immer noch keine Klassenhierarchie.

Antwort: Is the object name (name of the instance struct, e.g. GtkWidget) part of the normal section (don't put this into Standard or Private subsections).

Frage: Kein Symbolindex.

Antwort: Does the <package>-docs.{xml,sgml} contain a index that xi:includes the generated index?

Frage: Symbole werden nicht mit deren Dokumentationsbschnitt verknüpft.

Antwort: Is the doc-comment using the correct markup (added #,% or ())? Check if the gtkdoc-fixxref warns about unresolvable xrefs.

Frage: Eine neue Klasse erscheint nicht in der Dokumentation.

Antwort: Is the new page xi:included from <package>-docs.{xml,sgml}.

Frage: Ein neues Symbol erscheint nicht in der Dokumentation.

Antwort: 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.

Frage: Ein Typ fehlt in der Klassenhierarchie.

Antwort: 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. GtkWidget) is not listed or incidentialy makred private it will not be shown.

Frage: I get foldoc links for all gobject annotations.

Antwort: Check that xml/annotation-glossary.xml is xi:included from <package>-docs.{xml,sgml}.

Frage: Parameter wird im Kommentarblock des Quellcodes beschrieben, aber existiert nicht

Antwort: Überprüfen Sie, ob die Parameternamen der Prototypen in der Quelle und im Header unterschiedlich sind

Frage: multiple "IDs" for constraint linkend: XYZ

Antwort: Das Symbol XYZ erscheint zweifach in der Datei <package>-sections.txt.

Frage: Element typename in namespace '' encountered in para, but no template matches.

Antwort: