常见问题

问题: 无类继承关系。

答案: 对象的 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 incidentialy makred 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.

答案: