Modernisera dokumentationen
GTK-Doc har funnits ett tag. I detta avsnitt listar vi nya funktioner tillsammans med vilken version de gjordes tillgängliga.

GTK-Doc 1.9
När man använder xml istället för sgml, kan man faktiskt kalla huvuddokumentet <paket>-docs.xml.
Denna version har stöd för SCAN_OPTIONS=--rebuild-sections i Makefile.am. När detta är aktiverat kommer <paket>-sections.txt att autogenereras och kan tas bort från versionshanteringssystemet. Detta fungerar bra för projekt som har en väldigt standardiserad struktur (t.ex. kommer varje .{c,h}-par att skapa ett nytt avsnitt). Om man organiserar ett projekt likt detta kommer den manuella uppdateringen av en avsnittsfil att vara så enkelt som att köra meld <paket>-decl-list.txt <paket>-sections.txt.
Redan version 1.8 introducerade syntaxen för avsnittsdokumentation i källkoden istället för separata filer under tmpl. Denna version lägger till flaggor för att kunna ställa om hela dokumentationsmodulen till att inte använda det extra tmpl-byggsteget alls, genom att använda --flavour no-tmpl i configure.ac. Om du inte har tmpl incheckat i ditt versionshanteringssystem just nu och inte har gått över än bara lägg till flaggan i configure.ac så är du klar.

GTK-Doc 1.10
Denna version har stöd för SCAN_OPTIONS=--rebuild-types i Makefile.am. När det är aktiverat kommer <package>.types att autogenereras och kan tas bort från versionshanteringssystemet. När denna funktion används är det viktigt att också ställa in IGNORE_HFILES i Makefile.am för kod som bara byggs ibland.

GTK-Doc 1.16
Denna version har stöd för ett nytt verktyg som heter gtkdoc-check. Detta verktyg kan köra en uppsättning kontroller på din dokumentation. Det aktiveras genom att lägga till dessa raderna i slutet av Makefile.am.

Aktivera gtkdoc-check

if ENABLE_GTK_DOC
TESTS_ENVIRONMENT = \
  DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \
  SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)
TESTS = $(GTKDOC_CHECK)
endif

GTK-Doc 1.20
Version 1.18 införde inledande stöd för markdown. Att använda markdown i dokumentationskommentarer är mindre påträngande än att skriva docbook xml. Denna version förbättrar detta väsentligt och lägger till många fler stilar. Avsnittet som beskriver kommentarsyntax finnas alla detaljer.

GTK-Doc 1.25
Makefilerna som skeppas med denna version genererar en entitetsfil vid namn xml/gtkdocentities.ent som innehåller entiteter för t.ex. package_name och package_version. Du kan använda detta för att t.ex. i filen main xml undvika att hårdkoda versionsnumret. Nedan finns ett exempel som visar hur entitetsfilen inkluderas och hur entiteter används. Entiteterna kan också användas i alla genererade filer, GTK-Doc kommer att använda samma xml-huvud i genererade xml-filer.

Att använda förgenererade entiteter

<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
  <!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent">
  %gtkdocentities;
]>
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
  <bookinfo>
    <title>&package_name; handbok</title>
    <releaseinfo>
      för &package_string;.
      Den senaste versionen av detta dokument kan hittas på nätet på
      <ulink role="online-location" url="http://[SERVER]/&package_name;/index.html">http://[SERVER]/&package_name;/</ulink>.
    </releaseinfo>
  </bookinfo>