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: Fehlende oder falsche Benennung in der Datei <Paket>-sections.txt (lesen Sie die Erklärung).
Frage: Verdammt, ich habe immer noch keine Klassenhierarchie.
Antwort: Ist der Objektname (Name des Instanz-struct, z.B. GtkWidget) Teil des normalen Abschnitts (nicht in den Standard- oder Unterabschnitte).
Frage: Kein Symbolindex.
Antwort: Enthält <package>-docs.{xml,sgml} einen Index, der den erstellten Index xi:enthält?
Frage: Symbole werden nicht mit deren Dokumentationsbschnitt verknüpft.
Antwort: Verwendet das doc-comment das richtige Markup (hinzugefügtes »#«,»%« oder »()«)? Prüfen Sie, ob gtkdoc-fixxref wegen nicht auflösbarer xrefs warnt.
Frage: Eine neue Klasse erscheint nicht in der Dokumentation.
Antwort: Ist die neue Seite xi:eingebunden von <package>-docs.{xml,sgml}?
Frage: Ein neues Symbol erscheint nicht in der Dokumentation.
Antwort: ist doc-comment ordnungsgemäß formatiert? Prüfen Sie den Anfang des Dokuments auf Rechtschreibfehler im Kommentar. Prüfen Sie ob gtkdoc-fixxref wegen unauflösbarer xrefs warnt. Prüfen Sie, ob das Symbol richtig in <package>-sections.txt in einem öffentlichen Abschnitt gelistet ist.
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 incidentally marked private it will not be shown.
Frage: Ich erhalte foldoc-Verweise für alle gobjekt-Anmerkungen.
Antwort: Prüfen Sie, ob xml/annotation-glossary.xml von <package>-docs.{xml,sgml} xi:eingebunden ist.
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: