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: Wenn der Typ in <package>.hierarchy gelistet ist, aber nicht in xml/tree_index.sgml, dann prüfen Sie sorgfältig, ob der Typ ordnungsgemäß in <package>-sections.txt abgelegt ist. Falls die Typ-Instanz (z.B. GtkWidget) nicht aufgelistet oder versehentlich als privat markiert ist, so wird sie nciht angezeigt.

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: