Kontrollera resultatet
En GTK-Doc-körning genererar rapportfiler inuti dokumentationskatalogen. De genererade filerna heter: <paket>-undocumented.txt, <paket>-undeclared.txt och <paket>-unused.txt. Alla är vanliga textfiler och kan visas eller efterbehandlas enkelt.
Filen <paket>-undocumented.txt inleds med en sammanfattning över hur mycket dokumentation som skrivits. Under det finns två avsnitt avgränsade av blankrader. Det första avsnittet listar odokumenterade eller ofullständiga symboler. Det andra avsnittet gör detsamma för avsnittsdokumentation. Ofullständiga poster är de som har dokumentation, men där en ny parameter har lagts till.
Filen <paket>-undeclared.txt listar symboler som anges i <paket>-sections.txt men inte hittas i källkoden. Kontrollera om de har tagits bort eller om de är felstavade.
Filen <paket>-unused.txt listar symbolnamn där GTK-Doc-detektorn har hittat dokumentation men inte vet var den ska placeras. Detta innebär att symbolen ännu inte har lagts till i filen <package>-sections.txt.
Aktivera eller lägg till raden TESTS=$(GTKDOC_CHECK) i Makefile.am. Om åtminstone GTK-Doc 1.9 finns installerat kommer detta att köra rimlighetskontroller under körning av make check.
Man kan också titta på filerna som producerats av källkodsdetektorn: <paket>-decl-list.txt och <paket>-decl.txt. Den första kan jämföras med avsnittsfilen om den underhålls manuellt. Den andra listar alla deklarationer från huvudena. Om en symbol saknas bör man kontrollera om denna filen innehåller den.
Om projektet är GObject-baserat kan man också titta på filerna som producerats av objekt-detektorn: <paket>.args.txt, <paket>.hierarchy.txt, <paket>.interfaces.txt, <paket>.prerequisites.txt och <paket>.signals.txt. Om det saknas symboler i någon av dem kan man be GTK-Doc att bibehålla de temporära detektorfilerna för vidare analys, genom att köra det som GTK_DOC_KEEP_INTERMEDIATE=1 make.