Συχνές ερωτήσεις

Ερώτηση: Δεν υπάρχει ιεραρχία κλάσεων.

Απάντηση: Η συνάρτηση αντικειμένου xxx_get_type() δεν έχει εισαχθεί στο αρχείο <package>.types

Ερώτηση: Εξακολουθεί να μην υπάρχει ιεραρχία κλάσεων.

Απάντηση: Ελλιπής ή λανθασμένη ονομασία στο αρχείο <package>-sections.txt (δείτε την αιτιολόγηση).

Ερώτηση: Στο καλό του, πάλι δεν έχω ιεραρχία κλάσεων.

Απάντηση: Ελέγξτε αν το όνομα του αντικειμένου (δηλαδή το όνομα του συγκεκριμένου παραδείγματος της δομής, π.χ. GtkWidget) περιλαμβάνεται στην κανονική ενότητα (δεν πρέπει να βρίσκεται εντός υποενότητας Standard ή Private).

Ερώτηση: Δεν υπάρχει ευρετήριο συμβόλων.

Απάντηση: Το <package>-docs.{xml,sgml} περιέχει ένα ευρετήριο το οποίο περιλαμβάνει με xi:includes το παραγόμενο ευρετήριο;

Ερώτηση: Δεν υπάρχουν σύνδεσμοι μεταξύ των συμβόλων και των κατάλληλων ενοτήτων της τεκμηρίωσης.

Απάντηση: Το doc-comment χρησιμοποιεί σωστά τις επισημάνσεις (έχουν προστεθεί #,% ή ()); Ελέγξτε αν το gtkdoc-fixxref προειδοποιεί για ανεπίλυτα xrefs.

Ερώτηση: Μια νέα κλάση δεν εμφανίζεται στην τεκμηρίωση.

Απάντηση: Συμπεριλαμβάνεται η νέα σελίδα xi:included από το <package>-docs.{xml,sgml};

Ερώτηση: Ένα νέο σύμβολο δεν εμφανίζεται στην τεκμηρίωση.

Απάντηση: Το doc-comment είναι κανονικά μορφοποιημένο; Ελέγξτε για συντακτικά λάθη στην αρχή του σχολίου. Ελέγξτε αν το gtkdoc-fixxref προειδοποιεί για ανεπίλυτα xref. Ελέγξτε αν το σύμβολο είναι σωστά καταχωρημένο στο <package>-sections.txt σε μια δημόσια υποενότητα.

Ερώτηση: Λείπει ένας τύπος από την ιεραρχία κλάσεων.

Απάντηση: Αν ο τύπος υπάρχει στο <package>.hierarchy αλλά όχι στο xml/tree_index.sgml τότε ελέγξτε ξανά ότι ο τύπος είναι σωστά τοποθετημένος στο <package>-sections.txt. Αν ο τύπος του παραδείγματος (π.χ. GtkWidget) δεν είναι καταχωρημένος, ή είναι κατά λάθος σημειωμένος ως ιδιωτικός, τότε δε θα εμφανιστεί.

Ερώτηση: Λαμβάνω συνδέσμους foldoc για όλες τις σημειώσεις gobject.

Απάντηση: Ελέγξτε ότι το xml/annotation-glossary.xml είναι xi:included από το <package>-docs.{xml,sgml}.

Ερώτηση: Μια παράμετρος περιγράφεται σε σχόλιο του πηγαίου κώδικα, αλλά δεν υπάρχει

Απάντηση: Ελέγξτε αν το πρωτότυπο στην κεφαλίδα περιέχει διαφορετικό όνομα για την παράμετρο από αυτό που αναφέρεται στον κώδικα.

Ερώτηση: Πολλαπλά "Αναγνωριστικά" για τον προορισμό συνδέσμου: XYZ

Απάντηση: Το σύμβολο XYZ εμφανίζεται δύο φορές στο αρχείο <package>-sections.txt.

Ερώτηση: Βρέθηκε το όνομα τύπου του στοιχείου στην ονοματοθεσία '', αλλά δεν αντιστοιχεί σε κανένα πρότυπο.

Απάντηση: