常见问题
问题: 无类继承关系。
答案: 对象的 xxx_get_type() 函数未进入 <package>.types 文件。
问题: 仍无类继承关系。
答案: Missing or wrong naming in <package>-sections.txt file (see explanation).
问题: 该死,我仍然没有类继承关系。
答案: 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).
问题: 无标识符索引。
答案: Does the <package>-docs.{xml,sgml} contain a index that xi:includes the generated index?
问题: Symbols are not linked to their doc-section.
答案: Is the doc-comment using the correct markup (added #,% or ())? Check if the gtkdoc-fixxref warns about unresolvable xrefs.
问题: A new class does not appear in the docs.
答案: Is the new page xi:included from <package>-docs.{xml,sgml}.
问题: A new symbol does not appear in the docs.
答案: 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.
问题: A type is missing from the class hierarchy.
答案: 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.
问题: I get foldoc links for all gobject annotations.
答案: Check that xml/annotation-glossary.xml is xi:included from <package>-docs.{xml,sgml}.
问题: Parameter described in source code comment block but does not exist
答案: Check if the prototype in the header has different parameter names as in the source.
问题: multiple "IDs" for constraint linkend: XYZ
答案: Symbol XYZ appears twice in <package>-sections.txt file.
问题: Element typename in namespace '' encountered in para, but no template matches.
答案: