Frågor och svar

Fråga: Ingen klasshierarki.

Svar: Objektens xxx_get_type()-funktion har inte matats in i filen <paket>.types.

Fråga: Fortfarande ingen klasshierarki.

Svar: Saknat eller fel namn i filen <paket>-sections.txt (se förklaring).

Fråga: Förbannat, jag har fortfarande ingen klasshierarki.

Svar: Är objektnamnet (namnet på instansstrukturen, t.ex. GtkWidget) del av det normala avsnittet (stoppa inte detta i underavsnitt så som Standard eller Private).

Fråga: Inget symbolindex.

Svar: Innehåller <paket>-docs.{xml,sgml} ett index som inkluderar det genererade indexet med xi:include?

Fråga: Symboler är inte länkade till deras dokumentationsavsnitt.

Svar: Använder dokumentationskommentaren korrekta taggar (har du lagt till #, % eller ())? Kontrollera om gtkdoc-fixxref varnar om oupplösbara korsreferenser.

Fråga: En ny klass dyker inte upp i dokumentationen.

Svar: Är den nya sidan inkluderad med xi:include från <package>-docs.{xml,sgml}.

Fråga: En ny symbol dyker inte upp i dokumentationen.

Svar: Är dokumentationskommentaren korrekt formaterad. Leta efter stavfel i början av kommentaren. Kontrollera om gtkdoc-fixxref varnar om oupplösbara korsreferenser. Kontrollera om symbolen finns korrekt listad i <paket>-sections.txt i ett publikt avsnitt.

Fråga: En typ saknas från klasshierarkin.

Svar: Om typen finns listad i <paket>.hierarchy men inte i xml/tree_index.sgml, dubbelkolla då att typen finns korrekt placerad i <paket>-sections.txt. Om typinstansen (t.ex. GtkWidget) inte visas eller är markerad privat kommer den inte att visas.

Fråga: Jag får foldoc-länkar för alla gobject-noteringar.

Svar: Kontrollera att xml/annotation-glossary.xml är inkluderad med xi:include från <package>-docs.{xml,sgml}.

Fråga: Parameter beskriven i kommentarsblock i källkoden men existerar inte

Svar: Kontrollera om prototypen i huvudet har andra parameternamn än i källkoden.

Fråga: multipla ”ID:n” för begränsat länkslut: XYZ

Svar: Symbolen XYZ förekommer två gånger i filen <paket>-sections.txt.

Fråga: Elementtypnamn i namnrymd ”” påträffat i para, men ingen mall matchar.

Svar: