Επεξεργασία αρχείου ενοτήτων

Το αρχείο ενοτήτων χρησιμεύει στην οργάνωση της τεκμηρίωσης που παράγεται από το GTK-Doc. Εδώ διευκρινίζεται σε ποιο άρθρωμα ή κλάση ανήκει κάθε σύμβολο και αποφασίζεται η ορατότητά του (αν θα είναι δημόσιο ή ιδιωτικό).

Το αρχείο ενοτήτων είναι ένα αρχείο απλού κειμένου που χρησιμοποιεί σύνταξη με ετικέτες, παρόμοια με την xml. Οι κενές γραμμές αγνοούνται, ενώ οι γραμμές που ξεκινούν με # αποτελούν σχόλια.

Η ετικέτα <FILE> ... </FILE> χρησιμποιείται για να δηλώσει το όνομα του αρχείου χωρίς την επέκταση. Για παράδειγμα, το '<FILE>gnome-config</FILE>' σημαίνει ότι οι δηλώσεις των ενοτήτων θα βρίσκονται στο πρότυπο αρχείο tmpl/gnome-config.sgml, το οποίο θα μετατραπεί στο αρχείο DocBook SGML/XML sgml/gnome-config.sgml ή DocBook XML xml/gnome-config.xml. (Το όνομα του αρχείου html πηγάζει από το όνομα του αρθρώματος και τον τίτλο της ενότητας, ή από το όνομα της κλάσης του gobject, αλλά με πεζούς χαρακτήρες).

Η ετικέτα <TITLE> ... </TITLE> χρησιμοποιείται για να ορίσει τους τίτλους των ενοτήτων. Χρησιμεύει μόνο πριν τη δημιουργία των προτύπων, καθώς ο τίτλος που περιέχεται στα αρχεία προτύπων αντικαθιστά αυτούς τους τίτλους. Επίσης, αν χρησιμοποιείται το σχόλιο SECTION στον πηγαίο κώδικα, αυτό είναι πεπαλαιωμένο.

Μπορείτε να ομαδοποιείτε τα στοιχεία των ενοτήτων χρησιμοποιώντας την ετικέτα <SUBSECTION>. Με την τωρινή της μορφή, προσθέτει μία κενή γραμμή μεταξύ υποενοτήτων στη σύνοπτική παρουσίαση. Μπορείτε, επίσης, να χρησιμοποιήσετε την ετικέτα <SUBSECTION Standard> για κλασικές δηλώσεις GObject (π.χ. συναρτήσεις όπως η g_object_get_type και μακροεντολές όπως οι G_OBJECT(), G_IS_OBJECT(), κτλ.). Προς το παρόν, αυτές οι δηλώσεις μένουν εκτός τεκμηρίωσης. Τέλος, μπορείτε να χρησιμοποιήσετε την ετικέτα <SUBSECTION Private> για ιδιωτικές δηλώσεις που δεν πρόκειται να εμφανιστούν στην τεκμηρίωση (έτσι αποφεύγετε τις προειδοποιήσεις για δηλώσεις που δεν χρησιμοποιούνται). Αν η βιβλιοθήκη σας περιέχει ιδιωτικούς τύπους, για τους οποίους δεν επιθυμείτε να εμφανίζονται στην ιεραρχία αντικειμένων και στη λίστα υλοποιημένων ή απαιτούμενων διεπαφών, μπορείτε να τους προσθέσετε σε μία ιδιωτική υποενότητα.

Μπορείτε, επίσης, να χρησιμοποιείτε την ετικέτα <INCLUDE> ... </INCLUDE> για τα αρχεία #include που περιλαμβάνονται στις ενότητες συνοπτικής παρουσίασης. Περιέχει μία λίστα με αρχεία #include, χωρισμένα με κόμματα και χωρίς τα ''