gtk-doc-help.master - en to te translation catalogue (156 entries)

en: GTK-Doc Manual
te: GTK-Doc మాన్యుయల్

en: User manual for developers with instructions of GTK-Doc usage.
te: GTK-Doc వినియోగపు సూచనలతో అభివృద్దికారుల కొరకు వినియోగదారి మాన్యుయల్.

en: Chris
te: క్రిస్

en: Lyttle
te: లిట్టిల్

en: Dan
te: డాన్

en: Mueth
te: ముయెత్

en: Stefan
te: స్టిఫెన్

en: Kost
te: కోస్ట్

en: GTK-Doc project
te: GTK-Doc ప్రోజెక్ట్

en: Dan Mueth and Chris Lyttle and Stefan Kost
te: డాన్ ముయెత్ మరియు క్రిస్ లిట్టిల్ మరియు స్టిఫెన్ కోస్ట్

en: Permission is granted to copy, distribute and/or modify this document under the terms of the <citetitle>GNU Free Documentation License</citetitle>, 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 <link linkend="fdl">included</link>.
te: ఎటువంటి ఫ్రంట్-కవర్ పాఠ్యములు, మరియు బ్యాక్-కవర్ పాఠ్యములు లేకుండా, ఫ్రీ సాఫ్టువేరు ఫౌండేషన్ ద్వారా ప్రచురితమైన వర్షన్ 1.1 లేదా దాని తర్వాత వర్షన్‌ <citetitle>GNU Free Documentation License</citetitle> నియమాలకు లోబడి ఈ పత్రమును నకలు తీయుటకు, పంపిణీ చేయుటకు మరియు/లేదా సవరించుటకు అనుమతి యివ్వబడింది. లైసెన్సు యొక్క నకలు <link linkend="fdl">చేర్చబడింది</link>.న్ ద్వారా ప్రచురితమై,

en: 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.
te: కంపెనీలు వాటి వుత్పత్తులను మరియు సేవలను వర్గీకరించుటకు వుపయోగించు చాలా వరకు నామములు ట్రేడ్‌మార్కులుగా హక్కు కలిగివుంటాయి. అవి GNOME పత్రికీకరణనందు కనిపించునప్పుడు, మరియు GNOME Documentation Project సభ్యలు ఆ ట్రేడ్‌మార్కులను గుర్తించుటకు, ఆనామములు పెద్ద అక్షరములలో లేదా మొదటి అక్షరం పెద్ద అక్షరంగా ముద్రించబడతాయి.

en: 19 December 2009
te: 19 డిసెంబర్ 2009

en: development version
te: అభివృద్ది వర్షన్

en: 18 December 2009
te: 18 డిసెంబర్ 2009

en: broken tarball update
te: బ్రోకెన్ టార్బాల్ నవీకరణ

en: new tool features and bugfixes
te: కొత్త సాధనము సౌలభ్యాలు మరియు బగ్‌పరిష్కారములు

en: 16 Novemebr 2008
te: 16 నవంబర్ 2008

en: GNOME doc-utils migration
te: GNOME doc-utils మైగ్రేషన్

en: Introduction
te: పరిచయం

en: This chapter introduces GTK-Doc and gives an overview of what it is and how it is used.
te: ఈ అధ్యాయము GTK-Docను పరిచయం చేస్తుంది మరియు అది యేమిచేస్తుంది దానిని యెలా వుపయోగించాలి అనేదానిపై సంక్షిప్తంగా వివరిస్తుంది.

en: What is GTK-Doc?
te: GTK-Doc అంటే యేమిటి?

en: 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.
te: GTK-Doc అనునది C కోడ్‌ను పత్రికీకరణ చేయుటకు వుపయోగించబడింది. ఇది ముఖ్యంగా GTK+ మరియు GNOME వంటి లైబ్రరీల పబ్లిక్ API పత్రికీకరణకు వుపయోగించబడింది. అయితే యిది అనువర్తనము కోడ్‌ను పత్రికీకరణ చేయుటకు కూడా వుపయోగించవచ్చును.

en: How Does GTK-Doc Work?
te: GTK-Doc యెలా పనిచేయును?

en: 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).
te: GTK-Doc అనునది మూలపు(సోర్స్) ఫైళ్ళ యొక్క ఫంక్షన్స్ నందు ప్రత్యేకించి-రూపొందించిన కామెంట్ బ్లాక్స్ నందలి పత్రికీకరణను వుపయోగించి పనిచేయును, లేదా GTK-Doc వుపయోగించే మాదిరి(టెంప్లేట్) ఫైళ్ళకు జతచేసిన పత్రికీకరణను వుపయోగించును (GTK-Doc హెడర్ ఫైళ్ళ నందు డిక్లేర్ చేసివున్న ఫంక్షన్లకు మాత్రమే పత్రికీకరణ యిచ్చును; అది స్టాటిక్ ఫంక్షన్ల కొరకు అవుట్పుట్ అందించదు).

en: GTK-Doc consists of a number of perl scripts, each performing a different step in the process.
te: GTK-Doc చాలా పెర్ల్ స్క్రిప్టులను కలిగివుంది, ప్రతిది వేరువేరు స్టెప్పును కార్యక్రమమునందు జరుపును.

en: There are 5 main steps in the process:
te: అక్కడ కార్యక్రమమునందు 5 ముఖ్య స్టెప్పులు వున్నవి:

en: <guilabel>Writing the documentation.</guilabel> 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).
te: <guilabel>పత్రికీకరణను వ్రాయుట.</guilabel> మూలకర్త(ఆథర్) సోర్స్ ఫైళ్ళనందు ప్రతి ఫంక్షన్‌కు, మాక్రోకు, యూనియన్‌కు పత్రకీకరణను యిస్తాడు. (గతంలో సమాచారమును మాదిరి ఫైళ్ళనందు ప్రవేశపెట్టేవారు, యిది యిప్పడు సమర్ధించబడదు).

en: <guilabel>Gathering information about the code.</guilabel><application>gtkdoc-scan</application> scans the header files of the code looking for declarations of functions, macros, enums, structs, and unions. It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> containg 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 <filename>&lt;module&gt;-sections.txt</filename> 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 <filename>&lt;module&gt;-decl.txt</filename>. This file contains the full declarations found by the scanner. If for some reason one would like some sybols to show up in the docs, where the full declaration cannot be found by th scanner or the declaration should appear differently, one can place enties similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;module&gt;-overrides.txt</filename>. <application>gtkdoc-scanobj</application> can also be used to dynamically query a library about any GtkObject subclasses it exports. It saves information about each object's position in the class hierarchy and about any GTK Args and Signals it provides.
te: <guilabel>కోడ్ గురించిన సమాచారమును సేకరిస్తోంది.</guilabel><application>gtkdoc-scan</application> ఫంక్షన్ల, మాక్రోల, ఈనమ్స్,స్ట్రక్ట్స్, మరియు యూనియన్స్ కొరకు కోడ్ లాకింగ్ యొక్క హెడర్ ఫైళ్ళను స్కాన్ చేస్తుంది. డిక్లరేషన్ల జాబితాను కలిగివున్న <filename>&lt;module&gt;-decl-list.txt</filename> ఫైలును యిది సృష్టిస్తుంది, అవి యే హెడర్ ఫైళ్ళనందు వున్నవో దానిని అనుసరించి వాటిని ఆయా విభాగములలో వుంచును. మొదటి సారినడిపినప్పుడు ఈ పైలు <filename>&lt;module&gt;-sections.txt</filename>కు నకలు తీయబడుతుంది. మూలకర్త విభాగములను తిరిగిఅమర్చగలడు, మరియు వాటి నందలి డిక్లరేషన్ల క్రమమును కూడా, తద్వార చివరిగా కావలసిన క్రమమును పొందును. ఇది జనియింపచేయు రెండవ ఫైలు<filename>&lt;module&gt;-decl.txt</filename>. ఈ ఫైలు స్కానర్ ద్వారా కనుగొనబడిన పూర్తి డిక్లరేషన్లను కలిగివుంటుంది. ఏదోవొక కారణంచేత యెవరైన పత్రములనందు చిహ్నములను చూపాలని అనుకొంటే, యెక్కడైతే పూర్తి డిక్లరేషన్ స్కానర్ నందు కనుబడదో లేదా డిక్లరేషన్ భిన్నంగా కనిపించాలో అక్కడ,యెవరైనా <filename>&lt;module&gt;-decl.txt</filename>నందు వున్న అంశములకు సమానంగా వున్న వాటిని <filename>&lt;module&gt;-overrides.txt</filename>కు వుంచవచ్చును. <application>gtkdoc-scanobj</application> అనునది అది యెగుమతి చేసిన GtkObjectసబ్‌క్లాసెస్ గురించిన లైబ్రరీను క్వరీ చేయుటకు కూడా వుపయోగించబడును. ఇది క్లాస్ హైరార్కీ నందలి ప్రతి ఆబ్జక్టు యొక్క స్థాన సమాచారాన్ని దాయును మరియుఅది అందించు GTK ఆర్గ్స్ మరియు సంకేతముల సమాచారమును దాయును.

en: <guilabel>Generating the "template" files.</guilabel><application>gtkdoc-mktmpl</application> creates a number of files in the <filename class="directory">tmpl/</filename> 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.)
te: <guilabel>"template" ఫైళ్ళను జనియింపచేస్తోంది.</guilabel> <application>gtkdoc-mktmpl</application> అనునది ఫైళ్ళను <filename class="directory">tmpl/</filename> వుపసంచయంనందు సృష్టించును, మొదటి స్టెప్పనందు సేకరించిన సమాచారమును వుపయోగించి. (ఇది పునరావృతంగా నడుపవచ్చునని గమనించండి. ఇది యే పత్రముకూడా యెప్పటికి పోకుండా వుంచుటకు చూస్తుంది.)

en: Since GTK-Doc 1.9 the templates can be avoided. We encourage people to keep documentation in the code. <application>gtkdocize</application> supports now a <option>--flavour no-tmpl</option> option that chooses a makefile that skips tmpl usage totally. If you have never changed file in tmpl by hand, please remove the dir (e.g. from version control system).
te: GTK-Doc 1.9 నుండి మాదిరిలు వదిలివేయబడినవి. మేము అందరిని పత్రికీకరణను కోడ్‌నందు వుంచమని కోరుచున్నాము. tmpl వినియోగాన్ని పూర్తిగా వదిలివేసే <option>--flavour no-tmpl</option> ఐచ్చికాన్ని యిప్పుడు <application>gtkdocize</application> మద్దతించుచున్నది. tmpl నందలి ఫైలును మీరు మానవీయంగా యెప్పుడూ మార్చివుండకపోతే, దయచేసి డైరెక్టరీను తీసివేయుము(ఉ.దా. వర్షన్ కంట్రోల్ సిస్టమ్ నుండి).

en: <guilabel>Generating the SGML/XML and HTML/PDF.</guilabel><application>gtkdoc-mkdb</application> turns the template files into SGML or XML files in the <filename class="directory">sgml/</filename> or <filename class="directory">xml/</filename> 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 takes docs from sources and introspection data.
te: <guilabel>SGML/XML మరియు HTML/PDF జనియింపచేయుట. </guilabel> <application>gtkdoc-mkdb</application> అనునది <filename class="directory">sgml/</filename> లేదా <filename class="directory">xml/</filename> నందలి మాదిరి ఫైళ్ళను SGML లేదా XMLకు మార్చును. ప్రత్యేక కామెంట్ బ్లాక్సు వుపయోగిస్తూ, సోర్సు కోడ్ ఫంక్షన్ల నందు పత్రకీకరణను కలిగివుంటే, అది యిక్కడ కలుపబడును. tmpl ఫైళ్ళు వుపయోగించకపోతే యిది పత్రములను మూలాలనుండి మరియు లోపలి డాటానుండి మాత్రమే చదివి తీసుకొనును.

en: <application>gtkdoc-mkhtml</application> turns the SGML/XML files into HTML files in the <filename class="directory">html/</filename> subdirectory. Likewise <application>gtkdoc-mkpdf</application> turns the SGML/XML files into a PDF docuemnt called <filename>&lt;package&gt;.pdf</filename>.
te: <filename class="directory">html/</filename> వుపసంచయం నందలి SGML/XML ఫైళ్ళను <application>gtkdoc-mkhtml</application> అనునది HTML ఫైళ్ళకు మార్చును. అలాగే <application>gtkdoc-mkpdf</application> అనునది SGML/XML ఫైళ్ళను <filename>&lt;package&gt;.pdf</filename>గా పిలువబడే PDF పత్రమునకు మార్చును.

en: Files in <filename class="directory">sgml/</filename> or <filename class="directory">xml/</filename> and <filename class="directory">html/</filename> directories are always overwritten. One should never edit them directly.
te: <filename class="directory">sgml/</filename> లేదా <filename class="directory">xml/</filename> మరియు <filename class="directory">html/</filename> డైరెక్టరీల నందలి ఫైళ్ళు యెల్లప్పుడూ దిద్దివ్రాయబడును. ఎవరూ వాటిని యెప్పుడూ నేరుగా సరికూర్చకూడదు.

en: <guilabel>Fixing up cross-references between documents.</guilabel> After installing the HTML files, <application>gtkdoc-fixxref</application> 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, <application>gtkdoc-rebase</application> 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).
te: <guilabel>పత్రముల మధ్య క్రాస్-రిఫరెన్సెస్‌ను పరిష్కరించుచున్నది.</guilabel> HTML ఫైళ్ళను సంస్థాపించిన తర్వాత, వేరు వేరు పత్రముల మధ్య క్రాస్-రిఫరెన్సెస్‌ను అమర్చుటకు <application>gtkdoc-fixxref</application> నడుపవచ్చును. ఉదాహరణకు,  GTK+ పత్రికీకరణ అనునది GLib మాన్యుయల్ నందు వుంచిన పత్రికీకరణకు చాలా క్రాస్-రిఫరెన్సెస్ కలిగివుంది. పంపిణీ కొరకు మూలపు టార్బాల్‌ను సృష్టించునప్పుడు, <application>gtkdoc-rebase</application> అనునది అన్ని బహిర్గత లింకులను వెబ్-లింకులకు మార్చును. పంపిణీచేసిన (ముందుగాజనియింపచేసిన) పత్రములను సంస్థాపించునప్పుడు అదే అనువర్తనము లింకులను స్థానిక లింకులకు (ఆ పత్రములు యెక్కడ సంస్థాపించబడినవో అక్కడికి) తిరిగివుంచుటకు ప్రయత్నించును.

