Τεκμηρίωση κώδικα
Το GTK-Doc χρησιμοποιεί σχόλια με ειδική σύνταξη για την προσθήκη τεκμηρίωσης στον κώδικα. Παράλληλα, ανακαλεί πληροφορίες για τη δομή του έργου σας από άλλες πηγές. Στην επόμενη ενότητα περιέχονται όλες οι λεπτομέρειες για τη σύνταξη αυτών των σχολίων.
Στο παρελθόν, η τεκμηρίωση έπρεπε να συμπληρώνεται σε αρχεία του καταλόγου tmpl. Αυτή η προσέγγιση εμφανίζει το μειονέκτημα ότι οι πληροφορίες δεν ενημερώνονται συχνά, καθώς και το ότι προκύπτουν περιοδικές συγκρούσεις με τα συστήματα ελέγχου εκδόσεων.
Για να αποφύγετε αυτά τα προβλήματα, σας προτείνουμε να ενσωματώνετε την τεκμηρίωση στον πηγαίο κώδικα. Αυτή είναι και η μόνη μέθοδος που θα περιγράψουμε σε αυτό το εγχειρίδιο.
Ο σαρωτής μπορεί να χειρισθεί άνετα την πλειοψηφία των κεφαλίδων C. Σε περίπτωση που παίρνετε προειδοποιήσεις από τον σαρωτή οι οποίες μοιάζουν με έναν ειδικό χαρακτήρα, μπορείτε να υποδείξετε στο GTK-Doc να τους παραλείψει.
#ifndef __GTK_DOC_IGNORE__ /* unparseable code here */ #endif
Σημειώστε, ότι το GTK-Doc υποστηρίζει το #ifndef(__GTK_DOC_IGNORE__), αλλά όχι το #if !defined(__GTK_DOC_IGNORE__) ή άλλους συνδυασμούς.
- 3.1. Σχόλια τεκμηρίωσης
- 3.2. Τεκμηρίωση ενοτήτων
- 3.3. Τεκμηρίωση συμβόλων
- 3.4. Inline program documentation
- 3.5. Χρήσιμες ετικέτες DocBook