Ενσωμάτωση στο autoconf
Πολύ απλά! Απλά προσθέτετε μία γραμμή στο σενάριο configure.ac.
# check for gtk-doc GTK_DOC_CHECK([1.14],[--flavour no-tmpl])
Αυτό θα επαιτεί όλοι οι προγραμματιστές να έχουν εγκατεστημένο το gtk-doc. Αν είναι εντάξει για το έργο σας να έχετε επιπλέον κατασκευή ρυθμίσεων για το api-doc, μπορείτε να το επιλύσετε όπως αναφέρετε παρακάτω. Αφήστε το όπως έχει, όσο το gtkdocize ψάχνει στην αρχή της σειράς για το GTK_DOC_CHECK.
# check for gtk-doc m4_ifdef([GTK_DOC_CHECK], [ GTK_DOC_CHECK([1.14],[--flavour no-tmpl]) ],[ AM_CONDITIONAL([ENABLE_GTK_DOC], false) ])
Το πρώτο όρισμα χρησιμοποιείται για έλεγχο του gtkdocversion κατά τη ρύθμιση. Το δεύτερο, προαιρετικό όρισμα χρησιμοποιείται από το gtkdocize. Η μακροεντολή GTK_DOC_CHECK επίσης προσθέτει αρκετούς διακόπτες ρύθμισης:
- --with-html-dir=ΔΙΑΔΡΟΜΗ : διαδρομή προς την εγκατεστημένη τεκμηρίωση
- --enable-gtk-doc : χρήση gtk-doc για την παραγωγή τεκμηρίωσης [default=no]
- --enable-gtk-doc-html : παραγωγή τεκμηρίωσης σε μορφή html [default=yes]
- --enable-gtk-doc-pdf : παραγωγή τεκμηρίωσης σε μορφή pdf [default=no]
Η προεπιλογή είναι να είναι απενεργοποιημένο το GTK-Doc! Θυμηθείτε να χρησιμοποιήσετε την επιλογή '--enable-gtk-doc' στην επόμενη εκτέλεση του configure. Διαφορετικά εγκαθίσταται η προπαραχθείσα τεκμηρίωση (δυνατότητα χρήσιμη για το χρήστη, αλλά όχι για τον προγραμματιστή).
Επίσης, συνιστάται να προσθέσετε την ακόλουθη γραμμή στο σενάριο configure.ac. Επιτρέπει στο gtkdocize να αντιγράφει αυτόματα τον ορισμό της μακροεντολής GTK_DOC_CHECK στο έργο σας.
AC_CONFIG_MACRO_DIR(m4)