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: