Debian Codegraph @

help/manual/pt_BR/pt_BR.po

raw
1 # Brazilian Portuguese translation for gtk-doc help.
2 # Copyright (C) 2026 gtk-doc's COPYRIGHT HOLDER
3 # This file is distributed under the same license as the gtk-doc package.
4 # Marcelo Rodrigues <[email protected]>, 2010.
5 # Rafael Fontenelle <[email protected]>, 2013-2026.
6 #
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: gtk-doc help\n"
10 "Report-Msgid-Bugs-To: http://bugzilla.gnome.org/enter_bug.cgi?product=gtk-"
11 "doc&keywords=I18N+L10N&component=general\n"
12 "POT-Creation-Date: 2026-03-13 23:53+0000\n"
13 "PO-Revision-Date: 2026-03-17 16:36-0300\n"
14 "Last-Translator: Rafael Fontenelle <[email protected]>\n"
15 "Language-Team: Brazilian Portuguese <https://br.gnome.org/traducao>\n"
16 "Language: pt_BR\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
21 "X-Generator: Gtranslator 50.0\n"
22 "X-Project-Style: gnome\n"
23
24 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
25 msgctxt "_"
26 msgid "translator-credits"
27 msgstr ""
28 "Marcelo Rodrigues <[email protected]>, 2010\n"
29 "Rafael Fontenelle <[email protected]>, 2013-2021\n"
30 "Leônidas Araújo <[email protected]>, 2022-2023"
31
32 #. (itstool) path: bookinfo/title
33 #: C/index.docbook:12
34 msgid "GTK-Doc Manual"
35 msgstr "Manual do GTK-Doc"
36
37 #. (itstool) path: bookinfo/edition
38 #: C/index.docbook:13
39 msgid "1.24.1"
40 msgstr "1.24.1"
41
42 #. (itstool) path: abstract/para
43 #: C/index.docbook:14
44 msgid "User manual for developers with instructions of GTK-Doc usage."
45 msgstr ""
46 "Manual de usuário para desenvolvedores com instruções do uso do GTK-Doc."
47
48 #. (itstool) path: authorgroup/author
49 #: C/index.docbook:16
50 msgid ""
51 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
52 "<address> <email>[email protected]</email> </address> </affiliation>"
53 msgstr ""
54 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
55 "<address> <email>[email protected]</email> </address> </affiliation>"
56
57 #. (itstool) path: authorgroup/author
58 #: C/index.docbook:25
59 msgid ""
60 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
61 "<email>[email protected]</email> </address> </affiliation>"
62 msgstr ""
63 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
64 "<email>[email protected]</email> </address> </affiliation>"
65
66 #. (itstool) path: authorgroup/author
67 #: C/index.docbook:34
68 msgid ""
69 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
70 "<address> <email>[email protected]</email> </address> </affiliation>"
71 msgstr ""
72 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
73 "<address> <email>[email protected]</email> </address> </affiliation>"
74
75 #. (itstool) path: publisher/publishername
76 #: C/index.docbook:45
77 msgid "GTK-Doc project"
78 msgstr "Projeto GTK-Doc"
79
80 #. (itstool) path: bookinfo/publisher
81 #: C/index.docbook:44
82 msgid ""
83 "<_:publishername-1/> <address><email>[email protected]</email></address>"
84 msgstr ""
85 "<_:publishername-1/> <address><email>[email protected]</email></address>"
86
87 #. (itstool) path: bookinfo/copyright
88 #: C/index.docbook:48
89 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
90 msgstr "<year>2000, 2005</year> <holder>Dan Mueth e Chris Lyttle</holder>"
91
92 #. (itstool) path: bookinfo/copyright
93 #: C/index.docbook:52
94 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
95 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
96
97 #. (itstool) path: legalnotice/para
98 #: C/index.docbook:65
99 msgid ""
100 "Permission is granted to copy, distribute and/or modify this document under "
101 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
102 "Version 1.1 or any later version published by the Free Software Foundation "
103 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
104 "copy of the license is <link linkend=\"fdl\">included</link>."
105 msgstr ""
106 "Permissão concedida para copiar, distribuir e/ou modificar este documento "
107 "sob os termos da <citetitle>Licença de Documentação Livre GNU</citetitle> "
108 "(GNU Free Documentation License), Versão 1.1 ou qualquer versão mais recente "
109 "publicada pela Free Software Foundation; sem Seções Invariantes, Textos de "
110 "Capa Frontal, e sem Textos de Contracapa. Você pode encontrar uma cópia da "
111 "licença está <link linkend=\"fdl\">inclusa</link>."
112
113 #. (itstool) path: legalnotice/para
114 #: C/index.docbook:73
115 msgid ""
116 "Many of the names used by companies to distinguish their products and "
117 "services are claimed as trademarks. Where those names appear in any GNOME "
118 "documentation, and those trademarks are made aware to the members of the "
119 "GNOME Documentation Project, the names have been printed in caps or initial "
120 "caps."
121 msgstr ""
122 "Muitos dos nomes usados por empresas para distinguir seus produtos e "
123 "serviços são reivindicados como marcas registradas. Onde esses nomes "
124 "aparecem em qualquer documentação do GNOME e os membros do Projeto de "
125 "Documentação do GNOME estiverem cientes dessas marcas registradas, os nomes "
126 "aparecerão impressos em letras maiúsculas ou com iniciais em maiúsculas."
127
128 #. (itstool) path: revhistory/revision
129 #: C/index.docbook:83
130 msgid ""
131 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
132 "authorinitials> <revremark>gtk4 version</revremark>"
133 msgstr ""
134 "<revnumber>1.33.0</revnumber> <date>1 out 2020</date> <authorinitials>ss</"
135 "authorinitials> <revremark>versão gtk4</revremark>"
136
137 #. (itstool) path: revhistory/revision
138 #: C/index.docbook:89
139 msgid ""
140 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
141 "authorinitials> <revremark>dev version</revremark>"
142 msgstr ""
143 "<revnumber>1.32.1</revnumber> <date>15 ago 2019</date> <authorinitials>ss</"
144 "authorinitials> <revremark>versão de desenvolvimento</revremark>"
145
146 #. (itstool) path: revhistory/revision
147 #: C/index.docbook:95
148 msgid ""
149 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
150 "authorinitials> <revremark>hotfix release</revremark>"
151 msgstr ""
152 "<revnumber>1.32</revnumber> <date>15 ago 2019</date> <authorinitials>ss</"
153 "authorinitials> <revremark>lançamento de correção de erros</revremark>"
154
155 #. (itstool) path: revhistory/revision
156 #: C/index.docbook:101
157 msgid ""
158 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
159 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
160 msgstr ""
161 "<revnumber>1.31</revnumber> <date>05 ago 2019</date> <authorinitials>ss</"
162 "authorinitials> <revremark>refatoramentos e mais cobertura de testes</"
163 "revremark>"
164
165 #. (itstool) path: revhistory/revision
166 #: C/index.docbook:107
167 msgid ""
168 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
169 "authorinitials> <revremark>more test coverage</revremark>"
170 msgstr ""
171 "<revnumber>1.30</revnumber> <date>08 maio 2019</date> <authorinitials>ss</"
172 "authorinitials> <revremark>mais cobertura de testes</revremark>"
173
174 #. (itstool) path: revhistory/revision
175 #: C/index.docbook:113
176 msgid ""
177 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
178 "authorinitials> <revremark>bug fixes</revremark>"
179 msgstr ""
180 "<revnumber>1.29</revnumber> <date>28 ago 2018</date> <authorinitials>ss</"
181 "authorinitials> <revremark>correções de erros</revremark>"
182
183 #. (itstool) path: revhistory/revision
184 #: C/index.docbook:119
185 msgid ""
186 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
187 "authorinitials> <revremark>bug fixes</revremark>"
188 msgstr ""
189 "<revnumber>1.28</revnumber> <date>24 mar 2018</date> <authorinitials>ss</"
190 "authorinitials> <revremark>correções de erros</revremark>"
191
192 #. (itstool) path: revhistory/revision
193 #: C/index.docbook:125
194 msgid ""
195 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
196 "authorinitials> <revremark>fine tuning of the python port</revremark>"
197 msgstr ""
198 "<revnumber>1.27</revnumber> <date>07 dez 2017</date> <authorinitials>ss</"
199 "authorinitials> <revremark>ajustes do porte para Python</revremark>"
200
201 #. (itstool) path: revhistory/revision
202 #: C/index.docbook:131
203 msgid ""
204 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
205 "authorinitials> <revremark>port all tools from perl/bash to python</"
206 "revremark>"
207 msgstr ""
208 "<revnumber>1.26</revnumber> <date>11 ago 2017</date> <authorinitials>ss</"
209 "authorinitials> <revremark>portadas todas ferramentas de perl/bash para "
210 "Python</revremark>"
211
212 #. (itstool) path: revhistory/revision
213 #: C/index.docbook:137
214 msgid ""
215 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
216 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
217 msgstr ""
218 "<revnumber>1.25</revnumber> <date>21 mar 2016</date> <authorinitials>ss</"
219 "authorinitials> <revremark>correção de erros, limpezas de testes</revremark>"
220
221 #. (itstool) path: revhistory/revision
222 #: C/index.docbook:143
223 msgid ""
224 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
225 "authorinitials> <revremark>bug fix</revremark>"
226 msgstr ""
227 "<revnumber>1.24</revnumber> <date>29 maio 2015</date> <authorinitials>ss</"
228 "authorinitials> <revremark>correção de erros</revremark>"
229
230 #. (itstool) path: revhistory/revision
231 #: C/index.docbook:149
232 msgid ""
233 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
234 "authorinitials> <revremark>bug fix</revremark>"
235 msgstr ""
236 "<revnumber>1.23</revnumber> <date>17 maio 2015</date> <authorinitials>ss</"
237 "authorinitials> <revremark>correção de erros</revremark>"
238
239 #. (itstool) path: revhistory/revision
240 #: C/index.docbook:155
241 msgid ""
242 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
243 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
244 "revremark>"
245 msgstr ""
246 "<revnumber>1.22</revnumber> <date>07 maio 2015</date> <authorinitials>ss</"
247 "authorinitials> <revremark>correção de erros, desativadas funcionalidades "
248 "obsoletas</revremark>"
249
250 #. (itstool) path: revhistory/revision
251 #: C/index.docbook:161
252 msgid ""
253 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
254 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
255 "revremark>"
256 msgstr ""
257 "<revnumber>1.21</revnumber> <date>17 jul 2014</date> <authorinitials>ss</"
258 "authorinitials> <revremark>correção de erros, desativadas funcionalidades "
259 "obsoletas</revremark>"
260
261 #. (itstool) path: revhistory/revision
262 #: C/index.docbook:167
263 msgid ""
264 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
265 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
266 "revremark>"
267 msgstr ""
268 "<revnumber>1.20</revnumber> <date>14 fev 2014</date> <authorinitials>ss</"
269 "authorinitials> <revremark>correção de erros, suporte a markdown, melhorias "
270 "no estilo</revremark>"
271
272 #. (itstool) path: revhistory/revision
273 #: C/index.docbook:173
274 msgid ""
275 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
276 "authorinitials> <revremark>bug fixes</revremark>"
277 msgstr ""
278 "<revnumber>1.19</revnumber> <date>05 jun 2013</date> <authorinitials>ss</"
279 "authorinitials> <revremark>correção de erros</revremark>"
280
281 #. (itstool) path: revhistory/revision
282 #: C/index.docbook:179
283 msgid ""
284 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
285 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
286 msgstr ""
287 "<revnumber>1.18</revnumber> <date>14 set 2011</date> <authorinitials>ss</"
288 "authorinitials> <revremark>correção de erros, aceleração, suporte a "
289 "markdown</revremark>"
290
291 #. (itstool) path: revhistory/revision
292 #: C/index.docbook:185
293 msgid ""
294 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
295 "authorinitials> <revremark>urgent bug fix update</revremark>"
296 msgstr ""
297 "<revnumber>1.17</revnumber> <date>26 Fev 2011</date> <authorinitials>sk</"
298 "authorinitials> <revremark>atualização de correção de erro urgente</"
299 "revremark>"
300
301 #. (itstool) path: revhistory/revision
302 #: C/index.docbook:191
303 msgid ""
304 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
305 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
306 msgstr ""
307 "<revnumber>1.16</revnumber> <date>14 jan 2011</date> <authorinitials>sk</"
308 "authorinitials> <revremark>correção de erros, melhorias no layout</revremark>"
309
310 #. (itstool) path: revhistory/revision
311 #: C/index.docbook:197
312 msgid ""
313 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
314 "authorinitials> <revremark>bug and regression fixes</revremark>"
315 msgstr ""
316 "<revnumber>1.15</revnumber> <date>21 maio 2010</date> <authorinitials>sk</"
317 "authorinitials> <revremark>correção de erros e regressões</revremark>"
318
319 #. (itstool) path: revhistory/revision
320 #: C/index.docbook:203
321 msgid ""
322 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
323 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
324 msgstr ""
325 "<revnumber>1.14</revnumber> <date>28 mar 2010</date> <authorinitials>sk</"
326 "authorinitials> <revremark>Correção de erro e melhorias na performance</"
327 "revremark>"
328
329 #. (itstool) path: revhistory/revision
330 #: C/index.docbook:209
331 msgid ""
332 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
333 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
334 "revremark>"
335 msgstr ""
336 "<revnumber>1.13</revnumber> <date>18 dez 2009</date> <authorinitials>sk</"
337 "authorinitials> <revremark>atualização de tarball defeituoso</revremark>"
338
339 #. (itstool) path: revhistory/revision
340 #: C/index.docbook:215
341 msgid ""
342 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
343 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
344 "bugfixes</revremark>"
345 msgstr ""
346 "<revnumber>1.12</revnumber> <date>18 dez 2009</date> <authorinitials>sk</"
347 "authorinitials> <revremark>novas funcionalidades da ferramenta e correção de "
348 "erros</revremark>"
349
350 #. (itstool) path: revhistory/revision
351 #: C/index.docbook:221
352 msgid ""
353 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
354 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
355 "revremark>"
356 msgstr ""
357 "<revnumber>1.11</revnumber> <date>16 nov 2008</date> <authorinitials>mal</"
358 "authorinitials> <revremark>migração do GNOME doc-utils</revremark>"
359
360 #. (itstool) path: chapter/title
361 #: C/index.docbook:234
362 msgid "Introduction"
363 msgstr "Introdução"
364
365 #. (itstool) path: chapter/para
366 #: C/index.docbook:236
367 msgid ""
368 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
369 "it is used."
370 msgstr ""
371 "Este capítulo introduz GTK-Doc e dá um visão geral do que ele é e como ele é "
372 "usado."
373
374 #. (itstool) path: sect1/title
375 #: C/index.docbook:242
376 msgid "What is GTK-Doc?"
377 msgstr "O que é GTK-Doc?"
378
379 #. (itstool) path: sect1/para
380 #: C/index.docbook:244
381 msgid ""
382 "GTK-Doc is used to document C code. It is typically used to document the "
383 "public API of libraries, such as GLib-based libraries, but it can also be "
384 "used to document application code."
385 msgstr ""
386 "GTK-Doc é usado para documentar código C. Ele é tipicamente usado para "
387 "documentar a API pública das bibliotecas, como as bibliotecas baseadas no "
388 "Glib. Mas ele também pode ser usado para documentar código de aplicativos."
389
390 #. (itstool) path: sect1/title
391 #: C/index.docbook:252
392 msgid "How Does GTK-Doc Work?"
393 msgstr "Como o GTK-Doc funciona?"
394
395 #. (itstool) path: sect1/para
396 #: C/index.docbook:254
397 msgid ""
398 "GTK-Doc works by reading specially-formatted comment blocks placed inside "
399 "the source files to document symbols such as functions, macros, structs, "
400 "enums, etc. (though note that for most kind of symbols GTK-Doc will only "
401 "document the symbols that are declared in header files; for example it won't "
402 "produce output for static functions)."
403 msgstr ""
404 "O GTK-Doc funciona lendo blocos de comentários formatados especialmente para "
405 "esse fim, inseridos nos arquivos de origem, para documentar símbolos como "
406 "funções, macros, structs, enums, etc. (observe, porém, que para a maioria "
407 "dos tipos de símbolos, o GTK-Doc documentará apenas os símbolos declarados "
408 "nos arquivos de cabeçalho; por exemplo, ele não produzirá saída para funções "
409 "estáticas)."
410
411 #. (itstool) path: sect1/para
412 #: C/index.docbook:262
413 msgid ""
414 "GTK-Doc also reads template files where documentation can be added there as "
415 "well."
416 msgstr ""
417 "O GTK-Doc também lê arquivos de modelo, onde a documentação pode ser "
418 "adicionada."
419
420 #. (itstool) path: sect1/para
421 #: C/index.docbook:267
422 msgid ""
423 "GTK-Doc consists of a number of programs, each performing a different step "
424 "in the process."
425 msgstr ""
426 "GTK-Doc consiste em um número de programas, cada um executando uma etapa "
427 "diferente no processo."
428
429 #. (itstool) path: sect1/para
430 #: C/index.docbook:272
431 msgid "The main steps are:"
432 msgstr "Há etapas principais são:"
433
434 #. (itstool) path: listitem/para
435 #: C/index.docbook:279
436 msgid ""
437 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
438 "source files with the documentation for each function, macro, structs or "
439 "unions, etc."
440 msgstr ""
441 "<guilabel>Escrita da documentação.</guilabel> O autor preenche os arquivos "
442 "fonte com a documentação para cada função, macro, structs ou unions, etc."
443
444 #. (itstool) path: listitem/para
445 #: C/index.docbook:288
446 msgid ""
447 "<guilabel>Gathering information about the code.</guilabel> "
448 "<application>gtkdoc-scan</application> scans the header files of the code "
449 "looking for declarations of functions, macros, enums, structs, and unions. "
450 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
451 "containing a list of the declarations, placing them into sections according "
452 "to which header file they are in. On the first run this file is copied to "
453 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
454 "the sections, and the order of the declarations within them, to produce the "
455 "final desired order. The second file it generates is "
456 "<filename>&lt;module&gt;-decl.txt</filename>. This file contains the full "
457 "declarations found by the scanner. If for some reason one would like some "
458 "symbols to show up in the docs, where the full declaration cannot be found "
459 "by the scanner or the declaration should appear differently, one can place "
460 "entities similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> "
461 "into <filename>&lt;module&gt;-overrides.txt</filename>."
462 msgstr ""
463 "<guilabel>Coleta de informação sobre o código.</guilabel> "
464 "<application>gtkdoc-scan</application> varre os arquivos de cabeçalho do "
465 "código buscando por declarações de funções, macros, enums, structs e unions. "
466 "Ele cria o arquivo <filename>&lt;módulo&gt;-decl-list.txt</filename> "
467 "contendo uma lista de declarações, inserindo-as em seções da acordo com o "
468 "arquivo de cabeçalho no qual se encontram. Na primeira execução, este "
469 "arquivo é copiado para <filename>&lt;módulo&gt;-sections.txt</filename>. O "
470 "autor pode reorganizar as seções, e a ordem das declarações dentro delas, "
471 "para produzir a ordem final desejada. O segundo arquivo que ele gera é "
472 "<filename>&lt;módulo&gt;-decl.txt</filename>. Este arquivo contém as "
473 "declarações completas encontradas pela varredura. Se por algum motivo se "
474 "quiser que alguns símbolos apareçam nos documentos, nos quais declarações "
475 "completas não puderam ser encontradas pela varredura ou a declaração deveria "
476 "aparecer de outra forma, pode-se colocar entidades similares aos do "
477 "<filename>&lt;módulo&gt;-decl.txt</filename> no <filename>&lt;módulo&gt;-"
478 "overrides.txt</filename>."
479
480 #. (itstool) path: listitem/para
481 #: C/index.docbook:308
482 msgid ""
483 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
484 "query a library about any GObject subclasses it exports. It saves "
485 "information about each object's position in the class hierarchy and about "
486 "any GObject properties and signals it provides."
487 msgstr ""
488 "<application>gtkdoc-scangobj</application> também pode ser usado para "
489 "consultar dinamicamente uma biblioteca sobre qualquer subclasse GObject que "
490 "ele exporta. Ele salva informações sobre cada posição do objeto na "
491 "hierarquia de classe e sobre quaisquer propriedades GObject e sinais que ela "
492 "fornece."
493
494 #. (itstool) path: listitem/para
495 #: C/index.docbook:314
496 msgid ""
497 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
498 "needed in the past when GObject was still GtkObject inside GTK."
499 msgstr ""
500 "<application>gtkdoc-scanobj</application> não deve mais ser usado. Ele era "
501 "necessário no passado, quando GObject ainda era GtkObject dentro do GTK."
502
503 #. (itstool) path: listitem/para
504 #: C/index.docbook:322
505 msgid ""
506 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
507 "mkdb</application> turns the template files into XML files in the <filename "
508 "class=\"directory\">xml/</filename> subdirectory. If the source code "
509 "contains documentation for symbols, using the special comment blocks, it "
510 "gets merged in here. If there are no tmpl files used it only reads docs from "
511 "sources and introspection data."
512 msgstr ""
513 "<guilabel>Geração do XML e do HTML/PDF.</guilabel> <application>gtkdoc-mkdb</"
514 "application> transforma os arquivos modelos em arquivos XML no subdiretório "
515 "<filename class=\"directory\">xml/</filename>. Se o código-fonte contém "
516 "documentação para símbolos, usando os blocos de comentários especiais, ela é "
517 "mesclada aqui. Se não há arquivos tmpl sendo usados, ele apenas lê "
518 "documentos dos dados de introspecção e dos fontes."
519
520 #. (itstool) path: listitem/para
521 #: C/index.docbook:332
522 msgid ""
523 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
524 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
525 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
526 "document called <filename>&lt;package&gt;.pdf</filename>."
527 msgstr ""
528 "<application>gtkdoc-mkhtml</application> transforma os arquivos XML em "
529 "arquivos HTML no subdiretório <filename class=\"directory\">html/</"
530 "filename>. Da mesma forma, <application>gtkdoc-mkpdf</application> "
531 "transforma os arquivos XML em um documento PDF chamado "
532 "<filename>&lt;pacote&gt;.pdf</filename>."
533
534 #. (itstool) path: listitem/para
535 #: C/index.docbook:339
536 msgid ""
537 "Files in <filename class=\"directory\">xml/</filename> and <filename "
538 "class=\"directory\">html/</filename> directories are always overwritten. One "
539 "should never edit them directly."
540 msgstr ""
541 "Arquivos nos diretórios <filename class=\"directory\">xml/</filename> e "
542 "<filename class=\"directory\">html/</filename> são sempre sobrescritos. Não "
543 "devem ser editados manualmente."
544
545 #. (itstool) path: listitem/para
546 #: C/index.docbook:347
547 msgid ""
548 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
549 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
550 "run to fix up any cross-references between separate documents. For example, "
551 "the GTK documentation contains many cross-references to types documented in "
552 "the GLib manual."
553 msgstr ""
554 "<guilabel>Correção de referências cruzadas entre documentos.</guilabel> Após "
555 "a instalação dos arquivos HTML, <application>gtkdoc-fixxref</application> "
556 "pode ser executado para consertar referências cruzadas entre documentos "
557 "separados. Por exemplo, a documentação do GTK+ contém muitas referências "
558 "cruzadas a tipos documentados no manual do GLib. "
559
560 #. (itstool) path: listitem/para
561 #: C/index.docbook:356
562 msgid ""
563 "When creating the source tarball for distribution, <application>gtkdoc-"
564 "rebase</application> turns all external links into web-links. When "
565 "installing distributed (pregenerated) docs the same application will try to "
566 "turn links back to local links (where those docs are installed)."
567 msgstr ""
568 "Ao criar um tarball fonte para distribuição, <application>gtkdoc-rebase</"
569 "application> transforma todos os links externos em web-links. Ao instalar "
570 "documentações distribuídas (geradas previamente), o mesmo aplicativo vai "
571 "tentar transformar links de volta para links locais (onde aquelas "
572 "documentações estão instaladas)."
573
574 #. (itstool) path: sect1/title
575 #: C/index.docbook:369
576 msgid "Getting GTK-Doc"
577 msgstr "Obtendo GTK-Doc"
578
579 #. (itstool) path: sect2/title
580 #: C/index.docbook:372
581 msgid "Requirements"
582 msgstr "Requisitos"
583
584 #. (itstool) path: sect2/para
585 #: C/index.docbook:373
586 msgid ""
587 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
588 msgstr ""
589 "<guilabel>python 2/3</guilabel> – os scripts principais são escritos em "
590 "Python."
591
592 #. (itstool) path: sect2/para
593 #: C/index.docbook:376
594 msgid ""
595 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink "
596 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
597 msgstr ""
598 "<guilabel>xsltproc</guilabel> – o processador de xslt do libxslt <ulink "
599 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
600
601 #. (itstool) path: sect2/para
602 #: C/index.docbook:380
603 msgid ""
604 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink "
605 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
606 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
607 msgstr ""
608 "<guilabel>docbook-xsl</guilabel> – as folhas de estilo xsl de docbook <ulink "
609 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
610 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
611
612 #. (itstool) path: sect2/para
613 #: C/index.docbook:384
614 msgid ""
615 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
616 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
617 "examples"
618 msgstr ""
619 "Um dentre <guilabel>source-highlight</guilabel>, <guilabel>highlight</"
620 "guilabel> ou <guilabel>vim</guilabel> – opcional - usado para destaque de "
621 "sintaxe de exemplos"
622
623 #. (itstool) path: sect1/title
624 #: C/index.docbook:392
625 msgid "About GTK-Doc"
626 msgstr "Sobre GTK-Doc"
627
628 #. (itstool) path: sect1/para
629 #: C/index.docbook:394
630 msgid ""
631 "Historically GTK-Doc was used to generate template files from the sources "
632 "code. These template files could be used by developers to enter the API "
633 "documentation. This approach was rather inconvenient because it required to "
634 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
635 "possible to place all API information into source comments, which made the "
636 "template support obsolete. In version 1.26 template support has been removed."
637 msgstr ""
638 "Historicamente, o GTK-Doc foi usado para gerar arquivos de modelo a partir "
639 "do código-fonte. Esses arquivos de modelo poderiam ser usados pelos "
640 "desenvolvedores para inserir a documentação da API. Essa abordagem era "
641 "bastante inconveniente porque exigia manter os arquivos gerados sob controle "
642 "de versão. Desde o GTK-Doc 1.9, tornou-se possível colocar todas as "
643 "informações da API em comentários no fonte, o que tornou o suporte ao modelo "
644 "obsoleto. Na versão 1.26 suporte ao modelo foi removido."
645
646 #. (itstool) path: sect1/para
647 #: C/index.docbook:404 C/index.docbook:418
648 msgid "(FIXME)"
649 msgstr "(CORRIJA-ME)"
650
651 #. (itstool) path: sect1/para
652 #: C/index.docbook:408
653 msgid ""
654 "(authors, web pages, mailing list, license, future plans, comparison with "
655 "other similar systems.)"
656 msgstr ""
657 "(autores, páginas web, lista de discussão, licença, planos futuros, "
658 "comparação com outros sistemas similares.)"
659
660 #. (itstool) path: sect1/title
661 #: C/index.docbook:416
662 msgid "About this Manual"
663 msgstr "Sobre este manual"
664
665 #. (itstool) path: sect1/para
666 #: C/index.docbook:422
667 msgid "(who it is meant for, where you can get it, license)"
668 msgstr "(pra quem ele serve, onde você pode obtê-lo, licença)"
669
670 #. (itstool) path: chapter/title
671 #: C/index.docbook:431
672 msgid "Project Setup"
673 msgstr "Configurando o projeto"
674
675 #. (itstool) path: chapter/para
676 #: C/index.docbook:433
677 msgid ""
678 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
679 "into your project. The integration of GTK-Doc into a project includes the "
680 "following steps:"
681 msgstr ""
682 "Este capítulo descreve os passos necessários para integrar o GTK-Doc ao seu "
683 "projeto. A integração do GTK-Doc em um projeto inclui as seguintes etapas:"
684
685 #. (itstool) path: listitem/para
686 #: C/index.docbook:441
687 msgid ""
688 "Preparation of the directory structure and creating required configuration "
689 "files for your GTK-Doc documentation (see <link "
690 "linkend=\"settingup_docfiles\"> Setting up a skeleton documentation</link>)."
691 msgstr ""
692 "Preparação da estrutura de diretórios e criação dos arquivos de configuração "
693 "necessários para sua documentação do GTK-Doc (consulte <link "
694 "linkend=\"settingup_docfiles\">Preparando o esqueleto de uma documentação</"
695 "link>)."
696
697 #. (itstool) path: listitem/para
698 #: C/index.docbook:449
699 msgid ""
700 "Adjusting the build system to build your documentation using the GTK-Doc "
701 "tools. Multiple build systems are supported, in this manual we describe how "
702 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
703 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link "
704 "linkend=\"settingup_plain_makefiles\">plain Makefiles</link>."
705 msgstr ""
706 "Ajuste do sistema de compilação para compilar sua documentação usando as "
707 "ferramentas do GTK-Doc. Há suporte a vários sistemas de compilação, neste "
708 "manual descrevemos como integrar o GTK-Doc com <link "
709 "linkend=\"settingup_autotools\">Autotools</link>, <link "
710 "linkend=\"settingup_cmake\">CMake</link> e <link "
711 "linkend=\"settingup_plain_makefiles\">Makefiles simples</link>."
712
713 #. (itstool) path: listitem/para
714 #: C/index.docbook:459
715 msgid ""
716 "Adding GTK-Doc specific files to version control and deciding which files to "
717 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
718 "control systems</link>)."
719 msgstr ""
720 "Adição de arquivos específicos do GTK-Doc para o controle de versão e "
721 "decisão de quais arquivos ignorar (veja <link linkend=\"settingup_vcs\"> "
722 "Integração com sistemas de controle de versão</link>)."
723
724 #. (itstool) path: chapter/para
725 #: C/index.docbook:467
726 msgid ""
727 "The following sections assume we work on a project called <code>meep</code>. "
728 "This project contains two packages (or modules), a library called "
729 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
730 msgstr ""
731 "As seções a seguir presumem que trabalhamos em um projeto chamado "
732 "<code>meep</code>. Este projeto contém dois pacotes (ou módulos), uma "
733 "biblioteca chamada <code>libmeep</code> e um aplicativo de usuário final "
734 "chamado <code>meeper</code>."
735
736 #. (itstool) path: sect1/title
737 #: C/index.docbook:476
738 msgid "Setting up a skeleton documentation"
739 msgstr "Preparando o esqueleto de uma documentação"
740
741 #. (itstool) path: sect1/para
742 #: C/index.docbook:478
743 msgid ""
744 "A common convention is to place documentation into a folder called "
745 "<code>docs</code> inside your top-level project directory. We usually "
746 "distinguish between <emphasis>reference documentation</emphasis> intended "
747 "for developers and an <emphasis>user manual</emphasis> intended for end-"
748 "users. Again the convention is to have separate folders for both. We usually "
749 "place the reference documentation in a folder named <code>reference</code> "
750 "and the end-user manual in a folder named <code>help</code> as. According to "
751 "the above convention the documentation for our <code>libmeep</code> package "
752 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
753 "just one library or application the documentation could also be placed "
754 "directly into <code>docs/reference</code>. It is not mandatory to use the "
755 "above convention, but if you choose to use a different directory structure "
756 "you must adjust your build system configuration to match your directory "
757 "structure."
758 msgstr ""
759 "Uma convenção comum é colocar a documentação em uma pasta chamada "
760 "<code>docs</code> dentro do seu diretório de projeto de nível superior. "
761 "Costumamos distinguir entre a <emphasis>documentação de referência</"
762 "emphasis> destinada aos programadores e um <emphasis>manual do usuário</"
763 "emphasis> destinado aos usuários-finais. Novamente a convenção é ter pastas "
764 "separadas para ambos. Geralmente, colocamos a documentação de referência em "
765 "uma pasta chamada <code>reference</code> e o manual do usuário final em uma "
766 "pasta chamada <code>help</code>. De acordo com a convenção acima, a "
767 "documentação do nosso pacote <code>libmeep</code> seria colocada em: "
768 "<code>docs/reference/libmeep</code>. Para pacotes com apenas uma biblioteca "
769 "ou aplicativo, a documentação também pode ser colocada diretamente em "
770 "<code>docs/reference</code>. Não é obrigatório usar a convenção acima, mas "
771 "se você optar por usar uma estrutura de diretórios diferente, deverá ajustar "
772 "a configuração do sistema de compilação para que corresponda à estrutura do "
773 "diretório."
774
775 #. (itstool) path: example/title
776 #: C/index.docbook:509
777 msgid "Example directory structure of <emphasis>meep</emphasis> project"
778 msgstr ""
779 "Exemplo de estrutura de diretórios de projeto <emphasis>meep</emphasis>"
780
781 #. (itstool) path: example/programlisting
782 #: C/index.docbook:511
783 #, no-wrap
784 msgid ""
785 "\n"
786 "meep/\n"
787 " docs/\n"
788 " reference/ # reference documentation\n"
789 " libmeep/\n"
790 " meeper/\n"
791 " help/ # optional: user manual\n"
792 " meeper/\n"
793 " src/\n"
794 " libmeep/\n"
795 " meeper/\n"
796 msgstr ""
797 "\n"
798 "meep/\n"
799 " docs/\n"
800 " reference/ # documentação de referência\n"
801 " libmeep/\n"
802 " meeper/\n"
803 " help/ # opcional: manual de usuário\n"
804 " meeper/\n"
805 " src/\n"
806 " libmeep/\n"
807 " meeper/\n"
808
809 #. (itstool) path: sect1/para
810 #: C/index.docbook:503
811 msgid ""
812 "In the following sections we will assume a directory structure for our "
813 "<emphasis>meep</emphasis> project that uses the above conventions. "
814 "<_:example-1/>"
815 msgstr ""
816 "Nas seções a seguir, vamos presumir uma estrutura de diretórios para o nosso "
817 "projeto <emphasis>meep</emphasis> que usa as convenções acima. <_:example-1/>"
818
819 #. (itstool) path: sect1/title
820 #: C/index.docbook:528
821 msgid "Integration with Autotools"
822 msgstr "Integração com Autotools"
823
824 #. (itstool) path: sect1/para
825 #: C/index.docbook:529
826 msgid ""
827 "Integration of GTK-Doc into an autotools-based build system requires the "
828 "following steps:"
829 msgstr ""
830 "A integração do GTK-Doc em um sistema de compilação baseado em autotools "
831 "requer as seguintes etapas:"
832
833 #. (itstool) path: listitem/para
834 #: C/index.docbook:535
835 msgid ""
836 "Ensure that <application>gtkdocize</application> is run once before the "
837 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
838 "script is present, adjust it to check for GTK-Doc and add a call to "
839 "<application>gtkdocize</application>."
840 msgstr ""
841 "Certificar-se de que <application>gtkdocize</application> seja executado uma "
842 "vez antes do script <filename>configure</filename>. Se um script "
843 "<filename>autogen.sh</filename> estiver presente, ajuste-o para verificar o "
844 "GTK-Doc e adicione uma chamada ao <application>gtkdocize</application>."
845
846 #. (itstool) path: listitem/para
847 #: C/index.docbook:543
848 msgid ""
849 "The main purpose of <application>gtkdocize</application> is to make the "
850 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
851 "filename> macro definition file available to the build system, either by "
852 "copying or linking it into the project."
853 msgstr ""
854 "O principal objetivo do <application>gtkdocize</application> é fazer com que "
855 "o arquivo Makefile <filename>gtk-doc.make</filename> e o arquivo de "
856 "definição de macro <filename>gtk-doc.m4</filename> estejam disponíveis para "
857 "a compilação sistema, seja copiando ou vinculando-o ao projeto."
858
859 #. (itstool) path: listitem/para
860 #: C/index.docbook:552
861 msgid ""
862 "Add the necessary <application>autoconf</application> macros to "
863 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
864 "allow configuration of GTK-Doc via the generated <filename>configure</"
865 "filename> script."
866 msgstr ""
867 "Adicionar as macros <application>autoconf</application> necessárias ao "
868 "<filename>configure.ac</filename> para ativar o GTK-Doc em seu sistema de "
869 "compilação para permitir a configuração do GTK-Doc através do script "
870 "<filename>configure</filename> gerado."
871
872 #. (itstool) path: listitem/para
873 #: C/index.docbook:558
874 msgid ""
875 "Among others with registers the <code>--enable-gtk-doc</code> option with "
876 "the <filename>configure</filename> script."
877 msgstr ""
878 "Entre outros, registra a opção <code>--enable-gtk-doc</code> com o script "
879 "<filename>configure</filename>."
880
881 #. (itstool) path: listitem/para
882 #: C/index.docbook:564
883 msgid ""
884 "Create an <application>automake</application> script for each application or "
885 "library in your project. In the example used in this documentation this step "
886 "applies to both <code>meeper</code> and <code>libmeep</code>."
887 msgstr ""
888 "Criar um script <application>automake</application> para cada aplicativo ou "
889 "biblioteca em seu projeto. No exemplo usado nesta documentação, esta etapa "
890 "se aplica tanto a <code>meeper</code> quanto a <code>libmeep</code>."
891
892 #. (itstool) path: sect1/para
893 #: C/index.docbook:573
894 msgid ""
895 "In the following sections, we will perform the above steps in reverse order. "
896 "We start with the <application>automake</application> scripts and work our "
897 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
898 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
899 "build the documentation."
900 msgstr ""
901 "Nas seções a seguir, executaremos as etapas acima na ordem inversa. "
902 "Começamos com os scripts <application>automake</application> e vamos "
903 "trabalhando até o <filename>configure.ac</filename> e <filename>autogen.sh</"
904 "filename>. Então, mostramos como habilitar o Gtk-Doc no sistema de "
905 "compilação e como compilar a documentação."
906
907 #. (itstool) path: sect2/title
908 #: C/index.docbook:583
909 msgid "Integration with automake"
910 msgstr "Integração com automake"
911
912 #. (itstool) path: sect2/para
913 #: C/index.docbook:585
914 msgid ""
915 "First copy the <filename>Makefile.am</filename> from the <filename "
916 "class=\"directory\">examples</filename> sub-directory of the <ulink "
917 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/"
918 "Makefile.am\"> gtkdoc-sources</ulink> to your project's reference "
919 "documentation directory (e.g. <filename class=\"directory\">docs/reference/"
920 "&lt;package&gt;</filename>). A local copy should be available under e.g. "
921 "<filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If "
922 "you have multiple packages repeat this for each one."
923 msgstr ""
924 "Primeiro copie o <filename>Makefile.am</filename> do subdiretório do "
925 "<filename class=\"directory\">exemplo</filename> do <ulink url=\"https://"
926 "gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-"
927 "sources</ulink> para o diretório da documentação de referência do seu "
928 "projeto (por exemplo, <filename class=\"directory\">./docs/reference/"
929 "&lt;pacote&gt;</filename>). Uma cópia local deveria estar disponível sob, "
930 "por exemplo, <filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</"
931 "filename>. Se você tiver múltiplos pacotes de documentação, repita isso para "
932 "cada um."
933
934 #. (itstool) path: note/simpara
935 #: C/index.docbook:598
936 msgid ""
937 "Do not forget to add each <filename>Makefile.am</filename> to the "
938 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
939 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
940 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
941 "filename> to <function>AC_CONFIG_FILES</function>."
942 msgstr ""
943 "Não se esqueça de adicionar cada <filename>Makefile.am</filename> à macro "
944 "<function>AC_CONFIG_FILES</function> em <filename>configure.ac</filename>. "
945 "Para <filename>docs/reference/libmeep/Makefile.am</filename> você precisará "
946 "adicionar a entrada <filename>docs/reference/libmeep/Makefile</filename> "
947 "para <function>AC_CONFIG_FILES</function>."
948
949 #. (itstool) path: example/title
950 #: C/index.docbook:610
951 msgid "Example directory structure with <filename>Makefiles.am</filename>"
952 msgstr ""
953 "Exemplo de estrutura de diretório com <filename>Makefiles.am</filename>"
954
955 #. (itstool) path: example/programlisting
956 #: C/index.docbook:613
957 #, no-wrap
958 msgid ""
959 "\n"
960 "meep/\n"
961 " docs/\n"
962 " reference/ # reference documentation\n"
963 " libmeep/\n"
964 " Makefile.am\n"
965 " meeper/\n"
966 " Makefile.am\n"
967 " help/ # optional: user manual\n"
968 " meeper/\n"
969 " src/\n"
970 " libmeep/\n"
971 " meeper/\n"
972 msgstr ""
973 "\n"
974 "meep/\n"
975 " docs/\n"
976 " reference/ # documentação de referência\n"
977 " libmeep/\n"
978 " Makefile.am\n"
979 " meeper/\n"
980 " Makefile.am\n"
981 " help/ # opcional: manual de usuário\n"
982 " meeper/\n"
983 " src/\n"
984 " libmeep/\n"
985 " meeper/\n"
986
987 #. (itstool) path: sect2/para
988 #: C/index.docbook:629
989 msgid ""
990 "Next, you need to customize the copied Makefiles and provide values for the "
991 "various parameters in each <filename>Makefile.am</filename>. All settings "
992 "have a comment above them that describes their purpose and how to customize "
993 "the setting. Most settings are used to supply extra flags to the respective "
994 "tools to which they apply. Every tool has a variable of the form "
995 "<option>&lt;TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-"
996 "mkhtml</application> has an option named <code>MKHTML_OPTIONS</code>). All "
997 "the tools support <option>--help</option> to list the supported options."
998 msgstr ""
999 "Em seguida, você precisa personalizar os Makefiles copiados e fornecer "
1000 "valores para os vários parâmetros em cada <filename>Makefile.am</filename>. "
1001 "Todas as configurações têm um comentário sobre elas que descreve seu "
1002 "propósito e como personalizar a configuração. A maioria das configurações "
1003 "são usadas para fornecer opções extras para as respectivas ferramentas às "
1004 "quais elas se aplicam. Cada ferramenta tem uma variável na forma "
1005 "<option>&lt;NOME-FERRAMENTA&gt;_OPTIONS</option> (por exemplo, a ferramenta "
1006 "<application>gtkdoc-mkhtml</application> tem uma opção chamada "
1007 "<code>MKHTML_OPTIONS</code>). Todas as ferramentas têm suporte a <option>--"
1008 "help</option> pra listar os parâmetros disponíveis."
1009
1010 #. (itstool) path: listitem/para
1011 #: C/index.docbook:653
1012 msgid ""
1013 "<option>DOC_MODULE</option> is used to provide the name of the package that "
1014 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
1015 msgstr ""
1016 "<option>DOC_MODULE</option> é usado para fornecer o nome do pacote que está "
1017 "sendo documentado (por exemplo, <code>meeper</code> ou <code>libmeep</code>)."
1018
1019 #. (itstool) path: listitem/para
1020 #: C/index.docbook:660
1021 msgid ""
1022 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
1023 "directory which GTK-Doc searches for your API documentation. This will "
1024 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
1025 "directory of that directory."
1026 msgstr ""
1027 "<option>DOC_SOURCE_DIR</option> é usado para especificar a localização do "
1028 "diretório fonte que o GTK-Doc pesquisa na documentação da API. Isso "
1029 "geralmente será <code>DOC_SOURCE_DIR=$(top_srcdir)/src </code> ou um "
1030 "subdiretório desse diretório."
1031
1032 #. (itstool) path: listitem/para
1033 #: C/index.docbook:673
1034 msgid ""
1035 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
1036 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=$"
1037 "(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
1038 "the matched files change."
1039 msgstr ""
1040 "<option>HFILE_GLOB</option> e <option>CFILE_GLOB</option> são usados para "
1041 "dependências. Cada opção pega um arquivo glob (por exemplo, "
1042 "<code>HFILE_GLOB=$(top_srcdir)/src/*.c</code>). A documentação será "
1043 "recompilada se qualquer um dos arquivos correspondentes for alterado."
1044
1045 #. (itstool) path: listitem/para
1046 #: C/index.docbook:685
1047 msgid ""
1048 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
1049 "include when scanning for API documentation, which are not found under "
1050 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1051 "extra.h</code>)."
1052 msgstr ""
1053 "<option>EXTRA_HFILES</option> permite especificar arquivos de cabeçalho "
1054 "extras para incluir ao verificar a documentação da API, que não são "
1055 "encontrados em <code>DOC_SOURCE_DIR</code> (por exemplo, <code>EXTRA_HFILES=$"
1056 "(top_srcdir}/contrib/extra.h</code>)."
1057
1058 #. (itstool) path: listitem/para
1059 #: C/index.docbook:695
1060 msgid ""
1061 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
1062 "to ignore when scanning for API documentation. Use the basename of the file "
1063 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1064 "private_code_folder</code>)."
1065 msgstr ""
1066 "<option>IGNORE_HFILES</option> permite especificar arquivos ou diretórios de "
1067 "cabeçalho a serem ignorados ao verificar a documentação da API. Use o nome "
1068 "de base do arquivo ou diretório (por exemplo, <code>IGNORE_HFILES=gtkdebug.h "
1069 "gtkintl.h private_code_folder</code>)."
1070
1071 #. (itstool) path: listitem/para
1072 #: C/index.docbook:705
1073 msgid ""
1074 "<option>HTML_IMAGES</option> allows to specify images files which will be "
1075 "copied into the <filename>html/</filename> directory of the generated "
1076 "documentation. If your API documentation includes any images they need to be "
1077 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1078 "stock_about_24.png</code>)."
1079 msgstr ""
1080 "<option>HTML_IMAGES</option> permite especificar arquivos de imagens que "
1081 "serão copiados para o diretório <filename>html/</filename> da documentação "
1082 "gerada. Se a documentação da API incluir imagens, elas precisam ser "
1083 "adicionadas a essa opção (por exemplo, <code>HTML_IMAGES=$(top_srcdir)/gtk/"
1084 "stock-icons/stock_about_24.png</code>)."
1085
1086 #. (itstool) path: listitem/para
1087 #: C/index.docbook:718
1088 msgid ""
1089 "<option>content_files</option> allows to specify extra files that are "
1090 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
1091 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1092 msgstr ""
1093 "<option>content_files</option> permite especificar arquivos extras incluídos "
1094 "por <code>$(DOC_MAIN_SGML_FILE)</code> (por exemplo, "
1095 "<code>content_files=running.xml building.xml changes-2.0.xml</code>)."
1096
1097 #. (itstool) path: listitem/para
1098 #: C/index.docbook:729
1099 msgid ""
1100 "<option>expand_content_files</option> allows to specify files where "
1101 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
1102 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
1103 msgstr ""
1104 "<option>expand_content_files</option> permite especificar arquivos onde as "
1105 "<emphasis>abreviaturas gtk-doc</emphasis> como <code>#GtkWidget</code> são "
1106 "expandidas (por exemplo, <code>expand_content_files=running.xml</code>)."
1107
1108 #. (itstool) path: sect2/para
1109 #: C/index.docbook:647
1110 msgid ""
1111 "The following list explains the most relevant options. Check the example "
1112 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1113 msgstr ""
1114 "A lista a seguir explica as opções mais relevantes. Verifique o exemplo "
1115 "<filename>Makefile.am</filename> para opções adicionais. <_:itemizedlist-1/>"
1116
1117 #. (itstool) path: sect2/title
1118 #: C/index.docbook:744
1119 msgid "Integration with autoconf"
1120 msgstr "Integração com autoconf"
1121
1122 #. (itstool) path: sect2/para
1123 #: C/index.docbook:746
1124 msgid ""
1125 "Integration with <application>autoconf</application> is very simple and "
1126 "includes one required step and an additional optional (but recommended) "
1127 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
1128 "to your <filename>configure.ac</filename> script. This registers several "
1129 "configure options to enable GTK-Doc and allows you to set default arguments "
1130 "for <application>gtkdocize</application>."
1131 msgstr ""
1132 "A integração com <application>autoconf</application> é muito simples e "
1133 "inclui uma etapa obrigatória e uma etapa adicional opcional (mas "
1134 "recomendada). O primeiro passo é adicionar a macro <function>GTK_DOC_CHECK</"
1135 "function> ao seu script <filename>configure.ac</filename>. Isso registra "
1136 "várias opções de configuração para habilitar o GTK-Doc e permite definir "
1137 "argumentos padrão para <application>gtkdocize</application>."
1138
1139 #. (itstool) path: warning/simpara
1140 #: C/index.docbook:758
1141 msgid ""
1142 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
1143 "macro must start at the beginning of the line and should not start with "
1144 "whitespace."
1145 msgstr ""
1146 "Certifique-se de que a macro <code>GTK_DOC_CHECK</code> não esteja recuada. "
1147 "A macro deve começar no início da linha e não deve começar com espaço em "
1148 "branco."
1149
1150 #. (itstool) path: sect2/para
1151 #: C/index.docbook:765
1152 msgid ""
1153 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1154 "<filename>configure.ac</filename>. This is not required but helps "
1155 "<application>gtkdocize</application> to automatically copy the macro "
1156 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1157 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1158 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
1159 "to explicitly tell the <application>aclocal</application> tool where to find "
1160 "the macro definition file."
1161 msgstr ""
1162 "O segundo passo é adicionar o <code>AC_CONFIG_MACRO_DIR(m4)</code> ao seu "
1163 "<filename>configure.ac</filename>. Isso não é necessário, mas ajuda o "
1164 "<application>gtkdocize</application> a copiar automaticamente a definição da "
1165 "macro (por exemplo, <filename>gtk-doc.m4</filename>) que contém a macro "
1166 "<function>GTK_DOC_CHECK</function> para o diretório de macro do seu projeto. "
1167 "Sem isso, a macro GTK_DOC_CHECK pode não ser encontrada e você precisaria "
1168 "informar explicitamente à ferramenta <application>aclocal</application> onde "
1169 "encontrar o arquivo de definição de macro."
1170
1171 #. (itstool) path: example/title
1172 #: C/index.docbook:778
1173 msgid "Minimal integration with autoconf"
1174 msgstr "Integração mínima com autoconf"
1175
1176 #. (itstool) path: example/programlisting
1177 #: C/index.docbook:779
1178 #, no-wrap
1179 msgid ""
1180 "\n"
1181 "# recommended: set m4 directory\n"
1182 "AC_CONFIG_MACRO_DIR(m4)\n"
1183 "# optional: register gtk-doc in configure\n"
1184 "GTK_DOC_CHECK([1.28])\n"
1185 msgstr ""
1186 "\n"
1187 "# recomendado: defina o diretório m4\n"
1188 "AC_CONFIG_MACRO_DIR(m4)\n"
1189 "# opcional: registre gtk-doc no configure\n"
1190 "GTK_DOC_CHECK([1.28])\n"
1191
1192 #. (itstool) path: example/title
1193 #: C/index.docbook:794
1194 msgid "Integration with optional gtk-doc dependency"
1195 msgstr "Integração com dependência opcional do gtk-doc"
1196
1197 #. (itstool) path: example/programlisting
1198 #: C/index.docbook:795
1199 #, no-wrap
1200 msgid ""
1201 "\n"
1202 "m4_ifdef([GTK_DOC_CHECK], [\n"
1203 "# recommended: set m4 directory\n"
1204 "AC_CONFIG_MACRO_DIR(m4)\n"
1205 "# optional: register gtk-doc in configure\n"
1206 "GTK_DOC_CHECK([1.28])\n"
1207 "],[\n"
1208 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1209 "])\n"
1210 msgstr ""
1211 "\n"
1212 "m4_ifdef([GTK_DOC_CHECK], [\n"
1213 "# recomendado: defina diretório m4\n"
1214 "AC_CONFIG_MACRO_DIR(m4)\n"
1215 "# opcional: registre gtk-doc no configure\n"
1216 "GTK_DOC_CHECK([1.28])\n"
1217 "],[\n"
1218 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1219 "])\n"
1220
1221 #. (itstool) path: sect2/para
1222 #: C/index.docbook:788
1223 msgid ""
1224 "The above example works, but will require all developers to have gtk-doc "
1225 "installed. A better way is to make building the documentation optional as "
1226 "shown in the next example: <_:example-1/>"
1227 msgstr ""
1228 "O exemplo acima funciona, mas exigirá que todos os desenvolvedores tenham o "
1229 "gtk-doc instalado. Uma maneira melhor é tornar a documentação opcional, "
1230 "conforme mostrado no próximo exemplo: <_:example-1/>"
1231
1232 #. (itstool) path: sect2/para
1233 #: C/index.docbook:808
1234 msgid ""
1235 "The first argument is used to check for the Gtk-Doc version at configure "
1236 "time. The 2nd, optional argument is used by <application>gtkdocize</"
1237 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
1238 "configure switches:"
1239 msgstr ""
1240 "O primeiro argumento é usado para verificar a versão do Gtk-Doc em tempo de "
1241 "compilação. O segundo argumento é opcional, sendo usado por "
1242 "<application>gtkdocize</application>. A macro <symbol>GTK_DOC_CHECK</symbol> "
1243 "também adiciona várias opções de configuração:"
1244
1245 #. (itstool) path: listitem/para
1246 #: C/index.docbook:817
1247 msgid "--with-html-dir=PATH : path to installed docs"
1248 msgstr "--with-html-dir=CAMINHO : caminho para as documentações instaladas"
1249
1250 #. (itstool) path: listitem/para
1251 #: C/index.docbook:818
1252 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1253 msgstr "--enable-gtk-doc : usa gtk-doc para compilar documentação [padrão=não]"
1254
1255 #. (itstool) path: listitem/para
1256 #: C/index.docbook:819
1257 msgid ""
1258 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1259 msgstr ""
1260 "--enable-gtk-doc-html : compila documentação em formato html [padrão=sim]"
1261
1262 #. (itstool) path: listitem/para
1263 #: C/index.docbook:820
1264 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1265 msgstr ""
1266 "--enable-gtk-doc-pdf : compila documentação em formato pdf [padrão=não]"
1267
1268 #. (itstool) path: important/para
1269 #: C/index.docbook:824
1270 msgid ""
1271 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
1272 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
1273 "Otherwise pregenerated documentation is installed (which makes sense for "
1274 "users but not for developers)."
1275 msgstr ""
1276 "GTK-Doc está desabilitado por padrão! Lembre-se de passar a opção "
1277 "<option>\"--enable-gtk-doc\"</option> à próxima execução do "
1278 "<filename>configure</filename>. Do contrário, uma documentação gerada "
1279 "previamente é instalada (o que faz sentido para usuários, mas não para "
1280 "desenvolvedores)."
1281
1282 #. (itstool) path: sect2/para
1283 #: C/index.docbook:832
1284 msgid ""
1285 "After all changes to <filename>configure.ac</filename> are made, update the "
1286 "<filename>configure</filename> file. This can be done by re-running "
1287 "<code>autogen.sh</code>."
1288 msgstr ""
1289 "Após todas as alterações do <filename>configure.ac</filename> serem feitas, "
1290 "atualize o arquivo <filename>configure</filename>. Isso pode ser feito "
1291 "executando novamente <code>autogen.sh</code>."
1292
1293 #. (itstool) path: sect2/title
1294 #: C/index.docbook:840
1295 msgid "Integration with autogen"
1296 msgstr "Integração com autogen"
1297
1298 #. (itstool) path: sect2/para
1299 #: C/index.docbook:842
1300 msgid ""
1301 "Most projects will have an <filename>autogen.sh</filename> script to setup "
1302 "the build infrastructure after the project was checked out from a version "
1303 "control system (such as git or svn). GTK-Doc comes with a script called "
1304 "<application>gtkdocize</application> which can be used to copy the necessary "
1305 "files needed by Gtk-Doc to the source directory."
1306 msgstr ""
1307 "A maioria dos projetos tem um script <filename>autogen.sh</filename> para "
1308 "configurar a infraestrutura de compilação após o checkout do projeto sistema "
1309 "de um controle de versão (como git ou svn). GTK-Doc vêm com um script "
1310 "chamado <application>gtkdocize</application> que pode ser usado para copiar "
1311 "os arquivos necessários pelo Gtk-Doc para o diretório fonte."
1312
1313 #. (itstool) path: sect2/para
1314 #: C/index.docbook:850
1315 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1316 msgstr ""
1317 "Ele deve ser executado antes de autoreconf, autoheader, automake or autoconf."
1318
1319 #. (itstool) path: example/title
1320 #: C/index.docbook:855
1321 msgid "Running gtkdocize from autogen.sh"
1322 msgstr "Executando gtkdocize no autogen.sh"
1323
1324 #. (itstool) path: example/programlisting
1325 #: C/index.docbook:856
1326 #, no-wrap
1327 msgid ""
1328 "\n"
1329 "gtkdocize || exit 1\n"
1330 msgstr ""
1331 "\n"
1332 "gtkdocize || exit 1\n"
1333
1334 #. (itstool) path: example/title
1335 #: C/index.docbook:864
1336 msgid "Conditionally run gtkdocize from autogen.sh"
1337 msgstr "Executa condicionalmente gtkdocize no autogen.sh"
1338
1339 #. (itstool) path: example/programlisting
1340 #: C/index.docbook:865
1341 #, no-wrap
1342 msgid ""
1343 "\n"
1344 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1345 "if test $? -ne 0; then\n"
1346 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1347 "else\n"
1348 " $GTKDOCIZE || exit 1\n"
1349 "fi\n"
1350 msgstr ""
1351 "\n"
1352 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1353 "if test $? -ne 0; then\n"
1354 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1355 "else\n"
1356 " $GTKDOCIZE || exit 1\n"
1357 "fi\n"
1358
1359 #. (itstool) path: sect2/para
1360 #: C/index.docbook:876
1361 msgid ""
1362 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1363 "doc.make</filename> to your project root (or any directory specified by the "
1364 "<option>--docdir</option> option)."
1365 msgstr ""
1366 "Ao executar <application>gtkdocize</application>, ele copia <filename>gtk-"
1367 "doc.make</filename> para a raiz do seu projeto (ou qualquer diretório "
1368 "especificado pela opção <option>--docdir</option>)."
1369
1370 #. (itstool) path: sect2/para
1371 #: C/index.docbook:882
1372 msgid ""
1373 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1374 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1375 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1376 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1377 "<function>GTK_DOC_CHECK</function> macro."
1378 msgstr ""
1379 "<application>gtkdocize</application> verifica seu script "
1380 "<filename>configure.ac</filename> para <function>GTK_DOC_CHECK</function>. A "
1381 "macro <function>GTK_DOC_CHECK</function> pode ser usada para passar "
1382 "parâmetros extras para o script <application>gtkdocize</application>."
1383
1384 #. (itstool) path: sect2/para
1385 #: C/index.docbook:891
1386 msgid ""
1387 "Alternatively, additional arguments can also be passed to "
1388 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1389 "function> environment variable, or by directly specifying them to "
1390 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1391 msgstr ""
1392 "Alternativamente, argumentos adicionais também podem ser passados para "
1393 "<application>gtkdocsize</application> por meio da variável de ambiente "
1394 "<function>GTKDOCIZE_FLAGS</function> ou especificando-os diretamente ao "
1395 "<application>gtkdocsize</application> no <filename>autogen.sh</filename>."
1396
1397 #. (itstool) path: sect2/title
1398 #: C/index.docbook:902
1399 msgid "Executing GTK-Doc from the Build System"
1400 msgstr "Executando GTK-Doc a partir do sistema de compilação"
1401
1402 #. (itstool) path: sect2/para
1403 #: C/index.docbook:904
1404 msgid ""
1405 "After the previous steps it's time to run the build. First we need to rerun "
1406 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1407 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1408 "<filename>configure</filename> with this option afterwards."
1409 msgstr ""
1410 "Após as etapas anteriores, é hora de executar a compilação. Primeiro, nós "
1411 "queremos executar novamente o <filename>autogen.sh</filename>. Se este "
1412 "script executa o configure para você, então forneça a este a opção <option>--"
1413 "enable-gtk-doc</option>. Do contrário, execute manualmente "
1414 "<filename>configure</filename> com esta opção em seguida."
1415
1416 #. (itstool) path: sect2/para
1417 #: C/index.docbook:911
1418 msgid ""
1419 "The first make run generates several additional files in the doc-"
1420 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1421 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1422 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1423 msgstr ""
1424 "A primeira execução do make cria vários arquivos adicionais nos diretórios "
1425 "de documentação. Os importantes são: <filename>&lt;pacote&gt;.types</"
1426 "filename>, <filename>&lt;pacote&gt;-docs.xml</filename> (no passado, .sgml), "
1427 "<filename>&lt;pacote&gt;-sections.txt</filename>."
1428
1429 #. (itstool) path: example/title
1430 #: C/index.docbook:919
1431 msgid "Running the doc build"
1432 msgstr "Executando a compilação da documentação"
1433
1434 #. (itstool) path: example/programlisting
1435 #: C/index.docbook:920
1436 #, no-wrap
1437 msgid ""
1438 "\n"
1439 "./autogen.sh --enable-gtk-doc\n"
1440 "make\n"
1441 msgstr ""
1442 "\n"
1443 "./autogen.sh --enable-gtk-doc\n"
1444 "make\n"
1445
1446 #. (itstool) path: sect2/para
1447 #: C/index.docbook:927
1448 msgid ""
1449 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1450 "index.html</filename>. With this initial setup you will only see a very "
1451 "simple document. The next chapter will teach you how to add API "
1452 "documentation to your code via special comment blocks. The Chapter "
1453 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1454 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1455 "template</link> to add additional chapters and sections to your "
1456 "documentation files."
1457 msgstr ""
1458 "Agora você pode apontar seu navegador para <filename>docs/reference/"
1459 "&lt;pacote&gt;/index.html </filename>. Com esta configuração inicial, você "
1460 "verá apenas um documento muito simples. O próximo capítulo ensinará como "
1461 "adicionar documentação da API ao seu código por meio de blocos de "
1462 "comentários especiais. O capítulo seguinte depois introduz <link "
1463 "linkend=\"metafiles\">arquivos adicionais</link> e mostra como editar o "
1464 "<link linkend=\"metafiles_master\">modelo mestre</link> para adicionar "
1465 "capítulos e seções adicionais aos seus arquivos de documentação."
1466
1467 #. (itstool) path: sect1/title
1468 #: C/index.docbook:943
1469 msgid "Integration with CMake build systems"
1470 msgstr "Integração com sistemas de compilação CMake"
1471
1472 #. (itstool) path: sect1/para
1473 #: C/index.docbook:945
1474 msgid ""
1475 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1476 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1477 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1478 "set in your <filename>CMakeLists.txt</filename> file."
1479 msgstr ""
1480 "GTK-Doc agora fornece um módulo <filename>GtkDocConfig.cmake</filename> (e o "
1481 "module <filename>GtkDocConfigVersion.cmake</filename> correspondente). Ele "
1482 "fornece um comando <literal>gtk_doc_add_module</literal> que você pode usar "
1483 "em seu arquivo <filename>CMakeLists.txt</filename>."
1484
1485 #. (itstool) path: example/title
1486 #: C/index.docbook:955
1487 msgid "Example of using GTK-Doc from CMake"
1488 msgstr "Exemplo de uso do GTK-Doc no CMake"
1489
1490 #. (itstool) path: example/programlisting
1491 #: C/index.docbook:956
1492 #, no-wrap
1493 msgid ""
1494 "\n"
1495 "find_package(GtkDoc 1.25 REQUIRED)\n"
1496 "\n"
1497 "# Create the doc-libmeep target.\n"
1498 "gtk_doc_add_module(\n"
1499 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1500 " XML meep-docs.xml\n"
1501 " LIBRARIES libmeep\n"
1502 ")\n"
1503 "\n"
1504 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1505 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1506 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1507 "\n"
1508 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1509 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1510 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1511 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1512 msgstr ""
1513 "\n"
1514 "find_package(GtkDoc 1.25 REQUIRED)\n"
1515 "\n"
1516 "# Cria o alvo doc-libmeep.\n"
1517 "gtk_doc_add_module(\n"
1518 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1519 " XML meep-docs.xml\n"
1520 " LIBRARIES libmeep\n"
1521 ")\n"
1522 "\n"
1523 "# Compila doc-libmeep como parte do alvo padrão. Sem isso, você precisaria\n"
1524 "# executar explicitamente algo como `make doc-libmeep` para compilar os\n"
1525 "# documentos.\n"
1526 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1527 "\n"
1528 "# Instala os documentos. (Isso presume que você está usando o módulo\n"
1529 "# GNUInstallDirs do CMake para definir a variável CMAKE_INSTALL_DOCDIR\n"
1530 "# corretamente).\n"
1531 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1532 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1533
1534 #. (itstool) path: sect1/para
1535 #: C/index.docbook:953
1536 msgid "The following example shows how to use this command. <_:example-1/>"
1537 msgstr "O exemplo a seguir mostra como usar este comando. <_:example-1/>"
1538
1539 #. (itstool) path: sect1/title
1540 #: C/index.docbook:980
1541 msgid "Integration with plain makefiles or other build systems"
1542 msgstr "Integração com makefiles simples ou outros sistemas de compilação"
1543
1544 #. (itstool) path: sect1/para
1545 #: C/index.docbook:982
1546 msgid ""
1547 "In the case one does not want to use automake and therefore <filename>gtk-"
1548 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1549 "in own makefiles (or other build tools)."
1550 msgstr ""
1551 "Neste caso, não se deseja usar o automake e, portanto, <filename>gtk-"
1552 "doc.mak</filename>. Será necessário chamar as ferramentas do gtkdoc na ordem "
1553 "correta nos makefiles devidos (ou outras ferramentas de compilação)."
1554
1555 #. (itstool) path: example/title
1556 #: C/index.docbook:989
1557 msgid "Documentation build steps"
1558 msgstr "Etapas de compilação da documentação"
1559
1560 #. (itstool) path: example/programlisting
1561 #: C/index.docbook:990
1562 #, no-wrap
1563 msgid ""
1564 "\n"
1565 "DOC_MODULE=meep\n"
1566 "// sources have changed\n"
1567 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1568 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1569 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1570 "// xml files have changed\n"
1571 "mkdir html\n"
1572 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1573 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1574 msgstr ""
1575 "\n"
1576 "DOC_MODULE=meep\n"
1577 "// fontes foram alterados\n"
1578 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir=&gt;\n"
1579 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1580 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1581 "// arquivos xml foram alterados \n"
1582 "mkdir html\n"
1583 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1584 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1585
1586 #. (itstool) path: sect1/para
1587 #: C/index.docbook:1004
1588 msgid ""
1589 "One will need to look at the <filename>Makefile.am</filename> and "
1590 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1591 msgstr ""
1592 "Será necessário olhar no <filename>Makefile.am</filename> e no <filename>gtk-"
1593 "doc.mak</filename> para obter as opções extras necessárias."
1594
1595 #. (itstool) path: sect1/title
1596 #: C/index.docbook:1011
1597 msgid "Integration with version control systems"
1598 msgstr "Integração com sistemas de controle de versão"
1599
1600 #. (itstool) path: sect1/para
1601 #: C/index.docbook:1013
1602 msgid ""
1603 "As a rule of thumb, it's the files you edit which should go under version "
1604 "control. For typical projects it's these files: "
1605 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-"
1606 "docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-"
1607 "sections.txt</filename>, <filename>Makefile.am</filename>."
1608 msgstr ""
1609 "Como uma regra de ouro, são aqueles arquivos que você edita que devem entrar "
1610 "no controle de versão. Para projetos normais, esses são os arquivos: "
1611 "<filename>&lt;pacote&gt;.types</filename>, <filename>&lt;pacote&gt;-"
1612 "docs.xml</filename> (no passado, .sgml), <filename>&lt;pacote&gt;-"
1613 "sections.txt</filename>, <filename>Makefile.am</filename>."
1614
1615 #. (itstool) path: sect1/para
1616 #: C/index.docbook:1021
1617 msgid ""
1618 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1619 "directories should not go under version control. Neither should any of the "
1620 "<filename>.stamp</filename> files."
1621 msgstr ""
1622 "Arquivos nos diretórios <filename>xml/</filename> e <filename>html/</"
1623 "filename> não devem entrar no controle de versão. Da mesma forma, não devem "
1624 "entrar arquivos <filename>.stamp</filename>."
1625
1626 #. (itstool) path: chapter/title
1627 #: C/index.docbook:1031
1628 msgid "Documenting the code"
1629 msgstr "Documentando o código"
1630
1631 #. (itstool) path: chapter/para
1632 #: C/index.docbook:1033
1633 msgid ""
1634 "GTK-Doc uses source code comment with a special syntax for code "
1635 "documentation. Further it retrieves information about your project structure "
1636 "from other sources. During the next section you will find all information "
1637 "about the syntax of the comments."
1638 msgstr ""
1639 "GTK-Doc usa comentários do código-fonte com uma sintaxe especial para "
1640 "documentação do código. Além disso, ele obtém informações sobre a estrutura "
1641 "do seu projeto a partir de outros fontes. Na próxima seção, você vai "
1642 "descobrir todas as informações sobre a sintaxe dos comentários."
1643
1644 #. (itstool) path: example/title
1645 #: C/index.docbook:1044 C/index.docbook:1070
1646 msgid "GTK-Doc comment block"
1647 msgstr "Bloco de comentário do GTK-Doc"
1648
1649 #. (itstool) path: example/programlisting
1650 #: C/index.docbook:1045
1651 #, no-wrap
1652 msgid ""
1653 "\n"
1654 "#ifndef __GTK_DOC_IGNORE__\n"
1655 "/* unparseable code here */\n"
1656 "#endif\n"
1657 msgstr ""
1658 "\n"
1659 "#ifndef __GTK_DOC_IGNORE__\n"
1660 "/* código não analisável aqui */\n"
1661 "#endif\n"
1662
1663 #. (itstool) path: chapter/para
1664 #: C/index.docbook:1040
1665 msgid ""
1666 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1667 "of receiving warnings from the scanner that look like a special case, one "
1668 "can hint GTK-Doc to skip over them. <_:example-1/>"
1669 msgstr ""
1670 "O verificador do GTK-Doc sabe lidar com a maioria dos cabeçalhos de C sem "
1671 "problemas. Caso se receba avisos (warnings) na varredura que pareça ser um "
1672 "caso especial, pode-se informar ao GTK-Doc para ignorá-los. <_:example-1/>"
1673
1674 #. (itstool) path: note/title
1675 #: C/index.docbook:1054
1676 msgid "Limitations"
1677 msgstr "Limitações"
1678
1679 #. (itstool) path: note/para
1680 #: C/index.docbook:1055
1681 msgid ""
1682 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1683 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1684 msgstr ""
1685 "Note que o GTK-Doc oferece suporte a <code>#ifndef(__GTK_DOC_IGNORE__)</"
1686 "code>, mas não a <code>#if !defined(__GTK_DOC_IGNORE__)</code> ou outras "
1687 "combinações."
1688
1689 #. (itstool) path: sect1/title
1690 #: C/index.docbook:1065
1691 msgid "Documentation comments"
1692 msgstr "Comentários de documentação"
1693
1694 #. (itstool) path: example/programlisting
1695 #: C/index.docbook:1071
1696 #, no-wrap
1697 msgid ""
1698 "\n"
1699 "/**\n"
1700 " * identifier:\n"
1701 " * documentation ...\n"
1702 " */\n"
1703 msgstr ""
1704 "\n"
1705 "/**\n"
1706 " * identificador:\n"
1707 " * documentação ...\n"
1708 " */\n"
1709
1710 #. (itstool) path: sect1/para
1711 #: C/index.docbook:1067
1712 msgid ""
1713 "A multiline comment that starts with an additional '*' marks a documentation "
1714 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1715 msgstr ""
1716 "Um comentário multilinha que comece com um “*” adicional marca um bloco de "
1717 "documentação que será processado pelas ferramentas do GTK-Doc. <_:example-1/>"
1718
1719 #. (itstool) path: sect1/para
1720 #: C/index.docbook:1080
1721 msgid ""
1722 "The 'identifier' is one line with the name of the item the comment is "
1723 "related to. The syntax differs a little depending on the item. (TODO add "
1724 "table showing identifiers)"
1725 msgstr ""
1726 "O “identificador” é uma linha com o nome do item ao qual o comentário está "
1727 "relacionado. A sintaxe difere um pouco dependendo do item."
1728
1729 #. (itstool) path: sect1/para
1730 #: C/index.docbook:1086
1731 msgid ""
1732 "The 'documentation' block is also different for each symbol type. Symbol "
1733 "types that get parameters such as functions or macros have the parameter "
1734 "description first followed by a blank line (just a '*'). Afterwards follows "
1735 "the detailed description. All lines (outside program listings and CDATA "
1736 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1737 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1738 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1739 msgstr ""
1740 "O bloco “documentação” também é diferente para cada tipo de símbolo. Tipos "
1741 "de símbolos que levam parâmetros, como funções e macros, têm a descrição de "
1742 "parâmetro começando com uma linha vazia (apenas com um “*”). Posteriormente, "
1743 "segue com a descrição detalhada. Todas as linhas (fora das listagens do "
1744 "programa e seções CDATA) contendo apenas um “ *” (espaço em branco e "
1745 "asterisco) são convertidas para quebras de parágrafos. Se você não quiser "
1746 "uma quebra de parágrafo, altere isso para “ * “ (espaço, asterisco, espaço e "
1747 "espaço). Isso é útil em textos pré-formatados (listagens de código)."
1748
1749 #. (itstool) path: listitem/para
1750 #: C/index.docbook:1103
1751 msgid ""
1752 "What it is: The name for a class or function can sometimes be misleading for "
1753 "people coming from a different background."
1754 msgstr ""
1755 "O que é: O nome de uma classe ou função pode, em alguns casos, levar a um "
1756 "entendimento equivocado pessoas com experiências diferentes."
1757
1758 #. (itstool) path: listitem/para
1759 #: C/index.docbook:1109
1760 msgid ""
1761 "What it does: Tell about common uses. Put it in relation with the other API."
1762 msgstr ""
1763 "O que ele faz: Fale sobre usos comuns. Coloque em relação com a outra API."
1764
1765 #. (itstool) path: tip/para
1766 #: C/index.docbook:1099
1767 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1768 msgstr "Ao documentar um código, descreva dois aspectos: <_:itemizedlist-1/>"
1769
1770 #. (itstool) path: listitem/para
1771 #: C/index.docbook:1124
1772 msgid "Use function() to refer to functions or macros which take arguments."
1773 msgstr ""
1774 "Use function() para se referir às funções ou macros que levam argumentos."
1775
1776 #. (itstool) path: listitem/para
1777 #: C/index.docbook:1129
1778 msgid ""
1779 "Use @param to refer to parameters. Also use this when referring to "
1780 "parameters of other functions, related to the one being described."
1781 msgstr ""
1782 "Use @param para se referir a parâmetros. Também, use isso ao se referir a "
1783 "parâmetros de outras funções, relacionadas àquele sendo descrito."
1784
1785 #. (itstool) path: listitem/para
1786 #: C/index.docbook:1135
1787 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1788 msgstr "Use %constant para se referir a uma constante, ex.: %G_TRAVERSE_LEAFS."
1789
1790 #. (itstool) path: listitem/para
1791 #: C/index.docbook:1140
1792 msgid ""
1793 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1794 "macros which don't take arguments."
1795 msgstr ""
1796 "Use #symbol para se referir a outros tipos de símbolos, ex.: structs, enums "
1797 "e macros que não levam argumentos."
1798
1799 #. (itstool) path: listitem/para
1800 #: C/index.docbook:1146
1801 msgid "Use #Object::signal to refer to a GObject signal."
1802 msgstr "Use #Object::signal para se referir a um sinal de GObject."
1803
1804 #. (itstool) path: listitem/para
1805 #: C/index.docbook:1151
1806 msgid "Use #Object:property to refer to a GObject property."
1807 msgstr "Use #Object:property para se referir a uma propriedade de GObject."
1808
1809 #. (itstool) path: listitem/para
1810 #: C/index.docbook:1156
1811 msgid ""
1812 "Use #Struct.field to refer to a field inside a structure and "
1813 "#GObjectClass.foo_bar() to refer to a vmethod."
1814 msgstr ""
1815 "Use #Struct.field para se referir a um campo dentro de uma estrutura e "
1816 "#GObjectClass.foo_bar() para se referir a um vmethod."
1817
1818 #. (itstool) path: sect1/para
1819 #: C/index.docbook:1118
1820 msgid ""
1821 "One advantage of hyper-text over plain-text is the ability to have links in "
1822 "the document. Writing the correct markup for a link can be tedious though. "
1823 "GTK-Doc comes to help by providing several useful abbreviations. "
1824 "<_:itemizedlist-1/>"
1825 msgstr ""
1826 "Uma vantagem do hipertexto de texto simples é a habilidade de ter links no "
1827 "documento. Porém, escrever a marcação correta para cada link pode ser "
1828 "entediante. GTK-Doc vem para ajudar fornecendo abreviações úteis. "
1829 "<_:itemizedlist-1/>"
1830
1831 #. (itstool) path: tip/para
1832 #: C/index.docbook:1165
1833 msgid ""
1834 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1835 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1836 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", "
1837 "\"&amp;commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape "
1838 "them with a backslash '\\'."
1839 msgstr ""
1840 "Se você precisar usar os caracteres especiais “&lt;”, “&gt;”, “()”, “@”, “%” "
1841 "ou “#” em sua documentação sem GTK-Doc alterando-os, você pode usar as "
1842 "entidades XML “&amp;lt;”, “&amp;gt;”, “&amp;lpar;”, “&amp;rpar;”, "
1843 "“&amp;commat;”, “&amp;percnt;” e “&amp;num;”, respectivamente, ou escapá-los "
1844 "com uma contrabarra “\\”."
1845
1846 #. (itstool) path: sect1/para
1847 #: C/index.docbook:1174
1848 msgid ""
1849 "DocBook can do more than just links. One can also have lists, examples, "
1850 "headings, and images. As of version 1.20, the preferred way is to use a "
1851 "subset of the basic text formatting syntax called <ulink url=\"http://"
1852 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1853 "versions any documentation that includes Markdown will be rendered as is. "
1854 "For example, list items will appear as lines starting with a dash."
1855 msgstr ""
1856 "DocBook pode fazer mais do que apenas links. Ele também pode ter listas, "
1857 "exemplos, títulos e imagens. A partir da versão 1.20, a forma preferível é "
1858 "usar um subconjunto de sintaxe de formatação de texto básica chamada <ulink "
1859 "url=\"http://daringfireball.net/projects/markdown/\">Markdown</ulink>. Em "
1860 "versões mais antigas do GTK-Doc, qualquer documentação que inclui Markdown "
1861 "será renderizada como está. Por exemplo, itens de lista aparecerão como "
1862 "linhas começando com um traço."
1863
1864 #. (itstool) path: sect1/para
1865 #: C/index.docbook:1185
1866 msgid ""
1867 "While markdown is now preferred one can mix both. One limitation here is "
1868 "that one can use docbook xml within markdown, but markdown within docbook "
1869 "xml is not supported."
1870 msgstr ""
1871 "Enquanto markdown é agora preferível, é possível misturar ambos. Uma "
1872 "limitação aqui é que é possível usar docbook xml no markdown, mas não há "
1873 "suporte a markdown no docbook xml."
1874
1875 #. (itstool) path: sect1/para
1876 #: C/index.docbook:1191
1877 msgid ""
1878 "In older GTK-Doc releases, if you need support for additional formatting, "
1879 "you would need to enable the usage of docbook XML tags inside doc-comments "
1880 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1881 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1882 "filename>."
1883 msgstr ""
1884 "Em versões mais antigas do GTK-Doc, se você precisasse de suporte para "
1885 "formatação adicional, você precisaria de habilitar o uso de tags de XML de "
1886 "docbook dentro de comentários de documentação colocando <option>--xml-mode</"
1887 "option> (ou <option>--sgml-mode</option>) na variável <symbol>MKDB_OPTIONS</"
1888 "symbol> dentro de <filename>Makefile.am</filename>."
1889
1890 #. (itstool) path: example/title
1891 #: C/index.docbook:1200
1892 msgid "GTK-Doc comment block using Markdown"
1893 msgstr "Bloco de comentário do GTK-Doc usando Markdown"
1894
1895 #. (itstool) path: example/programlisting
1896 #: C/index.docbook:1201
1897 #, no-wrap
1898 msgid ""
1899 "\n"
1900 "/**\n"
1901 " * identifier:\n"
1902 " *\n"
1903 " * documentation paragraph ...\n"
1904 " *\n"
1905 " * # Sub Heading #\n"
1906 " *\n"
1907 " * ## Second Sub Heading\n"
1908 " *\n"
1909 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1910 " *\n"
1911 " * more documentation:\n"
1912 " *\n"
1913 " * - list item 1\n"
1914 " *\n"
1915 " * Paragraph inside a list item.\n"
1916 " *\n"
1917 " * - list item 2\n"
1918 " *\n"
1919 " * 1. numbered list item\n"
1920 " *\n"
1921 " * 2. another numbered list item\n"
1922 " *\n"
1923 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1924 " *\n"
1925 " * ![an inline image](plot-result.png)\n"
1926 " *\n"
1927 " * [A link to the heading anchor above][heading-two]\n"
1928 " *\n"
1929 " * A C-language example:\n"
1930 " * |[&lt;!-- language=\"C\" --&gt;\n"
1931 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1932 " * ]|\n"
1933 " */\n"
1934 msgstr ""
1935 "\n"
1936 "/**\n"
1937 " * identificador:\n"
1938 " *\n"
1939 " * parágrafo de documentação ...\n"
1940 " *\n"
1941 " * # Subtítulo #\n"
1942 " *\n"
1943 " * ## Segundo subtítulo\n"
1944 " *\n"
1945 " * # Subtítulo com um link âncora # {#titulo-dois}\n"
1946 " *\n"
1947 " * mais documentação:\n"
1948 " *\n"
1949 " * - item 1 da lista\n"
1950 " *\n"
1951 " * Parágrafo dentro de um item de lista.\n"
1952 " *\n"
1953 " * - item 2 da lista\n"
1954 " *\n"
1955 " * 1. item numerado da lista\n"
1956 " *\n"
1957 " * 2. outro item numerado da lista\n"
1958 " *\n"
1959 " * Outro parágrafo. [Um link para o site do GNOME](http://www.gnome.org/)\n"
1960 " *\n"
1961 " * ![uma imagem embutida](plot-result.png)\n"
1962 " *\n"
1963 " * [Um link para um título acima][titulo-dois]\n"
1964 " *\n"
1965 " * Um exemplo em linguagem C:\n"
1966 " * |[&lt;!-- language=\"C\" --&gt;\n"
1967 " * GtkWidget *label = gtk_label_new (\"Esplêndido!\");\n"
1968 " * ]|\n"
1969 " */\n"
1970
1971 #. (itstool) path: sect1/para
1972 #: C/index.docbook:1240
1973 msgid ""
1974 "More examples of what markdown tags are supported can be found in the <ulink "
1975 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
1976 "Documentation Markdown Syntax Reference</ulink>."
1977 msgstr ""
1978 "Mais exemplos de quais tags de markdown tags há suporte podem ser "
1979 "encontrados na <ulink url=\"https://wiki.gnome.org/Projects/GTK/"
1980 "DocumentationSyntax/Markdown\">Referência de sintaxe de markdown de "
1981 "documentação GTK</ulink>."
1982
1983 #. (itstool) path: tip/para
1984 #: C/index.docbook:1246
1985 msgid ""
1986 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
1987 "cannot write documentation for static symbols. Nevertheless it is good to "
1988 "comment those symbols too. This helps other developers to understand your "
1989 "code. Therefore we recommend to comment these using normal comments (without "
1990 "the 2nd '*' in the first line). If later the function needs to be made "
1991 "public, all one needs to do is to add another '*' in the comment block and "
1992 "insert the symbol name at the right place inside the sections file."
1993 msgstr ""
1994 "Como já mencionado anteriormente, GTK-Doc serve para documentar API pública. "
1995 "Portanto, não é possível escrever documentação para símbolos estáticos. Não "
1996 "obstante, é bom comentar estes símbolos também. Isso ajuda outros "
1997 "desenvolvedores a entender seu código. Portanto, é recomendado comentá-los "
1998 "usando comentários normais (sem o segundo “*” na primeira linha). Se, "
1999 "posteriormente, a função precisar ser publicada, tudo que precisa ser feito "
2000 "é adicionar outro “*” no bloco de comentário e inserir o nome do símbolo no "
2001 "lugar correto do arquivo e seções."
2002
2003 #. (itstool) path: sect1/title
2004 #: C/index.docbook:1261
2005 msgid "Documenting sections"
2006 msgstr "Documentando seções"
2007
2008 #. (itstool) path: sect1/para
2009 #: C/index.docbook:1263
2010 msgid ""
2011 "Each section of the documentation contains information about one class or "
2012 "module. To introduce the component one can write a section block. The short "
2013 "description is also used inside the table of contents. All the @fields are "
2014 "optional."
2015 msgstr ""
2016 "Cada seção da documentação contém informações sobre uma classe ou um módulo. "
2017 "Para introduzir o componente, pode-se escrever um bloco de seção. A "
2018 "descrição curta também é usada dentro da tabela de conteúdo (sumário). Todos "
2019 "os @fields são opcionais."
2020
2021 #. (itstool) path: example/title
2022 #: C/index.docbook:1271
2023 msgid "Section comment block"
2024 msgstr "Bloco de comentário de sessão"
2025
2026 #. (itstool) path: example/programlisting
2027 #: C/index.docbook:1272
2028 #, no-wrap
2029 msgid ""
2030 "\n"
2031 "/**\n"
2032 " * SECTION:meepapp\n"
2033 " * @short_description: the application class\n"
2034 " * @title: Meep application\n"
2035 " * @section_id:\n"
2036 " * @see_also: #MeepSettings\n"
2037 " * @stability: Stable\n"
2038 " * @include: meep/app.h\n"
2039 " * @image: application.png\n"
2040 " *\n"
2041 " * The application class handles ...\n"
2042 " */\n"
2043 msgstr ""
2044 "\n"
2045 "/**\n"
2046 " * SECTION:meepapp\n"
2047 " * @short_description: A classe do aplicativo\n"
2048 " * @title: Aplicativo Meep\n"
2049 " * @section_id:\n"
2050 " * @see_also: #MeepSettings\n"
2051 " * @stability: Estável\n"
2052 " * @include: meep/app.h\n"
2053 " * @image: aplicativo.png\n"
2054 " *\n"
2055 " * A classe do aplicativo cuida de ...\n"
2056 " */\n"
2057
2058 #. (itstool) path: varlistentry/term
2059 #: C/index.docbook:1291
2060 msgid "SECTION:&lt;name&gt;"
2061 msgstr "SECTION:&lt;nome&gt;"
2062
2063 #. (itstool) path: listitem/para
2064 #: C/index.docbook:1293
2065 msgid ""
2066 "The name links the section documentation to the respective part in the "
2067 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
2068 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-"
2069 "sections.txt</filename> file."
2070 msgstr ""
2071 "O nome vincula a documentação da seção à respectiva parte do arquivo "
2072 "<filename>&lt;pacote&gt;-sections.txt</filename>. O nome informado aqui deve "
2073 "corresponder à tag &lt;FILE&gt; no arquivo <filename>&lt;pacote&gt;-"
2074 "sections.txt</filename>."
2075
2076 #. (itstool) path: varlistentry/term
2077 #: C/index.docbook:1302
2078 msgid "@short_description"
2079 msgstr "@short_description"
2080
2081 #. (itstool) path: listitem/para
2082 #: C/index.docbook:1304
2083 msgid ""
2084 "A one line description of the section, that later will appear after the "
2085 "links in the TOC and at the top of the section page."
2086 msgstr ""
2087 "Uma descrição de uma linha da sessão,que mais tarde aparecerá após os links "
2088 "no TOC (sumário) no topo da página da sessão."
2089
2090 #. (itstool) path: varlistentry/term
2091 #: C/index.docbook:1311
2092 msgid "@title"
2093 msgstr "@title"
2094
2095 #. (itstool) path: listitem/para
2096 #: C/index.docbook:1313
2097 msgid ""
2098 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
2099 "can be overridden with the @title field."
2100 msgstr ""
2101 "O padrão para título de seção é &lt;nome&gt; da declaração da SECTION. Ele "
2102 "pode ser sobrescrito com o campo @title."
2103
2104 #. (itstool) path: varlistentry/term
2105 #: C/index.docbook:1320
2106 msgid "@section_id"
2107 msgstr "@section_id"
2108
2109 #. (itstool) path: listitem/para
2110 #: C/index.docbook:1322
2111 msgid ""
2112 "Overrides the use of title as a section identifier. For GObjects the "
2113 "&lt;title&gt; is used as a section_id and for other sections it is "
2114 "&lt;MODULE&gt;-&lt;title&gt;."
2115 msgstr ""
2116 "Sobrescreve o uso do título como um identificador de seção. Para GObjects, o "
2117 "&lt;title&gt; é usado como um section_id e para outras seções ele é "
2118 "&lt;MÓDULO&gt;-&lt;title&gt;."
2119
2120 #. (itstool) path: varlistentry/term
2121 #: C/index.docbook:1330
2122 msgid "@see_also"
2123 msgstr "@see_also"
2124
2125 #. (itstool) path: listitem/para
2126 #: C/index.docbook:1332
2127 msgid "A list of symbols that are related to this section."
2128 msgstr "Uma lista de símbolos que estão relacionados a esta sessão."
2129
2130 #. (itstool) path: varlistentry/term
2131 #: C/index.docbook:1338
2132 msgid "@stability"
2133 msgstr "@stability"
2134
2135 #. (itstool) path: listitem/para
2136 #: C/index.docbook:1345
2137 msgid ""
2138 "Stable - The intention of a Stable interface is to enable arbitrary third "
2139 "parties to develop applications to these interfaces, release them, and have "
2140 "confidence that they will run on all minor releases of the product (after "
2141 "the one in which the interface was introduced, and within the same major "
2142 "release). Even at a major release, incompatible changes are expected to be "
2143 "rare, and to have strong justifications."
2144 msgstr ""
2145 "Estável – A intenção de uma interface estável é permitir terceiros "
2146 "arbitrários desenvolverem aplicativos para essas interfaces, lançá-los e ter "
2147 "a confiança de que eles vão funcionar em todos os lançamentos menores do "
2148 "produto (após aquele no qual a interface foi introduzida e naquele mesmo "
2149 "lançamento maior). Atém mesmo em um lançamento maior, espera-se que "
2150 "alterações incompatíveis sejam raras e que tenham fortes justificativas."
2151
2152 #. (itstool) path: listitem/para
2153 #: C/index.docbook:1357
2154 msgid ""
2155 "Unstable - Unstable interfaces are experimental or transitional. They are "
2156 "typically used to give outside developers early access to new or rapidly "
2157 "changing technology, or to provide an interim solution to a problem where a "
2158 "more general solution is anticipated. No claims are made about either source "
2159 "or binary compatibility from one minor release to the next."
2160 msgstr ""
2161 "Instável – Interfaces instáveis são experimentais ou transicionais. Elas são "
2162 "normalmente usadas para dar a desenvolvedores externos um acesso prévio a "
2163 "nova tecnologia ou em rápida alteração, ou para fornecer uma solução "
2164 "interina para um problema que uma solução mais genérica foi antecipada. "
2165 "Nenhuma responsabilidade é assumida pela compatbilidade dos binários ou dos "
2166 "fontes de uma versão menor para a próxima."
2167
2168 #. (itstool) path: listitem/para
2169 #: C/index.docbook:1369
2170 msgid ""
2171 "Private - An interface that can be used within the GNOME stack itself, but "
2172 "that is not documented for end-users. Such functions should only be used in "
2173 "specified and documented ways."
2174 msgstr ""
2175 "Privado – Uma interface que pode ser usada dentro da própria pilha do GNOME, "
2176 "mas que não está documentada para usuários finais. Tais funções deveriam ser "
2177 "usadas nas formas especificadas e documentadas."
2178
2179 #. (itstool) path: listitem/para
2180 #: C/index.docbook:1378
2181 msgid ""
2182 "Internal - An interface that is internal to a module and does not require "
2183 "end-user documentation. Functions that are undocumented are assumed to be "
2184 "Internal."
2185 msgstr ""
2186 "Interna – Uma interface que é interna a um módulo e não requer documentação "
2187 "para o usuário final. Funções que não estão documentadas são presumidas como "
2188 "sendo “Interna”."
2189
2190 #. (itstool) path: listitem/para
2191 #: C/index.docbook:1340
2192 msgid ""
2193 "An informal description of the stability level this API has. We recommend "
2194 "the use of one of these terms: <_:itemizedlist-1/>"
2195 msgstr ""
2196 "Uma descrição informal do nível de estabilidade que esta API tem. Nós "
2197 "recomendamos o uso de um desses termos: <_:itemizedlist-1/>"
2198
2199 #. (itstool) path: varlistentry/term
2200 #: C/index.docbook:1390
2201 msgid "@include"
2202 msgstr "@include"
2203
2204 #. (itstool) path: listitem/para
2205 #: C/index.docbook:1392
2206 msgid ""
2207 "The <literal>#include</literal> files to show in the section synopsis (a "
2208 "comma separated list), overriding the global value from the <link "
2209 "linkend=\"metafiles_sections\">section file</link> or command line. This "
2210 "item is optional."
2211 msgstr ""
2212 "Os arquivos <literal>#include</literal> a ser mostrado na sinopse da seção "
2213 "(uma lista separada por vírgulas), sobrescrevendo o valor global do <link "
2214 "linkend=\"metafiles_sections\">arquivo de seção</link> ou linha de comando. "
2215 "Este item é opcional."
2216
2217 #. (itstool) path: varlistentry/term
2218 #: C/index.docbook:1401
2219 msgid "@image"
2220 msgstr "@image"
2221
2222 #. (itstool) path: listitem/para
2223 #: C/index.docbook:1403
2224 msgid ""
2225 "The image to display at the top of the reference page for this section. This "
2226 "will often be some sort of a diagram to illustrate the visual appearance of "
2227 "a class or a diagram of its relationship to other classes. This item is "
2228 "optional."
2229 msgstr ""
2230 "A imagem a ser exibida no topo da página de referência desta seção. Isso "
2231 "frequentemente será um tipo de diagrama para ilustrar a aparência visual de "
2232 "uma classe ou uma diagrama de suas relações a outras classes. Este item é "
2233 "opcional."
2234
2235 #. (itstool) path: tip/para
2236 #: C/index.docbook:1414
2237 msgid ""
2238 "To avoid unnecessary recompilation after doc-changes put the section docs "
2239 "into the c-source where possible."
2240 msgstr ""
2241 "Para evitar recompilação desnecessária após alterações de documentação "
2242 "inseridas nas documentações de seção no fonte em C onde possível."
2243
2244 #. (itstool) path: sect1/title
2245 #: C/index.docbook:1423
2246 msgid "Documenting symbols"
2247 msgstr "Documentando símbolos"
2248
2249 #. (itstool) path: sect1/para
2250 #: C/index.docbook:1425
2251 msgid ""
2252 "Each symbol (function, macro, struct, enum, signal and property) is "
2253 "documented in a separate block. The block is best placed close to the "
2254 "definition of the symbols so that it is easy to keep them in sync. Thus "
2255 "functions are usually documented in the c-source and macros, structs and "
2256 "enums in the header file."
2257 msgstr ""
2258 "Cada símbolo (função, macro, struct, enum, signal e property) é documentado "
2259 "em uma bloco separado. O bloco é melhor localizado perto da definição dos "
2260 "símbolos, de forma que seja fácil de mantê-los em sincronia. Portanto, as "
2261 "funções são normalmente documentadas no fonte em C e macros, scructs e enums "
2262 "no arquivo de header."
2263
2264 #. (itstool) path: sect2/title
2265 #. (itstool) path: example/title
2266 #: C/index.docbook:1433 C/index.docbook:1499
2267 msgid "General tags"
2268 msgstr "Tags gerais"
2269
2270 #. (itstool) path: sect2/para
2271 #: C/index.docbook:1435
2272 msgid ""
2273 "You can add versioning information to all documentation elements to tell "
2274 "when an API was introduced, or when it was deprecated."
2275 msgstr ""
2276 "Você pode adicionar informação sobre versionamento em todos os elementos de "
2277 "documentação para informar quando uma API foi introduzida ou quando ela se "
2278 "tornou obsoleta."
2279
2280 #. (itstool) path: variablelist/title
2281 #: C/index.docbook:1440
2282 msgid "Versioning Tags"
2283 msgstr "Tags de versionamento"
2284
2285 #. (itstool) path: varlistentry/term
2286 #: C/index.docbook:1441
2287 msgid "Since:"
2288 msgstr "Since:"
2289
2290 #. (itstool) path: listitem/para
2291 #: C/index.docbook:1443
2292 msgid "Description since which version of the code the API is available."
2293 msgstr "Descrição de desde qual versão do código a API está disponível."
2294
2295 #. (itstool) path: varlistentry/term
2296 #: C/index.docbook:1448
2297 msgid "Deprecated:"
2298 msgstr "Deprecated:"
2299
2300 #. (itstool) path: listitem/para
2301 #: C/index.docbook:1450
2302 msgid ""
2303 "Paragraph denoting that this function should no be used anymore. The "
2304 "description should point the reader to the new API."
2305 msgstr ""
2306 "Parágrafo denotando que esta função deveria não mais ser usada. A descrição "
2307 "deveria apontar o leitor para a nova API."
2308
2309 #. (itstool) path: sect2/para
2310 #: C/index.docbook:1458
2311 msgid ""
2312 "You can also add stability information to all documentation elements to "
2313 "indicate whether API stability is guaranteed for them for all future minor "
2314 "releases of the project."
2315 msgstr ""
2316 "Você também pode adicionar informação sobre estabilidade em todos os "
2317 "elementos de documentação para indicar se a estabilidade de uma API é "
2318 "garantida para eles para futuros lançamentos menores do projeto."
2319
2320 #. (itstool) path: sect2/para
2321 #: C/index.docbook:1464
2322 msgid ""
2323 "The default stability level for all documentation elements can be set by "
2324 "passing the <option>--default-stability</option> argument to "
2325 "<application>gtkdoc-mkdb</application> with one of the values below."
2326 msgstr ""
2327 "O nível de estabilidade padrão para todos os elementos de documentação pode "
2328 "ser definido passando o argumento <option>--default-stability</option> para "
2329 "<application>gtkdoc-mkdb</application> com um dos valores abaixo."
2330
2331 #. (itstool) path: variablelist/title
2332 #: C/index.docbook:1470
2333 msgid "Stability Tags"
2334 msgstr "Tags de estabilidade"
2335
2336 #. (itstool) path: varlistentry/term
2337 #: C/index.docbook:1471
2338 msgid "Stability: Stable"
2339 msgstr "Stability: Stable"
2340
2341 #. (itstool) path: listitem/para
2342 #: C/index.docbook:1473
2343 msgid ""
2344 "Mark the element as stable. This is for public APIs which are guaranteed to "
2345 "remain stable for all future minor releases of the project."
2346 msgstr ""
2347 "Marca o elemento como estável. Isto é para APIs públicas cuja estabilidade é "
2348 "garantida para todos os próximos lançamentos menores do projeto."
2349
2350 #. (itstool) path: varlistentry/term
2351 #: C/index.docbook:1480
2352 msgid "Stability: Unstable"
2353 msgstr "Stability: Unstable"
2354
2355 #. (itstool) path: listitem/para
2356 #: C/index.docbook:1482
2357 msgid ""
2358 "Mark the element as unstable. This is for public APIs which are released as "
2359 "a preview before being stabilised."
2360 msgstr ""
2361 "Marca o elemento como instável. Isto é para APIs públicas que são publicados "
2362 "como versão de desenvolvimento antes de se tornar estável."
2363
2364 #. (itstool) path: varlistentry/term
2365 #: C/index.docbook:1488
2366 msgid "Stability: Private"
2367 msgstr "Stability: Private"
2368
2369 #. (itstool) path: listitem/para
2370 #: C/index.docbook:1490
2371 msgid ""
2372 "Mark the element as private. This is for interfaces which can be used by "
2373 "tightly coupled modules, but not by arbitrary third parties."
2374 msgstr ""
2375 "Marca o elemento como privado. Isto é para interfaces que podem ser usadas "
2376 "por um conjunto pequeno de módulos, mas não por terceiros."
2377
2378 #. (itstool) path: example/programlisting
2379 #: C/index.docbook:1500
2380 #, no-wrap
2381 msgid ""
2382 "\n"
2383 "/**\n"
2384 " * foo_get_bar:\n"
2385 " * @foo: some foo\n"
2386 " *\n"
2387 " * Retrieves @foo's bar.\n"
2388 " *\n"
2389 " * Returns: @foo's bar\n"
2390 " *\n"
2391 " * Since: 2.6\n"
2392 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2393 " */\n"
2394 "Bar *\n"
2395 "foo_get_bar(Foo *foo)\n"
2396 "{\n"
2397 "...\n"
2398 msgstr ""
2399 "\n"
2400 "/**\n"
2401 " * foo_get_bar:\n"
2402 " * @foo: Um foo\n"
2403 " *\n"
2404 " * Obtém o bar do @foo.\n"
2405 " *\n"
2406 " * Returns: bar do @foo\n"
2407 " *\n"
2408 " * Since: 2.6\n"
2409 " * Deprecated: 2.12: Use foo_baz_get_bar() no seu lugar.\n"
2410 " */\n"
2411 "Bar *\n"
2412 "foo_get_bar(Foo *foo)\n"
2413 "{\n"
2414 "...\n"
2415
2416 #. (itstool) path: sect2/title
2417 #. (itstool) path: example/title
2418 #: C/index.docbook:1520 C/index.docbook:1530
2419 msgid "Annotations"
2420 msgstr "Anotações"
2421
2422 #. (itstool) path: sect2/para
2423 #: C/index.docbook:1522
2424 msgid ""
2425 "Documentation blocks can contain annotation-tags. These tags will be "
2426 "rendered with tooltips describing their meaning. The tags are used by "
2427 "GObject Introspection to generate language bindings. A detailed list of the "
2428 "supported tags can be found in the <ulink url=\"https://gi.readthedocs.io/en/"
2429 "latest/annotations/giannotations.html\" type=\"http\">GObject Introspection "
2430 "documentation</ulink>."
2431 msgstr ""
2432 "Os blocos de documentação podem conter etiquetas de anotação. Essas "
2433 "etiquetas serão renderizadas com dicas descrevendo seu significado. As "
2434 "etiquetas são usadas pelo GObject Introspection para gerar ligações de "
2435 "linguagem. Uma lista detalhada das etiquetas suportadas pode ser encontrada "
2436 "na <ulink url=\"https://gi.readthedocs.io/en/latest/annotations/"
2437 "giannotations.html\" type=\"http\">documentação do GObject Introspection</"
2438 "ulink> ."
2439
2440 #. (itstool) path: example/programlisting
2441 #: C/index.docbook:1531
2442 #, no-wrap
2443 msgid ""
2444 "\n"
2445 "/**\n"
2446 " * foo_get_bar: (annotation)\n"
2447 " * @foo: (annotation): some foo\n"
2448 " *\n"
2449 " * Retrieves @foo's bar.\n"
2450 " *\n"
2451 " * Returns: (annotation): @foo's bar\n"
2452 " */\n"
2453 "...\n"
2454 "/**\n"
2455 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2456 " * (and another annotation)\n"
2457 " * @foo: (annotation) (another annotation): some foo\n"
2458 " *\n"
2459 " * Sets bar on @foo.\n"
2460 " */\n"
2461 msgstr ""
2462 "\n"
2463 "/**\n"
2464 " * foo_get_bar: (anotação)\n"
2465 " * @foo: (anotação): algum foo\n"
2466 " *\n"
2467 " * Obtém bar do @foo.\n"
2468 " *\n"
2469 " * Returns: (anotação): bar do @foo\n"
2470 " */\n"
2471 "...\n"
2472 "/**\n"
2473 " * foo_set_bar_using_the_frobnicator: (anotação) (outra anotação)\n"
2474 " * (e uma outra anotação)\n"
2475 " * @foo: (anotação) (uma outra anotação): algum foo\n"
2476 " *\n"
2477 " * Define bar no @foo.\n"
2478 " */\n"
2479
2480 #. (itstool) path: sect2/title
2481 #. (itstool) path: example/title
2482 #: C/index.docbook:1552 C/index.docbook:1581
2483 msgid "Function comment block"
2484 msgstr "Bloco de comentário de função"
2485
2486 #. (itstool) path: listitem/para
2487 #: C/index.docbook:1558
2488 msgid ""
2489 "Document whether returned objects, lists, strings, etc, should be freed/"
2490 "unrefed/released."
2491 msgstr ""
2492 "Documente se objetos, listas, strings, etc. retornados devem ser não usados/"
2493 "não referenciados/liberada."
2494
2495 #. (itstool) path: listitem/para
2496 #: C/index.docbook:1564
2497 msgid "Document whether parameters can be NULL, and what happens if they are."
2498 msgstr ""
2499 "Documente se parâmetros pode ser NULL e o que acontece se eles o forem."
2500
2501 #. (itstool) path: listitem/para
2502 #: C/index.docbook:1569
2503 msgid ""
2504 "Mention interesting pre-conditions and post-conditions where appropriate."
2505 msgstr ""
2506 "Mencione pré-condições e pós-condições interessantes onde for apropriado."
2507
2508 #. (itstool) path: sect2/para
2509 #: C/index.docbook:1554 C/index.docbook:1640
2510 msgid "Please remember to: <_:itemizedlist-1/>"
2511 msgstr "Por favor, lembre-se de: <_:itemizedlist-1/>"
2512
2513 #. (itstool) path: sect2/para
2514 #: C/index.docbook:1576
2515 msgid ""
2516 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
2517 "private. They are treated like static functions."
2518 msgstr ""
2519 "Gtk-doc presume que todos os símbolos (macros, funções) começando com “_” "
2520 "são privados. Eles são tratados como funções estáticas."
2521
2522 #. (itstool) path: example/programlisting
2523 #: C/index.docbook:1582
2524 #, no-wrap
2525 msgid ""
2526 "\n"
2527 "/**\n"
2528 " * function_name:\n"
2529 " * @par1: description of parameter 1. These can extend over more than\n"
2530 " * one line.\n"
2531 " * @par2: description of parameter 2\n"
2532 " * @...: a %NULL-terminated list of bars\n"
2533 " *\n"
2534 " * The function description goes here. You can use @par1 to refer to parameters\n"
2535 " * so that they are highlighted in the output. You can also use %constant\n"
2536 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2537 " * other declarations (which may be documented elsewhere).\n"
2538 " *\n"
2539 " * Returns: an integer.\n"
2540 " *\n"
2541 " * Since: 2.2\n"
2542 " * Deprecated: 2.18: Use other_function() instead.\n"
2543 " */\n"
2544 msgstr ""
2545 "\n"
2546 "/**\n"
2547 " * nome_da_função:\n"
2548 " * @par1: descrição do parâmetro 1. Esta pode se estender por mais de\n"
2549 " * uma linha.\n"
2550 " * @par2: descrição do parâmetro 2\n"
2551 " * @...: uma lista de bars terminada em %NULL\n"
2552 " *\n"
2553 " * A descrição da função vai aqui. Você pode usar @par1 para se referir a parâmetros\n"
2554 " * de forma que eles ficam em destaque na saída. Você também pode usar %constant\n"
2555 " * para constantes, nome_da_função2() para funções e #GtkWidget para links para\n"
2556 " * outras declarações (que pode ser documentada em outro lugar).\n"
2557 " *\n"
2558 " * Returns: um inteiro.\n"
2559 " *\n"
2560 " * Since: 2.2\n"
2561 " * Deprecated: 2.18: Use outra_função() em seu lugar.\n"
2562 " */\n"
2563
2564 #. (itstool) path: variablelist/title
2565 #: C/index.docbook:1603
2566 msgid "Function tags"
2567 msgstr "Tags de função"
2568
2569 #. (itstool) path: varlistentry/term
2570 #: C/index.docbook:1604 C/index.docbook:1811
2571 msgid "Returns:"
2572 msgstr "Returns:"
2573
2574 #. (itstool) path: listitem/para
2575 #: C/index.docbook:1606
2576 msgid "Paragraph describing the returned result."
2577 msgstr "Parágrafo descrevendo o resultado retornado."
2578
2579 #. (itstool) path: varlistentry/term
2580 #: C/index.docbook:1611
2581 msgid "@...:"
2582 msgstr "@...:"
2583
2584 #. (itstool) path: listitem/para
2585 #: C/index.docbook:1613
2586 msgid ""
2587 "In case the function has variadic arguments, you should use this tag "
2588 "(@Varargs: does also work for historic reasons)."
2589 msgstr ""
2590 "No caso da função possuir argumentos variados, você deveria usar esta tag "
2591 "(@Varargs: também funciona por motivos de histórico)."
2592
2593 #. (itstool) path: sect2/title
2594 #. (itstool) path: example/title
2595 #: C/index.docbook:1623 C/index.docbook:1625
2596 msgid "Property comment block"
2597 msgstr "Bloco de comentário de propriedade"
2598
2599 #. (itstool) path: example/programlisting
2600 #: C/index.docbook:1626
2601 #, no-wrap
2602 msgid ""
2603 "\n"
2604 "/**\n"
2605 " * SomeWidget:some-property:\n"
2606 " *\n"
2607 " * Here you can document a property.\n"
2608 " */\n"
2609 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2610 msgstr ""
2611 "\n"
2612 "/**\n"
2613 " * AlgumWidget:alguma-propriedade:\n"
2614 " *\n"
2615 " * Aqui você pode documentar uma propriedade.\n"
2616 " */\n"
2617 "g_object_propriedade_install_classe (object_classe, PROP_ALGUMA_PROPRIEDADE, ...);\n"
2618
2619 #. (itstool) path: sect2/title
2620 #. (itstool) path: example/title
2621 #: C/index.docbook:1638 C/index.docbook:1657
2622 msgid "Signal comment block"
2623 msgstr "Bloco de comentário de sinal"
2624
2625 #. (itstool) path: listitem/para
2626 #: C/index.docbook:1644
2627 msgid ""
2628 "Document when the signal is emitted and whether it is emitted before or "
2629 "after other signals."
2630 msgstr ""
2631 "Documente quando o sinal é emitido e se ele é emitido antes ou após outros "
2632 "sinais."
2633
2634 #. (itstool) path: listitem/para
2635 #: C/index.docbook:1650
2636 msgid "Document what an application might do in the signal handler."
2637 msgstr "Documente o que um aplicativo pode fazer no manipulador do sinal."
2638
2639 #. (itstool) path: example/programlisting
2640 #: C/index.docbook:1658
2641 #, no-wrap
2642 msgid ""
2643 "\n"
2644 "/**\n"
2645 " * FooWidget::foobarized:\n"
2646 " * @widget: the widget that received the signal\n"
2647 " * @foo: some foo\n"
2648 " * @bar: some bar\n"
2649 " *\n"
2650 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2651 " */\n"
2652 "foo_signals[FOOBARIZED] =\n"
2653 " g_signal_new (\"foobarized\",\n"
2654 " ...\n"
2655 msgstr ""
2656 "\n"
2657 "/**\n"
2658 " * FooWidget::foobarizado:\n"
2659 " * @widget: o widget que recebeu o sinal\n"
2660 " * @foo: algum foo\n"
2661 " * @bar: algum bar\n"
2662 " *\n"
2663 " * O sinal ::foobarized é emitido cada vez que alguém tenta foobarizar @widget.\n"
2664 " */\n"
2665 "foo_sinais[FOOBARIZADO] =\n"
2666 " g_signal_novo (\"foobarizado\",\n"
2667 " ...\n"
2668
2669 #. (itstool) path: sect2/title
2670 #. (itstool) path: example/title
2671 #: C/index.docbook:1675 C/index.docbook:1676
2672 msgid "Struct comment block"
2673 msgstr "Bloco de comentário de struct"
2674
2675 #. (itstool) path: example/programlisting
2676 #: C/index.docbook:1677
2677 #, no-wrap
2678 msgid ""
2679 "\n"
2680 "/**\n"
2681 " * FooWidget:\n"
2682 " * @bar: some #gboolean\n"
2683 " *\n"
2684 " * This is the best widget, ever.\n"
2685 " */\n"
2686 "typedef struct _FooWidget {\n"
2687 " GtkWidget parent_instance;\n"
2688 "\n"
2689 " gboolean bar;\n"
2690 "} FooWidget;\n"
2691 msgstr ""
2692 "\n"
2693 "/**\n"
2694 " * FooWidget:\n"
2695 " * @bar: algum #gboolean\n"
2696 " *\n"
2697 " * Este é o melhor widget, já mais visto.\n"
2698 " */\n"
2699 "typedef struct _FooWidget {\n"
2700 " GtkWidget parent_intance;\n"
2701 "\n"
2702 " gboolean bar;\n"
2703 "} FooWidget;\n"
2704
2705 #. (itstool) path: sect2/para
2706 #: C/index.docbook:1692
2707 msgid ""
2708 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2709 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2710 "behaviour."
2711 msgstr ""
2712 "Use <code>/*&lt; private &gt;*/</code> antes dos campos da struct privada "
2713 "que você deseja esconder. Use <code>/*&lt; public &gt;*/</code> para o "
2714 "comportamento inverso."
2715
2716 #. (itstool) path: sect2/para
2717 #: C/index.docbook:1698
2718 msgid ""
2719 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2720 "it will be considered private automatically and doesn't need to be mentioned "
2721 "in the comment block."
2722 msgstr ""
2723 "Se o primeiro campo for “g_iface”, “parent_instance” ou “parent_class”, ele "
2724 "será automaticamente considerado como privado e não precisará ser mencionado "
2725 "no bloco de comentário."
2726
2727 #. (itstool) path: sect2/para
2728 #: C/index.docbook:1704
2729 msgid ""
2730 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2731 "is usually a good idea to add a comment block for a class, if it has "
2732 "vmethods (as this is how they can be documented). For the GObject itself one "
2733 "can use the related section docs, having a separate block for the instance "
2734 "struct would be useful if the instance has public fields. One disadvantage "
2735 "here is that this creates two index entries of the same name (the structure "
2736 "and the section)."
2737 msgstr ""
2738 "Blocos de comentário de struct também podem ser usados para GObjects e "
2739 "GObjectClasses. É normalmente uma boa ideia adicionar um bloco de comentário "
2740 "para uma classe, se ela possui vmethods (pois assim é como elas podem ser "
2741 "documentadas). Para o próprio GOBject pode-se usar os documentos de seção "
2742 "relacionados, tendo um bloco separado para a instância do struct seria útil "
2743 "se a instância possui campos públicos. Uma desvantagem aqui é que isso cria "
2744 "duas entradas no índice do mesmo nome (a estrutura e a seção)."
2745
2746 #. (itstool) path: sect2/title
2747 #. (itstool) path: example/title
2748 #: C/index.docbook:1716 C/index.docbook:1717
2749 msgid "Enum comment block"
2750 msgstr "Bloco de comentário de enum"
2751
2752 #. (itstool) path: example/programlisting
2753 #: C/index.docbook:1718
2754 #, no-wrap
2755 msgid ""
2756 "\n"
2757 "/**\n"
2758 " * Something:\n"
2759 " * @SOMETHING_FOO: something foo\n"
2760 " * @SOMETHING_BAR: something bar\n"
2761 " *\n"
2762 " * Enum values used for the thing, to specify the thing.\n"
2763 " */\n"
2764 "typedef enum {\n"
2765 " SOMETHING_FOO,\n"
2766 " SOMETHING_BAR,\n"
2767 " /*&lt; private &gt;*/\n"
2768 " SOMETHING_COUNT\n"
2769 "} Something;\n"
2770 msgstr ""
2771 "\n"
2772 "/**\n"
2773 " * Alguma coisa:\n"
2774 " * @ALGUMACOISA_FOO: alguma coisa foo\n"
2775 " * @ALGUMCAOISA_BAR: alguma coisa bar\n"
2776 " *\n"
2777 " * Valores de enum usados para a coisa, para especificar a coisa.\n"
2778 " */\n"
2779 "typedef enum {\n"
2780 " ALGUMACOISA_FOO,\n"
2781 " ALGUMACOISA_BAR,\n"
2782 " /*&lt; private &gt;*/\n"
2783 " ALGUMACOISA_CONTAGEM\n"
2784 "} Alguma coisa;\n"
2785
2786 #. (itstool) path: sect2/para
2787 #: C/index.docbook:1735
2788 msgid ""
2789 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2790 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2791 "behaviour."
2792 msgstr ""
2793 "Use <code>/*&lt; private &gt;*/</code> antes de valores privados de enum que "
2794 "você deseja ocultar. Use <code>/*&lt; public &gt;*/</code> para o "
2795 "comportamento inverso."
2796
2797 #. (itstool) path: sect1/title
2798 #: C/index.docbook:1746
2799 msgid "Inline program documentation"
2800 msgstr "Documentação de programa em-linha"
2801
2802 #. (itstool) path: sect1/para
2803 #: C/index.docbook:1747
2804 msgid ""
2805 "You can document programs and their commandline interface using inline "
2806 "documentation."
2807 msgstr ""
2808 "Você pode documentar programas e sua interface de linha de comando usando "
2809 "documentação em-linha."
2810
2811 #. (itstool) path: variablelist/title
2812 #: C/index.docbook:1753
2813 msgid "Tags"
2814 msgstr "Tags"
2815
2816 #. (itstool) path: varlistentry/term
2817 #: C/index.docbook:1755
2818 msgid "PROGRAM"
2819 msgstr "PROGRAM"
2820
2821 #. (itstool) path: listitem/para
2822 #: C/index.docbook:1758
2823 msgid "Defines the start of a program documentation."
2824 msgstr "Define o início da documentação de um programa."
2825
2826 #. (itstool) path: varlistentry/term
2827 #: C/index.docbook:1765
2828 msgid "@short_description:"
2829 msgstr "@short_description:"
2830
2831 #. (itstool) path: listitem/para
2832 #: C/index.docbook:1767
2833 msgid "Defines a short description of the program. (Optional)"
2834 msgstr "Define uma descrição breve do programa. (Opcional)"
2835
2836 #. (itstool) path: varlistentry/term
2837 #: C/index.docbook:1774
2838 msgid "@synopsis:"
2839 msgstr "@synopsis:"
2840
2841 #. (itstool) path: listitem/para
2842 #: C/index.docbook:1776
2843 msgid ""
2844 "Defines the arguments, or list of arguments that the program can take. "
2845 "(Optional)"
2846 msgstr ""
2847 "Define os argumentos, ou lista de argumentos, que o programa pode receber. "
2848 "(Opcional)"
2849
2850 #. (itstool) path: varlistentry/term
2851 #: C/index.docbook:1784
2852 msgid "@see_also:"
2853 msgstr "@see_also:"
2854
2855 #. (itstool) path: listitem/para
2856 #: C/index.docbook:1786
2857 msgid "See Also manual page section. (Optional)"
2858 msgstr "A seção “See Also” (Veja Também) de páginas de manual. (Opcional)"
2859
2860 #. (itstool) path: varlistentry/term
2861 #: C/index.docbook:1793
2862 msgid "@arg:"
2863 msgstr "@arg:"
2864
2865 #. (itstool) path: listitem/para
2866 #: C/index.docbook:1795
2867 msgid "Argument(s) passed to the program and their description. (Optional)"
2868 msgstr "Argumento(s) passado(s) para o programa e sua descrição. (Opcional)"
2869
2870 #. (itstool) path: varlistentry/term
2871 #: C/index.docbook:1802
2872 msgid "Description:"
2873 msgstr "Description:"
2874
2875 #. (itstool) path: listitem/para
2876 #: C/index.docbook:1804
2877 msgid "A longer description of the program."
2878 msgstr "Um descrição mais longa do programa."
2879
2880 #. (itstool) path: listitem/para
2881 #: C/index.docbook:1813
2882 msgid "Specify what value(s) the program returns. (Optional)"
2883 msgstr "Especifique qual(is) valor(es) o programa retorna. (Opcional)"
2884
2885 #. (itstool) path: sect2/title
2886 #: C/index.docbook:1822
2887 msgid "Example of program documentation."
2888 msgstr "Exemplo de documentação de programa."
2889
2890 #. (itstool) path: example/title
2891 #: C/index.docbook:1823
2892 msgid "Program documentation block"
2893 msgstr "Bloco de documentação de programa"
2894
2895 #. (itstool) path: example/programlisting
2896 #: C/index.docbook:1824
2897 #, no-wrap
2898 msgid ""
2899 "\n"
2900 "/**\n"
2901 " * PROGRAM:test-program\n"
2902 " * @short_description: A test program\n"
2903 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2904 " * @see_also: test(1)\n"
2905 " * @--arg1 *arg*: set arg1 to *arg*\n"
2906 " * @--arg2 *arg*: set arg2 to *arg*\n"
2907 " * @-v, --version: Print the version number\n"
2908 " * @-h, --help: Print the help message\n"
2909 " *\n"
2910 " * Long description of program.\n"
2911 " *\n"
2912 " * Returns: Zero on success, non-zero on failure\n"
2913 " */\n"
2914 "int main(int argc, char *argv[])\n"
2915 "{\n"
2916 "\treturn 0;\n"
2917 "}\n"
2918 msgstr ""
2919 "\n"
2920 "/**\n"
2921 " * PROGRAM:programa-teste\n"
2922 " * @short_description: Um programa teste\n"
2923 " * @synopsis: programa-teste [*OPÇÕES*...] --arg1 *arg* *ARQUIVO*\n"
2924 " * @see_also: teste(1)\n"
2925 " * @--arg1 *arg*: define arg1 para *arg*\n"
2926 " * @--arg2 *arg*: define arg2 para *arg*\n"
2927 " * @-v, --version: Exibe o número da versão\n"
2928 " * @-h, --help: Exibe a mensagem de ajuda\n"
2929 " *\n"
2930 " * Descrição longa do programa.\n"
2931 " *\n"
2932 " * Returns: Zero no caso de sucesso, não-zero no caso de falha\n"
2933 " */\n"
2934 "int main(int argc, char *argv[])\n"
2935 "{\n"
2936 "\treturn 0;\n"
2937 "}\n"
2938
2939 #. (itstool) path: sect1/title
2940 #: C/index.docbook:1850
2941 msgid "Useful DocBook tags"
2942 msgstr "Tags úteis do DocBook"
2943
2944 #. (itstool) path: sect1/para
2945 #: C/index.docbook:1852
2946 msgid ""
2947 "Here are some DocBook tags which are most useful when documenting the code."
2948 msgstr ""
2949 "Aqui estão algumas tags de DocBook que são muito úteis quando se está "
2950 "documentado o código."
2951
2952 #. (itstool) path: informalexample/programlisting
2953 #: C/index.docbook:1861
2954 #, no-wrap
2955 msgid ""
2956 "\n"
2957 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2958 msgstr ""
2959 "\n"
2960 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Tabela de hashes&lt;/link&gt;\n"
2961
2962 #. (itstool) path: sect1/para
2963 #: C/index.docbook:1857
2964 msgid ""
2965 "To link to another section in the GTK docs: <_:informalexample-1/> The "
2966 "linkend is the SGML/XML id on the top item of the page you want to link to. "
2967 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
2968 "then the page title (\"Hash Tables\"). For widgets it is just the class "
2969 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
2970 msgstr ""
2971 "Para vincular a outra seção nas documentações do GTK: <_:informalexample-1/> "
2972 "O \"linked\" é a identificação SGML/XML no item superior da página a qual "
2973 "você deseja vincular. Para a maioria das páginas isto é atualmente a parte "
2974 "(“gtk”, “gdk”, “glib”) e, então, o título da página (“Hash Tables”). Para os "
2975 "widgets isso é apenas o nome da classe. Espaços e sublinhados são "
2976 "convertidos em '-' para estar em conformidade com SGML/XML."
2977
2978 #. (itstool) path: informalexample/programlisting
2979 #: C/index.docbook:1874
2980 #, no-wrap
2981 msgid ""
2982 "\n"
2983 "&lt;function&gt;...&lt;/function&gt;\n"
2984 msgstr ""
2985 "\n"
2986 "&lt;function&gt;...&lt;/function&gt;\n"
2987
2988 #. (itstool) path: sect1/para
2989 #: C/index.docbook:1871
2990 msgid ""
2991 "To refer to an external function, e.g. a standard C function: "
2992 "<_:informalexample-1/>"
2993 msgstr ""
2994 "Para se referir a uma função externa, como, por exemplo, uma função padrão "
2995 "do C: <_:informalexample-1/>"
2996
2997 #. (itstool) path: informalexample/programlisting
2998 #: C/index.docbook:1883
2999 #, no-wrap
3000 msgid ""
3001 "\n"
3002 "&lt;example&gt;\n"
3003 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3004 " &lt;programlisting language=\"C\"&gt;\n"
3005 " ...\n"
3006 " &lt;/programlisting&gt;\n"
3007 "&lt;/example&gt;\n"
3008 msgstr ""
3009 "\n"
3010 "&lt;example&gt;\n"
3011 " &lt;title&gt;Usando uma GHashTable.&lt;/title&gt;\n"
3012 " &lt;programlisting language=\"C\"&gt;\n"
3013 " ...\n"
3014 " &lt;/programlisting&gt;\n"
3015 "&lt;/example&gt;\n"
3016
3017 #. (itstool) path: informalexample/programlisting
3018 #: C/index.docbook:1894
3019 #, no-wrap
3020 msgid ""
3021 "\n"
3022 "&lt;informalexample&gt;\n"
3023 " &lt;programlisting language=\"C\"&gt;\n"
3024 " ...\n"
3025 " &lt;/programlisting&gt;\n"
3026 "&lt;/informalexample&gt;\n"
3027 msgstr ""
3028 "\n"
3029 "&lt;informalexample&gt;\n"
3030 " &lt;programlisting language=\"C\"&gt;\n"
3031 " ...\n"
3032 " &lt;/programlisting&gt;\n"
3033 "&lt;/informalexample&gt;\n"
3034
3035 #. (itstool) path: informalexample/programlisting
3036 #: C/index.docbook:1906
3037 #, no-wrap
3038 msgid ""
3039 "\n"
3040 "|[&lt;!-- language=\"C\" --&gt;\n"
3041 " ...\n"
3042 "]|\n"
3043 msgstr ""
3044 "\n"
3045 "|[&lt;!-- language=\"C\" --&gt;\n"
3046 " ...\n"
3047 "]|\n"
3048
3049 #. (itstool) path: sect1/para
3050 #: C/index.docbook:1880
3051 msgid ""
3052 "To include example code: <_:informalexample-1/> or possibly this, for very "
3053 "short code fragments which don't need a title: <_:informalexample-2/> In "
3054 "both cases, the language attribute is optional and is used as a hint to the "
3055 "syntax highlighting engine (pygments for html output). For the latter GTK-"
3056 "Doc also supports an abbreviation: <_:informalexample-3/>"
3057 msgstr ""
3058 "Para incluir um código de exemplo: <_:informalexample-1/> ou possivelmente "
3059 "este, para fragmentos de código bem curtos que não precisam de um título: "
3060 "<_:informalexample-2/>. Nos dois casos, o atributo language é opcional e é "
3061 "usado como uma dica para o mecanismo de destaque de sintaxe (pigmentos para "
3062 "saída html). Para este último, GTK-Doc também possui suporte a uma "
3063 "abreviação: |[ ... ]|"
3064
3065 #. (itstool) path: informalexample/programlisting
3066 #: C/index.docbook:1917
3067 #, no-wrap
3068 msgid ""
3069 "\n"
3070 "&lt;itemizedlist&gt;\n"
3071 " &lt;listitem&gt;\n"
3072 " &lt;para&gt;\n"
3073 " ...\n"
3074 " &lt;/para&gt;\n"
3075 " &lt;/listitem&gt;\n"
3076 " &lt;listitem&gt;\n"
3077 " &lt;para&gt;\n"
3078 " ...\n"
3079 " &lt;/para&gt;\n"
3080 " &lt;/listitem&gt;\n"
3081 "&lt;/itemizedlist&gt;\n"
3082 msgstr ""
3083 "\n"
3084 "&lt;itemizedlist&gt;\n"
3085 " &lt;listitem&gt;\n"
3086 " &lt;para&gt;\n"
3087 " ...\n"
3088 " &lt;/para&gt;\n"
3089 " &lt;/listitem&gt;\n"
3090 " &lt;listitem&gt;\n"
3091 " &lt;para&gt;\n"
3092 " ...\n"
3093 " &lt;/para&gt;\n"
3094 " &lt;/listitem&gt;\n"
3095 "&lt;/itemizedlist&gt;\n"
3096
3097 #. (itstool) path: sect1/para
3098 #: C/index.docbook:1914
3099 msgid "To include bulleted lists: <_:informalexample-1/>"
3100 msgstr "Para incluir listas com marcadores: <_:informalexample-1/>"
3101
3102 #. (itstool) path: informalexample/programlisting
3103 #: C/index.docbook:1937
3104 #, no-wrap
3105 msgid ""
3106 "\n"
3107 "&lt;note&gt;\n"
3108 " &lt;para&gt;\n"
3109 " Make sure you free the data after use.\n"
3110 " &lt;/para&gt;\n"
3111 "&lt;/note&gt;\n"
3112 msgstr ""
3113 "\n"
3114 "&lt;note&gt;\n"
3115 " &lt;para&gt;\n"
3116 " Certifique-se de que você liberou os dados após usá-los.\n"
3117 " &lt;/para&gt;\n"
3118 "&lt;/note&gt;\n"
3119
3120 #. (itstool) path: sect1/para
3121 #: C/index.docbook:1934
3122 msgid ""
3123 "To include a note which stands out from the text: <_:informalexample-1/>"
3124 msgstr "Para incluir uma nota que fique fora do texto: <_:informalexample-1/>"
3125
3126 #. (itstool) path: informalexample/programlisting
3127 #: C/index.docbook:1950
3128 #, no-wrap
3129 msgid ""
3130 "\n"
3131 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3132 msgstr ""
3133 "\n"
3134 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3135
3136 #. (itstool) path: sect1/para
3137 #: C/index.docbook:1947
3138 msgid "To refer to a type: <_:informalexample-1/>"
3139 msgstr "Para se referir a um tipo: <_:informalexample-1/>"
3140
3141 #. (itstool) path: informalexample/programlisting
3142 #: C/index.docbook:1959
3143 #, no-wrap
3144 msgid ""
3145 "\n"
3146 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3147 msgstr ""
3148 "\n"
3149 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3150
3151 #. (itstool) path: sect1/para
3152 #: C/index.docbook:1956
3153 msgid ""
3154 "To refer to an external structure (not one described in the GTK docs): "
3155 "<_:informalexample-1/>"
3156 msgstr ""
3157 "Para se referir a uma estrutura externa (não uma descrita nos documentos do "
3158 "GTK): <_:informalexample-1/>"
3159
3160 #. (itstool) path: informalexample/programlisting
3161 #: C/index.docbook:1968
3162 #, no-wrap
3163 msgid ""
3164 "\n"
3165 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3166 msgstr ""
3167 "\n"
3168 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3169
3170 #. (itstool) path: sect1/para
3171 #: C/index.docbook:1965
3172 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3173 msgstr "Para se referir a um campo de uma estrutura: <_:informalexample-1/>"
3174
3175 #. (itstool) path: informalexample/programlisting
3176 #: C/index.docbook:1977
3177 #, no-wrap
3178 msgid ""
3179 "\n"
3180 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3181 msgstr ""
3182 "\n"
3183 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3184
3185 #. (itstool) path: sect1/para
3186 #: C/index.docbook:1974
3187 msgid ""
3188 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3189 "you'll probably be using #GtkWidget instead (to automatically create a link "
3190 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3191 "abbreviations</link>)."
3192 msgstr ""
3193 "Para se referir a um nome de classe, nós possivelmente poderíamos usar: "
3194 "<_:informalexample-1/> mas você provavelmente vai estar usando #GtkWidget em "
3195 "vez disso (para criar automaticamente um link para a página do GtkWidget – "
3196 "veja <link linkend=\"documenting_syntax\">as abreviações</link>)."
3197
3198 #. (itstool) path: informalexample/programlisting
3199 #: C/index.docbook:1988
3200 #, no-wrap
3201 msgid ""
3202 "\n"
3203 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3204 msgstr ""
3205 "\n"
3206 "&lt;emphasis&gt;Isso é importante&lt;/emphasis&gt;\n"
3207
3208 #. (itstool) path: sect1/para
3209 #: C/index.docbook:1985
3210 msgid "To emphasize text: <_:informalexample-1/>"
3211 msgstr "Para enfatizar um texto: <_:informalexample-1/>"
3212
3213 #. (itstool) path: informalexample/programlisting
3214 #: C/index.docbook:1997
3215 #, no-wrap
3216 msgid ""
3217 "\n"
3218 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3219 msgstr ""
3220 "\n"
3221 "&lt;filename&gt;/home/usuario/documentos&lt;/filename&gt;\n"
3222
3223 #. (itstool) path: sect1/para
3224 #: C/index.docbook:1994
3225 msgid "For filenames use: <_:informalexample-1/>"
3226 msgstr "Para nome de arquivos use: <_:informalexample-1/>"
3227
3228 #. (itstool) path: informalexample/programlisting
3229 #: C/index.docbook:2006
3230 #, no-wrap
3231 msgid ""
3232 "\n"
3233 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3234 msgstr ""
3235 "\n"
3236 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3237
3238 #. (itstool) path: sect1/para
3239 #: C/index.docbook:2003
3240 msgid "To refer to keys use: <_:informalexample-1/>"
3241 msgstr "Para se referir a chaves use: <_:informalexample-1/>"
3242
3243 #. (itstool) path: chapter/title
3244 #: C/index.docbook:2016
3245 msgid "Filling the extra files"
3246 msgstr "Preenchendo os arquivos extras"
3247
3248 #. (itstool) path: chapter/para
3249 #: C/index.docbook:2018
3250 msgid ""
3251 "There are a couple of extra files, that need to be maintained along with the "
3252 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3253 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3254 "<filename>&lt;package&gt;-sections.txt</filename>."
3255 msgstr ""
3256 "Há alguns poucos arquivos extras, que precisam ser mantidos junto com os "
3257 "comentários inseridos no código-fonte: <filename>&lt;pacote&gt;.types</"
3258 "filename>, <filename>&lt;pacote&gt;-docs.xml</filename> (no passado, .sgml), "
3259 "<filename>&lt;pacote&gt;-sections.txt</filename>."
3260
3261 #. (itstool) path: sect1/title
3262 #: C/index.docbook:2027
3263 msgid "Editing the types file"
3264 msgstr "Editando o arquivo de tipos"
3265
3266 #. (itstool) path: sect1/para
3267 #: C/index.docbook:2029
3268 msgid ""
3269 "If your library or application includes GObjects, you want their signals, "
3270 "arguments/parameters and position in the hierarchy to be shown in the "
3271 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3272 "function> functions together with their include inside the "
3273 "<filename>&lt;package&gt;.types</filename> file."
3274 msgstr ""
3275 "Se sua biblioteca ou aplicativo inclui GObjects, você deseja que seus "
3276 "sinais, argumentos/parâmetros e posição na hierarquia sejam mostrados na "
3277 "documentação. Tudo que você precisa fazer é listar as funções "
3278 "<function>xxx_get_type</function> junto com seus include dentro do arquivo "
3279 "<filename>&lt;pacote&gt;.types</filename>."
3280
3281 #. (itstool) path: example/title
3282 #: C/index.docbook:2038
3283 msgid "Example &lt;package&gt;.types file"
3284 msgstr "Exemplo de arquivo &lt;pacote&gt;.types"
3285
3286 #. (itstool) path: example/programlisting
3287 #: C/index.docbook:2039
3288 #, no-wrap
3289 msgid ""
3290 "\n"
3291 "#include &lt;gtk/gtk.h&gt;\n"
3292 "\n"
3293 "gtk_accel_label_get_type\n"
3294 "gtk_adjustment_get_type\n"
3295 "gtk_alignment_get_type\n"
3296 "gtk_arrow_get_type\n"
3297 msgstr ""
3298 "\n"
3299 "#include &lt;gtk/gtk.h&gt;\n"
3300 "\n"
3301 "gtk_accel_label_get_type\n"
3302 "gtk_adjustment_get_type\n"
3303 "gtk_alignment_get_type\n"
3304 "gtk_arrow_get_type\n"
3305
3306 #. (itstool) path: sect1/para
3307 #: C/index.docbook:2050
3308 msgid ""
3309 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3310 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3311 "<filename>Makefile.am</filename>. If you use this approach you should not "
3312 "dist the types file nor have it under version control."
3313 msgstr ""
3314 "Desde o GTK-Doc 1.8, o <application>gtkdoc-scan</application> pode gerar "
3315 "esta lista para você. Basta adicionar “--rebuild-types” a SCAN_OPTIONS no "
3316 "<filename>Makefile.am</filename>. Se você usar esta abordagem, você não "
3317 "deveria distribuir o arquivo de tipos nem tê-lo sob um controle de versão."
3318
3319 #. (itstool) path: sect1/title
3320 #: C/index.docbook:2059
3321 msgid "Editing the master document"
3322 msgstr "Editando o documento mestre"
3323
3324 #. (itstool) path: sect1/para
3325 #: C/index.docbook:2061
3326 msgid ""
3327 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
3328 "inline source comments, the GTK-Doc tools generate one documentation page "
3329 "per class or module as a separate file. The master document includes them "
3330 "and place them in an order."
3331 msgstr ""
3332 "O Gtk-Doc produz documentação em DocBook SGML/XML. Ao processar os "
3333 "comentários inseridos nos fontes, as ferramentas do GTK-Doc geram uma página "
3334 "de documentação por classe ou módulo como um arquivo separado. O documento "
3335 "mestre os inclui e os coloca em uma ordem."
3336
3337 #. (itstool) path: sect1/para
3338 #: C/index.docbook:2068
3339 msgid ""
3340 "While GTK-Doc creates a template master document for you, later runs will "
3341 "not touch it again. This means that one can freely structure the "
3342 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
3343 "has now a test suite, where also the master-document is recreated from "
3344 "scratch. Its a good idea to look at this from time to time to see if there "
3345 "are some new goodies introduced there."
3346 msgstr ""
3347 "Enquanto o Gtk-Doc cria um modelo de documento mestre para você, execuções "
3348 "posteriores não vão tocá-lo novamente. Isso significa que se pode estruturar "
3349 "a documentação livremente. Isso inclui agrupamento de páginas e adição de "
3350 "páginas extras. O Gtk-Doc agora possui uma suíte de teste, na qual também o "
3351 "documento mestre é recriado do zero. É uma boa ideia verificar isso de tempo "
3352 "em tempo para ver se há itens a serem introduzidos lá."
3353
3354 #. (itstool) path: tip/para
3355 #: C/index.docbook:2078
3356 msgid ""
3357 "Do not create tutorials as extra documents. Just write extra chapters. The "
3358 "benefit of directly embedding the tutorial for your library into the API "
3359 "documentation is that it is easy to link for the tutorial to symbol "
3360 "documentation. Apart chances are higher that the tutorial gets updates along "
3361 "with the library."
3362 msgstr ""
3363 "Não crie tutoriais como documentos extras. Apenas escreva capítulos extras. "
3364 "O benefício de embutir diretamente o tutorial para sua biblioteca na "
3365 "documentação da API é que é mais fácil vincular o tutorial a um símbolo da "
3366 "documentação. Além disso, as chances são mais altas que o tutorial obtenha "
3367 "atualizações junto com a biblioteca."
3368
3369 #. (itstool) path: sect1/para
3370 #: C/index.docbook:2087
3371 msgid ""
3372 "So what are the things to change inside the master document? For a start is "
3373 "only a little. There are some placeholders (text in square brackets) there "
3374 "which you should take care of."
3375 msgstr ""
3376 "Então, quais são as coisas para se alterar dentro do documento mestre? Para "
3377 "começar é apenas um pouco. Existem alguns mantedores de espaço (texto em "
3378 "colchetes) que você deve cuidar."
3379
3380 #. (itstool) path: example/title
3381 #: C/index.docbook:2094
3382 msgid "Master document header"
3383 msgstr "Cabeçalho do documento mestre"
3384
3385 #. (itstool) path: example/programlisting
3386 #: C/index.docbook:2095
3387 #, no-wrap
3388 msgid ""
3389 "\n"
3390 "&lt;bookinfo&gt;\n"
3391 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3392 " &lt;releaseinfo&gt;\n"
3393 " for MODULENAME [VERSION]\n"
3394 " The latest version of this documentation can be found on-line at\n"
3395 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3396 " &lt;/releaseinfo&gt;\n"
3397 "&lt;/bookinfo&gt;\n"
3398 "\n"
3399 "&lt;chapter&gt;\n"
3400 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3401 msgstr ""
3402 "\n"
3403 "&lt;bookinfo&gt;\n"
3404 " &lt;title&gt;Manual de referência do NOMEDOMÓDULO&lt;/title&gt;\n"
3405 " &lt;releaseinfo&gt;\n"
3406 " for NOMEDOMÓDULO [VERSÃO]\n"
3407 " A última versão desta documentação também pode ser encontrada on-line em\n"
3408 " &lt;ulink role=\"online-location\" url=\"http://[SERVIDOR]/NOMEDOMÓDULO/index.html\"&gt;http://[SERVIDOR]/NOMEDOMÓDULO/&lt;/ulink&gt;.\n"
3409 " &lt;/releaseinfo&gt;\n"
3410 "&lt;/bookinfo&gt;\n"
3411 "\n"
3412 "&lt;chapter&gt;\n"
3413 " &lt;title&gt;[Insira o título aqui]&lt;/title&gt;\n"
3414
3415 #. (itstool) path: sect1/para
3416 #: C/index.docbook:2111
3417 msgid ""
3418 "In addition a few option elements are created in commented form. You can "
3419 "review these and enable them as you like."
3420 msgstr ""
3421 "Além disso, alguns elementos de opção são criados na forma comentada. Você "
3422 "pode revisá-los e habilitá-los como preferir."
3423
3424 #. (itstool) path: example/title
3425 #: C/index.docbook:2117
3426 msgid "Optional part in the master document"
3427 msgstr "Parte opcional do documento mestre"
3428
3429 #. (itstool) path: example/programlisting
3430 #: C/index.docbook:2118
3431 #, no-wrap
3432 msgid ""
3433 "\n"
3434 " &lt;!-- enable this when you use gobject introspection annotations\n"
3435 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3436 " --&gt;\n"
3437 msgstr ""
3438 "\n"
3439 " &lt;!-- habilite isso se você usa anotações do gobject introspection\n"
3440 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3441 " --&gt;\n"
3442
3443 #. (itstool) path: sect1/para
3444 #: C/index.docbook:2126
3445 msgid ""
3446 "Finally you need to add new section whenever you introduce one. The <link "
3447 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
3448 "you of newly generated xml files that are not yet included into the doc."
3449 msgstr ""
3450 "Finalmente você precisa adicionar nova seção sempre que você a introduzir. A "
3451 "ferramenta <link linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> "
3452 "vai lembrar você de arquivos xml recentemente gerados que ainda não foram "
3453 "incluídos na documentação."
3454
3455 #. (itstool) path: example/title
3456 #: C/index.docbook:2134 C/index.docbook:2169
3457 msgid "Including generated sections"
3458 msgstr "Incluindo seções geradas"
3459
3460 #. (itstool) path: example/programlisting
3461 #: C/index.docbook:2135
3462 #, no-wrap
3463 msgid ""
3464 "\n"
3465 " &lt;chapter&gt;\n"
3466 " &lt;title&gt;my library&lt;/title&gt;\n"
3467 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3468 " ...\n"
3469 msgstr ""
3470 "\n"
3471 " &lt;chapter&gt;\n"
3472 " &lt;title&gt;minha biblioteca&lt;/title&gt;\n"
3473 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3474 " ...\n"
3475
3476 #. (itstool) path: sect1/title
3477 #: C/index.docbook:2147
3478 msgid "Editing the section file"
3479 msgstr "Editando o arquivo de seção"
3480
3481 #. (itstool) path: sect1/para
3482 #: C/index.docbook:2149
3483 msgid ""
3484 "The section file is used to organise the documentation output by GTK-Doc. "
3485 "Here one specifies which symbol belongs to which module or class and control "
3486 "the visibility (public or private)."
3487 msgstr ""
3488 "O arquivo de seção é usado para organizar a saída da documentação pelo GTK-"
3489 "Doc. Aqui pode-se especificar qual símbolo pertence a qual módulo ou classe "
3490 "e controla a visibilidade (pública ou privada)."
3491
3492 #. (itstool) path: sect1/para
3493 #: C/index.docbook:2155
3494 msgid ""
3495 "The section file is a plain text file with tags delimiting sections. Blank "
3496 "lines are ignored and lines starting with a '#' are treated as comment lines."
3497 msgstr ""
3498 "O arquivo de seção é uma arquivo texto simples com seções delimitadas por "
3499 "tags. Linhas em branco são ignoradas e linhas começando com um “#” são "
3500 "tratadas como linhas de comentários."
3501
3502 #. (itstool) path: note/para
3503 #: C/index.docbook:2162
3504 msgid ""
3505 "While the tags make the file look like xml, it is not. Please do not close "
3506 "tags like &lt;SUBSECTION&gt;."
3507 msgstr ""
3508 "Enquanto as tags fazem o arquivo se parecer xml, ele não é. Por favor, não "
3509 "feche tags como &lt;SUBSECTION&gt;."
3510
3511 #. (itstool) path: example/programlisting
3512 #: C/index.docbook:2170
3513 #, no-wrap
3514 msgid ""
3515 "\n"
3516 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3517 "\n"
3518 "&lt;SECTION&gt;\n"
3519 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3520 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3521 "MeepApp\n"
3522 "&lt;SUBSECTION Standard&gt;\n"
3523 "MEEP_APP\n"
3524 "...\n"
3525 "MeepAppClass\n"
3526 "meep_app_get_type\n"
3527 "&lt;/SECTION&gt;\n"
3528 msgstr ""
3529 "\n"
3530 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3531 "\n"
3532 "&lt;SECTION&gt;\n"
3533 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3534 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3535 "MeepApp\n"
3536 "&lt;SUBSECTION Standard&gt;\n"
3537 "MEEP_APP\n"
3538 "...\n"
3539 "MeepAppClass\n"
3540 "meep_app_get_type\n"
3541 "&lt;/SECTION&gt;\n"
3542
3543 #. (itstool) path: sect1/para
3544 #: C/index.docbook:2187
3545 msgid ""
3546 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3547 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3548 "FILE&gt;' will result in the section declarations being output in the "
3549 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3550 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
3551 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
3552 "(The name of the HTML file is based on the module name and the section "
3553 "title, or for GObjects it is based on the GObjects class name converted to "
3554 "lower case)."
3555 msgstr ""
3556 "A tag &lt;FILE&gt; ... &lt;/FILE&gt; é usada para especificar o nome de "
3557 "arquivo, sem qualquer sufixo. Por exemplo, ao usar “&lt;FILE&gt;gnome-"
3558 "config&lt;/FILE&gt;” resultará nas declarações da seção serem retornadas no "
3559 "arquivo modelo <filename>tmpl/gnome-config.sgml</filename>, o qual será "
3560 "convertido no arquivo DocBook XML <filename>xml/gnome-config.sgml</filename> "
3561 "ou no arquivo DocBook XML <filename>xml/gnome-config.xml</filename>. (O nome "
3562 "do arquivo HTML é baseado no nome do módulo e no título da seção ou, para "
3563 "GObjects, é baseado no nome da classe GObjects convertidos os caracteres "
3564 "para minúsculos)."
3565
3566 #. (itstool) path: sect1/para
3567 #: C/index.docbook:2199
3568 msgid ""
3569 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3570 "section. It is only useful before the templates (if used) are initially "
3571 "created, since the title set in the template file overrides this. Also if "
3572 "one uses SECTION comment in the sources, this is obsolete."
3573 msgstr ""
3574 "A tag &lt;TITLE&gt; ... &lt;/TITLE&gt; é usada para especificar o título da "
3575 "seção. Ela é usada apenas antes do modelo (se usado) ser criado "
3576 "inicialmente, já que o título definido no arquivo de modelo sobrescreve "
3577 "este. Também, se for usado o comentário SECTION nos fontes, isso está "
3578 "obsoleto."
3579
3580 #. (itstool) path: sect1/para
3581 #: C/index.docbook:2206
3582 msgid ""
3583 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3584 "Currently it outputs a blank line between subsections in the synopsis "
3585 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
3586 "declarations (e.g. the functions like g_object_get_type and macros like "
3587 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
3588 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
3589 "declarations which will not be output (it is a handy way to avoid warning "
3590 "messages about unused declarations). If your library contains private types "
3591 "which you don't want to appear in the object hierarchy and the list of "
3592 "implemented or required interfaces, add them to a Private subsection. "
3593 "Whether you would place GObject and GObjectClass like structs in public or "
3594 "Standard section depends if they have public entries (variables, vmethods)."
3595 msgstr ""
3596 "Você pode agrupar itens na seção usando a tag &lt;SUBSECTION&gt;. "
3597 "Atualmente, ela retorna uma linha em branco entre as subseções na seção de "
3598 "sinopse. Você também pode usar &lt;SUBSECTION Standard&gt; para declarações "
3599 "padrão do GObject (ex.: as funções como g_object_get_type e macros como "
3600 "G_OBJECT(), G_IS_OBJECT() etc.). Atualmente, estas são deixadas fora da "
3601 "documentação. Você também pode usar &lt;SUBSECTION Private&gt; para "
3602 "declarações privadas que não serão retornadas (é uma forma prática de evitar "
3603 "mensagens de aviso sobre declarações não usadas). Se sua biblioteca contém "
3604 "tipos privados que você não deseja que apareçam na hierarquia do objeto e a "
3605 "linha de classes implementadas ou exigidas, adicione-as a uma subseção "
3606 "privada. Se você colocaria o GObject e GObjectClass como structs numa seção "
3607 "padrão ou pública depende se há entradas públicas (variáveis, vmethods)."
3608
3609 #. (itstool) path: sect1/para
3610 #: C/index.docbook:2225
3611 msgid ""
3612 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
3613 "#include files which are shown in the synopsis sections. It contains a comma-"
3614 "separate list of #include files, without the angle brackets. If you set it "
3615 "outside of any sections, it acts for all sections until the end of the file. "
3616 "If you set it within a section, it only applies to that section."
3617 msgstr ""
3618 "Você também pode usar &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; para especificar "
3619 "os arquivos #include que são mostrados nas seções de sinopse. Ela contém uma "
3620 "lista separada por vírgula de arquivos #include, sem os sinais de maior que "
3621 "e menor que. Se você define-a fora de quaisquer seções, ela age para todas "
3622 "as seções até o fim do arquivo. Se você define-a em uma seção, ela só vai se "
3623 "aplicar àquela seção."
3624
3625 #. (itstool) path: chapter/title
3626 #: C/index.docbook:2239
3627 msgid "Controlling the result"
3628 msgstr "Controlando o resultado"
3629
3630 #. (itstool) path: chapter/para
3631 #: C/index.docbook:2241
3632 msgid ""
3633 "A GTK-Doc run generates report files inside the documentation directory. The "
3634 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3635 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3636 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3637 "files that can be viewed and postprocessed easily."
3638 msgstr ""
3639 "Uma execução do GTK-Doc gera arquivos de relatórios dentro do diretório de "
3640 "documentação. Os arquivos gerados são chamados: <filename>&lt;pacote&gt;-"
3641 "undocumented.txt</filename>, <filename>&lt;pacote&gt;-undeclared.txt</"
3642 "filename> e <filename>&lt;pacote&gt;-unused.txt</filename>. Todos eles são "
3643 "arquivos texto simples que podem ser facilmente visualizados e pós-"
3644 "processados."
3645
3646 #. (itstool) path: chapter/para
3647 #: C/index.docbook:2250
3648 msgid ""
3649 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
3650 "the documentation coverage summary. Below are two sections divided by blank "
3651 "lines. The first section lists undocumented or incomplete symbols. The "
3652 "second section does the same for section docs. Incomplete entries are those, "
3653 "which have documentation, but where e.g. a new parameter has been added."
3654 msgstr ""
3655 "O arquivo <filename>&lt;pacote&gt;-undocumented.txt</filename> começa com um "
3656 "sumário de cobertura da documentação. Abaixo estão duas seções divididas por "
3657 "linhas brancas. A primeira seção lista símbolos não documentados e "
3658 "incompletos. A segunda seção faz o mesmo para os documentos de seção. "
3659 "Entradas incompletas são aquelas que foram documentadas, mas nas quais, por "
3660 "exemplo, um novo parâmetro foi adicionado."
3661
3662 #. (itstool) path: chapter/para
3663 #: C/index.docbook:2259
3664 msgid ""
3665 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3666 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3667 "in the sources. Check if they have been removed or if they are misspelled."
3668 msgstr ""
3669 "O arquivo <filename>&lt;pacote&gt;-undeclared.txt</filename> lista símbolos "
3670 "dados no <filename>&lt;pacote&gt;-sections.txt</filename>, mas não "
3671 "encontrados nos fontes. Verifique se eles foram removidos ou se eles foram "
3672 "escritos incorretamente."
3673
3674 #. (itstool) path: chapter/para
3675 #: C/index.docbook:2266
3676 msgid ""
3677 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3678 "where the GTK-Doc scanner has found documentation, but does not know where "
3679 "to put it. This means that the symbol has not yet been added to the "
3680 "<filename>&lt;package&gt;-sections.txt</filename> file."
3681 msgstr ""
3682 "O arquivo <filename>&lt;pacote&gt;-unused.txt</filename> lista nomes de "
3683 "símbolo cuja documentação foi localizada na varredura do GTK-Doc, mas que "
3684 "não sabe onde colocá-los. Isso significa que o símbolo não foi adicionado "
3685 "ainda ao arquivo <filename>&lt;pacote&gt;-sections.txt</filename>."
3686
3687 #. (itstool) path: tip/para
3688 #: C/index.docbook:2274
3689 msgid ""
3690 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in "
3691 "Makefile.am. If at least GTK-Doc 1.9 is installed, this will run sanity "
3692 "checks during <command>make check</command> run."
3693 msgstr ""
3694 "Habilite ou adicione a linha <option>TESTS=$(GTKDOC_CHECK)</option> no "
3695 "Makefile.am. Se pelo menos GTK-Doc 1.9 estiver instalado, isso vai executar "
3696 "verificações de sanidade durante a execução de <command>make check</command>."
3697
3698 #. (itstool) path: chapter/para
3699 #: C/index.docbook:2281
3700 msgid ""
3701 "One can also look at the files produced by the source code scanner: "
3702 "<filename>&lt;package&gt;-decl-list.txt</filename> and "
3703 "<filename>&lt;package&gt;-decl.txt</filename>. The first one can be compared "
3704 "with the section file if that is manually maintained. The second lists all "
3705 "declarations from the headers. If a symbol is missing one could check if "
3706 "this file contains it."
3707 msgstr ""
3708 "Também pode-se buscar nos arquivos produzidos pela varredura do código-"
3709 "fonte: <filename>&lt;pacote&gt;-decl-list.txt</filename> e "
3710 "<filename>&lt;pacote&gt;-decl.txt</filename>. O primeiro pode ser comparado "
3711 "com o arquivo de seção, se ele for mantido manualmente. O segundo lista "
3712 "todas as declarações de cabeçalhos. Se um símbolo está faltando, pode-se "
3713 "verificar se este arquivo o contém."
3714
3715 #. (itstool) path: chapter/para
3716 #: C/index.docbook:2290
3717 msgid ""
3718 "If the project is GObject based, one can also look into the files produced "
3719 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3720 "<filename>&lt;package&gt;.hierarchy.txt</filename>, "
3721 "<filename>&lt;package&gt;.interfaces.txt</filename>, "
3722 "<filename>&lt;package&gt;.prerequisites.txt</filename> and "
3723 "<filename>&lt;package&gt;.signals.txt</filename>. If there are missing "
3724 "symbols in any of those, one can ask GTK-Doc to keep the intermediate "
3725 "scanner file for further analysis, by running it as "
3726 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3727 msgstr ""
3728 "Se o projeto é baseado em GObject, pode-se também procurar nos arquivos "
3729 "produzidos pela varredura de objetos: <filename>&lt;pacote&gt;.args.txt</"
3730 "filename>, <filename>&lt;pacote&gt;.hierarchy.txt</filename>, "
3731 "<filename>&lt;pacote&gt;.interfaces.txt</filename>, "
3732 "<filename>&lt;pacote&gt;.prerequisites.txt</filename> e "
3733 "<filename>&lt;pacote&gt;.signals.txt</filename>. Se há símbolos faltando em "
3734 "qualquer um deles, pode-se exigir que o GTK-Doc mantenha o arquivo "
3735 "intermediário de varredura para análise posterior, executando "
3736 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3737
3738 #. (itstool) path: chapter/title
3739 #: C/index.docbook:2305
3740 msgid "Modernizing the documentation"
3741 msgstr "Modernizando a documentação"
3742
3743 #. (itstool) path: chapter/para
3744 #: C/index.docbook:2307
3745 msgid ""
3746 "GTK-Doc has been around for quite some time. In this section we list new "
3747 "features together with the version since when it is available."
3748 msgstr ""
3749 "GTK-Doc está por aí já faz um tempo. Nesta seção, nós listamos novas "
3750 "funcionalidades juntamente da versão desde a qual está disponível."
3751
3752 #. (itstool) path: sect1/title
3753 #: C/index.docbook:2313
3754 msgid "GTK-Doc 1.9"
3755 msgstr "GTK-Doc 1.9"
3756
3757 #. (itstool) path: sect1/para
3758 #: C/index.docbook:2315
3759 msgid ""
3760 "When using xml instead of sgml, one can actually name the master document "
3761 "<filename>&lt;package&gt;-docs.xml</filename>."
3762 msgstr ""
3763 "Ao usar xml em vez de sgml, na verdade, é possível nomear o documento mestre "
3764 "<filename>&lt;pacote&gt;-docs.xml</filename>."
3765
3766 #. (itstool) path: sect1/para
3767 #: C/index.docbook:2320
3768 msgid ""
3769 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3770 "<filename>Makefile.am</filename>. When this is enabled, the "
3771 "<filename>&lt;package&gt;-sections.txt</filename> is autogenerated and can "
3772 "be removed from the vcs. This only works nicely for projects that have a "
3773 "very regular structure (e.g. each .{c,h} pair will create new section). If "
3774 "one organize a project close to that updating a manually maintained section "
3775 "file can be as simple as running <code>meld &lt;package&gt;-decl-list.txt "
3776 "&lt;package&gt;-sections.txt</code>."
3777 msgstr ""
3778 "Essa versão provê suporte <option>SCAN_OPTIONS=--rebuild-sections</option> "
3779 "em <filename>Makefile.am</filename>. Quando esta opção está habilitada, o "
3780 "<filename>&lt;package&gt;-sections.txt</filename> é auto-gerado e pode ser "
3781 "removido a partir do VCS. Isso só funciona corretamente para projetos que "
3782 "têm uma estrutura muito regular (ex.: cada par .{c,h} vai criar uma nova "
3783 "seção). Se uma pessoa organiza um projeto próximo a isso atualizando um "
3784 "arquivo de seção mantido manualmente pode ser tão simples quanto executando "
3785 "<code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-sections.txt</code>."
3786
3787 #. (itstool) path: sect1/para
3788 #: C/index.docbook:2331
3789 msgid ""
3790 "Version 1.8 already introduced the syntax for documenting sections in the "
3791 "sources instead of the separate files under <filename "
3792 "class=\"directory\">tmpl</filename>. This version adds options to switch the "
3793 "whole doc module to not use the extra tmpl build step at all, by using "
3794 "<option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If "
3795 "you don't have a <filename class=\"directory\">tmpl</filename> checked into "
3796 "your source control system and haven't yet switched, just add the flag to "
3797 "<filename>configure.ac</filename> and you are done."
3798 msgstr ""
3799 "A versão 1.8 já introduziu a sintaxe para documentação seções nos fontes em "
3800 "vez dos arquivos separados sob <filename class=\"directory\">tmpl</"
3801 "filename>. Essa versão adiciona opções para alternar todo o módulo de "
3802 "documentação para não usar a etapa de compilação extra do tmpl, usando "
3803 "<option>--flavour no-tmpl</option> no <filename>configure.ac</filename>. Se "
3804 "você não possui um <filename class=\"directory\">tmpl</filename> no seu "
3805 "sistema de controle de versão e ainda não trocou, basta adicionar uma opção "
3806 "ao <filename>configure.ac</filename> e está resolvido."
3807
3808 #. (itstool) path: sect1/title
3809 #: C/index.docbook:2343
3810 msgid "GTK-Doc 1.10"
3811 msgstr "GTK-Doc 1.10"
3812
3813 #. (itstool) path: sect1/para
3814 #: C/index.docbook:2345
3815 msgid ""
3816 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
3817 "<filename>Makefile.am</filename>. When this is enabled, the "
3818 "<filename>&lt;package&gt;.types</filename> is autogenerated and can be "
3819 "removed from the vcs. When using this feature it is important to also setup "
3820 "the <varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
3821 "code that is build conditionally."
3822 msgstr ""
3823 "Essa versão provê suporte <option>SCAN_OPTIONS=--rebuild-types</option> no "
3824 "<filename>Makefile.am</filename>. Quando isso está habilitado, o "
3825 "<filename>&lt;package&gt;.types</filename> é auto-gerado e pode ser removido "
3826 "do VCS. Quando usando essa funcionalidade é importante também configurar o "
3827 "<varname>IGNORE_HFILES</varname> no <filename>Makefile.am</filename> para "
3828 "código que é compilado condicionalmente."
3829
3830 #. (itstool) path: sect1/title
3831 #: C/index.docbook:2356
3832 msgid "GTK-Doc 1.16"
3833 msgstr "GTK-Doc 1.16"
3834
3835 #. (itstool) path: example/title
3836 #: C/index.docbook:2362
3837 msgid "Enable gtkdoc-check"
3838 msgstr "Habilitar gtkdoc-check"
3839
3840 #. (itstool) path: example/programlisting
3841 #: C/index.docbook:2363
3842 #, no-wrap
3843 msgid ""
3844 "\n"
3845 "if ENABLE_GTK_DOC\n"
3846 "TESTS_ENVIRONMENT = \\\n"
3847 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3848 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3849 "TESTS = $(GTKDOC_CHECK)\n"
3850 "endif\n"
3851 msgstr ""
3852 "\n"
3853 "if ENABLE_GTK_DOC\n"
3854 "TESTS_ENVIRONMENT = \\\n"
3855 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3856 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3857 "TESTS = $(GTKDOC_CHECK)\n"
3858 "endif\n"
3859
3860 #. (itstool) path: sect1/para
3861 #: C/index.docbook:2358
3862 msgid ""
3863 "This version includes a new tool called gtkdoc-check. This tool can run a "
3864 "set of sanity checks on your documentation. It is enabled by adding these "
3865 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
3866 msgstr ""
3867 "Essa versão inclui uma nova ferramenta chamada gtkdoc-check. Essa ferramenta "
3868 "pode executar um conjunto de verificações de sanidade na sua documentação. "
3869 "Ela é habilitada adicionando essas linhas ao final do <filename>Makefile.am</"
3870 "filename>. <_:example-1/>"
3871
3872 #. (itstool) path: sect1/title
3873 #: C/index.docbook:2376
3874 msgid "GTK-Doc 1.20"
3875 msgstr "GTK-Doc 1.20"
3876
3877 #. (itstool) path: sect1/para
3878 #: C/index.docbook:2378
3879 msgid ""
3880 "Version 1.18 brought some initial markdown support. Using markdown in doc "
3881 "comments is less intrusive than writing docbook xml. This version improves a "
3882 "lot on this and add a lot more styles. The section that explains the <link "
3883 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
3884 msgstr ""
3885 "A versão 1.18 trouxe algum suporte inicial a markdown. O uso de markdown em "
3886 "comentários de documentação é menos intrusiva do que escrever xml de "
3887 "docbook. Essa versão melhora em muito nisso e adiciona muito mais estilos. A "
3888 "seção que explica a <link linkend=\"documenting_syntax\">sintaxe de "
3889 "comentário</link> tem todos os detalhes."
3890
3891 #. (itstool) path: sect1/title
3892 #: C/index.docbook:2388
3893 msgid "GTK-Doc 1.25"
3894 msgstr "GTK-Doc 1.25"
3895
3896 #. (itstool) path: example/title
3897 #: C/index.docbook:2399
3898 msgid "Use pre-generated entities"
3899 msgstr "Usando entradas geradas previamente"
3900
3901 #. (itstool) path: example/programlisting
3902 #: C/index.docbook:2400
3903 #, no-wrap
3904 msgid ""
3905 "\n"
3906 "&lt;?xml version=\"1.0\"?&gt;\n"
3907 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3908 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3909 "[\n"
3910 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3911 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3912 " %gtkdocentities;\n"
3913 "]&gt;\n"
3914 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3915 " &lt;bookinfo&gt;\n"
3916 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3917 " &lt;releaseinfo&gt;\n"
3918 " for &amp;package_string;.\n"
3919 " The latest version of this documentation can be found on-line at\n"
3920 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3921 " &lt;/releaseinfo&gt;\n"
3922 " &lt;/bookinfo&gt;\n"
3923 msgstr ""
3924 "\n"
3925 "&lt;?xml version=\"1.0\"?&gt;\n"
3926 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3927 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3928 "[\n"
3929 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3930 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3931 " %gtkdocentities;\n"
3932 "]&gt;\n"
3933 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3934 " &lt;bookinfo&gt;\n"
3935 " &lt;title&gt;Manual de referência do &amp;nome-pacote;&lt;/title&gt;\n"
3936 " &lt;releaseinfo&gt;\n"
3937 " para &amp;versão-pacote;.\n"
3938 " A última versão desta documentação pode ser encontra on-line em\n"
3939 " &lt;ulink role=\"online-location\" url=\"http://[SERVIDOR]/&amp;nome-pacote;/index.html\"&gt;http://[SERVIDOR]/&amp;nome-pacote;/&lt;/ulink&gt;.\n"
3940 " &lt;/releaseinfo&gt;\n"
3941 " &lt;/bookinfo&gt;\n"
3942
3943 #. (itstool) path: sect1/para
3944 #: C/index.docbook:2390
3945 msgid ""
3946 "The makefiles shipped with this version generate an entity file at "
3947 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
3948 "package_name and package_version. You can use this e.g. in the main xml file "
3949 "to avoid hardcoding the version number. Below is an example that shows how "
3950 "the entity file is included in the master template and how the entities are "
3951 "used. The entities can also be used in all generated files, GTK-Doc will use "
3952 "the same xml header in generated xml files. <_:example-1/>"
3953 msgstr ""
3954 "Os makefiles fornecidos com esta versão geram um arquivo de entidade em "
3955 "<filename>xml/gtkdocentities.ent</filename>, contendo entidades para, por "
3956 "exemplo, nome-pacote e versão-pacote. Você pode usar isto, por exemplo, no "
3957 "arquivo xml principal para evitar ter que inserir diretamente o número de "
3958 "versão. Logo abaixo encontra-se um exemplo que mostra como o arquivo de "
3959 "entidade é incluído no modelo mestre e como as entidades são usadas. As "
3960 "entidades também podem ser usadas em todos arquivos gerados, GTK-Doc usará o "
3961 "mesmo cabeçalho xml nos arquivos xml gerados. <_:example-1/>"
3962
3963 #. (itstool) path: chapter/title
3964 #: C/index.docbook:2425
3965 msgid "Documenting other interfaces"
3966 msgstr "Documentando outras interfaces"
3967
3968 #. (itstool) path: chapter/para
3969 #: C/index.docbook:2427
3970 msgid ""
3971 "So far we have been using GTK-Doc to document the API of code. The next "
3972 "sections contain suggestions how the tools can be used to document other "
3973 "interfaces too."
3974 msgstr ""
3975 "Até agora nós temos usado o GTK-Doc para documentar a API de um código. As "
3976 "próximas sessões contêm sugestões de como as ferramentas podem ser usadas "
3977 "para documentar outras interfaces, também."
3978
3979 #. (itstool) path: sect1/title
3980 #: C/index.docbook:2434
3981 msgid "Command line options and man pages"
3982 msgstr "Opções de linha de comando e de páginas man"
3983
3984 # RefEntry é uma página de referência do DocBook (http://www.docbook.org/tdg/en/html/refentry.html)
3985 #. (itstool) path: sect1/para
3986 #: C/index.docbook:2436
3987 msgid ""
3988 "As one can generate man pages for a docbook refentry as well, it sounds like "
3989 "a good idea to use it for that purpose. This way the interface is part of "
3990 "the reference and one gets the man-page for free."
3991 msgstr ""
3992 "Já que também é possível gerar páginas man para um refentry do docbook, soa "
3993 "como uma boa ideia usá-lo para este propósito. Desta forma, a interface é "
3994 "parte da referência e é possível obter a página man livremente."
3995
3996 #. (itstool) path: sect2/title
3997 #: C/index.docbook:2443
3998 msgid "Document the tool"
3999 msgstr "Documentar a ferramenta"
4000
4001 #. (itstool) path: sect2/para
4002 #: C/index.docbook:2445
4003 msgid ""
4004 "Create one refentry file per tool. Following <link "
4005 "linkend=\"settingup_docfiles\">our example</link> we would call it "
4006 "<filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags "
4007 "that should be used and can look at generated file in the xml subdirectory "
4008 "as well as examples e.g. in glib."
4009 msgstr ""
4010 "Crie um arquivo refentry por ferramenta. Segundo <link "
4011 "linkend=\"settingup_docfiles\">nosso exemplo</link> nós chamaríamos ele de "
4012 "<filename>meep/docs/reference/meeper/meep.xml</filename>. Para as tags xml "
4013 "que devem ser usadas e podem parecer no arquivo gerado no subdiretório xml "
4014 "assim como exemplos, por exemplo, em glib."
4015
4016 #. (itstool) path: sect2/title
4017 #: C/index.docbook:2455
4018 msgid "Adding the extra configure check"
4019 msgstr "Adicionando a verificação extra ao configure"
4020
4021 #. (itstool) path: example/title
4022 #: C/index.docbook:2458 C/index.docbook:2476
4023 msgid "Extra configure checks"
4024 msgstr "Verificações extra no configure"
4025
4026 #. (itstool) path: example/programlisting
4027 #: C/index.docbook:2459
4028 #, no-wrap
4029 msgid ""
4030 "\n"
4031 "AC_ARG_ENABLE(man,\n"
4032 " [AC_HELP_STRING([--enable-man],\n"
4033 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4034 " enable_man=no)\n"
4035 "\n"
4036 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4037 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4038 msgstr ""
4039 "\n"
4040 "AC_ARG_ENABLE(man,\n"
4041 " [AC_HELP_STRING([--enable-man],\n"
4042 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4043 " enable_man=no)\n"
4044 "\n"
4045 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4046 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4047
4048 #. (itstool) path: sect2/title
4049 #: C/index.docbook:2473
4050 msgid "Adding the extra makefile rules"
4051 msgstr "Adicionando as regras extras ao makefile"
4052
4053 #. (itstool) path: example/programlisting
4054 #: C/index.docbook:2477
4055 #, no-wrap
4056 msgid ""
4057 "\n"
4058 "man_MANS = \\\n"
4059 " meeper.1\n"
4060 "\n"
4061 "if ENABLE_GTK_DOC\n"
4062 "if ENABLE_MAN\n"
4063 "\n"
4064 "%.1 : %.xml\n"
4065 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4066 "\n"
4067 "endif\n"
4068 "endif\n"
4069 "\n"
4070 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4071 "EXTRA_DIST += meep.xml\n"
4072 msgstr ""
4073 "\n"
4074 "man_MANS = \\\n"
4075 " meeper.1\n"
4076 "\n"
4077 "if ENABLE_GTK_DOC\n"
4078 "if ENABLE_MAN\n"
4079 "\n"
4080 "%.1 : %.xml\n"
4081 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4082 "\n"
4083 "endif\n"
4084 "endif\n"
4085 "\n"
4086 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4087 "EXTRA_DIST += meep.xml\n"
4088
4089 #. (itstool) path: sect1/title
4090 #: C/index.docbook:2499
4091 msgid "DBus interfaces"
4092 msgstr "Interfaces DBus"
4093
4094 #. (itstool) path: sect1/para
4095 #: C/index.docbook:2501
4096 msgid ""
4097 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4098 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4099 msgstr ""
4100 "(CORRIJA-ME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, "
4101 "http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4102
4103 #. (itstool) path: chapter/title
4104 #: C/index.docbook:2510
4105 msgid "Frequently asked questions"
4106 msgstr "Perguntas frequentes"
4107
4108 #. (itstool) path: segmentedlist/segtitle
4109 #: C/index.docbook:2514
4110 msgid "Question"
4111 msgstr "Questão"
4112
4113 #. (itstool) path: segmentedlist/segtitle
4114 #: C/index.docbook:2515
4115 msgid "Answer"
4116 msgstr "Resposta"
4117
4118 #. (itstool) path: seglistitem/seg
4119 #: C/index.docbook:2517
4120 msgid "No class hierarchy."
4121 msgstr "Sem hierarquia de classe."
4122
4123 #. (itstool) path: seglistitem/seg
4124 #: C/index.docbook:2518
4125 msgid ""
4126 "The objects <function>xxx_get_type()</function> function has not been "
4127 "entered into the <filename>&lt;package&gt;.types</filename> file."
4128 msgstr ""
4129 "A função de objetos <function>xxx_get_type()</function> não foi inserida no "
4130 "arquivo <filename>&lt;pacote&gt;.types</filename>."
4131
4132 #. (itstool) path: seglistitem/seg
4133 #: C/index.docbook:2524
4134 msgid "Still no class hierarchy."
4135 msgstr "Ainda sem hierarquia."
4136
4137 #. (itstool) path: seglistitem/seg
4138 #: C/index.docbook:2525
4139 msgid ""
4140 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4141 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4142 "October/msg00006.html\">explanation</ulink>)."
4143 msgstr ""
4144 "Nomenclatura faltando ou incorreta no arquivo <filename>&lt;pacote&gt;-"
4145 "sections.txt</filename> (veja a <ulink url=\"http://mail.gnome.org/archives/"
4146 "gtk-doc-list/2003-October/msg00006.html\">explicação</ulink>)."
4147
4148 #. (itstool) path: seglistitem/seg
4149 #: C/index.docbook:2531
4150 msgid "Damn, I have still no class hierarchy."
4151 msgstr "Droga. Eu ainda não tenho hierarquia de classes."
4152
4153 #. (itstool) path: seglistitem/seg
4154 #: C/index.docbook:2532
4155 msgid ""
4156 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
4157 "type>) part of the normal section (don't put this into Standard or Private "
4158 "subsections)."
4159 msgstr ""
4160 "Por acaso o nome do objeto (nome da struct da instância, ex. "
4161 "<type>GtkWidget</type>) faz parte da seção normal (não coloque isso em "
4162 "subseções Standard ou Private)."
4163
4164 #. (itstool) path: seglistitem/seg
4165 #: C/index.docbook:2539
4166 msgid "No symbol index."
4167 msgstr "Nenhum símbolo de índice."
4168
4169 #. (itstool) path: seglistitem/seg
4170 #: C/index.docbook:2540
4171 msgid ""
4172 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
4173 "index that xi:includes the generated index?"
4174 msgstr ""
4175 "O <filename>&lt;pacote&gt;-docs.{xml,sgml}</filename> contém um índice que "
4176 "“xi:inclui” o índice gerado?"
4177
4178 #. (itstool) path: seglistitem/seg
4179 #: C/index.docbook:2546
4180 msgid "Symbols are not linked to their doc-section."
4181 msgstr "Símbolos não estão vinculados ao seus doc-section."
4182
4183 #. (itstool) path: seglistitem/seg
4184 #: C/index.docbook:2547
4185 msgid ""
4186 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4187 "gtkdoc-fixxref warns about unresolvable xrefs."
4188 msgstr ""
4189 "O doc-comment está usando a marcação correta (adicionado #,% or ())? "
4190 "Verifique se o gtkdoc-fixxref avisa sobre xrefs não resolvidos."
4191
4192 #. (itstool) path: seglistitem/seg
4193 #: C/index.docbook:2553
4194 msgid "A new class does not appear in the docs."
4195 msgstr "Uma nova classe não aparece nos documentos."
4196
4197 #. (itstool) path: seglistitem/seg
4198 #: C/index.docbook:2554
4199 msgid ""
4200 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4201 "filename>."
4202 msgstr ""
4203 "A nova página foi “xi:incluída” do <filename>&lt;pacote&gt;-docs.{xml,sgml}</"
4204 "filename>."
4205
4206 #. (itstool) path: seglistitem/seg
4207 #: C/index.docbook:2560
4208 msgid "A new symbol does not appear in the docs."
4209 msgstr "Um novo símbolo não aparece nos documentos."
4210
4211 #. (itstool) path: seglistitem/seg
4212 #: C/index.docbook:2561
4213 msgid ""
4214 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4215 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4216 "xrefs. Check if the symbol is correctly listed in the "
4217 "<filename>&lt;package&gt;-sections.txt</filename> in a public subsection."
4218 msgstr ""
4219 "O doc-comment está formatado adequadamente? Verifique erros de escrita no "
4220 "começo do comentário. Verifique se o gtkdoc-fixxref avisa sobre xrefs não "
4221 "resolvíveis. Verifique se o símbolo está listado corretamente no "
4222 "<filename>&lt;pacote&gt;-sections.txt</filename> em uma subseção pública."
4223
4224 #. (itstool) path: seglistitem/seg
4225 #: C/index.docbook:2569
4226 msgid "A type is missing from the class hierarchy."
4227 msgstr "Um tipo está faltando da hierarquia de classe."
4228
4229 #. (itstool) path: seglistitem/seg
4230 #: C/index.docbook:2570
4231 msgid ""
4232 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4233 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4234 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4235 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
4236 "or incidentally marked private it will not be shown."
4237 msgstr ""
4238 "Se o tipo está listado no <filename>&lt;pacote&gt;.hierarchy</filename>, mas "
4239 "não em <filename>xml/tree_index.sgml</filename>, então certifique-se de que "
4240 "o tipo está colocado corretamente no <filename>&lt;pacote&gt;-sections.txt</"
4241 "filename>. Se a instância do tipo (ex.: <type>GtkWidget</type>) não está "
4242 "listada ou incidentalmente marcada como privada, ela não será mostrada."
4243
4244 #. (itstool) path: seglistitem/seg
4245 #: C/index.docbook:2579
4246 msgid "I get foldoc links for all gobject annotations."
4247 msgstr ""
4248 "Obtenho links de seguimento de documentos para todas as anotações gobject."
4249
4250 #. (itstool) path: seglistitem/seg
4251 #: C/index.docbook:2580
4252 msgid ""
4253 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4254 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4255 msgstr ""
4256 "Verifique se <filename>xml/annotation-glossary.xml</filename> está "
4257 "“xi:incluído” de <filename>&lt;pacote&gt;-docs.{xml,sgml}</filename>."
4258
4259 #. (itstool) path: seglistitem/seg
4260 #: C/index.docbook:2588
4261 msgid "Parameter described in source code comment block but does not exist"
4262 msgstr "Parâmetro descrito no bloco de comentário do código-fonte não existe"
4263
4264 #. (itstool) path: seglistitem/seg
4265 #: C/index.docbook:2589
4266 msgid ""
4267 "Check if the prototype in the header has different parameter names as in the "
4268 "source."
4269 msgstr ""
4270 "Verifique se o protótipo no cabeçalho tem nomes de parâmetros diferentes da "
4271 "fonte."
4272
4273 #. (itstool) path: seglistitem/seg
4274 #: C/index.docbook:2594
4275 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4276 msgstr "múltiplos “IDs” para restrições do fim do link XYZ"
4277
4278 #. (itstool) path: seglistitem/seg
4279 #: C/index.docbook:2595
4280 msgid ""
4281 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
4282 "filename> file."
4283 msgstr ""
4284 "O símbolo XYZ aparece duas vezes no arquivo <filename>&lt;pacote&gt;-"
4285 "sections.txt</filename>."
4286
4287 #. (itstool) path: seglistitem/seg
4288 #: C/index.docbook:2598
4289 msgid ""
4290 "Element typename in namespace '' encountered in para, but no template "
4291 "matches."
4292 msgstr ""
4293 "Elemento typename no espaço de nome '' encontrado em para, mas nenhum modelo "
4294 "correspondeu."
4295
4296 #. (itstool) path: chapter/title
4297 #: C/index.docbook:2605
4298 msgid "Tools related to gtk-doc"
4299 msgstr "Ferramentas relacionadas ao gtk-doc"
4300
4301 #. (itstool) path: chapter/para
4302 #: C/index.docbook:2607
4303 msgid ""
4304 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4305 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4306 "integrates with the trac search."
4307 msgstr ""
4308 "GtkDocPlugin – um plug-in de integração com <ulink url=\"http://trac-"
4309 "hacks.org/wiki/GtkDocPlugin\">Trac GTK-Doc</ulink>, que adiciona documentos "
4310 "de API a um site trac e integra com a pesquisa do trac."
4311
4312 #. (itstool) path: chapter/para
4313 #: C/index.docbook:2612
4314 msgid ""
4315 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
4316 "tags in the API to determine the minimum required version."
4317 msgstr ""
4318 "Gtkdoc-depscan – uma ferramenta (parte do gtk-doc) para verificar APIs "
4319 "usadas, a partir de suas tags, para determinar a versão mínima necessária."
4320
4321 #. (itstool) path: appendixinfo/releaseinfo
4322 #: C/fdl-appendix.xml:12
4323 msgid "Version 1.1, March 2000"
4324 msgstr "Versão 1.1, Março de 2000"
4325
4326 #. (itstool) path: copyright/year
4327 #: C/fdl-appendix.xml:16
4328 msgid "2000"
4329 msgstr "2000"
4330
4331 #. (itstool) path: copyright/holder
4332 #: C/fdl-appendix.xml:16
4333 msgid "Free Software Foundation, Inc."
4334 msgstr "Free Software Foundation, Inc."
4335
4336 #. (itstool) path: address/street
4337 #: C/fdl-appendix.xml:20
4338 msgid "51 Franklin Street, Suite 330"
4339 msgstr "51 Franklin Street, Suite 330"
4340
4341 #. (itstool) path: address/city
4342 #: C/fdl-appendix.xml:21
4343 msgid "Boston"
4344 msgstr "Boston"
4345
4346 #. (itstool) path: address/state
4347 #: C/fdl-appendix.xml:21
4348 msgid "MA"
4349 msgstr "MA"
4350
4351 #. (itstool) path: address/postcode
4352 #: C/fdl-appendix.xml:22
4353 msgid "02110-1301"
4354 msgstr "02110-1301"
4355
4356 #. (itstool) path: address/country
4357 #: C/fdl-appendix.xml:22
4358 msgid "USA"
4359 msgstr "USA"
4360
4361 #. (itstool) path: para/address
4362 #: C/fdl-appendix.xml:20
4363 msgid ""
4364 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4365 "<_:postcode-4/> <_:country-5/>"
4366 msgstr ""
4367 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4368 "<_:postcode-4/> <_:country-5/>"
4369
4370 #. (itstool) path: legalnotice/para
4371 #: C/fdl-appendix.xml:19
4372 msgid ""
4373 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
4374 "of this license document, but changing it is not allowed."
4375 msgstr ""
4376 "<_:address-1/> É permitido a qualquer um copiar e distribuir cópias exatas "
4377 "deste documento de licença, embora não seja permitido alterá-lo."
4378
4379 #. (itstool) path: appendix/title
4380 #. (itstool) path: para/quote
4381 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4382 msgid "GNU Free Documentation License"
4383 msgstr "Licença de Documentação Livre GNU"
4384
4385 #. (itstool) path: sect1/title
4386 #: C/fdl-appendix.xml:31
4387 msgid "0. PREAMBLE"
4388 msgstr "0. PREÂMBULO"
4389
4390 #. (itstool) path: para/quote
4391 #: C/fdl-appendix.xml:34
4392 msgid "free"
4393 msgstr "livre"
4394
4395 #. (itstool) path: sect1/para
4396 #: C/fdl-appendix.xml:32
4397 msgid ""
4398 "The purpose of this License is to make a manual, textbook, or other written "
4399 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
4400 "effective freedom to copy and redistribute it, with or without modifying it, "
4401 "either commercially or noncommercially. Secondarily, this License preserves "
4402 "for the author and publisher a way to get credit for their work, while not "
4403 "being considered responsible for modifications made by others."
4404 msgstr ""
4405 "O propósito desta Licença é fazer um manual, livro-texto, ou outro documento "
4406 "escrito <_:quote-1/> em seu sentido de liberdade: para garantir a todos a "
4407 "liberdade efetiva de copiá-lo e redistribui-lo, com ou sem modificações, "
4408 "tanto comercialmente como não comercialmente. Em segundo lugar, esta Licença "
4409 "preserva ao autor e ao editor uma forma de obter crédito pelo seu trabalho, "
4410 "enquanto não é considerado responsável por modificações feitas por outros."
4411
4412 #. (itstool) path: para/quote
4413 #: C/fdl-appendix.xml:44
4414 msgid "copyleft"
4415 msgstr "copyleft"
4416
4417 #. (itstool) path: sect1/para
4418 #: C/fdl-appendix.xml:43
4419 msgid ""
4420 "This License is a kind of <_:quote-1/>, which means that derivative works of "
4421 "the document must themselves be free in the same sense. It complements the "
4422 "GNU General Public License, which is a copyleft license designed for free "
4423 "software."
4424 msgstr ""
4425 "Esta licença é um tipo de <_:quote-1/>, que significa que trabalhos "
4426 "derivados do documento precisam ser, por sua vez, livres no mesmo sentido. "
4427 "Ela complementa a Licença Pública Geral GNU (GNU General Public License), "
4428 "que é uma licença copyleft projetada para softwares livres."
4429
4430 #. (itstool) path: sect1/para
4431 #: C/fdl-appendix.xml:50
4432 msgid ""
4433 "We have designed this License in order to use it for manuals for free "
4434 "software, because free software needs free documentation: a free program "
4435 "should come with manuals providing the same freedoms that the software does. "
4436 "But this License is not limited to software manuals; it can be used for any "
4437 "textual work, regardless of subject matter or whether it is published as a "
4438 "printed book. We recommend this License principally for works whose purpose "
4439 "is instruction or reference."
4440 msgstr ""
4441 "Criamos esta Licença para usá-la para manuais para software livre, porque "
4442 "software livre precisa de documentação livre: um programa livre deve ser "
4443 "fornecido com manuais que proporcionam as mesmas liberdades que o software. "
4444 "Mas esta Licença não está limitada aos manuais de software; pode ser usada "
4445 "para qualquer trabalho textual, independentemente do assunto ou dele ser "
4446 "publicado como um livro impresso. Recomendamos esta Licença principalmente "
4447 "para trabalhos cujo propósito seja instrução ou referência."
4448
4449 #. (itstool) path: sect1/title
4450 #: C/fdl-appendix.xml:62
4451 msgid "1. APPLICABILITY AND DEFINITIONS"
4452 msgstr "1. APLICABILIDADE E DEFINIÇÕES"
4453
4454 #. (itstool) path: para/quote
4455 #. (itstool) path: para/link
4456 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
4457 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
4458 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
4459 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
4460 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
4461 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
4462 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
4463 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
4464 #: C/fdl-appendix.xml:608
4465 msgid "Document"
4466 msgstr "Documento"
4467
4468 #. (itstool) path: para/quote
4469 #: C/fdl-appendix.xml:69
4470 msgid "you"
4471 msgstr "você"
4472
4473 #. (itstool) path: sect1/para
4474 #: C/fdl-appendix.xml:63
4475 msgid ""
4476 "This License applies to any manual or other work that contains a notice "
4477 "placed by the copyright holder saying it can be distributed under the terms "
4478 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
4479 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
4480 msgstr ""
4481 "Esta Licença se aplica a qualquer manual ou outro trabalho que contenha um "
4482 "aviso colocado pelo detentor dos direitos autorais dizendo que o documento "
4483 "pode ser distribuído sob os termos desta. O <_:quote-1/>, abaixo, refere-se "
4484 "a qualquer manual ou trabalho. Qualquer membro do público é um licenciado, e "
4485 "será referenciado como <_:quote-2/>."
4486
4487 #. (itstool) path: para/quote
4488 #. (itstool) path: para/link
4489 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
4490 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
4491 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
4492 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
4493 msgid "Modified Version"
4494 msgstr "Versão modificada"
4495
4496 #. (itstool) path: sect1/para
4497 #: C/fdl-appendix.xml:72
4498 msgid ""
4499 "A <_:quote-1/> of the Document means any work containing the Document or a "
4500 "portion of it, either copied verbatim, or with modifications and/or "
4501 "translated into another language."
4502 msgstr ""
4503 "Uma <_:quote-1/> do Documento significa qualquer trabalho contendo o "
4504 "Documento ou uma porção deste, seja uma cópia literal ou com modificações e/"
4505 "ou traduzido em outro idioma."
4506
4507 #. (itstool) path: para/quote
4508 #: C/fdl-appendix.xml:80
4509 msgid "Secondary Section"
4510 msgstr "Seção da secundária"
4511
4512 #. (itstool) path: sect1/para
4513 #: C/fdl-appendix.xml:79
4514 msgid ""
4515 "A <_:quote-1/> is a named appendix or a front-matter section of the "
4516 "<_:link-2/> that deals exclusively with the relationship of the publishers "
4517 "or authors of the Document to the Document's overall subject (or to related "
4518 "matters) and contains nothing that could fall directly within that overall "
4519 "subject. (For example, if the Document is in part a textbook of mathematics, "
4520 "a Secondary Section may not explain any mathematics.) The relationship could "
4521 "be a matter of historical connection with the subject or with related "
4522 "matters, or of legal, commercial, philosophical, ethical or political "
4523 "position regarding them."
4524 msgstr ""
4525 "Uma <_:quote-1/> é um apêndice com nome ou uma seção inicial do <_:link-2/> "
4526 "que trata exclusivamente da relação dos editores ou autores do Documento com "
4527 "seu assunto geral (ou temas relacionados) e não contém nada que possa estar "
4528 "diretamente dentro do assunto geral. (Por exemplo, se o Documento é em parte "
4529 "um livro-texto de matemática, uma Seção Secundária não pode explicar nada de "
4530 "matemática). Tal relação pode ser uma questão de conexão histórica com o "
4531 "assunto ou com temas relacionados, ou tratar de questões legais, comerciais, "
4532 "filosóficas, éticas ou políticas com relação a eles."
4533
4534 #. (itstool) path: para/quote
4535 #. (itstool) path: para/link
4536 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
4537 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
4538 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
4539 msgid "Invariant Sections"
4540 msgstr "Sessões invariantes"
4541
4542 #. (itstool) path: para/link
4543 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
4544 msgid "Secondary Sections"
4545 msgstr "Sessões secundárias"
4546
4547 #. (itstool) path: sect1/para
4548 #: C/fdl-appendix.xml:94
4549 msgid ""
4550 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
4551 "being those of Invariant Sections, in the notice that says that the "
4552 "<_:link-3/> is released under this License."
4553 msgstr ""
4554 "As <_:quote-1/> são certas <_:link-2/> cujos títulos são designados como "
4555 "sendo de Seções Invariantes na nota que afirma que o <_:link-3/> é publicado "
4556 "sob esta Licença."
4557
4558 #. (itstool) path: para/quote
4559 #. (itstool) path: para/link
4560 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
4561 #: C/fdl-appendix.xml:458
4562 msgid "Cover Texts"
4563 msgstr "Textos de Capa"
4564
4565 #. (itstool) path: sect1/para
4566 #: C/fdl-appendix.xml:103
4567 msgid ""
4568 "The <_:quote-1/> are certain short passages of text that are listed, as "
4569 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the "
4570 "<_:link-2/> is released under this License."
4571 msgstr ""
4572 "Os <_:quote-1/> são certas passagens de texto curtas que são listadas, como "
4573 "Textos de Capa Frontal ou Texto de Contra Capa, na nota que afirma que o "
4574 "<_:link-2/> é publicado sob esta Licença."
4575
4576 #. (itstool) path: para/quote
4577 #. (itstool) path: para/link
4578 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
4579 #: C/fdl-appendix.xml:369
4580 msgid "Transparent"
4581 msgstr "Transparente"
4582
4583 #. (itstool) path: para/quote
4584 #. (itstool) path: para/link
4585 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
4586 msgid "Opaque"
4587 msgstr "Opaco"
4588
4589 #. (itstool) path: sect1/para
4590 #: C/fdl-appendix.xml:111
4591 msgid ""
4592 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
4593 "represented in a format whose specification is available to the general "
4594 "public, whose contents can be viewed and edited directly and "
4595 "straightforwardly with generic text editors or (for images composed of "
4596 "pixels) generic paint programs or (for drawings) some widely available "
4597 "drawing editor, and that is suitable for input to text formatters or for "
4598 "automatic translation to a variety of formats suitable for input to text "
4599 "formatters. A copy made in an otherwise Transparent file format whose markup "
4600 "has been designed to thwart or discourage subsequent modification by readers "
4601 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
4602 msgstr ""
4603 "Uma cópia <_:quote-1/> do <_:link-2/> significa uma cópia legível por "
4604 "máquina, representada em um formato cuja especificação esteja disponível ao "
4605 "público geral e que cujo conteúdo possa ser visualizado e editado de forma "
4606 "clara e direta por editores de texto genéricos ou programas genéricos de "
4607 "desenho (para imagens compostas de pixels) ou para alguns dos editores de "
4608 "desenho amplamente disponíveis (para desenhos) e que seja apropriado para "
4609 "inclusão em formatadores de texto ou para a tradução automática em uma "
4610 "variedade de formatos apropriados de entrada em formatadores de texto. Uma "
4611 "cópia feita em outro formato de arquivo Transparente cuja marcação, ou "
4612 "ausência desta, tenha sido manipulada para impedir ou desencorajar "
4613 "modificação subsequente pelos leitores não é Transparente. Uma cópia que não "
4614 "é <_:quote-3/> é chamada <_:quote-4/>."
4615
4616 #. (itstool) path: sect1/para
4617 #: C/fdl-appendix.xml:128
4618 msgid ""
4619 "Examples of suitable formats for Transparent copies include plain ASCII "
4620 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
4621 "a publicly available DTD, and standard-conforming simple HTML designed for "
4622 "human modification. Opaque formats include PostScript, PDF, proprietary "
4623 "formats that can be read and edited only by proprietary word processors, "
4624 "SGML or XML for which the DTD and/or processing tools are not generally "
4625 "available, and the machine-generated HTML produced by some word processors "
4626 "for output purposes only."
4627 msgstr ""
4628 "Exemplos de formatos adequados para cópias Transparentes incluem ASCII "
4629 "simples sem marcação, formato de entrada Texinfo, formato de entrada LaTeX, "
4630 "SGML ou XML usando DTD publicamente disponível e HTML simples, conforme "
4631 "padrão, projetados para modificação humana. Os formatos Opacos incluem "
4632 "PostScript, PDF, formatos proprietários que podem ser lidos e editados "
4633 "apenas por processadores de texto proprietários, SGML ou XML para os quais o "
4634 "DTD e/ou ferramentas de processamento não estão geralmente disponíveis e o "
4635 "HTML gerado por máquina produzido por alguns processadores de texto para "
4636 "apenas para fins de saída."
4637
4638 #. (itstool) path: para/quote
4639 #. (itstool) path: para/link
4640 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
4641 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
4642 msgid "Title Page"
4643 msgstr "Título da página"
4644
4645 #. (itstool) path: sect1/para
4646 #: C/fdl-appendix.xml:141
4647 msgid ""
4648 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
4649 "following pages as are needed to hold, legibly, the material this License "
4650 "requires to appear in the title page. For works in formats which do not have "
4651 "any title page as such, <_:quote-2/> means the text near the most prominent "
4652 "appearance of the work's title, preceding the beginning of the body of the "
4653 "text."
4654 msgstr ""
4655 "A <_:quote-1/> significa, para um livro impresso, a própria página do "
4656 "título, além das páginas subsequentes necessárias para conter, de forma "
4657 "legível, o material que esta Licença requer que apareça na página do título. "
4658 "Para trabalhos em formatos que não possuem qualquer página de título "
4659 "semelhante, <_:quote-2/> significa o texto próximo à ocorrência mais "
4660 "proeminente do título do trabalho, precedendo o início do corpo do texto."
4661
4662 #. (itstool) path: sect1/title
4663 #: C/fdl-appendix.xml:153
4664 msgid "2. VERBATIM COPYING"
4665 msgstr "2. CÓPIA LITERAL"
4666
4667 #. (itstool) path: para/link
4668 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
4669 msgid "section 3"
4670 msgstr "seção 3"
4671
4672 #. (itstool) path: sect1/para
4673 #: C/fdl-appendix.xml:154
4674 msgid ""
4675 "You may copy and distribute the <_:link-1/> in any medium, either "
4676 "commercially or noncommercially, provided that this License, the copyright "
4677 "notices, and the license notice saying this License applies to the Document "
4678 "are reproduced in all copies, and that you add no other conditions "
4679 "whatsoever to those of this License. You may not use technical measures to "
4680 "obstruct or control the reading or further copying of the copies you make or "
4681 "distribute. However, you may accept compensation in exchange for copies. If "
4682 "you distribute a large enough number of copies you must also follow the "
4683 "conditions in <_:link-2/>."
4684 msgstr ""
4685 "Você pode copiar e distribuir o <_:link-1/> em qualquer meio, seja este de "
4686 "forma comercial ou não, desde que esta licença, as notas de direitos "
4687 "autorais (copyright), e a nota de licença afirmando que esta Licença se "
4688 "aplica ao Documento sejam reproduzidas em todas as cópias, e que você não "
4689 "inclua outras condições, quaisquer que sejam, às condições desta Licença. "
4690 "Você não pode usar de medidas técnicas para obstruir ou controlar a leitura "
4691 "ou cópia futura das cópias que você fizer ou distribuir. Contudo, você pode "
4692 "aceitar compensação em troca das cópias. Se você distribuir um número "
4693 "suficientemente grande de cópias, você deve também respeitar as condições "
4694 "descritas na <_:link-2/>."
4695
4696 #. (itstool) path: sect1/para
4697 #: C/fdl-appendix.xml:169
4698 msgid ""
4699 "You may also lend copies, under the same conditions stated above, and you "
4700 "may publicly display copies."
4701 msgstr ""
4702 "Você também pode emprestar cópias, nas mesmas condições acima mencionadas, e "
4703 "você pode publicar cópias."
4704
4705 #. (itstool) path: sect1/title
4706 #: C/fdl-appendix.xml:176
4707 msgid "3. COPYING IN QUANTITY"
4708 msgstr "3. COPIANDO EM QUANTIDADE"
4709
4710 #. (itstool) path: sect1/para
4711 #: C/fdl-appendix.xml:177
4712 msgid ""
4713 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
4714 "and the Document's license notice requires <_:link-2/>, you must enclose the "
4715 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
4716 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
4717 "cover. Both covers must also clearly and legibly identify you as the "
4718 "publisher of these copies. The front cover must present the full title with "
4719 "all words of the title equally prominent and visible. You may add other "
4720 "material on the covers in addition. Copying with changes limited to the "
4721 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
4722 "these conditions, can be treated as verbatim copying in other respects."
4723 msgstr ""
4724 "Se você publicar cópias impressas do <_:link-1/>, em número maior que 100, e "
4725 "a nota de licença do Documento exigir <_:link-2/>, você deve encadernar as "
4726 "cópias em capas que carreguem, de forma clara e legível, todos estes Textos "
4727 "de Capa: Textos de Capa Frontal na capa frontal e Textos de Contracapa na "
4728 "contracapa. Ambas as capas devem também identificar, de forma clara e "
4729 "legível, você como o editor das cópias. A capa frontal deve apresentar o "
4730 "título completo com todas as palavras deste igualmente proeminentes e "
4731 "visíveis. Além disso, você pode adicionar outro material nas capas. As "
4732 "cópias com mudanças limitadas às capas, desde que preservem o título do "
4733 "<_:link-3/> e satisfaçam estas condições podem ser tratadas como cópias "
4734 "literais em outros aspectos."
4735
4736 #. (itstool) path: sect1/para
4737 #: C/fdl-appendix.xml:195
4738 msgid ""
4739 "If the required texts for either cover are too voluminous to fit legibly, "
4740 "you should put the first ones listed (as many as fit reasonably) on the "
4741 "actual cover, and continue the rest onto adjacent pages."
4742 msgstr ""
4743 "Se os textos necessários para qualquer uma das coberturas forem demasiado "
4744 "volumosos para se ajustar de forma legível, você deve colocar os primeiros "
4745 "listados (tanto quanto encaixar razoavelmente) na capa real e continuar o "
4746 "resto em páginas adjacentes."
4747
4748 #. (itstool) path: sect1/para
4749 #: C/fdl-appendix.xml:202
4750 msgid ""
4751 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
4752 "more than 100, you must either include a machine-readable <_:link-3/> copy "
4753 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
4754 "accessible computer-network location containing a complete Transparent copy "
4755 "of the Document, free of added material, which the general network-using "
4756 "public has access to download anonymously at no charge using public-standard "
4757 "network protocols. If you use the latter option, you must take reasonably "
4758 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
4759 "ensure that this Transparent copy will remain thus accessible at the stated "
4760 "location until at least one year after the last time you distribute an "
4761 "Opaque copy (directly or through your agents or retailers) of that edition "
4762 "to the public."
4763 msgstr ""
4764 "Se você publicar ou distribuir cópias <_:link-1/> do <_:link-2/> em número "
4765 "maior que 100, você deve incluir uma cópia <_:link-3/> legível por máquina "
4766 "juntamente com cada cópia Opaca, ou dizer em (ou juntamente com) cada cópia "
4767 "Opaca, um endereço de rede a partir do qual o público geral de usuários "
4768 "possam acessar e obter de forma anônima e sob nenhum custo, usando "
4769 "protocolos de rede públicos padrão, uma cópia Transparente completa do "
4770 "Documento, livre de materiais adicionados. Se você decidir pela segunda "
4771 "opção, você deve seguir passos com certa prudência ao começar a distribuir "
4772 "as cópias Opacas em quantidade, a fim de garantir que esta cópia "
4773 "transparente permanecerá acessível no local indicado por pelo menos um ano "
4774 "após a última vez que você distribuir uma cópia Opaca (diretamente ou "
4775 "através de seus agentes ou distribuidores) desta edição ao público."
4776
4777 #. (itstool) path: sect1/para
4778 #: C/fdl-appendix.xml:222
4779 msgid ""
4780 "It is requested, but not required, that you contact the authors of the "
4781 "<_:link-1/> well before redistributing any large number of copies, to give "
4782 "them a chance to provide you with an updated version of the Document."
4783 msgstr ""
4784 "É solicitado, mas não exigido, que você contate os autores do <_:link-1/> "
4785 "muito antes de redistribuir qualquer grande número de cópias, para dar a "
4786 "eles uma chance de lhe fornecer uma versão atualizada do Documento."
4787
4788 #. (itstool) path: sect1/title
4789 #: C/fdl-appendix.xml:231
4790 msgid "4. MODIFICATIONS"
4791 msgstr "4. MODIFICAÇÕES"
4792
4793 #. (itstool) path: para/link
4794 #: C/fdl-appendix.xml:236
4795 msgid "2"
4796 msgstr "2"
4797
4798 #. (itstool) path: para/link
4799 #: C/fdl-appendix.xml:237
4800 msgid "3"
4801 msgstr "3"
4802
4803 #. (itstool) path: sect1/para
4804 #: C/fdl-appendix.xml:232
4805 msgid ""
4806 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
4807 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
4808 "release the Modified Version under precisely this License, with the Modified "
4809 "Version filling the role of the Document, thus licensing distribution and "
4810 "modification of the Modified Version to whoever possesses a copy of it. In "
4811 "addition, you must do these things in the Modified Version:"
4812 msgstr ""
4813 "Você pode copiar e distribuir uma <_:link-1/> do <_:link-2/> sob as "
4814 "condições das seções <_:link-3/> e <_:link-4/> acima, desde que você forneça "
4815 "a Versão Modificada estritamente sob esta Licença, com a Versão Modificada "
4816 "preenchendo a função de Documento, permitindo assim a distribuição e "
4817 "modificação da Versão Modificada a quem quer que possua uma cópia desta. "
4818 "Além disso, você deve executar os seguintes procedimentos na Versão "
4819 "Modificada:"
4820
4821 #. (itstool) path: formalpara/title
4822 #: C/fdl-appendix.xml:248
4823 msgid "A"
4824 msgstr "A"
4825
4826 #. (itstool) path: formalpara/para
4827 #: C/fdl-appendix.xml:249
4828 msgid ""
4829 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
4830 "that of the <_:link-2/>, and from those of previous versions (which should, "
4831 "if there were any, be listed in the History section of the Document). You "
4832 "may use the same title as a previous version if the original publisher of "
4833 "that version gives permission."
4834 msgstr ""
4835 "Usar na <_:link-1/> (e nas capas, se existirem) um título distinto em "
4836 "relação ao do <_:link-2/>, e daqueles de versões anteriores (os quais devem, "
4837 "na existência de algum, ser listados na seção “Histórico” do Documento). "
4838 "Você pode usar o mesmo título de uma versão anterior se o editor original "
4839 "daquela versão conceder-lhe permissão."
4840
4841 #. (itstool) path: formalpara/title
4842 #: C/fdl-appendix.xml:264
4843 msgid "B"
4844 msgstr "B"
4845
4846 #. (itstool) path: formalpara/para
4847 #: C/fdl-appendix.xml:265
4848 msgid ""
4849 "List on the <_:link-1/>, as authors, one or more persons or entities "
4850 "responsible for authorship of the modifications in the <_:link-2/>, together "
4851 "with at least five of the principal authors of the <_:link-3/> (all of its "
4852 "principal authors, if it has less than five)."
4853 msgstr ""
4854 "Listar na <_:link-1/> como autores, uma ou mais pessoas ou entidades "
4855 "responsáveis pela autoria das modificações na <_:link-2/>, juntamente com "
4856 "pelo menos cinco autores principais do <_:link-3/> (todos seus autores "
4857 "principais, se houver menos que cinco)."
4858
4859 #. (itstool) path: formalpara/title
4860 #: C/fdl-appendix.xml:279
4861 msgid "C"
4862 msgstr "C"
4863
4864 #. (itstool) path: formalpara/para
4865 #: C/fdl-appendix.xml:280
4866 msgid ""
4867 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
4868 "the publisher."
4869 msgstr ""
4870 "Declarar na <_:link-1/> o nome do editor da <_:link-2/>, como seu editor."
4871
4872 #. (itstool) path: formalpara/title
4873 #: C/fdl-appendix.xml:291
4874 msgid "D"
4875 msgstr "D"
4876
4877 #. (itstool) path: formalpara/para
4878 #: C/fdl-appendix.xml:292
4879 msgid "Preserve all the copyright notices of the <_:link-1/>."
4880 msgstr ""
4881 "Preservar todas as notas de direitos autorais (copyright) do <_:link-1/>."
4882
4883 #. (itstool) path: formalpara/title
4884 #: C/fdl-appendix.xml:301
4885 msgid "E"
4886 msgstr "E"
4887
4888 #. (itstool) path: formalpara/para
4889 #: C/fdl-appendix.xml:302
4890 msgid ""
4891 "Add an appropriate copyright notice for your modifications adjacent to the "
4892 "other copyright notices."
4893 msgstr ""
4894 "Adicionar um aviso de direitos autorais apropriado para suas modificações "
4895 "adjacentes aos outros avisos de direitos autorais."
4896
4897 #. (itstool) path: formalpara/title
4898 #: C/fdl-appendix.xml:311
4899 msgid "F"
4900 msgstr "F"
4901
4902 #. (itstool) path: formalpara/para
4903 #: C/fdl-appendix.xml:312
4904 msgid ""
4905 "Include, immediately after the copyright notices, a license notice giving "
4906 "the public permission to use the <_:link-1/> under the terms of this "
4907 "License, in the form shown in the Addendum below."
4908 msgstr ""
4909 "Incluir, imediatamente após as notas de direitos autorais, uma nota de "
4910 "licença concedendo permissão pública para o uso da <_:link-1/> sob os termos "
4911 "desta Licença, na forma mostrada no Adendo abaixo."
4912
4913 #. (itstool) path: formalpara/title
4914 #: C/fdl-appendix.xml:324
4915 msgid "G"
4916 msgstr "G"
4917
4918 #. (itstool) path: para/link
4919 #: C/fdl-appendix.xml:330
4920 msgid "Document's"
4921 msgstr "Do documento"
4922
4923 #. (itstool) path: formalpara/para
4924 #: C/fdl-appendix.xml:325
4925 msgid ""
4926 "Preserve in that license notice the full lists of <_:link-1/> and required "
4927 "<_:link-2/> given in the <_:link-3/> license notice."
4928 msgstr ""
4929 "Preservar na referida nota de licença a lista completa de <_:link-1/> e "
4930 "<_:link-2/> obrigatórios, dados na nota de licença do <_:link-3/>."
4931
4932 #. (itstool) path: formalpara/title
4933 #: C/fdl-appendix.xml:337
4934 msgid "H"
4935 msgstr "H"
4936
4937 #. (itstool) path: formalpara/para
4938 #: C/fdl-appendix.xml:338
4939 msgid "Include an unaltered copy of this License."
4940 msgstr "Incluir uma cópia inalterada desta Licença."
4941
4942 #. (itstool) path: formalpara/title
4943 #: C/fdl-appendix.xml:346
4944 msgid "I"
4945 msgstr "I"
4946
4947 #. (itstool) path: para/quote
4948 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
4949 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
4950 msgid "History"
4951 msgstr "Histórico"
4952
4953 #. (itstool) path: formalpara/para
4954 #: C/fdl-appendix.xml:347
4955 msgid ""
4956 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
4957 "item stating at least the title, year, new authors, and publisher of the "
4958 "<_:link-2/> as given on the <_:link-3/>. If there is no section entitled "
4959 "<_:quote-4/> in the <_:link-5/>, create one stating the title, year, "
4960 "authors, and publisher of the Document as given on its Title Page, then add "
4961 "an item describing the Modified Version as stated in the previous sentence."
4962 msgstr ""
4963 "Preservar a seção intitulada <_:quote-1/>, preservar seu título, e adicionar "
4964 "a esta um item declarando ao menos o título, o ano, novos autores, e o "
4965 "editor da <_:link-2/> conforme incluído na <_:link-3/>. Se nenhuma seção "
4966 "intitulada <_:quote-4/> estiver presente no <_:link-5/>, crie uma informando "
4967 "o título, o ano, os autores e o editor do Documento como evidenciado na "
4968 "Página de Título, em seguida adicione um item descrevendo a Versão "
4969 "Modificada como mencionado na sentença anterior."
4970
4971 #. (itstool) path: formalpara/title
4972 #: C/fdl-appendix.xml:365
4973 msgid "J"
4974 msgstr "J"
4975
4976 #. (itstool) path: formalpara/para
4977 #: C/fdl-appendix.xml:366
4978 msgid ""
4979 "Preserve the network location, if any, given in the <_:link-1/> for public "
4980 "access to a <_:link-2/> copy of the Document, and likewise the network "
4981 "locations given in the Document for previous versions it was based on. These "
4982 "may be placed in the <_:quote-3/> section. You may omit a network location "
4983 "for a work that was published at least four years before the Document "
4984 "itself, or if the original publisher of the version it refers to gives "
4985 "permission."
4986 msgstr ""
4987 "Preservar o endereço de rede, se existir algum, informado pelo <_:link-1/> "
4988 "para acesso público a uma cópia <_:link-2/> deste e, da mesma maneira, os "
4989 "endereços de rede dados no Documento para versões anteriores nas quais este "
4990 "se baseia. Estes podem ser colocados na seção <_:quote-3/>. Você pode omitir "
4991 "um endereço de rede para um trabalho que foi publicado pelo menos quatro "
4992 "anos antes do Documento em si, ou se o editor original da versão à qual o "
4993 "endereço se refere der permissão."
4994
4995 #. (itstool) path: formalpara/title
4996 #: C/fdl-appendix.xml:383
4997 msgid "K"
4998 msgstr "K"
4999
5000 #. (itstool) path: para/quote
5001 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
5002 msgid "Acknowledgements"
5003 msgstr "Agradecimentos"
5004
5005 #. (itstool) path: para/quote
5006 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
5007 msgid "Dedications"
5008 msgstr "Dedicatórias"
5009
5010 #. (itstool) path: formalpara/para
5011 #: C/fdl-appendix.xml:384
5012 msgid ""
5013 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
5014 "title, and preserve in the section all the substance and tone of each of the "
5015 "contributor acknowledgements and/or dedications given therein."
5016 msgstr ""
5017 "Preservar o título da seção para qualquer seção intitulada <_:quote-1/> ou "
5018 "<_:quote-2/> e preservar dentro da seção toda a substância e tom de cada um "
5019 "dos agradecimentos e/ou dedicatórias lá mencionados."
5020
5021 #. (itstool) path: formalpara/title
5022 #: C/fdl-appendix.xml:396
5023 msgid "L"
5024 msgstr "L"
5025
5026 #. (itstool) path: formalpara/para
5027 #: C/fdl-appendix.xml:397
5028 msgid ""
5029 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
5030 "in their titles. Section numbers or the equivalent are not considered part "
5031 "of the section titles."
5032 msgstr ""
5033 "Preservar todas as <_:link-1/> do <_:link-2/>, sem alterações em seus textos "
5034 "e títulos. Números de seção ou o equivalente não são considerados parte dos "
5035 "títulos das seções."
5036
5037 #. (itstool) path: formalpara/title
5038 #: C/fdl-appendix.xml:409
5039 msgid "M"
5040 msgstr "M"
5041
5042 #. (itstool) path: para/quote
5043 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
5044 msgid "Endorsements"
5045 msgstr "Apoio"
5046
5047 #. (itstool) path: formalpara/para
5048 #: C/fdl-appendix.xml:410
5049 msgid ""
5050 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
5051 "in the <_:link-2/>."
5052 msgstr ""
5053 "Apagar qualquer seção intitulada <_:quote-1/>. Tal seção não deve ser "
5054 "incluída na <_:link-2/>."
5055
5056 #. (itstool) path: formalpara/title
5057 #: C/fdl-appendix.xml:421
5058 msgid "N"
5059 msgstr "N"
5060
5061 #. (itstool) path: para/link
5062 #: C/fdl-appendix.xml:425
5063 msgid "Invariant Section"
5064 msgstr "Seção invariante"
5065
5066 #. (itstool) path: formalpara/para
5067 #: C/fdl-appendix.xml:422
5068 msgid ""
5069 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
5070 "with any <_:link-2/>."
5071 msgstr ""
5072 "Não renomear o título de qualquer seção existente como <_:quote-1/> ou que "
5073 "resulte em conflito com o título de qualquer <_:link-2/>."
5074
5075 #. (itstool) path: sect1/para
5076 #: C/fdl-appendix.xml:432
5077 msgid ""
5078 "If the <_:link-1/> includes new front-matter sections or appendices that "
5079 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5080 "may at your option designate some or all of these sections as invariant. To "
5081 "do this, add their titles to the list of <_:link-3/> in the Modified "
5082 "Version's license notice. These titles must be distinct from any other "
5083 "section titles."
5084 msgstr ""
5085 "Se a <_:link-1/> incluir novas seções iniciais ou apêndices que sejam "
5086 "qualificados como <_:link-2/>, e não contiver material copiado do Documento, "
5087 "você pode, a seu critério, tornar algumas dessas ou todas essas seções em "
5088 "invariantes. Para fazer isso, adicione seus títulos à lista de <_:link-3/> "
5089 "na nota de licença da Versão Modificada. Estes títulos devem ser distintos "
5090 "de quaisquer outros títulos de seções."
5091
5092 #. (itstool) path: sect1/para
5093 #: C/fdl-appendix.xml:444
5094 msgid ""
5095 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
5096 "but endorsements of your <_:link-2/> by various parties--for example, "
5097 "statements of peer review or that the text has been approved by an "
5098 "organization as the authoritative definition of a standard."
5099 msgstr ""
5100 "Você pode incluir uma seção intitulada <_:quote-1/>, desde que esta contenha "
5101 "apenas apoios recebidos limitados a sua <_:link-2/> por várias fontes -- por "
5102 "exemplo, notas do revisor ou de que o texto foi aprovado por uma organização "
5103 "como a definição oficial de um padrão."
5104
5105 #. (itstool) path: para/link
5106 #: C/fdl-appendix.xml:455
5107 msgid "Front-Cover Text"
5108 msgstr "Texto de Capa Frontal"
5109
5110 #. (itstool) path: para/link
5111 #: C/fdl-appendix.xml:457
5112 msgid "Back-Cover Text"
5113 msgstr "Texto de Contracapa"
5114
5115 #. (itstool) path: sect1/para
5116 #: C/fdl-appendix.xml:453
5117 msgid ""
5118 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5119 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
5120 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
5121 "Text may be added by (or through arrangements made by) any one entity. If "
5122 "the <_:link-5/> already includes a cover text for the same cover, previously "
5123 "added by you or by arrangement made by the same entity you are acting on "
5124 "behalf of, you may not add another; but you may replace the old one, on "
5125 "explicit permission from the previous publisher that added the old one."
5126 msgstr ""
5127 "Você pode adicionar uma passagem de até cinco palavras como <_:link-1/>, e "
5128 "uma passagem de até 25 palavras como <_:link-2/>, ao fim da lista de "
5129 "<_:link-3/> na <_:link-4/>. Somente uma passagem de Texto de Capa Frontal e "
5130 "uma de Texto de Contracapa podem ser adicionados por (ou através de arranjos "
5131 "feitos por) uma entidade qualquer. Caso o <_:link-5/> já incluir um texto de "
5132 "capa para a mesma capa, previamente incluído por você ou pelo arranjo feito "
5133 "pela mesma entidade em cujo nome você está agindo, você não poderá adicionar "
5134 "outro; mas você poderá substituir o antigo, com a permissão explícita do "
5135 "editor anterior, que o incluiu."
5136
5137 #. (itstool) path: sect1/para
5138 #: C/fdl-appendix.xml:470
5139 msgid ""
5140 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
5141 "give permission to use their names for publicity for or to assert or imply "
5142 "endorsement of any <_:link-2/>."
5143 msgstr ""
5144 "O(s) autor(es) e editor(es) do <_:link-1/>, por esta Licença, não concedem "
5145 "permissão para que seus nomes sejam usados a fins de publicidade, para "
5146 "defesa ou para apoio implícito de qualquer <_:link-2/>."
5147
5148 #. (itstool) path: sect1/title
5149 #: C/fdl-appendix.xml:480
5150 msgid "5. COMBINING DOCUMENTS"
5151 msgstr "5. COMBINANDO DOCUMENTOS"
5152
5153 #. (itstool) path: para/link
5154 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
5155 msgid "section 4"
5156 msgstr "seção 4"
5157
5158 #. (itstool) path: sect1/para
5159 #: C/fdl-appendix.xml:481
5160 msgid ""
5161 "You may combine the <_:link-1/> with other documents released under this "
5162 "License, under the terms defined in <_:link-2/> above for modified versions, "
5163 "provided that you include in the combination all of the <_:link-3/> of all "
5164 "of the original documents, unmodified, and list them all as Invariant "
5165 "Sections of your combined work in its license notice."
5166 msgstr ""
5167 "Você pode combinar o <_:link-1/> com outros documentos publicados sob esta "
5168 "Licença, sob os termos definidos na <_:link-2/> acima para versões "
5169 "modificadas, desde que você inclua na combinação todas as <_:link-3/> de "
5170 "todos os documentos originais, sem modificações, e as liste como Seções "
5171 "Invariantes de seu trabalho combinado, na sua nota de licença."
5172
5173 #. (itstool) path: sect1/para
5174 #: C/fdl-appendix.xml:492
5175 msgid ""
5176 "The combined work need only contain one copy of this License, and multiple "
5177 "identical <_:link-1/> may be replaced with a single copy. If there are "
5178 "multiple Invariant Sections with the same name but different contents, make "
5179 "the title of each such section unique by adding at the end of it, in "
5180 "parentheses, the name of the original author or publisher of that section if "
5181 "known, or else a unique number. Make the same adjustment to the section "
5182 "titles in the list of Invariant Sections in the license notice of the "
5183 "combined work."
5184 msgstr ""
5185 "O trabalho combinado precisa conter somente uma cópia desta Licença, e "
5186 "várias <_:link-1/> idênticas podem ser substituídas por uma única cópia. Se "
5187 "existirem várias Seções Invariantes de mesmo nome, porém com conteúdos "
5188 "diferentes, você deve tornar o título de cada uma destas seções único, "
5189 "adicionando ao fim destes, entre parênteses, o nome do autor ou, se "
5190 "conhecido, o editor original desta seção, ou ainda um número único. Faça o "
5191 "mesmo ajuste nos títulos de seção na lista de Seções Invariantes na nota de "
5192 "licença do trabalho combinado."
5193
5194 #. (itstool) path: para/quote
5195 #: C/fdl-appendix.xml:511
5196 msgid "Endorsements."
5197 msgstr "Apoios."
5198
5199 #. (itstool) path: sect1/para
5200 #: C/fdl-appendix.xml:505
5201 msgid ""
5202 "In the combination, you must combine any sections entitled <_:quote-1/> in "
5203 "the various original documents, forming one section entitled <_:quote-2/>; "
5204 "likewise combine any sections entitled <_:quote-3/>, and any sections "
5205 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
5206 msgstr ""
5207 "Na combinação, você deve combinar quaisquer seções intituladas <_:quote-1/> "
5208 "nos vários documentos originais, formando uma seção intitulada <_:quote-2/>; "
5209 "do mesmo modo, combine quaisquer seções intituladas <_:quote-3/>, e "
5210 "quaisquer seções intituladas <_:quote-4/>. Você deve apagar todas as seções "
5211 "intituladas <_:quote-5/>."
5212
5213 #. (itstool) path: sect1/title
5214 #: C/fdl-appendix.xml:516
5215 msgid "6. COLLECTIONS OF DOCUMENTS"
5216 msgstr "6. COLEÇÕES DE DOCUMENTOS"
5217
5218 #. (itstool) path: sect1/para
5219 #: C/fdl-appendix.xml:517
5220 msgid ""
5221 "You may make a collection consisting of the <_:link-1/> and other documents "
5222 "released under this License, and replace the individual copies of this "
5223 "License in the various documents with a single copy that is included in the "
5224 "collection, provided that you follow the rules of this License for verbatim "
5225 "copying of each of the documents in all other respects."
5226 msgstr ""
5227 "Você pode fazer uma coleção que consiste do <_:link-1/> e outros documentos "
5228 "publicados sob esta Licença, e substituir as cópias individuais desta "
5229 "Licença, nos vários documentos, por uma única cópia a ser incluída na "
5230 "coleção, desde que você siga as regras desta Licença para cópias literais de "
5231 "cada documento em todos os outros aspectos."
5232
5233 #. (itstool) path: sect1/para
5234 #: C/fdl-appendix.xml:527
5235 msgid ""
5236 "You may extract a single document from such a collection, and distribute it "
5237 "individually under this License, provided you insert a copy of this License "
5238 "into the extracted document, and follow this License in all other respects "
5239 "regarding verbatim copying of that document."
5240 msgstr ""
5241 "Você pode extrair um único documento de tal coleção e distribuí-lo "
5242 "individualmente sob esta Licença, desde que você insira uma cópia desta "
5243 "Licença no documento extraído e siga esta Licença em todos os outros "
5244 "aspectos referentes à cópia literal desse documento."
5245
5246 #. (itstool) path: sect1/title
5247 #: C/fdl-appendix.xml:537
5248 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
5249 msgstr "7. AGREGAÇÃO COM TRABALHOS INDEPENDENTES"
5250
5251 #. (itstool) path: para/quote
5252 #: C/fdl-appendix.xml:546
5253 msgid "aggregate"
5254 msgstr "agregação"
5255
5256 #. (itstool) path: para/link
5257 #: C/fdl-appendix.xml:550
5258 msgid "Cover Text"
5259 msgstr "Texto de Capa"
5260
5261 #. (itstool) path: sect1/para
5262 #: C/fdl-appendix.xml:538
5263 msgid ""
5264 "A compilation of the <_:link-1/> or its derivatives with other separate and "
5265 "independent documents or works, in or on a volume of a storage or "
5266 "distribution medium, does not as a whole count as a <_:link-2/> of the "
5267 "Document, provided no compilation copyright is claimed for the compilation. "
5268 "Such a compilation is called an <_:quote-3/>, and this License does not "
5269 "apply to the other self-contained works thus compiled with the Document , on "
5270 "account of their being thus compiled, if they are not themselves derivative "
5271 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
5272 "applicable to these copies of the Document, then if the Document is less "
5273 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
5274 "placed on covers that surround only the Document within the aggregate. "
5275 "Otherwise they must appear on covers around the whole aggregate."
5276 msgstr ""
5277 "Uma compilação do <_:link-1/> ou seus derivados com outros documentos ou "
5278 "trabalhos separados e independentes, dentro de ou sob um volume de um meio "
5279 "de armazenamento ou distribuição, não conta como um todo para uma <_:link-2/"
5280 "> do Documento, contanto que nenhum direito autoral de compilação seja "
5281 "reivindicado para esta compilação. Tal compilação configura um <_:quote-3/> "
5282 "e esta Licença não se aplica aos outros trabalhos contidos na compilação do "
5283 "Documento, levando em conta serem compilados, caso eles mesmos não forem "
5284 "trabalhos derivados do Documento. Se o requisito de <_:link-4/> da <_:link-5/"
5285 "> é aplicável a estas cópias do Documento, e ainda se o Documento é menor do "
5286 "que um quarto do agregado inteiro, os Textos de Capa do Documento podem ser "
5287 "inseridos nas capas que envolvem somente o Documento no agregado. Caso "
5288 "contrário, eles devem aparecer em capas em volta do agregado como um todo."
5289
5290 #. (itstool) path: sect1/title
5291 #: C/fdl-appendix.xml:561
5292 msgid "8. TRANSLATION"
5293 msgstr "8. TRADUÇÃO"
5294
5295 #. (itstool) path: sect1/para
5296 #: C/fdl-appendix.xml:562
5297 msgid ""
5298 "Translation is considered a kind of modification, so you may distribute "
5299 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing "
5300 "<_:link-3/> with translations requires special permission from their "
5301 "copyright holders, but you may include translations of some or all Invariant "
5302 "Sections in addition to the original versions of these Invariant Sections. "
5303 "You may include a translation of this License provided that you also include "
5304 "the original English version of this License. In case of a disagreement "
5305 "between the translation and the original English version of this License, "
5306 "the original English version will prevail."
5307 msgstr ""
5308 "Uma tradução é considerada como sendo um tipo de modificação, desta forma "
5309 "você pode distribuir traduções do <_:link-1/> sob os termos da <_:link-2/>. "
5310 "A substituição das <_:link-3/> por traduções requer permissão especial dos "
5311 "detentores dos direitos autorais, embora você possa incluir traduções de "
5312 "algumas ou todas as Seções Invariantes juntamente às versões originais "
5313 "destas. Você pode incluir uma tradução desta Licença, desde que você também "
5314 "inclua a versão original em Inglês desta Licença. Em caso de discordância "
5315 "entre a tradução e a versão original desta Licença ou nota de licença, a "
5316 "versão original em inglês prevalecerá."
5317
5318 #. (itstool) path: sect1/title
5319 #: C/fdl-appendix.xml:580
5320 msgid "9. TERMINATION"
5321 msgstr "9. TERMINAÇÃO"
5322
5323 #. (itstool) path: sect1/para
5324 #: C/fdl-appendix.xml:581
5325 msgid ""
5326 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
5327 "as expressly provided for under this License. Any other attempt to copy, "
5328 "modify, sublicense or distribute the Document is void, and will "
5329 "automatically terminate your rights under this License. However, parties who "
5330 "have received copies, or rights, from you under this License will not have "
5331 "their licenses terminated so long as such parties remain in full compliance."
5332 msgstr ""
5333 "Você não pode copiar, modificar, sublicenciar, ou distribuir o <_:link-1/> "
5334 "com exceção do que foi expressamente previsto sob esta Licença. Qualquer "
5335 "outra tentativa de cópia, modificação, sublicenciamento ou distribuição do "
5336 "Documento é nula, e implicará na rescisão automática de seus direitos sob "
5337 "esta Licença. Contudo, as partes que receberam as cópias, ou direitos, de "
5338 "você sob esta Licença não terão suas licenças rescindidas enquanto tais "
5339 "partes permanecerem em total acordo com a Licença."
5340
5341 #. (itstool) path: sect1/title
5342 #: C/fdl-appendix.xml:594
5343 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
5344 msgstr "10. FUTURAS REVISÕES DESTA LICENÇA"
5345
5346 #. (itstool) path: para/ulink
5347 #: C/fdl-appendix.xml:597
5348 msgid "Free Software Foundation"
5349 msgstr "Free Software Foundation"
5350
5351 #. (itstool) path: para/ulink
5352 #: C/fdl-appendix.xml:603
5353 msgid "http://www.gnu.org/copyleft/"
5354 msgstr "http://www.gnu.org/copyleft/"
5355
5356 #. (itstool) path: sect1/para
5357 #: C/fdl-appendix.xml:595
5358 msgid ""
5359 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
5360 "Documentation License from time to time. Such new versions will be similar "
5361 "in spirit to the present version, but may differ in detail to address new "
5362 "problems or concerns. See <_:ulink-2/>."
5363 msgstr ""
5364 "A <_:ulink-1/> pode publicar novas versões, revisadas, da Licença de "
5365 "Documentação Livre GNU de tempos em tempos. Tais versões posteriores terão "
5366 "ideologia similar à presente versão, embora possam diferir em detalhes a fim "
5367 "de abordar novos problemas ou preocupações. Consulte: <_:ulink-2/>."
5368
5369 #. (itstool) path: para/quote
5370 #: C/fdl-appendix.xml:610
5371 msgid "or any later version"
5372 msgstr "ou qualquer versão posterior"
5373
5374 #. (itstool) path: sect1/para
5375 #: C/fdl-appendix.xml:606
5376 msgid ""
5377 "Each version of the License is given a distinguishing version number. If the "
5378 "<_:link-1/> specifies that a particular numbered version of this License "
5379 "<_:quote-2/> applies to it, you have the option of following the terms and "
5380 "conditions either of that specified version or of any later version that has "
5381 "been published (not as a draft) by the Free Software Foundation. If the "
5382 "Document does not specify a version number of this License, you may choose "
5383 "any version ever published (not as a draft) by the Free Software Foundation."
5384 msgstr ""
5385 "É dado, a cada versão da Licença, um número de versão distinto. Se o "
5386 "<_:link-1/> especificar que um número de versão em específico desta Licença "
5387 "<_:quote-2/> se aplica a ele, você tem a opção de seguir os termos e "
5388 "condições tanto da versão especificada quanto de qualquer versão posterior "
5389 "que tenha sido publicada (não como rascunho) pela Free Software Foundation. "
5390 "Se o documento não especificar um número de versão desta Licença, você pode "
5391 "escolher qualquer versão já publicada (não como rascunho) pela Free Software "
5392 "Foundation."
5393
5394 #. (itstool) path: sect1/title
5395 #: C/fdl-appendix.xml:621
5396 msgid "Addendum"
5397 msgstr "Adendo"
5398
5399 #. (itstool) path: sect1/para
5400 #: C/fdl-appendix.xml:622
5401 msgid ""
5402 "To use this License in a document you have written, include a copy of the "
5403 "License in the document and put the following copyright and license notices "
5404 "just after the title page:"
5405 msgstr ""
5406 "Para usar esta Licença em um documento que você escreveu, inclua uma cópia "
5407 "da Licença no documento e coloque os seguintes avisos de direitos autorais e "
5408 "de licenças logo após a página de título:"
5409
5410 #. (itstool) path: blockquote/para
5411 #: C/fdl-appendix.xml:629
5412 msgid "Copyright YEAR YOUR NAME."
5413 msgstr "Copyright ANO SEU NOME."
5414
5415 #. (itstool) path: para/link
5416 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
5417 msgid "Front-Cover Texts"
5418 msgstr "Textos de Capa Frontal"
5419
5420 #. (itstool) path: para/link
5421 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
5422 msgid "Back-Cover Texts"
5423 msgstr "Textos de Contracapa"
5424
5425 #. (itstool) path: blockquote/para
5426 #: C/fdl-appendix.xml:632
5427 msgid ""
5428 "Permission is granted to copy, distribute and/or modify this document under "
5429 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5430 "version published by the Free Software Foundation; with the <_:link-1/> "
5431 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the "
5432 "<_:link-3/> being LIST. A copy of the license is included in the section "
5433 "entitled <_:quote-4/>."
5434 msgstr ""
5435 "Permissão concedida para copiar, distribuir e/ou modificar este documento "
5436 "sob os termos da Licença de Documentação Livre GNU (GNU Free Documentation "
5437 "License), Versão 1.1 ou qualquer versão mais recente publicada pela Free "
5438 "Software Foundation; com as <_:link-1/>, sendo LISTE SEUS TÍTULOS, com os "
5439 "<_:link-2/> sendo LISTA, e com os <_:link-3/> sendo LISTA. Uma cópia da "
5440 "licença está inclusa na seção intitulada <_:quote-4/>."
5441
5442 #. (itstool) path: para/quote
5443 #: C/fdl-appendix.xml:649
5444 msgid "with no Invariant Sections"
5445 msgstr "sem Seções Invariantes"
5446
5447 #. (itstool) path: para/quote
5448 #: C/fdl-appendix.xml:652
5449 msgid "no Front-Cover Texts"
5450 msgstr "sem Textos de Capa Frontal"
5451
5452 #. (itstool) path: para/quote
5453 #: C/fdl-appendix.xml:653
5454 msgid "Front-Cover Texts being LIST"
5455 msgstr "Textos de Capa Frontal sendo LISTADOS"
5456
5457 #. (itstool) path: sect1/para
5458 #: C/fdl-appendix.xml:647
5459 msgid ""
5460 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
5461 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of "
5462 "<_:quote-5/>; likewise for <_:link-6/>."
5463 msgstr ""
5464 "Se você não tiver qualquer <_:link-1/>, escreva <_:quote-2/> ao invés de "
5465 "afirmar quais são invariantes. Se você não tem <_:link-3/>, escreva "
5466 "<_:quote-4/> ao invés de <_:quote-5/>; O mesmo se aplica a <_:link-6/>."
5467
5468 #. (itstool) path: para/ulink
5469 #: C/fdl-appendix.xml:661
5470 msgid "GNU General Public License"
5471 msgstr "Licença Pública Geral GNU (GPL)"
5472
5473 #. (itstool) path: sect1/para
5474 #: C/fdl-appendix.xml:657
5475 msgid ""
5476 "If your document contains nontrivial examples of program code, we recommend "
5477 "releasing these examples in parallel under your choice of free software "
5478 "license, such as the <_:ulink-1/>, to permit their use in free software."
5479 msgstr ""
5480 "Se seu documento contiver exemplos não-triviais de código de programação, "
5481 "recomendamos publicar estes exemplos paralelamente, sob a licença de "
5482 "software livre que você escolher, como, por exemplo, a <_:ulink-1/>, para "
5483 "permitir seu uso em software livre."
5484
5485 #~ msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
5486 #~ msgstr "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
5487
5488 #, no-wrap
5489 #~ msgid ""
5490 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
5491 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
5492 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
5493 #~ msgstr ""
5494 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
5495 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
5496 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
5497
5498 #~ msgid ""
5499 #~ "The purpose of this License is to make a manual, textbook, or other "
5500 #~ "written document <quote>free</quote> in the sense of freedom: to assure "
5501 #~ "everyone the effective freedom to copy and redistribute it, with or "
5502 #~ "without modifying it, either commercially or noncommercially. "
5503 #~ "Secondarily, this License preserves for the author and publisher a way to "
5504 #~ "get credit for their work, while not being considered responsible for "
5505 #~ "modifications made by others."
5506 #~ msgstr ""
5507 #~ "O objetivo desta Licença é tornar um manual, livro didático ou outro "
5508 #~ "documento funcional e útil “livre” no sentido de liberdade: assegurar a "
5509 #~ "todos a liberdade efetiva de copiá-lo e redistribuí-lo, com ou sem "
5510 #~ "modificação do mesmo, comercialmente ou não. Em segundo lugar, esta "
5511 #~ "Licença preserva para o autor e o editor uma maneira de obter crédito por "
5512 #~ "seu trabalho, sem ser considerado responsável por modificações feitas por "
5513 #~ "outros."
5514
5515 #~ msgid ""
5516 #~ "This License is a kind of <quote>copyleft</quote>, which means that "
5517 #~ "derivative works of the document must themselves be free in the same "
5518 #~ "sense. It complements the GNU General Public License, which is a copyleft "
5519 #~ "license designed for free software."
5520 #~ msgstr ""
5521 #~ "Esta licença é um tipo de “copyleft”, o que significa que trabalhos "
5522 #~ "derivados do documento devem ser livres no mesmo sentido. Ela complementa "
5523 #~ "a Licença Pública Geral GNU (GNU General Public License), que é uma "
5524 #~ "licença com copyleft projetada para software livre."
5525
5526 #~ msgid ""
5527 #~ "This License applies to any manual or other work that contains a notice "
5528 #~ "placed by the copyright holder saying it can be distributed under the "
5529 #~ "terms of this License. The <quote>Document</quote>, below, refers to any "
5530 #~ "such manual or work. Any member of the public is a licensee, and is "
5531 #~ "addressed as <quote>you</quote>."
5532 #~ msgstr ""
5533 #~ "Esta Licença aplica-se a qualquer manual ou outro trabalho, em qualquer "
5534 #~ "meio, que contenha um aviso colocado pelo detentor dos direitos autorais "
5535 #~ "dizendo que pode ser distribuído nos termos desta Licença. Tal aviso "
5536 #~ "concede uma licença mundial, sem royalties, de duração ilimitada, para "
5537 #~ "usar esse trabalho nas condições aqui estabelecidas. O “Documento”, a "
5538 #~ "seguir, refere-se a qualquer manual ou trabalho. Qualquer membro do "
5539 #~ "público é um licenciado e é referido como “você”. Você aceita a licença "
5540 #~ "se você copiar, modificar ou distribuir o trabalho de forma a exigir "
5541 #~ "permissão de acordo com a lei de direitos autorais."
5542
5543 #~ msgid ""
5544 #~ "A <quote>Modified Version</quote> of the Document means any work "
5545 #~ "containing the Document or a portion of it, either copied verbatim, or "
5546 #~ "with modifications and/or translated into another language."
5547 #~ msgstr ""
5548 #~ "Uma “Versão Modificada” do Documento significa qualquer trabalho contendo "
5549 #~ "o Documento ou uma porção deste, seja uma cópia literal ou com "
5550 #~ "modificações e/ou traduzido em outro idioma."
5551
5552 #~ msgid ""
5553 #~ "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
5554 #~ "section of the <link linkend=\"fdl-document\">Document</link> that deals "
5555 #~ "exclusively with the relationship of the publishers or authors of the "
5556 #~ "Document to the Document's overall subject (or to related matters) and "
5557 #~ "contains nothing that could fall directly within that overall subject. "
5558 #~ "(For example, if the Document is in part a textbook of mathematics, a "
5559 #~ "Secondary Section may not explain any mathematics.) The relationship "
5560 #~ "could be a matter of historical connection with the subject or with "
5561 #~ "related matters, or of legal, commercial, philosophical, ethical or "
5562 #~ "political position regarding them."
5563 #~ msgstr ""
5564 #~ "A “Seção Secundária” é um apêndice nomeado ou uma seção anterior do "
5565 #~ "Documento que trata exclusivamente do relacionamento dos editores ou "
5566 #~ "autores do <link linkend=\"fdl-document\">Documento</link> com o assunto "
5567 #~ "geral do documento (ou assuntos relacionados) e não contém nada que possa "
5568 #~ "estar diretamente dentro desse assunto geral. (Assim, se o Documento for, "
5569 #~ "em parte, um livro de texto de matemática, uma Seção Secundária pode não "
5570 #~ "explicar qualquer matemática.) O relacionamento poderia ser uma questão "
5571 #~ "de conexão histórica com o assunto ou com assuntos relacionados, ou de "
5572 #~ "posição legal, comercial, filosófica, ética ou política em relação a eles."
5573
5574 #~ msgid ""
5575 #~ "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
5576 #~ "secondary\"> Secondary Sections</link> whose titles are designated, as "
5577 #~ "being those of Invariant Sections, in the notice that says that the <link "
5578 #~ "linkend=\"fdl-document\">Document</link> is released under this License."
5579 #~ msgstr ""
5580 #~ "As “Seções Invariantes” são certas <link linkend=\"fdl-secondary\">Seções "
5581 #~ "Secundárias</link> cujos títulos são designados, como sendo daquelas de "
5582 #~ "Seções Invariantes, no aviso que diz que o <link linkend=\"fdl-"
5583 #~ "document\">Documento</link> é liberado sob esta Licença."
5584
5585 #~ msgid ""
5586 #~ "The <quote>Cover Texts</quote> are certain short passages of text that "
5587 #~ "are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that "
5588 #~ "says that the <link linkend=\"fdl-document\">Document</link> is released "
5589 #~ "under this License."
5590 #~ msgstr ""
5591 #~ "Os “Textos de Capa” são certas passagens de texto que são listadas como "
5592 #~ "Textos de Capa Frontal ou Textos de Contracapa, no aviso que afirma que o "
5593 #~ "<link linkend=\"fdl-document\">Documento</link> foi publicado sob esta "
5594 #~ "Licença."
5595
5596 #~ msgid ""
5597 #~ "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
5598 #~ "Document</link> means a machine-readable copy, represented in a format "
5599 #~ "whose specification is available to the general public, whose contents "
5600 #~ "can be viewed and edited directly and straightforwardly with generic text "
5601 #~ "editors or (for images composed of pixels) generic paint programs or (for "
5602 #~ "drawings) some widely available drawing editor, and that is suitable for "
5603 #~ "input to text formatters or for automatic translation to a variety of "
5604 #~ "formats suitable for input to text formatters. A copy made in an "
5605 #~ "otherwise Transparent file format whose markup has been designed to "
5606 #~ "thwart or discourage subsequent modification by readers is not "
5607 #~ "Transparent. A copy that is not <quote>Transparent</quote> is called "
5608 #~ "<quote>Opaque</quote>."
5609 #~ msgstr ""
5610 #~ "Uma cópia “Transparente” do <link linkend=\"fdl-document\"> Documento</"
5611 #~ "link> significa uma cópia legível por máquina, representada em um formato "
5612 #~ "cuja especificação está disponível para o público em geral, cujo conteúdo "
5613 #~ "possa ser visto e editado diretamente com editores de texto genéricos ou "
5614 #~ "(para imagens compostas de pixels) programas gráficos genéricos ou (para "
5615 #~ "desenhos) algum editor de desenho amplamente disponível, e isso seja "
5616 #~ "adequado para entrada para formatadores de texto ou para tradução "
5617 #~ "automática para uma variedade de formatos adequados para entrada de "
5618 #~ "formatadores de texto. Uma cópia feita em um formato de arquivo "
5619 #~ "Transparente cuja marcação tenha sido projetada para frustrar ou "
5620 #~ "desencorajar a modificação subsequente pelos leitores não é Transparente. "
5621 #~ "Uma cópia que não é “Transparente” é chamada de “Opaca”."
5622
5623 #~ msgid ""
5624 #~ "The <quote>Title Page</quote> means, for a printed book, the title page "
5625 #~ "itself, plus such following pages as are needed to hold, legibly, the "
5626 #~ "material this License requires to appear in the title page. For works in "
5627 #~ "formats which do not have any title page as such, <quote>Title Page</"
5628 #~ "quote> means the text near the most prominent appearance of the work's "
5629 #~ "title, preceding the beginning of the body of the text."
5630 #~ msgstr ""
5631 #~ "A “Página de Título” significa, para um livro impresso, a própria página "
5632 #~ "do título, além das páginas subsequentes necessárias para conter, de "
5633 #~ "forma legível, o material que esta Licença requer que apareça na página "
5634 #~ "do título. Para trabalhos em formatos que não possuem qualquer página de "
5635 #~ "título semelhante, “Página de Título” significa o texto próximo à "
5636 #~ "ocorrência mais proeminente do título do trabalho, precedendo o início do "
5637 #~ "corpo do texto."
5638
5639 #~ msgid ""
5640 #~ "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
5641 #~ "link> in any medium, either commercially or noncommercially, provided "
5642 #~ "that this License, the copyright notices, and the license notice saying "
5643 #~ "this License applies to the Document are reproduced in all copies, and "
5644 #~ "that you add no other conditions whatsoever to those of this License. You "
5645 #~ "may not use technical measures to obstruct or control the reading or "
5646 #~ "further copying of the copies you make or distribute. However, you may "
5647 #~ "accept compensation in exchange for copies. If you distribute a large "
5648 #~ "enough number of copies you must also follow the conditions in <link "
5649 #~ "linkend=\"fdl-section3\">section 3</link>."
5650 #~ msgstr ""
5651 #~ "Você pode copiar e distribuir o <link linkend=\"fdl-document\">Documento</"
5652 #~ "link> em qualquer meio, seja este de forma comercial ou não, desde que "
5653 #~ "esta Licença, os avisos de direitos autorais e o aviso de licença "
5654 #~ "afirmando que esta Licença se aplica ao Documento sejam reproduzidos em "
5655 #~ "todas as cópias, e que você adicione nenhuma outra condição, qualquer que "
5656 #~ "seja, às condições desta Licença. Você não pode usar de medidas técnicas "
5657 #~ "para obstruir ou controlar a leitura ou cópia futura das cópias que você "
5658 #~ "fizer ou distribuir. Contudo, você pode aceitar compensação em troca das "
5659 #~ "cópias. Se você distribuir um número suficientemente grande de cópias, "
5660 #~ "você deve também respeitar as condições descritas na <link linkend=\"fdl-"
5661 #~ "section3\">seção 3</link>."
5662
5663 #~ msgid ""
5664 #~ "If you publish printed copies of the <link linkend=\"fdl-"
5665 #~ "document\">Document</link> numbering more than 100, and the Document's "
5666 #~ "license notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</"
5667 #~ "link>, you must enclose the copies in covers that carry, clearly and "
5668 #~ "legibly, all these Cover Texts: Front-Cover Texts on the front cover, and "
5669 #~ "Back-Cover Texts on the back cover. Both covers must also clearly and "
5670 #~ "legibly identify you as the publisher of these copies. The front cover "
5671 #~ "must present the full title with all words of the title equally prominent "
5672 #~ "and visible. You may add other material on the covers in addition. "
5673 #~ "Copying with changes limited to the covers, as long as they preserve the "
5674 #~ "title of the <link linkend=\"fdl-document\">Document</link> and satisfy "
5675 #~ "these conditions, can be treated as verbatim copying in other respects."
5676 #~ msgstr ""
5677 #~ "Se você publicar cópias impressas do <link linkend=\"fdl-"
5678 #~ "document\">Documento</link> em número maior que 100, e o aviso de licença "
5679 #~ "do Documento exigir os <link linkend=\"fdl-cover-texts\">Textos de Capa</"
5680 #~ "link>, você deve incluir as cópias nas capas que carregam, de forma clara "
5681 #~ "e legível, todas essas Textos de Capa: Textos de Capa Frontal na capa "
5682 #~ "frontal e Textos de Contracapa na contracapa. Ambas as capas também devem "
5683 #~ "identificá-lo claramente e legivelmente como o editor dessas cópias. A "
5684 #~ "capa frontal deve apresentar o título completo com todas as palavras do "
5685 #~ "título igualmente proeminentes e visíveis. Você também pode adicionar "
5686 #~ "outros materiais nas capas. Copiar com as alterações limitadas às capas, "
5687 #~ "desde que preservem o título do <link linkend=\"fdl-document\">Documento</"
5688 #~ "link> e satisfaçam estas condições, podem ser tratadas como cópias "
5689 #~ "literais em outros aspectos."
5690
5691 #~ msgid ""
5692 #~ "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</"
5693 #~ "link> copies of the <link linkend=\"fdl-document\">Document</link> "
5694 #~ "numbering more than 100, you must either include a machine-readable <link "
5695 #~ "linkend=\"fdl-transparent\">Transparent</link> copy along with each "
5696 #~ "Opaque copy, or state in or with each Opaque copy a publicly-accessible "
5697 #~ "computer-network location containing a complete Transparent copy of the "
5698 #~ "Document, free of added material, which the general network-using public "
5699 #~ "has access to download anonymously at no charge using public-standard "
5700 #~ "network protocols. If you use the latter option, you must take reasonably "
5701 #~ "prudent steps, when you begin distribution of Opaque copies in quantity, "
5702 #~ "to ensure that this Transparent copy will remain thus accessible at the "
5703 #~ "stated location until at least one year after the last time you "
5704 #~ "distribute an Opaque copy (directly or through your agents or retailers) "
5705 #~ "of that edition to the public."
5706 #~ msgstr ""
5707 #~ "Se você publicar ou distribuir cópias <link linkend=\"fdl-"
5708 #~ "transparent\">Opacas</link> do <link linkend=\"fdl-document\">Documento</"
5709 #~ "link> em número superior a 100, você deve incluir uma cópia <link "
5710 #~ "linkend=\"fdl-transparent\">Transparente</link> legível por máquina junto "
5711 #~ "com cada cópia Opaca ou estabelecer em ou com cada cópia Opaca uma "
5712 #~ "localização de rede de computador publicamente acessível contendo uma "
5713 #~ "cópia transparente completa do documento, sem material adicional, a "
5714 #~ "partir da qual o público geral usuário de rede tem acesso para baixar "
5715 #~ "anonimamente sem custo, usando protocolos de rede padrão público. Se você "
5716 #~ "usar a última opção, você deve tomar medidas razoavelmente prudentes, "
5717 #~ "quando você começar a distribuir cópias Opacas em quantidade, para "
5718 #~ "garantir que esta cópia Transparente permanecerá acessível no local "
5719 #~ "indicado até pelo menos um ano após a última vez que você distribuir uma "
5720 #~ "cópia Opaca (diretamente ou através de seus agentes ou varejistas) dessa "
5721 #~ "edição para o público."
5722
5723 #~ msgid ""
5724 #~ "It is requested, but not required, that you contact the authors of the "
5725 #~ "<link linkend=\"fdl-document\">Document</link> well before redistributing "
5726 #~ "any large number of copies, to give them a chance to provide you with an "
5727 #~ "updated version of the Document."
5728 #~ msgstr ""
5729 #~ "É solicitado, mas não é necessário, que você contate os autores do <link "
5730 #~ "linkend=\"fdl-document\">Documento</link> muito antes de redistribuir "
5731 #~ "qualquer grande número de cópias, para dar a eles uma chance de lhe "
5732 #~ "fornecer uma versão atualizada do Documento."
5733
5734 #~ msgid ""
5735 #~ "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
5736 #~ "Version</link> of the <link linkend=\"fdl-document\">Document</link> "
5737 #~ "under the conditions of sections <link linkend=\"fdl-section2\">2</link> "
5738 #~ "and <link linkend=\"fdl-section3\">3</link> above, provided that you "
5739 #~ "release the Modified Version under precisely this License, with the "
5740 #~ "Modified Version filling the role of the Document, thus licensing "
5741 #~ "distribution and modification of the Modified Version to whoever "
5742 #~ "possesses a copy of it. In addition, you must do these things in the "
5743 #~ "Modified Version:"
5744 #~ msgstr ""
5745 #~ "Você pode copiar e distribuir uma <link linkend=\"fdl-modified\">Versão "
5746 #~ "Modificada</link> do <link linkend=\"fdl-document\">Documento</link> sob "
5747 #~ "as condições das seções <link linkend=\"fdl-section2\">2</link> e <link "
5748 #~ "linkend=\"fdl-section3\">3</link> acima, desde que você forneça a Versão "
5749 #~ "Modificada estritamente sob esta Licença, com a Versão Modificada "
5750 #~ "preenchendo a função de Documento, permitindo assim a distribuição e "
5751 #~ "modificação da Versão Modificada a quem quer que possua uma cópia desta. "
5752 #~ "Além disso, você deve executar os seguintes procedimentos na Versão "
5753 #~ "Modificada:"
5754
5755 #~ msgid ""
5756 #~ "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
5757 #~ "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
5758 #~ "document\">Document</link>, and from those of previous versions (which "
5759 #~ "should, if there were any, be listed in the History section of the "
5760 #~ "Document). You may use the same title as a previous version if the "
5761 #~ "original publisher of that version gives permission."
5762 #~ msgstr ""
5763 #~ "Usar na <link linkend=\"fdl-title-page\">Página de Título</link> (e nas "
5764 #~ "capas, se existirem) um título distinto em relação ao do <link "
5765 #~ "linkend=\"fdl-document\">Documento</link>, e daqueles de versões "
5766 #~ "anteriores (os quais devem, havendo algum, ser listados na seção "
5767 #~ "“Histórico” do Documento). Você pode usar o mesmo título de uma versão "
5768 #~ "anterior se o editor original daquela versão lhe conceder permissão."
5769
5770 #~ msgid ""
5771 #~ "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as "
5772 #~ "authors, one or more persons or entities responsible for authorship of "
5773 #~ "the modifications in the <link linkend=\"fdl-modified\">Modified Version</"
5774 #~ "link>, together with at least five of the principal authors of the <link "
5775 #~ "linkend=\"fdl-document\">Document</link> (all of its principal authors, "
5776 #~ "if it has less than five)."
5777 #~ msgstr ""
5778 #~ "Listar na <link linkend=\"fdl-title-page\">Página de Título</link>, como "
5779 #~ "autores, uma ou mais pessoas ou entidades responsáveis pela autoria das "
5780 #~ "modificações na <link linkend=\"fdl-modified\">Versão Modificada</link>, "
5781 #~ "juntamente com pelo menos cinco dos autores principais do <link "
5782 #~ "linkend=\"fdl-document\">Documento</link> (todos os seus principais "
5783 #~ "autores, se tiverem menos de cinco)."
5784
5785 #~ msgid ""
5786 #~ "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name "
5787 #~ "of the publisher of the <link linkend=\"fdl-modified\">Modified Version</"
5788 #~ "link>, as the publisher."
5789 #~ msgstr ""
5790 #~ "Indicar na <link linkend=\"fdl-title-page\">Página de Título</link> o "
5791 #~ "nome do editor da <link linkend=\"fdl-modified\">Versão Modificada</"
5792 #~ "link>, como editor."
5793
5794 #~ msgid ""
5795 #~ "Preserve all the copyright notices of the <link linkend=\"fdl-"
5796 #~ "document\">Document</link>."
5797 #~ msgstr ""
5798 #~ "Preservar todas as avisos de direitos autorais do <link linkend=\"fdl-"
5799 #~ "document\">Documento</link>."
5800
5801 #~ msgid ""
5802 #~ "Include, immediately after the copyright notices, a license notice giving "
5803 #~ "the public permission to use the <link linkend=\"fdl-modified\">Modified "
5804 #~ "Version</link> under the terms of this License, in the form shown in the "
5805 #~ "Addendum below."
5806 #~ msgstr ""
5807 #~ "Incluir, imediatamente após os avisos de direitos autorais, um aviso de "
5808 #~ "licença que dê permissão ao público para usar a <link linkend=\"fdl-"
5809 #~ "modified\">Versão Modificada</link> sob os termos desta Licença, na forma "
5810 #~ "mostrada no Adendo abaixo."
5811
5812 #~ msgid ""
5813 #~ "Preserve in that license notice the full lists of <link linkend=\"fdl-"
5814 #~ "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
5815 #~ "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-"
5816 #~ "document\">Document's</link> license notice."
5817 #~ msgstr ""
5818 #~ "Preservar nesse aviso de licença as listas completas de <link "
5819 #~ "linkend=\"fdl-invariant\">Seções Invariantes</link> e os <link "
5820 #~ "linkend=\"fdl-cover-texts\">Textos de Capa</link> necessários fornecidos "
5821 #~ "no aviso de licença do <link linkend=\"fdl-document\">Documento</link>."
5822
5823 #~ msgid ""
5824 #~ "Preserve the section entitled <quote>History</quote>, and its title, and "
5825 #~ "add to it an item stating at least the title, year, new authors, and "
5826 #~ "publisher of the <link linkend=\"fdl-modified\">Modified Version</link> "
5827 #~ "as given on the <link linkend=\"fdl-title-page\">Title Page</link>. If "
5828 #~ "there is no section entitled <quote>History</quote> in the <link "
5829 #~ "linkend=\"fdl-document\">Document</link>, create one stating the title, "
5830 #~ "year, authors, and publisher of the Document as given on its Title Page, "
5831 #~ "then add an item describing the Modified Version as stated in the "
5832 #~ "previous sentence."
5833 #~ msgstr ""
5834 #~ "Preservar a seção intitulada “Histórico”, e seu título, e adicionar a ele "
5835 #~ "um item que indique pelo menos o título, o ano, os novos autores e o "
5836 #~ "editor da <link linkend=\"fdl-modified\">Versão Modificada</link> "
5837 #~ "conforme indicado na <link linkend=\"fdl-title-page\">Página de Título</"
5838 #~ "link>. Se não houver uma seção intitulada “Histórico” no <link "
5839 #~ "linkend=\"fdl-document\">Documento</link>, crie um que declare o título, "
5840 #~ "o ano, os autores e o editor do Documento conforme indicado em sua Página "
5841 #~ "de Título e, em seguida, adicione um item descrevendo a Versão "
5842 #~ "Modificada, como indicado na frase anterior."
5843
5844 #~ msgid ""
5845 #~ "Preserve the network location, if any, given in the <link linkend=\"fdl-"
5846 #~ "document\">Document</link> for public access to a <link linkend=\"fdl-"
5847 #~ "transparent\">Transparent</link> copy of the Document, and likewise the "
5848 #~ "network locations given in the Document for previous versions it was "
5849 #~ "based on. These may be placed in the <quote>History</quote> section. You "
5850 #~ "may omit a network location for a work that was published at least four "
5851 #~ "years before the Document itself, or if the original publisher of the "
5852 #~ "version it refers to gives permission."
5853 #~ msgstr ""
5854 #~ "Preservar a localização de rede, se for o caso, fornecida no <link "
5855 #~ "linkend=\"fdl-document\">Documento</link> para acesso público a uma cópia "
5856 #~ "<link linkend=\"fdl-transparent\">Transparente</link> do Documento, e "
5857 #~ "também as localizações de rede fornecidas no Documento para versões "
5858 #~ "anteriores nas quais ele foi baseado. Estas podem ser colocadas na seção "
5859 #~ "“Histórico”. Você pode omitir uma localização de rede para um trabalho "
5860 #~ "que foi publicado pelo menos quatro anos antes do Documento em si, ou se "
5861 #~ "o editor original da versão a que se refere der permissão."
5862
5863 #~ msgid ""
5864 #~ "In any section entitled <quote>Acknowledgements</quote> or "
5865 #~ "<quote>Dedications</quote>, preserve the section's title, and preserve in "
5866 #~ "the section all the substance and tone of each of the contributor "
5867 #~ "acknowledgements and/or dedications given therein."
5868 #~ msgstr ""
5869 #~ "Em qualquer seção intitulada “Agradecimentos” ou “Dedicatórias”, "
5870 #~ "preservar o título da seção, e preservar na seção toda a substância e tom "
5871 #~ "de cada um dos agradecimentos e/ou das dedicatórias dados nela."
5872
5873 #~ msgid ""
5874 #~ "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</"
5875 #~ "link> of the <link linkend=\"fdl-document\">Document</link>, unaltered in "
5876 #~ "their text and in their titles. Section numbers or the equivalent are not "
5877 #~ "considered part of the section titles."
5878 #~ msgstr ""
5879 #~ "Preservar todas as <link linkend=\"fdl-invariant\">Seções Invariantes</"
5880 #~ "link> do <link linkend=\"fdl-document\">Documento</link>, inalteradas em "
5881 #~ "seus textos e em seus títulos. Os números de seção ou o equivalente não "
5882 #~ "são considerados parte dos títulos das seções."
5883
5884 #~ msgid ""
5885 #~ "Delete any section entitled <quote>Endorsements</quote>. Such a section "
5886 #~ "may not be included in the <link linkend=\"fdl-modified\">Modified "
5887 #~ "Version</link>."
5888 #~ msgstr ""
5889 #~ "Excluir qualquer seção intitulada “Endossos”. Essa seção pode não estar "
5890 #~ "incluída na <link linkend=\"fdl-modified\">Versão Modificada</link>."
5891
5892 #~ msgid ""
5893 #~ "Do not retitle any existing section as <quote>Endorsements</quote> or to "
5894 #~ "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
5895 #~ "Section</link>."
5896 #~ msgstr ""
5897 #~ "Não mudar o título de qualquer seção existente para “Endossos” ou para "
5898 #~ "conflitar em título com qualquer <link linkend=\"fdl-invariant\">Seção "
5899 #~ "Invariante</link>."
5900
5901 #~ msgid ""
5902 #~ "If the <link linkend=\"fdl-modified\">Modified Version</link> includes "
5903 #~ "new front-matter sections or appendices that qualify as <link "
5904 #~ "linkend=\"fdl-secondary\">Secondary Sections</link> and contain no "
5905 #~ "material copied from the Document, you may at your option designate some "
5906 #~ "or all of these sections as invariant. To do this, add their titles to "
5907 #~ "the list of <link linkend=\"fdl-invariant\">Invariant Sections</link> in "
5908 #~ "the Modified Version's license notice. These titles must be distinct from "
5909 #~ "any other section titles."
5910 #~ msgstr ""
5911 #~ "Se a <link linkend=\"fdl-modified\">Versão Modificada</link> incluir "
5912 #~ "novas seções ou apêndices de primeira linha que se qualifiquem como <link "
5913 #~ "linkend=\"fdl-secondary\">Seções Secundárias</link> e não contenham "
5914 #~ "material copiado do Documento, você pode, a sua escolha, designar algumas "
5915 #~ "ou todas essas seções como invariantes. Para fazer isso, adicione seus "
5916 #~ "títulos à lista de <link linkend=\"fdl-invariant\">Seções Invariantes</"
5917 #~ "link> no aviso de licença da Versão Modificada. Esses títulos devem ser "
5918 #~ "distintos de qualquer outro título de seção."
5919
5920 #~ msgid ""
5921 #~ "You may add a section entitled <quote>Endorsements</quote>, provided it "
5922 #~ "contains nothing but endorsements of your <link linkend=\"fdl-"
5923 #~ "modified\">Modified Version</link> by various parties--for example, "
5924 #~ "statements of peer review or that the text has been approved by an "
5925 #~ "organization as the authoritative definition of a standard."
5926 #~ msgstr ""
5927 #~ "Você pode incluir uma seção intitulada “Endossos”, desde que contenha "
5928 #~ "nada além do endosso da sua <link linkend=\"fdl-modified\">Versão "
5929 #~ "Modificada</link> por várias terceiros – por exemplo, declarações de "
5930 #~ "revisão por pares ou de que o texto foi aprovado por uma organização como "
5931 #~ "a definição oficial de um padrão."
5932
5933 #~ msgid ""
5934 #~ "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
5935 #~ "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a "
5936 #~ "<link linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of "
5937 #~ "the list of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the "
5938 #~ "<link linkend=\"fdl-modified\">Modified Version</link>. Only one passage "
5939 #~ "of Front-Cover Text and one of Back-Cover Text may be added by (or "
5940 #~ "through arrangements made by) any one entity. If the <link linkend=\"fdl-"
5941 #~ "document\">Document</link> already includes a cover text for the same "
5942 #~ "cover, previously added by you or by arrangement made by the same entity "
5943 #~ "you are acting on behalf of, you may not add another; but you may replace "
5944 #~ "the old one, on explicit permission from the previous publisher that "
5945 #~ "added the old one."
5946 #~ msgstr ""
5947 #~ "Você pode adicionar uma passagem de até cinco palavras como um <link "
5948 #~ "linkend=\"fdl-cover-texts\">Texto de Capa Frontal</link> e uma passagem "
5949 #~ "de até 25 palavras como um <link linkend=\"fdl-cover-texts\">Texto de "
5950 #~ "Contracapa</link>, até o final da lista de <link linkend=\"fdl-cover-"
5951 #~ "texts\">Textos de Capa</link> na <link linkend=\"fdl-modified\">Versão "
5952 #~ "Modificada</link>. Apenas uma passagem de Texto de Capa Frontal e um de "
5953 #~ "Texto de Contracapa pode ser adicionada por (ou por meio de acordos "
5954 #~ "feitos por) qualquer entidade. Se o <link linkend=\"fdl-"
5955 #~ "document\">Documento</link> já incluir um texto de capa para a mesma "
5956 #~ "capa, previamente adicionado por você ou por acordo feito pela mesma "
5957 #~ "entidade em que você está agindo em nome de, você não pode adicionar "
5958 #~ "outro; mas você pode substituir o antigo, mediante permissão explícita do "
5959 #~ "editor anterior que adicionou o antigo."
5960
5961 #~ msgid ""
5962 #~ "The author(s) and publisher(s) of the <link linkend=\"fdl-"
5963 #~ "document\">Document</link> do not by this License give permission to use "
5964 #~ "their names for publicity for or to assert or imply endorsement of any "
5965 #~ "<link linkend=\"fdl-modified\">Modified Version </link>."
5966 #~ msgstr ""
5967 #~ "O(s) autor(es) e editor(es) do <link linkend=\"fdl-document\">Documento</"
5968 #~ "link> não concedem por esta Licença permissão para usar seus nomes para "
5969 #~ "publicidade ou afirmar ou implicar o endosso de qualquer <link "
5970 #~ "linkend=\"fdl-modified\">Versão Modificada</link>."
5971
5972 #~ msgid ""
5973 #~ "You may combine the <link linkend=\"fdl-document\">Document</link> with "
5974 #~ "other documents released under this License, under the terms defined in "
5975 #~ "<link linkend=\"fdl-section4\">section 4</link> above for modified "
5976 #~ "versions, provided that you include in the combination all of the <link "
5977 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> of all of the "
5978 #~ "original documents, unmodified, and list them all as Invariant Sections "
5979 #~ "of your combined work in its license notice."
5980 #~ msgstr ""
5981 #~ "Você pode combinar o <link linkend=\"fdl-document\">Documento</link> com "
5982 #~ "outros documentos publicados sob esta Licença, nos termos definidos na "
5983 #~ "<link linkend=\"fdl-section4\">seção 4</link> acima para versões "
5984 #~ "modificadas, desde que você inclua na combinação de todas as <link "
5985 #~ "linkend=\"fdl-invariant\">Seções Invariantes</link> de todos os "
5986 #~ "documentos originais, não modificados, e liste todos eles como Seções "
5987 #~ "Invariantes do seu trabalho combinado em seu aviso de licença."
5988
5989 #~ msgid ""
5990 #~ "The combined work need only contain one copy of this License, and "
5991 #~ "multiple identical <link linkend=\"fdl-invariant\">Invariant Sections</"
5992 #~ "link> may be replaced with a single copy. If there are multiple Invariant "
5993 #~ "Sections with the same name but different contents, make the title of "
5994 #~ "each such section unique by adding at the end of it, in parentheses, the "
5995 #~ "name of the original author or publisher of that section if known, or "
5996 #~ "else a unique number. Make the same adjustment to the section titles in "
5997 #~ "the list of Invariant Sections in the license notice of the combined work."
5998 #~ msgstr ""
5999 #~ "O trabalho combinado precisa conter somente uma cópia desta Licença, e "
6000 #~ "várias <link linkend=\"fdl-invariant\">Seções Invariantes</link> "
6001 #~ "idênticas podem ser substituídas por uma única cópia. Se existirem várias "
6002 #~ "Seções Invariantes de mesmo nome, porém com conteúdos diferentes, você "
6003 #~ "deve tornar o título de cada uma destas seções único, adicionando ao fim "
6004 #~ "deste, entre parênteses, o nome do autor ou, se conhecido, o editor "
6005 #~ "original desta seção, ou ainda um número único. Faça o mesmo ajuste nos "
6006 #~ "títulos de seção na lista de Seções Invariantes no aviso de licença do "
6007 #~ "trabalho combinado."
6008
6009 #~ msgid ""
6010 #~ "In the combination, you must combine any sections entitled "
6011 #~ "<quote>History</quote> in the various original documents, forming one "
6012 #~ "section entitled <quote>History</quote>; likewise combine any sections "
6013 #~ "entitled <quote>Acknowledgements</quote>, and any sections entitled "
6014 #~ "<quote>Dedications</quote>. You must delete all sections entitled "
6015 #~ "<quote>Endorsements.</quote>"
6016 #~ msgstr ""
6017 #~ "Na combinação, você deve combinar todas as seções intituladas “Histórico” "
6018 #~ "nos vários documentos originais, formando uma seção intitulada "
6019 #~ "“Histórico”; da mesma forma, combinar todas as seções intituladas "
6020 #~ "“Agradecimentos” e quaisquer seções intituladas “Dedicatórias”. Você deve "
6021 #~ "excluir todas as seções intituladas “Endossos”."
6022
6023 #~ msgid ""
6024 #~ "You may make a collection consisting of the <link linkend=\"fdl-"
6025 #~ "document\">Document</link> and other documents released under this "
6026 #~ "License, and replace the individual copies of this License in the various "
6027 #~ "documents with a single copy that is included in the collection, provided "
6028 #~ "that you follow the rules of this License for verbatim copying of each of "
6029 #~ "the documents in all other respects."
6030 #~ msgstr ""
6031 #~ "Você pode fazer uma coleção que consiste do <link linkend=\"fdl-"
6032 #~ "document\">Documento</link> e outros documentos publicados sob esta "
6033 #~ "Licença, e substituir as cópias individuais desta Licença, nos vários "
6034 #~ "documentos, por uma única cópia a ser incluída na coleção, desde que você "
6035 #~ "siga as regras desta Licença para cópias literais de cada documento em "
6036 #~ "todos os outros aspectos."
6037
6038 #~ msgid ""
6039 #~ "A compilation of the <link linkend=\"fdl-document\">Document</link> or "
6040 #~ "its derivatives with other separate and independent documents or works, "
6041 #~ "in or on a volume of a storage or distribution medium, does not as a "
6042 #~ "whole count as a <link linkend=\"fdl-modified\">Modified Version</link> "
6043 #~ "of the Document, provided no compilation copyright is claimed for the "
6044 #~ "compilation. Such a compilation is called an <quote>aggregate</quote>, "
6045 #~ "and this License does not apply to the other self-contained works thus "
6046 #~ "compiled with the Document , on account of their being thus compiled, if "
6047 #~ "they are not themselves derivative works of the Document. If the <link "
6048 #~ "linkend=\"fdl-cover-texts\">Cover Text</link> requirement of <link "
6049 #~ "linkend=\"fdl-section3\">section 3</link> is applicable to these copies "
6050 #~ "of the Document, then if the Document is less than one quarter of the "
6051 #~ "entire aggregate, the Document's Cover Texts may be placed on covers that "
6052 #~ "surround only the Document within the aggregate. Otherwise they must "
6053 #~ "appear on covers around the whole aggregate."
6054 #~ msgstr ""
6055 #~ "Uma compilação do <link linkend=\"fdl-document\">Documento</link> ou seus "
6056 #~ "derivados com outros documentos ou trabalhos separados e independentes, "
6057 #~ "em ou sobre um volume de um meio de armazenamento ou distribuição, não "
6058 #~ "como um todo conta como uma <link linkend=\"fdl-modified\">Versão "
6059 #~ "Modificada</link> do Documento, desde que nenhuma compilação de direitos "
6060 #~ "autorais seja reivindicada para a compilação. Tal compilação é chamada de "
6061 #~ "“agregado” (aggregate), e esta Licença não se aplica aos outros trabalhos "
6062 #~ "autônomos assim compilados com o Documento, por conta de serem assim "
6063 #~ "compilados, se eles não forem eles próprios trabalhos derivados do "
6064 #~ "Documento. Se o requisito do <link linkend=\"fdl-cover-texts\">Texto da "
6065 #~ "Capa</link> da <link linkend=\"fdl-section3\">seção 3</link> for "
6066 #~ "aplicável a essas cópias do Documento, então, se o Documento for inferior "
6067 #~ "a um quarto do agregado inteiro, os Textos de Capa do Documento poderão "
6068 #~ "ser colocados em capas que envolvam apenas o Documento no agregado. Caso "
6069 #~ "contrário, eles devem aparecer nas capas envolvem todo o agregado."
6070
6071 #~ msgid ""
6072 #~ "Translation is considered a kind of modification, so you may distribute "
6073 #~ "translations of the <link linkend=\"fdl-document\">Document</link> under "
6074 #~ "the terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing "
6075 #~ "<link linkend=\"fdl-invariant\"> Invariant Sections</link> with "
6076 #~ "translations requires special permission from their copyright holders, "
6077 #~ "but you may include translations of some or all Invariant Sections in "
6078 #~ "addition to the original versions of these Invariant Sections. You may "
6079 #~ "include a translation of this License provided that you also include the "
6080 #~ "original English version of this License. In case of a disagreement "
6081 #~ "between the translation and the original English version of this License, "
6082 #~ "the original English version will prevail."
6083 #~ msgstr ""
6084 #~ "A tradução é considerada um tipo de modificação, então você pode "
6085 #~ "distribuir as traduções do <link linkend=\"fdl-document\">Documento</"
6086 #~ "link> nos termos da <link linkend=\"fdl-section4\">seção 4</link>. A "
6087 #~ "substituição das <link linkend=\"fdl-invariant\">Seções Invariantes</"
6088 #~ "link> com traduções requer permissão especial de seus detentores de "
6089 #~ "direitos autorais, mas você pode incluir traduções de algumas ou todas as "
6090 #~ "Seções Invariantes além das versões originais destas Seções Invariantes. "
6091 #~ "Você pode incluir uma tradução desta Licença, desde que você também "
6092 #~ "inclua a versão original em inglês desta Licença. Em caso de desacordo "
6093 #~ "entre a tradução e a versão original desta Licença, a versão original "
6094 #~ "prevalecerá."
6095
6096 #~ msgid ""
6097 #~ "You may not copy, modify, sublicense, or distribute the <link "
6098 #~ "linkend=\"fdl-document\">Document</link> except as expressly provided for "
6099 #~ "under this License. Any other attempt to copy, modify, sublicense or "
6100 #~ "distribute the Document is void, and will automatically terminate your "
6101 #~ "rights under this License. However, parties who have received copies, or "
6102 #~ "rights, from you under this License will not have their licenses "
6103 #~ "terminated so long as such parties remain in full compliance."
6104 #~ msgstr ""
6105 #~ "Você não pode copiar, modificar, sublicenciar ou distribuir o <link "
6106 #~ "linkend=\"fdl-document\">Documento</link>, exceto conforme expressamente "
6107 #~ "previsto nesta Licença. Qualquer tentativa de copiar, modificar, "
6108 #~ "sublicenciar ou distribuir o Documento é anulada e terminará "
6109 #~ "automaticamente seus direitos sob esta Licença. No entanto, as partes que "
6110 #~ "receberam cópias ou direitos de você sob esta Licença não terão suas "
6111 #~ "licenças terminadas, desde que tais partes permaneçam em plena "
6112 #~ "conformidade."
6113
6114 #~ msgid ""
6115 #~ "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
6116 #~ "Software Foundation</ulink> may publish new, revised versions of the GNU "
6117 #~ "Free Documentation License from time to time. Such new versions will be "
6118 #~ "similar in spirit to the present version, but may differ in detail to "
6119 #~ "address new problems or concerns. See <ulink type=\"http\" url=\"http://"
6120 #~ "www.gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
6121 #~ msgstr ""
6122 #~ "A <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
6123 #~ "Software Foundation</ulink> pode publicar novas e revisadas versões da "
6124 #~ "Licença de Documentação Livre GNU de vez em quando. Essas novas versões "
6125 #~ "serão semelhantes em espírito à versão atual, mas podem diferir em "
6126 #~ "detalhes para resolver novos problemas ou preocupações. Veja <ulink "
6127 #~ "type=\"http\" url=\"http://www.gnu.org/copyleft\">http://www.gnu.org/"
6128 #~ "copyleft/</ulink>.A <ulink type=\"http\" url=\"http://www.gnu.org/fsf/"
6129 #~ "fsf.html\">Free Software Foundation</ulink> pode publicar novas versões, "
6130 #~ "revisadas, da Licença de Documentação Livre GNU de tempos em tempos. Tais "
6131 #~ "versões posteriores terão ideologia similar à presente versão, embora "
6132 #~ "possam diferir em detalhes a fim de abordar novos problemas ou "
6133 #~ "preocupações. Consulte: <ulink type=\"http\" url=\"http://www.gnu.org/"
6134 #~ "copyleft\">http://www.gnu.org/copyleft/</ulink>."
6135
6136 #~ msgid ""
6137 #~ "Each version of the License is given a distinguishing version number. If "
6138 #~ "the <link linkend=\"fdl-document\">Document</link> specifies that a "
6139 #~ "particular numbered version of this License <quote>or any later version</"
6140 #~ "quote> applies to it, you have the option of following the terms and "
6141 #~ "conditions either of that specified version or of any later version that "
6142 #~ "has been published (not as a draft) by the Free Software Foundation. If "
6143 #~ "the Document does not specify a version number of this License, you may "
6144 #~ "choose any version ever published (not as a draft) by the Free Software "
6145 #~ "Foundation."
6146 #~ msgstr ""
6147 #~ "Cada versão da Licença recebe um número de versão distinto. Se o <link "
6148 #~ "linkend=\"fdl-document\">Documento</link> especifica que uma versão "
6149 #~ "numerada específica desta Licença “ou qualquer versão posterior” aplica-"
6150 #~ "se a ele, você tem a opção de seguir os termos e condições daquela versão "
6151 #~ "especificada ou de qualquer versão posterior que tenha sido publicada "
6152 #~ "(não como um rascunho) pela Free Software Foundation. Se o Documento não "
6153 #~ "especificar um número de versão desta Licença, você pode escolher "
6154 #~ "qualquer versão publicada (não como um rascunho) pela Free Software "
6155 #~ "Foundation."
6156
6157 #~ msgid ""
6158 #~ "Permission is granted to copy, distribute and/or modify this document "
6159 #~ "under the terms of the GNU Free Documentation License, Version 1.1 or any "
6160 #~ "later version published by the Free Software Foundation; with the <link "
6161 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> being LIST THEIR "
6162 #~ "TITLES, with the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</"
6163 #~ "link> being LIST, and with the <link linkend=\"fdl-cover-texts\">Back-"
6164 #~ "Cover Texts</link> being LIST. A copy of the license is included in the "
6165 #~ "section entitled <quote>GNU Free Documentation License</quote>."
6166 #~ msgstr ""
6167 #~ "Permissão concedida para copiar, distribuir e/ou modificar este documento "
6168 #~ "sob os termos da Licença de Documentação Livre GNU, Versão 1.1 ou "
6169 #~ "qualquer versão mais recente publicada pela Free Software Foundation; com "
6170 #~ "as <link linkend=\"fdl-invariant\">Seções Invariantes</link> sendo LISTE "
6171 #~ "SEUS TÍTULOS, com os <link linkend=\"fdl-cover-texts\">Textos de Capa "
6172 #~ "Frontal</link> sendo LISTA e os <link linkend=\"fdl-cover-texts\">Textos "
6173 #~ "de Contracapa</link> sendo LISTA. Uma cópia da licença está incluída na "
6174 #~ "seção intitulada \"Licença de Documentação Livre GNU\" (GNU Free "
6175 #~ "Documentation License)."
6176
6177 #~ msgid ""
6178 #~ "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
6179 #~ "write <quote>with no Invariant Sections</quote> instead of saying which "
6180 #~ "ones are invariant. If you have no <link linkend=\"fdl-cover-"
6181 #~ "texts\">Front-Cover Texts</link>, write <quote>no Front-Cover Texts</"
6182 #~ "quote> instead of <quote>Front-Cover Texts being LIST</quote>; likewise "
6183 #~ "for <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link>."
6184 #~ msgstr ""
6185 #~ "Se você não tiver <link linkend=\"fdl-invariant\">Seção Invariante</"
6186 #~ "link>, escreva “sem Seções Invariantes” em vez de dizer quais são "
6187 #~ "invariantes. Se você não tiver <link linkend=\"fdl-cover-texts\">Textos "
6188 #~ "de Capa Frontal</link>, escreva “sem Textos da Capa Frontal” em vez de "
6189 #~ "“Textos de Capa Frontal sendo LIST”; Da mesma forma para <link "
6190 #~ "linkend=\"fdl-cover-texts\">Textos de Contracapa</link>."
6191
6192 #~ msgid ""
6193 #~ "If your document contains nontrivial examples of program code, we "
6194 #~ "recommend releasing these examples in parallel under your choice of free "
6195 #~ "software license, such as the <ulink type=\"http\" url=\"http://"
6196 #~ "www.gnu.org/copyleft/gpl.html\"> GNU General Public License</ulink>, to "
6197 #~ "permit their use in free software."
6198 #~ msgstr ""
6199 #~ "Se o seu documento contiver exemplos não triviais do código do programa, "
6200 #~ "recomendamos que apresente esses exemplos em paralelo, sob sua escolha de "
6201 #~ "licença de software livre, como a <ulink type=\"http\" url=\"http://"
6202 #~ "www.gnu.org/copyleft/gpl.html\">Licença Pública Geral GNU</ulink> (GNU "
6203 #~ "General Public License), para permitir sua utilização em software livre."
6204
6205 #~ msgid ""
6206 #~ "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
6207 #~ "authorinitials> <revremark>development</revremark>"
6208 #~ msgstr ""
6209 #~ "<revnumber>1.29</revnumber> <date>28 Ago 2018</date> <authorinitials>ss</"
6210 #~ "authorinitials> <revremark>desenvolvimento</revremark>"
6211
6212 #~ msgid "Setting up your project"
6213 #~ msgstr "Preparando seu projeto"
6214
6215 #~ msgid ""
6216 #~ "The next sections describe what steps to perform to integrate GTK-Doc "
6217 #~ "into your project. Theses sections assume we work on a project called "
6218 #~ "'meep'. This project contains a library called 'libmeep' and an end-user "
6219 #~ "app called 'meeper'. We also assume you will be using autoconf and "
6220 #~ "automake. In addition section <link linkend=\"plain_makefiles\">plain "
6221 #~ "makefiles or other build systems</link> will describe the basics needed "
6222 #~ "to work in a different build setup."
6223 #~ msgstr ""
6224 #~ "As próximas seções descrevem quais as etapas para realizar a integração "
6225 #~ "do GTK-Doc em seu projeto. Estas seções consideram que nós trabalhamos em "
6226 #~ "um projeto chamado “meep”. Este projeto contém uma biblioteca chamada "
6227 #~ "“libmeep” e um aplicativo para usuário final chamado “meeper”. Nós também "
6228 #~ "consideramos que você estará usando autoconf e automake. Além disso, a "
6229 #~ "seção sobre <link linkend=\"plain_makefiles\">makefiles simples ou outros "
6230 #~ "sistemas de compilação</link> vai descrever as necessidades básicas para "
6231 #~ "trabalhar em uma configuração de compilação diferente."
6232
6233 #~ msgid ""
6234 #~ "Under your top-level project directory create folders called docs/"
6235 #~ "reference (this way you can also have docs/help for end-user "
6236 #~ "documentation). It is recommended to create another subdirectory with the "
6237 #~ "name of the doc-package. For packages with just one library this step is "
6238 #~ "not necessary."
6239 #~ msgstr ""
6240 #~ "No diretório raiz do seu projeto, crie pastas chamadas docs/reference "
6241 #~ "(desta forma, você também pode ter docs/help para documentação para "
6242 #~ "usuário final). É recomendado criar um outro subdiretório com o nome do "
6243 #~ "pacote de documentação. Para pacotes com apenas uma biblioteca, esta "
6244 #~ "etapa não é obrigatória."
6245
6246 #~ msgid "Example directory structure"
6247 #~ msgstr "Exemplo de estrutura de diretórios"
6248
6249 #~ msgid "This can then look as shown below: <_:example-1/>"
6250 #~ msgstr "Isto pode, então, parecer como exibido abaixo: <_:example-1/>"
6251
6252 #~ msgid ""
6253 #~ "Very easy! Just add one line to your <filename>configure.ac</filename> "
6254 #~ "script."
6255 #~ msgstr ""
6256 #~ "Muito fácil! Basta adicionar uma linha ao seu script "
6257 #~ "<filename>configure.ac</filename>."
6258
6259 #~ msgid ""
6260 #~ "\n"
6261 #~ "# check for gtk-doc\n"
6262 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6263 #~ msgstr ""
6264 #~ "\n"
6265 #~ "# verifica por gtk-doc\n"
6266 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6267
6268 #~ msgid "Keep gtk-doc optional"
6269 #~ msgstr "Mantenha o gtk-doc como opcional"
6270
6271 #~ msgid ""
6272 #~ "\n"
6273 #~ "# check for gtk-doc\n"
6274 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
6275 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6276 #~ "],[\n"
6277 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
6278 #~ "])\n"
6279 #~ msgstr ""
6280 #~ "\n"
6281 #~ "# verifica por gtk-doc\n"
6282 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
6283 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6284 #~ "],[\n"
6285 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
6286 #~ "])\n"
6287
6288 #~ msgid ""
6289 #~ "This will require all developers to have gtk-doc installed. If it is okay "
6290 #~ "for your project to have optional api-doc build setup, you can solve this "
6291 #~ "as below. Keep it as is, as gtkdocize is looking for "
6292 #~ "<function>GTK_DOC_CHECK</function> at the start of a line. <_:example-1/>"
6293 #~ msgstr ""
6294 #~ "Isso vai exigir que todos os desenvolvedores tenham o gtk-doc instalado. "
6295 #~ "Se não houver problema para seu projeto ter uma configuração opcional de "
6296 #~ "compilação de documentação de API, você pode resolver isso como mostrado "
6297 #~ "abaixo. Mantenha assim, pois o gtkdocize está procurando por "
6298 #~ "<function>GTK_DOC_CHECK</function> no começo de uma linha. <_:example-1/>"
6299
6300 #~ msgid ""
6301 #~ "Furthermore it is recommended that you have the following line inside "
6302 #~ "your <filename>configure.ac</filename> script. This allows "
6303 #~ "<application>gtkdocize</application> to automatically copy the macro "
6304 #~ "definition for <function>GTK_DOC_CHECK</function> to your project."
6305 #~ msgstr ""
6306 #~ "Além disso, é recomendado que você tenha a seguinte linha dentro do seu "
6307 #~ "script <filename>configure.ac</filename>. Ela permite que "
6308 #~ "<application>gtkdocize</application> copie automaticamente a definição de "
6309 #~ "macro para <function>GTK_DOC_CHECK</function> para o seu projeto."
6310
6311 #~ msgid "Preparation for gtkdocize"
6312 #~ msgstr "Preparação para gtkdocize"
6313
6314 #~ msgid ""
6315 #~ "\n"
6316 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
6317 #~ msgstr ""
6318 #~ "\n"
6319 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
6320
6321 #~ msgid ""
6322 #~ "Historically GTK-Doc was generating template files where developers "
6323 #~ "entered the docs. This turned out to be not so good (e.g. the need for "
6324 #~ "having generated files under version control). Since GTK-Doc 1.9 the "
6325 #~ "tools can get all the information from source comments and thus the "
6326 #~ "templates can be avoided. We encourage people to keep documentation in "
6327 #~ "the code. <application>gtkdocize</application> supports now a <option>--"
6328 #~ "flavour no-tmpl</option> option that chooses a makefile that skips tmpl "
6329 #~ "usage totally. Besides adding the option directly to the command "
6330 #~ "invocation, they can be added also to an environment variable called "
6331 #~ "<symbol>GTKDOCIZE_FLAGS</symbol> or set as a 2nd parameter in "
6332 #~ "<symbol>GTK_DOC_CHECK</symbol> macro in the configure script. If you have "
6333 #~ "never changed file in tmpl by hand and migrating from older gtkdoc "
6334 #~ "versions, please remove the directory (e.g. from version control system)."
6335 #~ msgstr ""
6336 #~ "Historicamente, GTK-Doc estava gerando arquivos modelo (template) nos "
6337 #~ "quais os desenvolvedores inseriam as documentações. Isso acabou sendo não "
6338 #~ "tão bom (ex.: a necessidade de serem gerados arquivos sob controle de "
6339 #~ "versão). Desde o GTK-Doc 1.9 as ferramentas podem obter todas as "
6340 #~ "informações dos comentários no fonte e, portanto, os arquivos modelo "
6341 #~ "podem ser evitados. Nós encorajamos as pessoas a manter a documentação no "
6342 #~ "código. O <application>gtkdocize</application> possui agora suporte à "
6343 #~ "opção <option>--flavour no-tmpl</option> que escolhe um makefile que "
6344 #~ "ignora totalmente o uso de tmpl. Além de adicionar a opção diretamente à "
6345 #~ "chamada do comando, elas também podem ser adicionadas a uma variável de "
6346 #~ "ambiente chamada <symbol>GTKDOCIZE_FLAGS</symbol> ou definidas como um "
6347 #~ "segundo parâmetro na macro <symbol>GTK_DOC_CHECK</symbol> no script "
6348 #~ "configure. Se você nunca alterou um arquivo tmpl a mão e está migrando de "
6349 #~ "versões antigas do gtkdoc, por favor remova o diretório (ex.: do sistema "
6350 #~ "de controle de versão)."
6351
6352 #~ msgid ""
6353 #~ "Now you can point your browser to <filename>docs/reference/"
6354 #~ "&lt;package&gt;/index.html</filename>. Yes, it's a bit disappointing "
6355 #~ "still. But hang-on, during the next chapter we tell you how to fill the "
6356 #~ "pages with life."
6357 #~ msgstr ""
6358 #~ "Agora você pode apontar seu navegador para <filename>docs/reference/"
6359 #~ "&lt;pacote&gt;/index.html</filename>. Sim, é um pouco desapontador. Mas "
6360 #~ "aguente aí, durante o próximo capítulo nós vamos dizer como você pode "
6361 #~ "preencher as páginas com vida."
6362
6363 #~ msgid "Documentation placement"
6364 #~ msgstr "Localização da documentação"
6365
6366 #~ msgid ""
6367 #~ "In the past most documentation had to be filled into files residing "
6368 #~ "inside the <filename>tmpl</filename> directory. This has the "
6369 #~ "disadvantages that the information is often not updated and also that the "
6370 #~ "file tend to cause conflicts with version control systems."
6371 #~ msgstr ""
6372 #~ "Antigamente, a maioria das documentações tinha que ser preenchida em "
6373 #~ "arquivos residentes dentro do diretório <filename>tmpl</filename>. Isso "
6374 #~ "tem as desvantagens das informações frequentemente não serem atualizadas "
6375 #~ "e também que o arquivo tende a causar conflitos com sistemas de controle "
6376 #~ "de versão."
6377
6378 #~ msgid ""
6379 #~ "The avoid the aforementioned problems we suggest putting the "
6380 #~ "documentation inside the sources. This manual will only describe this way "
6381 #~ "of documenting code."
6382 #~ msgstr ""
6383 #~ "Para evitar os problemas mencionados a seguir nós sugerimos que a "
6384 #~ "documentação seja colocada dentro das fontes. Este manual vai apenas "
6385 #~ "descrever esta forma de documentar código."
6386
6387 #~ msgid "<guilabel>Python</guilabel> - optional - for gtkdoc-depscan"
6388 #~ msgstr "<guilabel>Python</guilabel> - opcional - para gtkdoc-depscan"
6389
6390 #~ msgid ""
6391 #~ "<guilabel>Generating the \"template\" files.</guilabel> "
6392 #~ "<application>gtkdoc-mktmpl</application> creates a number of files in the "
6393 #~ "<filename class=\"directory\">tmpl/</filename> subdirectory, using the "
6394 #~ "information gathered in the first step. (Note that this can be run "
6395 #~ "repeatedly. It will try to ensure that no documentation is ever lost.)"
6396 #~ msgstr ""
6397 #~ "<guilabel>Gerando os arquivos \"template\".</guilabel> "
6398 #~ "<application>gtkdoc-mktmpl</application> cria uma quantidade de arquivos "
6399 #~ "no subdiretório <filename class=\"directory\">tmpl/</filename>, usando a "
6400 #~ "informação coletada na primeira etapa. (Note que ele pode ser executado "
6401 #~ "repetidas vezes e vai tentar garantir que nenhuma documentação será "
6402 #~ "perdida, jamais.)"
6403
6404 #~ msgid ""
6405 #~ "Since GTK-Doc 1.9 the templates can be avoided. We encourage people to "
6406 #~ "keep documentation in the code. <application>gtkdocize</application> "
6407 #~ "supports now a <option>--flavour no-tmpl</option> option that chooses a "
6408 #~ "makefile that skips tmpl usage totally. If you have never changed file in "
6409 #~ "tmpl by hand, please remove the directory (e.g. from version control "
6410 #~ "system)."
6411 #~ msgstr ""
6412 #~ "Desde o GTK-Doc 1.9, os modelos (\"templates\") podem ser evitados. Nós "
6413 #~ "encorajamos as pessoas a manter a documentação no código. "
6414 #~ "<application>gtkdocize</application> possui suporte a uma opção <option>--"
6415 #~ "flavour no-tmpl</option> que escolhe um makefile que ignora totalmente o "
6416 #~ "uso de tmpl. Se você nunca alterou o arquivo em tmpl manualmente, por "
6417 #~ "favor remova o diretório (ex.: do sistema de controle de versão)."
6418
6419 #~ msgid "1.20"
6420 #~ msgstr "1.20"
6421
6422 #~ msgid "(FIXME : Stability information)"
6423 #~ msgstr "(CORRIJA-ME : Informação sobre estabilidade)"
6424
6425 #~ msgid ""
6426 #~ "Also, take a look at GObject Introspection annotation tags: http://"
6427 #~ "live.gnome.org/GObjectIntrospection/Annotations"
6428 #~ msgstr ""
6429 #~ "Também, dê uma olhada nas tags de anotação do GObject Introspection: "
6430 #~ "http://live.gnome.org/GObjectIntrospection/Annotations"
6431
6432 #~ msgid "1.18.1"
6433 #~ msgstr "1.18.1"
6434
6435 #~ msgid ""
6436 #~ "<guilabel>DocBook DTD v3.0</guilabel> - This is the DocBook SGML DTD. "
6437 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://"
6438 #~ "www.ora.com/davenport</ulink>"
6439 #~ msgstr ""
6440 #~ "<guilabel>DocBook DTD v3.0</guilabel> - Este é o DocBook SGML DTD. <ulink "
6441 #~ "url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora.com/"
6442 #~ "davenport</ulink>"
6443
6444 #~ msgid ""
6445 #~ "<guilabel>Jade v1.1</guilabel> - This is a DSSSL processor for converting "
6446 #~ "SGML to various formats. <ulink url=\"http://www.jclark.com/jade\" "
6447 #~ "type=\"http\">http://www.jclark.com/jade</ulink>"
6448 #~ msgstr ""
6449 #~ "<guilabel>Jade v1.1</guilabel> - Este é um processador de DSSSL para "
6450 #~ "conversão de SGML para vários formatos. <ulink url=\"http://"
6451 #~ "www.jclark.com/jade\" type=\"http\">http://www.jclark.com/jade</ulink>"
6452
6453 #~ msgid ""
6454 #~ "<guilabel>Modular DocBook Stylesheets</guilabel> This is the DSSSL code "
6455 #~ "to convert DocBook to HTML (and a few other formats). It's used together "
6456 #~ "with jade. I've customized the DSSSL code slightly, in gtk-doc.dsl, to "
6457 #~ "colour the program code listings/declarations, and to support global "
6458 #~ "cross-reference indices in the generated HTML. <ulink url=\"http://"
6459 #~ "nwalsh.com/docbook/dsssl\" type=\"http\">http://nwalsh.com/docbook/dsssl</"
6460 #~ "ulink>"
6461 #~ msgstr ""
6462 #~ "<guilabel>Folhas de estilo modulares do DocBook</guilabel> Este é o "
6463 #~ "código DSSSL para converter DocBook para HTML (e alguns outros formatos). "
6464 #~ "É usado junto com jade. Eu personalizei um pouco o código DSSSL, em gtk-"
6465 #~ "doc.dsl, para colorir as listagens/declarações do código do programa e "
6466 #~ "para dar suporte a índices de referências cruzadas globais nos HTML "
6467 #~ "gerados. <ulink url=\"http://nwalsh.com/docbook/dsssl\" "
6468 #~ "type=\"http\">http://nwalsh.com/docbook/dsssl</ulink>"
6469
6470 #~ msgid ""
6471 #~ "<guilabel>docbook-to-man</guilabel> - if you want to create man pages "
6472 #~ "from the DocBook. I've customized the 'translation spec' slightly, to "
6473 #~ "capitalise section headings and add the 'GTK Library' title at the top of "
6474 #~ "the pages and the revision date at the bottom. There is a link to this on "
6475 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://"
6476 #~ "www.ora.com/davenport</ulink> NOTE: This does not work yet."
6477 #~ msgstr ""
6478 #~ "<guilabel>docbook-to-man</guilabel> - se você deseja criar páginas man a "
6479 #~ "partir do DocBook. Eu personalizei um pouco a \"especificação de "
6480 #~ "tradução\", para deixar o título em caixa alta e adicionar o título \"GTK "
6481 #~ "Library\" no topo das páginas e a data de revisão no canto inferior. Há "
6482 #~ "também um link para isso em <ulink url=\"http://www.ora.com/davenport\" "
6483 #~ "type=\"http\">http://www.ora.com/davenport</ulink>. NOTA: isso não "
6484 #~ "funciona ainda."
6485
6486 #~ msgid ""
6487 #~ "There is no standard place where the DocBook Modular Stylesheets are "
6488 #~ "installed."
6489 #~ msgstr ""
6490 #~ "Não há um lugar padrão onde as folhas de estilos modulares de DocBook são "
6491 #~ "instaladas."
6492
6493 #~ msgid ""
6494 #~ "GTK-Doc's configure script searches these 3 directories automatically:"
6495 #~ msgstr ""
6496 #~ "O script de configuração do GTK-DOC pesquisa por esses três diretórios "
6497 #~ "automaticamente:"
6498
6499 #~ msgid ""
6500 #~ "<filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (used by "
6501 #~ "RedHat)"
6502 #~ msgstr ""
6503 #~ "<filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (usado "
6504 #~ "pelo RedHat)"
6505
6506 #~ msgid ""
6507 #~ "<filename> /usr/lib/dsssl/stylesheets/docbook </filename> (used by Debian)"
6508 #~ msgstr ""
6509 #~ "<filename> /usr/lib/dsssl/stylesheets/docbook </filename> (usado pelo "
6510 #~ "Debian)"
6511
6512 #~ msgid "<filename> /usr/share/sgml/docbkdsl </filename> (used by SuSE)"
6513 #~ msgstr "<filename> /usr/share/sgml/docbkdsl </filename> (usado pelo SuSE)"
6514
6515 #~ msgid ""
6516 #~ "If you have the stylesheets installed somewhere else, you need to "
6517 #~ "configure GTK-Doc using the option: <command> --with-dsssl-"
6518 #~ "dir=&lt;PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>"
6519 #~ msgstr ""
6520 #~ "Se você tiver as folhas de estilos instaladas em algum lugar, você "
6521 #~ "precisa configurar o Gtk-Doc usando a opção: <command> --with-dsssl-"
6522 #~ "dir=&lt;CAMINHO_PARA_DIRETÓRIO_RAIZ_DAS_FOLHAS_DE_ESTILO&gt; </command>"
6523
6524 #~ msgid ""
6525 #~ "You may also want to enable GTK-Doc for the distcheck make target. Just "
6526 #~ "add the one line shown in the next example to your top-level "
6527 #~ "<filename>Makefile.am</filename>:"
6528 #~ msgstr ""
6529 #~ "Você pode querer habilitar o GTK-Doc para o distcheck make target. Basta "
6530 #~ "adicionar a linha mostrada no exemplo abaixo ao <filename>Makefile.am</"
6531 #~ "filename> do seu diretório raiz:"
6532
6533 #~ msgid "Enable GTK-Doc during make distcheck"
6534 #~ msgstr "Habilita GTK-Doc durante make distcheck"
6535
6536 #~ msgid ""
6537 #~ "\n"
6538 #~ "\n"
6539 #~ "DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc\n"
6540 #~ "\n"
6541 #~ " "
6542 #~ msgstr ""
6543 #~ "\n"
6544 #~ "\n"
6545 #~ "DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc\n"
6546 #~ "\n"
6547 #~ " "
6548
6549 #~ msgid ""
6550 #~ "\n"
6551 #~ "\n"
6552 #~ "/**\n"
6553 #~ " * identifier:\n"
6554 #~ " *\n"
6555 #~ " * documentation ...\n"
6556 #~ " *\n"
6557 #~ " * # Sub heading #\n"
6558 #~ " *\n"
6559 #~ " * more documentation:\n"
6560 #~ " * - list item 1\n"
6561 #~ " * - list item 2\n"
6562 #~ " *\n"
6563 #~ " * Even more docs.\n"
6564 #~ " */\n"
6565 #~ "\n"
6566 #~ " "
6567 #~ msgstr ""
6568 #~ "\n"
6569 #~ "\n"
6570 #~ "/**\n"
6571 #~ " * identificador:\n"
6572 #~ " *\n"
6573 #~ " * documentação ...\n"
6574 #~ " *\n"
6575 #~ " * # Subtítulo #\n"
6576 #~ " *\n"
6577 #~ " * mais documentação:\n"
6578 #~ " * - item de lista 1\n"
6579 #~ " * - item de lista 2\n"
6580 #~ " *\n"
6581 #~ " * Mais documentação.\n"
6582 #~ " */\n"
6583 #~ "\n"
6584 #~ " "
6585
6586 #~ msgid ""
6587 #~ "Since GTK-Doc-1.18 the tool supports a subset or the <ulink url=\"http://"
6588 #~ "daringfireball.net/projects/markdown/\">markdown language</ulink>. One "
6589 #~ "can use it for sub-headings and simple itemized lists. On older GTK-Doc "
6590 #~ "versions the content will be rendered as it (the list items will appear "
6591 #~ "in one line separated by dashes). <_:example-1/>"
6592 #~ msgstr ""
6593 #~ "Desde o GTK-Doc-1.18, a ferramenta tem suporte a um subconjunto ou a "
6594 #~ "<ulink url=\"http://daringfireball.net/projects/markdown/\">linguagem "
6595 #~ "markdown</ulink>. É possível usá-la em subtítulos e listas simples "
6596 #~ "itemizadas. Em versões mais antigas GTK-Doc, o conteúdo será processado "
6597 #~ "com está (os itens da lista vai aparecer em uma linha separada por "
6598 #~ "traços). <_:example-1/>"
6599
6600 #~ msgid "1.15"
6601 #~ msgstr "1.15"
6602
6603 #~ msgid "Chris"
6604 #~ msgstr "Chris"
6605
6606 #~ msgid "Lyttle"
6607 #~ msgstr "Lyttle"
6608
6609 #~ msgid "[email protected]"
6610 #~ msgstr "[email protected]"
6611
6612 #~ msgid "Dan"
6613 #~ msgstr "Dan"
6614
6615 #~ msgid "Mueth"
6616 #~ msgstr "Mueth"
6617
6618 #~ msgid "[email protected]"
6619 #~ msgstr "[email protected]"
6620
6621 #~ msgid "Stefan"
6622 #~ msgstr "Stefan"
6623
6624 #~ msgid "Kost"
6625 #~ msgstr "Kost"
6626
6627 #~ msgid "[email protected]"
6628 #~ msgstr "[email protected]"
6629
6630 #~ msgid "[email protected]"
6631 #~ msgstr "[email protected]"
6632
6633 #~ msgid "2000, 2005, 2007-2009"
6634 #~ msgstr "2000, 2005, 2007-2009"
6635
6636 #~ msgid "Dan Mueth and Chris Lyttle and Stefan Kost"
6637 #~ msgstr "Dan Mueth e Chris Lyttle e Stefan Kost"
6638
6639 #~ msgid "development version"
6640 #~ msgstr "versão de desenvolvimento"
6641
6642 #~ msgid "bug and regression fixes"
6643 #~ msgstr "correções de falhas e regressão"
6644
6645 #~ msgid "bugfixes and performance improvements"
6646 #~ msgstr "correção de falhas e melhoramento de performance"
6647
6648 #~ msgid "broken tarball update"
6649 #~ msgstr "atualização de arquivo tarball quebrado"
6650
6651 #~ msgid "new tool features and bugfixes"
6652 #~ msgstr "novas funcionalidades da ferramenta e correções de falhas"
6653
6654 #~ msgid "GNOME doc-utils migration"
6655 #~ msgstr "migração do GNOME doc-utils"
6656
6657 #~ msgid "explanation"
6658 #~ msgstr "explicação"
6659
6660 #~ msgid ""
6661 #~ "Missing or wrong naming in <placeholder-1/> file (see <placeholder-2/>)."
6662 #~ msgstr " "