en: Getting GTK-Doc
te: GTK-Doc పొందుట

en: Requirements
te: అవసరములు

en: <guilabel>Perl v5</guilabel> - the main scripts are in Perl.
te: <guilabel>Perl v5</guilabel> - ముఖ్య స్క్రిప్టులు Perl1 నందు వున్నవి.

en: <guilabel>DocBook DTD v3.0</guilabel> - This is the DocBook SGML DTD. <ulink url="http://www.ora.com/davenport" type="http">http://www.ora.com/davenport</ulink>
te: <guilabel>DocBook DTD v3.0</guilabel> - ఇది DocBook SGML DTD. <ulink url="http://www.ora.com/davenport" type="http">http://www.ora.com/davenport</ulink>

en: <guilabel>Jade v1.1</guilabel> - This is a DSSSL processor for converting SGML to various formats. <ulink url="http://www.jclark.com/jade" type="http">http://www.jclark.com/jade</ulink>
te: <guilabel>Jade v1.1</guilabel> - SGMLను వివిధ ఫార్మాట్ల లోనికి మార్చుటకు యిది DSSSL ప్రోసెసర్. <ulink url="http://www.jclark.com/jade" type="http">http://www.jclark.com/jade</ulink>

en: <guilabel>Modular DocBook Stylesheets</guilabel> This is the DSSSL code to convert DocBook to HTML (and a few other formats). It's used together with jade. I've customized the DSSSL code slightly, in gtk-doc.dsl, to colour the program code listings/declarations, and to support global cross-reference indices in the generated HTML. <ulink url="http://nwalsh.com/docbook/dsssl" type="http">http://nwalsh.com/docbook/dsssl</ulink>
te: <guilabel>Modular DocBook Stylesheets</guilabel> DocBookను HTMLకు (యింకా కొన్ని యితర ఫార్మాట్లకు) మార్చుటకు యిది DSSSL కోడ్. ఇది jadeతో కలిపి వుపయోగించబడును. నేను DSSSL కోడ్‌ను కొద్దిగా మలచుకొనినాను, gtk-doc.dsl నందు, ప్రోగ్రామ్ కోడ్ జాబితాలు/డిక్లరేషన్లను రంగులో వుంచుటకు, మరియు జనియింపచేసిన HTML నందు గ్లోబల్ క్రాస్-రిఫరెన్సెస్ యిండిసెస్‌ను మద్దతించుటకు. <ulink url="http://nwalsh.com/docbook/dsssl" type="http">http://nwalsh.com/docbook/dsssl</ulink>

en: <guilabel>docbook-to-man</guilabel> - if you want to create man pages from the DocBook. I've customized the 'translation spec' slightly, to capitalise section headings and add the 'GTK Library' title at the top of the pages and the revision date at the bottom. There is a link to this on <ulink url="http://www.ora.com/davenport" type="http">http://www.ora.com/davenport</ulink> NOTE: This does not work yet.
te: <guilabel>docbook-to-man</guilabel> - DocBook నుండి man పేజీలను సృష్టించాలని అనుకొంటే. నేను 'translation spec' ను కొద్దిగా మలచుకొనినాను, విభగాపు హెడ్డింగులను పెద్దఅక్షరములలో వుంచుకొనుటకు మరియు పేజీల యొక్క పైభాగమున 'GTK Library' శీర్షికను జతచేయుటకు మరియు క్రిందన పునఃపరిశీలన తేదీను వుంచుటకు. దీనికి <ulink url="http://www.ora.com/davenport" type="http">http://www.ora.com/davenport</ulink> పైన వొక లింకు వుంది. గమనిక: ఇంది యింకా పనిచేయుటలేదు.

en: Installation
te: సంస్థాపన

en: There is no standard place where the DocBook Modular Stylesheets are installed.
te: DocBook మాడ్యులర్ స్టైల్‌షీట్లు యిక్కడ సంస్థాపించాలని వొక ప్రామాణిక స్థలము యేమీలేదు.

en: GTK-Doc's configure script searches these 3 directories automatically:
te: GTK-Doc యొక్క ఆకృతీకరణ స్క్రిప్టు ఈ 3 డైరెక్టరీలను స్వయంచాలకంగా శోధిస్తుంది:

en: <filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (used by RedHat)
te: <filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (RedHat ద్వారా వుపయోగించబడింది)

en: <filename> /usr/lib/dsssl/stylesheets/docbook </filename> (used by Debian)
te: <filename> /usr/lib/dsssl/stylesheets/docbook </filename> (Debian ద్వారా వుపయోగించబడింది)

en: <filename> /usr/share/sgml/docbkdsl </filename> (used by SuSE)
te: <filename> /usr/share/sgml/docbkdsl </filename> (SuSE ద్వారా వుపయోగించబడింది)

en: If you have the stylesheets installed somewhere else, you need to configure GTK-Doc using the option: <command> --with-dsssl-dir=&lt;PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>
te: మీరు యెక్కడోవొకచోట స్టైల్‌షీట్లను సంస్థాపించివుంటే, మీరు GTK-Docను ఈ ఐచ్చికము వుపయోగించి ఆకృతీకరించవలసి వుంటుంది: <command> --with-dsssl-dir=&lt;PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>

en: About GTK-Doc
te: GTK-Doc గురించి

en: (History, authors, web pages, license, future plans, comparison with other similar systems.)
te: (చరిత్ర, మూలకర్తలు, వెబ్ పుటలు, లైసెన్స్, భవిష్య ప్రణాళికలు, సమానమైన యితర సిస్టమ్సుతో పోలిక.)

en: About this Manual
te: ఈ మాన్యుయల్ గురించి

en: (who it is meant for, where you can get it, license)
te: (ఇది యెవరి కొరకు, మీరు దీనిని యెచటనుండి పొందగలరు, లైసెన్స్)

en: Setting up your project
te: మీ ప్రోజెక్టును అమర్చుట

en: The next sections describe what steps to perform to integrate GTK-Doc into your project. Theses section assume we work on a project called 'meep'. This project contains a library called 'libmeep' and an end-user app called 'meeper'.
te: GTK-Doc మీ ప్రోజెక్టునకు చేర్చుటకు యే స్టెప్పులు జరుపవలెనో తరువాతి విభాగములు వివరిస్తాయి. మనము 'meep' అను ప్రోజెక్టుపై పనిచేస్తున్నట్టు ఈ విభాగములనందు వద్దేశించడమైనది. ఈ ప్రోజెక్టు 'libmeep' అను లైబ్రరీను మరియు 'meeper' అను అంత్య-వినియోగదారి అనువర్తనమును కలిగివుంది.

en: Setting up a skeleton documentation
te: స్కెల్టెన్ పత్రికీకరణను అమర్చుచున్నది

en: 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.
te: మీ పై-స్థాయి ప్రోజెక్టు డైరెక్టరీ క్రింద docs/reference అను ఫోల్డర్లను సృష్టించుము (ఈ విధంగా మీరు docs/helpను అంత్య-వినియోగదారి పత్రికీకరణ కొరకు కలిగివుండవచ్చును). doc-package నామముతో వేరొక వుపసంచయంను సృష్టించుకొనుట సిఫార్సు చేయబడింది. కేవలం వొక లైబ్రరీ మాత్రమే వున్న ప్యాకేజీలకు యిది అవసరములేదు.

en: Example directory structure
te: ఉదాహరణ డైరెక్టరీ ఆకృతి

en: This can then look as show below: <placeholder-1/>
te: ఇది అప్పుడు క్రింది చూపిన విధంగా కనబడుతుంది: <placeholder-1/>

en: Integration with autoconf
te: autoconf తో విలీనం

en: Very easy! Just add one line to your <filename>configure.ac</filename> script.
te: చాలా సులువు! మీ <filename>configure.ac</filename> స్క్రిప్టునకు వొక లైను మాత్రమే జతచేయుము.

en: The first argument is used to check for the gtkdocversion at configure time. The 2nd, optional argument is used by <application>gtkdocize</application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several configure switches:
te: ఆకృతీకరణ సమయము వద్ద gtkdocversion కొరకు పరిశీలించుటకు మొదటి ఆర్గుమెంటు వుపయోగించబడింది. 2వది, <application>gtkdocize</application> చేత వుపయోగించబడిన ఐచ్చిక ఆర్గుమెంట్. <symbol>GTK_DOC_CHECK</symbol> మాక్రో చాలా ఆకృతీకరణ స్విచ్‌లను జతచేస్తుంది:

en: --with-html-dir=PATH : path to installed docs
te: --with-html-dir=PATH : సంస్థాపించిన పత్రములకు పాత్

en: --enable-gtk-doc : use gtk-doc to build documentation [default=no]
te: --enable-gtk-doc : పత్రికీకరణను నిర్మించుటకు gtk-doc వుపయోగించుము [default=no]

en: --enable-gtk-doc-html : build documentation in html format [default=yes]
te: --enable-gtk-doc-html : పత్రికీకరణను html ఫార్మాట్‌నందు నిర్మించుము [default=yes]

en: --enable-gtk-doc-pdf : build documentation in pdf format [default=no]
te: --enable-gtk-doc-pdf : పత్రికీకరణను pdf ఫార్మాట్ నందు నిర్మించుము [default=no]

en: GTK-Doc is disabled by default! Remember to pass the option <option>'--enable-gtk-doc'</option> to the next <filename>configure</filename> run. Otherwise pregenerated documentation is installed (which makes sense for users but not for developers).
te: GTK-Doc అప్రమేయంగా అచేతనము చేయబడింది! ఐచ్చికము <option>'--enable-gtk-doc'</option>ను తరువాతి <filename>configure</filename>కు నడుపుట మర్చిపోవద్దు. లేకపోతే ముందుగా జనియింపచేసిన పత్రికీకరణ సంస్థాపించబడుతుంది (ఇది వినియోగదారులకు వుపయోగకరం అయితే అభివృద్దికారులకు కాదు).

en: Furthermore it is recommended that you have the following line inside you <filename>configure.ac</filename> script. This allows <application>gtkdocize</application> to automatically copy the macro definition for <function>GTK_DOC_CHECK</function> to your project.
te: మీ <filename>configure.ac</filename> స్క్రిప్టునందు ఈ క్రింది వరుసను కలిగివుండుట చాలామంచిది. ఇది మీ ప్రోజెక్టునందు <function>GTK_DOC_CHECK</function> కొరకు స్వయంచాలకంగా మాక్రో నిర్వచనాన్ని నకలు తీయుటకు <application>gtkdocize</application>ను అనుమతిస్తుంది.

en: Preparation for gtkdocize
te: gtkdocize కొరకు సన్నాహం

en: Integration with automake
te: automake తో విలీనం

en: First copy the <filename>Makefile.am</filename> from the examples subdirectory of the gtkdoc-sources to your project's API documentation directory ( <filename class="directory">./docs/reference/&lt;package&gt;</filename>). If you have multiple doc-packages repeat this for each one.
te: ముందుగా <filename>Makefile.am</filename>ను gtkdoc-sources యొక్క వుదాహరణల వుపసంచయం నుండి మీ ప్రోజెక్టు యొక్క API పత్రికీకరణ డైరెక్టరీనకు నకలుతీయుము (<filename class="directory">./docs/reference/&lt;package&gt;</filename>). మీరు బహుళ doc-packages కలిగివుంటే ప్రతిదానికి యిలా చేయండి.

en: The next step is to edit the setting inside the <filename>Makefile.am</filename>. 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 <option>&lt;TOOLNAME&gt;_OPTIONS</option>. All the tools support <option>--help</option> to list the supported parameters.
te: తరువాతి స్టెప్పు <filename>Makefile.am</filename> నందలి అమరికను సరికూర్చుట. అన్ని అమరికలు వాటి ప్రయోజనాన్ని వివరించే వ్యాఖ్యను కలిగివున్నాయి. చాలా వరకు అమరికలు వాటి సంభందిత సాధనముల ద్వారా పంపబడే అదనపు ఫ్లాగ్స్. ప్రతి సాధనము <option>&lt;TOOLNAME&gt;_OPTIONS</option> రూపపు వేరియబుల్‌ను కలిగివుంది. మద్దతించు పారామితులను జాబితా చేయుటకు అన్ని సాధనములు <option>--help</option>ను మద్దతించును.

note: FIXME: explain options ?
en: You may also want to enable GTK-Doc for the distcheckmake target. Just add then one-liner show in the next example to you top-level <filename>Makefile.am</filename>:
te: మీరు GTK-Docను distcheckmake లక్ష్యము కొరకు చేతనము చేయవచ్చు. జతచేయి అప్పుడు తర్వాత వుదాహరణనందు one-liner మీకు పై-స్థాయి <filename>Makefile.am</filename>ను చూపును:

en: Enable GTK-Doc during make distcheck
te: distcheck చేయునప్పుడు GTK-Doc చేతనము చేయి

en: Integration with autogen
te: autogen తో విలీనం

en: Most projects will have an <filename>autogen.sh</filename> 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 <application>gtkdocize</application> which can be used in such a script. It should be run before autoheader, automake or autoconf.
te: వర్షన్ కంట్రోల్ సిస్టమ్ (cvs/svn/git వంటి) నుండి చెక్అవుట్ తర్వాత బుల్డ్ నిర్మాణం అమర్చుటకు చాలా ప్రోజెక్టులు <filename>autogen.sh</filename> స్క్రిప్టును కలిగివుంటాయి. GTK-Doc అనునది <application>gtkdocize</application> అనబడు సాధనంతో వస్తుంది దీనిని అటువంటి స్క్రిప్టు నందు వుపయోగించవచ్చును. ఇది autoheader, automake లేదా autoconf ముందు నడుపవలెను.

en: Running gtkdocize from autogen.sh
te: autogen.sh నుండి gtkdocize నడుపుతోంది

en: When running <application>gtkdocize</application> it copies <filename>gtk-doc.make</filename> to you project root (or any directory specified by the <option>--docdir</option> option). If also check you configure script for the <function>GTK_DOC_CHECK</function> invocation.
te: <application>gtkdocize</application> నడుపుచున్నప్పుడు అది <filename>gtk-doc.make</filename>ను మీ ప్రోజెక్టు root (లేదా <option>--docdir</option> ద్వారా తెలుపబడిన డైరెక్టరీ)కు నకలుతీయును. <function>GTK_DOC_CHECK</function> ఆమంత్రణం కొరకు యిది మీ ఆకృతీకరణ స్క్రిప్టును పరిశీలించును.

en: Historically GTK-Doc was gerating template files where developers entered the docs. this turned out to be not so good. Since a few version GTK-Doc could also get all the information from source comments. Since GTK-Doc 1.9 the templates can be avoided. We encourage people to keep documentation in the code. <application>gtkdocize</application> supports now a <option>--flavour no-tmpl</option> 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 a environment variable called <symbol>GTKDOCIZE_FLAGS</symbol> or set as a 2nd parameter in <symbol>GTK_DOC_CHECK</symbol> macro in the configure script. If you have never changed file in tmpl by hand and migrating from older gtkdoc versions, please remove the dir (e.g. from version control system).
te: చారిత్రకంగా GTK-Doc అనునది మాదిరి ఫైళ్ళను అభివృద్దికారులు పత్రములు ప్రవేశపెట్టినచోట జనియింపచేయుచున్నది. ఇది అంత మంచిగా లేదు. కొద్ది GTK-Docవర్షన్లు మాత్రమే సమాచారమునంతటిని మూలపు వ్యాఖ్యలనుండి పొందగలిగివున్నవి కావున. GTK-Doc 1.9 నుండి మాదిరిలు వదిలివేయబడినవి. పత్రికీకరణనుకోడ్‌నందు కలిగివుంచుటకే మేము అందరిని ప్రోత్సహిస్తున్నాము. tmpl వినియోగాన్ని పూర్తిగా వదిలివేసే <option>--flavour no-tmpl</option> ఐచ్చికాన్ని యిప్పుడు <application>gtkdocize</application> మద్దతించుచున్నది. ఐచ్చికాన్ని నేరుగా ఆదేశ ఆమంత్రీకరణకు జతచేయుటకు బదులుగా, అవి యెన్విరాన్మెంట్ వేరియబుల్‌ <symbol>GTKDOCIZE_FLAGS</symbol>కు జతచేయవచ్చును లేదా ఆకృతీకరణ స్క్రిప్టునందలి <symbol>GTK_DOC_CHECK</symbol> మాక్రో నందు 2వ పారామితిగా అమర్చుము. మీరు యెప్పుడూ tmpl నందలి ఫైలు మార్చివుండకపోతే మరియు gtkdoc వర్షన్లనుండి మైగ్రేట్ అవుతుంటే, దయచేసి dirను తీసివేయుము (ఉ.దా. వర్షన్ కంట్రోల్ సిస్టమ్ నుండి).

en: Running the doc build
te: doc బుల్డును నడుపుట

en: After the previous steps it's time to run the build. First we need to rerun <filename>autogen.sh</filename>. If this script runs configure for you, then give it the <option>--enable-gtk-doc</option> option. Otherwise manually run <filename>configure</filename> with this option afterwards.
te: గతంలో జరిపిన స్టెప్పుల తర్వాత యిప్పుడు బుల్డును నడుపవలెను. ముందుగా మనము <filename>autogen.sh</filename>ను తిరిగి నడుపవలెను. ఈ స్క్రిప్టు మీ కొరకు ఆకృతీకరణను నడిపితే, దానికి <option>--enable-gtk-doc</option> ఐచ్చికాన్ని యివ్వుము. లేదా తరువాత ఈ ఐచ్చికముతో మానవీయంగా <filename>configure</filename>ను నడుపుము.

en: The first make run generates several additional files in the doc-dirs. The important ones are: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.sgml</filename>, <filename>&lt;package&gt;-sections.txt</filename>.
te: మొదటి make run అనునది doc-dirs నందు చాలా అదనపు ఫైళ్ళను జనియింపచేయును. ముఖ్యమైనవి: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.sgml</filename>, <filename>&lt;package&gt;-sections.txt</filename>.

en: Now you can point your browser to <filename>docs/reference/&lt;package&gt;/index.html</filename>. Yes, it's a bit disappointing still. But hang-on, during the next chapter we tell you how to fill the pages with life.
te: ఇప్పుడు మీ బ్రౌజర్‌కు మీరు <filename>docs/reference/&lt;package&gt;/index.html</filename>ను సూచించవచ్చును. అవును, యిప్పటికి యిది కొంత నిరుత్సాహపరుస్తోంది. అయితే ఆగండి, తరువాతి అధ్యాయమునందు పేజీలను యెలా నింపాలో చెబుతాము.

en: Integration with version control systems
te: వర్షన్ కంట్రోల్ సిస్టమ్‌తో విలీనం

en: As a rule of the thumb, it's those files you edit, that should go under version control. For typical projects it's these files: <filename>&lt;package&gt;.types</filename><filename>&lt;package&gt;-docs.sgml</filename><filename>&lt;package&gt;-sections.txt</filename><filename>Makefile.am</filename>
te: thumb యొక్క నియమాన్ని అనుసరించి, యిది మీరు సరికూర్చిన ఫైళ్ళది, అది వర్షన్ కంట్రోల్  క్రిందకు వెళ్ళవలెను. ముఖ్యమైన ప్రోజెక్టులకు ఈ ఫైళ్ళు:<filename>&lt;package&gt;.types</filename><filename>&lt;package&gt;-docs.sgml</filename><filename>&lt;package&gt;-sections.txt</filename><filename>Makefile.am</filename>

en: Documenting the code
te: కోడ్‌ను పత్రికీకరణ చేయుట

en: 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 find all information about the syntax of the comments.
te: కోడ్ పత్రికీకరణ కొరకు GTK-Doc అనునది సోర్స్ కోడ్ కామెంట్‌ను ప్రత్యేక సిన్టాక్సుతో వుపయోగిస్తుంది. ఇంకా యిది యితర మూలములనుండి మీ ప్రోజెక్టు ఆకృతి గురించి సమాచారమును వెలికితీయును. తరువాతి విభాగమునందు మీరు మీ వ్యాఖ్యల యొక్క సిన్టాక్సు గురించి సమాచారమును అంతటిని కనుగొంటారు.

en: Documentation placement
te: పత్రికీకరణ స్థానము

en: In the past most documentation had to be filled into files residing inside the <filename>tmpl</filename> 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.
te: గతంలో చాలా వరకు పత్రికీకరణ అనునది <filename>tmpl</filename> డైరెక్టరీ క్రిందని ఫైళ్ళలో నింపవలసివుండేది. సమాచారము సరిగా నవీకరించబడక పోవుట మరియు ఆ ఫైలు వర్షన్ కంట్రోల్ సిస్టమ్సుతో విభేదించుట వంటి లోపాలను యిది కలిగివుంది.

en: The avoid the aforementioned problems we suggest putting the documentation inside the sources. This manual will only describe this way of documenting code.
te: ముందుగా తెలిపిన సమస్యలను తప్పించుటకు మేము పత్రికీకరణను మూలముల లోపలే వుంచమని సూచించుచున్నాము. ఈ మాన్యుయల్ ఈ విధంగా కోడ్ పత్రికీకరణను మాత్రమే వివరించును.

en: Documentation comments
te: పత్రికీకరణ వ్యాఖ్యలు

en: GTK-Doc comment block
te: GTK-Doc వ్యాఖ్య బ్లాక్

en: A multiline comment that starts with an additional '*' marks a documentation block that will be processed by the GTK-Doc tools. <placeholder-1/>
te: బహుళ వరుసలు వుండి అదనపు '*' గుర్తులతో ప్రారంభించబడు వ్యాఖ్య పత్రికీకరణ బ్లాక్‌ను సూచించును అది GTK-Doc సాధనముల ద్వారా నిర్వర్తించబడును. <placeholder-1/>

en: 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)
te: 'identifier' అనునది వ్యాఖ్యకు సంభందించిన అంశము యొక్క నామముతో వుండు వొక వరుస. అంశము పై ఆధారపడి సిన్టాక్సు అనునది కొద్దిగా విభేదించును. (చేయవలసినది identifies చూపు పట్టికను జతచేయి)

en: 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).
te: ప్రతి చిహ్నపు రకమునకు 'పత్రికీకరణ' బ్లాక్ భిన్నంగా వుంటుంది. ఫంక్షన్లు లేదా స్థూలములు పారామితి వివరణను కలిగివున్నవి ముందుగా ఖాళీ వరుస (a '*') అనుసరించాలి. తరువాత విశదీకృత వివరణను అనుసరించాలి. అన్ని వరుసలు (ప్రోగ్రామ్ బయటవి- జాబితాలు మరియు CDATA విభాగములు) ' *' (ఖాళీ-యాస్ట్రిక్) మాత్రమే కలిగివున్నవి పారాగ్రాఫ్ విరామాలుగా వుంచబడును. మీకు పారాగ్రాఫ్ విరామాలు అక్కరలేకపోతే, దానిని ' * ' (blank-asterisk-blank-blank)కు మార్చుము.

en: Use function() to refer to functions or macros which take arguments.
te: ఆర్గుమెంట్లను తీసుకొనే ఫంక్షన్లను లేదా మాక్రోలను సూచించుటకు function() వుపయోగించుము.

en: Use @param to refer to parameters. Also use this when referring to parameters of other functions, related to the one being described.
te: పారామితులను సూచించుటకు @param వుపయోగించుము. వివరించబడిన పారామితికి సంభందించిన యితర ఫంక్షన్ల పారామితులను సూచించుటకు కూడా దీనిని వుపయోగించుము.

en: Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS.
te: స్థిరరాశిని సూచించుటకు %constant వుపయోగించుము, ఉ.దా. %G_TRAVERSE_LEAFS.

en: Use #symbol to refer to other types of symbol, e.g. structs and enums and macros which don't take arguments.
te: ఇతర రకముల చిహ్నమును సూచించుటకు #symbol వుపయోగించుము, ఉ.దా. ఆర్గుమెంట్లు తీసుకొని structs మరియు enums మరియు macros వంటివి.

en: Use #Object::signal to refer to a GObject signal
te: GObject సంకేతమును సూచించుటకు #Object::signal వుపయోగించుము

en: Use #Object:property to refer to a GObject property
te: GObject లక్షణమును సూచించుటకు #Object:property వుపయోగించుము

en: Use #Struct.field to refer to a field inside a structure.
te: స్ట్రక్చర్ నందలి క్షేత్రమును సూచించుటకు #Struct.field వుపయోగించుము.

en: 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. <placeholder-1/>
te: సాదా-పాఠ్యమునందు హైపర్-పాఠ్యమును కలిగివుండువలన వొక సౌకర్యము పత్రమునందు లింకులను కలిగివుండవచ్చును. అయినను లింకు కొరకు సరైన మార్కప్ వ్రాయుట చికాకే. GTK-Doc నందు చాలా వుపయోగకర ఎబ్రివేషన్లు అందించబడుచున్నవి. <placeholder-1/>

en: If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or '#' in your documentation without GTK-Doc changing them you can use the XML entities "&amp;lt;", "&amp;gt;", "&amp;lpar;", "&amp;rpar;", "&amp;commat;", "&amp;percnt;" and "&amp;num;" respectively or escape them with a backslash '\'.
te: మీరు ప్రత్యేక ఆక్షరములు '&lt;', '&gt;', '()', '@', '%', or '#'ను మీ పత్రికీకరణనందు GTK-Doc వాటిని మార్చకుండా వుపయోగించాలి అంటే మీరు XML మూలకములు "&amp;lt;", "&amp;gt;", "&amp;lpar;", "&amp;rpar;", "&amp;commat;", "&amp;percnt;" మరియు "&amp;num;" వుపయోగించవచ్చు లేదా వాటిని '\' బాక్‌స్లాష్‌తో ఎస్కేప్ చేయుము.

en: DocBook can do more that just links. One can also have lists, tables and examples. To enable the usage of SGML/XML tags inside doc-comments you need to have <option>--sgml-mode</option> in the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</filename>.
te: DocBook లింకుల వలె చాలా చేయగలదు. ఒకరు జాబితాలనుకూడా కలిగివుండగలరు, పట్టికలు మరియు వుదాహరణలు కూడా. doc-comments లోపల SGML/XML టాగ్స్ యొక్క వినియోగాన్ని చేతనము చేయుటకు మీరు <filename>Makefile.am</filename> నందలి <symbol>MKDB_OPTIONS</symbol> వేరియబుల్ నందు <option>--sgml-mode</option> కలిగివుండాలి.

en: 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.
te: ముందుగా చెప్పినట్లుగా GTK-Doc అనునది పబ్లిక్ API పత్రికీకరణ కొరకు. స్థిర చిహ్నములకు వొక్కరే పత్రికీకరణ వ్రాయలేరు. ఆ చిహ్నములను కూడా వ్యాఖ్యానించుట మంచిది. ఇది యితరులు కూడా మీ కోడ్‌ను అర్ధము చేసుకొనుటకు సహాయపడును. అందుకని వీటిని సాదారణ వ్యాఖ్యలు (మొదటి వరుసనందు 2వ '*' లేకుండా) వుపయోగించి వ్యాఖ్యానించమని సూచించడమైంది. తరువాత ఆ ఫంక్షన్ పబ్లిక్‌గా మార్చవలసివుంటే, చేయవలసినదల్లా వేరొక '*'ను వ్యాఖ్య బ్లాక్ నందు చేర్చి మరియు చిహ్నపు నామాన్నివిభగాముల ఫైలునందు సరైన స్థానములో వుంచడమే.

en: Documenting sections
te: పత్రికీకరణ విభాగములు

en: 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.
te: పత్రికీకరణ యొక్క ప్రతి విభాగము వొక క్లాస్ లేదా మాడ్యూల్ గురించిన సమాచారమును కలిగివుంటుంది. మూలకాన్ని పరిచయం చేయుటకు వొకరు విభాగపు బ్లాక్‌ను వ్రాయవచ్చును. పొట్టి వివరణ అనునది పట్టిక యొక్క సారముల లోపలకూడా వుపయోగించబడును. అన్ని @fields ఐచ్చికమైనవి.

en: Section comment block
te: విభాగపు వ్యాఖ్య బ్లాక్

en: The name links the section documentation to the respective part in the <filename>&lt;package&gt;-sections.txt</filename> file. The name give here should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections.txt</filename> file.
te: నామము అనునది విభాగపు పత్రికీకరణను <filename>&lt;package&gt;-sections.txt</filename> ఫైలునందలి సంభందిత భాగమునకు లింకుచేయును. ఇక్కడ యిచ్చిన నామము <filename>&lt;package&gt;-sections.txt</filename> ఫైలునందలి &lt;FILE&gt; టాగ్‌తో సరిపోలవలెను.

en: 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.
te: విభాగము యొక్క వివరణ వొక్క వరుసలో, తరువాత అది TOC నందు లింక్సు తరువాత మరియు విభాగపు పేజీ పైన కనిపించును.

en: The section title defaults to &lt;name&gt; from the SECTION declaration. It can be overridden with the @title field.
te: విభాగపు శీర్షిక అనునది SECTION డిక్లరేషన్ నుండి &lt;name&gt; అప్రమేయం కాబడును. ఇది @title క్షేత్రము ద్వారా దిద్దివ్రాయబడును.

en: Overrides the use of title as a section identifier. For GObjects the &lt;title&gt; is used as a section_id and for other section it is &lt;MODULE&gt;-&lt;title&gt;.
te: శీర్షిక యొక్క వుపయోగాన్ని విభాగపు గుర్తింపుకారి వలె దిద్దివ్రాయును. GObjects కొరకు &lt;title&gt; అనునది section_id వలె మరియు యితర విభాగమునకు &lt;MODULE&gt;-&lt;title&gt; వలె వుపయోగించబడును.

en: A list of symbols that are related to this section..
te: ఈ విభాగమునకు సంభందించిన చిహ్నముల యొక్క జాబితా...

en: 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.
te: స్థిరమైన - స్థిరమైన యింటర్ఫేస్ ముఖ్యోద్దేశం మూడోవ్యక్తి అనువర్తనములను యీ యింటర్ఫేసులకు కొరకు అభివృద్దిపరచుట, విడుదల చేయుట, మరియు ఆ వుత్పాదన యొక్కఅన్ని చిన్న విడుదలలనందు(పెద్ద విడుదల క్రిందన విడుదలగునవి) నడుచునట్లు చూచుకొనుటను చేతన పరచుట. ముఖ్య విడుదలనందు కూడా, సారూప్యతా మార్పులు అనునవి తగ్గించుటకు, ఖచ్చితమైన నిర్ధారణలను కలిగివుండుట.

en: 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.
te: అస్థిరమైన - అస్థిరమైన యింటర్ఫేస్‌లు ప్రయోగాత్మకమైనవి లేదా బదలీకరణ పొందునవి. అవి ముఖ్యంగా బయటి అభివృద్దికారులకు కొత్తవి లేదా వేగంగా మారుతున్న సాంకేతికతపై యాక్సెస్ యిచ్చుటకు వుపయోగించబడును, లేదా వొక సమస్య కొరకు యెక్కువ సహజమైన పరిష్కారము కొరకు యెదురు చూడబడుతోందో అక్కడ మధ్యంతర పరిష్కారము యిచ్చుటకు. ఒక చిన్న విడుదలనుండి తర్వాత దానికి యెటువంటి క్లైమ్స్ సోర్స్ గురించికాని లేదా బైనరీ సారూప్యత గురించికాని చేయబడవు.

en: 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.
te: వ్యక్తిగత - GNOME స్టాక్ లోపలే వుపయోగించగల యింటర్ఫేస్, అయితే అది అంత్య-వినియోగదారుల కొరకు పత్రికీకరణ చేయబడదు. అటువంటి ఫంక్షన్లు తెలుపబడిన మరియు పత్రికీకరణ మార్గములలోనే వుపయోగించాలి.

en: 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.
te: అంతర్గత - మాడ్యూల్‌కు అంతర్గతమైన మాడ్యూల్ మరియు అంత్య-వినియోగదారి పత్రికీకరణ అవసరములేనిది. పత్రికీకరణ చేయని ఫంక్షన్లు అంతర్గతమైనవిగా పరిగణించాలి.

en: A informal description of the stability level this API has. We recommend the use of one of these terms: <placeholder-1/>
te: ఈ API కలిగివున్న స్థిరత్వపు స్థాయి యొక్క సాధారణ వివరణ. ఈ పదములలో వొక దానిని వుపయోగించుట మేము సిఫార్సు చేయుచున్నాము: <placeholder-1/>

en: The <literal>#include</literal> files to show in the section synopsis (a comma separated list), overriding the global value from the <link linkend="metafiles_sections">section file</link> or command line. This item is optional.
te: విభాగపు సారాంశము నందు చూపుటకు <literal>#include</literal> ఫైళ్ళు (కామాతో వేరుచేయబడిన జాబితా), <link linkend="metafiles_sections">విభాగపు ఫైలు</link> లేదా ఆదేశ వరుసనుండి గ్లోబల్ విలువను దిద్దివ్రాయుట. ఈ అంశము ఐచ్చికము.

en: 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.
te: ఈ విభాగము కొరకు సూచనపేజీ పైన ప్రదర్శించుటకు ప్రతిబింబము. ఇది తరుచుగా వొక క్లాస్ యొక్క విజువల్ అప్పియరెన్స్ వివరించుటకు డయాగ్రమ్ వంటిది లేదా యితర క్లాసులతో దాని సంభందాన్ని తెలిపే డయాగ్రమ్. ఈ అంశము ఐచ్చికము.

en: To avoid unnecessary recompilation after doc-changes put the section docs into the c-source where possible.
te: అనవసరపు రికంపైలేషన్‌ను విసర్జించుటకు doc-changes తర్వాత విభాగపు పత్రములను c-source నందు వీలైనచోట వుంచుము.

en: Documenting symbols
te: చిహ్నముల పత్రికీకరణ

en: 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 function are usually documented in the c-source and macros, struct and enum in the header file.
te: ప్రతి చిహ్నము (function, macro, struct, enum, signal మరియు property) విడివిడి బ్లాక్ నందు పత్రికీకరణ చేయబడినవి. బ్లాక్ అనునది చిహ్నము యొక్క నిర్వచనముకు దగ్గరా వుంచబడినది అలా వాటిని సింక్‌లో వుంచుట సులువు. ఫంక్షన్ సాధారణంగా c-source నందు మరియు macros, stuct మరియు enumలు హెడర్ ఫైలునందు పత్రికీకరణ చేయబడతాయి.

en: General tags
te: సాధారణ టాగ్లు

en: You can add versioning information to all documentation elements to tell when an api was introduced, or when it was deprecated.
te: మీరు వర్షనింగ్ సమాచారమును అన్ని పత్రికీకరణ మూలకాలకు జతచేయవచ్చును, api యెప్పుడు పరిచయం చేయబడిందో చెప్పుటకు, లేదా యెప్పుడు తీసివేయబడిందో చెప్పుటకు.

en: Versioning Tags
te: వర్షనింగ్ టాగ్స్

en: Since:
te: అప్పటినుంచి:

en: Description since which version of the code the API is available.
te: కోడ్ యొక్క యే వర్షన్ నుండి API అందుబాటులోవుందో వివరణ.

en: Deprecated:
te: తీసివేసిన:

en: Paragraph denoting that this function should no be used anymore. The description should point the reader to the new API.
te: ఈ ఫంక్షన్ యికపై వుపయోగించుటలేదని పారాగ్రాఫ్ చెబుచున్నది. వివరణ చదువరిని కొత్త APIకు సూచించాలి.

en: (FIXME : Stability information)
te: (FIXME : స్థిరత్వ సమాచారము)

en: Function comment block
te: ఫంక్షన్ వ్యాఖ్యానపు బ్లాక్

en: Document whether returned objects, lists, strings, etc, should be freed/unrefed/released.
te: తిరిగివచ్చిన objects, lists, strings, మొదలగునవి, freed/unrefed/released చేయాలా వద్దా అనేదానిపై పత్రము.

en: Document whether parameters can be NULL, and what happens if they are.
te: పారామితులు NULL కావచ్చా, వొకవేళ అయితే యేమి జరుగును అనేదానిపై పత్రము.

en: Mention interesting pre-conditions and post-conditions where appropriate.
te: తగుచోట్ల ఆసక్తికరమైన ప్రి-కండీషన్లు మరియు పోస్ట్-కండీషన్లను తెలుపుము.

en: Please remember to: <placeholder-1/>
te: దయచేసి దీనికి గుర్తువుంచండి: <placeholder-1/>

en: Gtk-doc assumes all symbols (macros, functions) starting with '_' are private. They are treated like static functions.
te: Gtk-doc అన్ని చిహ్నములు (macros, functions) '_'తో ప్రారంభమగునవి వ్యక్తిగతమైనవని పరిగణించును. అవి స్టాటిక్ ఫంక్షన్సు వలె పరిగణించబడును.

en: Also, take a look at gobject introspection annotation tags: http://live.gnome.org/GObjectIntrospection/Annotations
te: gobject యింట్రోస్పెక్షన్ యెన్నోయేషన్ టాగ్స్ వద్ద కూడా చూడండి: http://live.gnome.org/GObjectIntrospection/Annotations

en: Function tags
te: ఫంక్షన్ టాగ్లు

en: Returns:
te: తిరిగివచ్చినవి:

en: Paragraph describing the returned result.
te: పారాగ్రాఫ్ తిరిగివచ్చిన ఫలితాన్ని వివరిస్తుంది.

en: In case the function has variadic arguments, you should use this tag (@Varargs: does also work for historic reasons).
te: ఒకవేళ ఫంక్షన్ వేరియాడిక్ ఆర్గుమెంట్లను కలిగివుంటే, మీరు ఈ టాగ్‌ను వుపయోగించాలి (@Varargs: చారిత్రక కారణాలకు కూడా పనిచేయును).

en: Property comment block
te: లక్షణము వ్యాఖ్యాము బ్లాక్

en: Signal comment block
te: సంకేతపు వ్యాఖ్యానము బ్లాక్

en: Document when the signal is emitted and whether it is emitted before or after other signals.
te: సంకేతము యెప్పుడు వెలువడింది మరియు అది సంకేతముల ముందు వెలువడిందా లేదా తర్వాత అనేది పత్రికీకరణ చేయును.

en: Document what an application might do in the signal handler.
te: సంకేత సంభాలిక నందు వొక అనువర్తనము యేమి చేయవచ్చును అనే పత్రము.

en: Struct comment block
te: Struct వ్యాఖ్యానము బ్లాక్

en: Use <code>/*&lt; private &gt;*/</code> before the private struct fields you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behavirour.
te: మీరు మరుగున వుంచాలని అనుకొంటే private struct క్షేత్రముల ముందు <code>/*&lt; private &gt;*/</code> వుపయోగించు. విలోమ ప్రవర్తన కొరకు <code>/*&lt; public &gt;*/</code> వుపయోగించు.

en: Enum comment block
te: Enum వ్యాఖ్యానము బ్లాక్

en: Use <code>/*&lt; private &gt;*/</code> before the private enum values you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behavirour.
te: మీరు మరుగున వుంచాలని అనుకొంటే private enum విలువుల ముందు <code>/*&lt; private &gt;*/</code> వుపయోగించు. విలోమ ప్రవర్తన కొరకు <code>/*&lt; public &gt;*/</code> వుపయోగించు.

en: Useful DocBook tags
te: ఉపయోగకర DocBook టాగ్స్

en: Here are some DocBook tags which are most useful when documenting the code.
te: కోడ్‌ను పత్రికీకరణ చేయునప్పుడు యెక్కువ వుపయోగకరంగా వుండే మరికొన్ని DocBook టాగ్స్ యిక్కడ వున్నాయి.

en: To link to another section in the GTK docs: <placeholder-1/> The linkend is the SGML/XML id on the top item of the page you want to link to. For most pages this is currently the part ("gtk", "gdk", "glib") and then the page title ("Hash Tables"). For widgets it is just the class name. Spaces and underscores are converted to '-' to conform to SGML/XML.
te: GTK docs నందు వేరొక విభాగమునకు లింకు చేయుటకు: <placeholder-1/> మీరు లింకు యేర్పరచాలని కొరుకొనుచున్న పేజీ యొక్క పై అంశముపై SGML/XML idయే linkend. చాలా పేజీలకు ప్రస్తుతం యిదే పార్ట్ ("gtk", "gdk", "glib") మరియు పేజీ శీర్షిక ("Hash Tables"). విడ్జట్లకు యిది క్లాస్ నామము మాత్రమే. SGML/XML నిర్ధారించుటకు ఖాళీలు మరియు అండర్‌స్కోర్లు '-'గా మార్చబడినవి.

en: To refer to an external function, e.g. a standard C function: <placeholder-1/>
te: బాహ్య ఫంక్షన్‌ను సూచించుటకు, ఉ.దా. ప్రామాణిక C ఫంక్షన్: <placeholder-1/>

en: To include example code: <placeholder-1/> or possibly this, for very short code fragments which don't need a title: <placeholder-2/> For the latter GTK-Doc also supports an abbreviation: <![CDATA[
    |[
      ...
    ]|
    ]]>
te: ఉదాహరణ కోడ్‌ను చేర్చుటకు: <placeholder-1/> లేదా, శీర్షిక అవసరములేని చాలా చిన్న కోడ్ ముక్కల కొరకు: <placeholder-2/> తరువాతి GTK-Doc కూడా అబ్రివేషన్‌ను మద్దతించును: <![CDATA[
    |[
      ...
    ]|
    ]]>
