Foire aux questions
Question : Pas de hiérarchie de classe.
Réponse : Les fonctions objet xxx_get_type() n'ont pas été saisies dans le fichier <module>.types.
Question : Toujours pas de hiérarchie de classe.
Réponse : Mauvais nom ou nom absent dans le fichier <module>-sections.txt (consultez une explication).
Question : Zut, je n'ai toujours pas de hiérarchie de classe.
Réponse : Est-ce que le nom de l'objet (nom de la structure de l'instance, par ex. GtkWidget) fait parti de la section « normal » (ne pas le mettre dans les sous-sections « Standard » ou « Private »).
Question : Pas d'index des symboles.
Réponse : Est-ce que <module>-docs.{xml,sgml} contient un index qui « xi:includes » l'index généré ?
Question : Les symboles ne sont pas liés à leur section de documentation.
Réponse : Est-ce que doc-comment utilise le markup correct (ajout d'un #, % ou ()) ? Contrôlez si gtkdoc-fixxref affiche des avertissements à propos de xrefs non résolus.
Question : Une nouvelle classe n'apparaît pas dans les documents.
Réponse : Est-ce que la nouvelle page est xi:included à partir de <module>-docs.{xml,sgml}.
Question : Un nouveau symbole n'apparaît pas dans les documents.
Réponse : Est-ce que le doc-comment est correctement formaté. Vérifiez qu'il n'y a pas d'erreur de frappe au début du commentaire. Vérifiez que gtkdoc-fixxref ne vous indique pas de xrefs non résolus. Vérifiez que le symbole est correctement listé dans une section publique de <module>-sections.txt.
Question : Un type est absent dans la hiérarchie de classe.
Réponse : Si le type est listé dans <module>.hierarchy mais pas dans xml/tree_index.sgml alors contrôlez deux-fois que le type est correctement placé dans <module>-sections.txt. Si l'instance du type (par ex. GtkWidget) n'est pas listée ou marquée par accident comme privée, elle ne sera pas affichée.
Question : J'obtiens des liens foldoc pour toutes les annotations gobject.
Réponse : Vérifiez que xml/annotation-glossary.xml est xi:included à partir de <module>-docs.{xml,sgml}.
Question : Un paramètre est décrit dans le bloc de commentaires dans le code source mais il n'existe pas.
Réponse : Vérifiez si le prototype dans le fichier d'en-tête possède des noms de paramètres différents de ceux du fichier source.
Question : « ID » multiples pour le linkend: XYZ contraint
Réponse : Le symbole XYZ apparaît en double dans le fichier <module>-sections.txt.
Question : Élément typename dans l'espace de nom '' rencontré dans para mais aucun prototype ne correspond.
Réponse :