Často kladené dotazy

Dotaz: Schází hierarchie třídy.

Odpověď: Do souboru <balíček>.types nebyla vložena funkce objektu xxx_get_type().

Dotaz: Stále schází hierarchie třídy.

Odpověď: Chybějící nebo nesprávné pojmenování souboru <balíček>-sections.txt (viz vysvětlení).

Dotaz: Do háje, pořád nemám hierarchii třídy.

Odpověď: Je název objektu (název struktury instance, například GtkWidget) součástí normálního oddílu? (Nedávejte je do pododdílu Standard nebo Private).

Dotaz: Chybí rejstřík symbolů.

Odpověď: Obsahuje <package>-docs.{xml,sgml} rejstřík, který vloží pomocí xi:include vygenerovaný rejstřík?

Dotaz: Symbol nemá odkaz do svého oddílu dokumentace.

Odpověď: Používá dokumentační komentář správnou značku (přidané znaky #,% nebo ())? Podívejte se na varování gtkdoc-fixxref o nevyřešených křížových odkazech.

Dotaz: Nová třída se neobjevila v dokumentaci.

Odpověď: Je nový balíček vložený pomocí xi:include z <package>-docs.{xml,sgml}.

Dotaz: Nový symbol se neobjevil v dokumentaci.

Odpověď: Je dokumentační komentář správně naformátovaný? Zkontrolujte překlepy na začátku komentáře. Podívejte se po varováních gtkdoc-fixxref o nevyřešených křížových odkazech. Zkontrolujte, jestli je symbol správně uvedený v <package>-sections.txt ve veřejném pododdíle.

Dotaz: V hierarchii třídy schází typ.

Odpověď: Jestliže je typ uvedený v <package>.hierarchy, ale není v xml/tree_index.sgml, tak raději dvakrát zkontrolujte, jestli je typ správně uvedený v <package>-sections.txt. Jestliže instance typu (například GtkWidget) není uvedená, nebo je nedopatřením označení jako privátní, nebude zobrazena.

Dotaz: Vytvořily se mi odkazy na složku s dokumentací pro všechny anotace k GObject

Odpověď: Zkontrolujte, že xml/annotation-glossary.xml je vložené pomocí xi:include z <package>-docs.{xml,sgml}.

Dotaz: Parametr je v komentářovém bloku zdrojového kódu popsaný, ale neexistuje.

Odpověď: Zkontrolujte, za nemá prototyp v hlavičkovém souboru jiné názvy parametrů, než ve zdrojovém kódu.

Dotaz: Více „ID“ pro tentýž cíl odkazu: XYZ

Odpověď: Symbol XYZ se v souboru <package>-sections.txt objevuje dvakrát.

Dotaz: Element typename ve jmenném prostoru '' je uvedený v rodiči, ale neodpovídá mu žádná šablona.

Odpověď: