# translation of gtk-doc-help.master.po to Greek # Simos Xenitellis , 2009. # Jennie Petoumenou , 2009. # Marios Zindilis , 2010. # Tsivikis Vasilis , 2010. # Dimitris Spingos (Δημήτρης Σπίγγος) , 2013, 2014, 2015. # Efstathios Iosifidis , 2015. msgid "" msgstr "" "Project-Id-Version: gtk-doc-help.master\n" "POT-Creation-Date: 2016-03-21 21:32+0000\n" "PO-Revision-Date: 2016-04-10 22:03+0300\n" "Last-Translator: Tom Tryfonidis \n" "Language-Team: team@lists.gnome.gr\n" "Language: el\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" "X-Generator: Poedit 1.8.7.1\n" #. Put one translator per line, in the form NAME , YEAR1, YEAR2 msgctxt "_" msgid "translator-credits" msgstr "" "Ελληνική μεταφραστική ομάδα GNOME , 2009-2016\n" "Τζένη Πετούμενου , 2009\n" "Θάνος Τρυφωνίδης , 2012, 2015, 2016\n" "Δημήτρης Σπίγγος , 2013-2015\n" "Μαρία Θουκυδίδου , 2014\n" "Μαρία Μαυρίδου , 2014" #. (itstool) path: bookinfo/title #: C/index.docbook:12 msgid "GTK-Doc Manual" msgstr "Εγχειρίδιο GTK-Doc" #. (itstool) path: bookinfo/edition #: C/index.docbook:13 msgid "1.24.1" msgstr "1.24.1" #. (itstool) path: abstract/para #: C/index.docbook:14 msgid "User manual for developers with instructions of GTK-Doc usage." msgstr "" "Εγχειρίδιο χρήστη για προγραμματιστές με οδηγίες για τη χρήση του GTK-Doc." #. (itstool) path: authorgroup/author #: C/index.docbook:16 msgid "" "Chris Lyttle " "
chris@wilddev.net
" msgstr "" "Chris Lyttle " "
chris@wilddev.net
" #. (itstool) path: authorgroup/author #: C/index.docbook:25 msgid "" "Dan Mueth
" "d-mueth@uchicago.edu
" msgstr "" "Dan Mueth
" "d-mueth@uchicago.edu
" #. (itstool) path: authorgroup/author #: C/index.docbook:34 msgid "" "Stefan Sauer (Kost) " "
ensonic@users.sf.net
" msgstr "" "Stefan Sauer (Kost) " "
ensonic@users.sf.net
" #. (itstool) path: publisher/publishername #: C/index.docbook:45 msgid "GTK-Doc project" msgstr "Έργο GTK-Doc" #. (itstool) path: bookinfo/publisher #: C/index.docbook:44 msgid "" "<_:publishername-1/>
gtk-doc-list@gnome.org
" msgstr "" "<_:publishername-1/>
gtk-doc-list@gnome.org
" #. (itstool) path: bookinfo/copyright #: C/index.docbook:48 msgid "2000, 2005 Dan Mueth and Chris Lyttle" msgstr "2000, 2005 Dan Mueth και Chris Lyttle" #. (itstool) path: bookinfo/copyright #: C/index.docbook:52 msgid "2007-2015 Stefan Sauer (Kost)" msgstr "2007-2015 Stefan Sauer (Kost)" #. (itstool) path: legalnotice/para #: C/index.docbook:65 msgid "" "Permission is granted to copy, distribute and/or modify this document under " "the terms of the GNU Free Documentation License, " "Version 1.1 or any later version published by the Free Software Foundation " "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A " "copy of the license is included." msgstr "" "Χορηγείται άδεια αντιγραφής, διανομής και/ή τροποποίησης του παρόντος " "εγγράφου υπό τους όρους της έκδοσης 1.1 της Ελεύθερης Άδειας " "Τεκμηρίωσης GNU (GFDL), ή οποιασδήποτε μεταγενέστερης έκδοσής " "αυτής από το Ίδρυμα Ελεύθερου Λογισμικού (FSF), χωρίς αμετάβλητα τμήματα, " "κείμενα εξωφύλλου και κείμενα οπισθοφύλλου. Συμπεριλαμβάνεται αντίγραφο της άδειας." #. (itstool) path: legalnotice/para #: C/index.docbook:73 msgid "" "Many of the names used by companies to distinguish their products and " "services are claimed as trademarks. Where those names appear in any GNOME " "documentation, and those trademarks are made aware to the members of the " "GNOME Documentation Project, the names have been printed in caps or initial " "caps." msgstr "" "Πολλές από τις ονομασίες που χρησιμοποιούνται από εταιρείες για την " "διαφοροποίηση των προϊόντων και υπηρεσιών τους έχουν καταχωρισθεί ως " "εμπορικά σήματα. Σε όποιο σημείο της τεκμηρίωσης GNOME τυχόν εμφανίζονται " "αυτές οι ονομασίες, και εφόσον τα μέλη του Έργου τεκμηρίωσης GNOME έχουν " "λάβει γνώση αυτών των εμπορικών σημάτων, οι ονομασίες ή τα αρχικά αυτών θα " "γράφονται με κεφαλαίους χαρακτήρες." #. (itstool) path: revhistory/revision #: C/index.docbook:83 #| msgid "" #| "1.24.1 30 May 2015 " #| "ss development version" msgid "" "1.25.1 21 March 2016 ss development version" msgstr "" "1.25.1 21 Μαρτίου 2016 " "ss έκδοση ανάπτυξης" #. (itstool) path: revhistory/revision #: C/index.docbook:89 #| msgid "" #| "1.24 29 May 2015 ss bug fix" msgid "" "1.25 21 March 2016 ss bug fixes, test cleanups" msgstr "" "1.25 21 Μαρτίου 2016 ss διορθώσεις σφαλμάτων, εκαθάρριση δοκιμαστικού " "κώδικα" #. (itstool) path: revhistory/revision #: C/index.docbook:95 msgid "" "1.24 29 May 2015 ss bug fix" msgstr "" "1.24 29 Μαΐου 2015 ss διόρθωση σφαλμάτων" #. (itstool) path: revhistory/revision #: C/index.docbook:101 msgid "" "1.23 17 May 2015 ss bug fix" msgstr "" "1.23 17 Μαΐου 2015 ss διόρθωση σφαλμάτων" #. (itstool) path: revhistory/revision #: C/index.docbook:107 msgid "" "1.22 07 May 2015 ss bug fixes, dropping deprecated features" msgstr "" "1.22 07 Μαΐου 2015 ss διορθώσεις σφαλμάτων, απόρριψη παρωχημένων " "λειτουργιών" #. (itstool) path: revhistory/revision #: C/index.docbook:113 msgid "" "1.21 17 Jul 2014 ss bug fixes, dropping deprecated features" msgstr "" "1.21 17 Ιουλ 2013 ss διορθώσεις σφαλμάτων, απόρριψη παρωχημένων " "λειτουργιών" #. (itstool) path: revhistory/revision #: C/index.docbook:119 msgid "" "1.20 16 Feb 2014 ss bug fixes, markdown support, style improvements" msgstr "" "1.20 16 Φεβ 2014 ss διορθώσεις σφαλμάτων, υποστήριξη markdown, και " "βελτιώσεις στυλ" #. (itstool) path: revhistory/revision #: C/index.docbook:125 msgid "" "1.19 05 Jun 2013 ss bug fixes" msgstr "" "1.19 05 Ιουν 2013 ss διόρθωση σφαλμάτων" #. (itstool) path: revhistory/revision #: C/index.docbook:131 msgid "" "1.18 14 Sep 2011 ss bug fixes, speedups, markdown support" msgstr "" "1.18 14 Σεπτ 2011 ss διορθώσεις σφαλμάτων, επιταχύνσεις, υποστήριξη " "markdown" #. (itstool) path: revhistory/revision #: C/index.docbook:137 msgid "" "1.17 26 Feb 2011 sk urgent bug fix update" msgstr "" "1.17 26 Φεβ 2011 sk επείγουσα διόρθωση σφάλματος" #. (itstool) path: revhistory/revision #: C/index.docbook:143 msgid "" "1.16 14 Jan 2011 sk bugfixes, layout improvements" msgstr "" "1.16 14 Ιαν 2011 sk διορθώσεις σφαλμάτων και βελτιώσεις διάταξης" #. (itstool) path: revhistory/revision #: C/index.docbook:149 msgid "" "1.15 21 May 2010 sk bug and regression fixes" msgstr "" "1.15 21 Μαίου 2010 sk διορθώσεις σφαλμάτων και αναδρομής" #. (itstool) path: revhistory/revision #: C/index.docbook:155 msgid "" "1.14 28 March 2010 sk bugfixes and performance improvements" msgstr "" "1.14 28 Μαρτίου 2010 sk διορθώσεις σφαλμάτων και βελτιώσεις επίδοσης" #. (itstool) path: revhistory/revision #: C/index.docbook:161 msgid "" "1.13 18 December 2009 " "sk broken tarball update" msgstr "" "1.13 18 Δεκεμβρίου 2009 " "sk ανανέωση κατεστραμμένου " "συμπιεσμένου αρχείου" #. (itstool) path: revhistory/revision #: C/index.docbook:167 msgid "" "1.12 18 December 2009 " "sk new tool features and " "bugfixes" msgstr "" "1.12 18 Δεκεμβρίου 2009 " "sk νέα χαρακτηριστικά εργαλείων " "και διορθώσεις σφαλμάτων" #. (itstool) path: revhistory/revision #: C/index.docbook:173 msgid "" "1.11 16 November 2008 " "mal GNOME doc-utils migration" msgstr "" "1.11 16 Νοεμβρίου 2008 " "mal Μετάβαση σε GNOME doc-utils" #. (itstool) path: chapter/title #: C/index.docbook:186 msgid "Introduction" msgstr "Εισαγωγή" #. (itstool) path: chapter/para #: C/index.docbook:188 msgid "" "This chapter introduces GTK-Doc and gives an overview of what it is and how " "it is used." msgstr "" "Αυτό το κεφάλαιο αποτελεί μια εισαγωγή στο GTK-Doc. Περιγράφει το GTK-Doc " "και τον τρόπο χρήσης του." #. (itstool) path: sect1/title #: C/index.docbook:194 msgid "What is GTK-Doc?" msgstr "Τι είναι το GTK-Doc;" #. (itstool) path: sect1/para #: C/index.docbook:196 msgid "" "GTK-Doc is used to document C code. It is typically used to document the " "public API of libraries, such as the GTK+ and GNOME libraries. But it can " "also be used to document application code." msgstr "" "Το GTK-Doc χρησιμοποιείται για την τεκμηρίωση κώδικα C. Συνήθως, " "χρησιμοποιείται για την τεκμηρίωση του δημόσιου API βιβλιοθηκών όπως η GTK+ " "και η GNOME. Μπορεί όμως να χρησιμοποιηθεί και για την τεκμηρίωση κώδικα " "εφαρμογών." #. (itstool) path: sect1/title #: C/index.docbook:204 msgid "How Does GTK-Doc Work?" msgstr "Πώς λειτουργεί το GTK-Doc;" #. (itstool) path: sect1/para #: C/index.docbook:206 msgid "" "GTK-Doc works by using documentation of functions placed inside the source " "files in specially-formatted comment blocks, or documentation added to the " "template files which GTK-Doc uses (though note that GTK-Doc will only " "document functions that are declared in header files; it won't produce " "output for static functions)." msgstr "" "Το GTK-Doc χρησιμοποιεί την τεκμηρίωση συναρτήσεων που έχει συμπεριληφθεί " "στα πηγαία αρχεία (εντός μπλοκ σχολίων με ειδική μορφή), ή την τεκμηρίωση " "που έχει προστεθεί στα πρότυπα αρχεία που χρησιμοποιεί το GTK-Doc (σημειώστε " "όμως ότι το GTK-Doc παράγει τεκμηρίωση μόνο για τις συναρτήσεις που " "δηλώνονται σε αρχεία κεφαλίδας· δεν παράγει τεκμηρίωση για στατικές " "συναρτήσεις)." #. (itstool) path: sect1/para #: C/index.docbook:213 msgid "" "GTK-Doc consists of a number of perl scripts, each performing a different " "step in the process." msgstr "" "Το GTK-Doc αποτελείται από μια σειρά δέσμης ενεργειών perl, καθένα από τα " "οποία είναι υπεύθυνο για διαφορετικό στάδιο της όλης διαδικασίας." #. (itstool) path: sect1/para #: C/index.docbook:218 msgid "There are 5 main steps in the process:" msgstr "Η διαδικασία περιλαμβάνει 5 κύρια στάδια:" #. (itstool) path: listitem/para #: C/index.docbook:225 msgid "" "Writing the documentation. The author fills in the " "source files with the documentation for each function, macro, union etc. (In " "the past information was entered in generated template files, which is not " "recommended anymore)." msgstr "" "Συγγραφή της τεκμηρίωσης Ο συγγραφέας συμπληρώνει τα " "πηγαία αρχεία με τεκμηρίωση για όλες τις συναρτήσεις, μακροεντολές, ενώσεις " "κτλ. (Στο παρελθόν, οι πληροφορίες συμπληρώνονταν σε πρότυπα αρχεία που " "παράγονταν αυτόματα, αλλά αυτός ο τρόπος δεν συνιστάται πλέον.)" #. (itstool) path: listitem/para #: C/index.docbook:235 msgid "" "Gathering information about the code. " "gtkdoc-scan scans the header files of the code " "looking for declarations of functions, macros, enums, structs, and unions. " "It creates the file <module>-decl-list.txt " "containing a list of the declarations, placing them into sections according " "to which header file they are in. On the first run this file is copied to " "<module>-sections.txt. The author can rearrange " "the sections, and the order of the declarations within them, to produce the " "final desired order. The second file it generates is <" "module>-decl.txt. This file contains the full declarations " "found by the scanner. If for some reason one would like some symbols to show " "up in the docs, where the full declaration cannot be found by the scanner or " "the declaration should appear differently, one can place entities similar to " "the ones in <module>-decl.txt into <" "module>-overrides.txt." msgstr "" "Συλλέγοντας πληροφορίες για τον κώδικα. Το " "gtkdoc-scan σαρώνει τα αρχεία κεφαλίδων του " "κώδικα ψάχνοντας για δηλώσεις συναρτήσεων, μακροεντολές, enums, δομές και " "ενώσεις. Δημιουργεί το αρχείο <module>-decl-list.txt που περιέχει μια λίστα με τις δηλώσεις, και τις τοποθετεί σε " "ενότητες αναλόγως με το αρχείο κεφαλίδας στο οποίο βρίσκονται. Από την πρώτη " "εκτέλεση του προγράμματος το αρχείο αντιγράφεται στο <" "module>-sections.txt. Ο συγγραφέας μπορεί να τακτοποιεί τις " "ενότητες και τη σειρά των δηλώσεων, για να παραγάγει το επιθυμητό τελικό " "αποτέλεσμα. Το δεύτερο αρχείο δημιουργεί το <module>-decl." "txt. Το αρχείο αυτό περιέχει τις πλήρεις δηλώσεις που βρέθηκαν " "από τον σαρωτή.Αν για κάποιο λόγο θέλετε μερικά σύμβολα να εμφανίζονται στην " "τεκμηρίωση, όπου η πλήρης δήλωση δεν μπορεί να βρεθεί από τον σαρωτή, ή " "πρέπει να εμφανίζεται διαφορετικά, μπορεί κάποιος να τοποθετήσει οντότητες " "παρόμοιες με αυτές <module>-decl.txt στο αρχείο " "<module>-overrides.txt." #. (itstool) path: listitem/para #: C/index.docbook:252 msgid "" "gtkdoc-scangobj can also be used to dynamically " "query a library about any GObject subclasses it exports. It saves " "information about each object's position in the class hierarchy and about " "any GObject properties and signals it provides." msgstr "" "Το gtkdoc-scanobj μπορεί επίσης να χρησιμοποιηθεί " "για να κάνει δυναμική αναζήτηση σε μια βιβλιοθήκη για ενδεχόμενες υποκλάσεις " "GObject. Αποθηκεύει τις πληροφορίες για τη θέση κάθε αντικειμένου στην " "ιεραρχία κλάσεων καθώς και για τις ιδιότητες και σήματα GObject που περιέχει." #. (itstool) path: listitem/para #: C/index.docbook:258 msgid "" "gtkdoc-scanobj should not be used anymore. It was " "needed in the past when GObject was still GtkObject inside gtk+." msgstr "" "Το gtkdoc-scanobj δεν πρέπει να χρησιμοποιείται " "πλέον. Χρειαζόταν στο παρελθόν όταν το GObject ήταν ακόμα GtkObject μέσα στη " "gtk+." #. (itstool) path: listitem/para #: C/index.docbook:265 msgid "" "Generating the \"template\" files. gtkdoc-" "mktmpl creates a number of files in the tmpl/ subdirectory, using the information gathered " "in the first step. (Note that this can be run repeatedly. It will try to " "ensure that no documentation is ever lost.)" msgstr "" "Δημιουργία \"πρότυπων\" αρχείων Το gtkdoc-" "mktmpl παράγει μια σειρά από αρχεία στον υποκατάλογο tmpl/, χρησιμοποιώντας τις πληροφορίες που " "συλλέχθηκαν κατά το πρώτο στάδιο. (Σημειώστε ότι μπορεί να εκτελεσθεί " "περισσότερες από μία φορές. Προσπαθεί να διασφαλίσει ότι δεν χάνεται ποτέ " "και κανενός είδους τεκμηρίωση.)" #. (itstool) path: note/para #: C/index.docbook:274 msgid "" "Since GTK-Doc 1.9 the templates can be avoided. We encourage people to keep " "documentation in the code. gtkdocize supports now " "a option that chooses a makefile that " "skips tmpl usage totally. If you have never changed file in tmpl by hand, " "please remove the directory (e.g. from version control system)." msgstr "" "Από την έκδοση GTK-Doc 1.9 και μετά, τα πρότυπα αρχεία δεν είναι πλέον " "απαραίτητα. Σας συνιστούμε να διατηρείτε την τεκμηρίωση στον κώδικα. Το " "gtkdocize υποστηρίζει πλέον την επιλογή η οποία επιλέγει ένα αρχείο makefile που δεν " "χρησιμοποιεί καθόλου πρότυπα tmpl. Αν δεν έχετε κάνει ποτέ αλλαγές με το " "χέρι σε αρχεία προτύπων tmpl, παρακαλώ αφαιρέστε τον κατάλογο (π.χ. από ένα " "σύστημα ελέγχου εκδόσεων)." #. (itstool) path: listitem/para #: C/index.docbook:286 msgid "" "Generating the XML and HTML/PDF. gtkdoc-" "mkdb turns the template files into XML files in the xml/ subdirectory. If the source code " "contains documentation on functions, using the special comment blocks, it " "gets merged in here. If there are no tmpl files used it only reads docs from " "sources and introspection data." msgstr "" "Δημιουργία του XML και του HTML/PDF. Το " "gtkdoc-mkdb μετατρέπει τα αρχεία προτύπων σε " "αρχεία XML στον υποκατάλογο xml/. " "Αν ο πηγαίος κώδικας περιέχει τεκμηρίωση συναρτήσεων, χρησιμοποιώντας τις " "ειδικές ομάδες σχολίων, συγχωνεύεται εδώ. Αν δεν υπάρχουν χρησιμοποιούμενα " "αρχεία tmpl, διαβάζει μόνο έγγραφα από τα δεδομένα πηγών και αυτοελέγχου." #. (itstool) path: listitem/para #: C/index.docbook:295 msgid "" "gtkdoc-mkhtml turns the XML files into HTML files " "in the html/ subdirectory. Likewise " "gtkdoc-mkpdf turns the XML files into a PDF " "document called <package>.pdf." msgstr "" "Το gtkdoc-mkhtml μετατρέπει τα αρχεία XML σε " "αρχεία HTML στον υποκατάλογο html/. " "Ομοίως, το gtkdoc-mkpdf μετατρέπει τα αρχεία XML " "σε ένα έγγραφο PDF που ονομάζεται <package>.pdf." #. (itstool) path: listitem/para #: C/index.docbook:301 msgid "" "Files in xml/ and html/ directories are always overwritten. One " "should never edit them directly." msgstr "" "Τα αρχεία στους καταλόγους xml/ και " "html/ αντικαθίστανται πάντα. " "Επομένως, δεν πρέπει να τα επεξεργάζεστε απευθείας." #. (itstool) path: listitem/para #: C/index.docbook:309 msgid "" "Fixing up cross-references between documents. After " "installing the HTML files, gtkdoc-fixxref can be " "run to fix up any cross-references between separate documents. For example, " "the GTK+ documentation contains many cross-references to types documented in " "the GLib manual. When creating the source tarball for distribution, " "gtkdoc-rebase turns all external links into web-" "links. When installing distributed (pregenerated) docs the same application " "will try to turn links back to local links (where those docs are installed)." msgstr "" "Διόρθωση διασταυρούμενων παραπομπών μεταξύ εγγράφων " "Μετά την εγκατάσταση των αρχείων HTML, μπορείτε να εκτελέσετε το " "gtkdoc-fixxref για να διορθώσετε τυχόν " "διασταυρούμενες παραπομπές σε διαφορετικά έγγραφα. Για παράδειγμα, η " "τεκμηρίωση του GTK+ περιέχει πολλές παραπομπές σε τύπους που επεξηγούνται " "στο εγχειρίδιο του GLib. Όταν ετοιμάζετε πακέτα κώδικα για διανομή, μπορείτε " "να χρησιμοποιείτε το gtkdoc-rebase για να " "μετατρέπετε όλους τους εξωτερικούς συνδέσμους σε διαδικτυακούς συνδέσμους. " "Κατά την εγκατάσταση της τεκμηρίωσης που περιλαμβάνεται στον διανεμηθέντα " "κώδικα (παράγεται αυτόματα), η ίδια εφαρμογή θα προσπαθήσει να μετατρέψει " "ξανά τους συνδέσμους σε τοπικούς συνδέσμους (προς τις τοποθεσίες όπου είναι " "εγκατεστημένη η τεκμηρίωση)." #. (itstool) path: sect1/title #: C/index.docbook:327 msgid "Getting GTK-Doc" msgstr "Λήψη GTK-Doc" #. (itstool) path: sect2/title #: C/index.docbook:330 msgid "Requirements" msgstr "Απαιτήσεις" #. (itstool) path: sect2/para #: C/index.docbook:331 msgid "Perl v5 - the main scripts are in Perl." msgstr "" "Perl v5 - οι κύριες δέσμες ενεργειών είναι γραμμένες σε " "Perl." #. (itstool) path: sect2/para #: C/index.docbook:334 msgid "" "xsltproc - the xslt processor from libxslt xmlsoft.org/XSLT/" msgstr "" "xsltproc - το πρόγραμμα xslt processor από τη " "βιβλιοθήκη libxslt xmlsoft.org/XSLT/" #. (itstool) path: sect2/para #: C/index.docbook:338 msgid "" "docbook-xsl - the docbook xsl stylesheets sourceforge.net/projects/docbook/files/docbook-xsl" msgstr "" "docbook-xsl - τα φύλλα στυλ docbook xsl sourceforge.net/projects/docbook/files/docbook-xsl" #. (itstool) path: sect2/para #: C/index.docbook:342 msgid "Python - optional - for gtkdoc-depscan" msgstr "Python - προαιρετική - για το gtkdoc-depscan" #. (itstool) path: sect2/para #: C/index.docbook:345 msgid "" "One of source-highlight, highlight " "or vim - optional - used for syntax highlighting of " "examples" msgstr "" "Ένα από τα source-highlight, highlight ή vim - προαιρετικά - που χρησιμοποιούνται " "για την επισήμανση της σύνταξης στα παραδείγματα" #. (itstool) path: sect1/title #: C/index.docbook:353 msgid "About GTK-Doc" msgstr "Περί GTK-Doc" #. (itstool) path: sect1/para #: C/index.docbook:355 C/index.docbook:369 msgid "(FIXME)" msgstr "(ΠΡΟΣ ΔΙΟΡΘΩΣΗ)" #. (itstool) path: sect1/para #: C/index.docbook:359 msgid "" "(History, authors, web pages, mailing list, license, future plans, " "comparison with other similar systems.)" msgstr "" "(Ιστορικό, συγγραφείς, ιστοσελίδες, λίστα αλληλογραφίας, άδεια, μελλοντικά " "σχέδια, σύγκριση με άλλα παρόμοια συστήματα.)" #. (itstool) path: sect1/title #: C/index.docbook:367 msgid "About this Manual" msgstr "Περί του εγχειριδίου" #. (itstool) path: sect1/para #: C/index.docbook:373 msgid "(who it is meant for, where you can get it, license)" msgstr "(σε ποιους απευθύνεται, πού θα το βρείτε, άδεια)" #. (itstool) path: chapter/title #: C/index.docbook:382 msgid "Setting up your project" msgstr "Δημιουργώντας το δικό σας έργο" #. (itstool) path: chapter/para #: C/index.docbook:384 msgid "" "The next sections describe what steps to perform to integrate GTK-Doc into " "your project. Theses sections assume we work on a project called 'meep'. " "This project contains a library called 'libmeep' and an end-user app called " "'meeper'. We also assume you will be using autoconf and automake. In " "addition section plain makefiles or other " "build systems will describe the basics needed to work in a different " "build setup." msgstr "" "Οι επόμενες ενότητες περιγράφουν τα βήματα που απαιτούνται για να " "ενσωματώσετε το GTK-Doc στο έργο σας. Αυτές οι ενότητες προϋποθέτουν ότι " "εργάζεσθε σε ένα έργο που λέγεται 'meep'. Το έργο περιέχει τη βιβλιοθήκη " "'libmeep' και την εφαρμογή 'meeper' για τον τελικό χρήστη. Θεωρούμε επίσης, " "ότι θα χρησιμοποιείτε το autoconf και το automake. Επιπλέον, η ενότητα αρχεία makefiles ή άλλα συστήματα ανάπτυξης θα περιγράψει τα βασικά στοιχεία που απαιτούνται για να εργαστείτε σε " "μια διαφορετική δόμηση ρυθμίσεων." #. (itstool) path: sect1/title #: C/index.docbook:395 msgid "Setting up a skeleton documentation" msgstr "Δημιουργία του σκελετού τεκμηρίωσης" #. (itstool) path: sect1/para #: C/index.docbook:397 msgid "" "Under your top-level project directory create folders called docs/reference " "(this way you can also have docs/help for end-user documentation). It is " "recommended to create another subdirectory with the name of the doc-package. " "For packages with just one library this step is not necessary." msgstr "" "Εντός του ριζικού καταλόγου του έργου δημιουργήστε το φάκελο docs/reference " "(ώστε να μπορείτε να χρησιμοποιήσετε το όνομα docs/help για την τεκμηρίωση " "του τελικού χρήστη). Συνιστάται να δημιουργήσετε έναν ακόμη υποκατάλογο με " "το όνομα του πακέτου τεκμηρίωσης. Αυτό δε χρειάζεται για πακέτα που " "περιλαμβάνουν μόνο μία βιβλιοθήκη." #. (itstool) path: example/title #: C/index.docbook:406 msgid "Example directory structure" msgstr "Παράδειγμα δομής καταλόγου" #. (itstool) path: example/programlisting #: C/index.docbook:407 #, no-wrap msgid "" "\n" "meep/\n" " docs/\n" " reference/\n" " libmeep/\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" msgstr "" "\n" "meep/\n" " docs/\n" " reference/\n" " libmeep/\n" " meeper/\n" " src/\n" " libmeep/\n" " meeper/\n" #. (itstool) path: sect1/para #: C/index.docbook:404 msgid "This can then look as shown below: <_:example-1/>" msgstr "Αυτό θα φαίνεται, λοιπόν, όπως εμφανίζεται παρακάτω: <_:example-1/>" #. (itstool) path: sect1/title #. (itstool) path: example/title #: C/index.docbook:422 C/index.docbook:429 msgid "Integration with autoconf" msgstr "Ενσωμάτωση στο autoconf" #. (itstool) path: sect1/para #: C/index.docbook:424 msgid "" "Very easy! Just add one line to your configure.ac " "script." msgstr "" "Πολύ εύκολα! Απλά προσθέτετε μία γραμμή στη δέσμη ενεργειών " "configure.ac." #. (itstool) path: example/programlisting #: C/index.docbook:430 #, no-wrap msgid "" "\n" "# check for gtk-doc\n" "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n" msgstr "" "\n" "# έλεγχος για gtk-doc\n" "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n" #. (itstool) path: example/title #: C/index.docbook:442 msgid "Keep gtk-doc optional" msgstr "Προαιρετικά διατηρήστε το gtk-doc" #. (itstool) path: example/programlisting #: C/index.docbook:443 #, no-wrap msgid "" "\n" "# check for gtk-doc\n" "m4_ifdef([GTK_DOC_CHECK], [\n" "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n" "],[\n" "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n" "])\n" msgstr "" "\n" "# έλεγχος για gtk-doc\n" "m4_ifdef([GTK_DOC_CHECK], [\n" "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n" "],[\n" "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n" "])\n" #. (itstool) path: sect1/para #: C/index.docbook:437 msgid "" "This will require all developers to have gtk-doc installed. If it is okay " "for your project to have optional api-doc build setup, you can solve this as " "below. Keep it as is, as gtkdocize is looking for GTK_DOC_CHECK at the start of a line. <_:example-1/>" msgstr "" "Αυτό απαιτεί από όλους τους προγραμματιστές να έχουν εγκατεστημένο το gtk-" "doc. Αν είναι εντάξει για το έργο σας να έχετε μια επιπλέον δόμηση ρυθμίσεων " "για το api-doc, μπορείτε να το επιλύσετε όπως αναφέρεται παρακάτω. Αφήστε το " "ως έχει, όσο το gtkdocize αναζητά την αρχή της σειράς για το " "GTK_DOC_CHECK. <_:example-1/>" #. (itstool) path: sect1/para #: C/index.docbook:454 msgid "" "The first argument is used to check for the gtkdocversion at configure time. " "The 2nd, optional argument is used by gtkdocize. " "The GTK_DOC_CHECK macro also adds several configure " "switches:" msgstr "" "Το πρώτο όρισμα χρησιμοποιείται για έλεγχο του gtkdocversion κατά τη " "ρύθμιση. Το δεύτερο, προαιρετικό όρισμα χρησιμοποιείται από το " "gtkdocize. Η μακροεντολή GTK_DOC_CHECK επίσης προσθέτει αρκετούς διακόπτες ρύθμισης:" #. (itstool) path: listitem/para #: C/index.docbook:460 msgid "--with-html-dir=PATH : path to installed docs" msgstr "--with-html-dir= PATH : διαδρομή προς την εγκατεστημένη τεκμηρίωση" #. (itstool) path: listitem/para #: C/index.docbook:461 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]" msgstr "" "--enable-gtk-doc : χρήση gtk-doc για τη δόμηση τεκμηρίωσης [προεπιλογή=no]" #. (itstool) path: listitem/para #: C/index.docbook:462 msgid "" "--enable-gtk-doc-html : build documentation in html format [default=yes]" msgstr "" "--enable-gtk-doc-html : δόμηση τεκμηρίωσης σε μορφή html [προεπιλογή=yes]" #. (itstool) path: listitem/para #: C/index.docbook:463 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]" msgstr "--enable-gtk-doc-pdf : δόμηση τεκμηρίωσης σε μορφή pdf [προεπιλογή=no]" #. (itstool) path: important/para #: C/index.docbook:467 msgid "" "GTK-Doc is disabled by default! Remember to pass the option to the next configure run. " "Otherwise pregenerated documentation is installed (which makes sense for " "users but not for developers)." msgstr "" "Το GTK-Doc είναι απενεργοποιημένο από προεπιλογή! Να θυμάστε να " "χρησιμοποιείτε την επιλογή στην επόμενη " "εκτέλεση του configure. Διαφορετικά, εγκαθίσταται η " "προπαραχθείσα τεκμηρίωση (δυνατότητα χρήσιμη για τον χρήστη, αλλά όχι για " "τον προγραμματιστή)." #. (itstool) path: sect1/para #: C/index.docbook:475 msgid "" "Furthermore it is recommended that you have the following line inside you " "configure.ac script. This allows " "gtkdocize to automatically copy the macro " "definition for GTK_DOC_CHECK to your project." msgstr "" "Επίσης, συνιστάται να προσθέσετε την ακόλουθη γραμμή στη δέσμη ενεργειών " "configure.ac. Αυτό επιτρέπει στο gtkdocize να αντιγράφει αυτόματα τον ορισμό της μακροεντολής για το " "GTK_DOC_CHECK στο έργο σας." #. (itstool) path: example/title #: C/index.docbook:483 msgid "Preparation for gtkdocize" msgstr "Προετοιμασία για το gtkdocize" #. (itstool) path: example/programlisting #: C/index.docbook:484 #, no-wrap msgid "" "\n" "AC_CONFIG_MACRO_DIR(m4)\n" msgstr "" "\n" "AC_CONFIG_MACRO_DIR(m4)\n" #. (itstool) path: sect1/para #: C/index.docbook:489 msgid "" "After all changes to configure.ac are made, update the " "configure file. This can be done by re-running " "autoreconf -i or autogen.sh." msgstr "" "Όταν όλες οι αλλαγές στο configure.ac έχουν γίνει, " "ενημερώστε το αρχείο configure. Αυτό μπορείτε να το " "κάνετε επανεκετελώντας το autoreconf -i ή το autogen.sh." #. (itstool) path: sect1/title #: C/index.docbook:497 msgid "Integration with automake" msgstr "Ενσωμάτωση στο automake" #. (itstool) path: sect1/para #: C/index.docbook:499 msgid "" "First copy the Makefile.am from the examples sub directory of the gtkdoc-sources to your project's API documentation directory ( ./docs/reference/<package>). A local copy " "should be available under e.g. /usr/share/doc/gtk-doc-tools/" "examples/Makefile.am. If you have multiple doc-packages repeat " "this for each one." msgstr "" "Πρώτα αντιγράψτε το Makefile.am από τον υποκατάλογο με " "τα παραδείγματα των gtkdoc-" "sources στον κατάλογο της τεκμηρίωσης API του έργου σας ( ./docs/reference/<package>). Ένα τοπικό " "αντίγραφο θα πρέπει να είναι διαθέσιμο π.χ. στο /usr/share/doc/gtk-" "doc-tools/examples/Makefile.am. Αν έχετε πολλά doc-packages " "επαναλάβετε αυτό το βήμα για το καθένα απο αυτά." #. (itstool) path: sect1/para #: C/index.docbook:510 msgid "" "The next step is to edit the settings inside the Makefile.am. All the settings have a comment above that describes their " "purpose. Most settings are extra flags passed to the respective tools. Every " "tool has a variable of the form . " "All the tools support to list the supported " "parameters." msgstr "" "Το επόμενο βήμα είναι να τροποποιήσετε τις ρυθμίσεις στο Makefile." "am. Πριν από κάθε ρύθμιση υπάρχει ένα σχόλιο που εξηγεί τη " "χρησιμότητά της. Οι περισσότερες είναι σημαίες που στέλνονται στα αντίστοιχα " "εργαλεία. Κάθε εργαλείο διαθέτει μια μεταβλητή της μορφής . Όλα τα εργαλεία υποστηρίζουν την επιλογή " " για την παραγωγή λίστας με τις υποστηριζόμενες " "παραμέτρους." #. (itstool) path: sect1/title #: C/index.docbook:524 msgid "Integration with autogen" msgstr "Ενσωμάτωση στο autogen" #. (itstool) path: sect1/para #: C/index.docbook:526 msgid "" "Most projects will have an autogen.sh script to setup " "the build infrastructure after a checkout from version control system (such " "as cvs/svn/git). GTK-Doc comes with a tool called gtkdocize which can be used in such a script. It should be run before " "autoheader, automake or autoconf." msgstr "" "Τα περισσότερα έργα διαθέτουν ένα σενάριο autogen.sh " "για τη δόμηση υποδομών μετά από έναν έλεγχο από το σύστημα ελέγχου εκδόσεων " "(π.χ., cvs/svn/git). Το GTK-Doc διαθέτει το εργαλείο gtkdocize, το οποίο μπορεί να χρησιμοποιηθεί για ένα τέτοιο σενάριο. Θα " "πρέπει να εκτελείται πριν το autoheader, το automake ή το autoconf." #. (itstool) path: example/title #: C/index.docbook:535 msgid "Running gtkdocize from autogen.sh" msgstr "Εκτέλεση του gtkdocize από το autogen.sh" #. (itstool) path: example/programlisting #: C/index.docbook:536 #, no-wrap msgid "" "\n" "gtkdocize || exit 1\n" msgstr "" "\n" "gtkdocize || exit 1\n" #. (itstool) path: sect1/para #: C/index.docbook:542 msgid "" "When running gtkdocize it copies gtk-" "doc.make to your project root (or any directory specified by the " " option). It also checks you configure script for " "the GTK_DOC_CHECK invocation. This macro can be used to " "pass extra parameters to gtkdocize." msgstr "" "Κατά την εκτέλεσή του, το gtkdocize αντιγράφει το " "gtk-doc.make στο ριζικό κατάλογο του έργου σας (ή στον " "κατάλογο που ορίζει η επιλογή ). Επίσης, ελέγχει τη " "δέσμη ενεργειών configure για να βρει την κλήση στο GTK_DOC_CHECK." #. (itstool) path: sect1/para #: C/index.docbook:551 msgid "" "Historically GTK-Doc was generating template files where developers entered " "the docs. This turned out to be not so good (e.g. the need for having " "generated files under version control). Since GTK-Doc 1.9 the tools can get " "all the information from source comments and thus the templates can be " "avoided. We encourage people to keep documentation in the code. " "gtkdocize supports now a option that chooses a makefile that skips tmpl usage totally. " "Besides adding the option directly to the command invocation, they can be " "added also to an environment variable called GTKDOCIZE_FLAGS or set as a 2nd parameter in GTK_DOC_CHECK macro in " "the configure script. If you have never changed file in tmpl by hand and " "migrating from older gtkdoc versions, please remove the directory (e.g. from " "version control system)." msgstr "" "Αρχικά, το GTK-Doc δημιουργούσε αρχεία προτύπων εκεί που οι προγραμματιστές " "εισήγαγαν την τεκμηρίωση. Δυστυχώς, αυτή η προσέγγιση δεν ήταν ιδιαίτερα " "επιτυχής (π.χ η ανάγκη για παραγωγή αρχείων στο σύστημα ελέγχου εκδόσεων). " "Από την έκδοση 1.9 και μετά, τα πρότυπα αρχεία δεν είναι πλέον απαραίτητα. " "Σας συνιστούμε να διατηρείτε την τεκμηρίωση στον κώδικα. To " "gtkdocize υποστηρίζει πλέον την επιλογή που επιλέγει ένα αρχείο makefile που δεν " "χρησιμοποιεί καθόλου πρότυπα tmpl. Πέρα από την άμεση προσθήκη της επιλογής " "στην κλήση της εντολής, μπορεί να προστεθεί και σε μια μεταβλητή " "περιβάλλοντος που ονομάζεται GTKDOCIZE_FLAGS ή να ορισθεί " "ως δεύτερη παράμετρος στη μακροεντολή GTK_DOC_CHECK στο " "σενάριο configure. Αν δεν έχετε κάνει ποτέ αλλαγές με το χέρι σε αρχεία " "προτύπων και μεταβαίνετε από μια παλιότερη έκδοση του gtkdoc, παρακαλώ " "αφαιρέστε τον κατάλογο (π.χ. από το σύστημα ελέγχου εκδόσεων)." #. (itstool) path: sect1/title #. (itstool) path: example/title #: C/index.docbook:568 C/index.docbook:585 msgid "Running the doc build" msgstr "Εκτέλεση της δόμησης τεκμηρίωσης" #. (itstool) path: sect1/para #: C/index.docbook:570 msgid "" "After the previous steps it's time to run the build. First we need to rerun " "autogen.sh. If this script runs configure for you, then " "give it the option. Otherwise manually run " "configure with this option afterwards." msgstr "" "Αφού ολοκληρωθούν τα προηγούμενα βήματα, προχωρήστε στην δόμηση. Πρώτα, θα " "πρέπει να εκτελεσθεί εκ νέου το autogen.sh. Αν το " "σενάριο εκτελεί και το configure, προσθέστε την επιλογή . Διαφορετικά, εκτελέστε εσείς τοconfigure " "με αυτή την επιλογή." #. (itstool) path: sect1/para #: C/index.docbook:577 msgid "" "The first make run generates several additional files in the doc-" "directories. The important ones are: <package>.types, <package>-docs.xml (in the past ." "sgml), <package>-sections.txt." msgstr "" "Η πρώτη εκτέλεση του make δημιουργεί μια σειρά από πρόσθετα αρχεία στους " "καταλόγους της τεκμηρίωσης. Τα σημαντικά είναι τα: <package>." "types, <package>-docs.xml (στο " "παρελθόν .sgml), <package>-sections.txt." #. (itstool) path: example/programlisting #: C/index.docbook:586 #, no-wrap msgid "" "\n" "./autogen.sh --enable-gtk-doc\n" "make\n" msgstr "" "\n" "./autogen.sh --enable-gtk-doc\n" "make\n" #. (itstool) path: sect1/para #: C/index.docbook:592 msgid "" "Now you can point your browser to docs/reference/<package>/" "index.html. Yes, it's a bit disappointing still. But hang-on, " "during the next chapter we tell you how to fill the pages with life." msgstr "" "Τώρα, μπορείτε να εμφανίσετε το docs/reference/<package>/" "index.html στον περιηγητή σας. Είναι αλήθεια ότι προς το παρόν το " "αποτέλεσμα είναι μάλλον απογοητευτικό. Μην ανησυχείτε όμως. Στο επόμενο " "κεφάλαιο θα μάθετε πώς μπορείτε να ζωντανέψετε τις σελίδες σας." #. (itstool) path: sect1/title #: C/index.docbook:600 msgid "Integration with version control systems" msgstr "Ενσωμάτωση σε συστήματα ελέγχου εκδόσεων" #. (itstool) path: sect1/para #: C/index.docbook:602 msgid "" "As a rule of thumb, it's the files you edit which should go under version " "control. For typical projects it's these files: <package>." "types, <package>-docs.xml (in the " "past .sgml), <package>-sections.txt, " "Makefile.am." msgstr "" "Ο εμπειρικός κανόνας είναι ότι αυτά τα αρχεία που επεξεργασθήκατε πρέπει να " "περάσουν από τον έλεγχο έκδοσης. Για τυπικά έργα, πρόκειται για τα αρχεία: " "<package>.types, <package>-docs." "xml (στο παρελθόν .sgml), <package>-sections.txt, Makefile.am." #. (itstool) path: sect1/para #: C/index.docbook:610 msgid "" "Files in the xml/ and html/ " "directories should not go under version control. Neither should any of the " ".stamp files." msgstr "" "Αρχεία στους καταλόγους xml/ και html/ δεν θα πρέπει να υποβληθούν σε έλεγχο έκδοσης. Ούτε και αρχεία " "xml/ and html/." #. (itstool) path: sect1/title #: C/index.docbook:618 msgid "Integration with plain makefiles or other build systems" msgstr "Ενσωμάτωση στα αρχεία makefiles ή άλλα συστήματα δόμησης" #. (itstool) path: sect1/para #: C/index.docbook:620 msgid "" "In the case one does not want to use automake and therefore gtk-" "doc.mak one will need to call the gtkdoc tools in the right order " "in own makefiles (or other build tools)." msgstr "" "Στην περίπτωση που κάποιος δε θέλει να χρησιμοποιήσει το automake και, " "επομένως, το gtk-doc.mak θα χρειαστεί να καλέσει τα " "εργαλεία του gtkdoc στη σωστή σειρά στα makefiles (ή άλλα εργαλεία δόμησης)." #. (itstool) path: example/title #: C/index.docbook:627 msgid "Documentation build steps" msgstr "Βήματα δόμησης τεκμηρίωσης" #. (itstool) path: example/programlisting #: C/index.docbook:628 #, no-wrap msgid "" "\n" "DOC_MODULE=meep\n" "// sources have changed\n" "gtkdoc-scan --module=$(DOC_MODULE) <source-dir>\n" "gtkdoc-scangobj --module=$(DOC_MODULE)\n" "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=<source-dir>\n" "// xml files have changed\n" "mkdir html\n" "cd html && gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n" "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n" msgstr "" "\n" "DOC_MODULE=meep\n" "// sources have changed\n" "gtkdoc-scan --module=$(DOC_MODULE) --source-dir=...\n" "gtkdoc-scangobj --module=$(DOC_MODULE)\n" "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml\n" "// xml files have changed\n" "mkdir html\n" "cd html && gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n" "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n" #. (itstool) path: sect1/para #: C/index.docbook:642 msgid "" "One will need to look at the Makefile.am and " "gtk-doc.mak to pick the extra options needed." msgstr "" "Πρέπει να κοιτάξετε στα αρχεία Makefile.am και " "gtk-doc.mak για να επιλέξετε τις ρυθμίσεις που " "χρειάζονται." #. (itstool) path: sect1/title #: C/index.docbook:649 msgid "Integration with CMake build systems" msgstr "Ενσωμάτωση με συστήματα δόμησης CMake" #. (itstool) path: sect1/para #: C/index.docbook:651 msgid "" "GTK-Doc now provides a GtkDocConfig.cmake module (and " "the corresponding GtkDocConfigVersion.cmake module). " "This provides a gtk_doc_add_module command that you can " "set in your CMakeLists.txt file." msgstr "" "Το GTK-Doc παρέχει το άρθρωμα GtkDocConfig.cmake (και " "το αντίστοιχο άρθρωμα GtkDocConfigVersion.cmake). " "Επίσης παρέχει την εντολή gtk_doc_add_module την οποία " "μπορείτε να ορίσετε στο αρχείο CMakeLists.txt." #. (itstool) path: example/title #: C/index.docbook:661 msgid "Example of using GTK-Doc from CMake" msgstr "Παράδειγμα χρήσης του GTK-Doc από το CMake" #. (itstool) path: example/programlisting #: C/index.docbook:662 #, no-wrap msgid "" "\n" "find_package(GtkDoc 1.25 REQUIRED)\n" "\n" "# Create the doc-libmeep target.\n" "gtk_doc_add_module(\n" " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n" " XML meep-docs.xml\n" " LIBRARIES libmeep\n" ")\n" "\n" "# Build doc-libmeep as part of the default target. Without this, you would\n" "# have to explicitly run something like `make doc-libmeep` to build the docs.\n" "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n" "\n" "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n" "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n" "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n" " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n" msgstr "" "\n" "find_package(GtkDoc 1.25 REQUIRED)\n" "\n" "# Create the doc-libmeep target.\n" "gtk_doc_add_module(\n" " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n" " XML meep-docs.xml\n" " LIBRARIES libmeep\n" ")\n" "\n" "# Build doc-libmeep as part of the default target. Without this, you would\n" "# have to explicitly run something like `make doc-libmeep` to build the docs.\n" "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n" "\n" "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n" "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n" "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n" " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n" #. (itstool) path: sect1/para #: C/index.docbook:659 msgid "The following example shows how to use this command. <_:example-1/>" msgstr "" "Το ακόλουθο παράδειγμα δείχνει πως να χρησιμοποιήσετε την εντολή. <_:" "example-1/>" #. (itstool) path: chapter/title #: C/index.docbook:687 msgid "Documenting the code" msgstr "Τεκμηρίωση κώδικα" #. (itstool) path: chapter/para #: C/index.docbook:689 msgid "" "GTK-Doc uses source code comment with a special syntax for code " "documentation. Further it retrieves information about your project structure " "from other sources. During the next section you will find all information " "about the syntax of the comments." msgstr "" "Το GTK-Doc χρησιμοποιεί σχόλια με ειδική σύνταξη για την προσθήκη " "τεκμηρίωσης στον κώδικα. Παράλληλα, ανακαλεί πληροφορίες για τη δομή του " "έργου σας από άλλες πηγές. Στην επόμενη ενότητα περιέχονται όλες οι " "λεπτομέρειες για τη σύνταξη αυτών των σχολίων." #. (itstool) path: note/title #: C/index.docbook:697 msgid "Documentation placement" msgstr "Τοποθέτηση τεκμηρίωσης" #. (itstool) path: note/para #: C/index.docbook:698 msgid "" "In the past most documentation had to be filled into files residing inside " "the tmpl directory. This has the disadvantages that the " "information is often not updated and also that the file tend to cause " "conflicts with version control systems." msgstr "" "Στο παρελθόν, η τεκμηρίωση έπρεπε να συμπληρώνεται σε αρχεία του καταλόγου " "tmpl. Αυτή η προσέγγιση εμφανίζει το μειονέκτημα ότι οι " "πληροφορίες δεν ενημερώνονται συχνά, καθώς και το ότι προκύπτουν περιοδικές " "συγκρούσεις με τα συστήματα ελέγχου εκδόσεων." #. (itstool) path: note/para #: C/index.docbook:704 msgid "" "The avoid the aforementioned problems we suggest putting the documentation " "inside the sources. This manual will only describe this way of documenting " "code." msgstr "" "Για να αποφύγετε αυτά τα προβλήματα, σας προτείνουμε να ενσωματώνετε την " "τεκμηρίωση στον πηγαίο κώδικα. Αυτή είναι και η μόνη μέθοδος που θα " "περιγράψουμε σε αυτό το εγχειρίδιο." #. (itstool) path: example/title #: C/index.docbook:715 C/index.docbook:741 msgid "GTK-Doc comment block" msgstr "Μπλοκ σχολίου GTK-Doc" #. (itstool) path: example/programlisting #: C/index.docbook:716 #, no-wrap msgid "" "\n" "#ifndef __GTK_DOC_IGNORE__\n" "/* unparseable code here */\n" "#endif\n" msgstr "" "\n" "#ifndef __GTK_DOC_IGNORE__\n" "/* unparseable code here */\n" "#endif\n" #. (itstool) path: chapter/para #: C/index.docbook:711 msgid "" "The scanner can handle the majority of C headers fine. In the case of " "receiving warnings from the scanner that look like a special case, one can " "hint GTK-Doc to skip over them. <_:example-1/>" msgstr "" "Ο σαρωτής μπορεί να χειρισθεί άνετα την πλειοψηφία των κεφαλίδων C. Σε " "περίπτωση που παίρνετε προειδοποιήσεις από τον σαρωτή οι οποίες μοιάζουν με " "έναν ειδικό χαρακτήρα, μπορείτε να υποδείξετε στο GTK-Doc να τους " "παραλείψει. <_:example-1/>" #. (itstool) path: note/title #: C/index.docbook:725 msgid "Limitations" msgstr "Περιορισμοί" #. (itstool) path: note/para #: C/index.docbook:726 msgid "" "Note, that GTK-Doc's supports #ifndef(__GTK_DOC_IGNORE__) but " "not #if !defined(__GTK_DOC_IGNORE__) or other combinations." msgstr "" "Σημειώστε, ότι το GTK-Doc υποστηρίζει το #ifndef(__GTK_DOC_IGNORE__), αλλά όχι το #if !defined(__GTK_DOC_IGNORE__) ή άλλους " "συνδυασμούς." #. (itstool) path: sect1/title #: C/index.docbook:736 msgid "Documentation comments" msgstr "Σχόλια τεκμηρίωσης" #. (itstool) path: example/programlisting #: C/index.docbook:742 #, no-wrap msgid "" "\n" "/**\n" " * identifier:\n" " * documentation ...\n" " */\n" msgstr "" "\n" "/**\n" " * identifier:\n" " * documentation ...\n" " */\n" #. (itstool) path: sect1/para #: C/index.docbook:738 msgid "" "A multiline comment that starts with an additional '*' marks a documentation " "block that will be processed by the GTK-Doc tools. <_:example-1/>" msgstr "" "Ένα σχόλιο πολλαπλών γραμμών που διαθέτει ένα επιπλέον «*» στην αρχή " "αποτελεί ένα μπλοκ τεκμηρίωσης που λαμβάνεται υπόψη από τα εργαλεία του GTK-" "Doc. <_:example-1/>" #. (itstool) path: sect1/para #: C/index.docbook:751 msgid "" "The 'identifier' is one line with the name of the item the comment is " "related to. The syntax differs a little depending on the item. (TODO add " "table showing identifiers)" msgstr "" "Το 'αναγνωριστικό' είναι μία γραμμή που περιέχει το όνομα του στοιχείου στο " "οποίο αναφέρεται το σχόλιο. Η σύνταξή του εξαρτάται από τον τύπο του " "στοιχείου. (ΜΕΛΛΟΝΤΙΚΑ: να προστεθεί πίνακας με τα αναγνωριστικά)" #. (itstool) path: sect1/para #: C/index.docbook:757 msgid "" "The 'documentation' block is also different for each symbol type. Symbol " "types that get parameters such as functions or macros have the parameter " "description first followed by a blank line (just a '*'). Afterwards follows " "the detailed description. All lines (outside program listings and CDATA " "sections) just containing a ' *' (blank-asterisk) are converted to paragraph " "breaks. If you don't want a paragraph break, change that into ' * ' (blank-" "asterisk-blank-blank). This is useful in preformatted text (code listings)." msgstr "" "Η ομάδα 'τεκμηρίωσης' επίσης διαφέρει ανάλογα με τον τύπο συμβόλου. Για τους " "τύπους συμβόλων που δέχονται παραμέτρους όπως συναρτήσεις ή μακροεντολές " "προηγείται η περιγραφή των παραμέτρων και ακολουθεί μια κενή γραμμή (μόνο " "'*'). Ακολουθεί η λεπτομερής περιγραφή. Όλες οι γραμμές (εκτός από τις " "λίστες προγράμματος και τις ενότητες CDATA) που περιέχουν μόνο ένα ' " "*' (διάστημα-αστερίσκο) μετατρέπονται σε αλλαγές παραγράφου. Αν δεν " "επιθυμείτε αλλαγή παραγράφου, αλλάξτε το σε ' * ' (διάστημα-αστερίσκος-" "διάστημα-διάστημα). Αυτό είναι χρήσιμο σε προδιαμορφωμένο κείμενο (λίστες " "κώδικα)." #. (itstool) path: listitem/para #: C/index.docbook:774 msgid "" "What it is: The name for a class or function can sometimes be misleading for " "people coming from a different background." msgstr "" "Τι είναι: Το όνομα της κλάσης ή της συνάρτησης μπορεί μερικές φορές να είναι " "παραπλανητικό για ανθρώπους που δεν έχουν τεχνογνωσία στο θέμα." #. (itstool) path: listitem/para #: C/index.docbook:780 msgid "" "What it does: Tell about common uses. Put it in relation with the other API." msgstr "" "Τι κάνει: Αναφέρει τις κοινές χρήσεις και τις βάζει σε σχέση με άλλο API." #. (itstool) path: tip/para #: C/index.docbook:770 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>" msgstr "Όταν τεκμηριώνετε κώδικα, περιγράψτε δύο πλευρές: <_:itemizedlist-1/>" #. (itstool) path: listitem/para #: C/index.docbook:795 msgid "Use function() to refer to functions or macros which take arguments." msgstr "" "Χρησιμοποιήστε το function() για να αναφερθείτε σε συναρτήσεις ή " "μακροεντολές που δέχονται ορίσματα." #. (itstool) path: listitem/para #: C/index.docbook:800 msgid "" "Use @param to refer to parameters. Also use this when referring to " "parameters of other functions, related to the one being described." msgstr "" "Χρησιμοποιήστε το @param για να αναφερθείτε σε παραμέτρους. Επίσης, " "χρησιμοποιήστε αυτή τη γραφή για να αναφερθείτε σε παραμέτρους άλλων " "συναρτήσεων, σχετικών με την περιγραφόμενη." #. (itstool) path: listitem/para #: C/index.docbook:806 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS." msgstr "" "Χρησιμοποιήστε το %constant για να αναφερθείτε σε σταθερές, π.χ. " "%G_TRAVERSE_LEAFS." #. (itstool) path: listitem/para #: C/index.docbook:811 msgid "" "Use #symbol to refer to other types of symbol, e.g. structs and enums and " "macros which don't take arguments." msgstr "" "Χρησιμοποιήστε το #symbol για να αναφερθείτε σε άλλους τύπους συμβόλων, π.χ. " "δομές, αριθμήσεις και μακροεντολές που δε δέχονται ορίσματα." #. (itstool) path: listitem/para #: C/index.docbook:817 msgid "Use #Object::signal to refer to a GObject signal." msgstr "" "Χρησιμοποιήστε το #Object::signal για να αναφερθείτε σε ένα σήμα GObject." #. (itstool) path: listitem/para #: C/index.docbook:822 msgid "Use #Object:property to refer to a GObject property." msgstr "" "Χρησιμοποιήστε το #Object::property για να αναφερθείτε σε μία ιδιότητα " "GObject." #. (itstool) path: listitem/para #: C/index.docbook:827 msgid "" "Use #Struct.field to refer to a field inside a structure and #GObjectClass." "foo_bar() to refer to a vmethod." msgstr "" "Χρησιμοποιήστε το #Struct.field για να αναφερθείτε σε ένα πεδίο μέσα σε μια " "δομή και #GObjectClass.foo_bar() για να αναφερθείτε σε μια vmethod." #. (itstool) path: sect1/para #: C/index.docbook:789 msgid "" "One advantage of hyper-text over plain-text is the ability to have links in " "the document. Writing the correct markup for a link can be tedious though. " "GTK-Doc comes to help by providing several useful abbreviations. <_:" "itemizedlist-1/>" msgstr "" "Ένα πλεονέκτημα της χρήσης υπερκειμένου αντί για απλό κείμενο, είναι η " "δυνατότητα προσθήκης συνδέσμων στο έγγραφο. Ωστόσο, η συγγραφή της σωστής " "επισήμανσης για έναν σύνδεσμο μπορεί να είναι αρκετά κουραστική διαδικασία. " "Το GTK-Doc σας βοηθάει, παρέχοντάς σας μια σειρά από χρήσιμες συντομεύσεις. " "<_:itemizedlist-1/>" #. (itstool) path: tip/para #: C/index.docbook:836 msgid "" "If you need to use the special characters '<', '>', '()', '@', '%', or " "'#' in your documentation without GTK-Doc changing them you can use the XML " "entities \"&lt;\", \"&gt;\", \"&lpar;\", \"&rpar;\", \"&" "commat;\", \"&percnt;\" and \"&num;\" respectively or escape them " "with a backslash '\\'." msgstr "" "Αν θέλετε να χρησιμοποιήσετε τους ειδικούς χαρακτήρες «<», «>», «()», " "«@», «%» ή «#» στην τεκμηρίωση, χωρίς να φοβάστε ότι θα τους αλλάξει το GTK-" "Doc, μπορείτε να χρησιμοποιήσετε τις οντότητες XML «&lt;», «&gt;», " "«&lpar;», «&rpar;», «&commat;», «&percnt;» και «&num;», " "αντίστοιχα, ή να χρησιμοποιήσετε την ανάποδη κάθετο «\\» ως χαρακτήρα " "διαφυγής." #. (itstool) path: sect1/para #: C/index.docbook:845 msgid "" "DocBook can do more than just links. One can also have lists, examples, " "headings, and images. As of version 1.20, the preferred way is to use a " "subset of the basic text formatting syntax called Markdown. On older GTK-Doc " "versions any documentation that includes Markdown will be rendered as is. " "For example, list items will appear as lines starting with a dash." msgstr "" "Το DocBook μπορεί να κάνει παραπάνω από απλούς συνδέσμους. Μπορεί κάποιος να " "έχει και λίστες, παραδείγματα, κεφαλίδες και εικόνες. Από την έκδοση 1.20 " "και μετά, ο προτιμώμενος τρόπος είναι με τη χρήση ενός υποσυνόλου της " "βασικής σύνταξης για μορφοποίηση κειμένου που ονομάζεται Markdown. Σε παλιότερες " "εκδόσεις GTK-Doc οποιαδήποτε τεκμηρίωση που περιλαμβάνει Markdown θα " "αποδίδεται ως έχει. Για παράδειγμα, οι καταχωρήσεις της λίστας θα " "εμφανίζονται σαν γραμμές που αρχίζουν με μια παύλα." #. (itstool) path: sect1/para #: C/index.docbook:856 msgid "" "While markdown is now preferred one can mix both. One limitation here is " "that one can use docbook xml within markdown, but markdown within docbook " "xml is not supported." msgstr "" "Αν και τώρα προτιμάται η Markdown μπορεί κάποιος να αναμείξει και τις δύο. " "Ένας περιορισμός εδώ είναι ότι κάποιος μπορεί να χρησιμοποιήσει το docbook " "xml μέσα στο markdown, αλλά το markdown μέσα στο docbook xml δεν " "υποστηρίζεται." #. (itstool) path: sect1/para #: C/index.docbook:862 msgid "" "In older GTK-Doc releases, if you need support for additional formatting, " "you would need to enable the usage of docbook XML tags inside doc-comments " "by putting (or ) in " "the variable MKDB_OPTIONS inside Makefile.am." msgstr "" "Σε παλιότερες εκδόσεις του GTK-Doc, αν χρειάζεστε υποστήριξη για πρόσθετη " "μορφοποίηση, θα πρέπει να ενεργοποιήσετε τη χρήση των ετικετών docbook XML " "μέσα στα doc-comments θέτοντας το (ή το " ") στη μεταβλητή MKDB_OPTIONS " "μέσα στο Makefile.am." #. (itstool) path: example/title #: C/index.docbook:871 msgid "GTK-Doc comment block using Markdown" msgstr "Μπλοκ σχολίου GTK-Doc χρησιμοποιώντας Markdown" #. (itstool) path: example/programlisting #: C/index.docbook:872 #, no-wrap msgid "" "\n" "/**\n" " * identifier:\n" " *\n" " * documentation paragraph ...\n" " *\n" " * # Sub Heading #\n" " *\n" " * ## Second Sub Heading\n" " *\n" " * # Sub Heading With a Link Anchor # {#heading-two}\n" " *\n" " * more documentation:\n" " *\n" " * - list item 1\n" " *\n" " * Paragraph inside a list item.\n" " *\n" " * - list item 2\n" " *\n" " * 1. numbered list item\n" " *\n" " * 2. another numbered list item\n" " *\n" " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n" " *\n" " * ![an inline image](plot-result.png)\n" " *\n" " * [A link to the heading anchor above][heading-two]\n" " *\n" " * A C-language example:\n" " * |[<!-- language=\"C\" -->\n" " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n" " * ]|\n" " */\n" msgstr "" "\n" "/**\n" " * ταυτοποιητής:\n" " *\n" " * παράγραφος τεκμηρίωσης ...\n" " *\n" " * # Δευτερεύουσα επικεφαλίδα #\n" " *\n" " * ## Δεύτερη δευτερεύουσα επικεφαλίδα\n" " *\n" " * # Δευτερεύουσα επικεφαλίδα με μια άγκυρα συνδέσμου # {#επικεφαλίδα-δύο}\n" " *\n" " * περισσότερη τεκμηρίωση:\n" " *\n" " * - στοιχείο 1 καταλόγου\n" " *\n" " * Παράγραφος μέσα σε ένα στοιχείο καταλόγου.\n" " *\n" " * - στοιχείο καταλόγου 2\n" " *\n" " * 1. αριθμημένο στοιχείο καταλόγου\n" " *\n" " * 2. άλλο αριθμημένο στοιχείο καταλόγου\n" " *\n" " * Μια άλλη παράγραφος. [Ένας σύνδεσμος στην ιστοσελίδα GNOME](http://www.gnome.org/)\n" " *\n" " * ![μια ενσωματωμένη εικόνα ](plot-result.png)\n" " *\n" " * [Ένας σύνδεσμος στην από πάνω άγκυρα επικεφαλίδας][επικεφαλίδα-δύο]\n" " *\n" " * Ένα παράδειγμα γλώσσας C:\n" " * |[<!-- language=\"C\" -->\n" " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n" " * ]|\n" " */\n" #. (itstool) path: sect1/para #: C/index.docbook:911 msgid "" "More examples of what markdown tags are supported can be found in the GTK+ Documentation Markdown Syntax Reference." msgstr "" "Μπορείτε να βρείτε περισσότερα παραδείγματα για το ποιες ετικέτες markdown " "υποστηρίζονται στη διεύθυνση GTK+ Documentation Markdown Syntax " "Reference." #. (itstool) path: tip/para #: C/index.docbook:917 msgid "" "As already mentioned earlier GTK-Doc is for documenting public API. Thus one " "cannot write documentation for static symbols. Nevertheless it is good to " "comment those symbols too. This helps other to understand you code. " "Therefore we recommend to comment these using normal comments (without the " "2nd '*' in the first line). If later the function needs to be made public, " "all one needs to do is to add another '*' in the comment block and insert " "the symbol name at the right place inside the sections file." msgstr "" "Όπως αναφέρθηκε και προηγουμένως το GTK-Doc στοχεύει στην τεκμηρίωση του " "δημόσιου API. Άρα, δεν μπορεί κάποιος να γράψει τεκμηρίωση για στατικά " "σύμβολα. Παρόλα αυτά, συνιστάται ο σχολιασμός και αυτών των συμβόλων, γιατί " "βοηθά στην κατανόηση του κώδικα. Σας προτείνουμε λοιπόν να τα σχολιάζετε " "χρησιμοποιώντας κανονικά σχόλια (χωρίς το δεύτερο «*» στην πρώτη γραμμή). Αν " "αργότερα χρειαστεί να μετατραπεί η συνάρτηση σε δημόσια, το μόνο που θα " "πρέπει να γίνει είναι να προστεθεί άλλο ένα «*» στο μπλοκ του σχολίου, και " "να εισαχθεί το όνομα του συμβόλου στην κατάλληλη θέση του αρχείου ενοτήτων." #. (itstool) path: sect1/title #: C/index.docbook:931 msgid "Documenting sections" msgstr "Τεκμηρίωση ενοτήτων" #. (itstool) path: sect1/para #: C/index.docbook:933 msgid "" "Each section of the documentation contains information about one class or " "module. To introduce the component one can write a section block. The short " "description is also used inside the table of contents. All the @fields are " "optional." msgstr "" "Κάθε ενότητα της τεκμηρίωσης περιέχει πληροφορίες για μια κλάση ή ένα " "άρθρωμα. Για να εισάγετε το συστατικό μπορείτε να γράψετε ένα μπλοκ σχολίου " "ενότητας. Η σύντομη αυτή περιγραφή χρησιμοποιείται και για τον πίνακα " "περιεχομένων. Όλα τα πεδία @fields είναι προαιρετικά." #. (itstool) path: example/title #: C/index.docbook:941 msgid "Section comment block" msgstr "Μπλοκ σχολίου ενότητας" #. (itstool) path: example/programlisting #: C/index.docbook:942 #, no-wrap msgid "" "\n" "/**\n" " * SECTION:meepapp\n" " * @short_description: the application class\n" " * @title: Meep application\n" " * @section_id:\n" " * @see_also: #MeepSettings\n" " * @stability: Stable\n" " * @include: meep/app.h\n" " * @image: application.png\n" " *\n" " * The application class handles ...\n" " */\n" msgstr "" "\n" "/**\n" " * SECTION:meepapp\n" " * @short_description: the application class\n" " * @title: Meep application\n" " * @section_id:\n" " * @see_also: #MeepSettings\n" " * @stability: Stable\n" " * @include: meep/app.h\n" " * @image: application.png\n" " *\n" " * The application class handles ...\n" " */\n" #. (itstool) path: varlistentry/term #: C/index.docbook:961 msgid "SECTION:<name>" msgstr "SECTION:<name>" #. (itstool) path: listitem/para #: C/index.docbook:963 msgid "" "The name links the section documentation to the respective part in the " "<package>-sections.txt file. The name give here " "should match the <FILE> tag in the <package>-sections." "txt file." msgstr "" "Το name συνδέει την τεκμηρίωση της ενότητας με το αντίστοιχο μέρος στο " "αρχείο <package>-sections.txt. Το όνομα που " "δίνεται εδώ πρέπει να ταιριάζει με την ετικέτα <FILE> στο αρχείο " "<package>-sections.txt." #. (itstool) path: varlistentry/term #: C/index.docbook:972 msgid "@short_description" msgstr "@short_description" #. (itstool) path: listitem/para #: C/index.docbook:974 msgid "" "A one line description of the section, that later will appear after the " "links in the TOC and at the top of the section page." msgstr "" "Περιγραφή της ενότητας σε μια γραμμή, η οποία θα εμφανίζεται, στη συνέχεια, " "μετά από τους συνδέσμους του πίνακα περιεχομένων και στην αρχή της σελίδας " "της ενότητας." #. (itstool) path: varlistentry/term #: C/index.docbook:981 msgid "@title" msgstr "@title" #. (itstool) path: listitem/para #: C/index.docbook:983 msgid "" "The section title defaults to <name> from the SECTION declaration. It " "can be overridden with the @title field." msgstr "" "Ο τίτλος της ενότητας από προεπιλογή έχει όνομα <name> από τη δήλωση " "SECTION. Μπορεί να παρακαμφθεί με το πεδίο @title." #. (itstool) path: varlistentry/term #: C/index.docbook:990 msgid "@section_id" msgstr "@section_id" #. (itstool) path: listitem/para #: C/index.docbook:992 msgid "" "Overrides the use of title as a section identifier. For GObjects the <" "title> is used as a section_id and for other sections it is <" "MODULE>-<title>." msgstr "" "Παρακάμπτει τη χρήση του τίτλου ως αναγνωριστικό της ενότητας. Για " "αντικείμενα GOBject το <title> χρησιμοποιείται ως section_id και για " "άλλες ενότητες είναι <MODULE>-<title>." #. (itstool) path: varlistentry/term #: C/index.docbook:1000 msgid "@see_also" msgstr "@see_also" #. (itstool) path: listitem/para #: C/index.docbook:1002 msgid "A list of symbols that are related to this section." msgstr "Λίστα συμβόλων σχετικών με αυτή την ενότητα." #. (itstool) path: varlistentry/term #: C/index.docbook:1008 msgid "@stability" msgstr "@stability" #. (itstool) path: listitem/para #: C/index.docbook:1015 msgid "" "Stable - The intention of a Stable interface is to enable arbitrary third " "parties to develop applications to these interfaces, release them, and have " "confidence that they will run on all minor releases of the product (after " "the one in which the interface was introduced, and within the same major " "release). Even at a major release, incompatible changes are expected to be " "rare, and to have strong justifications." msgstr "" "Σταθερή - Μια σταθερή διεπαφή επιτρέπει σε τρίτους να αναπτύσσουν εφαρμογές " "για τις διεπαφές αυτές, να τις δημοσιεύουν και να είναι βέβαιοι ότι οι " "εφαρμογές θα τρέχουν σε όλες τις ελάσσονες εκδόσεις του προϊόντος (οι οποίες " "θα είναι μεταγενέστερες της διεπαφής και θα ανήκουν στην ίδια μείζονα " "έκδοση). Ακόμη και όταν πρόκειται για μείζονες νέες εκδόσεις, οι " "ασυμβατότητες αναμένεται να είναι σπάνιες και να οφείλονται σε σοβαρούς " "λόγους." #. (itstool) path: listitem/para #: C/index.docbook:1027 msgid "" "Unstable - Unstable interfaces are experimental or transitional. They are " "typically used to give outside developers early access to new or rapidly " "changing technology, or to provide an interim solution to a problem where a " "more general solution is anticipated. No claims are made about either source " "or binary compatibility from one minor release to the next." msgstr "" "Ασταθής - Ασταθείς είναι οι πειραματικές ή μεταβατικές διεπαφές. Συνήθως " "χρησιμοποιούνται για να παρέχουν σε τρίτους πρώιμη πρόσβαση σε νέες ή " "διαρκώς εξελισσόμενες τεχνολογίες, ή ως ενδιάμεσες λύσεις για προβλήματα για " "τα οποία αναμένεται μια γενικότερη λύση. Δεν υφίσταται καμία εγγύηση " "συμβατότητας μεταξύ μιας ελάσσονας έκδοσης και της επόμενης." #. (itstool) path: listitem/para #: C/index.docbook:1039 msgid "" "Private - An interface that can be used within the GNOME stack itself, but " "that is not documented for end-users. Such functions should only be used in " "specified and documented ways." msgstr "" "Ιδιωτική - Διεπαφή που μπορεί να χρησιμοποιηθεί εντός της στοίβας του GNOME, " "αλλά δε διαθέτει τεκμηρίωση που να απευθύνεται στους τελικούς χρήστες. " "Τέτοιου είδους συναρτήσεις μπορούν να χρησιμοποιούνται μόνο στο πλαίσιο " "σαφώς καθορισμένων και τεκμηριωμένων διαδικασιών." #. (itstool) path: listitem/para #: C/index.docbook:1048 msgid "" "Internal - An interface that is internal to a module and does not require " "end-user documentation. Functions that are undocumented are assumed to be " "Internal." msgstr "" "Εσωτερική - Μια διεπαφή που είναι εσωτερική σε ένα άρθρωμα και δεν απαιτεί " "την ύπαρξη τεκμηρίωσης για τον τελικό χρήστη. Οι συναρτήσεις που δεν " "περιέχουν τεκμηρίωση εκλαμβάνονται ως εσωτερικές." #. (itstool) path: listitem/para #: C/index.docbook:1010 msgid "" "An informal description of the stability level this API has. We recommend " "the use of one of these terms: <_:itemizedlist-1/>" msgstr "" "Άτυπη περιγραφή του επιπέδου σταθερότητας του συγκεκριμένου API. Σας " "συνιστούμε τη χρήση ενός από τους ακόλουθους όρους: <_:itemizedlist-1/>" #. (itstool) path: varlistentry/term #: C/index.docbook:1060 msgid "@include" msgstr "@include" #. (itstool) path: listitem/para #: C/index.docbook:1062 msgid "" "The #include files to show in the section synopsis (a " "comma separated list), overriding the global value from the section file or command line. This item is " "optional." msgstr "" "Αρχεία #include που εμφανίζονται στη συνοπτική παρουσίαση " "των ενοτήτων (λίστα αρχείων που χωρίζονται με κόμματα), αντικαθιστώντας την " "καθολική τιμή στο αρχείο ενότητας ή στη γραμμή εντολών. Πρόκειται για προαιρετικό στοιχείο." #. (itstool) path: varlistentry/term #: C/index.docbook:1071 msgid "@image" msgstr "@image" #. (itstool) path: listitem/para #: C/index.docbook:1073 msgid "" "The image to display at the top of the reference page for this section. This " "will often be some sort of a diagram to illustrate the visual appearance of " "a class or a diagram of its relationship to other classes. This item is " "optional." msgstr "" "Η εικόνα που θα εμφανίζεται στο πάνω μέρος της σελίδας αναφοράς για αυτή την " "ενότητα. Αυτή συχνά θα είναι κάποιου είδους διάγραμμα για την απεικόνιση μια " "κλάσης ή ενός διαγράμματος της σχέσης της με άλλες κλάσεις. Αυτή η " "καταχώρηση είναι προαιρετική." #. (itstool) path: tip/para #: C/index.docbook:1084 msgid "" "To avoid unnecessary recompilation after doc-changes put the section docs " "into the c-source where possible." msgstr "" "Για να μη χρειαστεί να κάνετε εκ νέου μεταγλώττιση μετά από αλλαγές στην " "τεκμηρίωση, σας προτείνουμε να ενσωματώνετε την τεκμηρίωση των ενοτήτων στο " "αρχείο του πηγαίου κώδικα, όπου αυτό είναι δυνατό." #. (itstool) path: sect1/title #: C/index.docbook:1093 msgid "Documenting symbols" msgstr "Τεκμηρίωση συμβόλων" #. (itstool) path: sect1/para #: C/index.docbook:1095 msgid "" "Each symbol (function, macro, struct, enum, signal and property) is " "documented in a separate block. The block is best placed close to the " "definition of the symbols so that it is easy to keep them in sync. Thus " "functions are usually documented in the c-source and macros, structs and " "enums in the header file." msgstr "" "Κάθε σύμβολο (συνάρτηση, μακροεντολή, δομή, αρίθμηση, σήμα, ιδιότητα) " "τεκμηριώνεται σε ξεχωριστή ομάδα. Η καταλληλότερη θέση για τις ομάδες είναι " "δίπλα στους ορισμούς των συμβόλων, γιατί διευκολύνει το έργο συγχρονισμού. " "Επομένως, η τεκμηρίωση των συναρτήσεων συνήθως βρίσκεται στο αρχείο του " "πηγαίου κώδικα, ενώ των μακροεντολών, δομών και αριθμήσεων στο αρχείο " "κεφαλίδας." #. (itstool) path: sect2/title #. (itstool) path: example/title #: C/index.docbook:1103 C/index.docbook:1169 msgid "General tags" msgstr "Γενικές ετικέτες" #. (itstool) path: sect2/para #: C/index.docbook:1105 msgid "" "You can add versioning information to all documentation elements to tell " "when an API was introduced, or when it was deprecated." msgstr "" "Μπορείτε να προσθέσετε πληροφορίες εκδόσεων σε όλα τα στοιχεία της " "τεκμηρίωσης για να πείτε πότε εισήχθηκε ένα API, ή πότε καταργήθηκε." #. (itstool) path: variablelist/title #: C/index.docbook:1110 msgid "Versioning Tags" msgstr "Εκδόσεις Ετικετών" #. (itstool) path: varlistentry/term #: C/index.docbook:1111 msgid "Since:" msgstr "Από:" #. (itstool) path: listitem/para #: C/index.docbook:1113 msgid "Description since which version of the code the API is available." msgstr "Περιγραφή οπό ποια έκδοση του κώδικα και μετά είναι διαθέσιμο το API." #. (itstool) path: varlistentry/term #: C/index.docbook:1118 msgid "Deprecated:" msgstr "Παρωχημένη:" #. (itstool) path: listitem/para #: C/index.docbook:1120 msgid "" "Paragraph denoting that this function should no be used anymore. The " "description should point the reader to the new API." msgstr "" "Παράγραφος που επισημαίνει ότι θα πρέπει να σταματήσει η χρήση της " "συνάρτησης. Η περιγραφή θα πρέπει να παραπέμπει τον αναγνώστη στο νέο API." #. (itstool) path: sect2/para #: C/index.docbook:1128 msgid "" "You can also add stability information to all documentation elements to " "indicate whether API stability is guaranteed for them for all future minor " "releases of the project." msgstr "" "Μπορείτε επίσης να προσθέσετε πληροφορίες σταθερότητας σε όλα τα στοιχεία " "της τεκμηρίωσης για να δείξετε αν η σταθερότητα API είναι εγγυημένη για αυτά " "για όλες τις μελλοντικές δευτερεύουσες εκδόσεις του έργου." #. (itstool) path: sect2/para #: C/index.docbook:1134 msgid "" "The default stability level for all documentation elements can be set by " "passing the argument to " "gtkdoc-mkdb with one of the values below." msgstr "" "Το επίπεδο προεπιλεγμένης σταθερότητας για όλα τα στοιχεία τεκμηρίωσης " "μπορούν να οριστούν μεταφέροντας το όρισμα