Preguntas más frecuentes

Pregunta: Sin jerarquía de clases.

Respuesta: Los objetos de la función xxx_get_type() no se han introducido en el archivo <paquete>.tipos.

Pregunta: Aún sin jerarquía de clases.

Respuesta: Faltan nombres o son erróneos en el archivo <package>-sections.txt (consultar explicación).

Pregunta: Maldición, aún no hay una jerarquía de clases.

Respuesta: Es el nombre del objeto (nombre de la estructura de la instancia, ej. GtkWidget) parte de la sección normal (no ponga esto en Estándar o Privado).

Pregunta: Sin índice de símbolos.

Respuesta: ¿<package>-docs.{xml,sgml} contiene un índice que «xi:includes» el índice generado?

Pregunta: Los símbolos no se enlazan con su sección en el documento.

Respuesta: ¿Está doc-comment usando el marcado correcto (añadido #,% o ())? Compruebe si gtk-doc-fixxref avisa de alguna referencia xref sin resolver.

Pregunta: Una clase nueva no aparece en la documentación.

Respuesta: Es la página nueva «xi:included» desde <package>-docs.{xml,sgml}.

Pregunta: Un símbolo nuevo no aparece en la documentación.

Respuesta: Comprobar que el doc-comment está formateado correctamente. Compruebe errores de escritura al principio del comentario. Compruebe si gtkdoc-fixxref avisa acerca de referencias xref no solventables. Compruebe si el símbolo está listado correctamente en la <package>-sections.txt en una subsección pública.

Pregunta: Falta un tipo en la clase de jerarquías

Respuesta: Si el tipo está listado en <paquete>.jerarquía pero no en xml/tree_index.sgml, entonces compruebe dos veces que el tipo está correctamente ubicado en la <package>-sections.txt. No se mostrará el tipo de instancia (ej. GtkWidget) si no está listada o accidentalmente marcada como privada.

Pregunta: Obtengo enlaces de seguimiento de documentos para todas las anotaciones gobject.

Respuesta: Compruebe que xml/annotation-glossary.xml está «xi:included» desde <package>-docs.{xml,sgml}.

Pregunta: Parámetro descrito en el bloque de comentarios del código fuente pero no existe

Respuesta: Compruebe si el prototipo en la cabecera tiene nombres de parámetro diferentes de la fuente.

Pregunta: múltiples «ID» para la restricción enlazada: XYZ

Respuesta: El símbolo XYZ aparece dos veces en el archivo <package>-sections.txt.

Pregunta: Elemento typename en namespac e«» encontrado en para, pero ninguna plantilla coincide.

Respuesta: