Perguntas frequentes

Questão: Sem hierarquia de classe.

Resposta: A função de objetos xxx_get_type() não foi inserida no arquivo <pacote>.types.

Questão: Ainda sem hierarquia.

Resposta: Nomenclatura faltando ou incorreta no arquivo <pacote>-sections.txt (veja a explicação).

Questão: Droga. Eu ainda não tenho hierarquia de classes.

Resposta: Por acaso o nome do objeto (nome da struct da instância, ex. GtkWidget) faz parte da seção normal (não coloque isso em subseções Standard ou Private)?

Questão: Nenhum símbolo de índice.

Resposta: O <pacote>-docs.{xml,sgml} contém um índice que “xi:inclui” o índice gerado?

Questão: Símbolos não estão vinculados ao seus doc-section.

Resposta: O doc-comment está usando a marcação correta (adicionado #,% or ())? Verifique se o gtkdoc-fixxref avisa sobre xrefs não resolvidos.

Questão: Uma nova classe não aparece nos documentos.

Resposta: A nova página foi “xi:incluída” do <pacote>-docs.{xml,sgml}?

Questão: Um novo símbolo não aparece nos documentos.

Resposta: O doc-comment está formatado adequadamente? Verifique erros de escrita no começo do comentário. Verifique se o gtkdoc-fixxref avisa sobre xrefs não resolvíveis. Verifique se o símbolo está listado corretamente no <pacote>-sections.txt em uma subseção pública.

Questão: Um tipo está faltando da hierarquia de classe.

Resposta: Se o tipo está listado no <pacote>.hierarchy, mas não em xml/tree_index.sgml, então certifique-se de que o tipo está colocado corretamente no <pacote>-sections.txt. Se a instância do tipo (ex.: GtkWidget) não está listada ou incidentalmente marcada como privada, ela não será mostrada.

Questão: Obtenho links de seguimento de documentos para todas as anotações gobject.

Resposta: Verifique se xml/annotation-glossary.xml está “xi:incluído” de <pacote>-docs.{xml,sgml}.

Questão: Parâmetro descrito no bloco de comentário do código fonte não existe

Resposta: Verifique se o protótipo no cabeçalho tem nomes de parâmetros diferentes da fonte.

Questão: múltiplos “IDs” para restrições do fim do link XYZ

Resposta: O símbolo XYZ aparece duas vezes no arquivo <pacote>-sections.txt.

Questão: Elemento typename no espaço de nome '' encontrado em para, mas nenhum modelo correspondeu.

Resposta: