Debian Codegraph @

help/manual/kk/kk.po

raw
1 # Kazakh translation for gtk-doc.
2 # Copyright (C) 2026 gtk-doc's COPYRIGHT HOLDER
3 # This file is distributed under the same license as the gtk-doc package.
4 # Baurzhan Muftakhidinov <[email protected]>, 2026.
5 #
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: gtk-doc master\n"
9 "POT-Creation-Date: 2026-03-11 00:44+0000\n"
10 "PO-Revision-Date: 2026-03-11 07:08+0500\n"
11 "Last-Translator: Baurzhan Muftakhidinov <[email protected]>\n"
12 "Language-Team: Kazakh <Kazakh>\n"
13 "Language: kk\n"
14 "MIME-Version: 1.0\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
17 "X-Generator: Poedit 3.8\n"
18
19 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
20 msgctxt "_"
21 msgid "translator-credits"
22 msgstr "Baurzhan Muftakhidinov <[email protected]>"
23
24 #. (itstool) path: bookinfo/title
25 #: C/index.docbook:12
26 msgid "GTK-Doc Manual"
27 msgstr "GTK-Doc нұсқаулығы"
28
29 #. (itstool) path: bookinfo/edition
30 #: C/index.docbook:13
31 msgid "1.24.1"
32 msgstr "1.24.1"
33
34 #. (itstool) path: abstract/para
35 #: C/index.docbook:14
36 msgid "User manual for developers with instructions of GTK-Doc usage."
37 msgstr ""
38 "Әзірлеушілерге арналған GTK-Doc қолдану нұсқаулары бар пайдаланушы нұсқаулығы."
39
40 #. (itstool) path: authorgroup/author
41 #: C/index.docbook:16
42 msgid ""
43 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> <address> "
44 "<email>[email protected]</email> </address> </affiliation>"
45 msgstr ""
46 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> <address> "
47 "<email>[email protected]</email> </address> </affiliation>"
48
49 #. (itstool) path: authorgroup/author
50 #: C/index.docbook:25
51 msgid ""
52 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
53 "<email>[email protected]</email> </address> </affiliation>"
54 msgstr ""
55 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
56 "<email>[email protected]</email> </address> </affiliation>"
57
58 #. (itstool) path: authorgroup/author
59 #: C/index.docbook:34
60 msgid ""
61 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
62 "<address> <email>[email protected]</email> </address> </affiliation>"
63 msgstr ""
64 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
65 "<address> <email>[email protected]</email> </address> </affiliation>"
66
67 #. (itstool) path: publisher/publishername
68 #: C/index.docbook:45
69 msgid "GTK-Doc project"
70 msgstr "GTK-Doc жобасы"
71
72 #. (itstool) path: bookinfo/publisher
73 #: C/index.docbook:44
74 msgid ""
75 "<_:publishername-1/> <address><email>[email protected]</email></address>"
76 msgstr ""
77 "<_:publishername-1/> <address><email>[email protected]</email></address>"
78
79 #. (itstool) path: bookinfo/copyright
80 #: C/index.docbook:48
81 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
82 msgstr "<year>2000, 2005</year> <holder>Dan Mueth және Chris Lyttle</holder>"
83
84 #. (itstool) path: bookinfo/copyright
85 #: C/index.docbook:52
86 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
87 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
88
89 #. (itstool) path: legalnotice/para
90 #: C/index.docbook:65
91 msgid ""
92 "Permission is granted to copy, distribute and/or modify this document under "
93 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
94 "Version 1.1 or any later version published by the Free Software Foundation "
95 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
96 "copy of the license is <link linkend=\"fdl\">included</link>."
97 msgstr ""
98 "Бұл құжатты Free Software Foundation жариялаған <citetitle>GNU Free "
99 "Documentation License</citetitle> 1.1 нұсқасы немесе кез келген соңғы "
100 "нұсқасының шарттарына сәйкес, Тұрақты бөлімдерсіз, Алдыңғы мұқаба мәтіндерсіз "
101 "және Артқы мұқаба мәтіндерсіз көшіруге, таратуға және/немесе өзгертуге рұқсат "
102 "етіледі. Лицензияның көшірмесі <link linkend=\"fdl\">қоса берілген</link>."
103
104 #. (itstool) path: legalnotice/para
105 #: C/index.docbook:73
106 msgid ""
107 "Many of the names used by companies to distinguish their products and services "
108 "are claimed as trademarks. Where those names appear in any GNOME "
109 "documentation, and those trademarks are made aware to the members of the GNOME "
110 "Documentation Project, the names have been printed in caps or initial caps."
111 msgstr ""
112 "Компаниялар өздерінің өнімдері мен қызметтерін ерекшелеу үшін пайдаланатын "
113 "көптеген атаулар сауда белгілері болып табылады. Мұндай атаулар кез келген "
114 "GNOME құжаттамасында кездескенде және GNOME құжаттама жобасының мүшелеріне сол "
115 "сауда белгілері туралы мәлім болса, бұл атаулар БАС ӘРІПТЕРМЕН немесе Бас "
116 "әріппен басталып жазылған."
117
118 #. (itstool) path: revhistory/revision
119 #: C/index.docbook:83
120 msgid ""
121 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
122 "authorinitials> <revremark>gtk4 version</revremark>"
123 msgstr ""
124 "<revnumber>1.33.0</revnumber> <date>1 қазан 2020</date> <authorinitials>mc</"
125 "authorinitials> <revremark>gtk4 нұсқасы</revremark>"
126
127 #. (itstool) path: revhistory/revision
128 #: C/index.docbook:89
129 msgid ""
130 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
131 "authorinitials> <revremark>dev version</revremark>"
132 msgstr ""
133 "<revnumber>1.32.1</revnumber> <date>15 тамыз 2019</date> <authorinitials>ss</"
134 "authorinitials> <revremark>әзірлеу нұсқасы</revremark>"
135
136 #. (itstool) path: revhistory/revision
137 #: C/index.docbook:95
138 msgid ""
139 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
140 "authorinitials> <revremark>hotfix release</revremark>"
141 msgstr ""
142 "<revnumber>1.32</revnumber> <date>15 тамыз 2019</date> <authorinitials>ss</"
143 "authorinitials> <revremark>шұғыл түзету шығарылымы</revremark>"
144
145 #. (itstool) path: revhistory/revision
146 #: C/index.docbook:101
147 msgid ""
148 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
149 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
150 msgstr ""
151 "<revnumber>1.31</revnumber> <date>05 тамыз 2019</date> <authorinitials>ss</"
152 "authorinitials> <revremark>рефакторинг және көбірек тест қамтуы</revremark>"
153
154 #. (itstool) path: revhistory/revision
155 #: C/index.docbook:107
156 msgid ""
157 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
158 "authorinitials> <revremark>more test coverage</revremark>"
159 msgstr ""
160 "<revnumber>1.30</revnumber> <date>08 мамыр 2019</date> <authorinitials>ss</"
161 "authorinitials> <revremark>көбірек тест қамтуы</revremark>"
162
163 #. (itstool) path: revhistory/revision
164 #: C/index.docbook:113
165 msgid ""
166 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
167 "authorinitials> <revremark>bug fixes</revremark>"
168 msgstr ""
169 "<revnumber>1.29</revnumber> <date>28 тамыз 2018</date> <authorinitials>ss</"
170 "authorinitials> <revremark>қателерді түзету</revremark>"
171
172 #. (itstool) path: revhistory/revision
173 #: C/index.docbook:119
174 msgid ""
175 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
176 "authorinitials> <revremark>bug fixes</revremark>"
177 msgstr ""
178 "<revnumber>1.28</revnumber> <date>24 наурыз 2018</date> <authorinitials>ss</"
179 "authorinitials> <revremark>қателерді түзету</revremark>"
180
181 #. (itstool) path: revhistory/revision
182 #: C/index.docbook:125
183 msgid ""
184 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
185 "authorinitials> <revremark>fine tuning of the python port</revremark>"
186 msgstr ""
187 "<revnumber>1.27</revnumber> <date>07 желтоқсан 2017</date> <authorinitials>ss</"
188 "authorinitials> <revremark>python портын дәл баптау</revremark>"
189
190 #. (itstool) path: revhistory/revision
191 #: C/index.docbook:131
192 msgid ""
193 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
194 "authorinitials> <revremark>port all tools from perl/bash to python</revremark>"
195 msgstr ""
196 "<revnumber>1.26</revnumber> <date>11 тамыз 2017</date> <authorinitials>ss</"
197 "authorinitials> <revremark>барлық саймандарды perl/bash-тан python-ға көшіру</"
198 "revremark>"
199
200 #. (itstool) path: revhistory/revision
201 #: C/index.docbook:137
202 msgid ""
203 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
204 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
205 msgstr ""
206 "<revnumber>1.25</revnumber> <date>21 наурыз 2016</date> <authorinitials>ss</"
207 "authorinitials> <revremark>қателерді түзету, тесттерді тазарту</revremark>"
208
209 #. (itstool) path: revhistory/revision
210 #: C/index.docbook:143
211 msgid ""
212 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
213 "authorinitials> <revremark>bug fix</revremark>"
214 msgstr ""
215 "<revnumber>1.24</revnumber> <date>29 мамыр 2015</date> <authorinitials>ss</"
216 "authorinitials> <revremark>қатені түзету</revremark>"
217
218 #. (itstool) path: revhistory/revision
219 #: C/index.docbook:149
220 msgid ""
221 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
222 "authorinitials> <revremark>bug fix</revremark>"
223 msgstr ""
224 "<revnumber>1.23</revnumber> <date>17 мамыр 2015</date> <authorinitials>ss</"
225 "authorinitials> <revremark>қатені түзету</revremark>"
226
227 #. (itstool) path: revhistory/revision
228 #: C/index.docbook:155
229 msgid ""
230 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
231 "authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>"
232 msgstr ""
233 "<revnumber>1.22</revnumber> <date>07 мамыр 2015</date> <authorinitials>ss</"
234 "authorinitials> <revremark>қателерді түзету, ескірген мүмкіндіктерді алып "
235 "тастау</revremark>"
236
237 #. (itstool) path: revhistory/revision
238 #: C/index.docbook:161
239 msgid ""
240 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
241 "authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>"
242 msgstr ""
243 "<revnumber>1.21</revnumber> <date>17 шілде 2014</date> <authorinitials>ss</"
244 "authorinitials> <revremark>қателерді түзету, ескірген мүмкіндіктерді алып "
245 "тастау</revremark>"
246
247 #. (itstool) path: revhistory/revision
248 #: C/index.docbook:167
249 msgid ""
250 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
251 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
252 "revremark>"
253 msgstr ""
254 "<revnumber>1.20</revnumber> <date>16 ақпан 2014</date> <authorinitials>ss</"
255 "authorinitials> <revremark>қателерді түзету, markdown қолдауы, стильді "
256 "жақсарту</revremark>"
257
258 #. (itstool) path: revhistory/revision
259 #: C/index.docbook:173
260 msgid ""
261 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
262 "authorinitials> <revremark>bug fixes</revremark>"
263 msgstr ""
264 "<revnumber>1.19</revnumber> <date>05 маусым 2013</date> <authorinitials>ss</"
265 "authorinitials> <revremark>қателерді түзету</revremark>"
266
267 #. (itstool) path: revhistory/revision
268 #: C/index.docbook:179
269 msgid ""
270 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
271 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
272 msgstr ""
273 "<revnumber>1.18</revnumber> <date>14 қыркүйек 2011</date> <authorinitials>ss</"
274 "authorinitials> <revremark>қателерді түзету, жылдамдату, markdown қолдауы</"
275 "revremark>"
276
277 #. (itstool) path: revhistory/revision
278 #: C/index.docbook:185
279 msgid ""
280 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
281 "authorinitials> <revremark>urgent bug fix update</revremark>"
282 msgstr ""
283 "<revnumber>1.17</revnumber> <date>26 ақпан 2011</date> <authorinitials>sk</"
284 "authorinitials> <revremark>шұғыл қателерді түзету жаңартуы</revremark>"
285
286 #. (itstool) path: revhistory/revision
287 #: C/index.docbook:191
288 msgid ""
289 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
290 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
291 msgstr ""
292 "<revnumber>1.16</revnumber> <date>14 қаңтар 2011</date> <authorinitials>sk</"
293 "authorinitials> <revremark>қателерді түзету, жайманы жақсарту</revremark>"
294
295 #. (itstool) path: revhistory/revision
296 #: C/index.docbook:197
297 msgid ""
298 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
299 "authorinitials> <revremark>bug and regression fixes</revremark>"
300 msgstr ""
301 "<revnumber>1.15</revnumber> <date>21 мамыр 2010</date> <authorinitials>sk</"
302 "authorinitials> <revremark>қателер мен регрессияларды түзету</revremark>"
303
304 #. (itstool) path: revhistory/revision
305 #: C/index.docbook:203
306 msgid ""
307 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
308 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
309 msgstr ""
310 "<revnumber>1.14</revnumber> <date>28 наурыз 2010</date> <authorinitials>sk</"
311 "authorinitials> <revremark>қателерді түзету және өнімділікті жақсарту</"
312 "revremark>"
313
314 #. (itstool) path: revhistory/revision
315 #: C/index.docbook:209
316 msgid ""
317 "<revnumber>1.13</revnumber> <date>18 December 2009</date> <authorinitials>sk</"
318 "authorinitials> <revremark>broken tarball update</revremark>"
319 msgstr ""
320 "<revnumber>1.13</revnumber> <date>18 желтоқсан 2009</date> <authorinitials>sk</"
321 "authorinitials> <revremark>бүлінген tarball жаңартуы</revremark>"
322
323 #. (itstool) path: revhistory/revision
324 #: C/index.docbook:215
325 msgid ""
326 "<revnumber>1.12</revnumber> <date>18 December 2009</date> <authorinitials>sk</"
327 "authorinitials> <revremark>new tool features and bugfixes</revremark>"
328 msgstr ""
329 "<revnumber>1.12</revnumber> <date>18 желтоқсан 2009</date> <authorinitials>sk</"
330 "authorinitials> <revremark>сайманның жаңа мүмкіндіктері мен қателерді түзету</"
331 "revremark>"
332
333 #. (itstool) path: revhistory/revision
334 #: C/index.docbook:221
335 msgid ""
336 "<revnumber>1.11</revnumber> <date>16 November 2008</date> <authorinitials>mal</"
337 "authorinitials> <revremark>GNOME doc-utils migration</revremark>"
338 msgstr ""
339 "<revnumber>1.11</revnumber> <date>16 қараша 2008</date> <authorinitials>mal</"
340 "authorinitials> <revremark>GNOME doc-utils миграциясы</revremark>"
341
342 #. (itstool) path: chapter/title
343 #: C/index.docbook:234
344 msgid "Introduction"
345 msgstr "Кіріспе"
346
347 #. (itstool) path: chapter/para
348 #: C/index.docbook:236
349 msgid ""
350 "This chapter introduces GTK-Doc and gives an overview of what it is and how it "
351 "is used."
352 msgstr ""
353 "Бұл тарау GTK-Doc-пен таныстырады және оның не екендігі мен қалай "
354 "қолданылатыны туралы шолу береді."
355
356 #. (itstool) path: sect1/title
357 #: C/index.docbook:242
358 msgid "What is GTK-Doc?"
359 msgstr "GTK-Doc дегеніміз не?"
360
361 #. (itstool) path: sect1/para
362 #: C/index.docbook:244
363 msgid ""
364 "GTK-Doc is used to document C code. It is typically used to document the "
365 "public API of libraries, such as GLib-based libraries, but it can also be used "
366 "to document application code."
367 msgstr ""
368 "GTK-Doc C кодын құжаттау үшін пайдаланылады. Ол әдетте GLib негізіндегі "
369 "кітапханалар сияқты кітапханалардың ашық API-ін құжаттау үшін қолданылады, "
370 "бірақ оны қолданба кодын құжаттау үшін де пайдалануға болады."
371
372 #. (itstool) path: sect1/title
373 #: C/index.docbook:252
374 msgid "How Does GTK-Doc Work?"
375 msgstr "GTK-Doc қалай жұмыс істейді?"
376
377 #. (itstool) path: sect1/para
378 #: C/index.docbook:254
379 msgid ""
380 "GTK-Doc works by reading specially-formatted comment blocks placed inside the "
381 "source files to document symbols such as functions, macros, structs, enums, "
382 "etc. (though note that for most kind of symbols GTK-Doc will only document the "
383 "symbols that are declared in header files; for example it won't produce output "
384 "for static functions)."
385 msgstr ""
386 "GTK-Doc функциялар, макростар, құрылымдар, тізімдер және т.б. сияқты "
387 "таңбаларды құжаттау үшін бастапқы файлдар ішіне орналастырылған арнайы "
388 "пішімделген түсініктеме блоктарын оқу арқылы жұмыс істейді (бірақ таңбалардың "
389 "көптеген түрлері үшін GTK-Doc тек тақырыптық файлдарда жарияланған таңбаларды "
390 "ғана құжаттайтынын ескеріңіз; мысалы, ол статикалық функциялар үшін нәтиже "
391 "бермейді)."
392
393 #. (itstool) path: sect1/para
394 #: C/index.docbook:262
395 msgid ""
396 "GTK-Doc also reads template files where documentation can be added there as "
397 "well."
398 msgstr ""
399 "GTK-Doc сонымен қатар құжаттаманы қосуға болатын үлгі файлдарын да оқиды."
400
401 #. (itstool) path: sect1/para
402 #: C/index.docbook:267
403 msgid ""
404 "GTK-Doc consists of a number of programs, each performing a different step in "
405 "the process."
406 msgstr ""
407 "GTK-Doc бірнеше бағдарламадан тұрады, олардың әрқайсысы процестің әртүрлі "
408 "қадамын орындайды."
409
410 #. (itstool) path: sect1/para
411 #: C/index.docbook:272
412 msgid "The main steps are:"
413 msgstr "Негізгі қадамдар:"
414
415 #. (itstool) path: listitem/para
416 #: C/index.docbook:279
417 msgid ""
418 "<guilabel>Writing the documentation.</guilabel> The author fills in the source "
419 "files with the documentation for each function, macro, structs or unions, etc."
420 msgstr ""
421 "<guilabel>Құжаттаманы жазу.</guilabel> Автор бастапқы файлдарды әрбір функция, "
422 "макрос, құрылымдар немесе біріктірулер және т.б. үшін құжаттамамен толтырады."
423
424 #. (itstool) path: listitem/para
425 #: C/index.docbook:288
426 msgid ""
427 "<guilabel>Gathering information about the code.</guilabel> <application>gtkdoc-"
428 "scan</application> scans the header files of the code looking for declarations "
429 "of functions, macros, enums, structs, and unions. It creates the file "
430 "<filename>&lt;module&gt;-decl-list.txt</filename> containing a list of the "
431 "declarations, placing them into sections according to which header file they "
432 "are in. On the first run this file is copied to <filename>&lt;module&gt;-"
433 "sections.txt</filename>. The author can rearrange the sections, and the order "
434 "of the declarations within them, to produce the final desired order. The "
435 "second file it generates is <filename>&lt;module&gt;-decl.txt</filename>. This "
436 "file contains the full declarations found by the scanner. If for some reason "
437 "one would like some symbols to show up in the docs, where the full declaration "
438 "cannot be found by the scanner or the declaration should appear differently, "
439 "one can place entities similar to the ones in <filename>&lt;module&gt;-"
440 "decl.txt</filename> into <filename>&lt;module&gt;-overrides.txt</filename>."
441 msgstr ""
442 "<guilabel>Код туралы ақпаратты жинау.</guilabel> <application>gtkdoc-scan</"
443 "application> кодтың тақырыптық файлдарын функциялар, макростар, тізімдер, "
444 "құрылымдар және біріктірулердің декларацияларын іздеп сканерлейді. Ол "
445 "декларациялар тізімі бар <filename>&lt;module&gt;-decl-list.txt</filename> "
446 "файлын жасайды және оларды қай тақырыптық файлда болғанына байланысты "
447 "бөлімдерге орналастырады. Бірінші іске қосуда бұл файл "
448 "<filename>&lt;module&gt;-sections.txt</filename> файлына көшіріледі. Автор "
449 "соңғы қалаған реттілікке қол жеткізу үшін бөлімдерді және олардың ішіндегі "
450 "декларациялар ретін қайта реттей алады. Ол жасайтын екінші файл — "
451 "<filename>&lt;module&gt;-decl.txt</filename>. Бұл файлда сканер тапқан толық "
452 "декларациялар болады. Егер қандай да бір себеппен сканер толық декларацияны "
453 "таба алмаса немесе декларация басқаша көрінуі тиіс болса және кейбір "
454 "таңбалардың құжаттарда көрінуін қаласаңыз, <filename>&lt;module&gt;-decl.txt</"
455 "filename> файлындағыға ұқсас нысандарды <filename>&lt;module&gt;-"
456 "overrides.txt</filename> файлына орналастыруға болады."
457
458 #. (itstool) path: listitem/para
459 #: C/index.docbook:308
460 msgid ""
461 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
462 "query a library about any GObject subclasses it exports. It saves information "
463 "about each object's position in the class hierarchy and about any GObject "
464 "properties and signals it provides."
465 msgstr ""
466 "<application>gtkdoc-scangobj</application> сонымен қатар кітапханадан ол "
467 "экспорттайтын кез келген GObject ішкі кластары туралы динамикалық түрде сұрау "
468 "үшін пайдаланылуы мүмкін. Ол әрбір объектінің класс иерархиясындағы орны және "
469 "ол беретін кез келген GObject қасиеттері мен сигналдары туралы ақпаратты "
470 "сақтайды."
471
472 #. (itstool) path: listitem/para
473 #: C/index.docbook:314
474 msgid ""
475 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
476 "needed in the past when GObject was still GtkObject inside GTK."
477 msgstr ""
478 "<application>gtkdoc-scanobj</application> бұдан былай пайдаланылмауы керек. Ол "
479 "бұрын GObject әлі GTK ішінде GtkObject болған кезде қажет болған."
480
481 #. (itstool) path: listitem/para
482 #: C/index.docbook:322
483 msgid ""
484 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
485 "mkdb</application> turns the template files into XML files in the <filename "
486 "class=\"directory\">xml/</filename> subdirectory. If the source code contains "
487 "documentation for symbols, using the special comment blocks, it gets merged in "
488 "here. If there are no tmpl files used it only reads docs from sources and "
489 "introspection data."
490 msgstr ""
491 "<guilabel>XML және HTML/PDF жасау.</guilabel> <application>gtkdoc-mkdb</"
492 "application> үлгі файлдарын <filename class=\"directory\">xml/</filename> ішкі "
493 "бумасындағы XML файлдарына айналдырады. Егер бастапқы кодта арнайы түсініктеме "
494 "блоктарын пайдаланатын таңбаларға арналған құжаттама болса, ол осында "
495 "біріктіріледі. Егер tmpl файлдары пайдаланылмаса, ол құжаттарды тек бастапқы "
496 "кодтар мен интроспекция деректерінен оқиды."
497
498 #. (itstool) path: listitem/para
499 #: C/index.docbook:332
500 msgid ""
501 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
502 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
503 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
504 "document called <filename>&lt;package&gt;.pdf</filename>."
505 msgstr ""
506 "<application>gtkdoc-mkhtml</application> XML файлдарын <filename "
507 "class=\"directory\">html/</filename> ішкі бумасындағы HTML файлдарына "
508 "айналдырады. Сол сияқты <application>gtkdoc-mkpdf</application> XML файлдарын "
509 "<filename>&lt;package&gt;.pdf</filename> деп аталатын PDF құжатына айналдырады."
510
511 #. (itstool) path: listitem/para
512 #: C/index.docbook:339
513 msgid ""
514 "Files in <filename class=\"directory\">xml/</filename> and <filename "
515 "class=\"directory\">html/</filename> directories are always overwritten. One "
516 "should never edit them directly."
517 msgstr ""
518 "<filename class=\"directory\">xml/</filename> және <filename "
519 "class=\"directory\">html/</filename> бумаларындағы файлдар әрқашан қайта "
520 "жазылады. Оларды ешқашан тікелей түзетуге болмайды."
521
522 #. (itstool) path: listitem/para
523 #: C/index.docbook:347
524 msgid ""
525 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
526 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
527 "run to fix up any cross-references between separate documents. For example, "
528 "the GTK documentation contains many cross-references to types documented in "
529 "the GLib manual."
530 msgstr ""
531 "<guilabel>Құжаттар арасындағы өзара сілтемелерді түзету.</guilabel> HTML "
532 "файлдарын орнатқаннан кейін, бөлек құжаттар арасындағы кез келген өзара "
533 "сілтемелерді түзету үшін <application>gtkdoc-fixxref</application> "
534 "бағдарламасын іске қосуға болады. Мысалы, GTK құжаттамасында GLib "
535 "нұсқаулығында құжатталған типтерге көптеген өзара сілтемелер бар."
536
537 #. (itstool) path: listitem/para
538 #: C/index.docbook:356
539 msgid ""
540 "When creating the source tarball for distribution, <application>gtkdoc-rebase</"
541 "application> turns all external links into web-links. When installing "
542 "distributed (pregenerated) docs the same application will try to turn links "
543 "back to local links (where those docs are installed)."
544 msgstr ""
545 "Таратуға арналған бастапқы архивті жасау кезінде <application>gtkdoc-rebase</"
546 "application> барлық сыртқы сілтемелерді веб-сілтемелерге айналдырады. "
547 "Таратылатын (алдын ала жасалған) құжаттарды орнатқан кезде дәл сол қолданба "
548 "сілтемелерді жергілікті сілтемелерге (сол құжаттар орнатылған жерге) қайта "
549 "айналдыруға тырысады."
550
551 #. (itstool) path: sect1/title
552 #: C/index.docbook:369
553 msgid "Getting GTK-Doc"
554 msgstr "GTK-Doc алу"
555
556 #. (itstool) path: sect2/title
557 #: C/index.docbook:372
558 msgid "Requirements"
559 msgstr "Талаптар"
560
561 #. (itstool) path: sect2/para
562 #: C/index.docbook:373
563 msgid "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
564 msgstr ""
565 "<guilabel>python 2/3</guilabel> - негізгі скрипттер python тілінде жазылған."
566
567 #. (itstool) path: sect2/para
568 #: C/index.docbook:376
569 msgid ""
570 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink "
571 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
572 msgstr ""
573 "<guilabel>xsltproc</guilabel> - libxslt-тен алынған xslt процессоры <ulink "
574 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
575
576 #. (itstool) path: sect2/para
577 #: C/index.docbook:380
578 msgid ""
579 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink "
580 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
581 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
582 msgstr ""
583 "<guilabel>docbook-xsl</guilabel> - docbook xsl стиль кестелері <ulink "
584 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
585 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
586
587 #. (itstool) path: sect2/para
588 #: C/index.docbook:384
589 msgid ""
590 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
591 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
592 "examples"
593 msgstr ""
594 "<guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> немесе "
595 "<guilabel>vim</guilabel> біреуі - міндетті емес - мысалдардың синтаксисін "
596 "жарықтандыру үшін қолданылады"
597
598 #. (itstool) path: sect1/title
599 #: C/index.docbook:392
600 msgid "About GTK-Doc"
601 msgstr "GTK-Doc туралы"
602
603 #. (itstool) path: sect1/para
604 #: C/index.docbook:394
605 msgid ""
606 "Historically GTK-Doc was used to generate template files from the sources "
607 "code. These template files could be used by developers to enter the API "
608 "documentation. This approach was rather inconvenient because it required to "
609 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
610 "possible to place all API information into source comments, which made the "
611 "template support obsolete. In version 1.26 template support has been removed."
612 msgstr ""
613 "Тарихи тұрғыдан GTK-Doc бастапқы кодтан үлгі файлдарын жасау үшін қолданылған. "
614 "Бұл үлгі файлдарын әзірлеушілер API құжаттамасын енгізу үшін пайдалана алатын. "
615 "Бұл тәсіл өте ыңғайсыз болды, өйткені ол жасалған файлдарды нұсқаларды бақылау "
616 "жүйесінде сақтауды талап етті. GTK-Doc 1.9 нұсқасынан бастап барлық API "
617 "ақпаратын бастапқы код түсіндірмелеріне орналастыру мүмкін болды, бұл "
618 "үлгілерді қолдауды қажетсіз етті. 1.26 нұсқасында үлгілерді қолдау мүлдем "
619 "алынып тасталды."
620
621 #. (itstool) path: sect1/para
622 #: C/index.docbook:404 C/index.docbook:418
623 msgid "(FIXME)"
624 msgstr "(ТҮЗЕТУ КЕРЕК)"
625
626 #. (itstool) path: sect1/para
627 #: C/index.docbook:408
628 msgid ""
629 "(authors, web pages, mailing list, license, future plans, comparison with "
630 "other similar systems.)"
631 msgstr ""
632 "(авторлар, веб-беттер, тарату тізімі, лицензия, болашақ жоспарлар, басқа ұқсас "
633 "жүйелермен салыстыру.)"
634
635 #. (itstool) path: sect1/title
636 #: C/index.docbook:416
637 msgid "About this Manual"
638 msgstr "Бұл нұсқаулық туралы"
639
640 #. (itstool) path: sect1/para
641 #: C/index.docbook:422
642 msgid "(who it is meant for, where you can get it, license)"
643 msgstr "(кімге арналған, қайдан алуға болады, лицензия)"
644
645 #. (itstool) path: chapter/title
646 #: C/index.docbook:431
647 msgid "Project Setup"
648 msgstr "Жобаны баптау"
649
650 #. (itstool) path: chapter/para
651 #: C/index.docbook:433
652 msgid ""
653 "This Chapter describes the steps that are necessary to integrate GTK-Doc into "
654 "your project. The integration of GTK-Doc into a project includes the following "
655 "steps:"
656 msgstr ""
657 "Бұл тарауда GTK-Doc-ты жобаңызға біріктіру үшін қажетті қадамдар сипатталған. "
658 "GTK-Doc-ты жобаға біріктіру келесі қадамдарды қамтиды:"
659
660 #. (itstool) path: listitem/para
661 #: C/index.docbook:441
662 msgid ""
663 "Preparation of the directory structure and creating required configuration "
664 "files for your GTK-Doc documentation (see <link "
665 "linkend=\"settingup_docfiles\"> Setting up a skeleton documentation</link>)."
666 msgstr ""
667 "Бума құрылымын дайындау және GTK-Doc құжаттамаңыз үшін қажетті конфигурация "
668 "файлдарын жасау (<link linkend=\"settingup_docfiles\">Құжаттама қаңқасын "
669 "баптау</link> қараңыз)."
670
671 #. (itstool) path: listitem/para
672 #: C/index.docbook:449
673 msgid ""
674 "Adjusting the build system to build your documentation using the GTK-Doc "
675 "tools. Multiple build systems are supported, in this manual we describe how to "
676 "integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</link>, "
677 "<link linkend=\"settingup_cmake\">CMake</link>, and <link "
678 "linkend=\"settingup_plain_makefiles\">plain Makefiles</link>."
679 msgstr ""
680 "GTK-Doc саймандарын пайдаланып құжаттамаңызды құрастыру үшін құрастыру жүйесін "
681 "реттеу. Бірнеше құрастыру жүйелеріне қолдау көрсетіледі, бұл нұсқаулықта біз "
682 "GTK-Doc-ты <link linkend=\"settingup_autotools\">Autotools</link>, <link "
683 "linkend=\"settingup_cmake\">CMake</link> және <link "
684 "linkend=\"settingup_plain_makefiles\">жай Makefiles</link> жүйелерімен қалай "
685 "біріктіруге болатынын сипаттаймыз."
686
687 #. (itstool) path: listitem/para
688 #: C/index.docbook:459
689 msgid ""
690 "Adding GTK-Doc specific files to version control and deciding which files to "
691 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version control "
692 "systems</link>)."
693 msgstr ""
694 "GTK-Doc арнайы файлдарын нұсқаларды бақылау жүйесіне қосу және қай файлдарды "
695 "елемеу керектігін шешу (<link linkend=\"settingup_vcs\">Нұсқаларды бақылау "
696 "жүйелерімен біріктіру</link> қараңыз)."
697
698 #. (itstool) path: chapter/para
699 #: C/index.docbook:467
700 msgid ""
701 "The following sections assume we work on a project called <code>meep</code>. "
702 "This project contains two packages (or modules), a library called "
703 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
704 msgstr ""
705 "Келесі бөлімдерде біз <code>meep</code> деп аталатын жобада жұмыс істейміз деп "
706 "есептейміз. Бұл жоба екі дестеден (немесе модульден) тұрады: <code>libmeep</"
707 "code> деп аталатын кітапхана және <code>meeper</code> деп аталатын соңғы "
708 "пайдаланушы қолданбасы."
709
710 #. (itstool) path: sect1/title
711 #: C/index.docbook:476
712 msgid "Setting up a skeleton documentation"
713 msgstr "Құжаттама қаңқасын баптау"
714
715 #. (itstool) path: sect1/para
716 #: C/index.docbook:478
717 msgid ""
718 "A common convention is to place documentation into a folder called <code>docs</"
719 "code> inside your top-level project directory. We usually distinguish between "
720 "<emphasis>reference documentation</emphasis> intended for developers and an "
721 "<emphasis>user manual</emphasis> intended for end-users. Again the convention "
722 "is to have separate folders for both. We usually place the reference "
723 "documentation in a folder named <code>reference</code> and the end-user manual "
724 "in a folder named <code>help</code> as. According to the above convention the "
725 "documentation for our <code>libmeep</code> package would be placed into: "
726 "<code>docs/reference/libmeep</code>. For packages with just one library or "
727 "application the documentation could also be placed directly into <code>docs/"
728 "reference</code>. It is not mandatory to use the above convention, but if you "
729 "choose to use a different directory structure you must adjust your build "
730 "system configuration to match your directory structure."
731 msgstr ""
732 "Жалпы қабылданған ереже — құжаттаманы жобаңыздың жоғарғы деңгейлі бумасындағы "
733 "<code>docs</code> деп аталатын бумаға орналастыру. Біз әдетте әзірлеушілерге "
734 "арналған <emphasis>анықтамалық құжаттама</emphasis> мен соңғы пайдаланушыларға "
735 "арналған <emphasis>пайдаланушы нұсқаулығын</emphasis> ажыратамыз. Тағы да, "
736 "екеуі үшін бөлек бумалардың болуы — қалыпты жағдай. Біз әдетте анықтамалық "
737 "құжаттаманы <code>reference</code> деп аталатын бумаға, ал пайдаланушы "
738 "нұсқаулығын <code>help</code> бумасына орналастырамыз. Жоғарыдағы ережеге "
739 "сәйкес, біздің <code>libmeep</code> дестеміз үшін құжаттама мына жерде "
740 "орналасады: <code>docs/reference/libmeep</code>. Тек бір кітапханасы немесе "
741 "қолданбасы бар дестелер үшін құжаттама тікелей <code>docs/reference</code> "
742 "ішіне де орналастырылуы мүмкін. Жоғарыдағы ережені қолдану міндетті емес, "
743 "бірақ егер сіз басқа бума құрылымын таңдасаңыз, құрастыру жүйесінің "
744 "конфигурациясын бума құрылымыңызға сәйкес реттеуіңіз керек."
745
746 #. (itstool) path: example/title
747 #: C/index.docbook:509
748 msgid "Example directory structure of <emphasis>meep</emphasis> project"
749 msgstr "<emphasis>meep</emphasis> жобасының бума құрылымының мысалы"
750
751 #. (itstool) path: example/programlisting
752 #: C/index.docbook:511
753 #, no-wrap
754 msgid ""
755 "\n"
756 "meep/\n"
757 " docs/\n"
758 " reference/ # reference documentation\n"
759 " libmeep/\n"
760 " meeper/\n"
761 " help/ # optional: user manual\n"
762 " meeper/\n"
763 " src/\n"
764 " libmeep/\n"
765 " meeper/\n"
766 msgstr ""
767 "\n"
768 "meep/\n"
769 " docs/\n"
770 " reference/ # анықтамалық құжаттама\n"
771 " libmeep/\n"
772 " meeper/\n"
773 " help/ # міндетті емес: пайдаланушы нұсқаулығы\n"
774 " meeper/\n"
775 " src/\n"
776 " libmeep/\n"
777 " meeper/\n"
778
779 #. (itstool) path: sect1/para
780 #: C/index.docbook:503
781 msgid ""
782 "In the following sections we will assume a directory structure for our "
783 "<emphasis>meep</emphasis> project that uses the above conventions. "
784 "<_:example-1/>"
785 msgstr ""
786 "Келесі бөлімдерде біз жоғарыдағы ережелерді пайдаланатын <emphasis>meep</"
787 "emphasis> жобасы үшін бума құрылымын қарастырамыз. <_:example-1/>"
788
789 #. (itstool) path: sect1/title
790 #: C/index.docbook:528
791 msgid "Integration with Autotools"
792 msgstr "Autotools-пен біріктіру"
793
794 #. (itstool) path: sect1/para
795 #: C/index.docbook:529
796 msgid ""
797 "Integration of GTK-Doc into an autotools-based build system requires the "
798 "following steps:"
799 msgstr ""
800 "GTK-Doc-ты autotools-қа негізделген құрастыру жүйесіне біріктіру келесі "
801 "қадамдарды талап етеді:"
802
803 #. (itstool) path: listitem/para
804 #: C/index.docbook:535
805 msgid ""
806 "Ensure that <application>gtkdocize</application> is run once before the "
807 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
808 "script is present, adjust it to check for GTK-Doc and add a call to "
809 "<application>gtkdocize</application>."
810 msgstr ""
811 "<application>gtkdocize</application> бағдарламасы <filename>configure</"
812 "filename> скриптінен бұрын бір рет іске қосылғанына көз жеткізіңіз. Егер "
813 "<filename>autogen.sh</filename> скрипті болса, оны GTK-Doc-ты тексеру үшін "
814 "реттеп, <application>gtkdocize</application> шақыруын қосыңыз."
815
816 #. (itstool) path: listitem/para
817 #: C/index.docbook:543
818 msgid ""
819 "The main purpose of <application>gtkdocize</application> is to make the "
820 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
821 "filename> macro definition file available to the build system, either by "
822 "copying or linking it into the project."
823 msgstr ""
824 "<application>gtkdocize</application> бағдарламасының негізгі мақсаты — "
825 "<filename>gtk-doc.make</filename> Makefile файлын және <filename>gtk-doc.m4</"
826 "filename> макрос анықтамасы файлын жобаға көшіру немесе сілтеу арқылы "
827 "құрастыру жүйесіне қолжетімді ету."
828
829 #. (itstool) path: listitem/para
830 #: C/index.docbook:552
831 msgid ""
832 "Add the necessary <application>autoconf</application> macros to "
833 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
834 "allow configuration of GTK-Doc via the generated <filename>configure</"
835 "filename> script."
836 msgstr ""
837 "Жасалған <filename>configure</filename> скрипті арқылы GTK-Doc конфигурациясын "
838 "жасауға мүмкіндік беру үшін құрастыру жүйесінде GTK-Doc-ты іске қосатын "
839 "<filename>configure.ac</filename> файлына қажетті <application>autoconf</"
840 "application> макростарын қосыңыз."
841
842 #. (itstool) path: listitem/para
843 #: C/index.docbook:558
844 msgid ""
845 "Among others with registers the <code>--enable-gtk-doc</code> option with the "
846 "<filename>configure</filename> script."
847 msgstr ""
848 "Басқалармен қатар, бұл <filename>configure</filename> скриптімен <code>--"
849 "enable-gtk-doc</code> опциясын тіркейді."
850
851 #. (itstool) path: listitem/para
852 #: C/index.docbook:564
853 msgid ""
854 "Create an <application>automake</application> script for each application or "
855 "library in your project. In the example used in this documentation this step "
856 "applies to both <code>meeper</code> and <code>libmeep</code>."
857 msgstr ""
858 "Жобаңыздағы әрбір қолданба немесе кітапхана үшін <application>automake</"
859 "application> скриптін жасаңыз. Осы құжаттамада пайдаланылған мысалда бұл қадам "
860 "<code>meeper</code> және <code>libmeep</code> екеуіне де қатысты."
861
862 #. (itstool) path: sect1/para
863 #: C/index.docbook:573
864 msgid ""
865 "In the following sections, we will perform the above steps in reverse order. "
866 "We start with the <application>automake</application> scripts and work our way "
867 "up to <filename>configure.ac</filename> and <filename>autogen.sh</filename>. "
868 "Then we show how enable Gtk-Doc in the build system and how to build the "
869 "documentation."
870 msgstr ""
871 "Келесі бөлімдерде біз жоғарыдағы қадамдарды кері ретпен орындаймыз. Біз "
872 "<application>automake</application> скрипттерінен бастап, "
873 "<filename>configure.ac</filename> және <filename>autogen.sh</filename> "
874 "файлдарына қарай жүреміз. Содан кейін құрастыру жүйесінде Gtk-Doc-ты қалай "
875 "іске қосуды және құжаттаманы қалай құрастыруды көрсетеміз."
876
877 #. (itstool) path: sect2/title
878 #: C/index.docbook:583
879 msgid "Integration with automake"
880 msgstr "Automake-пен біріктіру"
881
882 #. (itstool) path: sect2/para
883 #: C/index.docbook:585
884 msgid ""
885 "First copy the <filename>Makefile.am</filename> from the <filename "
886 "class=\"directory\">examples</filename> sub-directory of the <ulink "
887 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/"
888 "Makefile.am\"> gtkdoc-sources</ulink> to your project's reference "
889 "documentation directory (e.g. <filename class=\"directory\">docs/reference/"
890 "&lt;package&gt;</filename>). A local copy should be available under e.g. "
891 "<filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If you "
892 "have multiple packages repeat this for each one."
893 msgstr ""
894 "Алдымен <filename class=\"directory\">examples</filename> ішкі бумасындағы "
895 "<filename>Makefile.am</filename> файлын <ulink url=\"https://gitlab.gnome.org/"
896 "GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-sources</ulink> ішінен "
897 "жобаңыздың анықтамалық құжаттама бумасына (мысалы, <filename "
898 "class=\"directory\">docs/reference/&lt;package&gt;</filename>) көшіріңіз. "
899 "Жергілікті көшірмесі мына жерде қолжетімді болуы керек: <filename>/usr/share/"
900 "doc/gtk-doc-tools/examples/Makefile.am</filename>. Егер сізде бірнеше десте "
901 "болса, мұны әрқайсысы үшін қайталаңыз."
902
903 #. (itstool) path: note/simpara
904 #: C/index.docbook:598
905 msgid ""
906 "Do not forget to add each <filename>Makefile.am</filename> to the "
907 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
908 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
909 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
910 "filename> to <function>AC_CONFIG_FILES</function>."
911 msgstr ""
912 "Әрбір <filename>Makefile.am</filename> файлын <filename>configure.ac</"
913 "filename> ішіндегі <function>AC_CONFIG_FILES</function> макросына қосуды "
914 "ұмытпаңыз. <filename>docs/reference/libmeep/Makefile.am</filename> үшін "
915 "<function>AC_CONFIG_FILES</function> ішіне <filename>docs/reference/libmeep/"
916 "Makefile</filename> жазбасын қосу керек болады."
917
918 #. (itstool) path: example/title
919 #: C/index.docbook:610
920 msgid "Example directory structure with <filename>Makefiles.am</filename>"
921 msgstr "<filename>Makefiles.am</filename> файлдары бар бума құрылымының мысалы"
922
923 #. (itstool) path: example/programlisting
924 #: C/index.docbook:613
925 #, no-wrap
926 msgid ""
927 "\n"
928 "meep/\n"
929 " docs/\n"
930 " reference/ # reference documentation\n"
931 " libmeep/\n"
932 " Makefile.am\n"
933 " meeper/\n"
934 " Makefile.am\n"
935 " help/ # optional: user manual\n"
936 " meeper/\n"
937 " src/\n"
938 " libmeep/\n"
939 " meeper/\n"
940 msgstr ""
941 "\n"
942 "meep/\n"
943 " docs/\n"
944 " reference/ # анықтамалық құжаттама\n"
945 " libmeep/\n"
946 " Makefile.am\n"
947 " meeper/\n"
948 " Makefile.am\n"
949 " help/ # міндетті емес: пайдаланушы нұсқаулығы\n"
950 " meeper/\n"
951 " src/\n"
952 " libmeep/\n"
953 " meeper/\n"
954
955 #. (itstool) path: sect2/para
956 #: C/index.docbook:629
957 msgid ""
958 "Next, you need to customize the copied Makefiles and provide values for the "
959 "various parameters in each <filename>Makefile.am</filename>. All settings have "
960 "a comment above them that describes their purpose and how to customize the "
961 "setting. Most settings are used to supply extra flags to the respective tools "
962 "to which they apply. Every tool has a variable of the form "
963 "<option>&lt;TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-"
964 "mkhtml</application> has an option named <code>MKHTML_OPTIONS</code>). All the "
965 "tools support <option>--help</option> to list the supported options."
966 msgstr ""
967 "Әрі қарай, көшірілген Makefile файлдарын теңшеуіңіз және әрбір "
968 "<filename>Makefile.am</filename> ішіндегі түрлі параметрлерге мәндер беруіңіз "
969 "керек. Барлық баптаулардың үстінде олардың мақсаты мен баптауды қалай теңшеу "
970 "керектігін сипаттайтын түсіндірме бар. Көптеген баптаулар тиісті саймандарға "
971 "қосымша жалаушалар беру үшін қолданылады. Әрбір сайманда қолдау көрсетілетін "
972 "опцияларды тізімдеу үшін <option>--help</option> опциясы бар (мысалы, "
973 "<application>gtkdoc-mkhtml</application> сайманында <code>MKHTML_OPTIONS</"
974 "code> деп аталатын опция бар)."
975
976 #. (itstool) path: listitem/para
977 #: C/index.docbook:653
978 msgid ""
979 "<option>DOC_MODULE</option> is used to provide the name of the package that is "
980 "being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
981 msgstr ""
982 "<option>DOC_MODULE</option> құжатталатын дестенің атын көрсету үшін "
983 "қолданылады (мысалы, <code>meeper</code> немесе <code>libmeep</code>)."
984
985 #. (itstool) path: listitem/para
986 #: C/index.docbook:660
987 msgid ""
988 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
989 "directory which GTK-Doc searches for your API documentation. This will usually "
990 "be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-directory of that "
991 "directory."
992 msgstr ""
993 "<option>DOC_SOURCE_DIR</option> GTK-Doc сіздің API құжаттамаңызды іздейтін "
994 "бастапқы код бумасының орнын көрсету үшін қолданылады. Бұл әдетте <code> "
995 "DOC_SOURCE_DIR=$(top_srcdir)/src </code> немесе сол буманың ішкі бумасы болады."
996
997 #. (itstool) path: listitem/para
998 #: C/index.docbook:673
999 msgid ""
1000 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
1001 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=$"
1002 "(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of the "
1003 "matched files change."
1004 msgstr ""
1005 "<option>HFILE_GLOB</option> және <option>CFILE_GLOB</option> тәуелділіктер "
1006 "үшін қолданылады. Әрбір опция файл маскасын (file-glob) қабылдайды (мысалы, "
1007 "<code>HFILE_GLOB=$(top_srcdir)/src/*.c</code>). Сәйкес келетін файлдардың кез "
1008 "келгені өзгерсе, құжаттама қайта құрастырылады."
1009
1010 #. (itstool) path: listitem/para
1011 #: C/index.docbook:685
1012 msgid ""
1013 "<option>EXTRA_HFILES</option> allows to specify extra header files to include "
1014 "when scanning for API documentation, which are not found under "
1015 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1016 "extra.h</code>)."
1017 msgstr ""
1018 "<option>EXTRA_HFILES</option> API құжаттамасын сканерлеу кезінде "
1019 "<code>DOC_SOURCE_DIR</code> ішінде табылмаған қосымша тақырыптық файлдарды "
1020 "қосуға мүмкіндік береді (мысалы, <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1021 "extra.h</code>)."
1022
1023 #. (itstool) path: listitem/para
1024 #: C/index.docbook:695
1025 msgid ""
1026 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
1027 "to ignore when scanning for API documentation. Use the basename of the file or "
1028 "directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder</"
1029 "code>)."
1030 msgstr ""
1031 "<option>IGNORE_HFILES</option> API құжаттамасын сканерлеу кезінде елемейтін "
1032 "тақырыптық файлдарды немесе бумаларды көрсетуге мүмкіндік береді. Файлдың "
1033 "немесе буманың негізгі атын пайдаланыңыз (мысалы, <code> "
1034 "IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder</code>)."
1035
1036 #. (itstool) path: listitem/para
1037 #: C/index.docbook:705
1038 msgid ""
1039 "<option>HTML_IMAGES</option> allows to specify images files which will be "
1040 "copied into the <filename>html/</filename> directory of the generated "
1041 "documentation. If your API documentation includes any images they need to be "
1042 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1043 "stock_about_24.png</code>)."
1044 msgstr ""
1045 "<option>HTML_IMAGES</option> жасалған құжаттаманың <filename>html/</filename> "
1046 "бумасына көшірілетін сурет файлдарын көрсетуге мүмкіндік береді. Егер сіздің "
1047 "API құжаттамаңызға қандай да бір суреттер кірсе, оларды осы опцияға қосу керек "
1048 "(мысалы, <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png</"
1049 "code>)."
1050
1051 #. (itstool) path: listitem/para
1052 #: C/index.docbook:718
1053 msgid ""
1054 "<option>content_files</option> allows to specify extra files that are included "
1055 "by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> content_files=running.xml "
1056 "building.xml changes-2.0.xml</code>)."
1057 msgstr ""
1058 "<option>content_files</option> <code>$(DOC_MAIN_SGML_FILE)</code> файлына "
1059 "қосылатын қосымша файлдарды көрсетуге мүмкіндік береді (мысалы, <code> "
1060 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1061
1062 #. (itstool) path: listitem/para
1063 #: C/index.docbook:729
1064 msgid ""
1065 "<option>expand_content_files</option> allows to specify files where "
1066 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> are "
1067 "expanded (e.g. <code> expand_content_files=running.xml</code>)."
1068 msgstr ""
1069 "<option>expand_content_files</option> <code>#GtkWidget</code> сияқты "
1070 "<emphasis>gtk-doc қысқартулары</emphasis> жазылатын файлдарды көрсетуге "
1071 "мүмкіндік береді (мысалы, <code> expand_content_files=running.xml</code>)."
1072
1073 #. (itstool) path: sect2/para
1074 #: C/index.docbook:647
1075 msgid ""
1076 "The following list explains the most relevant options. Check the example "
1077 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1078 msgstr ""
1079 "Келесі тізімде ең маңызды опциялар түсіндірілген. Қосымша опциялар үшін "
1080 "<filename>Makefile.am</filename> мысалын қараңыз. <_:itemizedlist-1/>"
1081
1082 #. (itstool) path: sect2/title
1083 #: C/index.docbook:744
1084 msgid "Integration with autoconf"
1085 msgstr "Autoconf-пен біріктіру"
1086
1087 #. (itstool) path: sect2/para
1088 #: C/index.docbook:746
1089 msgid ""
1090 "Integration with <application>autoconf</application> is very simple and "
1091 "includes one required step and an additional optional (but recommended) step. "
1092 "The first step is to add the <function>GTK_DOC_CHECK</function> macro to your "
1093 "<filename>configure.ac</filename> script. This registers several configure "
1094 "options to enable GTK-Doc and allows you to set default arguments for "
1095 "<application>gtkdocize</application>."
1096 msgstr ""
1097 "<application>autoconf</application> жүйесімен біріктіру өте оңай және бір "
1098 "міндетті қадамды және қосымша міндетті емес (бірақ ұсынылатын) қадамды "
1099 "қамтиды. Бірінші қадам — <filename>configure.ac</filename> скриптіне "
1100 "<function>GTK_DOC_CHECK</function> макросын қосу. Бұл GTK-Doc-ты іске қосу "
1101 "үшін бірнеше конфигурация опцияларын тіркейді және <application>gtkdocize</"
1102 "application> үшін әдепкі аргументтерді орнатуға мүмкіндік береді."
1103
1104 #. (itstool) path: warning/simpara
1105 #: C/index.docbook:758
1106 msgid ""
1107 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The macro "
1108 "must start at the beginning of the line and should not start with whitespace."
1109 msgstr ""
1110 "<code>GTK_DOC_CHECK</code> макросының шегініссіз екеніне көз жеткізіңіз. "
1111 "Макрос жолдың басынан басталуы керек және бос орыннан басталмауы керек."
1112
1113 #. (itstool) path: sect2/para
1114 #: C/index.docbook:765
1115 msgid ""
1116 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1117 "<filename>configure.ac</filename>. This is not required but helps "
1118 "<application>gtkdocize</application> to automatically copy the macro "
1119 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1120 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1121 "Without this, the GTK_DOC_CHECK macro might not be found and you would need to "
1122 "explicitly tell the <application>aclocal</application> tool where to find the "
1123 "macro definition file."
1124 msgstr ""
1125 "Екінші қадам — <filename>configure.ac</filename> файлына "
1126 "<code>AC_CONFIG_MACRO_DIR(m4)</code> қосу. Бұл міндетті емес, бірақ "
1127 "<application>gtkdocize</application> бағдарламасына <function>GTK_DOC_CHECK</"
1128 "function> макросы бар макрос анықтамасын (мысалы, <filename>gtk-doc.m4</"
1129 "filename>) жобаңыздың макрос бумасына автоматты түрде көшіруге көмектеседі. "
1130 "Бұлсыз GTK_DOC_CHECK макросы табылмауы мүмкін және сізге <application>aclocal</"
1131 "application> сайманына макрос анықтамасы файлының қайда екенін нақты көрсету "
1132 "керек болады."
1133
1134 #. (itstool) path: example/title
1135 #: C/index.docbook:778
1136 msgid "Minimal integration with autoconf"
1137 msgstr "Autoconf-пен минималды біріктіру"
1138
1139 #. (itstool) path: example/programlisting
1140 #: C/index.docbook:779
1141 #, no-wrap
1142 msgid ""
1143 "\n"
1144 "# recommended: set m4 directory\n"
1145 "AC_CONFIG_MACRO_DIR(m4)\n"
1146 "# optional: register gtk-doc in configure\n"
1147 "GTK_DOC_CHECK([1.28])\n"
1148 msgstr ""
1149 "\n"
1150 "# ұсынылады: m4 бумасын орнату\n"
1151 "AC_CONFIG_MACRO_DIR(m4)\n"
1152 "# міндетті емес: configure-де gtk-doc тіркеу\n"
1153 "GTK_DOC_CHECK([1.28])\n"
1154
1155 #. (itstool) path: example/title
1156 #: C/index.docbook:794
1157 msgid "Integration with optional gtk-doc dependency"
1158 msgstr "Міндетті емес gtk-doc тәуелділігімен біріктіру"
1159
1160 #. (itstool) path: example/programlisting
1161 #: C/index.docbook:795
1162 #, no-wrap
1163 msgid ""
1164 "\n"
1165 "m4_ifdef([GTK_DOC_CHECK], [\n"
1166 "# recommended: set m4 directory\n"
1167 "AC_CONFIG_MACRO_DIR(m4)\n"
1168 "# optional: register gtk-doc in configure\n"
1169 "GTK_DOC_CHECK([1.28])\n"
1170 "],[\n"
1171 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1172 "])\n"
1173 msgstr ""
1174 "\n"
1175 "m4_ifdef([GTK_DOC_CHECK], [\n"
1176 "# ұсынылады: m4 бумасын орнату\n"
1177 "AC_CONFIG_MACRO_DIR(m4)\n"
1178 "# міндетті емес: configure-де gtk-doc тіркеу\n"
1179 "GTK_DOC_CHECK([1.28])\n"
1180 "],[\n"
1181 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1182 "])\n"
1183
1184 #. (itstool) path: sect2/para
1185 #: C/index.docbook:788
1186 msgid ""
1187 "The above example works, but will require all developers to have gtk-doc "
1188 "installed. A better way is to make building the documentation optional as "
1189 "shown in the next example: <_:example-1/>"
1190 msgstr ""
1191 "Жоғарыдағы мысал жұмыс істейді, бірақ ол барлық әзірлеушілерден gtk-doc "
1192 "орнатылған болуын талап етеді. Жақсырақ жол — келесі мысалда көрсетілгендей "
1193 "құжаттаманы құрастыруды міндетті емес ету: <_:example-1/>"
1194
1195 #. (itstool) path: sect2/para
1196 #: C/index.docbook:808
1197 msgid ""
1198 "The first argument is used to check for the Gtk-Doc version at configure time. "
1199 "The 2nd, optional argument is used by <application>gtkdocize</application>. "
1200 "The <symbol>GTK_DOC_CHECK</symbol> macro also adds several configure switches:"
1201 msgstr ""
1202 "Бірінші аргумент конфигурация кезінде Gtk-Doc нұсқасын тексеру үшін "
1203 "қолданылады. 2-ші, міндетті емес аргументті <application>gtkdocize</"
1204 "application> пайдаланады. <symbol>GTK_DOC_CHECK</symbol> макросы сонымен қатар "
1205 "бірнеше конфигурация ауыстырып-қосқыштарын қосады:"
1206
1207 #. (itstool) path: listitem/para
1208 #: C/index.docbook:817
1209 msgid "--with-html-dir=PATH : path to installed docs"
1210 msgstr "--with-html-dir=PATH : орнатылған құжаттардың жолы"
1211
1212 #. (itstool) path: listitem/para
1213 #: C/index.docbook:818
1214 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1215 msgstr ""
1216 "--enable-gtk-doc : құжаттаманы құрастыру үшін gtk-doc пайдалану [әдепкі=жоқ]"
1217
1218 #. (itstool) path: listitem/para
1219 #: C/index.docbook:819
1220 msgid "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1221 msgstr "--enable-gtk-doc-html : құжаттаманы html пішімінде құрастыру [әдепкі=иә]"
1222
1223 #. (itstool) path: listitem/para
1224 #: C/index.docbook:820
1225 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1226 msgstr "--enable-gtk-doc-pdf : құжаттаманы pdf пішімінде құрастыру [әдепкі=жоқ]"
1227
1228 #. (itstool) path: important/para
1229 #: C/index.docbook:824
1230 msgid ""
1231 "GTK-Doc is disabled by default! Remember to pass the option <option>'--enable-"
1232 "gtk-doc'</option> to the next <filename>configure</filename> run. Otherwise "
1233 "pregenerated documentation is installed (which makes sense for users but not "
1234 "for developers)."
1235 msgstr ""
1236 "GTK-Doc әдепкі бойынша сөндірулі! Келесі <filename>configure</filename> іске "
1237 "қосу кезінде <option>'--enable-gtk-doc'</option> опциясын беруді ұмытпаңыз. "
1238 "Әйтпесе, алдын ала жасалған құжаттама орнатылады (бұл пайдаланушылар үшін "
1239 "тиімді, бірақ әзірлеушілер үшін емес)."
1240
1241 #. (itstool) path: sect2/para
1242 #: C/index.docbook:832
1243 msgid ""
1244 "After all changes to <filename>configure.ac</filename> are made, update the "
1245 "<filename>configure</filename> file. This can be done by re-running "
1246 "<code>autogen.sh</code>."
1247 msgstr ""
1248 "<filename>configure.ac</filename> файлына барлық өзгерістер енгізілгеннен "
1249 "кейін, <filename>configure</filename> файлын жаңартыңыз. Мұны "
1250 "<code>autogen.sh</code> файлын қайта іске қосу арқылы жасауға болады."
1251
1252 #. (itstool) path: sect2/title
1253 #: C/index.docbook:840
1254 msgid "Integration with autogen"
1255 msgstr "Autogen-мен біріктіру"
1256
1257 #. (itstool) path: sect2/para
1258 #: C/index.docbook:842
1259 msgid ""
1260 "Most projects will have an <filename>autogen.sh</filename> script to setup the "
1261 "build infrastructure after the project was checked out from a version control "
1262 "system (such as git or svn). GTK-Doc comes with a script called "
1263 "<application>gtkdocize</application> which can be used to copy the necessary "
1264 "files needed by Gtk-Doc to the source directory."
1265 msgstr ""
1266 "Көптеген жобаларда жоба нұсқаларды бақылау жүйесінен (мысалы, git немесе svn) "
1267 "алынғаннан кейін құрастыру инфрақұрылымын баптау үшін <filename>autogen.sh</"
1268 "filename> скрипті болады. GTK-Doc құрамында Gtk-Doc үшін қажетті файлдарды "
1269 "бастапқы код бумасына көшіру үшін қолданылатын <application>gtkdocize</"
1270 "application> атты скрипт бар."
1271
1272 #. (itstool) path: sect2/para
1273 #: C/index.docbook:850
1274 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1275 msgstr ""
1276 "Оны autoreconf, autoheader, automake немесе autoconf-тан бұрын іске қосу керек."
1277
1278 #. (itstool) path: example/title
1279 #: C/index.docbook:855
1280 msgid "Running gtkdocize from autogen.sh"
1281 msgstr "gtkdocize бағдарламасын autogen.sh ішінен іске қосу"
1282
1283 #. (itstool) path: example/programlisting
1284 #: C/index.docbook:856
1285 #, no-wrap
1286 msgid ""
1287 "\n"
1288 "gtkdocize || exit 1\n"
1289 msgstr ""
1290 "\n"
1291 "gtkdocize || exit 1\n"
1292
1293 #. (itstool) path: example/title
1294 #: C/index.docbook:864
1295 msgid "Conditionally run gtkdocize from autogen.sh"
1296 msgstr "gtkdocize бағдарламасын autogen.sh ішінен шартты түрде іске қосу"
1297
1298 #. (itstool) path: example/programlisting
1299 #: C/index.docbook:865
1300 #, no-wrap
1301 msgid ""
1302 "\n"
1303 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1304 "if test $? -ne 0; then\n"
1305 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1306 "else\n"
1307 " $GTKDOCIZE || exit 1\n"
1308 "fi\n"
1309 msgstr ""
1310 "\n"
1311 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1312 "if test $? -ne 0; then\n"
1313 " echo \"gtk-doc қолдауы табылмады. Құжаттарды құрастыра алмайсыз.\"\n"
1314 "else\n"
1315 " $GTKDOCIZE || exit 1\n"
1316 "fi\n"
1317
1318 #. (itstool) path: sect2/para
1319 #: C/index.docbook:876
1320 msgid ""
1321 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1322 "doc.make</filename> to your project root (or any directory specified by the "
1323 "<option>--docdir</option> option)."
1324 msgstr ""
1325 "<application>gtkdocize</application> іске қосылғанда, ол <filename>gtk-"
1326 "doc.make</filename> файлын жобаңыздың түбіріне (немесе <option>--docdir</"
1327 "option> опциясымен көрсетілген кез келген бумаға) көшіреді."
1328
1329 #. (itstool) path: sect2/para
1330 #: C/index.docbook:882
1331 msgid ""
1332 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1333 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1334 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1335 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1336 "<function>GTK_DOC_CHECK</function> macro."
1337 msgstr ""
1338 "<application>gtkdocize</application> сіздің <filename>configure.ac</filename> "
1339 "скриптіңізді <function>GTK_DOC_CHECK</function> макросының бар-жоғына "
1340 "тексереді. <function>GTK_DOC_CHECK</function> макросын <application>gtkdocize</"
1341 "application> скриптіне қосымша аргументтерді беру үшін пайдалануға болады. Бұл "
1342 "<function>GTK_DOC_CHECK</function> макросындағы 2-ші параметр."
1343
1344 #. (itstool) path: sect2/para
1345 #: C/index.docbook:891
1346 msgid ""
1347 "Alternatively, additional arguments can also be passed to "
1348 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1349 "function> environment variable, or by directly specifying them to "
1350 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1351 msgstr ""
1352 "Сонымен қатар, қосымша аргументтерді <application>gtkdocize</application> "
1353 "скриптіне <function>GTKDOCIZE_FLAGS</function> орта айнымалысы арқылы немесе "
1354 "<filename>autogen.sh</filename> ішінде тікелей <application>gtkdocize</"
1355 "application>-ға көрсету арқылы беруге болады."
1356
1357 #. (itstool) path: sect2/title
1358 #: C/index.docbook:902
1359 msgid "Executing GTK-Doc from the Build System"
1360 msgstr "GTK-Doc-ты құрастыру жүйесінен орындау"
1361
1362 #. (itstool) path: sect2/para
1363 #: C/index.docbook:904
1364 msgid ""
1365 "After the previous steps it's time to run the build. First we need to rerun "
1366 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1367 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1368 "<filename>configure</filename> with this option afterwards."
1369 msgstr ""
1370 "Алдыңғы қадамдардан кейін құрастыруды іске қосатын уақыт келді. Алдымен "
1371 "<filename>autogen.sh</filename> файлын қайта іске қосуымыз керек. Егер бұл "
1372 "скрипт сіз үшін configure-ді іске қосса, оған <option>--enable-gtk-doc</"
1373 "option> опциясын беріңіз. Әйтпесе, <filename>configure</filename> файлын осы "
1374 "опциямен кейінірек қолмен іске қосыңыз."
1375
1376 #. (itstool) path: sect2/para
1377 #: C/index.docbook:911
1378 msgid ""
1379 "The first make run generates several additional files in the doc-directories. "
1380 "The important ones are: <filename>&lt;package&gt;.types</filename>, "
1381 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
1382 "<filename>&lt;package&gt;-sections.txt</filename>."
1383 msgstr ""
1384 "Бірінші make іске қосылуы құжаттама бумаларында бірнеше қосымша файлдарды "
1385 "жасайды. Маңыздылары: <filename>&lt;package&gt;.types</filename>, "
1386 "<filename>&lt;package&gt;-docs.xml</filename> (бұрын .sgml болатын), "
1387 "<filename>&lt;package&gt;-sections.txt</filename>."
1388
1389 #. (itstool) path: example/title
1390 #: C/index.docbook:919
1391 msgid "Running the doc build"
1392 msgstr "Құжаттарды құрастыруды іске қосу"
1393
1394 #. (itstool) path: example/programlisting
1395 #: C/index.docbook:920
1396 #, no-wrap
1397 msgid ""
1398 "\n"
1399 "./autogen.sh --enable-gtk-doc\n"
1400 "make\n"
1401 msgstr ""
1402 "\n"
1403 "./autogen.sh --enable-gtk-doc\n"
1404 "make\n"
1405
1406 #. (itstool) path: sect2/para
1407 #: C/index.docbook:927
1408 msgid ""
1409 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1410 "index.html</filename>. With this initial setup you will only see a very simple "
1411 "document. The next chapter will teach you how to add API documentation to your "
1412 "code via special comment blocks. The Chapter afterwards introduces <link "
1413 "linkend=\"metafiles\">additional files</link> and shows how to edit the <link "
1414 "linkend=\"metafiles_master\">master template</link> to add additional chapters "
1415 "and sections to your documentation files."
1416 msgstr ""
1417 "Енді браузеріңізді <filename>docs/reference/&lt;package&gt;/index.html</"
1418 "filename> файлына бағыттай аласыз. Осы бастапқы баптаумен сіз тек өте "
1419 "қарапайым құжатты көресіз. Келесі тарау сізге арнайы түсіндірме блоктары "
1420 "арқылы кодыңыздан API құжаттамасын қалай қосу керектігін үйретеді. Одан "
1421 "кейінгі тарау <link linkend=\"metafiles\">қосымша файлдармен</link> "
1422 "таныстырады және құжаттама файлдарына қосымша тараулар мен бөлімдерді қосу "
1423 "үшін <link linkend=\"metafiles_master\">негізгі үлгіні</link> қалай түзету "
1424 "керектігін көрсетеді."
1425
1426 #. (itstool) path: sect1/title
1427 #: C/index.docbook:943
1428 msgid "Integration with CMake build systems"
1429 msgstr "CMake құрастыру жүйелерімен біріктіру"
1430
1431 #. (itstool) path: sect1/para
1432 #: C/index.docbook:945
1433 msgid ""
1434 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and the "
1435 "corresponding <filename>GtkDocConfigVersion.cmake</filename> module). This "
1436 "provides a <literal>gtk_doc_add_module</literal> command that you can set in "
1437 "your <filename>CMakeLists.txt</filename> file."
1438 msgstr ""
1439 "GTK-Doc енді <filename>GtkDocConfig.cmake</filename> модулін (және тиісті "
1440 "<filename>GtkDocConfigVersion.cmake</filename> модулін) ұсынады. Бұл "
1441 "<filename>CMakeLists.txt</filename> файлында орнатуға болатын "
1442 "<literal>gtk_doc_add_module</literal> командасын береді."
1443
1444 #. (itstool) path: example/title
1445 #: C/index.docbook:955
1446 msgid "Example of using GTK-Doc from CMake"
1447 msgstr "GTK-Doc-ты CMake-тен пайдалану мысалы"
1448
1449 #. (itstool) path: example/programlisting
1450 #: C/index.docbook:956
1451 #, no-wrap
1452 msgid ""
1453 "\n"
1454 "find_package(GtkDoc 1.25 REQUIRED)\n"
1455 "\n"
1456 "# Create the doc-libmeep target.\n"
1457 "gtk_doc_add_module(\n"
1458 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1459 " XML meep-docs.xml\n"
1460 " LIBRARIES libmeep\n"
1461 ")\n"
1462 "\n"
1463 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1464 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1465 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1466 "\n"
1467 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1468 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1469 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1470 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1471 msgstr ""
1472 "\n"
1473 "find_package(GtkDoc 1.25 REQUIRED)\n"
1474 "\n"
1475 "# doc-libmeep мақсатын жасау.\n"
1476 "gtk_doc_add_module(\n"
1477 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1478 " XML meep-docs.xml\n"
1479 " LIBRARIES libmeep\n"
1480 ")\n"
1481 "\n"
1482 "# Әдепкі мақсаттың бөлігі ретінде doc-libmeep құрастыру. Бұлсыз, сізге\n"
1483 "# құжаттарды құрастыру үшін `make doc-libmeep` сияқты команданы қолмен іске қосу керек болар еді.\n"
1484 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1485 "\n"
1486 "# Құжаттарды орнату. (Бұл CMAKE_INSTALL_DOCDIR айнымалысын дұрыс орнату үшін\n"
1487 "# GNUInstallDirs CMake модулін пайдаланып жатырсыз деп есептейді).\n"
1488 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1489 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1490
1491 #. (itstool) path: sect1/para
1492 #: C/index.docbook:953
1493 msgid "The following example shows how to use this command. <_:example-1/>"
1494 msgstr ""
1495 "Келесі мысалда осы команданы қалай пайдалану керектігі көрсетілген. "
1496 "<_:example-1/>"
1497
1498 #. (itstool) path: sect1/title
1499 #: C/index.docbook:980
1500 msgid "Integration with plain makefiles or other build systems"
1501 msgstr "Жай makefile немесе басқа құрастыру жүйелерімен біріктіру"
1502
1503 #. (itstool) path: sect1/para
1504 #: C/index.docbook:982
1505 msgid ""
1506 "In the case one does not want to use automake and therefore <filename>gtk-"
1507 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1508 "in own makefiles (or other build tools)."
1509 msgstr ""
1510 "Егер біреу automake-ті, демек <filename>gtk-doc.mak</filename> файлын "
1511 "пайдаланғысы келмесе, жеке makefile файлдарында (немесе басқа құрастыру "
1512 "саймандарында) gtkdoc саймандарын дұрыс ретпен шақыруы керек болады."
1513
1514 #. (itstool) path: example/title
1515 #: C/index.docbook:989
1516 msgid "Documentation build steps"
1517 msgstr "Құжаттаманы құрастыру қадамдары"
1518
1519 #. (itstool) path: example/programlisting
1520 #: C/index.docbook:990
1521 #, no-wrap
1522 msgid ""
1523 "\n"
1524 "DOC_MODULE=meep\n"
1525 "// sources have changed\n"
1526 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1527 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1528 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1529 "// xml files have changed\n"
1530 "mkdir html\n"
1531 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1532 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1533 msgstr ""
1534 "\n"
1535 "DOC_MODULE=meep\n"
1536 "// бастапқы кодтар өзгерді\n"
1537 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1538 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1539 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1540 "// xml файлдары өзгерді\n"
1541 "mkdir html\n"
1542 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1543 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1544
1545 #. (itstool) path: sect1/para
1546 #: C/index.docbook:1004
1547 msgid ""
1548 "One will need to look at the <filename>Makefile.am</filename> and "
1549 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1550 msgstr ""
1551 "Қажетті қосымша опцияларды таңдау үшін <filename>Makefile.am</filename> және "
1552 "<filename>gtk-doc.mak</filename> файлдарына қарау керек болады."
1553
1554 #. (itstool) path: sect1/title
1555 #: C/index.docbook:1011
1556 msgid "Integration with version control systems"
1557 msgstr "Нұсқаларды бақылау жүйелерімен біріктіру"
1558
1559 #. (itstool) path: sect1/para
1560 #: C/index.docbook:1013
1561 msgid ""
1562 "As a rule of thumb, it's the files you edit which should go under version "
1563 "control. For typical projects it's these files: "
1564 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-"
1565 "docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-"
1566 "sections.txt</filename>, <filename>Makefile.am</filename>."
1567 msgstr ""
1568 "Жалпы ереже бойынша, нұсқаларды бақылау жүйесіне сіз түзетін файлдар кіруі "
1569 "керек. Типтік жобалар үшін бұл келесі файлдар: "
1570 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-"
1571 "docs.xml</filename> (бұрын .sgml), <filename>&lt;package&gt;-sections.txt</"
1572 "filename>, <filename>Makefile.am</filename>."
1573
1574 #. (itstool) path: sect1/para
1575 #: C/index.docbook:1021
1576 msgid ""
1577 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1578 "directories should not go under version control. Neither should any of the "
1579 "<filename>.stamp</filename> files."
1580 msgstr ""
1581 "<filename>xml/</filename> және <filename>html/</filename> бумаларындағы "
1582 "файлдар нұсқаларды бақылау жүйесіне кірмеуі керек. Сондай-ақ ешбір "
1583 "<filename>.stamp</filename> файлдары да."
1584
1585 #. (itstool) path: chapter/title
1586 #: C/index.docbook:1031
1587 msgid "Documenting the code"
1588 msgstr "Кодты құжаттау"
1589
1590 #. (itstool) path: chapter/para
1591 #: C/index.docbook:1033
1592 msgid ""
1593 "GTK-Doc uses source code comment with a special syntax for code documentation. "
1594 "Further it retrieves information about your project structure from other "
1595 "sources. During the next section you will find all information about the "
1596 "syntax of the comments."
1597 msgstr ""
1598 "GTK-Doc кодты құжаттау үшін арнайы синтаксисі бар бастапқы код түсіндірмелерін "
1599 "пайдаланады. Әрі қарай, ол басқа дереккөздерден жобаңыздың құрылымы туралы "
1600 "ақпаратты алады. Келесі бөлімде түсіндірмелер синтаксисі туралы барлық "
1601 "ақпаратты таба аласыз."
1602
1603 #. (itstool) path: example/title
1604 #: C/index.docbook:1044 C/index.docbook:1070
1605 msgid "GTK-Doc comment block"
1606 msgstr "GTK-Doc түсіндірме блогы"
1607
1608 #. (itstool) path: example/programlisting
1609 #: C/index.docbook:1045
1610 #, no-wrap
1611 msgid ""
1612 "\n"
1613 "#ifndef __GTK_DOC_IGNORE__\n"
1614 "/* unparseable code here */\n"
1615 "#endif\n"
1616 msgstr ""
1617 "\n"
1618 "#ifndef __GTK_DOC_IGNORE__\n"
1619 "/* талданбайтын код осында */\n"
1620 "#endif\n"
1621
1622 #. (itstool) path: chapter/para
1623 #: C/index.docbook:1040
1624 msgid ""
1625 "The GTK-Doc scanner can handle the majority of C headers fine. In the case of "
1626 "receiving warnings from the scanner that look like a special case, one can "
1627 "hint GTK-Doc to skip over them. <_:example-1/>"
1628 msgstr ""
1629 "GTK-Doc сканері C тақырыптық файлдарының көпшілігін жақсы өңдей алады. Егер "
1630 "сканерден ерекше жағдайға ұқсайтын ескертулер алсаңыз, GTK-Doc-қа оларды "
1631 "өткізіп жіберу туралы нұсқау беруге болады. <_:example-1/>"
1632
1633 #. (itstool) path: note/title
1634 #: C/index.docbook:1054
1635 msgid "Limitations"
1636 msgstr "Шектеулер"
1637
1638 #. (itstool) path: note/para
1639 #: C/index.docbook:1055
1640 msgid ""
1641 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but not "
1642 "<code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1643 msgstr ""
1644 "Ескеріңіз, GTK-Doc <code>#ifndef(__GTK_DOC_IGNORE__)</code> форматын қолдайды, "
1645 "бірақ <code>#if !defined(__GTK_DOC_IGNORE__)</code> немесе басқа тіркесімдерді "
1646 "қолдамайды."
1647
1648 #. (itstool) path: sect1/title
1649 #: C/index.docbook:1065
1650 msgid "Documentation comments"
1651 msgstr "Құжаттама түсіндірмелері"
1652
1653 #. (itstool) path: example/programlisting
1654 #: C/index.docbook:1071
1655 #, no-wrap
1656 msgid ""
1657 "\n"
1658 "/**\n"
1659 " * identifier:\n"
1660 " * documentation ...\n"
1661 " */\n"
1662 msgstr ""
1663 "\n"
1664 "/**\n"
1665 " * идентификатор:\n"
1666 " * құжаттама ...\n"
1667 " */\n"
1668
1669 #. (itstool) path: sect1/para
1670 #: C/index.docbook:1067
1671 msgid ""
1672 "A multiline comment that starts with an additional '*' marks a documentation "
1673 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1674 msgstr ""
1675 "Қосымша '*' таңбасынан басталатын көпжолды түсіндірме GTK-Doc саймандарымен "
1676 "өңделетін құжаттама блогын білдіреді. <_:example-1/>"
1677
1678 #. (itstool) path: sect1/para
1679 #: C/index.docbook:1080
1680 msgid ""
1681 "The 'identifier' is one line with the name of the item the comment is related "
1682 "to. The syntax differs a little depending on the item. (TODO add table showing "
1683 "identifiers)"
1684 msgstr ""
1685 "'Идентификатор' — бұл түсіндірмеге қатысты элементтің атауы бар бір жол. "
1686 "Синтаксис элементке байланысты аздап ерекшеленеді. (ЖАСАУ КЕРЕК: "
1687 "идентификаторларды көрсететін кестені қосу)"
1688
1689 #. (itstool) path: sect1/para
1690 #: C/index.docbook:1086
1691 msgid ""
1692 "The 'documentation' block is also different for each symbol type. Symbol types "
1693 "that get parameters such as functions or macros have the parameter description "
1694 "first followed by a blank line (just a '*'). Afterwards follows the detailed "
1695 "description. All lines (outside program listings and CDATA sections) just "
1696 "containing a ' *' (blank-asterisk) are converted to paragraph breaks. If you "
1697 "don't want a paragraph break, change that into ' * ' (blank-asterisk-blank-"
1698 "blank). This is useful in preformatted text (code listings)."
1699 msgstr ""
1700 "'Құжаттама' блогы да әрбір таңба түрі үшін әртүрлі болады. Функциялар немесе "
1701 "макростар сияқты параметрлерді алатын таңба түрлерінде алдымен параметр "
1702 "сипаттамасы, содан кейін бос жол келеді (тек '*'). Одан кейін егжей-тегжейлі "
1703 "сипаттама келеді. Тек ' *' (бос орын-жұлдызша) таңбасынан тұратын барлық "
1704 "жолдар (бағдарлама тізімдері мен CDATA бөлімдерінен тыс) абзац үзілімдеріне "
1705 "айналдырылады. Егер абзац үзілімін қаламасаңыз, оны ' * ' (бос орын-жұлдызша-"
1706 "бос орын-бос орын) етіп өзгертіңіз. Бұл алдын ала пішімделген мәтінде (код "
1707 "тізімдерінде) пайдалы."
1708
1709 #. (itstool) path: listitem/para
1710 #: C/index.docbook:1103
1711 msgid ""
1712 "What it is: The name for a class or function can sometimes be misleading for "
1713 "people coming from a different background."
1714 msgstr ""
1715 "Ол не: Класс немесе функция атауы басқа ортадан келген адамдар үшін кейде "
1716 "жаңылыстыруы мүмкін."
1717
1718 #. (itstool) path: listitem/para
1719 #: C/index.docbook:1109
1720 msgid ""
1721 "What it does: Tell about common uses. Put it in relation with the other API."
1722 msgstr ""
1723 "Ол не істейді: Жалпы қолдану тәсілдері туралы айтыңыз. Оны басқа API-мен "
1724 "байланыстырыңыз."
1725
1726 #. (itstool) path: tip/para
1727 #: C/index.docbook:1099
1728 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1729 msgstr "Кодты құжаттау кезінде екі аспектіні сипаттаңыз: <_:itemizedlist-1/>"
1730
1731 #. (itstool) path: listitem/para
1732 #: C/index.docbook:1124
1733 msgid "Use function() to refer to functions or macros which take arguments."
1734 msgstr ""
1735 "Аргументтерді алатын функцияларға немесе макростарға сілтеме жасау үшін "
1736 "функция() пайдаланыңыз."
1737
1738 #. (itstool) path: listitem/para
1739 #: C/index.docbook:1129
1740 msgid ""
1741 "Use @param to refer to parameters. Also use this when referring to parameters "
1742 "of other functions, related to the one being described."
1743 msgstr ""
1744 "Параметрлерге сілтеме жасау үшін @параметр пайдаланыңыз. Мұны сипатталып "
1745 "жатқан функцияға қатысты басқа функциялардың параметрлеріне сілтеме жасағанда "
1746 "да пайдаланыңыз."
1747
1748 #. (itstool) path: listitem/para
1749 #: C/index.docbook:1135
1750 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1751 msgstr ""
1752 "Константаға сілтеме жасау үшін %константа пайдаланыңыз, мысалы, "
1753 "%G_TRAVERSE_LEAFS."
1754
1755 #. (itstool) path: listitem/para
1756 #: C/index.docbook:1140
1757 msgid ""
1758 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1759 "macros which don't take arguments."
1760 msgstr ""
1761 "Аргументтерді алмайтын құрылымдар, тізімдер және макростар сияқты таңбалардың "
1762 "басқа түрлеріне сілтеме жасау үшін #таңба пайдаланыңыз."
1763
1764 #. (itstool) path: listitem/para
1765 #: C/index.docbook:1146
1766 msgid "Use #Object::signal to refer to a GObject signal."
1767 msgstr "GObject сигналына сілтеме жасау үшін #Объект::сигнал пайдаланыңыз."
1768
1769 #. (itstool) path: listitem/para
1770 #: C/index.docbook:1151
1771 msgid "Use #Object:property to refer to a GObject property."
1772 msgstr "GObject қасиетіне сілтеме жасау үшін #Объект:қасиет пайдаланыңыз."
1773
1774 #. (itstool) path: listitem/para
1775 #: C/index.docbook:1156
1776 msgid ""
1777 "Use #Struct.field to refer to a field inside a structure and "
1778 "#GObjectClass.foo_bar() to refer to a vmethod."
1779 msgstr ""
1780 "Құрылым ішіндегі өріске сілтеме жасау үшін #Құрылым.өріс және vmethod-қа "
1781 "сілтеме жасау үшін #GObjectClass.foo_bar() пайдаланыңыз."
1782
1783 #. (itstool) path: sect1/para
1784 #: C/index.docbook:1118
1785 msgid ""
1786 "One advantage of hyper-text over plain-text is the ability to have links in "
1787 "the document. Writing the correct markup for a link can be tedious though. GTK-"
1788 "Doc comes to help by providing several useful abbreviations. <_:itemizedlist-1/"
1789 ">"
1790 msgstr ""
1791 "Гипермәтіннің жай мәтіннен бір артықшылығы — құжатта сілтемелердің болуы. "
1792 "Сілтеме үшін дұрыс белгіні жазу жалықтыруы мүмкін. GTK-Doc бірнеше пайдалы "
1793 "қысқартуларды ұсыну арқылы көмекке келеді. <_:itemizedlist-1/>"
1794
1795 #. (itstool) path: tip/para
1796 #: C/index.docbook:1165
1797 msgid ""
1798 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1799 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1800 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", "
1801 "\"&amp;commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape "
1802 "them with a backslash '\\'."
1803 msgstr ""
1804 "Егер құжаттамаңызда GTK-Doc оларды өзгертпей, '&lt;', '&gt;', '()', '@', '%', "
1805 "немесе '#' арнайы таңбаларын пайдалану қажет болса, тиісінше \"&amp;lt;\", "
1806 "\"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;commat;\", \"&amp;percnt;"
1807 "\" және \"&amp;num;\" XML нысандарын пайдалануға болады немесе оларды кері "
1808 "қиғаш сызықпен '\\' экрандауға болады."
1809
1810 #. (itstool) path: sect1/para
1811 #: C/index.docbook:1174
1812 msgid ""
1813 "DocBook can do more than just links. One can also have lists, examples, "
1814 "headings, and images. As of version 1.20, the preferred way is to use a subset "
1815 "of the basic text formatting syntax called <ulink url=\"http://"
1816 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1817 "versions any documentation that includes Markdown will be rendered as is. For "
1818 "example, list items will appear as lines starting with a dash."
1819 msgstr ""
1820 "DocBook тек сілтемелерден де көп нәрсені істей алады. Сонымен қатар тізімдер, "
1821 "мысалдар, тақырыптар және суреттер болуы мүмкін. 1.20 нұсқасынан бастап, "
1822 "<ulink url=\"http://daringfireball.net/projects/markdown/\">Markdown</ulink> "
1823 "деп аталатын негізгі мәтінді пішімдеу синтаксисінің ішкі жиынын пайдалану "
1824 "ұсынылады. Ескі GTK-Doc нұсқаларында Markdown қамтитын кез келген құжаттама "
1825 "сол қалпында көрсетіледі. Мысалы, тізім элементтері сызықшадан басталатын "
1826 "жолдар ретінде көрінеді."
1827
1828 #. (itstool) path: sect1/para
1829 #: C/index.docbook:1185
1830 msgid ""
1831 "While markdown is now preferred one can mix both. One limitation here is that "
1832 "one can use docbook xml within markdown, but markdown within docbook xml is "
1833 "not supported."
1834 msgstr ""
1835 "Қазір markdown-ға басымдық берілсе де, екеуін де араластыруға болады. Мұндағы "
1836 "бір шектеу — markdown ішінде docbook xml пайдалануға болады, бірақ docbook xml "
1837 "ішінде markdown-ға қолдау көрсетілмейді."
1838
1839 #. (itstool) path: sect1/para
1840 #: C/index.docbook:1191
1841 msgid ""
1842 "In older GTK-Doc releases, if you need support for additional formatting, you "
1843 "would need to enable the usage of docbook XML tags inside doc-comments by "
1844 "putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in the "
1845 "variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</filename>."
1846 msgstr ""
1847 "Ескі GTK-Doc шығарылымдарында, егер сізге қосымша пішімдеуді қолдау қажет "
1848 "болса, <filename>Makefile.am</filename> ішіндегі <symbol>MKDB_OPTIONS</symbol> "
1849 "айнымалысына <option>--xml-mode</option> (немесе <option>--sgml-mode</option>) "
1850 "қосу арқылы түсіндірмелер ішінде docbook XML тегтерін пайдалануды қосуыңыз "
1851 "керек болар еді."
1852
1853 #. (itstool) path: example/title
1854 #: C/index.docbook:1200
1855 msgid "GTK-Doc comment block using Markdown"
1856 msgstr "Markdown пайдаланатын GTK-Doc түсіндірме блогы"
1857
1858 #. (itstool) path: example/programlisting
1859 #: C/index.docbook:1201
1860 #, no-wrap
1861 msgid ""
1862 "\n"
1863 "/**\n"
1864 " * identifier:\n"
1865 " *\n"
1866 " * documentation paragraph ...\n"
1867 " *\n"
1868 " * # Sub Heading #\n"
1869 " *\n"
1870 " * ## Second Sub Heading\n"
1871 " *\n"
1872 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1873 " *\n"
1874 " * more documentation:\n"
1875 " *\n"
1876 " * - list item 1\n"
1877 " *\n"
1878 " * Paragraph inside a list item.\n"
1879 " *\n"
1880 " * - list item 2\n"
1881 " *\n"
1882 " * 1. numbered list item\n"
1883 " *\n"
1884 " * 2. another numbered list item\n"
1885 " *\n"
1886 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1887 " *\n"
1888 " * ![an inline image](plot-result.png)\n"
1889 " *\n"
1890 " * [A link to the heading anchor above][heading-two]\n"
1891 " *\n"
1892 " * A C-language example:\n"
1893 " * |[&lt;!-- language=\"C\" --&gt;\n"
1894 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1895 " * ]|\n"
1896 " */\n"
1897 msgstr ""
1898 "\n"
1899 "/**\n"
1900 " * идентификатор:\n"
1901 " *\n"
1902 " * құжаттама абзацы ...\n"
1903 " *\n"
1904 " * # Ішкі тақырып #\n"
1905 " *\n"
1906 " * ## Екінші ішкі тақырып\n"
1907 " *\n"
1908 " * # Сілтеме якорі бар ішкі тақырып # {#heading-two}\n"
1909 " *\n"
1910 " * көбірек құжаттама:\n"
1911 " *\n"
1912 " * - тізім элементі 1\n"
1913 " *\n"
1914 " * Тізім элементінің ішіндегі абзац.\n"
1915 " *\n"
1916 " * - тізім element 2\n"
1917 " *\n"
1918 " * 1. нөмірленген тізім элементі\n"
1919 " *\n"
1920 " * 2. басқа нөмірленген тізім элементі\n"
1921 " *\n"
1922 " * Басқа абзац. [GNOME веб-сайтына сілтеме](http://www.gnome.org/)\n"
1923 " *\n"
1924 " * ![кірістірілген сурет](plot-result.png)\n"
1925 " *\n"
1926 " * [Жоғарыдағы тақырып якоріне сілтеме][heading-two]\n"
1927 " *\n"
1928 " * C тіліндегі мысал:\n"
1929 " * |[&lt;!-- language=\"C\" --&gt;\n"
1930 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1931 " * ]|\n"
1932 " */\n"
1933
1934 #. (itstool) path: sect1/para
1935 #: C/index.docbook:1240
1936 msgid ""
1937 "More examples of what markdown tags are supported can be found in the <ulink "
1938 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
1939 "Documentation Markdown Syntax Reference</ulink>."
1940 msgstr ""
1941 "Қандай markdown тегтеріне қолдау көрсетілетіні туралы көбірек мысалдарды "
1942 "<ulink url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/"
1943 "Markdown\">GTK құжаттамасының Markdown синтаксисі анықтамалығынан</ulink> "
1944 "табуға болады."
1945
1946 #. (itstool) path: tip/para
1947 #: C/index.docbook:1246
1948 msgid ""
1949 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
1950 "cannot write documentation for static symbols. Nevertheless it is good to "
1951 "comment those symbols too. This helps other developers to understand your "
1952 "code. Therefore we recommend to comment these using normal comments (without "
1953 "the 2nd '*' in the first line). If later the function needs to be made public, "
1954 "all one needs to do is to add another '*' in the comment block and insert the "
1955 "symbol name at the right place inside the sections file."
1956 msgstr ""
1957 "Бұған дейін айтылғандай, GTK-Doc ашық API құжаттауға арналған. Сондықтан "
1958 "статикалық таңбалар үшін құжаттама жазу мүмкін емес. Соған қарамастан, ол "
1959 "таңбаларға да түсіндірме берген дұрыс. Бұл басқа әзірлеушілерге кодыңызды "
1960 "түсінуге көмектеседі. Сондықтан біз оларды қалыпты түсіндірмелерді пайдаланып "
1961 "сипаттауды ұсынамыз (бірінші жолда екінші '*' таңбасынсыз). Егер кейінірек "
1962 "функцияны ашық ету қажет болса, түсіндірме блогына тағы бір '*' қосып, "
1963 "бөлімдер файлының ішіндегі тиісті жерге таңба атын енгізу жеткілікті."
1964
1965 #. (itstool) path: sect1/title
1966 #: C/index.docbook:1261
1967 msgid "Documenting sections"
1968 msgstr "Бөлімдерді құжаттау"
1969
1970 #. (itstool) path: sect1/para
1971 #: C/index.docbook:1263
1972 msgid ""
1973 "Each section of the documentation contains information about one class or "
1974 "module. To introduce the component one can write a section block. The short "
1975 "description is also used inside the table of contents. All the @fields are "
1976 "optional."
1977 msgstr ""
1978 "Құжаттаманың әрбір бөлімінде бір класс немесе модуль туралы ақпарат болады. "
1979 "Компонентті таныстыру үшін бөлім блогын жазуға болады. Қысқаша сипаттама "
1980 "мазмұн кестесінде де қолданылады. Барлық @өрістер міндетті емес."
1981
1982 #. (itstool) path: example/title
1983 #: C/index.docbook:1271
1984 msgid "Section comment block"
1985 msgstr "Бөлім түсіндірме блогы"
1986
1987 #. (itstool) path: example/programlisting
1988 #: C/index.docbook:1272
1989 #, no-wrap
1990 msgid ""
1991 "\n"
1992 "/**\n"
1993 " * SECTION:meepapp\n"
1994 " * @short_description: the application class\n"
1995 " * @title: Meep application\n"
1996 " * @section_id:\n"
1997 " * @see_also: #MeepSettings\n"
1998 " * @stability: Stable\n"
1999 " * @include: meep/app.h\n"
2000 " * @image: application.png\n"
2001 " *\n"
2002 " * The application class handles ...\n"
2003 " */\n"
2004 msgstr ""
2005 "\n"
2006 "/**\n"
2007 " * SECTION:meepapp\n"
2008 " * @short_description: қолданба класы\n"
2009 " * @title: Meep қолданбасы\n"
2010 " * @section_id:\n"
2011 " * @see_also: #MeepSettings\n"
2012 " * @stability: Stable\n"
2013 " * @include: meep/app.h\n"
2014 " * @image: application.png\n"
2015 " *\n"
2016 " * Қолданба класы ... өңдейді\n"
2017 " */\n"
2018
2019 #. (itstool) path: varlistentry/term
2020 #: C/index.docbook:1291
2021 msgid "SECTION:&lt;name&gt;"
2022 msgstr "SECTION:&lt;аты&gt;"
2023
2024 #. (itstool) path: listitem/para
2025 #: C/index.docbook:1293
2026 msgid ""
2027 "The name links the section documentation to the respective part in the "
2028 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
2029 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-"
2030 "sections.txt</filename> file."
2031 msgstr ""
2032 "Аты бөлім құжаттамасын <filename>&lt;package&gt;-sections.txt</filename> "
2033 "файлындағы тиісті бөлікке байланыстырады. Мұнда берілген ат "
2034 "<filename>&lt;package&gt;-sections.txt</filename> файлындағы &lt;FILE&gt; "
2035 "тегіне сәйкес келуі керек."
2036
2037 #. (itstool) path: varlistentry/term
2038 #: C/index.docbook:1302
2039 msgid "@short_description"
2040 msgstr "@short_description"
2041
2042 #. (itstool) path: listitem/para
2043 #: C/index.docbook:1304
2044 msgid ""
2045 "A one line description of the section, that later will appear after the links "
2046 "in the TOC and at the top of the section page."
2047 msgstr ""
2048 "Бөлімнің бір жолдық сипаттамасы, ол кейінірек мазмұн кестесіндегі "
2049 "сілтемелерден кейін және бөлім бетінің жоғарғы жағында пайда болады."
2050
2051 #. (itstool) path: varlistentry/term
2052 #: C/index.docbook:1311
2053 msgid "@title"
2054 msgstr "@title"
2055
2056 #. (itstool) path: listitem/para
2057 #: C/index.docbook:1313
2058 msgid ""
2059 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
2060 "can be overridden with the @title field."
2061 msgstr ""
2062 "Бөлім тақырыбы әдепкі бойынша SECTION декларациясындағы &lt;аты&gt; болады. "
2063 "Оны @title өрісімен алмастыруға болады."
2064
2065 #. (itstool) path: varlistentry/term
2066 #: C/index.docbook:1320
2067 msgid "@section_id"
2068 msgstr "@section_id"
2069
2070 #. (itstool) path: listitem/para
2071 #: C/index.docbook:1322
2072 msgid ""
2073 "Overrides the use of title as a section identifier. For GObjects the "
2074 "&lt;title&gt; is used as a section_id and for other sections it is "
2075 "&lt;MODULE&gt;-&lt;title&gt;."
2076 msgstr ""
2077 "Тақырыпты бөлім идентификаторы ретінде пайдалануды алмастырады. GObjects үшін "
2078 "&lt;title&gt; бөлім идентификаторы (section_id) ретінде қолданылады, ал басқа "
2079 "бөлімдер үшін ол &lt;MODULE&gt;-&lt;title&gt; болады."
2080
2081 #. (itstool) path: varlistentry/term
2082 #: C/index.docbook:1330
2083 msgid "@see_also"
2084 msgstr "@see_also"
2085
2086 #. (itstool) path: listitem/para
2087 #: C/index.docbook:1332
2088 msgid "A list of symbols that are related to this section."
2089 msgstr "Осы бөлімге қатысты таңбалар тізімі."
2090
2091 #. (itstool) path: varlistentry/term
2092 #: C/index.docbook:1338
2093 msgid "@stability"
2094 msgstr "@stability"
2095
2096 #. (itstool) path: listitem/para
2097 #: C/index.docbook:1345
2098 msgid ""
2099 "Stable - The intention of a Stable interface is to enable arbitrary third "
2100 "parties to develop applications to these interfaces, release them, and have "
2101 "confidence that they will run on all minor releases of the product (after the "
2102 "one in which the interface was introduced, and within the same major release). "
2103 "Even at a major release, incompatible changes are expected to be rare, and to "
2104 "have strong justifications."
2105 msgstr ""
2106 "Тұрақты (Stable) — Тұрақты интерфейстің мақсаты — кез келген үшінші тараптарға "
2107 "осы интерфейстерге арналған қолданбаларды әзірлеуге, оларды шығаруға және "
2108 "олардың өнімнің барлық кіші шығарылымдарында (интерфейс енгізілген нұсқадан "
2109 "кейін және сол негізгі нұсқа ішінде) жұмыс істейтініне сенімді болуға "
2110 "мүмкіндік беру. Тіпті негізгі шығарылымда да үйлесімсіз өзгерістер сирек "
2111 "болады деп күтіледі және олардың күшті негіздемесі болуы керек."
2112
2113 #. (itstool) path: listitem/para
2114 #: C/index.docbook:1357
2115 msgid ""
2116 "Unstable - Unstable interfaces are experimental or transitional. They are "
2117 "typically used to give outside developers early access to new or rapidly "
2118 "changing technology, or to provide an interim solution to a problem where a "
2119 "more general solution is anticipated. No claims are made about either source "
2120 "or binary compatibility from one minor release to the next."
2121 msgstr ""
2122 "Тұрақты емес (Unstable) — Тұрақты емес интерфейстер эксперименттік немесе "
2123 "өтпелі болып табылады. Олар әдетте сыртқы әзірлеушілерге жаңа немесе тез "
2124 "өзгеретін технологияға ерте қол жеткізуге мүмкіндік беру үшін немесе жалпы "
2125 "шешім күтілетін мәселеге аралық шешім ұсыну үшін пайдаланылады. Бір кіші "
2126 "шығарылымнан екіншісіне бастапқы кодтың немесе бинарлық файлдың үйлесімділігі "
2127 "туралы ешқандай уәде берілмейді."
2128
2129 #. (itstool) path: listitem/para
2130 #: C/index.docbook:1369
2131 msgid ""
2132 "Private - An interface that can be used within the GNOME stack itself, but "
2133 "that is not documented for end-users. Such functions should only be used in "
2134 "specified and documented ways."
2135 msgstr ""
2136 "Жеке (Private) — GNOME жиынтығының өзінде қолдануға болатын, бірақ соңғы "
2137 "пайдаланушылар үшін құжатталмаған интерфейс. Мұндай функциялар тек көрсетілген "
2138 "және құжатталған тәсілдермен ғана пайдаланылуы керек."
2139
2140 #. (itstool) path: listitem/para
2141 #: C/index.docbook:1378
2142 msgid ""
2143 "Internal - An interface that is internal to a module and does not require end-"
2144 "user documentation. Functions that are undocumented are assumed to be Internal."
2145 msgstr ""
2146 "Ішкі (Internal) — Модульге тән және соңғы пайдаланушы құжаттамасын қажет "
2147 "етпейтін интерфейс. Құжатталмаған функциялар Ішкі деп есептеледі."
2148
2149 #. (itstool) path: listitem/para
2150 #: C/index.docbook:1340
2151 msgid ""
2152 "An informal description of the stability level this API has. We recommend the "
2153 "use of one of these terms: <_:itemizedlist-1/>"
2154 msgstr ""
2155 "Бұл API ие болатын тұрақтылық деңгейінің бейресми сипаттамасы. Біз мына "
2156 "терминдердің бірін пайдалануды ұсынамыз: <_:itemizedlist-1/>"
2157
2158 #. (itstool) path: varlistentry/term
2159 #: C/index.docbook:1390
2160 msgid "@include"
2161 msgstr "@include"
2162
2163 #. (itstool) path: listitem/para
2164 #: C/index.docbook:1392
2165 msgid ""
2166 "The <literal>#include</literal> files to show in the section synopsis (a comma "
2167 "separated list), overriding the global value from the <link "
2168 "linkend=\"metafiles_sections\">section file</link> or command line. This item "
2169 "is optional."
2170 msgstr ""
2171 "Бөлім синопсисінде (үтірмен ажыратылған тізім) көрсетілетін <literal>#include</"
2172 "literal> файлдары, <link linkend=\"metafiles_sections\">бөлім файлынан</link> "
2173 "немесе командалық жолдан алынған глобалды мәнді алмастырады. Бұл элемент "
2174 "міндетті емес."
2175
2176 #. (itstool) path: varlistentry/term
2177 #: C/index.docbook:1401
2178 msgid "@image"
2179 msgstr "@image"
2180
2181 #. (itstool) path: listitem/para
2182 #: C/index.docbook:1403
2183 msgid ""
2184 "The image to display at the top of the reference page for this section. This "
2185 "will often be some sort of a diagram to illustrate the visual appearance of a "
2186 "class or a diagram of its relationship to other classes. This item is optional."
2187 msgstr ""
2188 "Осы бөлімнің анықтамалық бетінің жоғарғы жағында көрсетілетін сурет. Бұл "
2189 "көбінесе кластың көрнекі көрінісін немесе оның басқа кластармен байланысын "
2190 "сипаттайтын қандай да бір диаграмма болады. Бұл элемент міндетті емес."
2191
2192 #. (itstool) path: tip/para
2193 #: C/index.docbook:1414
2194 msgid ""
2195 "To avoid unnecessary recompilation after doc-changes put the section docs into "
2196 "the c-source where possible."
2197 msgstr ""
2198 "Құжат өзгерістерінен кейін қажетсіз қайта құрастыруды болдырмау үшін, бөлім "
2199 "құжаттарын мүмкіндігінше c-бастапқы кодына орналастырыңыз."
2200
2201 #. (itstool) path: sect1/title
2202 #: C/index.docbook:1423
2203 msgid "Documenting symbols"
2204 msgstr "Таңбаларды құжаттау"
2205
2206 #. (itstool) path: sect1/para
2207 #: C/index.docbook:1425
2208 msgid ""
2209 "Each symbol (function, macro, struct, enum, signal and property) is documented "
2210 "in a separate block. The block is best placed close to the definition of the "
2211 "symbols so that it is easy to keep them in sync. Thus functions are usually "
2212 "documented in the c-source and macros, structs and enums in the header file."
2213 msgstr ""
2214 "Әрбір таңба (функция, макрос, құрылым, тізім, сигнал және қасиет) жеке блокта "
2215 "құжатталады. Блокты таңбалардың анықтамасына жақын орналастырған дұрыс, сонда "
2216 "оларды синхрондау оңай болады. Осылайша, функциялар әдетте c-бастапқы кодында, "
2217 "ал макростар, құрылымдар мен тізімдер тақырыптық файлда құжатталады."
2218
2219 #. (itstool) path: sect2/title
2220 #. (itstool) path: example/title
2221 #: C/index.docbook:1433 C/index.docbook:1499
2222 msgid "General tags"
2223 msgstr "Жалпы тегтер"
2224
2225 #. (itstool) path: sect2/para
2226 #: C/index.docbook:1435
2227 msgid ""
2228 "You can add versioning information to all documentation elements to tell when "
2229 "an API was introduced, or when it was deprecated."
2230 msgstr ""
2231 "API-дың қашан енгізілгенін немесе қашан ескіргенін көрсету үшін барлық "
2232 "құжаттама элементтеріне нұсқа туралы ақпаратты қосуға болады."
2233
2234 #. (itstool) path: variablelist/title
2235 #: C/index.docbook:1440
2236 msgid "Versioning Tags"
2237 msgstr "Нұсқа тегтері"
2238
2239 #. (itstool) path: varlistentry/term
2240 #: C/index.docbook:1441
2241 msgid "Since:"
2242 msgstr "Бастап:"
2243
2244 #. (itstool) path: listitem/para
2245 #: C/index.docbook:1443
2246 msgid "Description since which version of the code the API is available."
2247 msgstr "Кодтың қай нұсқасынан бастап API қолжетімді екендігі туралы сипаттама."
2248
2249 #. (itstool) path: varlistentry/term
2250 #: C/index.docbook:1448
2251 msgid "Deprecated:"
2252 msgstr "Ескірген:"
2253
2254 #. (itstool) path: listitem/para
2255 #: C/index.docbook:1450
2256 msgid ""
2257 "Paragraph denoting that this function should no be used anymore. The "
2258 "description should point the reader to the new API."
2259 msgstr ""
2260 "Бұл функцияны бұдан былай қолдануға болмайтынын білдіретін абзац. Сипаттама "
2261 "оқырманды жаңа API-ға бағыттауы керек."
2262
2263 #. (itstool) path: sect2/para
2264 #: C/index.docbook:1458
2265 msgid ""
2266 "You can also add stability information to all documentation elements to "
2267 "indicate whether API stability is guaranteed for them for all future minor "
2268 "releases of the project."
2269 msgstr ""
2270 "Сондай-ақ жобаның барлық болашақ кіші шығарылымдары үшін API тұрақтылығына "
2271 "кепілдік берілгенін көрсету үшін барлық құжаттама элементтеріне тұрақтылық "
2272 "туралы ақпаратты қосуға болады."
2273
2274 #. (itstool) path: sect2/para
2275 #: C/index.docbook:1464
2276 msgid ""
2277 "The default stability level for all documentation elements can be set by "
2278 "passing the <option>--default-stability</option> argument to "
2279 "<application>gtkdoc-mkdb</application> with one of the values below."
2280 msgstr ""
2281 "Барлық құжаттама элементтері үшін әдепкі тұрақтылық деңгейін "
2282 "<application>gtkdoc-mkdb</application> бағдарламасына төмендегі мәндердің "
2283 "бірімен <option>--default-stability</option> аргументін беру арқылы орнатуға "
2284 "болады."
2285
2286 #. (itstool) path: variablelist/title
2287 #: C/index.docbook:1470
2288 msgid "Stability Tags"
2289 msgstr "Тұрақтылық тегтері"
2290
2291 #. (itstool) path: varlistentry/term
2292 #: C/index.docbook:1471
2293 msgid "Stability: Stable"
2294 msgstr "Тұрақтылығы: Тұрақты"
2295
2296 #. (itstool) path: listitem/para
2297 #: C/index.docbook:1473
2298 msgid ""
2299 "Mark the element as stable. This is for public APIs which are guaranteed to "
2300 "remain stable for all future minor releases of the project."
2301 msgstr ""
2302 "Элементті тұрақты ретте белгілеңіз. Бұл жобаның барлық болашақ кіші "
2303 "шығарылымдары үшін тұрақты болып қалуына кепілдік берілген ашық API "
2304 "интерфейстеріне арналған."
2305
2306 #. (itstool) path: varlistentry/term
2307 #: C/index.docbook:1480
2308 msgid "Stability: Unstable"
2309 msgstr "Тұрақтылығы: Тұрақты емес"
2310
2311 #. (itstool) path: listitem/para
2312 #: C/index.docbook:1482
2313 msgid ""
2314 "Mark the element as unstable. This is for public APIs which are released as a "
2315 "preview before being stabilised."
2316 msgstr ""
2317 "Элементті тұрақты емес ретте белгілеңіз. Бұл тұрақтандырылғанға дейін алдын "
2318 "ала қарау ретінде шығарылатын ашық API интерфейстеріне арналған."
2319
2320 #. (itstool) path: varlistentry/term
2321 #: C/index.docbook:1488
2322 msgid "Stability: Private"
2323 msgstr "Тұрақтылығы: Жеке"
2324
2325 #. (itstool) path: listitem/para
2326 #: C/index.docbook:1490
2327 msgid ""
2328 "Mark the element as private. This is for interfaces which can be used by "
2329 "tightly coupled modules, but not by arbitrary third parties."
2330 msgstr ""
2331 "Элементті жеке ретте белгілеңіз. Бұл бір-бірімен тығыз байланысты модульдер "
2332 "арқылы пайдаланылуы мүмкін, бірақ кез келген үшінші тараптар үшін емес "
2333 "интерфейстерге арналған."
2334
2335 #. (itstool) path: example/programlisting
2336 #: C/index.docbook:1500
2337 #, no-wrap
2338 msgid ""
2339 "\n"
2340 "/**\n"
2341 " * foo_get_bar:\n"
2342 " * @foo: some foo\n"
2343 " *\n"
2344 " * Retrieves @foo's bar.\n"
2345 " *\n"
2346 " * Returns: @foo's bar\n"
2347 " *\n"
2348 " * Since: 2.6\n"
2349 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2350 " */\n"
2351 "Bar *\n"
2352 "foo_get_bar(Foo *foo)\n"
2353 "{\n"
2354 "...\n"
2355 msgstr ""
2356 "\n"
2357 "/**\n"
2358 " * foo_get_bar:\n"
2359 " * @foo: кейбір foo\n"
2360 " *\n"
2361 " * @foo-дың bar-ын алады.\n"
2362 " *\n"
2363 " * Қайтарады: @foo-дың bar-ы\n"
2364 " *\n"
2365 " * Бастап: 2.6\n"
2366 " * Ескірген: 2.12: Оның орнына foo_baz_get_bar() пайдаланыңыз.\n"
2367 " */\n"
2368 "Bar *\n"
2369 "foo_get_bar(Foo *foo)\n"
2370 "{\n"
2371 "...\n"
2372
2373 #. (itstool) path: sect2/title
2374 #. (itstool) path: example/title
2375 #: C/index.docbook:1520 C/index.docbook:1530
2376 msgid "Annotations"
2377 msgstr "Аннотациялар"
2378
2379 #. (itstool) path: sect2/para
2380 #: C/index.docbook:1522
2381 msgid ""
2382 "Documentation blocks can contain annotation-tags. These tags will be rendered "
2383 "with tooltips describing their meaning. The tags are used by GObject "
2384 "Introspection to generate language bindings. A detailed list of the supported "
2385 "tags can be found in the <ulink url=\"https://gi.readthedocs.io/en/latest/"
2386 "annotations/giannotations.html\" type=\"http\">GObject Introspection "
2387 "documentation</ulink>."
2388 msgstr ""
2389 "Құжаттама блоктарында аннотация тегтері болуы мүмкін. Бұл тегтер олардың "
2390 "мағынасын сипаттайтын құралдардың көмегімен көрсетіледі. Тегтер GObject "
2391 "Introspection арқылы тілдік байланыстарды жасау үшін қолданылады. Қолдау "
2392 "көрсетілетін тегтердің егжей-тегжейлі тізімін <ulink url=\"https://"
2393 "gi.readthedocs.io/en/latest/annotations/giannotations.html\" "
2394 "type=\"http\">GObject Introspection құжаттамасынан</ulink> табуға болады."
2395
2396 #. (itstool) path: example/programlisting
2397 #: C/index.docbook:1531
2398 #, no-wrap
2399 msgid ""
2400 "\n"
2401 "/**\n"
2402 " * foo_get_bar: (annotation)\n"
2403 " * @foo: (annotation): some foo\n"
2404 " *\n"
2405 " * Retrieves @foo's bar.\n"
2406 " *\n"
2407 " * Returns: (annotation): @foo's bar\n"
2408 " */\n"
2409 "...\n"
2410 "/**\n"
2411 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2412 " * (and another annotation)\n"
2413 " * @foo: (annotation) (another annotation): some foo\n"
2414 " *\n"
2415 " * Sets bar on @foo.\n"
2416 " */\n"
2417 msgstr ""
2418 "\n"
2419 "/**\n"
2420 " * foo_get_bar: (аннотация)\n"
2421 " * @foo: (аннотация): кейбір foo\n"
2422 " *\n"
2423 " * @foo-дың bar-ын алады.\n"
2424 " *\n"
2425 " * Қайтарады: (аннотация): @foo-дың bar-ы\n"
2426 " */\n"
2427 "...\n"
2428 "/**\n"
2429 " * foo_set_bar_using_the_frobnicator: (аннотация) (тағы бір аннотация)\n"
2430 " * (және тағы бір аннотация)\n"
2431 " * @foo: (аннотация) (тағы бір аннотация): кейбір foo\n"
2432 " *\n"
2433 " * @foo-да bar-ды орнатады.\n"
2434 " */\n"
2435
2436 #. (itstool) path: sect2/title
2437 #. (itstool) path: example/title
2438 #: C/index.docbook:1552 C/index.docbook:1581
2439 msgid "Function comment block"
2440 msgstr "Функция түсіндірме блогы"
2441
2442 #. (itstool) path: listitem/para
2443 #: C/index.docbook:1558
2444 msgid ""
2445 "Document whether returned objects, lists, strings, etc, should be freed/"
2446 "unrefed/released."
2447 msgstr ""
2448 "Қайтарылған объектілерді, тізімдерді, жолдарды және т.б. босату/сілтемесін жою/"
2449 "босату (free/unref/release) қажеттігін құжаттаңыз."
2450
2451 #. (itstool) path: listitem/para
2452 #: C/index.docbook:1564
2453 msgid "Document whether parameters can be NULL, and what happens if they are."
2454 msgstr ""
2455 "Параметрлердің NULL болуы мүмкін-болмауын және егер солай болса не болатынын "
2456 "құжаттаңыз."
2457
2458 #. (itstool) path: listitem/para
2459 #: C/index.docbook:1569
2460 msgid "Mention interesting pre-conditions and post-conditions where appropriate."
2461 msgstr ""
2462 "Қажет болған жағдайда қызықты алдын ала шарттар мен кейінгі шарттарды атап "
2463 "өтіңіз."
2464
2465 #. (itstool) path: sect2/para
2466 #: C/index.docbook:1554 C/index.docbook:1640
2467 msgid "Please remember to: <_:itemizedlist-1/>"
2468 msgstr "Келесілерді ұмытпаңыз: <_:itemizedlist-1/>"
2469
2470 #. (itstool) path: sect2/para
2471 #: C/index.docbook:1576
2472 msgid ""
2473 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are private. "
2474 "They are treated like static functions."
2475 msgstr ""
2476 "Gtk-doc '_' таңбасынан басталатын барлық таңбаларды (макростар, функциялар) "
2477 "жеке деп есептейді. Олар статикалық функциялар ретінде қарастырылады."
2478
2479 #. (itstool) path: example/programlisting
2480 #: C/index.docbook:1582
2481 #, no-wrap
2482 msgid ""
2483 "\n"
2484 "/**\n"
2485 " * function_name:\n"
2486 " * @par1: description of parameter 1. These can extend over more than\n"
2487 " * one line.\n"
2488 " * @par2: description of parameter 2\n"
2489 " * @...: a %NULL-terminated list of bars\n"
2490 " *\n"
2491 " * The function description goes here. You can use @par1 to refer to parameters\n"
2492 " * so that they are highlighted in the output. You can also use %constant\n"
2493 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2494 " * other declarations (which may be documented elsewhere).\n"
2495 " *\n"
2496 " * Returns: an integer.\n"
2497 " *\n"
2498 " * Since: 2.2\n"
2499 " * Deprecated: 2.18: Use other_function() instead.\n"
2500 " */\n"
2501 msgstr ""
2502 "\n"
2503 "/**\n"
2504 " * функция_аты:\n"
2505 " * @par1: 1-параметрдің сипаттамасы. Ол бірнеше жолға созылуы\n"
2506 " * мүмкін.\n"
2507 " * @par2: 2-параметрдің сипаттамасы\n"
2508 " * @...: %NULL-мен аяқталатын bar-лар тізімі\n"
2509 " *\n"
2510 " * Функцияның сипаттамасы осында жазылады. Параметрлерге сілтеме жасау үшін @par1\n"
2511 " * пайдалануға болады, сонда олар нәтижеде ерекшеленеді. Сондай-ақ константалар\n"
2512 " * үшін %константа, функциялар үшін функция_аты2() және басқа декларацияларға\n"
2513 " * сілтемелер (олар басқа жерде құжатталған болуы мүмкін) үшін #GtkWidget пайдалана аласыз.\n"
2514 " *\n"
2515 " * Қайтарады: бүтін сан.\n"
2516 " *\n"
2517 " * Бастап: 2.2\n"
2518 " * Ескірген: 2.18: Оның орнына басқа_функция() пайдаланыңыз.\n"
2519 " */\n"
2520
2521 #. (itstool) path: variablelist/title
2522 #: C/index.docbook:1603
2523 msgid "Function tags"
2524 msgstr "Функция тегтері"
2525
2526 #. (itstool) path: varlistentry/term
2527 #: C/index.docbook:1604 C/index.docbook:1811
2528 msgid "Returns:"
2529 msgstr "Қайтарады:"
2530
2531 #. (itstool) path: listitem/para
2532 #: C/index.docbook:1606
2533 msgid "Paragraph describing the returned result."
2534 msgstr "Қайтарылған нәтижені сипаттайтын абзац."
2535
2536 #. (itstool) path: varlistentry/term
2537 #: C/index.docbook:1611
2538 msgid "@...:"
2539 msgstr "@...:"
2540
2541 #. (itstool) path: listitem/para
2542 #: C/index.docbook:1613
2543 msgid ""
2544 "In case the function has variadic arguments, you should use this tag "
2545 "(@Varargs: does also work for historic reasons)."
2546 msgstr ""
2547 "Егер функцияда айнымалы аргументтер болса, осы тегті пайдалану керек "
2548 "(@Varargs: тарихи себептермен де жұмыс істейді)."
2549
2550 #. (itstool) path: sect2/title
2551 #. (itstool) path: example/title
2552 #: C/index.docbook:1623 C/index.docbook:1625
2553 msgid "Property comment block"
2554 msgstr "Қасиет түсіндірме блогы"
2555
2556 #. (itstool) path: example/programlisting
2557 #: C/index.docbook:1626
2558 #, no-wrap
2559 msgid ""
2560 "\n"
2561 "/**\n"
2562 " * SomeWidget:some-property:\n"
2563 " *\n"
2564 " * Here you can document a property.\n"
2565 " */\n"
2566 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2567 msgstr ""
2568 "\n"
2569 "/**\n"
2570 " * SomeWidget:some-property:\n"
2571 " *\n"
2572 " * Мұнда сіз қасиетті құжаттай аласыз.\n"
2573 " */\n"
2574 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2575
2576 #. (itstool) path: sect2/title
2577 #. (itstool) path: example/title
2578 #: C/index.docbook:1638 C/index.docbook:1657
2579 msgid "Signal comment block"
2580 msgstr "Сигнал түсіндірме блогы"
2581
2582 #. (itstool) path: listitem/para
2583 #: C/index.docbook:1644
2584 msgid ""
2585 "Document when the signal is emitted and whether it is emitted before or after "
2586 "other signals."
2587 msgstr ""
2588 "Сигналдың қашан таратылатынын және оның басқа сигналдардан бұрын немесе кейін "
2589 "таратылатынын құжаттаңыз."
2590
2591 #. (itstool) path: listitem/para
2592 #: C/index.docbook:1650
2593 msgid "Document what an application might do in the signal handler."
2594 msgstr "Сигнал өңдеушісінде қолданба не істей алатынын құжаттаңыз."
2595
2596 #. (itstool) path: example/programlisting
2597 #: C/index.docbook:1658
2598 #, no-wrap
2599 msgid ""
2600 "\n"
2601 "/**\n"
2602 " * FooWidget::foobarized:\n"
2603 " * @widget: the widget that received the signal\n"
2604 " * @foo: some foo\n"
2605 " * @bar: some bar\n"
2606 " *\n"
2607 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2608 " */\n"
2609 "foo_signals[FOOBARIZED] =\n"
2610 " g_signal_new (\"foobarized\",\n"
2611 " ...\n"
2612 msgstr ""
2613 "\n"
2614 "/**\n"
2615 " * FooWidget::foobarized:\n"
2616 " * @widget: сигналды алған виджет\n"
2617 " * @foo: кейбір foo\n"
2618 " * @bar: кейбір bar\n"
2619 " *\n"
2620 " * ::foobarized сигналы біреу @widget-ті foobarize жасауға тырысқан сайын таратылады.\n"
2621 " */\n"
2622 "foo_signals[FOOBARIZED] =\n"
2623 " g_signal_new (\"foobarized\",\n"
2624 " ...\n"
2625
2626 #. (itstool) path: sect2/title
2627 #. (itstool) path: example/title
2628 #: C/index.docbook:1675 C/index.docbook:1676
2629 msgid "Struct comment block"
2630 msgstr "Құрылым түсіндірме блогы"
2631
2632 #. (itstool) path: example/programlisting
2633 #: C/index.docbook:1677
2634 #, no-wrap
2635 msgid ""
2636 "\n"
2637 "/**\n"
2638 " * FooWidget:\n"
2639 " * @bar: some #gboolean\n"
2640 " *\n"
2641 " * This is the best widget, ever.\n"
2642 " */\n"
2643 "typedef struct _FooWidget {\n"
2644 " GtkWidget parent_instance;\n"
2645 "\n"
2646 " gboolean bar;\n"
2647 "} FooWidget;\n"
2648 msgstr ""
2649 "\n"
2650 "/**\n"
2651 " * FooWidget:\n"
2652 " * @bar: кейбір #gboolean\n"
2653 " *\n"
2654 " * Бұл ең жақсы виджет.\n"
2655 " */\n"
2656 "typedef struct _FooWidget {\n"
2657 " GtkWidget parent_instance;\n"
2658 "\n"
2659 " gboolean bar;\n"
2660 "} FooWidget;\n"
2661
2662 #. (itstool) path: sect2/para
2663 #: C/index.docbook:1692
2664 msgid ""
2665 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2666 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour."
2667 msgstr ""
2668 "Жасқырғыңыз келетін жеке құрылым өрістерінің алдында <code>/*&lt; private "
2669 "&gt;*/</code> пайдаланыңыз. Керісінше әрекет үшін <code>/*&lt; public &gt;*/</"
2670 "code> пайдаланыңыз."
2671
2672 #. (itstool) path: sect2/para
2673 #: C/index.docbook:1698
2674 msgid ""
2675 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" it "
2676 "will be considered private automatically and doesn't need to be mentioned in "
2677 "the comment block."
2678 msgstr ""
2679 "Егер бірінші өріс \"g_iface\", \"parent_instance\" немесе \"parent_class\" "
2680 "болса, ол автоматты түрде жеке деп есептеледі және оны түсіндірме блогында "
2681 "атап өтудің қажеті жоқ."
2682
2683 #. (itstool) path: sect2/para
2684 #: C/index.docbook:1704
2685 msgid ""
2686 "Struct comment blocks can also be used for GObjects and GObjectClasses. It is "
2687 "usually a good idea to add a comment block for a class, if it has vmethods (as "
2688 "this is how they can be documented). For the GObject itself one can use the "
2689 "related section docs, having a separate block for the instance struct would be "
2690 "useful if the instance has public fields. One disadvantage here is that this "
2691 "creates two index entries of the same name (the structure and the section)."
2692 msgstr ""
2693 "Құрылым түсіндірме блоктарын GObjects және GObjectClasses үшін де пайдалануға "
2694 "болады. Егер класта vmethod-тар болса (оларды осылай құжаттауға болады), оған "
2695 "түсіндірме блогын қосқан жөн. GObject-тың өзі үшін тиісті бөлім құжаттарын "
2696 "пайдалануға болады, егер данада ашық өрістер болса, дана құрылымы үшін жеке "
2697 "блоктың болуы пайдалы болар еді. Мұндағы бір кемшілік — бұл бір атаумен екі "
2698 "индекс жазбасын жасайды (құрылым және бөлім)."
2699
2700 #. (itstool) path: sect2/title
2701 #. (itstool) path: example/title
2702 #: C/index.docbook:1716 C/index.docbook:1717
2703 msgid "Enum comment block"
2704 msgstr "Тізім (enum) түсіндірме блогы"
2705
2706 #. (itstool) path: example/programlisting
2707 #: C/index.docbook:1718
2708 #, no-wrap
2709 msgid ""
2710 "\n"
2711 "/**\n"
2712 " * Something:\n"
2713 " * @SOMETHING_FOO: something foo\n"
2714 " * @SOMETHING_BAR: something bar\n"
2715 " *\n"
2716 " * Enum values used for the thing, to specify the thing.\n"
2717 " */\n"
2718 "typedef enum {\n"
2719 " SOMETHING_FOO,\n"
2720 " SOMETHING_BAR,\n"
2721 " /*&lt; private &gt;*/\n"
2722 " SOMETHING_COUNT\n"
2723 "} Something;\n"
2724 msgstr ""
2725 "\n"
2726 "/**\n"
2727 " * Something:\n"
2728 " * @SOMETHING_FOO: something foo\n"
2729 " * @SOMETHING_BAR: something bar\n"
2730 " *\n"
2731 " * Нәрсені көрсету үшін қолданылатын тізім мәндері.\n"
2732 " */\n"
2733 "typedef enum {\n"
2734 " SOMETHING_FOO,\n"
2735 " SOMETHING_BAR,\n"
2736 " /*&lt; private &gt;*/\n"
2737 " SOMETHING_COUNT\n"
2738 "} Something;\n"
2739
2740 #. (itstool) path: sect2/para
2741 #: C/index.docbook:1735
2742 msgid ""
2743 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you want "
2744 "to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour."
2745 msgstr ""
2746 "Жасқырғыңыз келетін жеке тізім мәндерінің алдында <code>/*&lt; private &gt;*/</"
2747 "code> пайдаланыңыз. Керісінше әрекет үшін <code>/*&lt; public &gt;*/</code> "
2748 "пайдаланыңыз."
2749
2750 #. (itstool) path: sect1/title
2751 #: C/index.docbook:1746
2752 msgid "Inline program documentation"
2753 msgstr "Бағдарламаның ішкі құжаттамасы"
2754
2755 #. (itstool) path: sect1/para
2756 #: C/index.docbook:1747
2757 msgid ""
2758 "You can document programs and their commandline interface using inline "
2759 "documentation."
2760 msgstr ""
2761 "Бағдарламаларды және олардың командалық жол интерфейсін ішкі құжаттама арқылы "
2762 "құжаттай аласыз."
2763
2764 #. (itstool) path: variablelist/title
2765 #: C/index.docbook:1753
2766 msgid "Tags"
2767 msgstr "Тегтер"
2768
2769 #. (itstool) path: varlistentry/term
2770 #: C/index.docbook:1755
2771 msgid "PROGRAM"
2772 msgstr "PROGRAM"
2773
2774 #. (itstool) path: listitem/para
2775 #: C/index.docbook:1758
2776 msgid "Defines the start of a program documentation."
2777 msgstr "Бағдарлама құжаттамасының басталуын анықтайды."
2778
2779 #. (itstool) path: varlistentry/term
2780 #: C/index.docbook:1765
2781 msgid "@short_description:"
2782 msgstr "@short_description:"
2783
2784 #. (itstool) path: listitem/para
2785 #: C/index.docbook:1767
2786 msgid "Defines a short description of the program. (Optional)"
2787 msgstr "Бағдарламаның қысқаша сипаттамасын анықтайды. (Міндетті емес)"
2788
2789 #. (itstool) path: varlistentry/term
2790 #: C/index.docbook:1774
2791 msgid "@synopsis:"
2792 msgstr "@synopsis:"
2793
2794 #. (itstool) path: listitem/para
2795 #: C/index.docbook:1776
2796 msgid ""
2797 "Defines the arguments, or list of arguments that the program can take. "
2798 "(Optional)"
2799 msgstr ""
2800 "Бағдарлама қабылдай алатын аргументтерді немесе аргументтер тізімін анықтайды. "
2801 "(Міндетті емес)"
2802
2803 #. (itstool) path: varlistentry/term
2804 #: C/index.docbook:1784
2805 msgid "@see_also:"
2806 msgstr "@see_also:"
2807
2808 #. (itstool) path: listitem/para
2809 #: C/index.docbook:1786
2810 msgid "See Also manual page section. (Optional)"
2811 msgstr "Нұсқаулық бетінің \"Сондай-ақ қараңыз\" бөлімі. (Міндетті емес)"
2812
2813 #. (itstool) path: varlistentry/term
2814 #: C/index.docbook:1793
2815 msgid "@arg:"
2816 msgstr "@arg:"
2817
2818 #. (itstool) path: listitem/para
2819 #: C/index.docbook:1795
2820 msgid "Argument(s) passed to the program and their description. (Optional)"
2821 msgstr ""
2822 "Бағдарламаға берілетін аргумент(тер) және олардың сипаттамасы. (Міндетті емес)"
2823
2824 #. (itstool) path: varlistentry/term
2825 #: C/index.docbook:1802
2826 msgid "Description:"
2827 msgstr "Сипаттамасы:"
2828
2829 #. (itstool) path: listitem/para
2830 #: C/index.docbook:1804
2831 msgid "A longer description of the program."
2832 msgstr "Бағдарламаның толығырақ сипаттамасы."
2833
2834 #. (itstool) path: listitem/para
2835 #: C/index.docbook:1813
2836 msgid "Specify what value(s) the program returns. (Optional)"
2837 msgstr "Бағдарлама қандай мән(дер) қайтаратынын көрсетіңіз. (Міндетті емес)"
2838
2839 #. (itstool) path: sect2/title
2840 #: C/index.docbook:1822
2841 msgid "Example of program documentation."
2842 msgstr "Бағдарлама құжаттамасының мысалы."
2843
2844 #. (itstool) path: example/title
2845 #: C/index.docbook:1823
2846 msgid "Program documentation block"
2847 msgstr "Бағдарлама құжаттамасының блогы"
2848
2849 #. (itstool) path: example/programlisting
2850 #: C/index.docbook:1824
2851 #, no-wrap
2852 msgid ""
2853 "\n"
2854 "/**\n"
2855 " * PROGRAM:test-program\n"
2856 " * @short_description: A test program\n"
2857 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2858 " * @see_also: test(1)\n"
2859 " * @--arg1 *arg*: set arg1 to *arg*\n"
2860 " * @--arg2 *arg*: set arg2 to *arg*\n"
2861 " * @-v, --version: Print the version number\n"
2862 " * @-h, --help: Print the help message\n"
2863 " *\n"
2864 " * Long description of program.\n"
2865 " *\n"
2866 " * Returns: Zero on success, non-zero on failure\n"
2867 " */\n"
2868 "int main(int argc, char *argv[])\n"
2869 "{\n"
2870 "\treturn 0;\n"
2871 "}\n"
2872 msgstr ""
2873 "\n"
2874 "/**\n"
2875 " * PROGRAM:test-program\n"
2876 " * @short_description: Тесттік бағдарлама\n"
2877 " * @synopsis: test-program [*ОПЦИЯЛАР*...] --arg1 *арг* *ФАЙЛ*\n"
2878 " * @see_also: test(1)\n"
2879 " * @--arg1 *арг*: arg1 мәнін *арг* етіп орнату\n"
2880 " * @--arg2 *арг*: arg2 мәнін *арг* етіп орнату\n"
2881 " * @-v, --version: Нұсқа нөмірін басып шығару\n"
2882 " * @-h, --help: Көмек хабарын басып шығару\n"
2883 " *\n"
2884 " * Бағдарламаның толық сипаттамасы.\n"
2885 " *\n"
2886 " * Қайтарады: Сәтті болғанда нөл, сәтсіз болғанда нөл емес мән\n"
2887 " */\n"
2888 "int main(int argc, char *argv[])\n"
2889 "{\n"
2890 "\treturn 0;\n"
2891 "}\n"
2892
2893 #. (itstool) path: sect1/title
2894 #: C/index.docbook:1850
2895 msgid "Useful DocBook tags"
2896 msgstr "Пайдалы DocBook тегтері"
2897
2898 #. (itstool) path: sect1/para
2899 #: C/index.docbook:1852
2900 msgid ""
2901 "Here are some DocBook tags which are most useful when documenting the code."
2902 msgstr "Мұнда кодты құжаттау кезінде ең пайдалы DocBook тегтері берілген."
2903
2904 #. (itstool) path: informalexample/programlisting
2905 #: C/index.docbook:1861
2906 #, no-wrap
2907 msgid ""
2908 "\n"
2909 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2910 msgstr ""
2911 "\n"
2912 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Хэш-кестелер&lt;/link&gt;\n"
2913
2914 #. (itstool) path: sect1/para
2915 #: C/index.docbook:1857
2916 msgid ""
2917 "To link to another section in the GTK docs: <_:informalexample-1/> The linkend "
2918 "is the SGML/XML id on the top item of the page you want to link to. For most "
2919 "pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and then the "
2920 "page title (\"Hash Tables\"). For widgets it is just the class name. Spaces "
2921 "and underscores are converted to '-' to conform to SGML/XML."
2922 msgstr ""
2923 "GTK құжаттарындағы басқа бөлімге сілтеме жасау үшін: <_:informalexample-1/> "
2924 "linkend — сілтеме жасағыңыз келетін беттің жоғарғы элементіндегі SGML/XML "
2925 "идентификаторы. Көптеген беттер үшін бұл қазіргі уақытта бөлім (\"gtk\", "
2926 "\"gdk\", \"glib\"), содан кейін бет тақырыбы (\"Хэш-кестелер\"). Виджеттер "
2927 "үшін бұл жай ғана класс атауы. SGML/XML талаптарына сәйкес келу үшін бос "
2928 "орындар мен астын сызу таңбалары '-' таңбасына айналдырылады."
2929
2930 #. (itstool) path: informalexample/programlisting
2931 #: C/index.docbook:1874
2932 #, no-wrap
2933 msgid ""
2934 "\n"
2935 "&lt;function&gt;...&lt;/function&gt;\n"
2936 msgstr ""
2937 "\n"
2938 "&lt;function&gt;...&lt;/function&gt;\n"
2939
2940 #. (itstool) path: sect1/para
2941 #: C/index.docbook:1871
2942 msgid ""
2943 "To refer to an external function, e.g. a standard C function: "
2944 "<_:informalexample-1/>"
2945 msgstr ""
2946 "Сыртқы функцияға сілтеме жасау үшін, мысалы, стандартты C функциясы: "
2947 "<_:informalexample-1/>"
2948
2949 #. (itstool) path: informalexample/programlisting
2950 #: C/index.docbook:1883
2951 #, no-wrap
2952 msgid ""
2953 "\n"
2954 "&lt;example&gt;\n"
2955 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
2956 " &lt;programlisting language=\"C\"&gt;\n"
2957 " ...\n"
2958 " &lt;/programlisting&gt;\n"
2959 "&lt;/example&gt;\n"
2960 msgstr ""
2961 "\n"
2962 "&lt;example&gt;\n"
2963 " &lt;title&gt;GHashTable пайдалану.&lt;/title&gt;\n"
2964 " &lt;programlisting language=\"C\"&gt;\n"
2965 " ...\n"
2966 " &lt;/programlisting&gt;\n"
2967 "&lt;/example&gt;\n"
2968
2969 #. (itstool) path: informalexample/programlisting
2970 #: C/index.docbook:1894
2971 #, no-wrap
2972 msgid ""
2973 "\n"
2974 "&lt;informalexample&gt;\n"
2975 " &lt;programlisting language=\"C\"&gt;\n"
2976 " ...\n"
2977 " &lt;/programlisting&gt;\n"
2978 "&lt;/informalexample&gt;\n"
2979 msgstr ""
2980 "\n"
2981 "&lt;informalexample&gt;\n"
2982 " &lt;programlisting language=\"C\"&gt;\n"
2983 " ...\n"
2984 " &lt;/programlisting&gt;\n"
2985 "&lt;/informalexample&gt;\n"
2986
2987 #. (itstool) path: informalexample/programlisting
2988 #: C/index.docbook:1906
2989 #, no-wrap
2990 msgid ""
2991 "\n"
2992 "|[&lt;!-- language=\"C\" --&gt;\n"
2993 " ...\n"
2994 "]|\n"
2995 msgstr ""
2996 "\n"
2997 "|[&lt;!-- language=\"C\" --&gt;\n"
2998 " ...\n"
2999 "]|\n"
3000
3001 #. (itstool) path: sect1/para
3002 #: C/index.docbook:1880
3003 msgid ""
3004 "To include example code: <_:informalexample-1/> or possibly this, for very "
3005 "short code fragments which don't need a title: <_:informalexample-2/> In both "
3006 "cases, the language attribute is optional and is used as a hint to the syntax "
3007 "highlighting engine (pygments for html output). For the latter GTK-Doc also "
3008 "supports an abbreviation: <_:informalexample-3/>"
3009 msgstr ""
3010 "Код мысалын қосу үшін: <_:informalexample-1/> немесе тақырыпты қажет етпейтін "
3011 "өте қысқа код фрагменттері үшін: <_:informalexample-2/> Екі жағдайда да "
3012 "language атрибуты міндетті емес және синтаксисті жарықтандыру қозғалтқышына "
3013 "(html нәтижесі үшін pygments) нұсқау ретінде қолданылады. Соңғысы үшін GTK-Doc "
3014 "қысқартуды да қолдайды: <_:informalexample-3/>"
3015
3016 #. (itstool) path: informalexample/programlisting
3017 #: C/index.docbook:1917
3018 #, no-wrap
3019 msgid ""
3020 "\n"
3021 "&lt;itemizedlist&gt;\n"
3022 " &lt;listitem&gt;\n"
3023 " &lt;para&gt;\n"
3024 " ...\n"
3025 " &lt;/para&gt;\n"
3026 " &lt;/listitem&gt;\n"
3027 " &lt;listitem&gt;\n"
3028 " &lt;para&gt;\n"
3029 " ...\n"
3030 " &lt;/para&gt;\n"
3031 " &lt;/listitem&gt;\n"
3032 "&lt;/itemizedlist&gt;\n"
3033 msgstr ""
3034 "\n"
3035 "&lt;itemizedlist&gt;\n"
3036 " &lt;listitem&gt;\n"
3037 " &lt;para&gt;\n"
3038 " ...\n"
3039 " &lt;/para&gt;\n"
3040 " &lt;/listitem&gt;\n"
3041 " &lt;listitem&gt;\n"
3042 " &lt;para&gt;\n"
3043 " ...\n"
3044 " &lt;/para&gt;\n"
3045 " &lt;/listitem&gt;\n"
3046 "&lt;/itemizedlist&gt;\n"
3047
3048 #. (itstool) path: sect1/para
3049 #: C/index.docbook:1914
3050 msgid "To include bulleted lists: <_:informalexample-1/>"
3051 msgstr "Таңбаланған тізімдерді қосу үшін: <_:informalexample-1/>"
3052
3053 #. (itstool) path: informalexample/programlisting
3054 #: C/index.docbook:1937
3055 #, no-wrap
3056 msgid ""
3057 "\n"
3058 "&lt;note&gt;\n"
3059 " &lt;para&gt;\n"
3060 " Make sure you free the data after use.\n"
3061 " &lt;/para&gt;\n"
3062 "&lt;/note&gt;\n"
3063 msgstr ""
3064 "\n"
3065 "&lt;note&gt;\n"
3066 " &lt;para&gt;\n"
3067 " Пайдаланғаннан кейін деректерді босатуды ұмытпаңыз.\n"
3068 " &lt;/para&gt;\n"
3069 "&lt;/note&gt;\n"
3070
3071 #. (itstool) path: sect1/para
3072 #: C/index.docbook:1934
3073 msgid "To include a note which stands out from the text: <_:informalexample-1/>"
3074 msgstr "Мәтіннен ерекшеленіп тұратын ескертуді қосу үшін: <_:informalexample-1/>"
3075
3076 #. (itstool) path: informalexample/programlisting
3077 #: C/index.docbook:1950
3078 #, no-wrap
3079 msgid ""
3080 "\n"
3081 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3082 msgstr ""
3083 "\n"
3084 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3085
3086 #. (itstool) path: sect1/para
3087 #: C/index.docbook:1947
3088 msgid "To refer to a type: <_:informalexample-1/>"
3089 msgstr "Түрге (type) сілтеме жасау үшін: <_:informalexample-1/>"
3090
3091 #. (itstool) path: informalexample/programlisting
3092 #: C/index.docbook:1959
3093 #, no-wrap
3094 msgid ""
3095 "\n"
3096 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3097 msgstr ""
3098 "\n"
3099 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3100
3101 #. (itstool) path: sect1/para
3102 #: C/index.docbook:1956
3103 msgid ""
3104 "To refer to an external structure (not one described in the GTK docs): "
3105 "<_:informalexample-1/>"
3106 msgstr ""
3107 "Сыртқы құрылымға сілтеме жасау үшін (GTK құжаттарында сипатталмаған): "
3108 "<_:informalexample-1/>"
3109
3110 #. (itstool) path: informalexample/programlisting
3111 #: C/index.docbook:1968
3112 #, no-wrap
3113 msgid ""
3114 "\n"
3115 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3116 msgstr ""
3117 "\n"
3118 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3119
3120 #. (itstool) path: sect1/para
3121 #: C/index.docbook:1965
3122 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3123 msgstr "Құрылымның өрісіне сілтеме жасау үшін: <_:informalexample-1/>"
3124
3125 #. (itstool) path: informalexample/programlisting
3126 #: C/index.docbook:1977
3127 #, no-wrap
3128 msgid ""
3129 "\n"
3130 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3131 msgstr ""
3132 "\n"
3133 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3134
3135 #. (itstool) path: sect1/para
3136 #: C/index.docbook:1974
3137 msgid ""
3138 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3139 "you'll probably be using #GtkWidget instead (to automatically create a link to "
3140 "the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3141 "abbreviations</link>)."
3142 msgstr ""
3143 "Класс атауына сілтеме жасау үшін біз мынаны пайдалана аламыз: "
3144 "<_:informalexample-1/> бірақ сіз оның орнына #GtkWidget пайдаланатын шығарсыз "
3145 "(GtkWidget бетіне автоматты түрде сілтеме жасау үшін — <link "
3146 "linkend=\"documenting_syntax\">қысқартуларды</link> қараңыз)."
3147
3148 #. (itstool) path: informalexample/programlisting
3149 #: C/index.docbook:1988
3150 #, no-wrap
3151 msgid ""
3152 "\n"
3153 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3154 msgstr ""
3155 "\n"
3156 "&lt;emphasis&gt;Бұл маңызды&lt;/emphasis&gt;\n"
3157
3158 #. (itstool) path: sect1/para
3159 #: C/index.docbook:1985
3160 msgid "To emphasize text: <_:informalexample-1/>"
3161 msgstr "Мәтінді ерекшелеу үшін: <_:informalexample-1/>"
3162
3163 #. (itstool) path: informalexample/programlisting
3164 #: C/index.docbook:1997
3165 #, no-wrap
3166 msgid ""
3167 "\n"
3168 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3169 msgstr ""
3170 "\n"
3171 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3172
3173 #. (itstool) path: sect1/para
3174 #: C/index.docbook:1994
3175 msgid "For filenames use: <_:informalexample-1/>"
3176 msgstr "Файл аттары үшін пайдаланыңыз: <_:informalexample-1/>"
3177
3178 #. (itstool) path: informalexample/programlisting
3179 #: C/index.docbook:2006
3180 #, no-wrap
3181 msgid ""
3182 "\n"
3183 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3184 msgstr ""
3185 "\n"
3186 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3187
3188 #. (itstool) path: sect1/para
3189 #: C/index.docbook:2003
3190 msgid "To refer to keys use: <_:informalexample-1/>"
3191 msgstr "Пернелерге сілтеме жасау үшін пайдаланыңыз: <_:informalexample-1/>"
3192
3193 #. (itstool) path: chapter/title
3194 #: C/index.docbook:2016
3195 msgid "Filling the extra files"
3196 msgstr "Қосымша файлдарды толтыру"
3197
3198 #. (itstool) path: chapter/para
3199 #: C/index.docbook:2018
3200 msgid ""
3201 "There are a couple of extra files, that need to be maintained along with the "
3202 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3203 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3204 "<filename>&lt;package&gt;-sections.txt</filename>."
3205 msgstr ""
3206 "Бастапқы кодтағы ішкі түсіндірмелермен бірге сақталуы керек бірнеше қосымша "
3207 "файлдар бар: <filename>&lt;package&gt;.types</filename>, "
3208 "<filename>&lt;package&gt;-docs.xml</filename> (бұрын .sgml), "
3209 "<filename>&lt;package&gt;-sections.txt</filename>."
3210
3211 #. (itstool) path: sect1/title
3212 #: C/index.docbook:2027
3213 msgid "Editing the types file"
3214 msgstr "Түрлер (types) файлын түзету"
3215
3216 #. (itstool) path: sect1/para
3217 #: C/index.docbook:2029
3218 msgid ""
3219 "If your library or application includes GObjects, you want their signals, "
3220 "arguments/parameters and position in the hierarchy to be shown in the "
3221 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3222 "function> functions together with their include inside the "
3223 "<filename>&lt;package&gt;.types</filename> file."
3224 msgstr ""
3225 "Егер сіздің кітапханаңызда немесе қолданбаңызда GObjects болса, олардың "
3226 "сигналдары, аргументтері/параметрлері және иерархиядағы орны құжаттамада "
3227 "көрсетілгенін қалайсыз. Сізге тек <function>xxx_get_type</function> "
3228 "функцияларын олардың include файлымен бірге <filename>&lt;package&gt;.types</"
3229 "filename> файлында тізімдеу керек."
3230
3231 #. (itstool) path: example/title
3232 #: C/index.docbook:2038
3233 msgid "Example &lt;package&gt;.types file"
3234 msgstr "&lt;package&gt;.types файлының мысалы"
3235
3236 #. (itstool) path: example/programlisting
3237 #: C/index.docbook:2039
3238 #, no-wrap
3239 msgid ""
3240 "\n"
3241 "#include &lt;gtk/gtk.h&gt;\n"
3242 "\n"
3243 "gtk_accel_label_get_type\n"
3244 "gtk_adjustment_get_type\n"
3245 "gtk_alignment_get_type\n"
3246 "gtk_arrow_get_type\n"
3247 msgstr ""
3248 "\n"
3249 "#include &lt;gtk/gtk.h&gt;\n"
3250 "\n"
3251 "gtk_accel_label_get_type\n"
3252 "gtk_adjustment_get_type\n"
3253 "gtk_alignment_get_type\n"
3254 "gtk_arrow_get_type\n"
3255
3256 #. (itstool) path: sect1/para
3257 #: C/index.docbook:2050
3258 msgid ""
3259 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3260 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3261 "<filename>Makefile.am</filename>. If you use this approach you should not dist "
3262 "the types file nor have it under version control."
3263 msgstr ""
3264 "GTK-Doc 1.8 нұсқасынан бастап <application>gtkdoc-scan</application> бұл "
3265 "тізімді сіз үшін жасай алады. Тек <filename>Makefile.am</filename> ішіндегі "
3266 "SCAN_OPTIONS айнымалысына \"--rebuild-types\" қосыңыз. Егер сіз осы тәсілді "
3267 "пайдалансаңыз, types файлын таратпауыңыз немесе оны нұсқаларды бақылау "
3268 "жүйесінде сақтамауыңыз керек."
3269
3270 #. (itstool) path: sect1/title
3271 #: C/index.docbook:2059
3272 msgid "Editing the master document"
3273 msgstr "Негізгі құжатты түзету"
3274
3275 #. (itstool) path: sect1/para
3276 #: C/index.docbook:2061
3277 msgid ""
3278 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the inline "
3279 "source comments, the GTK-Doc tools generate one documentation page per class "
3280 "or module as a separate file. The master document includes them and place them "
3281 "in an order."
3282 msgstr ""
3283 "GTK-Doc DocBook SGML/XML пішімінде құжаттама жасайды. Бастапқы кодтың ішкі "
3284 "түсіндірмелерін өңдеу кезінде GTK-Doc саймандары әрбір класс немесе модуль "
3285 "үшін жеке файл ретінде бір құжаттама бетін жасайды. Негізгі құжат оларды "
3286 "қамтиды және белгілі бір ретпен орналастырады."
3287
3288 #. (itstool) path: sect1/para
3289 #: C/index.docbook:2068
3290 msgid ""
3291 "While GTK-Doc creates a template master document for you, later runs will not "
3292 "touch it again. This means that one can freely structure the documentation. "
3293 "That includes grouping pages and adding extra pages. GTK-Doc has now a test "
3294 "suite, where also the master-document is recreated from scratch. Its a good "
3295 "idea to look at this from time to time to see if there are some new goodies "
3296 "introduced there."
3297 msgstr ""
3298 "GTK-Doc сіз үшін негізгі үлгі құжатын жасағанымен, кейінгі іске қосулар оған "
3299 "тиіспейді. Бұл құжаттаманы еркін құрылымдауға болатынын білдіреді. Бұл "
3300 "беттерді топтастыруды және қосымша беттерді қосуды қамтиды. GTK-Doc-та қазір "
3301 "тест жинағы бар, онда негізгі құжат нөлден қайта жасалады. Онда қандай да бір "
3302 "жаңа мүмкіндіктер енгізілгенін көру үшін оған мезгіл-мезгіл қарап тұрған дұрыс."
3303
3304 #. (itstool) path: tip/para
3305 #: C/index.docbook:2078
3306 msgid ""
3307 "Do not create tutorials as extra documents. Just write extra chapters. The "
3308 "benefit of directly embedding the tutorial for your library into the API "
3309 "documentation is that it is easy to link for the tutorial to symbol "
3310 "documentation. Apart chances are higher that the tutorial gets updates along "
3311 "with the library."
3312 msgstr ""
3313 "Оқулықтарды қосымша құжат ретінде жасамаңыз. Тек қосымша тараулар жазыңыз. "
3314 "Кітапханаңызға арналған оқулықты тікелей API құжаттамасына енгізудің пайдасы — "
3315 "оқулықтан таңба құжаттамасына сілтеме жасау оңай болады. Сонымен қатар, "
3316 "оқулықтың кітапханамен бірге жаңару мүмкіндігі жоғары болады."
3317
3318 #. (itstool) path: sect1/para
3319 #: C/index.docbook:2087
3320 msgid ""
3321 "So what are the things to change inside the master document? For a start is "
3322 "only a little. There are some placeholders (text in square brackets) there "
3323 "which you should take care of."
3324 msgstr ""
3325 "Сонымен, негізгі құжат ішінде нені өзгерту керек? Бастапқыда өте аз нәрсе. "
3326 "Онда сіз назар аударуыңыз керек кейбір толтырғыштар (шаршы жақшадағы мәтін) "
3327 "бар."
3328
3329 #. (itstool) path: example/title
3330 #: C/index.docbook:2094
3331 msgid "Master document header"
3332 msgstr "Негізгі құжаттың тақырыптамасы"
3333
3334 #. (itstool) path: example/programlisting
3335 #: C/index.docbook:2095
3336 #, no-wrap
3337 msgid ""
3338 "\n"
3339 "&lt;bookinfo&gt;\n"
3340 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3341 " &lt;releaseinfo&gt;\n"
3342 " for MODULENAME [VERSION]\n"
3343 " The latest version of this documentation can be found on-line at\n"
3344 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3345 " &lt;/releaseinfo&gt;\n"
3346 "&lt;/bookinfo&gt;\n"
3347 "\n"
3348 "&lt;chapter&gt;\n"
3349 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3350 msgstr ""
3351 "\n"
3352 "&lt;bookinfo&gt;\n"
3353 " &lt;title&gt;MODULENAME анықтамалық нұсқаулығы&lt;/title&gt;\n"
3354 " &lt;releaseinfo&gt;\n"
3355 " MODULENAME [VERSION] үшін\n"
3356 " Бұл құжаттаманың соңғы нұсқасын желіде мына жерден табуға болады:\n"
3357 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3358 " &lt;/releaseinfo&gt;\n"
3359 "&lt;/bookinfo&gt;\n"
3360 "\n"
3361 "&lt;chapter&gt;\n"
3362 " &lt;title&gt;[Атауды осында енгізіңіз]&lt;/title&gt;\n"
3363
3364 #. (itstool) path: sect1/para
3365 #: C/index.docbook:2111
3366 msgid ""
3367 "In addition a few option elements are created in commented form. You can "
3368 "review these and enable them as you like."
3369 msgstr ""
3370 "Бұған қоса, түсіндірме түрінде бірнеше опциялық элементтер жасалады. Сіз "
3371 "оларды қарап шығып, қалауыңызша іске қоса аласыз."
3372
3373 #. (itstool) path: example/title
3374 #: C/index.docbook:2117
3375 msgid "Optional part in the master document"
3376 msgstr "Негізгі құжаттағы міндетті емес бөлік"
3377
3378 #. (itstool) path: example/programlisting
3379 #: C/index.docbook:2118
3380 #, no-wrap
3381 msgid ""
3382 "\n"
3383 " &lt;!-- enable this when you use gobject introspection annotations\n"
3384 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3385 " --&gt;\n"
3386 msgstr ""
3387 "\n"
3388 "&lt;!-- gobject introspection аннотацияларын пайдаланған кезде мұны іске қосыңыз\n"
3389 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3390 " --&gt;\n"
3391
3392 #. (itstool) path: sect1/para
3393 #: C/index.docbook:2126
3394 msgid ""
3395 "Finally you need to add new section whenever you introduce one. The <link "
3396 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind you "
3397 "of newly generated xml files that are not yet included into the doc."
3398 msgstr ""
3399 "Соңында, жаңа бөлім енгізген сайын оны қосу керек. <link linkend=\"modernizing-"
3400 "gtk-doc-1-16\">gtkdoc-check</link> сайманы әлі құжатқа енгізілмеген жаңадан "
3401 "жасалған xml файлдары туралы еске салып отырады."
3402
3403 #. (itstool) path: example/title
3404 #: C/index.docbook:2134 C/index.docbook:2169
3405 msgid "Including generated sections"
3406 msgstr "Жасалған бөлімдерді қосу"
3407
3408 #. (itstool) path: example/programlisting
3409 #: C/index.docbook:2135
3410 #, no-wrap
3411 msgid ""
3412 "\n"
3413 " &lt;chapter&gt;\n"
3414 " &lt;title&gt;my library&lt;/title&gt;\n"
3415 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3416 " ...\n"
3417 msgstr ""
3418 "\n"
3419 "&lt;chapter&gt;\n"
3420 " &lt;title&gt;менің кітапханам&lt;/title&gt;\n"
3421 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3422 " ...\n"
3423
3424 #. (itstool) path: sect1/title
3425 #: C/index.docbook:2147
3426 msgid "Editing the section file"
3427 msgstr "Бөлім файлын түзету"
3428
3429 #. (itstool) path: sect1/para
3430 #: C/index.docbook:2149
3431 msgid ""
3432 "The section file is used to organise the documentation output by GTK-Doc. Here "
3433 "one specifies which symbol belongs to which module or class and control the "
3434 "visibility (public or private)."
3435 msgstr ""
3436 "Бөлім файлы GTK-Doc шығаратын құжаттаманы ұйымдастыру үшін қолданылады. Мұнда "
3437 "қай таңба қай модульге немесе класқа жататыны көрсетіледі және көрінуі (ашық "
3438 "немесе жеке) басқарылады."
3439
3440 #. (itstool) path: sect1/para
3441 #: C/index.docbook:2155
3442 msgid ""
3443 "The section file is a plain text file with tags delimiting sections. Blank "
3444 "lines are ignored and lines starting with a '#' are treated as comment lines."
3445 msgstr ""
3446 "Бөлім файлы — бөлімдерді ажырататын тегтері бар жай мәтіндік файл. Бос жолдар "
3447 "еленбейді және '#' таңбасынан басталатын жолдар түсіндірме жолдары ретінде "
3448 "қарастырылады."
3449
3450 #. (itstool) path: note/para
3451 #: C/index.docbook:2162
3452 msgid ""
3453 "While the tags make the file look like xml, it is not. Please do not close "
3454 "tags like &lt;SUBSECTION&gt;."
3455 msgstr ""
3456 "Тегтер файлды xml сияқты етіп көрсеткенімен, ол xml емес. Өтінеміз, "
3457 "&lt;SUBSECTION&gt; сияқты тегтерді жаппаңыз."
3458
3459 #. (itstool) path: example/programlisting
3460 #: C/index.docbook:2170
3461 #, no-wrap
3462 msgid ""
3463 "\n"
3464 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3465 "\n"
3466 "&lt;SECTION&gt;\n"
3467 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3468 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3469 "MeepApp\n"
3470 "&lt;SUBSECTION Standard&gt;\n"
3471 "MEEP_APP\n"
3472 "...\n"
3473 "MeepAppClass\n"
3474 "meep_app_get_type\n"
3475 "&lt;/SECTION&gt;\n"
3476 msgstr ""
3477 "\n"
3478 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3479 "\n"
3480 "&lt;SECTION&gt;\n"
3481 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3482 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3483 "MeepApp\n"
3484 "&lt;SUBSECTION Standard&gt;\n"
3485 "MEEP_APP\n"
3486 "...\n"
3487 "MeepAppClass\n"
3488 "meep_app_get_type\n"
3489 "&lt;/SECTION&gt;\n"
3490
3491 #. (itstool) path: sect1/para
3492 #: C/index.docbook:2187
3493 msgid ""
3494 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3495 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/FILE&gt;' "
3496 "will result in the section declarations being output in the template file "
3497 "<filename>tmpl/gnome-config.sgml</filename>, which will be converted into the "
3498 "DocBook XML file <filename>xml/gnome-config.sgml</filename> or the DocBook XML "
3499 "file <filename>xml/gnome-config.xml</filename>. (The name of the HTML file is "
3500 "based on the module name and the section title, or for GObjects it is based on "
3501 "the GObjects class name converted to lower case)."
3502 msgstr ""
3503 "&lt;FILE&gt; ... &lt;/FILE&gt; тегі суффиксіз файл атын көрсету үшін "
3504 "қолданылады. Мысалы, '&lt;FILE&gt;gnome-config&lt;/FILE&gt;' пайдалану бөлім "
3505 "декларацияларының <filename>tmpl/gnome-config.sgml</filename> үлгі файлында "
3506 "шығарылуына әкеледі, ол <filename>xml/gnome-config.sgml</filename> DocBook XML "
3507 "файлына немесе <filename>xml/gnome-config.xml</filename> DocBook XML файлына "
3508 "айналдырылады. (HTML файлының аты модуль атына және бөлім тақырыбына "
3509 "негізделеді немесе GObjects үшін ол кіші әріптерге айналдырылған GObjects "
3510 "класс атына негізделеді)."
3511
3512 #. (itstool) path: sect1/para
3513 #: C/index.docbook:2199
3514 msgid ""
3515 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3516 "section. It is only useful before the templates (if used) are initially "
3517 "created, since the title set in the template file overrides this. Also if one "
3518 "uses SECTION comment in the sources, this is obsolete."
3519 msgstr ""
3520 "&lt;TITLE&gt; ... &lt;/TITLE&gt; тегі бөлім тақырыбын көрсету үшін "
3521 "қолданылады. Ол тек үлгілер (егер пайдаланылса) бастапқыда жасалғанға дейін "
3522 "ғана пайдалы, өйткені үлгі файлында орнатылған тақырып оны алмастырады. Сондай-"
3523 "ақ, егер бастапқы кодтарда SECTION түсіндірмесі пайдаланылса, бұл ескірген "
3524 "болып саналады."
3525
3526 #. (itstool) path: sect1/para
3527 #: C/index.docbook:2206
3528 msgid ""
3529 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3530 "Currently it outputs a blank line between subsections in the synopsis section. "
3531 "You can also use &lt;SUBSECTION Standard&gt; for standard GObject declarations "
3532 "(e.g. the functions like g_object_get_type and macros like G_OBJECT(), "
3533 "G_IS_OBJECT() etc.). Currently these are left out of the documentation. You "
3534 "can also use &lt;SUBSECTION Private&gt; for private declarations which will "
3535 "not be output (it is a handy way to avoid warning messages about unused "
3536 "declarations). If your library contains private types which you don't want to "
3537 "appear in the object hierarchy and the list of implemented or required "
3538 "interfaces, add them to a Private subsection. Whether you would place GObject "
3539 "and GObjectClass like structs in public or Standard section depends if they "
3540 "have public entries (variables, vmethods)."
3541 msgstr ""
3542 "Элементтерді бөлімде &lt;SUBSECTION&gt; тегі арқылы топтастыруға болады. "
3543 "Қазіргі уақытта ол синопсис бөліміндегі ішкі бөлімдер арасында бос жолды "
3544 "шығарады. Стандартты GObject декларациялары (мысалы, g_object_get_type сияқты "
3545 "функциялар және G_OBJECT(), G_IS_OBJECT() және т.б. сияқты макростар) үшін "
3546 "&lt;SUBSECTION Standard&gt; пайдалануға болады. Қазіргі уақытта олар "
3547 "құжаттамадан тыс қалады. Сондай-ақ шығарылмайтын жеке декларациялар үшін "
3548 "&lt;SUBSECTION Private&gt; пайдалануға болады (бұл пайдаланылмаған "
3549 "декларациялар туралы ескерту хабарламаларын болдырмаудың ыңғайлы жолы). Егер "
3550 "кітапханаңызда объект иерархиясында және іске асырылған немесе талап етілетін "
3551 "интерфейстер тізімінде көрінуін қаламайтын жеке түрлер болса, оларды Private "
3552 "ішкі бөліміне қосыңыз. GObject және GObjectClass сияқты құрылымдарды public "
3553 "немесе Standard бөліміне орналастыру олардың ашық жазбаларының (айнымалылар, "
3554 "vmethod-тар) болуына байланысты."
3555
3556 #. (itstool) path: sect1/para
3557 #: C/index.docbook:2225
3558 msgid ""
3559 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the #include "
3560 "files which are shown in the synopsis sections. It contains a comma-separate "
3561 "list of #include files, without the angle brackets. If you set it outside of "
3562 "any sections, it acts for all sections until the end of the file. If you set "
3563 "it within a section, it only applies to that section."
3564 msgstr ""
3565 "Синопсис бөлімдерінде көрсетілетін #include файлдарын көрсету үшін "
3566 "&lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; де пайдалануға болады. Онда бұрыштық "
3567 "жақшасыз, үтірмен ажыратылған #include файлдарының тізімі болады. Егер оны кез "
3568 "келген бөлімнен тыс орнатсаңыз, ол файлдың соңына дейін барлық бөлімдер үшін "
3569 "әрекет етеді. Егер оны бөлім ішінде орнатсаңыз, ол тек сол бөлімге ғана "
3570 "қатысты болады."
3571
3572 #. (itstool) path: chapter/title
3573 #: C/index.docbook:2239
3574 msgid "Controlling the result"
3575 msgstr "Нәтижені бақылау"
3576
3577 #. (itstool) path: chapter/para
3578 #: C/index.docbook:2241
3579 msgid ""
3580 "A GTK-Doc run generates report files inside the documentation directory. The "
3581 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3582 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3583 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3584 "files that can be viewed and postprocessed easily."
3585 msgstr ""
3586 "GTK-Doc іске қосылуы құжаттама бумасында есеп файлдарын жасайды. Жасалған "
3587 "файлдар келесідей аталады: <filename>&lt;package&gt;-undocumented.txt</"
3588 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> және "
3589 "<filename>&lt;package&gt;-unused.txt</filename>. Бұлардың барлығы оңай қарауға "
3590 "және өңдеуге болатын жай мәтіндік файлдар."
3591
3592 #. (itstool) path: chapter/para
3593 #: C/index.docbook:2250
3594 msgid ""
3595 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with the "
3596 "documentation coverage summary. Below are two sections divided by blank lines. "
3597 "The first section lists undocumented or incomplete symbols. The second section "
3598 "does the same for section docs. Incomplete entries are those, which have "
3599 "documentation, but where e.g. a new parameter has been added."
3600 msgstr ""
3601 "<filename>&lt;package&gt;-undocumented.txt</filename> файлы құжаттаманың "
3602 "қамтылуы туралы жиынтықпен басталады. Төменде бос жолдармен бөлінген екі бөлім "
3603 "бар. Бірінші бөлімде құжатталмаған немесе толық емес таңбалар тізімі берілген. "
3604 "Екінші бөлімде бөлім құжаттары үшін дәл солай жасалған. Толық емес жазбалар — "
3605 "бұл құжаттамасы бар, бірақ, мысалы, жаңа параметр қосылған жазбалар."
3606
3607 #. (itstool) path: chapter/para
3608 #: C/index.docbook:2259
3609 msgid ""
3610 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3611 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3612 "in the sources. Check if they have been removed or if they are misspelled."
3613 msgstr ""
3614 "<filename>&lt;package&gt;-undeclared.txt</filename> файлы "
3615 "<filename>&lt;package&gt;-sections.txt</filename> файлында берілген, бірақ "
3616 "бастапқы кодтарда табылмаған таңбаларды тізімдейді. Олардың жойылғанын немесе "
3617 "қате жазылғанын тексеріңіз."
3618
3619 #. (itstool) path: chapter/para
3620 #: C/index.docbook:2266
3621 msgid ""
3622 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3623 "where the GTK-Doc scanner has found documentation, but does not know where to "
3624 "put it. This means that the symbol has not yet been added to the "
3625 "<filename>&lt;package&gt;-sections.txt</filename> file."
3626 msgstr ""
3627 "<filename>&lt;package&gt;-unused.txt</filename> файлы GTK-Doc сканері "
3628 "құжаттамасын тапқан, бірақ оны қайда қою керектігін білмейтін таңбалардың "
3629 "атауларын тізімдейді. Бұл таңба әлі <filename>&lt;package&gt;-sections.txt</"
3630 "filename> файлына қосылмағанын білдіреді."
3631
3632 #. (itstool) path: tip/para
3633 #: C/index.docbook:2274
3634 msgid ""
3635 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile.am. "
3636 "If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
3637 "<command>make check</command> run."
3638 msgstr ""
3639 "Makefile.am ішіне <option>TESTS=$(GTKDOC_CHECK)</option> жолын қосыңыз немесе "
3640 "іске қосыңыз. Егер кем дегенде GTK-Doc 1.9 орнатылған болса, бұл <command>make "
3641 "check</command> іске қосу кезінде дұрыстық тексерулерін орындайды."
3642
3643 #. (itstool) path: chapter/para
3644 #: C/index.docbook:2281
3645 msgid ""
3646 "One can also look at the files produced by the source code scanner: "
3647 "<filename>&lt;package&gt;-decl-list.txt</filename> and "
3648 "<filename>&lt;package&gt;-decl.txt</filename>. The first one can be compared "
3649 "with the section file if that is manually maintained. The second lists all "
3650 "declarations from the headers. If a symbol is missing one could check if this "
3651 "file contains it."
3652 msgstr ""
3653 "Сондай-ақ бастапқы код сканері шығарған файлдарды қарауға болады: "
3654 "<filename>&lt;package&gt;-decl-list.txt</filename> және "
3655 "<filename>&lt;package&gt;-decl.txt</filename>. Біріншісін бөлім файлымен "
3656 "салыстыруға болады, егер ол қолмен сақталса. Екіншісі тақырыптық файлдардағы "
3657 "барлық декларацияларды тізімдейді. Егер таңба жетіспесе, осы файлда оның бар-"
3658 "жоғын тексеруге болады."
3659
3660 #. (itstool) path: chapter/para
3661 #: C/index.docbook:2290
3662 msgid ""
3663 "If the project is GObject based, one can also look into the files produced by "
3664 "the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3665 "<filename>&lt;package&gt;.hierarchy.txt</filename>, "
3666 "<filename>&lt;package&gt;.interfaces.txt</filename>, "
3667 "<filename>&lt;package&gt;.prerequisites.txt</filename> and "
3668 "<filename>&lt;package&gt;.signals.txt</filename>. If there are missing symbols "
3669 "in any of those, one can ask GTK-Doc to keep the intermediate scanner file for "
3670 "further analysis, by running it as <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</"
3671 "command>."
3672 msgstr ""
3673 "Егер жоба GObject негізінде болса, объект сканері шығарған файлдарды да "
3674 "қарауға болады: <filename>&lt;package&gt;.args.txt</filename>, "
3675 "<filename>&lt;package&gt;.hierarchy.txt</filename>, "
3676 "<filename>&lt;package&gt;.interfaces.txt</filename>, "
3677 "<filename>&lt;package&gt;.prerequisites.txt</filename> және "
3678 "<filename>&lt;package&gt;.signals.txt</filename>. Егер олардың кез келгенінде "
3679 "таңбалар жетіспесе, GTK-Doc-ты <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</"
3680 "command> арқылы іске қосып, одан әрі талдау үшін аралық сканер файлын сақтауын "
3681 "сұрауға болады."
3682
3683 #. (itstool) path: chapter/title
3684 #: C/index.docbook:2305
3685 msgid "Modernizing the documentation"
3686 msgstr "Құжаттаманы заманауи ету"
3687
3688 #. (itstool) path: chapter/para
3689 #: C/index.docbook:2307
3690 msgid ""
3691 "GTK-Doc has been around for quite some time. In this section we list new "
3692 "features together with the version since when it is available."
3693 msgstr ""
3694 "GTK-Doc біраз уақыттан бері бар. Бұл бөлімде біз жаңа мүмкіндіктерді олардың "
3695 "қолжетімді болған нұсқасымен бірге тізімдейміз."
3696
3697 #. (itstool) path: sect1/title
3698 #: C/index.docbook:2313
3699 msgid "GTK-Doc 1.9"
3700 msgstr "GTK-Doc 1.9"
3701
3702 #. (itstool) path: sect1/para
3703 #: C/index.docbook:2315
3704 msgid ""
3705 "When using xml instead of sgml, one can actually name the master document "
3706 "<filename>&lt;package&gt;-docs.xml</filename>."
3707 msgstr ""
3708 "sgml орнына xml пайдаланған кезде, негізгі құжатты <filename>&lt;package&gt;-"
3709 "docs.xml</filename> деп атауға болады."
3710
3711 #. (itstool) path: sect1/para
3712 #: C/index.docbook:2320
3713 msgid ""
3714 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3715 "<filename>Makefile.am</filename>. When this is enabled, the "
3716 "<filename>&lt;package&gt;-sections.txt</filename> is autogenerated and can be "
3717 "removed from the vcs. This only works nicely for projects that have a very "
3718 "regular structure (e.g. each .{c,h} pair will create new section). If one "
3719 "organize a project close to that updating a manually maintained section file "
3720 "can be as simple as running <code>meld &lt;package&gt;-decl-list.txt "
3721 "&lt;package&gt;-sections.txt</code>."
3722 msgstr ""
3723 "Бұл нұсқа <filename>Makefile.am</filename> ішіндегі <option>SCAN_OPTIONS=--"
3724 "rebuild-sections</option> параметрін қолдайды. Бұл іске қосылғанда, "
3725 "<filename>&lt;package&gt;-sections.txt</filename> автоматты түрде жасалады "
3726 "және оны нұсқаларды бақылау жүйесінен алып тастауға болады. Бұл тек өте "
3727 "тұрақты құрылымы бар жобалар үшін жақсы жұмыс істейді (мысалы, әрбір .{c,h} "
3728 "жұбы жаңа бөлім жасайды). Егер сіз жобаны соған жақын ұйымдастырсаңыз, қолмен "
3729 "сақталатын бөлім файлын жаңарту <code>meld &lt;package&gt;-decl-list.txt "
3730 "&lt;package&gt;-sections.txt</code> іске қосу сияқты оңай болуы мүмкін."
3731
3732 #. (itstool) path: sect1/para
3733 #: C/index.docbook:2331
3734 msgid ""
3735 "Version 1.8 already introduced the syntax for documenting sections in the "
3736 "sources instead of the separate files under <filename "
3737 "class=\"directory\">tmpl</filename>. This version adds options to switch the "
3738 "whole doc module to not use the extra tmpl build step at all, by using "
3739 "<option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If "
3740 "you don't have a <filename class=\"directory\">tmpl</filename> checked into "
3741 "your source control system and haven't yet switched, just add the flag to "
3742 "<filename>configure.ac</filename> and you are done."
3743 msgstr ""
3744 "1.8 нұсқасы <filename class=\"directory\">tmpl</filename> ішіндегі жеке "
3745 "файлдардың орнына бастапқы кодтардағы бөлімдерді құжаттау синтаксисін енгізді. "
3746 "Бұл нұсқа <filename>configure.ac</filename> ішінде <option>--flavour no-tmpl</"
3747 "option> пайдалану арқылы бүкіл құжат модулін қосымша tmpl құрастыру қадамын "
3748 "мүлдем пайдаланбауға ауыстыру опцияларын қосады. Егер сізде нұсқаларды бақылау "
3749 "жүйесіне енгізілген <filename class=\"directory\">tmpl</filename> болмаса және "
3750 "әлі ауыспаған болсаңыз, жай ғана <filename>configure.ac</filename> файлына "
3751 "жалаушаны қосыңыз, болды."
3752
3753 #. (itstool) path: sect1/title
3754 #: C/index.docbook:2343
3755 msgid "GTK-Doc 1.10"
3756 msgstr "GTK-Doc 1.10"
3757
3758 #. (itstool) path: sect1/para
3759 #: C/index.docbook:2345
3760 msgid ""
3761 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
3762 "<filename>Makefile.am</filename>. When this is enabled, the "
3763 "<filename>&lt;package&gt;.types</filename> is autogenerated and can be removed "
3764 "from the vcs. When using this feature it is important to also setup the "
3765 "<varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for code "
3766 "that is build conditionally."
3767 msgstr ""
3768 "Бұл нұсқа <filename>Makefile.am</filename> ішіндегі <option>SCAN_OPTIONS=--"
3769 "rebuild-types</option> параметрін қолдайды. Бұл іске қосылғанда, "
3770 "<filename>&lt;package&gt;.types</filename> автоматты түрде жасалады және оны "
3771 "нұсқаларды бақылау жүйесінен алып тастауға болады. Бұл мүмкіндікті пайдаланған "
3772 "кезде шартты түрде құрастырылатын код үшін <filename>Makefile.am</filename> "
3773 "ішінде <varname>IGNORE_HFILES</varname> параметрін де орнату маңызды."
3774
3775 #. (itstool) path: sect1/title
3776 #: C/index.docbook:2356
3777 msgid "GTK-Doc 1.16"
3778 msgstr "GTK-Doc 1.16"
3779
3780 #. (itstool) path: example/title
3781 #: C/index.docbook:2362
3782 msgid "Enable gtkdoc-check"
3783 msgstr "gtkdoc-check іске қосу"
3784
3785 #. (itstool) path: example/programlisting
3786 #: C/index.docbook:2363
3787 #, no-wrap
3788 msgid ""
3789 "\n"
3790 "if ENABLE_GTK_DOC\n"
3791 "TESTS_ENVIRONMENT = \\\n"
3792 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3793 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3794 "TESTS = $(GTKDOC_CHECK)\n"
3795 "endif\n"
3796 msgstr ""
3797 "\n"
3798 "if ENABLE_GTK_DOC\n"
3799 "TESTS_ENVIRONMENT = \\\n"
3800 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3801 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3802 "TESTS = $(GTKDOC_CHECK)\n"
3803 "endif\n"
3804
3805 #. (itstool) path: sect1/para
3806 #: C/index.docbook:2358
3807 msgid ""
3808 "This version includes a new tool called gtkdoc-check. This tool can run a set "
3809 "of sanity checks on your documentation. It is enabled by adding these lines to "
3810 "the end of <filename>Makefile.am</filename>. <_:example-1/>"
3811 msgstr ""
3812 "Бұл нұсқа gtkdoc-check деп аталатын жаңа сайманды қамтиды. Бұл сайман "
3813 "құжаттамаңызда бірқатар дұрыстық тексерулерін орындай алады. Ол "
3814 "<filename>Makefile.am</filename> файлының соңына мына жолдарды қосу арқылы "
3815 "іске қосылады. <_:example-1/>"
3816
3817 #. (itstool) path: sect1/title
3818 #: C/index.docbook:2376
3819 msgid "GTK-Doc 1.20"
3820 msgstr "GTK-Doc 1.20"
3821
3822 #. (itstool) path: sect1/para
3823 #: C/index.docbook:2378
3824 msgid ""
3825 "Version 1.18 brought some initial markdown support. Using markdown in doc "
3826 "comments is less intrusive than writing docbook xml. This version improves a "
3827 "lot on this and add a lot more styles. The section that explains the <link "
3828 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
3829 msgstr ""
3830 "1.18 нұсқасы кейбір бастапқы markdown қолдауын әкелді. Құжат түсіндірмелерінде "
3831 "markdown пайдалану docbook xml жазуға қарағанда ыңғайлырақ. Бұл нұсқа оны "
3832 "айтарлықтай жақсартады және көптеген стильдерді қосады. <link "
3833 "linkend=\"documenting_syntax\">Түсіндірме синтаксисін</link> түсіндіретін "
3834 "бөлімде барлық мәліметтер бар."
3835
3836 #. (itstool) path: sect1/title
3837 #: C/index.docbook:2388
3838 msgid "GTK-Doc 1.25"
3839 msgstr "GTK-Doc 1.25"
3840
3841 #. (itstool) path: example/title
3842 #: C/index.docbook:2399
3843 msgid "Use pre-generated entities"
3844 msgstr "Алдын ала жасалған нысандарды (entities) пайдалану"
3845
3846 #. (itstool) path: example/programlisting
3847 #: C/index.docbook:2400
3848 #, no-wrap
3849 msgid ""
3850 "\n"
3851 "&lt;?xml version=\"1.0\"?&gt;\n"
3852 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3853 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3854 "[\n"
3855 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3856 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3857 " %gtkdocentities;\n"
3858 "]&gt;\n"
3859 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3860 " &lt;bookinfo&gt;\n"
3861 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3862 " &lt;releaseinfo&gt;\n"
3863 " for &amp;package_string;.\n"
3864 " The latest version of this documentation can be found on-line at\n"
3865 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3866 " &lt;/releaseinfo&gt;\n"
3867 " &lt;/bookinfo&gt;\n"
3868 msgstr ""
3869 "\n"
3870 "&lt;?xml version=\"1.0\"?&gt;\n"
3871 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3872 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3873 "[\n"
3874 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3875 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3876 " %gtkdocentities;\n"
3877 "]&gt;\n"
3878 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3879 " &lt;bookinfo&gt;\n"
3880 " &lt;title&gt;&amp;package_name; анықтамалық нұсқаулығы&lt;/title&gt;\n"
3881 " &lt;releaseinfo&gt;\n"
3882 " &amp;package_string; үшін.\n"
3883 " Бұл құжаттаманың соңғы нұсқасын желіде мына жерден табуға болады:\n"
3884 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3885 " &lt;/releaseinfo&gt;\n"
3886 " &lt;/bookinfo&gt;\n"
3887
3888 #. (itstool) path: sect1/para
3889 #: C/index.docbook:2390
3890 msgid ""
3891 "The makefiles shipped with this version generate an entity file at "
3892 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
3893 "package_name and package_version. You can use this e.g. in the main xml file "
3894 "to avoid hardcoding the version number. Below is an example that shows how the "
3895 "entity file is included in the master template and how the entities are used. "
3896 "The entities can also be used in all generated files, GTK-Doc will use the "
3897 "same xml header in generated xml files. <_:example-1/>"
3898 msgstr ""
3899 "Осы нұсқамен бірге келетін makefile файлдары <filename>xml/gtkdocentities.ent</"
3900 "filename> мекенжайында нысан (entity) файлын жасайды, онда мысалы, "
3901 "package_name және package_version нысандары болады. Нұсқа нөмірін қолмен "
3902 "жазбау үшін оны негізгі xml файлында пайдалануға болады. Төменде нысан "
3903 "файлының негізгі үлгіге қалай қосылатыны және нысандардың қалай қолданылатыны "
3904 "көрсетілген мысал берілген. Нысандарды барлық жасалған файлдарда да "
3905 "пайдалануға болады, GTK-Doc жасалған xml файлдарында бірдей xml тақырыптамасын "
3906 "пайдаланады. <_:example-1/>"
3907
3908 #. (itstool) path: chapter/title
3909 #: C/index.docbook:2425
3910 msgid "Documenting other interfaces"
3911 msgstr "Басқа интерфейстерді құжаттау"
3912
3913 #. (itstool) path: chapter/para
3914 #: C/index.docbook:2427
3915 msgid ""
3916 "So far we have been using GTK-Doc to document the API of code. The next "
3917 "sections contain suggestions how the tools can be used to document other "
3918 "interfaces too."
3919 msgstr ""
3920 "Осы уақытқа дейін біз GTK-Doc-ты кодтың API-ын құжаттау үшін пайдаланып "
3921 "келдік. Келесі бөлімдерде саймандарды басқа интерфейстерді құжаттау үшін қалай "
3922 "пайдалануға болатыны туралы ұсыныстар берілген."
3923
3924 #. (itstool) path: sect1/title
3925 #: C/index.docbook:2434
3926 msgid "Command line options and man pages"
3927 msgstr "Командалық жол опциялары және man беттері"
3928
3929 #. (itstool) path: sect1/para
3930 #: C/index.docbook:2436
3931 msgid ""
3932 "As one can generate man pages for a docbook refentry as well, it sounds like a "
3933 "good idea to use it for that purpose. This way the interface is part of the "
3934 "reference and one gets the man-page for free."
3935 msgstr ""
3936 "Docbook refentry үшін де man беттерін жасауға болатындықтан, оны осы мақсатта "
3937 "пайдалану жақсы идея болып көрінеді. Осылайша интерфейс анықтамалықтың бір "
3938 "бөлігі болады және сіз man-бетті тегін аласыз."
3939
3940 #. (itstool) path: sect2/title
3941 #: C/index.docbook:2443
3942 msgid "Document the tool"
3943 msgstr "Сайманды құжаттау"
3944
3945 #. (itstool) path: sect2/para
3946 #: C/index.docbook:2445
3947 msgid ""
3948 "Create one refentry file per tool. Following <link "
3949 "linkend=\"settingup_docfiles\">our example</link> we would call it "
3950 "<filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags "
3951 "that should be used and can look at generated file in the xml subdirectory as "
3952 "well as examples e.g. in glib."
3953 msgstr ""
3954 "Әр сайман үшін бір refentry файлын жасаңыз. <link "
3955 "linkend=\"settingup_docfiles\">Біздің мысалымызға</link> сүйене отырып, біз "
3956 "оны <filename>meep/docs/reference/meeper/meep.xml</filename> деп атар едік. "
3957 "Қолданылуы тиіс xml тегтері үшін xml ішкі бумасындағы жасалған файлды, сондай-"
3958 "ақ glib ішіндегі мысалдарды қарауға болады."
3959
3960 #. (itstool) path: sect2/title
3961 #: C/index.docbook:2455
3962 msgid "Adding the extra configure check"
3963 msgstr "Қосымша configure тексеруін қосу"
3964
3965 #. (itstool) path: example/title
3966 #: C/index.docbook:2458 C/index.docbook:2476
3967 msgid "Extra configure checks"
3968 msgstr "Қосымша configure тексерулері"
3969
3970 #. (itstool) path: example/programlisting
3971 #: C/index.docbook:2459
3972 #, no-wrap
3973 msgid ""
3974 "\n"
3975 "AC_ARG_ENABLE(man,\n"
3976 " [AC_HELP_STRING([--enable-man],\n"
3977 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
3978 " enable_man=no)\n"
3979 "\n"
3980 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
3981 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
3982 msgstr ""
3983 "\n"
3984 "AC_ARG_ENABLE(man,\n"
3985 " [AC_HELP_STRING([--enable-man],\n"
3986 " [man беттерін Docbook-тан қайта жасау [әдепкі=жоқ]])],enable_man=yes,\n"
3987 " enable_man=no)\n"
3988 "\n"
3989 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
3990 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
3991
3992 #. (itstool) path: sect2/title
3993 #: C/index.docbook:2473
3994 msgid "Adding the extra makefile rules"
3995 msgstr "Қосымша makefile ережелерін қосу"
3996
3997 #. (itstool) path: example/programlisting
3998 #: C/index.docbook:2477
3999 #, no-wrap
4000 msgid ""
4001 "\n"
4002 "man_MANS = \\\n"
4003 " meeper.1\n"
4004 "\n"
4005 "if ENABLE_GTK_DOC\n"
4006 "if ENABLE_MAN\n"
4007 "\n"
4008 "%.1 : %.xml\n"
4009 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4010 "\n"
4011 "endif\n"
4012 "endif\n"
4013 "\n"
4014 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4015 "EXTRA_DIST += meep.xml\n"
4016 msgstr ""
4017 "\n"
4018 "man_MANS = \\\n"
4019 " meeper.1\n"
4020 "\n"
4021 "if ENABLE_GTK_DOC\n"
4022 "if ENABLE_MAN\n"
4023 "\n"
4024 "%.1 : %.xml\n"
4025 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4026 "\n"
4027 "endif\n"
4028 "endif\n"
4029 "\n"
4030 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4031 "EXTRA_DIST += meep.xml\n"
4032
4033 #. (itstool) path: sect1/title
4034 #: C/index.docbook:2499
4035 msgid "DBus interfaces"
4036 msgstr "DBus интерфейстері"
4037
4038 #. (itstool) path: sect1/para
4039 #: C/index.docbook:2501
4040 msgid ""
4041 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4042 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4043 msgstr ""
4044 "(ТҮЗЕТУ КЕРЕК: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, "
4045 "http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4046
4047 #. (itstool) path: chapter/title
4048 #: C/index.docbook:2510
4049 msgid "Frequently asked questions"
4050 msgstr "Жиі қойылатын сұрақтар"
4051
4052 #. (itstool) path: segmentedlist/segtitle
4053 #: C/index.docbook:2514
4054 msgid "Question"
4055 msgstr "Сұрақ"
4056
4057 #. (itstool) path: segmentedlist/segtitle
4058 #: C/index.docbook:2515
4059 msgid "Answer"
4060 msgstr "Жауап"
4061
4062 #. (itstool) path: seglistitem/seg
4063 #: C/index.docbook:2517
4064 msgid "No class hierarchy."
4065 msgstr "Класс иерархиясы жоқ."
4066
4067 #. (itstool) path: seglistitem/seg
4068 #: C/index.docbook:2518
4069 msgid ""
4070 "The objects <function>xxx_get_type()</function> function has not been entered "
4071 "into the <filename>&lt;package&gt;.types</filename> file."
4072 msgstr ""
4073 "Объектілердің <function>xxx_get_type()</function> функциясы "
4074 "<filename>&lt;package&gt;.types</filename> файлына енгізілмеген."
4075
4076 #. (itstool) path: seglistitem/seg
4077 #: C/index.docbook:2524
4078 msgid "Still no class hierarchy."
4079 msgstr "Әлі де класс иерархиясы жоқ."
4080
4081 #. (itstool) path: seglistitem/seg
4082 #: C/index.docbook:2525
4083 msgid ""
4084 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4085 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4086 "October/msg00006.html\">explanation</ulink>)."
4087 msgstr ""
4088 "<filename>&lt;package&gt;-sections.txt</filename> файлында атау жетіспейді "
4089 "немесе қате берілген (<ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/"
4090 "2003-October/msg00006.html\">түсіндірмесін</ulink> қараңыз)."
4091
4092 #. (itstool) path: seglistitem/seg
4093 #: C/index.docbook:2531
4094 msgid "Damn, I have still no class hierarchy."
4095 msgstr "Қап, менде әлі де класс иерархиясы жоқ."
4096
4097 #. (itstool) path: seglistitem/seg
4098 #: C/index.docbook:2532
4099 msgid ""
4100 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</type>) "
4101 "part of the normal section (don't put this into Standard or Private "
4102 "subsections)."
4103 msgstr ""
4104 "Объект аты (мысалы, <type>GtkWidget</type> дана құрылымының аты) қалыпты "
4105 "бөлімнің бөлігі болып табыла ма (оны Standard немесе Private ішкі бөлімдеріне "
4106 "қоймаңыз)."
4107
4108 #. (itstool) path: seglistitem/seg
4109 #: C/index.docbook:2539
4110 msgid "No symbol index."
4111 msgstr "Таңбалар индексі жоқ."
4112
4113 #. (itstool) path: seglistitem/seg
4114 #: C/index.docbook:2540
4115 msgid ""
4116 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a index "
4117 "that xi:includes the generated index?"
4118 msgstr ""
4119 "<filename>&lt;package&gt;-docs.{xml,sgml}</filename> файлында жасалған "
4120 "индексті xi:include арқылы қосатын индекс бар ма?"
4121
4122 #. (itstool) path: seglistitem/seg
4123 #: C/index.docbook:2546
4124 msgid "Symbols are not linked to their doc-section."
4125 msgstr "Таңбалар өздерінің құжаттама бөліміне сілтемеленбеген."
4126
4127 #. (itstool) path: seglistitem/seg
4128 #: C/index.docbook:2547
4129 msgid ""
4130 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4131 "gtkdoc-fixxref warns about unresolvable xrefs."
4132 msgstr ""
4133 "Құжат түсіндірмесінде дұрыс белгілер (#, % немесе ()) қолданылған ба? gtkdoc-"
4134 "fixxref шешілмейтін xref-тер туралы ескертетінін тексеріңіз."
4135
4136 #. (itstool) path: seglistitem/seg
4137 #: C/index.docbook:2553
4138 msgid "A new class does not appear in the docs."
4139 msgstr "Жаңа класс құжаттарда көрінбейді."
4140
4141 #. (itstool) path: seglistitem/seg
4142 #: C/index.docbook:2554
4143 msgid ""
4144 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4145 "filename>."
4146 msgstr ""
4147 "Жаңа бет <filename>&lt;package&gt;-docs.{xml,sgml}</filename> ішінен "
4148 "xi:include арқылы қосылған ба."
4149
4150 #. (itstool) path: seglistitem/seg
4151 #: C/index.docbook:2560
4152 msgid "A new symbol does not appear in the docs."
4153 msgstr "Жаңа таңба құжаттарда көрінбейді."
4154
4155 #. (itstool) path: seglistitem/seg
4156 #: C/index.docbook:2561
4157 msgid ""
4158 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4159 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4160 "xrefs. Check if the symbol is correctly listed in the "
4161 "<filename>&lt;package&gt;-sections.txt</filename> in a public subsection."
4162 msgstr ""
4163 "Құжат түсіндірмесі дұрыс пішімделген бе? Түсіндірменің басындағы емле "
4164 "қателерін тексеріңіз. gtkdoc-fixxref шешілмейтін xref-тер туралы ескертетінін "
4165 "тексеріңіз. Таңба <filename>&lt;package&gt;-sections.txt</filename> файлындағы "
4166 "ашық ішкі бөлімде дұрыс тізімделгенін тексеріңіз."
4167
4168 #. (itstool) path: seglistitem/seg
4169 #: C/index.docbook:2569
4170 msgid "A type is missing from the class hierarchy."
4171 msgstr "Класс иерархиясында түр (type) жетіспейді."
4172
4173 #. (itstool) path: seglistitem/seg
4174 #: C/index.docbook:2570
4175 msgid ""
4176 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4177 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4178 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4179 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed or "
4180 "incidentally marked private it will not be shown."
4181 msgstr ""
4182 "Егер түр <filename>&lt;package&gt;.hierarchy</filename> ішінде тізімделген, "
4183 "бірақ <filename>xml/tree_index.sgml</filename> ішінде болмаса, түрдің "
4184 "<filename>&lt;package&gt;-sections.txt</filename> файлында дұрыс "
4185 "орналастырылғанын қайта тексеріңіз. Егер түр данасы (мысалы, <type>GtkWidget</"
4186 "type>) тізімделмесе немесе байқаусызда жеке ретінде белгіленсе, ол "
4187 "көрсетілмейді."
4188
4189 #. (itstool) path: seglistitem/seg
4190 #: C/index.docbook:2579
4191 msgid "I get foldoc links for all gobject annotations."
4192 msgstr "Мен барлық gobject аннотациялары үшін foldoc сілтемелерін аламын."
4193
4194 #. (itstool) path: seglistitem/seg
4195 #: C/index.docbook:2580
4196 msgid ""
4197 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4198 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4199 msgstr ""
4200 "<filename>xml/annotation-glossary.xml</filename> файлы "
4201 "<filename>&lt;package&gt;-docs.{xml,sgml}</filename> ішінен xi:include арқылы "
4202 "қосылғанын тексеріңіз."
4203
4204 #. (itstool) path: seglistitem/seg
4205 #: C/index.docbook:2588
4206 msgid "Parameter described in source code comment block but does not exist"
4207 msgstr "Параметр бастапқы кодтың түсіндірме блогында сипатталған, бірақ ол жоқ"
4208
4209 #. (itstool) path: seglistitem/seg
4210 #: C/index.docbook:2589
4211 msgid ""
4212 "Check if the prototype in the header has different parameter names as in the "
4213 "source."
4214 msgstr ""
4215 "Тақырыптағы прототипте бастапқы кодтағыдан басқа параметр атауларының бар-"
4216 "жоғын тексеріңіз."
4217
4218 #. (itstool) path: seglistitem/seg
4219 #: C/index.docbook:2594
4220 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4221 msgstr "шектеулі linkend үшін бірнеше \"ID\" бар: XYZ"
4222
4223 #. (itstool) path: seglistitem/seg
4224 #: C/index.docbook:2595
4225 msgid ""
4226 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</filename> "
4227 "file."
4228 msgstr ""
4229 "XYZ таңбасы <filename>&lt;package&gt;-sections.txt</filename> файлында екі рет "
4230 "кездеседі."
4231
4232 #. (itstool) path: seglistitem/seg
4233 #: C/index.docbook:2598
4234 msgid ""
4235 "Element typename in namespace '' encountered in para, but no template matches."
4236 msgstr ""
4237 "para ішінде '' атаулар кеңістігіндегі typename элементі кездесті, бірақ ешбір "
4238 "үлгі сәйкес келмеді."
4239
4240 #. (itstool) path: chapter/title
4241 #: C/index.docbook:2605
4242 msgid "Tools related to gtk-doc"
4243 msgstr "gtk-doc-қа қатысты саймандар"
4244
4245 #. (itstool) path: chapter/para
4246 #: C/index.docbook:2607
4247 msgid ""
4248 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4249 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4250 "integrates with the trac search."
4251 msgstr ""
4252 "GtkDocPlugin — trac сайтына API құжаттарын қосатын және trac іздеуімен "
4253 "біріктіретін <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac GTK-"
4254 "Doc</ulink> біріктіру плагині."
4255
4256 #. (itstool) path: chapter/para
4257 #: C/index.docbook:2612
4258 msgid ""
4259 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since tags "
4260 "in the API to determine the minimum required version."
4261 msgstr ""
4262 "Gtkdoc-depscan — ең төменгі қажетті нұсқаны анықтау үшін пайдаланылған API-ды "
4263 "API-дағы since тегтеріне қарсы тексеретін сайман (gtk-doc бөлігі)."
4264
4265 #. (itstool) path: appendixinfo/releaseinfo
4266 #: C/fdl-appendix.xml:12
4267 msgid "Version 1.1, March 2000"
4268 msgstr "1.1 нұсқасы, наурыз 2000"
4269
4270 #. (itstool) path: copyright/year
4271 #: C/fdl-appendix.xml:16
4272 msgid "2000"
4273 msgstr "2000"
4274
4275 #. (itstool) path: copyright/holder
4276 #: C/fdl-appendix.xml:16
4277 msgid "Free Software Foundation, Inc."
4278 msgstr "Free Software Foundation, Inc."
4279
4280 #. (itstool) path: address/street
4281 #: C/fdl-appendix.xml:20
4282 msgid "51 Franklin Street, Suite 330"
4283 msgstr "51 Franklin Street, Suite 330"
4284
4285 #. (itstool) path: address/city
4286 #: C/fdl-appendix.xml:21
4287 msgid "Boston"
4288 msgstr "Бостон"
4289
4290 #. (itstool) path: address/state
4291 #: C/fdl-appendix.xml:21
4292 msgid "MA"
4293 msgstr "MA"
4294
4295 #. (itstool) path: address/postcode
4296 #: C/fdl-appendix.xml:22
4297 msgid "02110-1301"
4298 msgstr "02110-1301"
4299
4300 #. (itstool) path: address/country
4301 #: C/fdl-appendix.xml:22
4302 msgid "USA"
4303 msgstr "АҚШ"
4304
4305 #. (itstool) path: para/address
4306 #: C/fdl-appendix.xml:20
4307 msgid ""
4308 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4309 "<_:postcode-4/> <_:country-5/>"
4310 msgstr ""
4311 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4312 "<_:postcode-4/> <_:country-5/>"
4313
4314 #. (itstool) path: legalnotice/para
4315 #: C/fdl-appendix.xml:19
4316 msgid ""
4317 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies of "
4318 "this license document, but changing it is not allowed."
4319 msgstr ""
4320 "<_:address-1/> Осы лицензиялық құжаттың сөзбе-сөз көшірмелерін көшіруге және "
4321 "таратуға барлығына рұқсат етіледі, бірақ оны өзгертуге жол берілмейді."
4322
4323 #. (itstool) path: appendix/title
4324 #. (itstool) path: para/quote
4325 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4326 msgid "GNU Free Documentation License"
4327 msgstr "GNU еркін құжаттама лицензиясы"
4328
4329 #. (itstool) path: sect1/title
4330 #: C/fdl-appendix.xml:31
4331 msgid "0. PREAMBLE"
4332 msgstr "0. КІРІСПЕ"
4333
4334 #. (itstool) path: para/quote
4335 #: C/fdl-appendix.xml:34
4336 msgid "free"
4337 msgstr "еркін"
4338
4339 #. (itstool) path: sect1/para
4340 #: C/fdl-appendix.xml:32
4341 msgid ""
4342 "The purpose of this License is to make a manual, textbook, or other written "
4343 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
4344 "effective freedom to copy and redistribute it, with or without modifying it, "
4345 "either commercially or noncommercially. Secondarily, this License preserves "
4346 "for the author and publisher a way to get credit for their work, while not "
4347 "being considered responsible for modifications made by others."
4348 msgstr ""
4349 "Осы Лицензияның мақсаты — нұсқаулықты, оқулықты немесе басқа жазбаша құжатты "
4350 "бостандық мағынасында <_:quote-1/> ету: барлығына оны коммерциялық немесе "
4351 "коммерциялық емес түрде өзгерту арқылы немесе өзгертпей, көшіру мен қайта "
4352 "таратудың тиімді еркіндігін қамтамасыз ету. Екіншіден, бұл Лицензия автор мен "
4353 "баспагер үшін басқалар жасаған өзгерістерге жауапты деп саналмай-ақ, өз "
4354 "жұмыстары үшін құрмет алу жолын сақтайды."
4355
4356 #. (itstool) path: para/quote
4357 #: C/fdl-appendix.xml:44
4358 msgid "copyleft"
4359 msgstr "копилефт"
4360
4361 #. (itstool) path: sect1/para
4362 #: C/fdl-appendix.xml:43
4363 msgid ""
4364 "This License is a kind of <_:quote-1/>, which means that derivative works of "
4365 "the document must themselves be free in the same sense. It complements the GNU "
4366 "General Public License, which is a copyleft license designed for free software."
4367 msgstr ""
4368 "Бұл Лицензия <_:quote-1/> түрі болып табылады, бұл құжаттың туынды "
4369 "жұмыстарының өздері де дәл осындай мағынада еркін болуы керек дегенді "
4370 "білдіреді. Ол еркін бағдарламалық қамтама үшін жасалған копилефт лицензиясы "
4371 "болып табылатын GNU General Public License лицензиясын толықтырады."
4372
4373 #. (itstool) path: sect1/para
4374 #: C/fdl-appendix.xml:50
4375 msgid ""
4376 "We have designed this License in order to use it for manuals for free "
4377 "software, because free software needs free documentation: a free program "
4378 "should come with manuals providing the same freedoms that the software does. "
4379 "But this License is not limited to software manuals; it can be used for any "
4380 "textual work, regardless of subject matter or whether it is published as a "
4381 "printed book. We recommend this License principally for works whose purpose is "
4382 "instruction or reference."
4383 msgstr ""
4384 "Біз бұл Лицензияны еркін бағдарламалық қамтамаға арналған нұсқаулықтар үшін "
4385 "пайдалану мақсатында әзірледік, өйткені еркін бағдарламалық қамтамаға еркін "
4386 "құжаттама қажет: еркін бағдарлама бағдарламалық қамтама беретін бостандықтарды "
4387 "қамтамасыз ететін нұсқаулықтармен бірге келуі керек. Бірақ бұл Лицензия тек "
4388 "бағдарламалық қамтама нұсқаулықтарымен шектелмейді; оны мазмұнына немесе баспа "
4389 "кітап ретінде жарияланғанына қарамастан кез келген мәтіндік жұмыс үшін "
4390 "пайдалануға болады. Біз бұл Лицензияны негізінен мақсаты нұсқаулық немесе "
4391 "анықтамалық болып табылатын жұмыстар үшін ұсынамыз."
4392
4393 #. (itstool) path: sect1/title
4394 #: C/fdl-appendix.xml:62
4395 msgid "1. APPLICABILITY AND DEFINITIONS"
4396 msgstr "1. ҚОЛДАНЫЛУЫ ЖӘНЕ АНЫҚТАМАЛАР"
4397
4398 #. (itstool) path: para/quote
4399 #. (itstool) path: para/link
4400 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
4401 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
4402 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
4403 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
4404 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
4405 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
4406 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
4407 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
4408 #: C/fdl-appendix.xml:608
4409 msgid "Document"
4410 msgstr "Құжат"
4411
4412 #. (itstool) path: para/quote
4413 #: C/fdl-appendix.xml:69
4414 msgid "you"
4415 msgstr "сіз"
4416
4417 #. (itstool) path: sect1/para
4418 #: C/fdl-appendix.xml:63
4419 msgid ""
4420 "This License applies to any manual or other work that contains a notice placed "
4421 "by the copyright holder saying it can be distributed under the terms of this "
4422 "License. The <_:quote-1/>, below, refers to any such manual or work. Any "
4423 "member of the public is a licensee, and is addressed as <_:quote-2/>."
4424 msgstr ""
4425 "Бұл Лицензия авторлық құқық иесі осы Лицензияның шарттары бойынша таратылуы "
4426 "мүмкін екендігі туралы ескертуді орналастырған кез келген нұсқаулыққа немесе "
4427 "басқа жұмысқа қолданылады. Төмендегі <_:quote-1/> осындай кез келген "
4428 "нұсқаулыққа немесе жұмысқа қатысты. Кез келген адам лицензиат болып табылады "
4429 "және ол <_:quote-2/> ретінде аталады."
4430
4431 #. (itstool) path: para/quote
4432 #. (itstool) path: para/link
4433 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
4434 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
4435 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
4436 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
4437 msgid "Modified Version"
4438 msgstr "Өзгертілген нұсқа"
4439
4440 #. (itstool) path: sect1/para
4441 #: C/fdl-appendix.xml:72
4442 msgid ""
4443 "A <_:quote-1/> of the Document means any work containing the Document or a "
4444 "portion of it, either copied verbatim, or with modifications and/or translated "
4445 "into another language."
4446 msgstr ""
4447 "Құжаттың <_:quote-1/> — сөзбе-сөз көшірілген немесе өзгертулермен және/немесе "
4448 "басқа тілге аударылған, Құжатты немесе оның бір бөлігін қамтитын кез келген "
4449 "жұмысты білдіреді."
4450
4451 #. (itstool) path: para/quote
4452 #: C/fdl-appendix.xml:80
4453 msgid "Secondary Section"
4454 msgstr "Қосалқы бөлім"
4455
4456 #. (itstool) path: sect1/para
4457 #: C/fdl-appendix.xml:79
4458 msgid ""
4459 "A <_:quote-1/> is a named appendix or a front-matter section of the <_:link-2/"
4460 "> that deals exclusively with the relationship of the publishers or authors of "
4461 "the Document to the Document's overall subject (or to related matters) and "
4462 "contains nothing that could fall directly within that overall subject. (For "
4463 "example, if the Document is in part a textbook of mathematics, a Secondary "
4464 "Section may not explain any mathematics.) The relationship could be a matter "
4465 "of historical connection with the subject or with related matters, or of "
4466 "legal, commercial, philosophical, ethical or political position regarding them."
4467 msgstr ""
4468 "<_:quote-1/> — тек қана <_:link-2/> баспагерлерінің немесе авторларының "
4469 "Құжаттың жалпы тақырыбына (немесе қатысты мәселелерге) қатынасына қатысты және "
4470 "сол жалпы тақырыпқа тікелей кіретін ештеңесі жоқ, Құжаттың аталған қосымшасы "
4471 "немесе алғы сөз бөлімі. (Мысалы, егер Құжат ішінара математика оқулығы болса, "
4472 "Қосалқы бөлім математиканы түсіндірмеуі мүмкін.) Бұл қатынас тақырыппен немесе "
4473 "қатысты мәселелермен тарихи байланыс немесе оларға қатысты құқықтық, "
4474 "коммерциялық, философиялық, этикалық немесе саяси ұстаным болуы мүмкін."
4475
4476 #. (itstool) path: para/quote
4477 #. (itstool) path: para/link
4478 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
4479 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
4480 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
4481 msgid "Invariant Sections"
4482 msgstr "Тұрақты бөлімдер"
4483
4484 #. (itstool) path: para/link
4485 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
4486 msgid "Secondary Sections"
4487 msgstr "Қосалқы бөлімдер"
4488
4489 #. (itstool) path: sect1/para
4490 #: C/fdl-appendix.xml:94
4491 msgid ""
4492 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as being "
4493 "those of Invariant Sections, in the notice that says that the <_:link-3/> is "
4494 "released under this License."
4495 msgstr ""
4496 "<_:quote-1/> — <_:link-3/> осы Лицензия бойынша шығарылғаны туралы ескертуде "
4497 "тақырыптары Тұрақты бөлімдер ретінде белгіленген белгілі бір <_:link-2/>."
4498
4499 #. (itstool) path: para/quote
4500 #. (itstool) path: para/link
4501 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
4502 #: C/fdl-appendix.xml:458
4503 msgid "Cover Texts"
4504 msgstr "Мұқаба мәтіндері"
4505
4506 #. (itstool) path: sect1/para
4507 #: C/fdl-appendix.xml:103
4508 msgid ""
4509 "The <_:quote-1/> are certain short passages of text that are listed, as Front-"
4510 "Cover Texts or Back-Cover Texts, in the notice that says that the <_:link-2/> "
4511 "is released under this License."
4512 msgstr ""
4513 "<_:quote-1/> — <_:link-2/> осы Лицензия бойынша шығарылғаны туралы ескертуде "
4514 "Алдыңғы мұқаба мәтіндері немесе Артқы мұқаба мәтіндері ретінде тізімделген "
4515 "мәтіннің белгілі бір қысқа үзінділері."
4516
4517 #. (itstool) path: para/quote
4518 #. (itstool) path: para/link
4519 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
4520 #: C/fdl-appendix.xml:369
4521 msgid "Transparent"
4522 msgstr "Тұнық"
4523
4524 #. (itstool) path: para/quote
4525 #. (itstool) path: para/link
4526 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
4527 msgid "Opaque"
4528 msgstr "Күңгірт"
4529
4530 #. (itstool) path: sect1/para
4531 #: C/fdl-appendix.xml:111
4532 msgid ""
4533 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
4534 "represented in a format whose specification is available to the general "
4535 "public, whose contents can be viewed and edited directly and straightforwardly "
4536 "with generic text editors or (for images composed of pixels) generic paint "
4537 "programs or (for drawings) some widely available drawing editor, and that is "
4538 "suitable for input to text formatters or for automatic translation to a "
4539 "variety of formats suitable for input to text formatters. A copy made in an "
4540 "otherwise Transparent file format whose markup has been designed to thwart or "
4541 "discourage subsequent modification by readers is not Transparent. A copy that "
4542 "is not <_:quote-3/> is called <_:quote-4/>."
4543 msgstr ""
4544 "<_:link-2/>-тың <_:quote-1/> көшірмесі — сипаттамасы қалың жұртшылыққа "
4545 "қолжетімді пішімде ұсынылған, мазмұны қарапайым мәтіндік редакторлармен немесе "
4546 "(пиксельдерден тұратын суреттер үшін) қарапайым сурет салу бағдарламаларымен "
4547 "немесе (сызбалар үшін) кеңінен қолжетімді кейбір сызба редакторларымен тікелей "
4548 "және оңай көруге және түзетуге болатын, мәтінді пішімдеуіштерге енгізуге "
4549 "немесе мәтінді пішімдеуіштерге енгізуге жарамды әртүрлі пішімдерге автоматты "
4550 "түрде аударуға жарамды машинамен оқылатын көшірме. Белгілеуі оқырмандардың "
4551 "кейінгі өзгертулеріне кедергі келтіру немесе оларды болдырмау үшін жасалған, "
4552 "басқаша Тұнық файл пішімінде жасалған көшірме Тұнық емес. <_:quote-3/> емес "
4553 "көшірме <_:quote-4/> деп аталады."
4554
4555 #. (itstool) path: sect1/para
4556 #: C/fdl-appendix.xml:128
4557 msgid ""
4558 "Examples of suitable formats for Transparent copies include plain ASCII "
4559 "without markup, Texinfo input format, LaTeX input format, SGML or XML using a "
4560 "publicly available DTD, and standard-conforming simple HTML designed for human "
4561 "modification. Opaque formats include PostScript, PDF, proprietary formats that "
4562 "can be read and edited only by proprietary word processors, SGML or XML for "
4563 "which the DTD and/or processing tools are not generally available, and the "
4564 "machine-generated HTML produced by some word processors for output purposes "
4565 "only."
4566 msgstr ""
4567 "Тұнық көшірмелер үшін қолайлы пішімдердің мысалдарына белгілеусіз жай ASCII, "
4568 "Texinfo енгізу пішімі, LaTeX енгізу пішімі, жалпыға қолжетімді DTD "
4569 "пайдаланатын SGML немесе XML және адамның өзгертуіне арналған стандартқа "
4570 "сәйкес келетін қарапайым HTML жатады. Күңгірт пішімдерге PostScript, PDF, тек "
4571 "меншікті мәтіндік процессорлармен оқуға және түзетуге болатын меншікті "
4572 "пішімдер, DTD және/немесе өңдеу саймандары жалпыға бірдей қолжетімді емес SGML "
4573 "немесе XML, сондай-ақ кейбір мәтіндік процессорлар тек шығару мақсатында "
4574 "жасаған машинамен жасалған HTML жатады."
4575
4576 #. (itstool) path: para/quote
4577 #. (itstool) path: para/link
4578 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
4579 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
4580 msgid "Title Page"
4581 msgstr "Титулдық бет"
4582
4583 #. (itstool) path: sect1/para
4584 #: C/fdl-appendix.xml:141
4585 msgid ""
4586 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
4587 "following pages as are needed to hold, legibly, the material this License "
4588 "requires to appear in the title page. For works in formats which do not have "
4589 "any title page as such, <_:quote-2/> means the text near the most prominent "
4590 "appearance of the work's title, preceding the beginning of the body of the "
4591 "text."
4592 msgstr ""
4593 "<_:quote-1/> — баспа кітап үшін титулдық беттің өзі, сонымен қатар осы "
4594 "Лицензия титулдық бетте көрінуін талап ететін материалды анық орналастыру үшін "
4595 "қажетті келесі беттер. Титулдық беті жоқ пішімдегі жұмыстар үшін <_:quote-2/> "
4596 "— мәтін корпусының басына дейінгі жұмыс тақырыбының ең көрнекті көрінісіне "
4597 "жақын мәтінді білдіреді."
4598
4599 #. (itstool) path: sect1/title
4600 #: C/fdl-appendix.xml:153
4601 msgid "2. VERBATIM COPYING"
4602 msgstr "2. СӨЗБЕ-СӨЗ КӨШІРУ"
4603
4604 #. (itstool) path: para/link
4605 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
4606 msgid "section 3"
4607 msgstr "3-бөлім"
4608
4609 #. (itstool) path: sect1/para
4610 #: C/fdl-appendix.xml:154
4611 msgid ""
4612 "You may copy and distribute the <_:link-1/> in any medium, either commercially "
4613 "or noncommercially, provided that this License, the copyright notices, and the "
4614 "license notice saying this License applies to the Document are reproduced in "
4615 "all copies, and that you add no other conditions whatsoever to those of this "
4616 "License. You may not use technical measures to obstruct or control the reading "
4617 "or further copying of the copies you make or distribute. However, you may "
4618 "accept compensation in exchange for copies. If you distribute a large enough "
4619 "number of copies you must also follow the conditions in <_:link-2/>."
4620 msgstr ""
4621 "Осы Лицензия, авторлық құқық туралы ескертулер және осы Лицензия Құжатқа "
4622 "қолданылатыны туралы лицензиялық ескерту барлық көшірмелерде жаңғыртылған және "
4623 "осы Лицензияның шарттарына ешқандай басқа шарттар қосылмаған жағдайда, сіз "
4624 "<_:link-1/>-ты кез келген ортада коммерциялық немесе коммерциялық емес түрде "
4625 "көшіре және тарата аласыз. Сіз жасаған немесе таратқан көшірмелерді оқуды "
4626 "немесе одан әрі көшіруді кедергі келтіру немесе бақылау үшін техникалық "
4627 "шараларды қолдана алмайсыз. Дегенмен, көшірмелер үшін айырбас ретінде өтемақы "
4628 "қабылдауыңызға болады. Егер сіз көшірмелердің жеткілікті үлкен санын "
4629 "таратсаңыз, <_:link-2/>-дағы шарттарды да орындауыңыз керек."
4630
4631 #. (itstool) path: sect1/para
4632 #: C/fdl-appendix.xml:169
4633 msgid ""
4634 "You may also lend copies, under the same conditions stated above, and you may "
4635 "publicly display copies."
4636 msgstr ""
4637 "Сондай-ақ, сіз жоғарыда аталған шарттармен көшірмелерді қарызға бере аласыз "
4638 "және көшірмелерді көпшілікке көрсете аласыз."
4639
4640 #. (itstool) path: sect1/title
4641 #: C/fdl-appendix.xml:176
4642 msgid "3. COPYING IN QUANTITY"
4643 msgstr "3. КӨП МӨЛШЕРДЕ КӨШІРУ"
4644
4645 #. (itstool) path: sect1/para
4646 #: C/fdl-appendix.xml:177
4647 msgid ""
4648 "If you publish printed copies of the <_:link-1/> numbering more than 100, and "
4649 "the Document's license notice requires <_:link-2/>, you must enclose the "
4650 "copies in covers that carry, clearly and legibly, all these Cover Texts: Front-"
4651 "Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both "
4652 "covers must also clearly and legibly identify you as the publisher of these "
4653 "copies. The front cover must present the full title with all words of the "
4654 "title equally prominent and visible. You may add other material on the covers "
4655 "in addition. Copying with changes limited to the covers, as long as they "
4656 "preserve the title of the <_:link-3/> and satisfy these conditions, can be "
4657 "treated as verbatim copying in other respects."
4658 msgstr ""
4659 "Егер сіз <_:link-1/>-тың 100-ден астам басып шығарылған көшірмелерін "
4660 "жарияласаңыз және Құжаттың лицензиялық ескертуі <_:link-2/>-ді талап етсе, "
4661 "көшірмелерді осы Мұқаба мәтіндерінің барлығын анық және оңай оқылатын етіп "
4662 "тасымалдайтын мұқабаларға салуыңыз керек: алдыңғы мұқабада Алдыңғы мұқаба "
4663 "мәтіндері, ал артқы мұқабада Артқы мұқаба мәтіндері. Екі мұқаба да сізді осы "
4664 "көшірмелердің баспагері ретінде анық және оңай оқылатын етіп анықтауы керек. "
4665 "Алдыңғы мұқабада тақырыптың барлық сөздері бірдей көрнекті және көрінетін "
4666 "толық тақырып болуы керек. Мұқабаларға қосымша басқа материалдарды қосуға "
4667 "болады. Мұқабалармен шектелген өзгерістермен көшіру, егер олар <_:link-3/> "
4668 "тақырыбын сақтаса және осы шарттарды қанағаттандырса, басқа жағынан сөзбе-сөз "
4669 "көшіру ретінде қарастырылуы мүмкін."
4670
4671 #. (itstool) path: sect1/para
4672 #: C/fdl-appendix.xml:195
4673 msgid ""
4674 "If the required texts for either cover are too voluminous to fit legibly, you "
4675 "should put the first ones listed (as many as fit reasonably) on the actual "
4676 "cover, and continue the rest onto adjacent pages."
4677 msgstr ""
4678 "Егер кез келген мұқаба үшін талап етілетін мәтіндер оңай оқылатын етіп "
4679 "орналасуы үшін тым көлемді болса, тізімдегі біріншілерін (мүмкіндігінше көп) "
4680 "нақты мұқабаға орналастырып, қалғанын іргелес беттерде жалғастыруыңыз керек."
4681
4682 #. (itstool) path: sect1/para
4683 #: C/fdl-appendix.xml:202
4684 msgid ""
4685 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
4686 "more than 100, you must either include a machine-readable <_:link-3/> copy "
4687 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
4688 "accessible computer-network location containing a complete Transparent copy of "
4689 "the Document, free of added material, which the general network-using public "
4690 "has access to download anonymously at no charge using public-standard network "
4691 "protocols. If you use the latter option, you must take reasonably prudent "
4692 "steps, when you begin distribution of Opaque copies in quantity, to ensure "
4693 "that this Transparent copy will remain thus accessible at the stated location "
4694 "until at least one year after the last time you distribute an Opaque copy "
4695 "(directly or through your agents or retailers) of that edition to the public."
4696 msgstr ""
4697 "Егер сіз <_:link-2/>-тың 100-ден астам <_:link-1/> көшірмелерін жарияласаңыз "
4698 "немесе таратсаңыз, әрбір Күңгірт көшірмемен бірге машинамен оқылатын <_:link-3/"
4699 "> көшірмені қосуыңыз керек немесе әрбір Күңгірт көшірмеде немесе онымен бірге "
4700 "Құжаттың толық Тұнық көшірмесі бар, қосымша материалсыз, жалпы желіні "
4701 "пайдаланатын қалың жұртшылық анонимді түрде және жалпыға ортақ стандартты "
4702 "желілік хаттамаларды пайдаланып ақысыз жүктеп алуға қол жеткізе алатын жалпыға "
4703 "қолжетімді компьютерлік желі орнын көрсетуіңіз керек. Егер сіз соңғы опцияны "
4704 "пайдалансаңыз, Күңгірт көшірмелерді көп мөлшерде тарата бастағанда, бұл Тұнық "
4705 "көшірме көрсетілген орында сіз сол басылымның Күңгірт көшірмесін қалың "
4706 "жұртшылыққа соңғы рет таратқаннан кейін (тікелей немесе сіздің агенттеріңіз "
4707 "немесе ритейлерлеріңіз арқылы) кем дегенде бір жыл өткенге дейін қолжетімді "
4708 "болып қалатынына көз жеткізу үшін орынды сақтық шараларын қолдануыңыз керек."
4709
4710 #. (itstool) path: sect1/para
4711 #: C/fdl-appendix.xml:222
4712 msgid ""
4713 "It is requested, but not required, that you contact the authors of the "
4714 "<_:link-1/> well before redistributing any large number of copies, to give "
4715 "them a chance to provide you with an updated version of the Document."
4716 msgstr ""
4717 "Көшірмелердің көп мөлшерін қайта таратпас бұрын <_:link-1/> авторларына "
4718 "хабарласып, оларға Құжаттың жаңартылған нұсқасын ұсынуға мүмкіндік беруіңіз "
4719 "міндетті емес, бірақ сұралады."
4720
4721 #. (itstool) path: sect1/title
4722 #: C/fdl-appendix.xml:231
4723 msgid "4. MODIFICATIONS"
4724 msgstr "4. ӨЗГЕРТУЛЕР"
4725
4726 #. (itstool) path: para/link
4727 #: C/fdl-appendix.xml:236
4728 msgid "2"
4729 msgstr "2"
4730
4731 #. (itstool) path: para/link
4732 #: C/fdl-appendix.xml:237
4733 msgid "3"
4734 msgstr "3"
4735
4736 #. (itstool) path: sect1/para
4737 #: C/fdl-appendix.xml:232
4738 msgid ""
4739 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
4740 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
4741 "release the Modified Version under precisely this License, with the Modified "
4742 "Version filling the role of the Document, thus licensing distribution and "
4743 "modification of the Modified Version to whoever possesses a copy of it. In "
4744 "addition, you must do these things in the Modified Version:"
4745 msgstr ""
4746 "Сіз <_:link-2/>-тың <_:link-1/> көшірмесін жоғарыдағы <_:link-3/> және "
4747 "<_:link-4/> бөлімдерінің шарттарына сәйкес көшіре және тарата аласыз, егер сіз "
4748 "Өзгертілген нұсқаны дәл осы Лицензия бойынша шығарсаңыз, бұл ретте Өзгертілген "
4749 "нұсқа Құжат рөлін атқарады, осылайша Өзгертілген нұсқаның көшірмесі бар кез "
4750 "келген адамға оны таратуға және өзгертуге лицензия беріледі. Сонымен қатар, "
4751 "сіз Өзгертілген нұсқада мыналарды орындауыңыз керек:"
4752
4753 #. (itstool) path: formalpara/title
4754 #: C/fdl-appendix.xml:248
4755 msgid "A"
4756 msgstr "A"
4757
4758 #. (itstool) path: formalpara/para
4759 #: C/fdl-appendix.xml:249
4760 msgid ""
4761 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from that "
4762 "of the <_:link-2/>, and from those of previous versions (which should, if "
4763 "there were any, be listed in the History section of the Document). You may use "
4764 "the same title as a previous version if the original publisher of that version "
4765 "gives permission."
4766 msgstr ""
4767 "<_:link-1/>-да (және мұқабаларда, егер бар болса) <_:link-2/> тақырыбынан және "
4768 "алдыңғы нұсқалардың тақырыптарынан (олар болған жағдайда, Құжаттың Тарих "
4769 "бөлімінде тізімделуі тиіс) ерекшеленетін тақырыпты пайдаланыңыз. Егер сол "
4770 "нұсқаның түпнұсқа баспагері рұқсат берсе, алдыңғы нұсқамен бірдей тақырыпты "
4771 "пайдалануға болады."
4772
4773 #. (itstool) path: formalpara/title
4774 #: C/fdl-appendix.xml:264
4775 msgid "B"
4776 msgstr "B"
4777
4778 #. (itstool) path: formalpara/para
4779 #: C/fdl-appendix.xml:265
4780 msgid ""
4781 "List on the <_:link-1/>, as authors, one or more persons or entities "
4782 "responsible for authorship of the modifications in the <_:link-2/>, together "
4783 "with at least five of the principal authors of the <_:link-3/> (all of its "
4784 "principal authors, if it has less than five)."
4785 msgstr ""
4786 "<_:link-1/>-да авторлар ретінде <_:link-2/>-дағы өзгертулердің авторлығына "
4787 "жауапты бір немесе бірнеше адамды немесе заңды тұлғаларды, сонымен бірге "
4788 "<_:link-3/>-тың кем дегенде бес негізгі авторын (егер негізгі авторлары бестен "
4789 "аз болса, олардың барлығын) тізімдеңіз."
4790
4791 #. (itstool) path: formalpara/title
4792 #: C/fdl-appendix.xml:279
4793 msgid "C"
4794 msgstr "C"
4795
4796 #. (itstool) path: formalpara/para
4797 #: C/fdl-appendix.xml:280
4798 msgid ""
4799 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as the "
4800 "publisher."
4801 msgstr ""
4802 "<_:link-1/>-да баспагер ретінде <_:link-2/> баспагерінің атын көрсетіңіз."
4803
4804 #. (itstool) path: formalpara/title
4805 #: C/fdl-appendix.xml:291
4806 msgid "D"
4807 msgstr "D"
4808
4809 #. (itstool) path: formalpara/para
4810 #: C/fdl-appendix.xml:292
4811 msgid "Preserve all the copyright notices of the <_:link-1/>."
4812 msgstr "<_:link-1/>-тың барлық авторлық құқық туралы ескертулерін сақтаңыз."
4813
4814 #. (itstool) path: formalpara/title
4815 #: C/fdl-appendix.xml:301
4816 msgid "E"
4817 msgstr "E"
4818
4819 #. (itstool) path: formalpara/para
4820 #: C/fdl-appendix.xml:302
4821 msgid ""
4822 "Add an appropriate copyright notice for your modifications adjacent to the "
4823 "other copyright notices."
4824 msgstr ""
4825 "Басқа авторлық құқық туралы ескертулердің жанына өзгертулеріңіз үшін тиісті "
4826 "авторлық құқық туралы ескертуді қосыңыз."
4827
4828 #. (itstool) path: formalpara/title
4829 #: C/fdl-appendix.xml:311
4830 msgid "F"
4831 msgstr "F"
4832
4833 #. (itstool) path: formalpara/para
4834 #: C/fdl-appendix.xml:312
4835 msgid ""
4836 "Include, immediately after the copyright notices, a license notice giving the "
4837 "public permission to use the <_:link-1/> under the terms of this License, in "
4838 "the form shown in the Addendum below."
4839 msgstr ""
4840 "Авторлық құқық туралы ескертулерден кейін бірден төмендегі Қосымшада "
4841 "көрсетілген пішімде қалың жұртшылыққа <_:link-1/>-ты осы Лицензияның шарттары "
4842 "бойынша пайдалануға рұқсат беретін лицензиялық ескертуді қосыңыз."
4843
4844 #. (itstool) path: formalpara/title
4845 #: C/fdl-appendix.xml:324
4846 msgid "G"
4847 msgstr "G"
4848
4849 #. (itstool) path: para/link
4850 #: C/fdl-appendix.xml:330
4851 msgid "Document's"
4852 msgstr "Құжаттың"
4853
4854 #. (itstool) path: formalpara/para
4855 #: C/fdl-appendix.xml:325
4856 msgid ""
4857 "Preserve in that license notice the full lists of <_:link-1/> and required "
4858 "<_:link-2/> given in the <_:link-3/> license notice."
4859 msgstr ""
4860 "Сол лицензиялық ескертуде <_:link-3/> лицензиялық ескертуінде берілген "
4861 "<_:link-1/> және талап етілетін <_:link-2/> толық тізімдерін сақтаңыз."
4862
4863 #. (itstool) path: formalpara/title
4864 #: C/fdl-appendix.xml:337
4865 msgid "H"
4866 msgstr "H"
4867
4868 #. (itstool) path: formalpara/para
4869 #: C/fdl-appendix.xml:338
4870 msgid "Include an unaltered copy of this License."
4871 msgstr "Осы Лицензияның өзгертілмеген көшірмесін қосыңыз."
4872
4873 #. (itstool) path: formalpara/title
4874 #: C/fdl-appendix.xml:346
4875 msgid "I"
4876 msgstr "I"
4877
4878 #. (itstool) path: para/quote
4879 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
4880 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
4881 msgid "History"
4882 msgstr "Тарих"
4883
4884 #. (itstool) path: formalpara/para
4885 #: C/fdl-appendix.xml:347
4886 msgid ""
4887 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
4888 "item stating at least the title, year, new authors, and publisher of the "
4889 "<_:link-2/> as given on the <_:link-3/>. If there is no section entitled "
4890 "<_:quote-4/> in the <_:link-5/>, create one stating the title, year, authors, "
4891 "and publisher of the Document as given on its Title Page, then add an item "
4892 "describing the Modified Version as stated in the previous sentence."
4893 msgstr ""
4894 "<_:quote-1/> деп аталатын бөлімді және оның тақырыбын сақтаңыз және оған кем "
4895 "дегенде <_:link-2/> тақырыбын, жылын, жаңа авторларын және баспагерін "
4896 "<_:link-3/>-да көрсетілгендей етіп мәлімдейтін элементті қосыңыз. Егер "
4897 "<_:link-5/>-да <_:quote-4/> деп аталатын бөлім болмаса, оның Титулдық бетінде "
4898 "көрсетілгендей Құжаттың тақырыбын, жылын, авторларын және баспагерін "
4899 "көрсететін бөлім жасаңыз, содан кейін алдыңғы сөйлемде айтылғандай Өзгертілген "
4900 "нұсқаны сипаттайтын элементті қосыңыз."
4901
4902 #. (itstool) path: formalpara/title
4903 #: C/fdl-appendix.xml:365
4904 msgid "J"
4905 msgstr "J"
4906
4907 #. (itstool) path: formalpara/para
4908 #: C/fdl-appendix.xml:366
4909 msgid ""
4910 "Preserve the network location, if any, given in the <_:link-1/> for public "
4911 "access to a <_:link-2/> copy of the Document, and likewise the network "
4912 "locations given in the Document for previous versions it was based on. These "
4913 "may be placed in the <_:quote-3/> section. You may omit a network location for "
4914 "a work that was published at least four years before the Document itself, or "
4915 "if the original publisher of the version it refers to gives permission."
4916 msgstr ""
4917 "<_:link-1/>-да Құжаттың <_:link-2/> көшірмесіне көпшіліктің қол жеткізуі үшін "
4918 "берілген желілік орынды (бар болса) және сол сияқты Құжатта ол негізделген "
4919 "алдыңғы нұсқалар үшін берілген желілік орындарды сақтаңыз. Олар <_:quote-3/> "
4920 "бөліміне орналастырылуы мүмкін. Құжаттың өзінен кем дегенде төрт жыл бұрын "
4921 "жарияланған жұмыс үшін немесе ол сілтеме жасайтын нұсқаның түпнұсқа баспагері "
4922 "рұқсат берсе, желілік орынды алып тастауға болады."
4923
4924 #. (itstool) path: formalpara/title
4925 #: C/fdl-appendix.xml:383
4926 msgid "K"
4927 msgstr "K"
4928
4929 #. (itstool) path: para/quote
4930 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
4931 msgid "Acknowledgements"
4932 msgstr "Алғыстар"
4933
4934 #. (itstool) path: para/quote
4935 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
4936 msgid "Dedications"
4937 msgstr "Арнаулар"
4938
4939 #. (itstool) path: formalpara/para
4940 #: C/fdl-appendix.xml:384
4941 msgid ""
4942 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
4943 "title, and preserve in the section all the substance and tone of each of the "
4944 "contributor acknowledgements and/or dedications given therein."
4945 msgstr ""
4946 "<_:quote-1/> немесе <_:quote-2/> деп аталатын кез келген бөлімде бөлімнің "
4947 "тақырыбын сақтаңыз және бөлімде берілген әрбір үлес қосушының алғыстарының "
4948 "және/немесе арнауларының барлық мазмұны мен реңін сақтаңыз."
4949
4950 #. (itstool) path: formalpara/title
4951 #: C/fdl-appendix.xml:396
4952 msgid "L"
4953 msgstr "L"
4954
4955 #. (itstool) path: formalpara/para
4956 #: C/fdl-appendix.xml:397
4957 msgid ""
4958 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
4959 "in their titles. Section numbers or the equivalent are not considered part of "
4960 "the section titles."
4961 msgstr ""
4962 "<_:link-2/>-тың барлық <_:link-1/>-ын мәтіні мен тақырыптарын өзгертпей "
4963 "сақтаңыз. Бөлім нөмірлері немесе оған тең нәрселер бөлім тақырыптарының бөлігі "
4964 "болып саналмайды."
4965
4966 #. (itstool) path: formalpara/title
4967 #: C/fdl-appendix.xml:409
4968 msgid "M"
4969 msgstr "M"
4970
4971 #. (itstool) path: para/quote
4972 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
4973 msgid "Endorsements"
4974 msgstr "Мақұлдаулар"
4975
4976 #. (itstool) path: formalpara/para
4977 #: C/fdl-appendix.xml:410
4978 msgid ""
4979 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
4980 "in the <_:link-2/>."
4981 msgstr ""
4982 "<_:quote-1/> деп аталатын кез келген бөлімді өшіріңіз. Мұндай бөлім <_:link-2/"
4983 ">-ға қосылмауы мүмкін."
4984
4985 #. (itstool) path: formalpara/title
4986 #: C/fdl-appendix.xml:421
4987 msgid "N"
4988 msgstr "N"
4989
4990 #. (itstool) path: para/link
4991 #: C/fdl-appendix.xml:425
4992 msgid "Invariant Section"
4993 msgstr "Тұрақты бөлім"
4994
4995 #. (itstool) path: formalpara/para
4996 #: C/fdl-appendix.xml:422
4997 msgid ""
4998 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
4999 "with any <_:link-2/>."
5000 msgstr ""
5001 "Ешбір бар бөлімнің атын <_:quote-1/> деп немесе кез келген <_:link-2/>-мен "
5002 "тақырып жағынан қайшы келетіндей етіп өзгертпеңіз."
5003
5004 #. (itstool) path: sect1/para
5005 #: C/fdl-appendix.xml:432
5006 msgid ""
5007 "If the <_:link-1/> includes new front-matter sections or appendices that "
5008 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5009 "may at your option designate some or all of these sections as invariant. To do "
5010 "this, add their titles to the list of <_:link-3/> in the Modified Version's "
5011 "license notice. These titles must be distinct from any other section titles."
5012 msgstr ""
5013 "Егер <_:link-1/> <_:link-2/> талаптарына сай келетін және Құжаттан көшірілген "
5014 "ешқандай материалды қамтымайтын жаңа алғы сөз бөлімдерін немесе қосымшаларды "
5015 "қамтыса, сіз өз қалауыңыз бойынша осы бөлімдердің кейбірін немесе барлығын "
5016 "тұрақты ретінде белгілей аласыз. Ол үшін олардың тақырыптарын Өзгертілген "
5017 "нұсқаның лицензиялық ескертуіндегі <_:link-3/> тізіміне қосыңыз. Бұл "
5018 "тақырыптар кез келген басқа бөлім тақырыптарынан ерекшеленуі керек."
5019
5020 #. (itstool) path: sect1/para
5021 #: C/fdl-appendix.xml:444
5022 msgid ""
5023 "You may add a section entitled <_:quote-1/>, provided it contains nothing but "
5024 "endorsements of your <_:link-2/> by various parties--for example, statements "
5025 "of peer review or that the text has been approved by an organization as the "
5026 "authoritative definition of a standard."
5027 msgstr ""
5028 "Сіз <_:quote-1/> деп аталатын бөлімді қоса аласыз, егер онда әртүрлі "
5029 "тараптардың сіздің <_:link-2/>-ыңызды мақұлдауынан басқа ештеңе болмаса — "
5030 "мысалы, сараптамалық шолу мәлімдемелері немесе мәтін ұйыммен стандарттың "
5031 "беделді анықтамасы ретінде бекітілгені туралы мәлімдемелер."
5032
5033 #. (itstool) path: para/link
5034 #: C/fdl-appendix.xml:455
5035 msgid "Front-Cover Text"
5036 msgstr "Алдыңғы мұқаба мәтіні"
5037
5038 #. (itstool) path: para/link
5039 #: C/fdl-appendix.xml:457
5040 msgid "Back-Cover Text"
5041 msgstr "Артқы мұқаба мәтіні"
5042
5043 #. (itstool) path: sect1/para
5044 #: C/fdl-appendix.xml:453
5045 msgid ""
5046 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5047 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in the "
5048 "<_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover Text "
5049 "may be added by (or through arrangements made by) any one entity. If the "
5050 "<_:link-5/> already includes a cover text for the same cover, previously added "
5051 "by you or by arrangement made by the same entity you are acting on behalf of, "
5052 "you may not add another; but you may replace the old one, on explicit "
5053 "permission from the previous publisher that added the old one."
5054 msgstr ""
5055 "Сіз <_:link-4/>-тегі <_:link-3/> тізімінің соңына <_:link-1/> ретінде бес "
5056 "сөзге дейінгі үзіндіні және <_:link-2/> ретінде 25 сөзге дейінгі үзіндіні қоса "
5057 "аласыз. Кез келген бір заңды тұлға тек бір Алдыңғы мұқаба мәтіні мен бір Артқы "
5058 "мұқаба мәтіні үзіндісін қоса алады (немесе жасалған келісімдер арқылы). Егер "
5059 "<_:link-5/>-да бұрын сіз немесе сіз атынан әрекет етіп отырған сол заңды тұлға "
5060 "жасаған келісім бойынша қосылған дәл сол мұқабаға арналған мұқаба мәтіні "
5061 "болса, сіз басқасын қоса алмайсыз; бірақ ескісін қосқан алдыңғы баспагердің "
5062 "нақты рұқсатымен оны ауыстыра аласыз."
5063
5064 #. (itstool) path: sect1/para
5065 #: C/fdl-appendix.xml:470
5066 msgid ""
5067 "The author(s) and publisher(s) of the <_:link-1/> do not by this License give "
5068 "permission to use their names for publicity for or to assert or imply "
5069 "endorsement of any <_:link-2/>."
5070 msgstr ""
5071 "<_:link-1/> авторы (авторлары) мен баспагері (баспагерлері) осы Лицензия "
5072 "арқылы өз есімдерін жарнамалау үшін немесе кез келген <_:link-2/>-ны "
5073 "мақұлдауды растау немесе меңзеу үшін пайдалануға рұқсат бермейді."
5074
5075 #. (itstool) path: sect1/title
5076 #: C/fdl-appendix.xml:480
5077 msgid "5. COMBINING DOCUMENTS"
5078 msgstr "5. ҚҰЖАТТАРДЫ БІРІКТІРУ"
5079
5080 #. (itstool) path: para/link
5081 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
5082 msgid "section 4"
5083 msgstr "4-бөлім"
5084
5085 #. (itstool) path: sect1/para
5086 #: C/fdl-appendix.xml:481
5087 msgid ""
5088 "You may combine the <_:link-1/> with other documents released under this "
5089 "License, under the terms defined in <_:link-2/> above for modified versions, "
5090 "provided that you include in the combination all of the <_:link-3/> of all of "
5091 "the original documents, unmodified, and list them all as Invariant Sections of "
5092 "your combined work in its license notice."
5093 msgstr ""
5094 "Сіз <_:link-1/>-ты осы Лицензия бойынша шығарылған басқа құжаттармен, "
5095 "өзгертілген нұсқалар үшін жоғарыдағы <_:link-2/>-те анықталған шарттар бойынша "
5096 "біріктіре аласыз, егер сіз біріктіруге барлық түпнұсқа құжаттардың барлық "
5097 "<_:link-3/>-ын өзгеріссіз енгізсеңіз және олардың барлығын біріктірілген "
5098 "жұмысыңыздың лицензиялық ескертуінде Тұрақты бөлімдер ретінде тізімдесеңіз."
5099
5100 #. (itstool) path: sect1/para
5101 #: C/fdl-appendix.xml:492
5102 msgid ""
5103 "The combined work need only contain one copy of this License, and multiple "
5104 "identical <_:link-1/> may be replaced with a single copy. If there are "
5105 "multiple Invariant Sections with the same name but different contents, make "
5106 "the title of each such section unique by adding at the end of it, in "
5107 "parentheses, the name of the original author or publisher of that section if "
5108 "known, or else a unique number. Make the same adjustment to the section titles "
5109 "in the list of Invariant Sections in the license notice of the combined work."
5110 msgstr ""
5111 "Біріктірілген жұмыс осы Лицензияның тек бір көшірмесін қамтуы керек және "
5112 "бірнеше бірдей <_:link-1/>-ды бір көшірмемен ауыстыруға болады. Егер атауы "
5113 "бірдей, бірақ мазмұны әртүрлі бірнеше Тұрақты бөлімдер болса, әрбір мұндай "
5114 "бөлімнің тақырыбын оның соңына жақша ішінде, белгілі болса, сол бөлімнің "
5115 "түпнұсқа авторының немесе баспагерінің атын, әйтпесе бірегей нөмірді қосу "
5116 "арқылы бірегей етіңіз. Біріктірілген жұмыстың лицензиялық ескертуіндегі "
5117 "Тұрақты бөлімдер тізіміндегі бөлім тақырыптарына да дәл сондай түзету жасаңыз."
5118
5119 #. (itstool) path: para/quote
5120 #: C/fdl-appendix.xml:511
5121 msgid "Endorsements."
5122 msgstr "Мақұлдаулар."
5123
5124 #. (itstool) path: sect1/para
5125 #: C/fdl-appendix.xml:505
5126 msgid ""
5127 "In the combination, you must combine any sections entitled <_:quote-1/> in the "
5128 "various original documents, forming one section entitled <_:quote-2/>; "
5129 "likewise combine any sections entitled <_:quote-3/>, and any sections entitled "
5130 "<_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
5131 msgstr ""
5132 "Біріктіруде сіз әртүрлі түпнұсқа құжаттардағы <_:quote-1/> деп аталатын кез "
5133 "келген бөлімдерді біріктіріп, <_:quote-2/> деп аталатын бір бөлімді құрауыңыз "
5134 "керек; сол сияқты <_:quote-3/> деп аталатын кез келген бөлімдерді және "
5135 "<_:quote-4/> деп аталатын кез келген бөлімдерді біріктіріңіз. <_:quote-5/> деп "
5136 "аталатын барлық бөлімдерді өшіруіңіз керек"
5137
5138 #. (itstool) path: sect1/title
5139 #: C/fdl-appendix.xml:516
5140 msgid "6. COLLECTIONS OF DOCUMENTS"
5141 msgstr "6. ҚҰЖАТТАР ЖИНАҚТАРЫ"
5142
5143 #. (itstool) path: sect1/para
5144 #: C/fdl-appendix.xml:517
5145 msgid ""
5146 "You may make a collection consisting of the <_:link-1/> and other documents "
5147 "released under this License, and replace the individual copies of this License "
5148 "in the various documents with a single copy that is included in the "
5149 "collection, provided that you follow the rules of this License for verbatim "
5150 "copying of each of the documents in all other respects."
5151 msgstr ""
5152 "Сіз <_:link-1/>-тан және осы Лицензия бойынша шығарылған басқа құжаттардан "
5153 "тұратын жинақ жасай аласыз және әртүрлі құжаттардағы осы Лицензияның жеке "
5154 "көшірмелерін жинаққа енгізілген жалғыз көшірмемен ауыстыра аласыз, егер сіз "
5155 "барлық басқа жағынан әрбір құжатты сөзбе-сөз көшірудің осы Лицензиясының "
5156 "ережелерін орындасаңыз."
5157
5158 #. (itstool) path: sect1/para
5159 #: C/fdl-appendix.xml:527
5160 msgid ""
5161 "You may extract a single document from such a collection, and distribute it "
5162 "individually under this License, provided you insert a copy of this License "
5163 "into the extracted document, and follow this License in all other respects "
5164 "regarding verbatim copying of that document."
5165 msgstr ""
5166 "Мұндай жинақтан бір құжатты бөліп алып, оны осы Лицензия бойынша жеке тарата "
5167 "аласыз, егер сіз бөліп алынған құжатқа осы Лицензияның көшірмесін енгізсеңіз "
5168 "және сол құжатты сөзбе-сөз көшіруге қатысты барлық басқа жағынан осы "
5169 "Лицензияны орындасаңыз."
5170
5171 #. (itstool) path: sect1/title
5172 #: C/fdl-appendix.xml:537
5173 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
5174 msgstr "7. ТӘУЕЛСІЗ ЖҰМЫСТАРМЕН БІРІКТІРУ"
5175
5176 #. (itstool) path: para/quote
5177 #: C/fdl-appendix.xml:546
5178 msgid "aggregate"
5179 msgstr "агрегат"
5180
5181 #. (itstool) path: para/link
5182 #: C/fdl-appendix.xml:550
5183 msgid "Cover Text"
5184 msgstr "Мұқаба мәтіні"
5185
5186 #. (itstool) path: sect1/para
5187 #: C/fdl-appendix.xml:538
5188 msgid ""
5189 "A compilation of the <_:link-1/> or its derivatives with other separate and "
5190 "independent documents or works, in or on a volume of a storage or distribution "
5191 "medium, does not as a whole count as a <_:link-2/> of the Document, provided "
5192 "no compilation copyright is claimed for the compilation. Such a compilation is "
5193 "called an <_:quote-3/>, and this License does not apply to the other self-"
5194 "contained works thus compiled with the Document , on account of their being "
5195 "thus compiled, if they are not themselves derivative works of the Document. If "
5196 "the <_:link-4/> requirement of <_:link-5/> is applicable to these copies of "
5197 "the Document, then if the Document is less than one quarter of the entire "
5198 "aggregate, the Document's Cover Texts may be placed on covers that surround "
5199 "only the Document within the aggregate. Otherwise they must appear on covers "
5200 "around the whole aggregate."
5201 msgstr ""
5202 "Сақтау немесе тарату ортасының көлемінде немесе оның үстінде <_:link-1/>-тың "
5203 "немесе оның туындыларының басқа бөлек және тәуелсіз құжаттармен немесе "
5204 "жұмыстармен компиляциясы, егер компиляция үшін ешқандай компиляциялық авторлық "
5205 "құқық талап етілмесе, тұтастай алғанда Құжаттың <_:link-2/> болып саналмайды. "
5206 "Мұндай компиляция <_:quote-3/> деп аталады және бұл Лицензия Құжатпен бірге "
5207 "компиляцияланған басқа дербес жұмыстарға, егер олардың өздері Құжаттың туынды "
5208 "жұмыстары болмаса, олардың осылай компиляцияланғанына байланысты "
5209 "қолданылмайды. Егер <_:link-5/>-тегі <_:link-4/> талабы Құжаттың осы "
5210 "көшірмелеріне қолданылса, онда Құжат бүкіл агрегаттың төрттен бірінен аз "
5211 "болса, Құжаттың Мұқаба мәтіндері агрегат ішінде тек Құжатты ғана қоршайтын "
5212 "мұқабаларға орналастырылуы мүмкін. Әйтпесе, олар бүкіл агрегатты қоршайтын "
5213 "мұқабаларда көрінуі керек."
5214
5215 #. (itstool) path: sect1/title
5216 #: C/fdl-appendix.xml:561
5217 msgid "8. TRANSLATION"
5218 msgstr "8. АУДАРМА"
5219
5220 #. (itstool) path: sect1/para
5221 #: C/fdl-appendix.xml:562
5222 msgid ""
5223 "Translation is considered a kind of modification, so you may distribute "
5224 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing "
5225 "<_:link-3/> with translations requires special permission from their copyright "
5226 "holders, but you may include translations of some or all Invariant Sections in "
5227 "addition to the original versions of these Invariant Sections. You may include "
5228 "a translation of this License provided that you also include the original "
5229 "English version of this License. In case of a disagreement between the "
5230 "translation and the original English version of this License, the original "
5231 "English version will prevail."
5232 msgstr ""
5233 "Аударма өзгертудің бір түрі болып саналады, сондықтан сіз <_:link-1/>-тың "
5234 "аудармаларын <_:link-2/> шарттарына сәйкес тарата аласыз. <_:link-3/>-ды "
5235 "аудармалармен ауыстыру олардың авторлық құқық иелерінің арнайы рұқсатын талап "
5236 "етеді, бірақ сіз осы Тұрақты бөлімдердің түпнұсқа нұсқаларына қосымша кейбір "
5237 "немесе барлық Тұрақты бөлімдердің аудармаларын қоса аласыз. Осы Лицензияның "
5238 "аудармасын, егер сіз осы Лицензияның түпнұсқа ағылшын тіліндегі нұсқасын да "
5239 "қоссаңыз, қоса аласыз. Аударма мен осы Лицензияның түпнұсқа ағылшын тіліндегі "
5240 "нұсқасы арасында келіспеушілік туындаған жағдайда, түпнұсқа ағылшын тіліндегі "
5241 "нұсқасы басым болады."
5242
5243 #. (itstool) path: sect1/title
5244 #: C/fdl-appendix.xml:580
5245 msgid "9. TERMINATION"
5246 msgstr "9. ТОҚТАТУ"
5247
5248 #. (itstool) path: sect1/para
5249 #: C/fdl-appendix.xml:581
5250 msgid ""
5251 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except as "
5252 "expressly provided for under this License. Any other attempt to copy, modify, "
5253 "sublicense or distribute the Document is void, and will automatically "
5254 "terminate your rights under this License. However, parties who have received "
5255 "copies, or rights, from you under this License will not have their licenses "
5256 "terminated so long as such parties remain in full compliance."
5257 msgstr ""
5258 "Осы Лицензияда тікелей қарастырылған жағдайларды қоспағанда, сіз <_:link-1/>-"
5259 "ты көшіре, өзгерте, қосалқы лицензия бере немесе тарата алмайсыз. Құжатты "
5260 "көшіруге, өзгертуге, қосалқы лицензия беруге немесе таратуға бағытталған кез "
5261 "келген басқа әрекет жарамсыз болып табылады және осы Лицензия бойынша "
5262 "құқықтарыңызды автоматты түрде тоқтатады. Дегенмен, осы Лицензия бойынша "
5263 "сізден көшірмелерді немесе құқықтарды алған тараптардың лицензиялары, егер "
5264 "мұндай тараптар толық сәйкестікте болса, тоқтатылмайды."
5265
5266 #. (itstool) path: sect1/title
5267 #: C/fdl-appendix.xml:594
5268 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
5269 msgstr "10. ОСЫ ЛИЦЕНЗИЯНЫҢ БОЛАШАҚ ҚАЙТА ҚАРАУЛАРЫ"
5270
5271 #. (itstool) path: para/ulink
5272 #: C/fdl-appendix.xml:597
5273 msgid "Free Software Foundation"
5274 msgstr "Free Software Foundation"
5275
5276 #. (itstool) path: para/ulink
5277 #: C/fdl-appendix.xml:603
5278 msgid "http://www.gnu.org/copyleft/"
5279 msgstr "http://www.gnu.org/copyleft/"
5280
5281 #. (itstool) path: sect1/para
5282 #: C/fdl-appendix.xml:595
5283 msgid ""
5284 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
5285 "Documentation License from time to time. Such new versions will be similar in "
5286 "spirit to the present version, but may differ in detail to address new "
5287 "problems or concerns. See <_:ulink-2/>."
5288 msgstr ""
5289 "<_:ulink-1/> мезгіл-мезгіл GNU еркін құжаттама лицензиясының жаңа, қайта "
5290 "қаралған нұсқаларын жариялай алады. Мұндай жаңа нұсқалар рухы жағынан қазіргі "
5291 "нұсқаға ұқсас болады, бірақ жаңа мәселелерді немесе алаңдаушылықтарды шешу "
5292 "үшін егжей-тегжейлі ерекшеленуі мүмкін. <_:ulink-2/> қараңыз."
5293
5294 #. (itstool) path: para/quote
5295 #: C/fdl-appendix.xml:610
5296 msgid "or any later version"
5297 msgstr "немесе кез келген кейінгі нұсқасы"
5298
5299 #. (itstool) path: sect1/para
5300 #: C/fdl-appendix.xml:606
5301 msgid ""
5302 "Each version of the License is given a distinguishing version number. If the "
5303 "<_:link-1/> specifies that a particular numbered version of this License "
5304 "<_:quote-2/> applies to it, you have the option of following the terms and "
5305 "conditions either of that specified version or of any later version that has "
5306 "been published (not as a draft) by the Free Software Foundation. If the "
5307 "Document does not specify a version number of this License, you may choose any "
5308 "version ever published (not as a draft) by the Free Software Foundation."
5309 msgstr ""
5310 "Лицензияның әрбір нұсқасына айрықша нұсқа нөмірі беріледі. Егер <_:link-1/> "
5311 "осы Лицензияның белгілі бір нөмірленген нұсқасы <_:quote-2/> оған "
5312 "қолданылатынын көрсетсе, сізде сол көрсетілген нұсқаның немесе Free Software "
5313 "Foundation жариялаған (жоба ретінде емес) кез келген кейінгі нұсқаның шарттары "
5314 "мен ережелерін орындау таңдауы болады. Егер Құжат осы Лицензияның нұсқа "
5315 "нөмірін көрсетпесе, сіз Free Software Foundation жариялаған (жоба ретінде "
5316 "емес) кез келген нұсқаны таңдай аласыз."
5317
5318 #. (itstool) path: sect1/title
5319 #: C/fdl-appendix.xml:621
5320 msgid "Addendum"
5321 msgstr "Қосымша"
5322
5323 #. (itstool) path: sect1/para
5324 #: C/fdl-appendix.xml:622
5325 msgid ""
5326 "To use this License in a document you have written, include a copy of the "
5327 "License in the document and put the following copyright and license notices "
5328 "just after the title page:"
5329 msgstr ""
5330 "Осы Лицензияны өзіңіз жазған құжатта пайдалану үшін құжатқа Лицензияның "
5331 "көшірмесін енгізіңіз және титулдық беттен кейін бірден келесі авторлық құқық "
5332 "және лицензиялық ескертулерді қойыңыз:"
5333
5334 #. (itstool) path: blockquote/para
5335 #: C/fdl-appendix.xml:629
5336 msgid "Copyright YEAR YOUR NAME."
5337 msgstr "Copyright ЖЫЛ СІЗДІҢ АТЫҢЫЗ."
5338
5339 #. (itstool) path: para/link
5340 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
5341 msgid "Front-Cover Texts"
5342 msgstr "Алдыңғы мұқаба мәтіндері"
5343
5344 #. (itstool) path: para/link
5345 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
5346 msgid "Back-Cover Texts"
5347 msgstr "Артқы мұқаба мәтіндері"
5348
5349 #. (itstool) path: blockquote/para
5350 #: C/fdl-appendix.xml:632
5351 msgid ""
5352 "Permission is granted to copy, distribute and/or modify this document under "
5353 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5354 "version published by the Free Software Foundation; with the <_:link-1/> being "
5355 "LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:link-3/> "
5356 "being LIST. A copy of the license is included in the section entitled "
5357 "<_:quote-4/>."
5358 msgstr ""
5359 "Бұл құжатты Free Software Foundation жариялаған GNU еркін құжаттама "
5360 "лицензиясының 1.1 нұсқасы немесе кез келген соңғы нұсқасының шарттарына сәйкес "
5361 "көшіруге, таратуға және/немесе өзгертуге рұқсат етіледі; <_:link-1/> ТІЗІМІ "
5362 "МЕН ОЛАРДЫҢ ТАҚЫРЫПТАРЫМЕН, <_:link-2/> ТІЗІМІМЕН, және <_:link-3/> ТІЗІМІМЕН "
5363 "бірге. Лицензияның көшірмесі <_:quote-4/> деп аталатын бөлімге енгізілген."
5364
5365 #. (itstool) path: para/quote
5366 #: C/fdl-appendix.xml:649
5367 msgid "with no Invariant Sections"
5368 msgstr "инвариантты бөлімдерсіз"
5369
5370 #. (itstool) path: para/quote
5371 #: C/fdl-appendix.xml:652
5372 msgid "no Front-Cover Texts"
5373 msgstr "алдыңғы мұқаба мәтіндерсіз"
5374
5375 #. (itstool) path: para/quote
5376 #: C/fdl-appendix.xml:653
5377 msgid "Front-Cover Texts being LIST"
5378 msgstr "Алдыңғы мұқаба мәтіндері ТІЗІМІМЕН"
5379
5380 #. (itstool) path: sect1/para
5381 #: C/fdl-appendix.xml:647
5382 msgid ""
5383 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
5384 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of "
5385 "<_:quote-5/>; likewise for <_:link-6/>."
5386 msgstr ""
5387 "Егер сізде <_:link-1/> болмаса, қайсысы тұрақты екенін айтудың орнына "
5388 "<_:quote-2/> деп жазыңыз. Егер сізде <_:link-3/> болмаса, <_:quote-5/> орнына "
5389 "<_:quote-4/> деп жазыңыз; <_:link-6/> үшін де солай."
5390
5391 #. (itstool) path: para/ulink
5392 #: C/fdl-appendix.xml:661
5393 msgid "GNU General Public License"
5394 msgstr "GNU General Public License"
5395
5396 #. (itstool) path: sect1/para
5397 #: C/fdl-appendix.xml:657
5398 msgid ""
5399 "If your document contains nontrivial examples of program code, we recommend "
5400 "releasing these examples in parallel under your choice of free software "
5401 "license, such as the <_:ulink-1/>, to permit their use in free software."
5402 msgstr ""
5403 "Егер сіздің құжатыңыз бағдарлама кодының маңызды мысалдарын қамтыса, оларды "
5404 "еркін бағдарламалық қамтамада пайдалануға рұқсат беру үшін осы мысалдарды "
5405 "<_:ulink-1/> сияқты өзіңіз таңдаған еркін бағдарламалық қамтама лицензиясы "
5406 "бойынша қатар шығаруды ұсынамыз."