Ενσωμάτωση στο autogen

Τα περισσότερα έργα διαθέτουν ένα σενάριο autogen.sh για τη δόμηση υποδομών μετά από έναν έλεγχο από το σύστημα ελέγχου εκδόσεων (π.χ., cvs/svn/git). Το GTK-Doc διαθέτει το εργαλείο gtkdocize, το οποίο μπορεί να χρησιμοποιηθεί για ένα τέτοιο σενάριο. Θα πρέπει να εκτελείται πριν το autoheader, το automake ή το autoconf.

Παράδειγμα 2-5Εκτέλεση του gtkdocize από το autogen.sh
gtkdocize || exit 1

Κατά την εκτέλεσή του, το gtkdocize αντιγράφει το gtk-doc.make στο ριζικό κατάλογο του έργου σας (ή στον κατάλογο που ορίζει η επιλογή --docdir). Επίσης, ελέγχει τη δέσμη ενεργειών configure για να βρει την κλήση στο GTK_DOC_CHECK.

Αρχικά, το GTK-Doc δημιουργούσε αρχεία προτύπων εκεί που οι προγραμματιστές εισήγαγαν την τεκμηρίωση. Δυστυχώς, αυτή η προσέγγιση δεν ήταν ιδιαίτερα επιτυχής (π.χ η ανάγκη για παραγωγή αρχείων στο σύστημα ελέγχου εκδόσεων). Από την έκδοση 1.9 και μετά, τα πρότυπα αρχεία δεν είναι πλέον απαραίτητα. Σας συνιστούμε να διατηρείτε την τεκμηρίωση στον κώδικα. To gtkdocize υποστηρίζει πλέον την επιλογή --flavour no-tmpl που επιλέγει ένα αρχείο makefile που δεν χρησιμοποιεί καθόλου πρότυπα tmpl. Πέρα από την άμεση προσθήκη της επιλογής στην κλήση της εντολής, μπορεί να προστεθεί και σε μια μεταβλητή περιβάλλοντος που ονομάζεται GTKDOCIZE_FLAGS ή να ορισθεί ως δεύτερη παράμετρος στη μακροεντολή GTK_DOC_CHECK στο σενάριο configure. Αν δεν έχετε κάνει ποτέ αλλαγές με το χέρι σε αρχεία προτύπων και μεταβαίνετε από μια παλιότερη έκδοση του gtkdoc, παρακαλώ αφαιρέστε τον κατάλογο (π.χ. από το σύστημα ελέγχου εκδόσεων).