Debian Codegraph @

help/manual/zh_CN/zh_CN.po

raw
1 # Chinese (China) translation for gtk-doc.
2 # Copyright (C) 2011 gtk-doc's COPYRIGHT HOLDER
3 # This file is distributed under the same license as the gtk-doc package.
4 # LuYanbo <[email protected]>, 2011.
5 # 黄世海 <[email protected]>, 2012.
6 # Wylmer Wang <[email protected]>, 2012.
7 #
8 msgid ""
9 msgstr ""
10 "Project-Id-Version: gtk-doc master\n"
11 "POT-Creation-Date: 2020-10-01 20:17+0000\n"
12 "PO-Revision-Date: 2022-03-16 08:00-0400\n"
13 "Last-Translator: Wylmer Wang <[email protected]>\n"
14 "Language-Team: Chinese (China) <[email protected]>\n"
15 "Language: zh_CN\n"
16 "MIME-Version: 1.0\n"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
19 "X-Poedit-Bookmarks: 236,211,220,228,94,235,-1,-1,-1,-1\n"
20 "X-Generator: Poedit 2.4.3\n"
21 "X-Poedit-SourceCharset: utf-8\n"
22
23 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
24 msgctxt "_"
25 msgid "translator-credits"
26 msgstr ""
27 "LuYanbo <[email protected]>, 2011\n"
28 "黄世海 <[email protected]>, 2012\n"
29 "Wylmer Wang <[email protected]>, 2012"
30
31 #. (itstool) path: bookinfo/title
32 #: C/index.docbook:12
33 msgid "GTK-Doc Manual"
34 msgstr "GTK-Doc 手册"
35
36 #. (itstool) path: bookinfo/edition
37 #: C/index.docbook:13
38 msgid "1.24.1"
39 msgstr "1.24.1"
40
41 #. (itstool) path: abstract/para
42 #: C/index.docbook:14
43 msgid "User manual for developers with instructions of GTK-Doc usage."
44 msgstr "为开发人员提供 GTK-Doc 用法说明的用户手册。"
45
46 #. (itstool) path: authorgroup/author
47 #: C/index.docbook:16
48 msgid ""
49 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
50 "<address> <email>[email protected]</email> </address> </affiliation>"
51 msgstr ""
52 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
53 "<address> <email>[email protected]</email> </address> </affiliation>"
54
55 #. (itstool) path: authorgroup/author
56 #: C/index.docbook:25
57 msgid ""
58 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
59 "<email>[email protected]</email> </address> </affiliation>"
60 msgstr ""
61 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
62 "<email>[email protected]</email> </address> </affiliation>"
63
64 #. (itstool) path: authorgroup/author
65 #: C/index.docbook:34
66 msgid ""
67 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
68 "<address> <email>[email protected]</email> </address> </affiliation>"
69 msgstr ""
70 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
71 "<address> <email>[email protected]</email> </address> </affiliation>"
72
73 #. (itstool) path: publisher/publishername
74 #: C/index.docbook:45
75 msgid "GTK-Doc project"
76 msgstr "GTK-Doc 项目"
77
78 #. (itstool) path: bookinfo/publisher
79 #: C/index.docbook:44
80 msgid ""
81 "<_:publishername-1/> <address><email>[email protected]</email></address>"
82 msgstr ""
83 "<_:publishername-1/> <address><email>[email protected]</email></address>"
84
85 #. (itstool) path: bookinfo/copyright
86 #: C/index.docbook:48
87 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
88 msgstr "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
89
90 #. (itstool) path: bookinfo/copyright
91 #: C/index.docbook:52
92 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
93 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
94
95 #. (itstool) path: legalnotice/para
96 #: C/index.docbook:65
97 msgid ""
98 "Permission is granted to copy, distribute and/or modify this document under "
99 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
100 "Version 1.1 or any later version published by the Free Software Foundation "
101 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
102 "copy of the license is <link linkend=\"fdl\">included</link>."
103 msgstr ""
104 "允许在<citetitle>GNU 自由文档认证书</citetitle>的规范下复制,发布或者/并且修"
105 "改本文档,由自由软件基金会出版的1.1版或更新版本的无变更的部分,无封面文本,以"
106 "及无背面文本。取得证书的制件<link linkend=\"fdl\">included</link>."
107
108 #. (itstool) path: legalnotice/para
109 #: C/index.docbook:73
110 msgid ""
111 "Many of the names used by companies to distinguish their products and "
112 "services are claimed as trademarks. Where those names appear in any GNOME "
113 "documentation, and those trademarks are made aware to the members of the "
114 "GNOME Documentation Project, the names have been printed in caps or initial "
115 "caps."
116 msgstr ""
117 "公司使用的区别于它们的许多产品及服务的名字就称为商标. 这些名字出现在任何GNOME"
118 "文档中, 而且那些商标会提示GNOME文档项目成员, 那些名字会打印在封面或初始页面"
119 "中."
120
121 #. (itstool) path: revhistory/revision
122 #: C/index.docbook:83
123 msgid ""
124 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
125 "authorinitials> <revremark>gtk4 version</revremark>"
126 msgstr ""
127 "<revnumber>1.33.0</revnumber> <date>2020年10月1日</date> <authorinitials>mc</"
128 "authorinitials> <revremark>gtk4 版本</revremark>"
129
130 #. (itstool) path: revhistory/revision
131 #: C/index.docbook:89
132 #, fuzzy
133 #| msgid ""
134 #| "<revnumber>1.18.1</revnumber> <date>20 Sep 2011</date> "
135 #| "<authorinitials>ss</authorinitials> <revremark>development version</"
136 #| "revremark>"
137 msgid ""
138 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
139 "authorinitials> <revremark>dev version</revremark>"
140 msgstr ""
141 "<revnumber>1.18.1</revnumber> <date>2011年9月20</date> <authorinitials>ss</"
142 "authorinitials> <revremark>开发版本</revremark>"
143
144 #. (itstool) path: revhistory/revision
145 #: C/index.docbook:95
146 #, fuzzy
147 #| msgid ""
148 #| "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
149 #| "authorinitials> <revremark>urgent bug fix update</revremark>"
150 msgid ""
151 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
152 "authorinitials> <revremark>hotfix release</revremark>"
153 msgstr ""
154 "<revnumber>1.17</revnumber> <date>2011年2月26</date> <authorinitials>sk</"
155 "authorinitials> <revremark>紧急问题修复更新</revremark>"
156
157 #. (itstool) path: revhistory/revision
158 #: C/index.docbook:101
159 #, fuzzy
160 #| msgid ""
161 #| "<revnumber>1.18.1</revnumber> <date>20 Sep 2011</date> "
162 #| "<authorinitials>ss</authorinitials> <revremark>development version</"
163 #| "revremark>"
164 msgid ""
165 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
166 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
167 msgstr ""
168 "<revnumber>1.18.1</revnumber> <date>2011年9月20</date> <authorinitials>ss</"
169 "authorinitials> <revremark>开发版本</revremark>"
170
171 #. (itstool) path: revhistory/revision
172 #: C/index.docbook:107
173 #, fuzzy
174 #| msgid ""
175 #| "<revnumber>1.18.1</revnumber> <date>20 Sep 2011</date> "
176 #| "<authorinitials>ss</authorinitials> <revremark>development version</"
177 #| "revremark>"
178 msgid ""
179 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
180 "authorinitials> <revremark>more test coverage</revremark>"
181 msgstr ""
182 "<revnumber>1.18.1</revnumber> <date>2011年9月20</date> <authorinitials>ss</"
183 "authorinitials> <revremark>开发版本</revremark>"
184
185 #. (itstool) path: revhistory/revision
186 #: C/index.docbook:113
187 #, fuzzy
188 #| msgid ""
189 #| "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
190 #| "authorinitials> <revremark>urgent bug fix update</revremark>"
191 msgid ""
192 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
193 "authorinitials> <revremark>bug fixes</revremark>"
194 msgstr ""
195 "<revnumber>1.17</revnumber> <date>2011年2月26</date> <authorinitials>sk</"
196 "authorinitials> <revremark>紧急问题修复更新</revremark>"
197
198 #. (itstool) path: revhistory/revision
199 #: C/index.docbook:119
200 #, fuzzy
201 #| msgid ""
202 #| "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
203 #| "authorinitials> <revremark>bug and regression fixes</revremark>"
204 msgid ""
205 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
206 "authorinitials> <revremark>bug fixes</revremark>"
207 msgstr ""
208 "<revnumber>1.15</revnumber> <date>2010年5月21</date> <authorinitials>sk</"
209 "authorinitials> <revremark>问题和退化修复</revremark>"
210
211 #. (itstool) path: revhistory/revision
212 #: C/index.docbook:125
213 #, fuzzy
214 #| msgid ""
215 #| "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
216 #| "authorinitials> <revremark>urgent bug fix update</revremark>"
217 msgid ""
218 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
219 "authorinitials> <revremark>fine tuning of the python port</revremark>"
220 msgstr ""
221 "<revnumber>1.17</revnumber> <date>2011年2月26</date> <authorinitials>sk</"
222 "authorinitials> <revremark>紧急问题修复更新</revremark>"
223
224 #. (itstool) path: revhistory/revision
225 #: C/index.docbook:131
226 #, fuzzy
227 #| msgid ""
228 #| "<revnumber>1.18.1</revnumber> <date>20 Sep 2011</date> "
229 #| "<authorinitials>ss</authorinitials> <revremark>development version</"
230 #| "revremark>"
231 msgid ""
232 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
233 "authorinitials> <revremark>port all tools from perl/bash to python</"
234 "revremark>"
235 msgstr ""
236 "<revnumber>1.18.1</revnumber> <date>2011年9月20</date> <authorinitials>ss</"
237 "authorinitials> <revremark>开发版本</revremark>"
238
239 #. (itstool) path: revhistory/revision
240 #: C/index.docbook:137
241 #, fuzzy
242 #| msgid ""
243 #| "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
244 #| "authorinitials> <revremark>bug and regression fixes</revremark>"
245 msgid ""
246 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
247 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
248 msgstr ""
249 "<revnumber>1.15</revnumber> <date>2010年5月21</date> <authorinitials>sk</"
250 "authorinitials> <revremark>问题和退化修复</revremark>"
251
252 #. (itstool) path: revhistory/revision
253 #: C/index.docbook:143
254 #, fuzzy
255 #| msgid ""
256 #| "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
257 #| "authorinitials> <revremark>bug and regression fixes</revremark>"
258 msgid ""
259 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
260 "authorinitials> <revremark>bug fix</revremark>"
261 msgstr ""
262 "<revnumber>1.15</revnumber> <date>2010年5月21</date> <authorinitials>sk</"
263 "authorinitials> <revremark>问题和退化修复</revremark>"
264
265 #. (itstool) path: revhistory/revision
266 #: C/index.docbook:149
267 #, fuzzy
268 #| msgid ""
269 #| "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
270 #| "authorinitials> <revremark>bug and regression fixes</revremark>"
271 msgid ""
272 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
273 "authorinitials> <revremark>bug fix</revremark>"
274 msgstr ""
275 "<revnumber>1.15</revnumber> <date>2010年5月21</date> <authorinitials>sk</"
276 "authorinitials> <revremark>问题和退化修复</revremark>"
277
278 #. (itstool) path: revhistory/revision
279 #: C/index.docbook:155
280 #, fuzzy
281 #| msgid ""
282 #| "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
283 #| "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
284 msgid ""
285 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
286 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
287 "revremark>"
288 msgstr ""
289 "<revnumber>1.16</revnumber> <date>2011年1月14</date> <authorinitials>sk</"
290 "authorinitials> <revremark>修复问题,布局改进</revremark>"
291
292 #. (itstool) path: revhistory/revision
293 #: C/index.docbook:161
294 #, fuzzy
295 #| msgid ""
296 #| "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
297 #| "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
298 msgid ""
299 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
300 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
301 "revremark>"
302 msgstr ""
303 "<revnumber>1.16</revnumber> <date>2011年1月14</date> <authorinitials>sk</"
304 "authorinitials> <revremark>修复问题,布局改进</revremark>"
305
306 #. (itstool) path: revhistory/revision
307 #: C/index.docbook:167
308 #, fuzzy
309 #| msgid ""
310 #| "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
311 #| "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
312 msgid ""
313 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
314 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
315 "revremark>"
316 msgstr ""
317 "<revnumber>1.16</revnumber> <date>2011年1月14</date> <authorinitials>sk</"
318 "authorinitials> <revremark>修复问题,布局改进</revremark>"
319
320 #. (itstool) path: revhistory/revision
321 #: C/index.docbook:173
322 #, fuzzy
323 #| msgid ""
324 #| "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
325 #| "authorinitials> <revremark>urgent bug fix update</revremark>"
326 msgid ""
327 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
328 "authorinitials> <revremark>bug fixes</revremark>"
329 msgstr ""
330 "<revnumber>1.17</revnumber> <date>2011年2月26</date> <authorinitials>sk</"
331 "authorinitials> <revremark>紧急问题修复更新</revremark>"
332
333 #. (itstool) path: revhistory/revision
334 #: C/index.docbook:179
335 #, fuzzy
336 #| msgid ""
337 #| "<revnumber>1.18</revnumber> <date>14 sep 2011</date> <authorinitials>ss</"
338 #| "authorinitials> <revremark>bug fixes, speedups, markdown support</"
339 #| "revremark>"
340 msgid ""
341 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
342 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
343 msgstr ""
344 "<revnumber>1.18</revnumber> <date>2011年9月14</date> <authorinitials>ss</"
345 "authorinitials> <revremark>修复问题,速度优化、markdown 支持</revremark>"
346
347 #. (itstool) path: revhistory/revision
348 #: C/index.docbook:185
349 msgid ""
350 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
351 "authorinitials> <revremark>urgent bug fix update</revremark>"
352 msgstr ""
353 "<revnumber>1.17</revnumber> <date>2011年2月26日</date> <authorinitials>sk</"
354 "authorinitials> <revremark>紧急问题修复更新</revremark>"
355
356 #. (itstool) path: revhistory/revision
357 #: C/index.docbook:191
358 msgid ""
359 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
360 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
361 msgstr ""
362 "<revnumber>1.16</revnumber> <date>2011年1月14日</date> <authorinitials>sk</"
363 "authorinitials> <revremark>修复问题,布局改进</revremark>"
364
365 #. (itstool) path: revhistory/revision
366 #: C/index.docbook:197
367 msgid ""
368 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
369 "authorinitials> <revremark>bug and regression fixes</revremark>"
370 msgstr ""
371 "<revnumber>1.15</revnumber> <date>2010年5月21日</date> <authorinitials>sk</"
372 "authorinitials> <revremark>问题和退化修复</revremark>"
373
374 #. (itstool) path: revhistory/revision
375 #: C/index.docbook:203
376 msgid ""
377 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
378 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
379 msgstr ""
380 "<revnumber>1.14</revnumber> <date>2010年3月28日</date> <authorinitials>sk</"
381 "authorinitials> <revremark>问题修复和性能提高</revremark>"
382
383 #. (itstool) path: revhistory/revision
384 #: C/index.docbook:209
385 msgid ""
386 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
387 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
388 "revremark>"
389 msgstr ""
390 "<revnumber>1.13</revnumber> <date>2009年12月18日</date> <authorinitials>sk</"
391 "authorinitials> <revremark>损坏的档案包更新</revremark>"
392
393 #. (itstool) path: revhistory/revision
394 #: C/index.docbook:215
395 msgid ""
396 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
397 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
398 "bugfixes</revremark>"
399 msgstr ""
400 "<revnumber>1.12</revnumber> <date>2009年12月18日</date> <authorinitials>sk</"
401 "authorinitials> <revremark>新工具功能和问题修复</revremark>"
402
403 #. (itstool) path: revhistory/revision
404 #: C/index.docbook:221
405 msgid ""
406 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
407 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
408 "revremark>"
409 msgstr ""
410 "<revnumber>1.11</revnumber> <date>2008年11月16日</date> <authorinitials>mal</"
411 "authorinitials> <revremark>GNOME doc-utils 迁移</revremark>"
412
413 #. (itstool) path: chapter/title
414 #: C/index.docbook:234
415 msgid "Introduction"
416 msgstr "介绍"
417
418 #. (itstool) path: chapter/para
419 #: C/index.docbook:236
420 msgid ""
421 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
422 "it is used."
423 msgstr "本章介绍 GTK-Doc,并概述了它是什么以及如何使用它。"
424
425 #. (itstool) path: sect1/title
426 #: C/index.docbook:242
427 msgid "What is GTK-Doc?"
428 msgstr "什么是 GTK-Doc?"
429
430 #. (itstool) path: sect1/para
431 #: C/index.docbook:244
432 msgid ""
433 "GTK-Doc is used to document C code. It is typically used to document the "
434 "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
435 "also be used to document application code."
436 msgstr ""
437 "GTK-Doc 用于为C代码编写文档。典型地用于编写库的公共API,如GTK+与GNOME库。不过"
438 "它也可以用于书写应用程序代码文档。"
439
440 #. (itstool) path: sect1/title
441 #: C/index.docbook:252
442 msgid "How Does GTK-Doc Work?"
443 msgstr "GTK Doc 是怎样工作的?"
444
445 #. (itstool) path: sect1/para
446 #: C/index.docbook:254
447 #, fuzzy
448 msgid ""
449 "GTK-Doc works by using documentation of functions placed inside the source "
450 "files in specially-formatted comment blocks, or documentation added to the "
451 "template files which GTK-Doc uses (though note that GTK-Doc will only "
452 "document functions that are declared in header files; it won't produce "
453 "output for static functions)."
454 msgstr ""
455 "GTK-Doc通过使用放置于源文件内特殊格式的注释块的函数文档工作,或者添加在GTK-"
456 "Doc使用的模板文件中。"
457
458 #. (itstool) path: sect1/para
459 #: C/index.docbook:261
460 msgid ""
461 "GTK-Doc consists of a number of python scripts, each performing a different "
462 "step in the process."
463 msgstr "GTK-Doc 由一些 python 脚本组成,每个脚本完成这一过程中不同的步骤。"
464
465 #. (itstool) path: sect1/para
466 #: C/index.docbook:266
467 msgid "There are 5 main steps in the process:"
468 msgstr "这个进程有五个主要步骤:"
469
470 #. (itstool) path: listitem/para
471 #: C/index.docbook:273
472 #, fuzzy
473 msgid ""
474 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
475 "source files with the documentation for each function, macro, structs or "
476 "unions, etc."
477 msgstr ""
478 "<guilabel>书写文档。</guilabel>作者在源文件中为每个函数,宏,联合体等对象书写"
479 "了文档(在以往的消息里它进入到已完成的模板文件中,现已经不再介绍了)。"
480
481 #. (itstool) path: listitem/para
482 #: C/index.docbook:282
483 #, fuzzy
484 msgid ""
485 "<guilabel>Gathering information about the code.</guilabel> "
486 "<application>gtkdoc-scan</application> scans the header files of the code "
487 "looking for declarations of functions, macros, enums, structs, and unions. "
488 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
489 "containing a list of the declarations, placing them into sections according "
490 "to which header file they are in. On the first run this file is copied to "
491 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
492 "the sections, and the order of the declarations within them, to produce the "
493 "final desired order. The second file it generates is <filename>&lt;"
494 "module&gt;-decl.txt</filename>. This file contains the full declarations "
495 "found by the scanner. If for some reason one would like some symbols to show "
496 "up in the docs, where the full declaration cannot be found by the scanner or "
497 "the declaration should appear differently, one can place entities similar to "
498 "the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;"
499 "module&gt;-overrides.txt</filename>."
500 msgstr ""
501 "<guilabel>收集关于源代码的信息.</guilabel><application>gtkdoc-扫描</"
502 "application>扫描代码的头文件寻找函数,宏,枚举,结构与联合体的声明。它创建包"
503 "含一系列声明的文件:<filename>&lt;module&gt;-decl-list.txt</filename>,并按照"
504 "它们所在的头文件把它们放入特定的部分中。在第一次运行时这个文件会复制到"
505 "<filename>&lt;module&gt;-sections.txt</filename>中。作者可以重新安排这些部分"
506 "及在它们当中的声明顺序,以便产生最后所需的顺序。它产生的第二个文件是:"
507 "<filename>&lt;module&gt;-decl.txt</filename>。这个文件包含了扫描器找到的全声"
508 "明。如果基于某种原因你需要在文档中显示出一些符号,扫描器无法在全声明中找到或"
509 "者声明会呈现出不同的形态,你可以把相似的实体<filename>&lt:module&gt;-decl."
510 "txt</filename>放入<filename>&lt;module&gt;-overrides.txt</filename>中去。"
511
512 #. (itstool) path: listitem/para
513 #: C/index.docbook:299
514 #, fuzzy
515 msgid ""
516 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
517 "query a library about any GObject subclasses it exports. It saves "
518 "information about each object's position in the class hierarchy and about "
519 "any GObject properties and signals it provides."
520 msgstr ""
521 "<application>gtkdoc-scangobj</application>也可以用于动态查询关于任何它导出的"
522 "GObject子类的一个库。它保存在关于每个对象在继承关系以及它所提供关于任何"
523 "GObject属性与信号的位置。"
524
525 #. (itstool) path: listitem/para
526 #: C/index.docbook:305
527 #, fuzzy
528 msgid ""
529 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
530 "needed in the past when GObject was still GtkObject inside gtk+."
531 msgstr ""
532 "<application>gtkdoc-scanobj</application>可能不再使用了。它在过去GObject仍就"
533 "是gtk+中的GtkObject的时候是需要的。"
534
535 #. (itstool) path: listitem/para
536 #: C/index.docbook:312
537 #, fuzzy
538 msgid ""
539 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
540 "mkdb</application> turns the template files into XML files in the <filename "
541 "class=\"directory\">xml/</filename> subdirectory. If the source code "
542 "contains documentation on functions, using the special comment blocks, it "
543 "gets merged in here. If there are no tmpl files used it only reads docs from "
544 "sources and introspection data."
545 msgstr ""
546 "<guilabel>生成 SGML/XML and HTML/PDF文件.</guilabel><application>gtkdoc-"
547 "mkdb</application>把<filename class=\"directory\">sgml/</filename> or "
548 "<filename class=\"directory\">xml/</filename>子目录中的模板文件转换为 SGML "
549 "或 XML格式的文件。如果源代码中包含了用特殊的注释块书写的函数文档,它会在此合"
550 "并。如果没有使用tmpl文件,它只从数据源与自检数据中读出文档。我们建议您使用"
551 "Docbook XML。"
552
553 #. (itstool) path: listitem/para
554 #: C/index.docbook:321
555 #, fuzzy
556 msgid ""
557 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
558 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
559 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
560 "document called <filename>&lt;package&gt;.pdf</filename>."
561 msgstr ""
562 "<application>gtkdoc-mkhtml</application> 把<filename class=\"directory"
563 "\">html/</filename> 子目录中的SGML/XML文件转换为HTML文件。就如同"
564 "application>gtkdoc-mkpdf</application>把SGML/XML文件转换为称为<filename>&lt;"
565 "package&gt;.pdf</filename>的PDF文档一样。"
566
567 #. (itstool) path: listitem/para
568 #: C/index.docbook:327
569 #, fuzzy
570 msgid ""
571 "Files in <filename class=\"directory\">xml/</filename> and <filename class="
572 "\"directory\">html/</filename> directories are always overwritten. One "
573 "should never edit them directly."
574 msgstr ""
575 "在<filename class=\"directory\">sgml/</filename>或者 <filename class="
576 "\"directory\">xml/</filename> 与 <filename class=\"directory\">html/</"
577 "filename>目录中的文件常常被覆盖。任何人都不能直接编辑它们。"
578
579 #. (itstool) path: listitem/para
580 #: C/index.docbook:335
581 #, fuzzy
582 msgid ""
583 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
584 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
585 "run to fix up any cross-references between separate documents. For example, "
586 "the GTK+ documentation contains many cross-references to types documented in "
587 "the GLib manual. When creating the source tarball for distribution, "
588 "<application>gtkdoc-rebase</application> turns all external links into web-"
589 "links. When installing distributed (pregenerated) docs the same application "
590 "will try to turn links back to local links (where those docs are installed)."
591 msgstr ""
592 "<guilabel>Fixing up cross-references between documents.</guilabel> ,在安装"
593 "HTML文件时,<application>gtkdoc-fixxref</application>能够用于修复任何独立文档"
594 "之间的交叉链接。例如:GTK+文档包含了许多交叉链接来显示GLib手册中的文档。在为"
595 "发行软件创建tarball源时,<application>gtkdoc-rebase</application>会把所有的外"
596 "部链接转换为网页链接。在安装发行文档(事先生成的)时,应用程序会试着把这些链"
597 "接换回到本地链接(在那些文档安装的地方)。"
598
599 #. (itstool) path: sect1/title
600 #: C/index.docbook:353
601 msgid "Getting GTK-Doc"
602 msgstr "获取 GTK-Doc"
603
604 #. (itstool) path: sect2/title
605 #: C/index.docbook:356
606 msgid "Requirements"
607 msgstr "要求"
608
609 #. (itstool) path: sect2/para
610 #: C/index.docbook:357
611 msgid ""
612 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
613 msgstr "<guilabel>python 2/3</guilabel> - 主脚本使用 python 编写。"
614
615 #. (itstool) path: sect2/para
616 #: C/index.docbook:360
617 msgid ""
618 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="
619 "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
620 msgstr ""
621
622 #. (itstool) path: sect2/para
623 #: C/index.docbook:364
624 msgid ""
625 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url="
626 "\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http"
627 "\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
628 msgstr ""
629
630 #. (itstool) path: sect2/para
631 #: C/index.docbook:368
632 msgid ""
633 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
634 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
635 "examples"
636 msgstr ""
637
638 #. (itstool) path: sect1/title
639 #: C/index.docbook:376
640 msgid "About GTK-Doc"
641 msgstr "关于 GTK-Doc"
642
643 #. (itstool) path: sect1/para
644 #: C/index.docbook:378
645 msgid ""
646 "Historically GTK-Doc was used to generate template files from the sources "
647 "code. These template files could be used by developers to enter the API "
648 "documentation. This approach was rather inconvenient because it required to "
649 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
650 "possible to place all API information into source comments, which made the "
651 "template support obsolete. In version 1.26 template support has been removed."
652 msgstr ""
653
654 #. (itstool) path: sect1/para
655 #: C/index.docbook:388 C/index.docbook:402
656 msgid "(FIXME)"
657 msgstr "(FIXME)"
658
659 #. (itstool) path: sect1/para
660 #: C/index.docbook:392
661 #, fuzzy
662 msgid ""
663 "(authors, web pages, mailing list, license, future plans, comparison with "
664 "other similar systems.)"
665 msgstr "(历史, 作者, 网页, 认证, 未来计划, 与其它相似系统的比较.)"
666
667 #. (itstool) path: sect1/title
668 #: C/index.docbook:400
669 msgid "About this Manual"
670 msgstr "关于此手册"
671
672 #. (itstool) path: sect1/para
673 #: C/index.docbook:406
674 msgid "(who it is meant for, where you can get it, license)"
675 msgstr "(它意味着什么,你可以从哪里获得它, 许可证)"
676
677 #. (itstool) path: chapter/title
678 #: C/index.docbook:415
679 msgid "Project Setup"
680 msgstr ""
681
682 #. (itstool) path: chapter/para
683 #: C/index.docbook:417
684 msgid ""
685 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
686 "into your project. The integration of GTK-Doc into a project includes the "
687 "following steps:"
688 msgstr ""
689
690 #. (itstool) path: listitem/para
691 #: C/index.docbook:425
692 msgid ""
693 "Preparation of the directory structure and creating required configuration "
694 "files for your GTK-Doc documentation (see <link linkend=\"settingup_docfiles"
695 "\"> Setting up a skeleton documentation</link>)."
696 msgstr ""
697
698 #. (itstool) path: listitem/para
699 #: C/index.docbook:433
700 msgid ""
701 "Adjusting the build system to build your documentation using the GTK-Doc "
702 "tools. Multiple build systems are supported, in this manual we describe how "
703 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
704 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link linkend="
705 "\"settingup_plain_makefiles\">plain Makefiles</link>."
706 msgstr ""
707
708 #. (itstool) path: listitem/para
709 #: C/index.docbook:443
710 msgid ""
711 "Adding GTK-Doc specific files to version control and deciding which files to "
712 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
713 "control systems</link>)."
714 msgstr ""
715
716 #. (itstool) path: chapter/para
717 #: C/index.docbook:451
718 msgid ""
719 "The following sections assume we work on a project called <code>meep</code>. "
720 "This project contains two packages (or modules), a library called "
721 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
722 msgstr ""
723
724 #. (itstool) path: sect1/title
725 #: C/index.docbook:460
726 msgid "Setting up a skeleton documentation"
727 msgstr "设置一个框架文档"
728
729 #. (itstool) path: sect1/para
730 #: C/index.docbook:462
731 msgid ""
732 "A common convention is to place documentation into a folder called "
733 "<code>docs</code> inside your top-level project directory. We usually "
734 "distinguish between <emphasis>reference documentation</emphasis> intended "
735 "for developers and an <emphasis>user manual</emphasis> intended for end-"
736 "users. Again the convention is to have separate folders for both. We usually "
737 "place the reference documentation in a folder named <code>reference</code> "
738 "and the end-user manual in a folder named <code>help</code> as. According to "
739 "the above convention the documentation for our <code>libmeep</code> package "
740 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
741 "just one library or application the documentation could also be placed "
742 "directly into <code>docs/reference</code>. It is not mandatory to use the "
743 "above convention, but if you choose to use a different directory structure "
744 "you must adjust your build system configuration to match your directory "
745 "structure."
746 msgstr ""
747
748 #. (itstool) path: example/title
749 #: C/index.docbook:493
750 msgid "Example directory structure of <emphasis>meep</emphasis> project"
751 msgstr ""
752
753 #. (itstool) path: example/programlisting
754 #: C/index.docbook:495
755 #, fuzzy, no-wrap
756 #| msgid ""
757 #| "\n"
758 #| "\n"
759 #| "meep/\n"
760 #| " docs/\n"
761 #| " reference/\n"
762 #| " libmeep/\n"
763 #| " meeper/\n"
764 #| " src/\n"
765 #| " libmeep/\n"
766 #| " meeper/\n"
767 #| "\n"
768 #| " "
769 msgid ""
770 "\n"
771 "meep/\n"
772 " docs/\n"
773 " reference/ # reference documentation\n"
774 " libmeep/\n"
775 " meeper/\n"
776 " help/ # optional: user manual\n"
777 " meeper/\n"
778 " src/\n"
779 " libmeep/\n"
780 " meeper/\n"
781 msgstr ""
782 "\n"
783 "\n"
784 "meep/\n"
785 " docs/\n"
786 " reference/\n"
787 " libmeep/\n"
788 " meeper/\n"
789 " src/\n"
790 " libmeep/\n"
791 " meeper/\n"
792 "\n"
793 " "
794
795 #. (itstool) path: sect1/para
796 #: C/index.docbook:487
797 msgid ""
798 "In the following sections we will assume a directory structure for our "
799 "<emphasis>meep</emphasis> project that uses the above conventions. <_:"
800 "example-1/>"
801 msgstr ""
802
803 #. (itstool) path: sect1/title
804 #: C/index.docbook:512
805 msgid "Integration with Autotools"
806 msgstr "与 Autotools 集成"
807
808 #. (itstool) path: sect1/para
809 #: C/index.docbook:513
810 msgid ""
811 "Integration of GTK-Doc into an autotools-based build system requires the "
812 "following steps:"
813 msgstr ""
814
815 #. (itstool) path: listitem/para
816 #: C/index.docbook:519
817 msgid ""
818 "Ensure that <application>gtkdocize</application> is run once before the "
819 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
820 "script is present, adjust it to check for GTK-Doc and add a call to "
821 "<application>gtkdocize</application>."
822 msgstr ""
823
824 #. (itstool) path: listitem/para
825 #: C/index.docbook:527
826 msgid ""
827 "The main purpose of <application>gtkdocize</application> is to make the "
828 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
829 "filename> macro definition file available to the build system, either by "
830 "copying or linking it into the project."
831 msgstr ""
832
833 #. (itstool) path: listitem/para
834 #: C/index.docbook:536
835 msgid ""
836 "Add the necessary <application>autoconf</application> macros to "
837 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
838 "allow configuration of GTK-Doc via the generated <filename>configure</"
839 "filename> script."
840 msgstr ""
841
842 #. (itstool) path: listitem/para
843 #: C/index.docbook:542
844 msgid ""
845 "Among others with registers the <code>--enable-gtk-doc</code> option with "
846 "the <filename>configure</filename> script."
847 msgstr ""
848
849 #. (itstool) path: listitem/para
850 #: C/index.docbook:548
851 msgid ""
852 "Create an <application>automake</application> script for each application or "
853 "library in your project. In the example used in this documentation this step "
854 "applies to both <code>meeper</code> and <code>libmeep</code>."
855 msgstr ""
856
857 #. (itstool) path: sect1/para
858 #: C/index.docbook:557
859 msgid ""
860 "In the following sections, we will perform the above steps in reverse order. "
861 "We start with the <application>automake</application> scripts and work our "
862 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
863 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
864 "build the documentation."
865 msgstr ""
866
867 #. (itstool) path: sect2/title
868 #: C/index.docbook:567
869 msgid "Integration with automake"
870 msgstr "与 automake 集成"
871
872 #. (itstool) path: sect2/para
873 #: C/index.docbook:569
874 #, fuzzy
875 msgid ""
876 "First copy the <filename>Makefile.am</filename> from the <filename class="
877 "\"directory\">examples</filename> sub-directory of the <ulink url=\"https://"
878 "gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-"
879 "sources</ulink> to your project's reference documentation directory (e.g. "
880 "<filename class=\"directory\">docs/reference/&lt;package&gt;</filename>). A "
881 "local copy should be available under e.g. <filename>/usr/share/doc/gtk-doc-"
882 "tools/examples/Makefile.am</filename>. If you have multiple packages repeat "
883 "this for each one."
884 msgstr ""
885 "首先从gtkdoc-sources的示例子目录及你项目的 API文档目录中复制"
886 "<filename>Makefile.am</filename> ( <filename class=\"directory\">./docs/"
887 "reference/&lt;package&gt;</filename>).如果你的每个目录都有多份doc-packages复"
888 "件的话。"
889
890 #. (itstool) path: note/simpara
891 #: C/index.docbook:582
892 msgid ""
893 "Do not forget to add each <filename>Makefile.am</filename> to the "
894 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
895 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
896 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
897 "filename> to <function>AC_CONFIG_FILES</function>."
898 msgstr ""
899
900 #. (itstool) path: example/title
901 #: C/index.docbook:594
902 msgid "Example directory structure with <filename>Makefiles.am</filename>"
903 msgstr ""
904
905 #. (itstool) path: example/programlisting
906 #: C/index.docbook:597
907 #, no-wrap
908 msgid ""
909 "\n"
910 "meep/\n"
911 " docs/\n"
912 " reference/ # reference documentation\n"
913 " libmeep/\n"
914 " Makefile.am\n"
915 " meeper/\n"
916 " Makefile.am\n"
917 " help/ # optional: user manual\n"
918 " meeper/\n"
919 " src/\n"
920 " libmeep/\n"
921 " meeper/\n"
922 msgstr ""
923
924 #. (itstool) path: sect2/para
925 #: C/index.docbook:613
926 #, fuzzy
927 msgid ""
928 "Next, you need to customize the copied Makefiles and provide values for the "
929 "various parameters in each <filename>Makefile.am</filename>. All settings "
930 "have a comment above them that describes their purpose and how to customize "
931 "the setting. Most settings are used to supply extra flags to the respective "
932 "tools to which they apply. Every tool has a variable of the form <option>&lt;"
933 "TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-mkhtml</"
934 "application> has an option named <code>MKHTML_OPTIONS</code>). All the tools "
935 "support <option>--help</option> to list the supported options."
936 msgstr ""
937 "下一步是编辑<filename>Makefile.am</filename>内部的设置了。所有的设置上面都有"
938 "用于描述其目的的注释。多数设置是传递给各个工具的额外标志。第各工具有各种各样"
939 "的表格<option>&lt;TOOLNAME&gt;_OPTIONS</option>.所有的工具都支持<option>--"
940 "help</option>选项以列出它支持的参数。"
941
942 #. (itstool) path: listitem/para
943 #: C/index.docbook:637
944 msgid ""
945 "<option>DOC_MODULE</option> is used to provide the name of the package that "
946 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
947 msgstr ""
948
949 #. (itstool) path: listitem/para
950 #: C/index.docbook:644
951 msgid ""
952 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
953 "directory which GTK-Doc searches for your API documentation. This will "
954 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
955 "directory of that directory."
956 msgstr ""
957
958 #. (itstool) path: listitem/para
959 #: C/index.docbook:657
960 msgid ""
961 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
962 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB="
963 "$(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
964 "the matched files change."
965 msgstr ""
966
967 #. (itstool) path: listitem/para
968 #: C/index.docbook:669
969 msgid ""
970 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
971 "include when scanning for API documentation, which are not found under "
972 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
973 "extra.h</code>)."
974 msgstr ""
975
976 #. (itstool) path: listitem/para
977 #: C/index.docbook:679
978 msgid ""
979 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
980 "to ignore when scanning for API documentation. Use the basename of the file "
981 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
982 "private_code_folder</code>)."
983 msgstr ""
984
985 #. (itstool) path: listitem/para
986 #: C/index.docbook:689
987 msgid ""
988 "<option>HTML_IMAGES</option> allows to specify images files which will be "
989 "copied into the <filename>html/</filename> directory of the generated "
990 "documentation. If your API documentation includes any images they need to be "
991 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
992 "stock_about_24.png</code>)."
993 msgstr ""
994
995 #. (itstool) path: listitem/para
996 #: C/index.docbook:702
997 msgid ""
998 "<option>content_files</option> allows to specify extra files that are "
999 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
1000 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1001 msgstr ""
1002
1003 #. (itstool) path: listitem/para
1004 #: C/index.docbook:713
1005 msgid ""
1006 "<option>expand_content_files</option> allows to specify files where "
1007 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
1008 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
1009 msgstr ""
1010
1011 #. (itstool) path: sect2/para
1012 #: C/index.docbook:631
1013 msgid ""
1014 "The following list explains the most relevant options. Check the example "
1015 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1016 msgstr ""
1017
1018 #. (itstool) path: sect2/title
1019 #: C/index.docbook:728
1020 msgid "Integration with autoconf"
1021 msgstr "与 autoconf 集成"
1022
1023 #. (itstool) path: sect2/para
1024 #: C/index.docbook:730
1025 msgid ""
1026 "Integration with <application>autoconf</application> is very simple and "
1027 "includes one required step and an additional optional (but recommended) "
1028 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
1029 "to your <filename>configure.ac</filename> script. This registers several "
1030 "configure options to enable GTK-Doc and allows you to set default arguments "
1031 "for <application>gtkdocize</application>."
1032 msgstr ""
1033
1034 #. (itstool) path: warning/simpara
1035 #: C/index.docbook:742
1036 msgid ""
1037 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
1038 "macro must start at the beginning of the line and should not start with "
1039 "whitespace."
1040 msgstr ""
1041
1042 #. (itstool) path: sect2/para
1043 #: C/index.docbook:749
1044 msgid ""
1045 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1046 "<filename>configure.ac</filename>. This is not required but helps "
1047 "<application>gtkdocize</application> to automatically copy the macro "
1048 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1049 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1050 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
1051 "to explicitly tell the <application>aclocal</application> tool where to find "
1052 "the macro definition file."
1053 msgstr ""
1054
1055 #. (itstool) path: example/title
1056 #: C/index.docbook:762
1057 msgid "Minimal integration with autoconf"
1058 msgstr "与 autoconf 的最小化集成"
1059
1060 #. (itstool) path: example/programlisting
1061 #: C/index.docbook:763
1062 #, no-wrap
1063 msgid ""
1064 "\n"
1065 "# recommended: set m4 directory\n"
1066 "AC_CONFIG_MACRO_DIR(m4)\n"
1067 "# optional: register gtk-doc in configure\n"
1068 "GTK_DOC_CHECK([1.28])\n"
1069 msgstr ""
1070 "\n"
1071 "# 推荐:设置 m4 目录\n"
1072 "AC_CONFIG_MACRO_DIR(m4)\n"
1073 "# 可选:在 configure 中注册 gtk-doc\n"
1074 "GTK_DOC_CHECK([1.28])\n"
1075
1076 #. (itstool) path: example/title
1077 #: C/index.docbook:778
1078 msgid "Integration with optional gtk-doc dependency"
1079 msgstr "与可选的 gtk-doc 依赖的集成"
1080
1081 #. (itstool) path: example/programlisting
1082 #: C/index.docbook:779
1083 #, no-wrap
1084 msgid ""
1085 "\n"
1086 "m4_ifdef([GTK_DOC_CHECK], [\n"
1087 "# recommended: set m4 directory\n"
1088 "AC_CONFIG_MACRO_DIR(m4)\n"
1089 "# optional: register gtk-doc in configure\n"
1090 "GTK_DOC_CHECK([1.28])\n"
1091 "],[\n"
1092 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1093 "])\n"
1094 msgstr ""
1095
1096 #. (itstool) path: sect2/para
1097 #: C/index.docbook:772
1098 msgid ""
1099 "The above example works, but will require all developers to have gtk-doc "
1100 "installed. A better way is to make building the documentation optional as "
1101 "shown in the next example: <_:example-1/>"
1102 msgstr ""
1103
1104 #. (itstool) path: sect2/para
1105 #: C/index.docbook:792
1106 #, fuzzy
1107 msgid ""
1108 "The first argument is used to check for the Gtk-Doc version at configure "
1109 "time. The 2nd, optional argument is used by <application>gtkdocize</"
1110 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
1111 "configure switches:"
1112 msgstr ""
1113 "第一个参数用来在配置时检查gtkdoc的版本。第二个可选参数由"
1114 "<application>gtkdocize</application>使用。<symbol>GTK_DOC_CHECK</symbol>宏也"
1115 "会加入几个配置开关。"
1116
1117 #. (itstool) path: listitem/para
1118 #: C/index.docbook:801
1119 msgid "--with-html-dir=PATH : path to installed docs"
1120 msgstr "--with-html-dir=PATH : 安装文档的路径"
1121
1122 #. (itstool) path: listitem/para
1123 #: C/index.docbook:802
1124 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1125 msgstr "--enable-gtk-doc : 用gtk-doc构建文档[默认值:no]"
1126
1127 #. (itstool) path: listitem/para
1128 #: C/index.docbook:803
1129 msgid ""
1130 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1131 msgstr "--enable-gtk-doc-html :用html格式构建文档[默认值:yes]"
1132
1133 #. (itstool) path: listitem/para
1134 #: C/index.docbook:804
1135 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1136 msgstr "--enable-gtk-doc-pdf : 以PDF格式构建文档[默认值:no]"
1137
1138 #. (itstool) path: important/para
1139 #: C/index.docbook:808
1140 msgid ""
1141 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
1142 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
1143 "Otherwise pregenerated documentation is installed (which makes sense for "
1144 "users but not for developers)."
1145 msgstr ""
1146 "GTK-Doc在默认情况下是关闭的!请记得给文本<filename>configure</filename>运作时"
1147 "传递<option>'--enable-gtk-doc'</option>选项。否则,将会安装预先生成的文档(对"
1148 "用户有意义但对开发人员没用处)。"
1149
1150 #. (itstool) path: sect2/para
1151 #: C/index.docbook:816
1152 msgid ""
1153 "After all changes to <filename>configure.ac</filename> are made, update the "
1154 "<filename>configure</filename> file. This can be done by re-running "
1155 "<code>autogen.sh</code>."
1156 msgstr ""
1157
1158 #. (itstool) path: sect2/title
1159 #: C/index.docbook:824
1160 msgid "Integration with autogen"
1161 msgstr "与 autogen 集成"
1162
1163 #. (itstool) path: sect2/para
1164 #: C/index.docbook:826
1165 #, fuzzy
1166 msgid ""
1167 "Most projects will have an <filename>autogen.sh</filename> script to setup "
1168 "the build infrastructure after the project was checked out from a version "
1169 "control system (such as git or svn). GTK-Doc comes with a script called "
1170 "<application>gtkdocize</application> which can be used to copy the necessary "
1171 "files needed by Gtk-Doc to the source directory."
1172 msgstr ""
1173 "在经过版本控制系统(比如 cvs/svn/git)的检查之后,多数项目会有一个"
1174 "<filename>autogen.sh</filename>脚本来设置构建基础结构。GTK-Doc便带着一个名叫"
1175 "<application>gtkdocize</application>的可以用在这样一个脚本中的工具出炉了。"
1176
1177 #. (itstool) path: sect2/para
1178 #: C/index.docbook:834
1179 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1180 msgstr "它应在 autoreconf, autoheader, automake 或 autoconf 之前运行。"
1181
1182 #. (itstool) path: example/title
1183 #: C/index.docbook:839
1184 msgid "Running gtkdocize from autogen.sh"
1185 msgstr "从autogen.sh中运行gtkdocize"
1186
1187 #. (itstool) path: example/programlisting
1188 #: C/index.docbook:840
1189 #, no-wrap
1190 msgid ""
1191 "\n"
1192 "gtkdocize || exit 1\n"
1193 msgstr ""
1194 "\n"
1195 "gtkdocize || exit 1\n"
1196
1197 #. (itstool) path: example/title
1198 #: C/index.docbook:848
1199 msgid "Conditionally run gtkdocize from autogen.sh"
1200 msgstr "从 autogen.sh 中有条件地运行 gtkdocize"
1201
1202 #. (itstool) path: example/programlisting
1203 #: C/index.docbook:849
1204 #, no-wrap
1205 msgid ""
1206 "\n"
1207 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1208 "if test $? -ne 0; then\n"
1209 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1210 "else\n"
1211 " $GTKDOCIZE || exit 1\n"
1212 "fi\n"
1213 msgstr ""
1214 "\n"
1215 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1216 "if test $? -ne 0; then\n"
1217 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1218 "else\n"
1219 " $GTKDOCIZE || exit 1\n"
1220 "fi\n"
1221
1222 #. (itstool) path: sect2/para
1223 #: C/index.docbook:860
1224 #, fuzzy
1225 msgid ""
1226 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1227 "doc.make</filename> to your project root (or any directory specified by the "
1228 "<option>--docdir</option> option)."
1229 msgstr ""
1230 "当<application>gtkdocize</application> 运行时它复制文件<filename>gtk-doc."
1231 "make</filename>到你的项目的根目录(或者由选项<option>--docdir</option>指定的任"
1232 "何目录)。它也为<function>GTK_DOC_CHECK</function> 调用器检查你的配置脚本。这"
1233 "个宏可以用于向<application>gtkdocize</application>传递参数。"
1234
1235 #. (itstool) path: sect2/para
1236 #: C/index.docbook:866
1237 #, fuzzy
1238 msgid ""
1239 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1240 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1241 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1242 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1243 "<function>GTK_DOC_CHECK</function> macro."
1244 msgstr ""
1245 "当<application>gtkdocize</application> 运行时它复制文件<filename>gtk-doc."
1246 "make</filename>到你的项目的根目录(或者由选项<option>--docdir</option>指定的任"
1247 "何目录)。它也为<function>GTK_DOC_CHECK</function> 调用器检查你的配置脚本。这"
1248 "个宏可以用于向<application>gtkdocize</application>传递参数。"
1249
1250 #. (itstool) path: sect2/para
1251 #: C/index.docbook:875
1252 msgid ""
1253 "Alternatively, additional arguments can also be passed to "
1254 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1255 "function> environment variable, or by directly specifying them to "
1256 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1257 msgstr ""
1258
1259 #. (itstool) path: sect2/title
1260 #: C/index.docbook:886
1261 msgid "Executing GTK-Doc from the Build System"
1262 msgstr "从构建系统运行 GTK-Doc"
1263
1264 #. (itstool) path: sect2/para
1265 #: C/index.docbook:888
1266 #, fuzzy
1267 msgid ""
1268 "After the previous steps it's time to run the build. First we need to rerun "
1269 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1270 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1271 "<filename>configure</filename> with this option afterwards."
1272 msgstr ""
1273 "在完成前面的几步之后是运行构建的时间了。首先我们得重新运行<filename>autogen."
1274 "sh</filename>.如果这个脚本为你运行了configure,那么给它一个<option>--enable-"
1275 "gtk-doc</option>选项。不然用这个选项手动运行<filename>configure</filename>紧"
1276 "随其后。 "
1277
1278 #. (itstool) path: sect2/para
1279 #: C/index.docbook:895
1280 #, fuzzy
1281 msgid ""
1282 "The first make run generates several additional files in the doc-"
1283 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1284 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past ."
1285 "sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1286 msgstr ""
1287 "第一次运行make时在文档目录里生成几个额外的文件。其中几个重要的文件是:"
1288 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs."
1289 "xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</"
1290 "filename>."
1291
1292 #. (itstool) path: example/title
1293 #: C/index.docbook:903
1294 msgid "Running the doc build"
1295 msgstr "运行文档构建"
1296
1297 #. (itstool) path: example/programlisting
1298 #: C/index.docbook:904
1299 #, no-wrap
1300 msgid ""
1301 "\n"
1302 "./autogen.sh --enable-gtk-doc\n"
1303 "make\n"
1304 msgstr ""
1305 "\n"
1306 "./autogen.sh --enable-gtk-doc\n"
1307 "make\n"
1308
1309 #. (itstool) path: sect2/para
1310 #: C/index.docbook:911
1311 msgid ""
1312 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1313 "index.html</filename>. With this initial setup you will only see a very "
1314 "simple document. The next chapter will teach you how to add API "
1315 "documentation to your code via special comment blocks. The Chapter "
1316 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1317 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1318 "template</link> to add additional chapters and sections to your "
1319 "documentation files."
1320 msgstr ""
1321
1322 #. (itstool) path: sect1/title
1323 #: C/index.docbook:927
1324 msgid "Integration with CMake build systems"
1325 msgstr "与 CMake 构建系统集成"
1326
1327 #. (itstool) path: sect1/para
1328 #: C/index.docbook:929
1329 msgid ""
1330 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1331 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1332 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1333 "set in your <filename>CMakeLists.txt</filename> file."
1334 msgstr ""
1335
1336 #. (itstool) path: example/title
1337 #: C/index.docbook:939
1338 msgid "Example of using GTK-Doc from CMake"
1339 msgstr "在 CMake 中使用 GTK-Doc 的例子"
1340
1341 #. (itstool) path: example/programlisting
1342 #: C/index.docbook:940
1343 #, no-wrap
1344 msgid ""
1345 "\n"
1346 "find_package(GtkDoc 1.25 REQUIRED)\n"
1347 "\n"
1348 "# Create the doc-libmeep target.\n"
1349 "gtk_doc_add_module(\n"
1350 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1351 " XML meep-docs.xml\n"
1352 " LIBRARIES libmeep\n"
1353 ")\n"
1354 "\n"
1355 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1356 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1357 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1358 "\n"
1359 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1360 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1361 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1362 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1363 msgstr ""
1364
1365 #. (itstool) path: sect1/para
1366 #: C/index.docbook:937
1367 msgid "The following example shows how to use this command. <_:example-1/>"
1368 msgstr "下面的例子展示如何使用此命令。<_:example-1/>"
1369
1370 #. (itstool) path: sect1/title
1371 #: C/index.docbook:964
1372 msgid "Integration with plain makefiles or other build systems"
1373 msgstr "与普通makefile或其它构建系统整合"
1374
1375 #. (itstool) path: sect1/para
1376 #: C/index.docbook:966
1377 #, fuzzy
1378 msgid ""
1379 "In the case one does not want to use automake and therefore <filename>gtk-"
1380 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1381 "in own makefiles (or other build tools)."
1382 msgstr ""
1383 "在本例中某人不想用automake,因此<filename>gtk-doc.mak</filename>就必须在自己"
1384 "的makefiles(或其它构建工具)里用正确的顺序调用gtkdoc工具里面。"
1385
1386 #. (itstool) path: example/title
1387 #: C/index.docbook:973
1388 msgid "Documentation build steps"
1389 msgstr "文档构建步骤"
1390
1391 #. (itstool) path: example/programlisting
1392 #: C/index.docbook:974
1393 #, no-wrap
1394 msgid ""
1395 "\n"
1396 "DOC_MODULE=meep\n"
1397 "// sources have changed\n"
1398 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1399 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1400 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1401 "// xml files have changed\n"
1402 "mkdir html\n"
1403 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1404 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1405 msgstr ""
1406
1407 #. (itstool) path: sect1/para
1408 #: C/index.docbook:988
1409 msgid ""
1410 "One will need to look at the <filename>Makefile.am</filename> and "
1411 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1412 msgstr ""
1413 "您必须查阅<filename>Makefile.am</filename> 和 <filename>gtk-doc.mak</"
1414 "filename>以获取所须的额外选项。"
1415
1416 #. (itstool) path: sect1/title
1417 #: C/index.docbook:995
1418 msgid "Integration with version control systems"
1419 msgstr "与版本控制系统集成"
1420
1421 #. (itstool) path: sect1/para
1422 #: C/index.docbook:997
1423 #, fuzzy
1424 msgid ""
1425 "As a rule of thumb, it's the files you edit which should go under version "
1426 "control. For typical projects it's these files: <filename>&lt;package&gt;."
1427 "types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1428 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, "
1429 "<filename>Makefile.am</filename>."
1430 msgstr ""
1431 "作为首要的规则,你编辑的文件都必须进行版本控制。对于典型的项目它是这些文件:"
1432 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.."
1433 "xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</"
1434 "filename>, <filename>Makefile.am</filename>"
1435
1436 #. (itstool) path: sect1/para
1437 #: C/index.docbook:1005
1438 msgid ""
1439 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1440 "directories should not go under version control. Neither should any of the "
1441 "<filename>.stamp</filename> files."
1442 msgstr ""
1443
1444 #. (itstool) path: chapter/title
1445 #: C/index.docbook:1015
1446 msgid "Documenting the code"
1447 msgstr "编写代码文档"
1448
1449 #. (itstool) path: chapter/para
1450 #: C/index.docbook:1017
1451 #, fuzzy
1452 msgid ""
1453 "GTK-Doc uses source code comment with a special syntax for code "
1454 "documentation. Further it retrieves information about your project structure "
1455 "from other sources. During the next section you will find all information "
1456 "about the syntax of the comments."
1457 msgstr ""
1458 "GTK-Doc用一种带有特殊语法的源代码注释来编写代码文档。而且它会从其它代码中收"
1459 "集有关你的项目结构的信息。在下一章节里你将找到有关其注释语法的全部信息。"
1460
1461 #. (itstool) path: example/title
1462 #: C/index.docbook:1028 C/index.docbook:1054
1463 msgid "GTK-Doc comment block"
1464 msgstr "GTK-Doc 注释块"
1465
1466 #. (itstool) path: example/programlisting
1467 #: C/index.docbook:1029
1468 #, fuzzy, no-wrap
1469 #| msgid ""
1470 #| "\n"
1471 #| "\n"
1472 #| "#ifndef __GTK_DOC_IGNORE__\n"
1473 #| "/* unparseable code here */\n"
1474 #| "#endif\n"
1475 #| "\n"
1476 #| " "
1477 msgid ""
1478 "\n"
1479 "#ifndef __GTK_DOC_IGNORE__\n"
1480 "/* unparseable code here */\n"
1481 "#endif\n"
1482 msgstr ""
1483 "\n"
1484 "\n"
1485 "#ifndef __GTK_DOC_IGNORE__\n"
1486 "/* 这里放置无法解析的代码 */\n"
1487 "#endif\n"
1488 "\n"
1489 " "
1490
1491 #. (itstool) path: chapter/para
1492 #: C/index.docbook:1024
1493 #, fuzzy
1494 msgid ""
1495 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1496 "of receiving warnings from the scanner that look like a special case, one "
1497 "can hint GTK-Doc to skip over them. <_:example-1/>"
1498 msgstr ""
1499 "代码扫描程序能够很好地处理主要的C语言头文件。接收扫描程序发出的警告的过程看起"
1500 "来像个特殊案例,你可以示意GTK-Doc忽略它们。<placeholder-1/>"
1501
1502 #. (itstool) path: note/title
1503 #: C/index.docbook:1038
1504 msgid "Limitations"
1505 msgstr "局限性"
1506
1507 #. (itstool) path: note/para
1508 #: C/index.docbook:1039
1509 msgid ""
1510 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1511 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1512 msgstr ""
1513
1514 #. (itstool) path: sect1/title
1515 #: C/index.docbook:1049
1516 msgid "Documentation comments"
1517 msgstr "文档注释"
1518
1519 #. (itstool) path: example/programlisting
1520 #: C/index.docbook:1055
1521 #, fuzzy, no-wrap
1522 #| msgid ""
1523 #| "\n"
1524 #| "\n"
1525 #| "/**\n"
1526 #| " * identifier:\n"
1527 #| " * documentation ...\n"
1528 #| " */\n"
1529 #| "\n"
1530 #| " "
1531 msgid ""
1532 "\n"
1533 "/**\n"
1534 " * identifier:\n"
1535 " * documentation ...\n"
1536 " */\n"
1537 msgstr ""
1538 "\n"
1539 "\n"
1540 "/**\n"
1541 " * identifier:\n"
1542 " * documentation ...\n"
1543 " */\n"
1544 "\n"
1545 " "
1546
1547 #. (itstool) path: sect1/para
1548 #: C/index.docbook:1051
1549 #, fuzzy
1550 msgid ""
1551 "A multiline comment that starts with an additional '*' marks a documentation "
1552 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1553 msgstr ""
1554 "一个以'*'号起始的多行注释标注了一个将由GTK-Doc工具处理的文档块。"
1555 "<placeholder-1/>"
1556
1557 #. (itstool) path: sect1/para
1558 #: C/index.docbook:1064
1559 #, fuzzy
1560 msgid ""
1561 "The 'identifier' is one line with the name of the item the comment is "
1562 "related to. The syntax differs a little depending on the item. (TODO add "
1563 "table showing identifiers)"
1564 msgstr ""
1565 "'identifier'是指示注释相关项的名字的行。其语法因其项的不同而而有一点差异。"
1566 "(TODO add table showing identifiers)"
1567
1568 #. (itstool) path: sect1/para
1569 #: C/index.docbook:1070
1570 #, fuzzy
1571 msgid ""
1572 "The 'documentation' block is also different for each symbol type. Symbol "
1573 "types that get parameters such as functions or macros have the parameter "
1574 "description first followed by a blank line (just a '*'). Afterwards follows "
1575 "the detailed description. All lines (outside program listings and CDATA "
1576 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1577 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1578 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1579 msgstr ""
1580 "'documentation'块也会因标识符类型而不同。标识符类型取得参数如函数与宏一个空行"
1581 "之后有其参数的描述(只是一个'*'号)。然后紧跟着它的细节描述。所有的行"
1582 "( program- 列 与 CDATA 段除外)只包括一个 ' *' (空格-星号)会转化为段落分割符。"
1583 "如果你不想要段落分割符,可以把它改为' * '(空格-星号-空格-空格)。"
1584
1585 #. (itstool) path: listitem/para
1586 #: C/index.docbook:1087
1587 #, fuzzy
1588 msgid ""
1589 "What it is: The name for a class or function can sometimes be misleading for "
1590 "people coming from a different background."
1591 msgstr "这就是:有时候来自不同文明的人会误解类或函数。"
1592
1593 #. (itstool) path: listitem/para
1594 #: C/index.docbook:1093
1595 #, fuzzy
1596 msgid ""
1597 "What it does: Tell about common uses. Put it in relation with the other API."
1598 msgstr "它做的是:告知普通的用法。把它与其它的API发生联系。"
1599
1600 #. (itstool) path: tip/para
1601 #: C/index.docbook:1083
1602 #, fuzzy
1603 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1604 msgstr "在编写代码文档时,描述两种方向:<placeholder-1/>"
1605
1606 #. (itstool) path: listitem/para
1607 #: C/index.docbook:1108
1608 msgid "Use function() to refer to functions or macros which take arguments."
1609 msgstr "用function()来指示带有参数的函数或宏。"
1610
1611 #. (itstool) path: listitem/para
1612 #: C/index.docbook:1113
1613 msgid ""
1614 "Use @param to refer to parameters. Also use this when referring to "
1615 "parameters of other functions, related to the one being described."
1616 msgstr "用@param指示参数。同样也可以指示其它函数的参数,与所描述的对象有关。"
1617
1618 #. (itstool) path: listitem/para
1619 #: C/index.docbook:1119
1620 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1621 msgstr "用%constant指示常量,比如:%G_TRAVERSE_LEAFS。"
1622
1623 #. (itstool) path: listitem/para
1624 #: C/index.docbook:1124
1625 msgid ""
1626 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1627 "macros which don't take arguments."
1628 msgstr "用#symbol指示其它符号类型,比如:结构,枚举与不带参数的宏。"
1629
1630 #. (itstool) path: listitem/para
1631 #: C/index.docbook:1130
1632 #, fuzzy
1633 #| msgid "Use #Object::signal to refer to a GObject signal"
1634 msgid "Use #Object::signal to refer to a GObject signal."
1635 msgstr "用#Object::signal指示一个GObject信号"
1636
1637 #. (itstool) path: listitem/para
1638 #: C/index.docbook:1135
1639 #, fuzzy
1640 #| msgid "Use #Object:property to refer to a GObject property"
1641 msgid "Use #Object:property to refer to a GObject property."
1642 msgstr "用#Object::property指示一个#Object属性"
1643
1644 #. (itstool) path: listitem/para
1645 #: C/index.docbook:1140
1646 #, fuzzy
1647 #| msgid "Use #Struct.field to refer to a field inside a structure."
1648 msgid ""
1649 "Use #Struct.field to refer to a field inside a structure and #GObjectClass."
1650 "foo_bar() to refer to a vmethod."
1651 msgstr "用#Struct.field指示结构体的字段。"
1652
1653 #. (itstool) path: sect1/para
1654 #: C/index.docbook:1102
1655 msgid ""
1656 "One advantage of hyper-text over plain-text is the ability to have links in "
1657 "the document. Writing the correct markup for a link can be tedious though. "
1658 "GTK-Doc comes to help by providing several useful abbreviations. <_:"
1659 "itemizedlist-1/>"
1660 msgstr ""
1661 "与纯文本相比,超文本的优势在于可以在文档内部有链接。但为一个链接编写正确的标"
1662 "记可能是件枯燥的差事。GTK-Doc提供了几个有用的简化方法帮你解决这个麻烦。<_:"
1663 "itemizedlist-1/>"
1664
1665 #. (itstool) path: tip/para
1666 #: C/index.docbook:1149
1667 msgid ""
1668 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1669 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1670 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;"
1671 "commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape them "
1672 "with a backslash '\\'."
1673 msgstr ""
1674 "如果你要在文档里面使用一些特殊的字符'&lt;', '&gt;', '()', '@', '%', or '#' 且"
1675 "不用GTK-Doc来修改它们,你可以相应地用XML 实体 \"&amp;lt;\", \"&amp;gt;\", "
1676 "\"&amp;lpar;\", \"&amp;rpar;\", \"&amp;commat;\", \"&amp;percnt;\" 以及 "
1677 "\"&amp;num;\"或者用一个反斜线'\\'来转义它们。"
1678
1679 #. (itstool) path: sect1/para
1680 #: C/index.docbook:1158
1681 msgid ""
1682 "DocBook can do more than just links. One can also have lists, examples, "
1683 "headings, and images. As of version 1.20, the preferred way is to use a "
1684 "subset of the basic text formatting syntax called <ulink url=\"http://"
1685 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1686 "versions any documentation that includes Markdown will be rendered as is. "
1687 "For example, list items will appear as lines starting with a dash."
1688 msgstr ""
1689
1690 #. (itstool) path: sect1/para
1691 #: C/index.docbook:1169
1692 msgid ""
1693 "While markdown is now preferred one can mix both. One limitation here is "
1694 "that one can use docbook xml within markdown, but markdown within docbook "
1695 "xml is not supported."
1696 msgstr ""
1697
1698 #. (itstool) path: sect1/para
1699 #: C/index.docbook:1175
1700 #, fuzzy
1701 #| msgid ""
1702 #| "DocBook can do more than just links. One can also have lists, tables and "
1703 #| "examples. To enable the usage of docbook SGML/XML tags inside doc-"
1704 #| "comments you need to have <option>--xml-mode</option> or <option>--sgml-"
1705 #| "mode</option> in the variable <symbol>MKDB_OPTIONS</symbol> inside "
1706 #| "<filename>Makefile.am</filename>."
1707 msgid ""
1708 "In older GTK-Doc releases, if you need support for additional formatting, "
1709 "you would need to enable the usage of docbook XML tags inside doc-comments "
1710 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1711 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1712 "filename>."
1713 msgstr ""
1714 "DocBook可以做比链接多得多的事情。你可以有列表,表格和示例。要在doc-comments中"
1715 "激活docbook SGML/XML标识的使用,你得往<filename>Makefile.am</filename>文件中"
1716 "的变量<symbol>MKDB_OPTIONS</symbol>上加入<option>--xml-mode</option> 或 "
1717 "<option>--sgml-mode</option>选项。"
1718
1719 #. (itstool) path: example/title
1720 #: C/index.docbook:1184
1721 msgid "GTK-Doc comment block using Markdown"
1722 msgstr "使用 Markdown 进行 GTK-Doc 块注释"
1723
1724 #. (itstool) path: example/programlisting
1725 #: C/index.docbook:1185
1726 #, no-wrap
1727 msgid ""
1728 "\n"
1729 "/**\n"
1730 " * identifier:\n"
1731 " *\n"
1732 " * documentation paragraph ...\n"
1733 " *\n"
1734 " * # Sub Heading #\n"
1735 " *\n"
1736 " * ## Second Sub Heading\n"
1737 " *\n"
1738 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1739 " *\n"
1740 " * more documentation:\n"
1741 " *\n"
1742 " * - list item 1\n"
1743 " *\n"
1744 " * Paragraph inside a list item.\n"
1745 " *\n"
1746 " * - list item 2\n"
1747 " *\n"
1748 " * 1. numbered list item\n"
1749 " *\n"
1750 " * 2. another numbered list item\n"
1751 " *\n"
1752 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1753 " *\n"
1754 " * ![an inline image](plot-result.png)\n"
1755 " *\n"
1756 " * [A link to the heading anchor above][heading-two]\n"
1757 " *\n"
1758 " * A C-language example:\n"
1759 " * |[&lt;!-- language=\"C\" --&gt;\n"
1760 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1761 " * ]|\n"
1762 " */\n"
1763 msgstr ""
1764
1765 #. (itstool) path: sect1/para
1766 #: C/index.docbook:1224
1767 msgid ""
1768 "More examples of what markdown tags are supported can be found in the <ulink "
1769 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
1770 "Documentation Markdown Syntax Reference</ulink>."
1771 msgstr ""
1772
1773 #. (itstool) path: tip/para
1774 #: C/index.docbook:1230
1775 #, fuzzy
1776 #| msgid ""
1777 #| "As already mentioned earlier GTK-Doc is for documenting public API. Thus "
1778 #| "one cannot write documentation for static symbols. Nevertheless it is "
1779 #| "good to comment those symbols too. This helps other to understand you "
1780 #| "code. Therefore we recommend to comment these using normal comments "
1781 #| "(without the 2nd '*' in the first line). If later the function needs to "
1782 #| "be made public, all one needs to do is to add another '*' in the comment "
1783 #| "block and insert the symbol name at the right place inside the sections "
1784 #| "file."
1785 msgid ""
1786 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
1787 "cannot write documentation for static symbols. Nevertheless it is good to "
1788 "comment those symbols too. This helps other developers to understand your "
1789 "code. Therefore we recommend to comment these using normal comments (without "
1790 "the 2nd '*' in the first line). If later the function needs to be made "
1791 "public, all one needs to do is to add another '*' in the comment block and "
1792 "insert the symbol name at the right place inside the sections file."
1793 msgstr ""
1794 "如早先所述,GTK-Doc是为编写公共的API而作的。所以你不能够为静态符号编写文档。"
1795 "尽管如此,它也可以很好地为那些符号作注释。这有助于他人理解你的代码。因此我们"
1796 "建议你用普通的注释来注释它们(不使用第一行的第二个'*'号)。如果以后函数须要作"
1797 "为public,你须做的只是在注释块中加入另一个 '*'号并且在区段文件里插入正确的标"
1798 "识符名称。"
1799
1800 #. (itstool) path: sect1/title
1801 #: C/index.docbook:1245
1802 msgid "Documenting sections"
1803 msgstr "文档章节"
1804
1805 #. (itstool) path: sect1/para
1806 #: C/index.docbook:1247
1807 msgid ""
1808 "Each section of the documentation contains information about one class or "
1809 "module. To introduce the component one can write a section block. The short "
1810 "description is also used inside the table of contents. All the @fields are "
1811 "optional."
1812 msgstr ""
1813 "文档的每个章节都包含着关于一个类或模块的信息。要介绍它的组件,你可以编写一节"
1814 "注释块。在内容表格中也可以使用简短的描述。所有的@fields都是可选的。"
1815
1816 #. (itstool) path: example/title
1817 #: C/index.docbook:1255
1818 msgid "Section comment block"
1819 msgstr "节注释块"
1820
1821 #. (itstool) path: example/programlisting
1822 #: C/index.docbook:1256
1823 #, fuzzy, no-wrap
1824 #| msgid ""
1825 #| "\n"
1826 #| "\n"
1827 #| "/**\n"
1828 #| " * SECTION:meepapp\n"
1829 #| " * @short_description: the application class\n"
1830 #| " * @title: Meep application\n"
1831 #| " * @section_id:\n"
1832 #| " * @see_also: #MeepSettings\n"
1833 #| " * @stability: Stable\n"
1834 #| " * @include: meep/app.h\n"
1835 #| " * @image: application.png\n"
1836 #| " *\n"
1837 #| " * The application class handles ...\n"
1838 #| " */\n"
1839 #| "\n"
1840 #| " "
1841 msgid ""
1842 "\n"
1843 "/**\n"
1844 " * SECTION:meepapp\n"
1845 " * @short_description: the application class\n"
1846 " * @title: Meep application\n"
1847 " * @section_id:\n"
1848 " * @see_also: #MeepSettings\n"
1849 " * @stability: Stable\n"
1850 " * @include: meep/app.h\n"
1851 " * @image: application.png\n"
1852 " *\n"
1853 " * The application class handles ...\n"
1854 " */\n"
1855 msgstr ""
1856 "\n"
1857 "\n"
1858 "/**\n"
1859 " * SECTION:meepapp\n"
1860 " * @short_description: the application class\n"
1861 " * @title: Meep application\n"
1862 " * @section_id:\n"
1863 " * @see_also: #MeepSettings\n"
1864 " * @stability: Stable\n"
1865 " * @include: meep/app.h\n"
1866 " * @image: application.png\n"
1867 " *\n"
1868 " * The application class handles ...\n"
1869 " */\n"
1870 "\n"
1871 " "
1872
1873 #. (itstool) path: varlistentry/term
1874 #: C/index.docbook:1275
1875 msgid "SECTION:&lt;name&gt;"
1876 msgstr "SECTION:&lt;name&gt;"
1877
1878 #. (itstool) path: listitem/para
1879 #: C/index.docbook:1277
1880 #, fuzzy
1881 #| msgid ""
1882 #| "The name links the section documentation to the respective part in the "
1883 #| "<filename>&lt;package&gt;-sections.txt</filename> file. The name give "
1884 #| "here should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-"
1885 #| "sections.txt</filename> file."
1886 msgid ""
1887 "The name links the section documentation to the respective part in the "
1888 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
1889 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections."
1890 "txt</filename> file."
1891 msgstr ""
1892 "名字链接这节文档到文件<filename>&lt;package&gt;-sections.txt</filename>中对应"
1893 "的部分。这里的名字应匹配<filename>&lt;package&gt;-sections.txt</filename>文件"
1894 "中的&lt;FILE&gt;标识。"
1895
1896 #. (itstool) path: varlistentry/term
1897 #: C/index.docbook:1286
1898 msgid "@short_description"
1899 msgstr "@short_description"
1900
1901 #. (itstool) path: listitem/para
1902 #: C/index.docbook:1288
1903 msgid ""
1904 "A one line description of the section, that later will appear after the "
1905 "links in the TOC and at the top of the section page."
1906 msgstr "该节的单行描述,不久将出现在TOC里的链接后和该节页面的顶部。"
1907
1908 #. (itstool) path: varlistentry/term
1909 #: C/index.docbook:1295
1910 msgid "@title"
1911 msgstr "@title"
1912
1913 #. (itstool) path: listitem/para
1914 #: C/index.docbook:1297
1915 msgid ""
1916 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
1917 "can be overridden with the @title field."
1918 msgstr ""
1919 "段落的标题在SECTION声明里默认是 &lt;name&gt; 。它可以由@title字段替换。"
1920
1921 #. (itstool) path: varlistentry/term
1922 #: C/index.docbook:1304
1923 msgid "@section_id"
1924 msgstr "@section_id"
1925
1926 #. (itstool) path: listitem/para
1927 #: C/index.docbook:1306
1928 msgid ""
1929 "Overrides the use of title as a section identifier. For GObjects the &lt;"
1930 "title&gt; is used as a section_id and for other sections it is &lt;"
1931 "MODULE&gt;-&lt;title&gt;."
1932 msgstr ""
1933 "替换标题的用途作为一个段落指示器。对于GObjects,&lt;title&gt;用作section_id且"
1934 "对于其它的段落它是&lt;MODULE&gt;-&lt;title&gt;。"
1935
1936 #. (itstool) path: varlistentry/term
1937 #: C/index.docbook:1314
1938 msgid "@see_also"
1939 msgstr "@see_also"
1940
1941 #. (itstool) path: listitem/para
1942 #: C/index.docbook:1316
1943 msgid "A list of symbols that are related to this section."
1944 msgstr "与本节相关的标识符。"
1945
1946 #. (itstool) path: varlistentry/term
1947 #: C/index.docbook:1322
1948 msgid "@stability"
1949 msgstr "@stability"
1950
1951 #. (itstool) path: listitem/para
1952 #: C/index.docbook:1329
1953 #, fuzzy
1954 msgid ""
1955 "Stable - The intention of a Stable interface is to enable arbitrary third "
1956 "parties to develop applications to these interfaces, release them, and have "
1957 "confidence that they will run on all minor releases of the product (after "
1958 "the one in which the interface was introduced, and within the same major "
1959 "release). Even at a major release, incompatible changes are expected to be "
1960 "rare, and to have strong justifications."
1961 msgstr ""
1962 "稳定版-一个稳定版本软件界面的目的是让任意第三方开发者为这些界面开发应用程"
1963 "序,发行它们,并且确信它们的产品可以在所有的小版本号发布版上运行(after the "
1964 "one in which the interface was introduced, and within the same major "
1965 "release)。即使在一个主发行版,兼容的修改也是非常稀少的,并且要有大量的修正。"
1966
1967 #. (itstool) path: listitem/para
1968 #: C/index.docbook:1341
1969 #, fuzzy
1970 msgid ""
1971 "Unstable - Unstable interfaces are experimental or transitional. They are "
1972 "typically used to give outside developers early access to new or rapidly "
1973 "changing technology, or to provide an interim solution to a problem where a "
1974 "more general solution is anticipated. No claims are made about either source "
1975 "or binary compatibility from one minor release to the next."
1976 msgstr ""
1977 "不稳定版-不稳定版本的界面是用于体验或者过渡的软件版本。它们通常是给外部开发"
1978 "人员早期访问新的或快速改变的技术,或者为已获得预期的更普遍的方案提供一个内部"
1979 "解决方案。以保证从一个镜像发行版到另一个之间没有源代码与二进制代码兼容性的问"
1980 "题。"
1981
1982 #. (itstool) path: listitem/para
1983 #: C/index.docbook:1353
1984 #, fuzzy
1985 msgid ""
1986 "Private - An interface that can be used within the GNOME stack itself, but "
1987 "that is not documented for end-users. Such functions should only be used in "
1988 "specified and documented ways."
1989 msgstr ""
1990 "个人版-一种可以离开GNOME堆栈而自己运行的界面,但是并没有正式声明给终端用户使"
1991 "用。这样的函数只能以指定的且正式声明的方法来使用它。"
1992
1993 #. (itstool) path: listitem/para
1994 #: C/index.docbook:1362
1995 msgid ""
1996 "Internal - An interface that is internal to a module and does not require "
1997 "end-user documentation. Functions that are undocumented are assumed to be "
1998 "Internal."
1999 msgstr ""
2000 "内部版-一种为一个模块而设计的内部界面,并且不需要终端用户文档。未正式声明的"
2001 "函数假定是属于内部的。"
2002
2003 #. (itstool) path: listitem/para
2004 #: C/index.docbook:1324
2005 #, fuzzy
2006 #| msgid ""
2007 #| "A informal description of the stability level this API has. We recommend "
2008 #| "the use of one of these terms: <_:itemizedlist-1/>"
2009 msgid ""
2010 "An informal description of the stability level this API has. We recommend "
2011 "the use of one of these terms: <_:itemizedlist-1/>"
2012 msgstr ""
2013 "对这个API对稳定级别的一个非正式的描述。我们建议你使用以下术语:<_:"
2014 "itemizedlist-1/>"
2015
2016 #. (itstool) path: varlistentry/term
2017 #: C/index.docbook:1374
2018 msgid "@include"
2019 msgstr "@include"
2020
2021 #. (itstool) path: listitem/para
2022 #: C/index.docbook:1376
2023 #, fuzzy
2024 msgid ""
2025 "The <literal>#include</literal> files to show in the section synopsis (a "
2026 "comma separated list), overriding the global value from the <link linkend="
2027 "\"metafiles_sections\">section file</link> or command line. This item is "
2028 "optional."
2029 msgstr ""
2030 "<literal>#include</literal> 文件在段落提纲内部显现(一个由分号‘;’分隔的列"
2031 "表),从<link linkend=\"metafiles_sections\">section file</link>或者命令行中"
2032 "取代全局数值。这是个可选项。"
2033
2034 #. (itstool) path: varlistentry/term
2035 #: C/index.docbook:1385
2036 msgid "@image"
2037 msgstr "@image"
2038
2039 #. (itstool) path: listitem/para
2040 #: C/index.docbook:1387
2041 msgid ""
2042 "The image to display at the top of the reference page for this section. This "
2043 "will often be some sort of a diagram to illustrate the visual appearance of "
2044 "a class or a diagram of its relationship to other classes. This item is "
2045 "optional."
2046 msgstr ""
2047 "本章节的参考页顶部显示的图像。这常常是某些用于阐释一个类或者图表与其它类之间"
2048 "关系的可视化图示。这个项是可选的。"
2049
2050 #. (itstool) path: tip/para
2051 #: C/index.docbook:1398
2052 msgid ""
2053 "To avoid unnecessary recompilation after doc-changes put the section docs "
2054 "into the c-source where possible."
2055 msgstr ""
2056 "为避免不必要的重编译,在文档改动后尽可能把段落文档放入C代码中合适的位置。"
2057
2058 #. (itstool) path: sect1/title
2059 #: C/index.docbook:1407
2060 msgid "Documenting symbols"
2061 msgstr "编写符号文档"
2062
2063 #. (itstool) path: sect1/para
2064 #: C/index.docbook:1409
2065 msgid ""
2066 "Each symbol (function, macro, struct, enum, signal and property) is "
2067 "documented in a separate block. The block is best placed close to the "
2068 "definition of the symbols so that it is easy to keep them in sync. Thus "
2069 "functions are usually documented in the c-source and macros, structs and "
2070 "enums in the header file."
2071 msgstr ""
2072 "每个符号(函数,宏,结构,枚举,信号及属性)都在各自独立的块中描述。这些块最"
2073 "好放置于接近标识符定义的地方,这样可以容易地让它们保持同步。因此函数通常在C代"
2074 "码中定义,宏和结构及枚举在头文件里定义。"
2075
2076 #. (itstool) path: sect2/title
2077 #. (itstool) path: example/title
2078 #: C/index.docbook:1417 C/index.docbook:1483
2079 msgid "General tags"
2080 msgstr "一般标记"
2081
2082 #. (itstool) path: sect2/para
2083 #: C/index.docbook:1419
2084 msgid ""
2085 "You can add versioning information to all documentation elements to tell "
2086 "when an API was introduced, or when it was deprecated."
2087 msgstr "你可以为所有的文档元素加入版本信息,表明何时引入或废弃了某个API。"
2088
2089 #. (itstool) path: variablelist/title
2090 #: C/index.docbook:1424
2091 msgid "Versioning Tags"
2092 msgstr "版本标记"
2093
2094 #. (itstool) path: varlistentry/term
2095 #: C/index.docbook:1425
2096 msgid "Since:"
2097 msgstr "始于:"
2098
2099 #. (itstool) path: listitem/para
2100 #: C/index.docbook:1427
2101 msgid "Description since which version of the code the API is available."
2102 msgstr "描述从哪个版本的代码开始加入了该API。"
2103
2104 #. (itstool) path: varlistentry/term
2105 #: C/index.docbook:1432
2106 msgid "Deprecated:"
2107 msgstr "废弃:"
2108
2109 #. (itstool) path: listitem/para
2110 #: C/index.docbook:1434
2111 msgid ""
2112 "Paragraph denoting that this function should no be used anymore. The "
2113 "description should point the reader to the new API."
2114 msgstr "表明这个函数不应再使用的一段文档。描述文字应向读者介绍新的API。"
2115
2116 #. (itstool) path: sect2/para
2117 #: C/index.docbook:1442
2118 #, fuzzy
2119 #| msgid ""
2120 #| "You can add versioning information to all documentation elements to tell "
2121 #| "when an API was introduced, or when it was deprecated."
2122 msgid ""
2123 "You can also add stability information to all documentation elements to "
2124 "indicate whether API stability is guaranteed for them for all future minor "
2125 "releases of the project."
2126 msgstr "你可以为所有的文档元素加入版本信息,表明何时引入或废弃了某个API。"
2127
2128 #. (itstool) path: sect2/para
2129 #: C/index.docbook:1448
2130 msgid ""
2131 "The default stability level for all documentation elements can be set by "
2132 "passing the <option>--default-stability</option> argument to "
2133 "<application>gtkdoc-mkdb</application> with one of the values below."
2134 msgstr ""
2135
2136 #. (itstool) path: variablelist/title
2137 #: C/index.docbook:1454
2138 msgid "Stability Tags"
2139 msgstr "稳定性标签"
2140
2141 #. (itstool) path: varlistentry/term
2142 #: C/index.docbook:1455
2143 msgid "Stability: Stable"
2144 msgstr ""
2145
2146 #. (itstool) path: listitem/para
2147 #: C/index.docbook:1457
2148 msgid ""
2149 "Mark the element as stable. This is for public APIs which are guaranteed to "
2150 "remain stable for all future minor releases of the project."
2151 msgstr ""
2152
2153 #. (itstool) path: varlistentry/term
2154 #: C/index.docbook:1464
2155 msgid "Stability: Unstable"
2156 msgstr ""
2157
2158 #. (itstool) path: listitem/para
2159 #: C/index.docbook:1466
2160 msgid ""
2161 "Mark the element as unstable. This is for public APIs which are released as "
2162 "a preview before being stabilised."
2163 msgstr ""
2164
2165 #. (itstool) path: varlistentry/term
2166 #: C/index.docbook:1472
2167 msgid "Stability: Private"
2168 msgstr ""
2169
2170 #. (itstool) path: listitem/para
2171 #: C/index.docbook:1474
2172 msgid ""
2173 "Mark the element as private. This is for interfaces which can be used by "
2174 "tightly coupled modules, but not by arbitrary third parties."
2175 msgstr ""
2176
2177 #. (itstool) path: example/programlisting
2178 #: C/index.docbook:1484
2179 #, fuzzy, no-wrap
2180 #| msgid ""
2181 #| "\n"
2182 #| "\n"
2183 #| "/**\n"
2184 #| " * foo_get_bar:\n"
2185 #| " * @foo: some foo\n"
2186 #| " *\n"
2187 #| " * Retrieves @foo's bar.\n"
2188 #| " *\n"
2189 #| " * Returns: @foo's bar\n"
2190 #| " *\n"
2191 #| " * Since: 2.6\n"
2192 #| " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2193 #| " **/\n"
2194 #| "Bar *\n"
2195 #| "foo_get_bar(Foo *foo)\n"
2196 #| "{\n"
2197 #| "...\n"
2198 #| "\n"
2199 #| " "
2200 msgid ""
2201 "\n"
2202 "/**\n"
2203 " * foo_get_bar:\n"
2204 " * @foo: some foo\n"
2205 " *\n"
2206 " * Retrieves @foo's bar.\n"
2207 " *\n"
2208 " * Returns: @foo's bar\n"
2209 " *\n"
2210 " * Since: 2.6\n"
2211 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2212 " */\n"
2213 "Bar *\n"
2214 "foo_get_bar(Foo *foo)\n"
2215 "{\n"
2216 "...\n"
2217 msgstr ""
2218 "\n"
2219 "\n"
2220 "/**\n"
2221 " * foo_get_bar:\n"
2222 " * @foo: some foo\n"
2223 " *\n"
2224 " * Retrieves @foo's bar.\n"
2225 " *\n"
2226 " * 返回值: @foo's bar\n"
2227 " *\n"
2228 " * 始于: 2.6\n"
2229 " * 废弃: 2.12: 请转用 foo_baz_get_bar()。\n"
2230 " **/\n"
2231 "Bar *\n"
2232 "foo_get_bar(Foo *foo)\n"
2233 "{\n"
2234 "...\n"
2235 "\n"
2236 " "
2237
2238 #. (itstool) path: sect2/title
2239 #. (itstool) path: example/title
2240 #: C/index.docbook:1504 C/index.docbook:1514
2241 msgid "Annotations"
2242 msgstr "注记"
2243
2244 #. (itstool) path: sect2/para
2245 #: C/index.docbook:1506
2246 msgid ""
2247 "Documentation blocks can contain annotation-tags. These tags will be "
2248 "rendered with tooltips describing their meaning. The tags are used by "
2249 "gobject-introspection to generate language bindings. A detailed list of the "
2250 "supported tags can be found on <ulink url=\"http://live.gnome.org/"
2251 "GObjectIntrospection/Annotations\" type=\"http\">the wiki</ulink>."
2252 msgstr ""
2253
2254 #. (itstool) path: example/programlisting
2255 #: C/index.docbook:1515
2256 #, no-wrap
2257 msgid ""
2258 "\n"
2259 "/**\n"
2260 " * foo_get_bar: (annotation)\n"
2261 " * @foo: (annotation): some foo\n"
2262 " *\n"
2263 " * Retrieves @foo's bar.\n"
2264 " *\n"
2265 " * Returns: (annotation): @foo's bar\n"
2266 " */\n"
2267 "...\n"
2268 "/**\n"
2269 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2270 " * (and another annotation)\n"
2271 " * @foo: (annotation) (another annotation): some foo\n"
2272 " *\n"
2273 " * Sets bar on @foo.\n"
2274 " */\n"
2275 msgstr ""
2276
2277 #. (itstool) path: sect2/title
2278 #. (itstool) path: example/title
2279 #: C/index.docbook:1536 C/index.docbook:1565
2280 msgid "Function comment block"
2281 msgstr "函数注释块"
2282
2283 #. (itstool) path: listitem/para
2284 #: C/index.docbook:1542
2285 msgid ""
2286 "Document whether returned objects, lists, strings, etc, should be freed/"
2287 "unrefed/released."
2288 msgstr ""
2289 "描述返回的对象、列表、字符串等是否应释放内存(freed)/解除引用/释放(released)。"
2290
2291 #. (itstool) path: listitem/para
2292 #: C/index.docbook:1548
2293 msgid "Document whether parameters can be NULL, and what happens if they are."
2294 msgstr "描述参数可否为NULL,如果是的话会发生什么。"
2295
2296 #. (itstool) path: listitem/para
2297 #: C/index.docbook:1553
2298 msgid ""
2299 "Mention interesting pre-conditions and post-conditions where appropriate."
2300 msgstr "在适当时提及相关的前提条件与后续条件。"
2301
2302 #. (itstool) path: sect2/para
2303 #: C/index.docbook:1538 C/index.docbook:1624
2304 msgid "Please remember to: <_:itemizedlist-1/>"
2305 msgstr "请记得:<_:itemizedlist-1/>"
2306
2307 #. (itstool) path: sect2/para
2308 #: C/index.docbook:1560
2309 msgid ""
2310 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
2311 "private. They are treated like static functions."
2312 msgstr ""
2313 "Gtk-doc 假定所有以'_'符开头的符号(宏,函数)是私有的并视它们为静态函数。"
2314
2315 #. (itstool) path: example/programlisting
2316 #: C/index.docbook:1566
2317 #, fuzzy, no-wrap
2318 #| msgid ""
2319 #| "\n"
2320 #| "\n"
2321 #| "/**\n"
2322 #| " * function_name:\n"
2323 #| " * @par1: description of parameter 1. These can extend over more than\n"
2324 #| " * one line.\n"
2325 #| " * @par2: description of parameter 2\n"
2326 #| " * @...: a %NULL-terminated list of bars\n"
2327 #| " *\n"
2328 #| " * The function description goes here. You can use @par1 to refer to parameters\n"
2329 #| " * so that they are highlighted in the output. You can also use %constant\n"
2330 #| " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2331 #| " * other declarations (which may be documented elsewhere).\n"
2332 #| " *\n"
2333 #| " * Returns: an integer.\n"
2334 #| " *\n"
2335 #| " * Since: 2.2\n"
2336 #| " * Deprecated: 2.18: Use other_function() instead.\n"
2337 #| " */\n"
2338 #| "\n"
2339 #| " "
2340 msgid ""
2341 "\n"
2342 "/**\n"
2343 " * function_name:\n"
2344 " * @par1: description of parameter 1. These can extend over more than\n"
2345 " * one line.\n"
2346 " * @par2: description of parameter 2\n"
2347 " * @...: a %NULL-terminated list of bars\n"
2348 " *\n"
2349 " * The function description goes here. You can use @par1 to refer to parameters\n"
2350 " * so that they are highlighted in the output. You can also use %constant\n"
2351 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2352 " * other declarations (which may be documented elsewhere).\n"
2353 " *\n"
2354 " * Returns: an integer.\n"
2355 " *\n"
2356 " * Since: 2.2\n"
2357 " * Deprecated: 2.18: Use other_function() instead.\n"
2358 " */\n"
2359 msgstr ""
2360 "\n"
2361 "\n"
2362 "/**\n"
2363 " * function_name:\n"
2364 " * @par1: 对参数 1 的描述。\n"
2365 " * 可超过一行。\n"
2366 " * @par2: 对参数 2 的描述\n"
2367 " * @...: 一个以 %NULL 终止的 bars 列表\n"
2368 " *\n"
2369 " * 这里是函数描述。您可以用 @par1 引用参数,这样在输出中它们会突出显示。\n"
2370 " * 您也可以使用 %constant 代表常量,function_name2() 代表函数,#GtkWidget \n"
2371 " * 代表指向指向其他声明的链接(可能在其他位置描述)。\n"
2372 " *\n"
2373 " * 返回值: 一个整型值。\n"
2374 " *\n"
2375 " * 始于: 2.2\n"
2376 " * 废弃: 2.18: 请转用 other_function()。\n"
2377 " */\n"
2378 "\n"
2379 " "
2380
2381 #. (itstool) path: variablelist/title
2382 #: C/index.docbook:1587
2383 msgid "Function tags"
2384 msgstr "函数标记"
2385
2386 #. (itstool) path: varlistentry/term
2387 #: C/index.docbook:1588 C/index.docbook:1795
2388 msgid "Returns:"
2389 msgstr "返回值:"
2390
2391 #. (itstool) path: listitem/para
2392 #: C/index.docbook:1590
2393 msgid "Paragraph describing the returned result."
2394 msgstr "描述返回结果的段落。"
2395
2396 #. (itstool) path: varlistentry/term
2397 #: C/index.docbook:1595
2398 msgid "@...:"
2399 msgstr "@...:"
2400
2401 #. (itstool) path: listitem/para
2402 #: C/index.docbook:1597
2403 msgid ""
2404 "In case the function has variadic arguments, you should use this tag "
2405 "(@Varargs: does also work for historic reasons)."
2406 msgstr ""
2407 "如果函数有变长参数列表,你应当使用这个标记(@Varargs: 由于历史原因确实也管"
2408 "用)。"
2409
2410 #. (itstool) path: sect2/title
2411 #. (itstool) path: example/title
2412 #: C/index.docbook:1607 C/index.docbook:1609
2413 msgid "Property comment block"
2414 msgstr "属性注释块"
2415
2416 #. (itstool) path: example/programlisting
2417 #: C/index.docbook:1610
2418 #, fuzzy, no-wrap
2419 #| msgid ""
2420 #| "\n"
2421 #| "\n"
2422 #| "/**\n"
2423 #| " * SomeWidget:some-property:\n"
2424 #| " *\n"
2425 #| " * Here you can document a property.\n"
2426 #| " */\n"
2427 #| "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2428 #| "\n"
2429 #| " "
2430 msgid ""
2431 "\n"
2432 "/**\n"
2433 " * SomeWidget:some-property:\n"
2434 " *\n"
2435 " * Here you can document a property.\n"
2436 " */\n"
2437 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2438 msgstr ""
2439 "\n"
2440 "\n"
2441 "/**\n"
2442 " * SomeWidget:some-property:\n"
2443 " *\n"
2444 " * 这里您可以描述一个属性。\n"
2445 " */\n"
2446 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2447 "\n"
2448 " "
2449
2450 #. (itstool) path: sect2/title
2451 #. (itstool) path: example/title
2452 #: C/index.docbook:1622 C/index.docbook:1641
2453 msgid "Signal comment block"
2454 msgstr "信号注释块"
2455
2456 #. (itstool) path: listitem/para
2457 #: C/index.docbook:1628
2458 msgid ""
2459 "Document when the signal is emitted and whether it is emitted before or "
2460 "after other signals."
2461 msgstr "描述信号何时发射(emitted)及在其它信号之前还是之后发射。"
2462
2463 #. (itstool) path: listitem/para
2464 #: C/index.docbook:1634
2465 msgid "Document what an application might do in the signal handler."
2466 msgstr "描述应用程序在信号处理函数中能做些什么。"
2467
2468 #. (itstool) path: example/programlisting
2469 #: C/index.docbook:1642
2470 #, fuzzy, no-wrap
2471 #| msgid ""
2472 #| "\n"
2473 #| "\n"
2474 #| "/**\n"
2475 #| " * FooWidget::foobarized:\n"
2476 #| " * @widget: the widget that received the signal\n"
2477 #| " * @foo: some foo\n"
2478 #| " * @bar: some bar\n"
2479 #| " *\n"
2480 #| " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2481 #| " */\n"
2482 #| "foo_signals[FOOBARIZE] =\n"
2483 #| " g_signal_new (\"foobarize\",\n"
2484 #| " ...\n"
2485 #| "\n"
2486 #| " "
2487 msgid ""
2488 "\n"
2489 "/**\n"
2490 " * FooWidget::foobarized:\n"
2491 " * @widget: the widget that received the signal\n"
2492 " * @foo: some foo\n"
2493 " * @bar: some bar\n"
2494 " *\n"
2495 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2496 " */\n"
2497 "foo_signals[FOOBARIZED] =\n"
2498 " g_signal_new (\"foobarized\",\n"
2499 " ...\n"
2500 msgstr ""
2501 "\n"
2502 "\n"
2503 "/**\n"
2504 " * FooWidget::foobarized:\n"
2505 " * @widget: 接受信号的窗口部件\n"
2506 " * @foo: some foo\n"
2507 " * @bar: some bar\n"
2508 " *\n"
2509 " * ::foobarized 信号在每次有人尝试 foobarize @widget 时发射。\n"
2510 " */\n"
2511 "foo_signals[FOOBARIZE] =\n"
2512 " g_signal_new (\"foobarize\",\n"
2513 " ...\n"
2514 "\n"
2515 " "
2516
2517 #. (itstool) path: sect2/title
2518 #. (itstool) path: example/title
2519 #: C/index.docbook:1659 C/index.docbook:1660
2520 msgid "Struct comment block"
2521 msgstr "结构注释块"
2522
2523 #. (itstool) path: example/programlisting
2524 #: C/index.docbook:1661
2525 #, fuzzy, no-wrap
2526 #| msgid ""
2527 #| "\n"
2528 #| "\n"
2529 #| "/**\n"
2530 #| " * FooWidget:\n"
2531 #| " * @bar: some #gboolean\n"
2532 #| " *\n"
2533 #| " * This is the best widget, ever.\n"
2534 #| " */\n"
2535 #| "typedef struct _FooWidget {\n"
2536 #| " /*&lt; private &gt;*/\n"
2537 #| " GtkWidget parent;\n"
2538 #| "\n"
2539 #| " /*&lt; public &gt;*/\n"
2540 #| " gboolean bar;\n"
2541 #| "} FooWidget;\n"
2542 #| "\n"
2543 #| " "
2544 msgid ""
2545 "\n"
2546 "/**\n"
2547 " * FooWidget:\n"
2548 " * @bar: some #gboolean\n"
2549 " *\n"
2550 " * This is the best widget, ever.\n"
2551 " */\n"
2552 "typedef struct _FooWidget {\n"
2553 " GtkWidget parent_instance;\n"
2554 "\n"
2555 " gboolean bar;\n"
2556 "} FooWidget;\n"
2557 msgstr ""
2558 "\n"
2559 "\n"
2560 "/**\n"
2561 " * FooWidget:\n"
2562 " * @bar: some #gboolean\n"
2563 " *\n"
2564 " * 这是史上最好的窗口部件。\n"
2565 " */\n"
2566 "typedef struct _FooWidget {\n"
2567 " /*&lt; private &gt;*/\n"
2568 " GtkWidget parent;\n"
2569 "\n"
2570 " /*&lt; public &gt;*/\n"
2571 " gboolean bar;\n"
2572 "} FooWidget;\n"
2573 "\n"
2574 " "
2575
2576 #. (itstool) path: sect2/para
2577 #: C/index.docbook:1676
2578 msgid ""
2579 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2580 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2581 "behaviour."
2582 msgstr ""
2583 "在你需要隐藏的私有结构字段之前使用<code>/*&lt; private &gt;*/</code> 。反之使"
2584 "用<code>/*&lt; public &gt;*/</code>."
2585
2586 #. (itstool) path: sect2/para
2587 #: C/index.docbook:1682
2588 msgid ""
2589 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2590 "it will be considered private automatically and doesn't need to be mentioned "
2591 "in the comment block."
2592 msgstr ""
2593
2594 # 什么是vmethod?难以理解。
2595 #. (itstool) path: sect2/para
2596 #: C/index.docbook:1688
2597 msgid ""
2598 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2599 "is usually a good idea to add a comment block for a class, if it has "
2600 "vmethods (as this is how they can be documented). For the GObject itself one "
2601 "can use the related section docs, having a separate block for the instance "
2602 "struct would be useful if the instance has public fields. One disadvantage "
2603 "here is that this creates two index entries of the same name (the structure "
2604 "and the section)."
2605 msgstr ""
2606 "结构注释块也可以用于GObjects与GObjectClasses。为一个类添加注释块通常是个极好"
2607 "的主意,如果它有vmethod(因为这是怎样制作它的文档的方法)。对于GObject自身而"
2608 "言,你可以使用相关的章节文档,如果对象实例有公共字段,为每个实例结构体单独块"
2609 "注释是非常有用的。缺点是这会为同一名字创建两个索引记录(结构与章节)。"
2610
2611 #. (itstool) path: sect2/title
2612 #. (itstool) path: example/title
2613 #: C/index.docbook:1700 C/index.docbook:1701
2614 msgid "Enum comment block"
2615 msgstr "枚举注释块"
2616
2617 #. (itstool) path: example/programlisting
2618 #: C/index.docbook:1702
2619 #, fuzzy, no-wrap
2620 #| msgid ""
2621 #| "\n"
2622 #| "\n"
2623 #| "/**\n"
2624 #| " * Something:\n"
2625 #| " * @SOMETHING_FOO: something foo\n"
2626 #| " * @SOMETHING_BAR: something bar\n"
2627 #| " *\n"
2628 #| " * Enum values used for the thing, to specify the thing.\n"
2629 #| " *\n"
2630 #| " **/\n"
2631 #| "typedef enum {\n"
2632 #| " SOMETHING_FOO,\n"
2633 #| " SOMETHING_BAR,\n"
2634 #| " /*&lt; private &gt;*/\n"
2635 #| " SOMETHING_COUNT\n"
2636 #| "} Something;\n"
2637 #| "\n"
2638 #| " "
2639 msgid ""
2640 "\n"
2641 "/**\n"
2642 " * Something:\n"
2643 " * @SOMETHING_FOO: something foo\n"
2644 " * @SOMETHING_BAR: something bar\n"
2645 " *\n"
2646 " * Enum values used for the thing, to specify the thing.\n"
2647 " */\n"
2648 "typedef enum {\n"
2649 " SOMETHING_FOO,\n"
2650 " SOMETHING_BAR,\n"
2651 " /*&lt; private &gt;*/\n"
2652 " SOMETHING_COUNT\n"
2653 "} Something;\n"
2654 msgstr ""
2655 "\n"
2656 "\n"
2657 "/**\n"
2658 " * Something:\n"
2659 " * @SOMETHING_FOO: something foo\n"
2660 " * @SOMETHING_BAR: something bar\n"
2661 " *\n"
2662 " * 用来解决问题和指定事物的枚举值。\n"
2663 " *\n"
2664 " **/\n"
2665 "typedef enum {\n"
2666 " SOMETHING_FOO,\n"
2667 " SOMETHING_BAR,\n"
2668 " /*&lt; private &gt;*/\n"
2669 " SOMETHING_COUNT\n"
2670 "} Something;\n"
2671 "\n"
2672 " "
2673
2674 #. (itstool) path: sect2/para
2675 #: C/index.docbook:1719
2676 msgid ""
2677 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2678 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2679 "behaviour."
2680 msgstr ""
2681 "在你要隐藏的枚举数值前使用<code>/*&lt; private &gt;*/</code>。反之使用<code>/"
2682 "*&lt; public &gt;*/</code> 。"
2683
2684 #. (itstool) path: sect1/title
2685 #: C/index.docbook:1730
2686 #, fuzzy
2687 #| msgid "Setting up a skeleton documentation"
2688 msgid "Inline program documentation"
2689 msgstr "设置一个框架文档"
2690
2691 #. (itstool) path: sect1/para
2692 #: C/index.docbook:1731
2693 msgid ""
2694 "You can document programs and their commandline interface using inline "
2695 "documentation."
2696 msgstr ""
2697
2698 #. (itstool) path: variablelist/title
2699 #: C/index.docbook:1737
2700 msgid "Tags"
2701 msgstr ""
2702
2703 #. (itstool) path: varlistentry/term
2704 #: C/index.docbook:1739
2705 msgid "PROGRAM"
2706 msgstr ""
2707
2708 #. (itstool) path: listitem/para
2709 #: C/index.docbook:1742
2710 msgid "Defines the start of a program documentation."
2711 msgstr ""
2712
2713 #. (itstool) path: varlistentry/term
2714 #: C/index.docbook:1749
2715 msgid "@short_description:"
2716 msgstr "@short_description:"
2717
2718 #. (itstool) path: listitem/para
2719 #: C/index.docbook:1751
2720 msgid "Defines a short description of the program. (Optional)"
2721 msgstr ""
2722
2723 #. (itstool) path: varlistentry/term
2724 #: C/index.docbook:1758
2725 msgid "@synopsis:"
2726 msgstr ""
2727
2728 #. (itstool) path: listitem/para
2729 #: C/index.docbook:1760
2730 msgid ""
2731 "Defines the arguments, or list of arguments that the program can take. "
2732 "(Optional)"
2733 msgstr ""
2734
2735 #. (itstool) path: varlistentry/term
2736 #: C/index.docbook:1768
2737 msgid "@see_also:"
2738 msgstr "@see_also:"
2739
2740 #. (itstool) path: listitem/para
2741 #: C/index.docbook:1770
2742 msgid "See Also manual page section. (Optional)"
2743 msgstr ""
2744
2745 #. (itstool) path: varlistentry/term
2746 #: C/index.docbook:1777
2747 msgid "@arg:"
2748 msgstr ""
2749
2750 #. (itstool) path: listitem/para
2751 #: C/index.docbook:1779
2752 msgid "Argument(s) passed to the program and their description. (Optional)"
2753 msgstr ""
2754
2755 #. (itstool) path: varlistentry/term
2756 #: C/index.docbook:1786
2757 #, fuzzy
2758 #| msgid "@short_description"
2759 msgid "Description:"
2760 msgstr "@short_description"
2761
2762 #. (itstool) path: listitem/para
2763 #: C/index.docbook:1788
2764 msgid "A longer description of the program."
2765 msgstr "程序的一段较长的描述。"
2766
2767 #. (itstool) path: listitem/para
2768 #: C/index.docbook:1797
2769 msgid "Specify what value(s) the program returns. (Optional)"
2770 msgstr ""
2771
2772 #. (itstool) path: sect2/title
2773 #: C/index.docbook:1806
2774 msgid "Example of program documentation."
2775 msgstr ""
2776
2777 #. (itstool) path: example/title
2778 #: C/index.docbook:1807
2779 msgid "Program documentation block"
2780 msgstr "程序文档块"
2781
2782 #. (itstool) path: example/programlisting
2783 #: C/index.docbook:1808
2784 #, no-wrap
2785 msgid ""
2786 "\n"
2787 "/**\n"
2788 " * PROGRAM:test-program\n"
2789 " * @short_description: A test program\n"
2790 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2791 " * @see_also: test(1)\n"
2792 " * @--arg1 *arg*: set arg1 to *arg*\n"
2793 " * @--arg2 *arg*: set arg2 to *arg*\n"
2794 " * @-v, --version: Print the version number\n"
2795 " * @-h, --help: Print the help message\n"
2796 " *\n"
2797 " * Long description of program.\n"
2798 " *\n"
2799 " * Returns: Zero on success, non-zero on failure\n"
2800 " */\n"
2801 "int main(int argc, char *argv[])\n"
2802 "{\n"
2803 "\treturn 0;\n"
2804 "}\n"
2805 msgstr ""
2806
2807 #. (itstool) path: sect1/title
2808 #: C/index.docbook:1834
2809 msgid "Useful DocBook tags"
2810 msgstr "有用的DocBook标记"
2811
2812 #. (itstool) path: sect1/para
2813 #: C/index.docbook:1836
2814 msgid ""
2815 "Here are some DocBook tags which are most useful when documenting the code."
2816 msgstr "这些是在编写代码文档时非常有用处的DocBook标记。"
2817
2818 #. (itstool) path: informalexample/programlisting
2819 #: C/index.docbook:1845
2820 #, fuzzy, no-wrap
2821 #| msgid ""
2822 #| "\n"
2823 #| "\n"
2824 #| "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2825 #| "\n"
2826 #| " "
2827 msgid ""
2828 "\n"
2829 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2830 msgstr ""
2831 "\n"
2832 "\n"
2833 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2834 "\n"
2835 " "
2836
2837 #. (itstool) path: sect1/para
2838 #: C/index.docbook:1841
2839 #, fuzzy
2840 msgid ""
2841 "To link to another section in the GTK docs: <_:informalexample-1/> The "
2842 "linkend is the SGML/XML id on the top item of the page you want to link to. "
2843 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
2844 "then the page title (\"Hash Tables\"). For widgets it is just the class "
2845 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
2846 msgstr ""
2847 "在GTK文档中链接到另一章节:<_:informalexample-1/> 链接尾部是你要链接的页面顶"
2848 "部选项上的SGML/XML id。目前对于大多页面,它是(\"gtk\", \"gdk\", \"glib\") 部"
2849 "分与页面标题(\"Hash Tables\")。对于widgets它只是类和名称而已。空格字符和下划"
2850 "线都转换成 '-' 以适应SGML/XML.。"
2851
2852 #. (itstool) path: informalexample/programlisting
2853 #: C/index.docbook:1858
2854 #, fuzzy, no-wrap
2855 #| msgid ""
2856 #| "\n"
2857 #| "\n"
2858 #| "&lt;function&gt;...&lt;/function&gt;\n"
2859 #| "\n"
2860 #| " "
2861 msgid ""
2862 "\n"
2863 "&lt;function&gt;...&lt;/function&gt;\n"
2864 msgstr ""
2865 "\n"
2866 "\n"
2867 "&lt;function&gt;...&lt;/function&gt;\n"
2868 "\n"
2869 " "
2870
2871 #. (itstool) path: sect1/para
2872 #: C/index.docbook:1855
2873 msgid ""
2874 "To refer to an external function, e.g. a standard C function: <_:"
2875 "informalexample-1/>"
2876 msgstr "引用一个外部函数,比如一个标准 C 函数:<_:informalexample-1/>"
2877
2878 #. (itstool) path: informalexample/programlisting
2879 #: C/index.docbook:1867
2880 #, fuzzy, no-wrap
2881 #| msgid ""
2882 #| "\n"
2883 #| "\n"
2884 #| "&lt;example&gt;\n"
2885 #| " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
2886 #| " &lt;programlisting&gt;\n"
2887 #| " ...\n"
2888 #| " &lt;/programlisting&gt;\n"
2889 #| "&lt;/example&gt;\n"
2890 #| "\n"
2891 #| " "
2892 msgid ""
2893 "\n"
2894 "&lt;example&gt;\n"
2895 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
2896 " &lt;programlisting language=\"C\"&gt;\n"
2897 " ...\n"
2898 " &lt;/programlisting&gt;\n"
2899 "&lt;/example&gt;\n"
2900 msgstr ""
2901 "\n"
2902 "\n"
2903 "&lt;example&gt;\n"
2904 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
2905 " &lt;programlisting&gt;\n"
2906 " ...\n"
2907 " &lt;/programlisting&gt;\n"
2908 "&lt;/example&gt;\n"
2909 "\n"
2910 " "
2911
2912 #. (itstool) path: informalexample/programlisting
2913 #: C/index.docbook:1878
2914 #, fuzzy, no-wrap
2915 #| msgid ""
2916 #| "\n"
2917 #| "\n"
2918 #| "&lt;informalexample&gt;\n"
2919 #| " &lt;programlisting&gt;\n"
2920 #| " ...\n"
2921 #| " &lt;/programlisting&gt;\n"
2922 #| "&lt;/informalexample&gt;\n"
2923 #| "\n"
2924 #| " "
2925 msgid ""
2926 "\n"
2927 "&lt;informalexample&gt;\n"
2928 " &lt;programlisting language=\"C\"&gt;\n"
2929 " ...\n"
2930 " &lt;/programlisting&gt;\n"
2931 "&lt;/informalexample&gt;\n"
2932 msgstr ""
2933 "\n"
2934 "\n"
2935 "&lt;informalexample&gt;\n"
2936 " &lt;programlisting&gt;\n"
2937 " ...\n"
2938 " &lt;/programlisting&gt;\n"
2939 "&lt;/informalexample&gt;\n"
2940 "\n"
2941 " "
2942
2943 #. (itstool) path: informalexample/programlisting
2944 #: C/index.docbook:1890
2945 #, no-wrap
2946 msgid ""
2947 "\n"
2948 "|[&lt;!-- language=\"C\" --&gt;\n"
2949 " ...\n"
2950 "]|\n"
2951 msgstr ""
2952
2953 #. (itstool) path: sect1/para
2954 #: C/index.docbook:1864
2955 #, fuzzy
2956 #| msgid ""
2957 #| "To include example code: <_:informalexample-1/> or possibly this, for "
2958 #| "very short code fragments which don't need a title: <_:informalexample-2/"
2959 #| "> For the latter GTK-Doc also supports an abbreviation: |[ ... ]|"
2960 msgid ""
2961 "To include example code: <_:informalexample-1/> or possibly this, for very "
2962 "short code fragments which don't need a title: <_:informalexample-2/> In "
2963 "both cases, the language attribute is optional and is used as a hint to the "
2964 "syntax highlighting engine (pygments for html output). For the latter GTK-"
2965 "Doc also supports an abbreviation: <_:informalexample-3/>"
2966 msgstr ""
2967 "要包含示例代码:<_:informalexample-1/> 或类似的,很短的不需要标题的代码段:"
2968 "<_:informalexample-2/> 对后者,GTK-Doc 还支持一种缩写方式:|[ ... ]|"
2969
2970 #. (itstool) path: informalexample/programlisting
2971 #: C/index.docbook:1901
2972 #, fuzzy, no-wrap
2973 #| msgid ""
2974 #| "\n"
2975 #| "\n"
2976 #| "&lt;itemizedlist&gt;\n"
2977 #| " &lt;listitem&gt;\n"
2978 #| " &lt;para&gt;\n"
2979 #| " ...\n"
2980 #| " &lt;/para&gt;\n"
2981 #| " &lt;/listitem&gt;\n"
2982 #| " &lt;listitem&gt;\n"
2983 #| " &lt;para&gt;\n"
2984 #| " ...\n"
2985 #| " &lt;/para&gt;\n"
2986 #| " &lt;/listitem&gt;\n"
2987 #| "&lt;/itemizedlist&gt;\n"
2988 #| "\n"
2989 #| " "
2990 msgid ""
2991 "\n"
2992 "&lt;itemizedlist&gt;\n"
2993 " &lt;listitem&gt;\n"
2994 " &lt;para&gt;\n"
2995 " ...\n"
2996 " &lt;/para&gt;\n"
2997 " &lt;/listitem&gt;\n"
2998 " &lt;listitem&gt;\n"
2999 " &lt;para&gt;\n"
3000 " ...\n"
3001 " &lt;/para&gt;\n"
3002 " &lt;/listitem&gt;\n"
3003 "&lt;/itemizedlist&gt;\n"
3004 msgstr ""
3005 "\n"
3006 "\n"
3007 "&lt;itemizedlist&gt;\n"
3008 " &lt;listitem&gt;\n"
3009 " &lt;para&gt;\n"
3010 " ...\n"
3011 " &lt;/para&gt;\n"
3012 " &lt;/listitem&gt;\n"
3013 " &lt;listitem&gt;\n"
3014 " &lt;para&gt;\n"
3015 " ...\n"
3016 " &lt;/para&gt;\n"
3017 " &lt;/listitem&gt;\n"
3018 "&lt;/itemizedlist&gt;\n"
3019 "\n"
3020 " "
3021
3022 #. (itstool) path: sect1/para
3023 #: C/index.docbook:1898
3024 msgid "To include bulleted lists: <_:informalexample-1/>"
3025 msgstr "要包含符号列表:<_:informalexample-1/>"
3026
3027 #. (itstool) path: informalexample/programlisting
3028 #: C/index.docbook:1921
3029 #, fuzzy, no-wrap
3030 #| msgid ""
3031 #| "\n"
3032 #| "\n"
3033 #| "&lt;note&gt;\n"
3034 #| " &lt;para&gt;\n"
3035 #| " Make sure you free the data after use.\n"
3036 #| " &lt;/para&gt;\n"
3037 #| "&lt;/note&gt;\n"
3038 #| "\n"
3039 #| " "
3040 msgid ""
3041 "\n"
3042 "&lt;note&gt;\n"
3043 " &lt;para&gt;\n"
3044 " Make sure you free the data after use.\n"
3045 " &lt;/para&gt;\n"
3046 "&lt;/note&gt;\n"
3047 msgstr ""
3048 "\n"
3049 "\n"
3050 "&lt;note&gt;\n"
3051 " &lt;para&gt;\n"
3052 " Make sure you free the data after use.\n"
3053 " &lt;/para&gt;\n"
3054 "&lt;/note&gt;\n"
3055 "\n"
3056 " "
3057
3058 #. (itstool) path: sect1/para
3059 #: C/index.docbook:1918
3060 msgid ""
3061 "To include a note which stands out from the text: <_:informalexample-1/>"
3062 msgstr "要包含一条文字中突出显示的注解:<_:informalexample-1/>"
3063
3064 #. (itstool) path: informalexample/programlisting
3065 #: C/index.docbook:1934
3066 #, fuzzy, no-wrap
3067 #| msgid ""
3068 #| "\n"
3069 #| "\n"
3070 #| "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3071 #| "\n"
3072 #| " "
3073 msgid ""
3074 "\n"
3075 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3076 msgstr ""
3077 "\n"
3078 "\n"
3079 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3080 "\n"
3081 " "
3082
3083 #. (itstool) path: sect1/para
3084 #: C/index.docbook:1931
3085 msgid "To refer to a type: <_:informalexample-1/>"
3086 msgstr "要引用一个类型:<_:informalexample-1/>"
3087
3088 #. (itstool) path: informalexample/programlisting
3089 #: C/index.docbook:1943
3090 #, fuzzy, no-wrap
3091 #| msgid ""
3092 #| "\n"
3093 #| "\n"
3094 #| "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3095 #| "\n"
3096 #| " "
3097 msgid ""
3098 "\n"
3099 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3100 msgstr ""
3101 "\n"
3102 "\n"
3103 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3104 "\n"
3105 " "
3106
3107 #. (itstool) path: sect1/para
3108 #: C/index.docbook:1940
3109 msgid ""
3110 "To refer to an external structure (not one described in the GTK docs): <_:"
3111 "informalexample-1/>"
3112 msgstr "引用一个外部结构(不是在GTK 文档中描述的):<_:informalexample-1/>"
3113
3114 #. (itstool) path: informalexample/programlisting
3115 #: C/index.docbook:1952
3116 #, fuzzy, no-wrap
3117 #| msgid ""
3118 #| "\n"
3119 #| "\n"
3120 #| "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3121 #| "\n"
3122 #| " "
3123 msgid ""
3124 "\n"
3125 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3126 msgstr ""
3127 "\n"
3128 "\n"
3129 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3130 "\n"
3131 " "
3132
3133 #. (itstool) path: sect1/para
3134 #: C/index.docbook:1949
3135 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3136 msgstr "要引用一个结构字段:<_:informalexample-1/>"
3137
3138 #. (itstool) path: informalexample/programlisting
3139 #: C/index.docbook:1961
3140 #, fuzzy, no-wrap
3141 #| msgid ""
3142 #| "\n"
3143 #| "\n"
3144 #| "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3145 #| "\n"
3146 #| " "
3147 msgid ""
3148 "\n"
3149 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3150 msgstr ""
3151 "\n"
3152 "\n"
3153 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3154 "\n"
3155 " "
3156
3157 #. (itstool) path: sect1/para
3158 #: C/index.docbook:1958
3159 msgid ""
3160 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3161 "you'll probably be using #GtkWidget instead (to automatically create a link "
3162 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3163 "abbreviations</link>)."
3164 msgstr ""
3165 "要引用一个类的名字,你可能会使用:<_:informalexample-1/> 但是你可能正在使用"
3166 "#GtkWidget(要自动创建一个到GtkWidget 页面的链接-请参阅<link linkend="
3167 "\"documenting_syntax\">缩写</link>)。"
3168
3169 #. (itstool) path: informalexample/programlisting
3170 #: C/index.docbook:1972
3171 #, fuzzy, no-wrap
3172 #| msgid ""
3173 #| "\n"
3174 #| "\n"
3175 #| "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3176 #| "\n"
3177 #| " "
3178 msgid ""
3179 "\n"
3180 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3181 msgstr ""
3182 "\n"
3183 "\n"
3184 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3185 "\n"
3186 " "
3187
3188 #. (itstool) path: sect1/para
3189 #: C/index.docbook:1969
3190 msgid "To emphasize text: <_:informalexample-1/>"
3191 msgstr "要强调文本:<_:informalexample-1/>"
3192
3193 #. (itstool) path: informalexample/programlisting
3194 #: C/index.docbook:1981
3195 #, fuzzy, no-wrap
3196 #| msgid ""
3197 #| "\n"
3198 #| "\n"
3199 #| "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3200 #| "\n"
3201 #| " "
3202 msgid ""
3203 "\n"
3204 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3205 msgstr ""
3206 "\n"
3207 "\n"
3208 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3209 "\n"
3210 " "
3211
3212 #. (itstool) path: sect1/para
3213 #: C/index.docbook:1978
3214 msgid "For filenames use: <_:informalexample-1/>"
3215 msgstr "对于文件名,使用:<_:informalexample-1/>"
3216
3217 #. (itstool) path: informalexample/programlisting
3218 #: C/index.docbook:1990
3219 #, fuzzy, no-wrap
3220 #| msgid ""
3221 #| "\n"
3222 #| "\n"
3223 #| "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3224 #| "\n"
3225 #| " "
3226 msgid ""
3227 "\n"
3228 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3229 msgstr ""
3230 "\n"
3231 "\n"
3232 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3233 "\n"
3234 " "
3235
3236 #. (itstool) path: sect1/para
3237 #: C/index.docbook:1987
3238 msgid "To refer to keys use: <_:informalexample-1/>"
3239 msgstr "要引用键值,使用:<_:informalexample-1/>"
3240
3241 #. (itstool) path: chapter/title
3242 #: C/index.docbook:2000
3243 msgid "Filling the extra files"
3244 msgstr "填充额外的文件"
3245
3246 #. (itstool) path: chapter/para
3247 #: C/index.docbook:2002
3248 msgid ""
3249 "There are a couple of extra files, that need to be maintained along with the "
3250 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3251 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3252 "<filename>&lt;package&gt;-sections.txt</filename>."
3253 msgstr ""
3254 "另有几个文件要和内嵌源代码注释一起维护:<filename>&lt;package&gt;.types</"
3255 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (原为 .sgml), "
3256 "<filename>&lt;package&gt;-sections.txt</filename>。"
3257
3258 #. (itstool) path: sect1/title
3259 #: C/index.docbook:2011
3260 msgid "Editing the types file"
3261 msgstr "编辑类型文件"
3262
3263 #. (itstool) path: sect1/para
3264 #: C/index.docbook:2013
3265 #, fuzzy
3266 msgid ""
3267 "If your library or application includes GObjects, you want their signals, "
3268 "arguments/parameters and position in the hierarchy to be shown in the "
3269 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3270 "function> functions together with their include inside the <filename>&lt;"
3271 "package&gt;.types</filename> file."
3272 msgstr ""
3273 "如果你的厍或应用程序包含了GtkObjects/GObjects,想把它们的信号,形式参数/实际"
3274 "参数以及在继承关系中所在位置都写入文档,只需将<function>xxx_get_type</"
3275 "function>及其引用在<filename>&lt;package&gt;.types</filename> 文件中列出。"
3276
3277 #. (itstool) path: example/title
3278 #: C/index.docbook:2022
3279 #, fuzzy
3280 #| msgid "&lt;package&gt;.types"
3281 msgid "Example &lt;package&gt;.types file"
3282 msgstr "&lt;package&gt;.types"
3283
3284 #. (itstool) path: example/programlisting
3285 #: C/index.docbook:2023
3286 #, fuzzy, no-wrap
3287 #| msgid ""
3288 #| "\n"
3289 #| "\n"
3290 #| "#include &lt;gtk/gtk.h&gt;\n"
3291 #| "\n"
3292 #| "gtk_accel_label_get_type\n"
3293 #| "gtk_adjustment_get_type\n"
3294 #| "gtk_alignment_get_type\n"
3295 #| "gtk_arrow_get_type\n"
3296 #| "\n"
3297 #| " "
3298 msgid ""
3299 "\n"
3300 "#include &lt;gtk/gtk.h&gt;\n"
3301 "\n"
3302 "gtk_accel_label_get_type\n"
3303 "gtk_adjustment_get_type\n"
3304 "gtk_alignment_get_type\n"
3305 "gtk_arrow_get_type\n"
3306 msgstr ""
3307 "\n"
3308 "\n"
3309 "#include &lt;gtk/gtk.h&gt;\n"
3310 "\n"
3311 "gtk_accel_label_get_type\n"
3312 "gtk_adjustment_get_type\n"
3313 "gtk_alignment_get_type\n"
3314 "gtk_arrow_get_type\n"
3315 "\n"
3316 " "
3317
3318 #. (itstool) path: sect1/para
3319 #: C/index.docbook:2034
3320 msgid ""
3321 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3322 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3323 "<filename>Makefile.am</filename>. If you use this approach you should not "
3324 "dist the types file nor have it under version control."
3325 msgstr ""
3326 "从GTK-Doc 1.8开始<application>gtkdoc-scan</application>能够自动生成这个列表。"
3327 "只要往<filename>Makefile.am</filename>文件中的SCAN_OPTIONS项加入“--rebuild-"
3328 "types”即可。如果你要使用它请保证不发行类型文件也不将它置于版本控制系统的管理"
3329 "之下。"
3330
3331 #. (itstool) path: sect1/title
3332 #: C/index.docbook:2043
3333 msgid "Editing the master document"
3334 msgstr "编辑主文档"
3335
3336 #. (itstool) path: sect1/para
3337 #: C/index.docbook:2045
3338 msgid ""
3339 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
3340 "inline source comments, the GTK-Doc tools generate one documentation page "
3341 "per class or module as a separate file. The master document includes them "
3342 "and place them in an order."
3343 msgstr ""
3344 "GTK-Doc 以 DocBook SGML/XML 格式生成文档。当处理源代码内嵌注释时, GTK-Doc 工"
3345 "具以独立文件为每个类或模块生成一个文档页。主文档包含了它们并且将它们按顺序排"
3346 "列。"
3347
3348 #. (itstool) path: sect1/para
3349 #: C/index.docbook:2052
3350 #, fuzzy
3351 #| msgid ""
3352 #| "While GTK-Doc creates a template master document for you, later run will "
3353 #| "not touch it again. This means that one can freely structure the "
3354 #| "documentation. That includes grouping pages and adding extra pages. GTK-"
3355 #| "Doc has now a test suite, where also the master-document is recreated "
3356 #| "from scratch. Its a good idea to look at this from time to time to see if "
3357 #| "there are some new goodies introduced there."
3358 msgid ""
3359 "While GTK-Doc creates a template master document for you, later runs will "
3360 "not touch it again. This means that one can freely structure the "
3361 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
3362 "has now a test suite, where also the master-document is recreated from "
3363 "scratch. Its a good idea to look at this from time to time to see if there "
3364 "are some new goodies introduced there."
3365 msgstr ""
3366 "GTK-Doc为你创建一个模板主文档,之后的运行就不会再动它了。这意味着你可以自由地"
3367 "组织这个文档,包括分组页和加入的额外页面。GTK-Doc现在有一个测试套件,它的主文"
3368 "档也重新生成。建议您经常关注它,又了解是否引入了新的功能特性。"
3369
3370 #. (itstool) path: tip/para
3371 #: C/index.docbook:2062
3372 msgid ""
3373 "Do not create tutorials as extra documents. Just write extra chapters. The "
3374 "benefit of directly embedding the tutorial for your library into the API "
3375 "documentation is that it is easy to link for the tutorial to symbol "
3376 "documentation. Apart chances are higher that the tutorial gets updates along "
3377 "with the library."
3378 msgstr ""
3379 "不要把教程(tutorial)当作额外的文档来编写。写成额外的章节即可。把你的库教程直"
3380 "接放入API文档的好处就是教程与符号文档之间的链接很容易。另外教程与库一同升级时"
3381 "分离的机会也更高。"
3382
3383 #. (itstool) path: sect1/para
3384 #: C/index.docbook:2071
3385 msgid ""
3386 "So what are the things to change inside the master document? For a start is "
3387 "only a little. There are some placeholders (text in square brackets) there "
3388 "which you should take care of."
3389 msgstr ""
3390 "那么什么是主文档内部要修改的东西呢?开始只是一点点东西。有一些占位标识(在方"
3391 "括号内部的文本)你应当多留意。"
3392
3393 #. (itstool) path: example/title
3394 #: C/index.docbook:2078
3395 msgid "Master document header"
3396 msgstr "主文档头部"
3397
3398 #. (itstool) path: example/programlisting
3399 #: C/index.docbook:2079
3400 #, fuzzy, no-wrap
3401 #| msgid ""
3402 #| "\n"
3403 #| "\n"
3404 #| "&lt;bookinfo&gt;\n"
3405 #| " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3406 #| " &lt;releaseinfo&gt;\n"
3407 #| " for MODULENAME [VERSION]\n"
3408 #| " The latest version of this documentation can be found on-line at\n"
3409 #| " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3410 #| " &lt;/releaseinfo&gt;\n"
3411 #| "&lt;/bookinfo&gt;\n"
3412 #| "\n"
3413 #| "&lt;chapter&gt;\n"
3414 #| " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3415 #| "\n"
3416 #| " "
3417 msgid ""
3418 "\n"
3419 "&lt;bookinfo&gt;\n"
3420 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3421 " &lt;releaseinfo&gt;\n"
3422 " for MODULENAME [VERSION]\n"
3423 " The latest version of this documentation can be found on-line at\n"
3424 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3425 " &lt;/releaseinfo&gt;\n"
3426 "&lt;/bookinfo&gt;\n"
3427 "\n"
3428 "&lt;chapter&gt;\n"
3429 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3430 msgstr ""
3431 "\n"
3432 "\n"
3433 "&lt;bookinfo&gt;\n"
3434 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3435 " &lt;releaseinfo&gt;\n"
3436 " for MODULENAME [VERSION]\n"
3437 " The latest version of this documentation can be found on-line at\n"
3438 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3439 " &lt;/releaseinfo&gt;\n"
3440 "&lt;/bookinfo&gt;\n"
3441 "\n"
3442 "&lt;chapter&gt;\n"
3443 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3444 "\n"
3445 " "
3446
3447 #. (itstool) path: sect1/para
3448 #: C/index.docbook:2095
3449 msgid ""
3450 "In addition a few option elements are created in commented form. You can "
3451 "review these and enable them as you like."
3452 msgstr ""
3453
3454 #. (itstool) path: example/title
3455 #: C/index.docbook:2101
3456 #, fuzzy
3457 #| msgid "Editing the master document"
3458 msgid "Optional part in the master document"
3459 msgstr "编辑主文档"
3460
3461 #. (itstool) path: example/programlisting
3462 #: C/index.docbook:2102
3463 #, no-wrap
3464 msgid ""
3465 "\n"
3466 " &lt;!-- enable this when you use gobject introspection annotations\n"
3467 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3468 " --&gt;\n"
3469 msgstr ""
3470
3471 #. (itstool) path: sect1/para
3472 #: C/index.docbook:2110
3473 msgid ""
3474 "Finally you need to add new section whenever you introduce one. The <link "
3475 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
3476 "you of newly generated xml files that are not yet included into the doc."
3477 msgstr ""
3478
3479 #. (itstool) path: example/title
3480 #: C/index.docbook:2118 C/index.docbook:2153
3481 msgid "Including generated sections"
3482 msgstr ""
3483
3484 #. (itstool) path: example/programlisting
3485 #: C/index.docbook:2119
3486 #, no-wrap
3487 msgid ""
3488 "\n"
3489 " &lt;chapter&gt;\n"
3490 " &lt;title&gt;my library&lt;/title&gt;\n"
3491 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3492 " ...\n"
3493 msgstr ""
3494
3495 #. (itstool) path: sect1/title
3496 #: C/index.docbook:2131
3497 msgid "Editing the section file"
3498 msgstr "编辑节文件(section file)"
3499
3500 #. (itstool) path: sect1/para
3501 #: C/index.docbook:2133
3502 msgid ""
3503 "The section file is used to organise the documentation output by GTK-Doc. "
3504 "Here one specifies which symbol belongs to which module or class and control "
3505 "the visibility (public or private)."
3506 msgstr ""
3507 "节文件用于组织由GTK-Doc输出的文档。在此你指定哪个符号属于哪个类或模块,并控制"
3508 "它是否可见(公共的或私有的)。"
3509
3510 #. (itstool) path: sect1/para
3511 #: C/index.docbook:2139
3512 #, fuzzy
3513 #| msgid ""
3514 #| "The section file is a plain test file with xml like syntax (using tags). "
3515 #| "Blank lines are ignored and lines starting with a '#' are treated as "
3516 #| "comment lines."
3517 msgid ""
3518 "The section file is a plain text file with tags delimiting sections. Blank "
3519 "lines are ignored and lines starting with a '#' are treated as comment lines."
3520 msgstr ""
3521 "节文件是一个类xml语法的纯文本文件(使用标记)。忽略空白行且以'#' 起始的行视为"
3522 "注释行。"
3523
3524 #. (itstool) path: note/para
3525 #: C/index.docbook:2146
3526 msgid ""
3527 "While the tags make the file look like xml, it is not. Please do not close "
3528 "tags like &lt;SUBSECTION&gt;."
3529 msgstr ""
3530
3531 #. (itstool) path: example/programlisting
3532 #: C/index.docbook:2154
3533 #, no-wrap
3534 msgid ""
3535 "\n"
3536 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3537 "\n"
3538 "&lt;SECTION&gt;\n"
3539 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3540 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3541 "MeepApp\n"
3542 "&lt;SUBSECTION Standard&gt;\n"
3543 "MEEP_APP\n"
3544 "...\n"
3545 "MeepAppClass\n"
3546 "meep_app_get_type\n"
3547 "&lt;/SECTION&gt;\n"
3548 msgstr ""
3549
3550 #. (itstool) path: sect1/para
3551 #: C/index.docbook:2171
3552 #, fuzzy
3553 #| msgid ""
3554 #| "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3555 #| "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3556 #| "FILE&gt;' will result in the section declarations being output in the "
3557 #| "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3558 #| "converted into the DocBook SGML/XML file <filename>sgml/gnome-config."
3559 #| "sgml</filename> or .DocBook XML file <filename>xml/gnome-config.xml</"
3560 #| "filename>. (The name of the html file is based on the module name and the "
3561 #| "section title, or for gobjects it is based on the gobjects class name "
3562 #| "converted to lower case)."
3563 msgid ""
3564 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3565 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3566 "FILE&gt;' will result in the section declarations being output in the "
3567 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3568 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
3569 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
3570 "(The name of the HTML file is based on the module name and the section "
3571 "title, or for GObjects it is based on the GObjects class name converted to "
3572 "lower case)."
3573 msgstr ""
3574 "&lt;FILE&gt; ... &lt;/FILE&gt;标记用于指定文件名,不加任何后缀。例如:用'&lt;"
3575 "FILE&gt;gnome-config&lt;/FILE&gt;' 会导致段落声明输出到模板文件"
3576 "<filename>tmpl/gnome-config.sgml</filename>中去,它将会转换为DocBook SGML/XML"
3577 "文件<filename>sgml/gnome-config.sgml</filename>或者 .DocBook XML文件"
3578 "<filename>xml/gnome-config.xml</filename>。(html文件的名字是基于模块名字与节"
3579 "标题形成的,或者对gobjects是基于转换为小写的gobjects类名字形成的。)"
3580
3581 #. (itstool) path: sect1/para
3582 #: C/index.docbook:2183
3583 msgid ""
3584 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3585 "section. It is only useful before the templates (if used) are initially "
3586 "created, since the title set in the template file overrides this. Also if "
3587 "one uses SECTION comment in the sources, this is obsolete."
3588 msgstr ""
3589 "&lt;TITLE&gt; ... &lt;/TITLE&gt;标记用于节的标题。它只在模板(如果使用的话)"
3590 "最初创建之前有用,因为设置在模板文件内的标题覆盖了它。或者如果你在源代码中使"
3591 "用了SECTION注释(此功能已过时)。"
3592
3593 #. (itstool) path: sect1/para
3594 #: C/index.docbook:2190
3595 msgid ""
3596 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3597 "Currently it outputs a blank line between subsections in the synopsis "
3598 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
3599 "declarations (e.g. the functions like g_object_get_type and macros like "
3600 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
3601 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
3602 "declarations which will not be output (it is a handy way to avoid warning "
3603 "messages about unused declarations). If your library contains private types "
3604 "which you don't want to appear in the object hierarchy and the list of "
3605 "implemented or required interfaces, add them to a Private subsection. "
3606 "Whether you would place GObject and GObjectClass like structs in public or "
3607 "Standard section depends if they have public entries (variables, vmethods)."
3608 msgstr ""
3609
3610 #. (itstool) path: sect1/para
3611 #: C/index.docbook:2209
3612 msgid ""
3613 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
3614 "#include files which are shown in the synopsis sections. It contains a comma-"
3615 "separate list of #include files, without the angle brackets. If you set it "
3616 "outside of any sections, it acts for all sections until the end of the file. "
3617 "If you set it within a section, it only applies to that section."
3618 msgstr ""
3619
3620 #. (itstool) path: chapter/title
3621 #: C/index.docbook:2223
3622 msgid "Controlling the result"
3623 msgstr "控制结果"
3624
3625 #. (itstool) path: chapter/para
3626 #: C/index.docbook:2225
3627 msgid ""
3628 "A GTK-Doc run generates report files inside the documentation directory. The "
3629 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3630 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3631 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3632 "files that can be viewed and postprocessed easily."
3633 msgstr ""
3634
3635 #. (itstool) path: chapter/para
3636 #: C/index.docbook:2234
3637 msgid ""
3638 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
3639 "the documentation coverage summary. Below are two sections divided by blank "
3640 "lines. The first section lists undocumented or incomplete symbols. The "
3641 "second section does the same for section docs. Incomplete entries are those, "
3642 "which have documentation, but where e.g. a new parameter has been added."
3643 msgstr ""
3644
3645 #. (itstool) path: chapter/para
3646 #: C/index.docbook:2243
3647 msgid ""
3648 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3649 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3650 "in the sources. Check if they have been removed or if they are misspelled."
3651 msgstr ""
3652
3653 #. (itstool) path: chapter/para
3654 #: C/index.docbook:2250
3655 msgid ""
3656 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3657 "where the GTK-Doc scanner has found documentation, but does not know where "
3658 "to put it. This means that the symbol has not yet been added to the "
3659 "<filename>&lt;package&gt;-sections.txt</filename> file."
3660 msgstr ""
3661
3662 #. (itstool) path: tip/para
3663 #: C/index.docbook:2258
3664 msgid ""
3665 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile."
3666 "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
3667 "<command>make check</command> run."
3668 msgstr ""
3669
3670 #. (itstool) path: chapter/para
3671 #: C/index.docbook:2265
3672 msgid ""
3673 "One can also look at the files produced by the source code scanner: "
3674 "<filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;"
3675 "package&gt;-decl.txt</filename>. The first one can be compared with the "
3676 "section file if that is manually maintained. The second lists all "
3677 "declarations from the headers. If a symbol is missing one could check if "
3678 "this file contains it."
3679 msgstr ""
3680
3681 #. (itstool) path: chapter/para
3682 #: C/index.docbook:2274
3683 msgid ""
3684 "If the project is GObject based, one can also look into the files produced "
3685 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3686 "<filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
3687 "package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
3688 "prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</"
3689 "filename>. If there are missing symbols in any of those, one can ask GTK-Doc "
3690 "to keep the intermediate scanner file for further analysis, by running it as "
3691 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3692 msgstr ""
3693
3694 #. (itstool) path: chapter/title
3695 #: C/index.docbook:2289
3696 msgid "Modernizing the documentation"
3697 msgstr "文档的现代化"
3698
3699 #. (itstool) path: chapter/para
3700 #: C/index.docbook:2291
3701 msgid ""
3702 "GTK-Doc has been around for quite some time. In this section we list new "
3703 "features together with the version since when it is available."
3704 msgstr ""
3705 "GTK-Doc 已经存在了一段时间。在本章节中,我们列出新出现的功能以及这些功能所对"
3706 "应的最低版本。"
3707
3708 #. (itstool) path: sect1/title
3709 #: C/index.docbook:2297
3710 msgid "GTK-Doc 1.9"
3711 msgstr "GTK-Doc 1.9"
3712
3713 #. (itstool) path: sect1/para
3714 #: C/index.docbook:2299
3715 msgid ""
3716 "When using xml instead of sgml, one can actually name the master document "
3717 "<filename>&lt;package&gt;-docs.xml</filename>."
3718 msgstr ""
3719
3720 #. (itstool) path: sect1/para
3721 #: C/index.docbook:2304
3722 msgid ""
3723 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3724 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
3725 "package&gt;-sections.txt</filename> is autogenerated and can be removed from "
3726 "the vcs. This only works nicely for projects that have a very regular "
3727 "structure (e.g. each .{c,h} pair will create new section). If one organize a "
3728 "project close to that updating a manually maintained section file can be as "
3729 "simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-"
3730 "sections.txt</code>."
3731 msgstr ""
3732
3733 #. (itstool) path: sect1/para
3734 #: C/index.docbook:2315
3735 msgid ""
3736 "Version 1.8 already introduced the syntax for documenting sections in the "
3737 "sources instead of the separate files under <filename class=\"directory"
3738 "\">tmpl</filename>. This version adds options to switch the whole doc module "
3739 "to not use the extra tmpl build step at all, by using <option>--flavour no-"
3740 "tmpl</option> in <filename>configure.ac</filename>. If you don't have a "
3741 "<filename class=\"directory\">tmpl</filename> checked into your source "
3742 "control system and haven't yet switched, just add the flag to "
3743 "<filename>configure.ac</filename> and you are done."
3744 msgstr ""
3745
3746 #. (itstool) path: sect1/title
3747 #: C/index.docbook:2327
3748 msgid "GTK-Doc 1.10"
3749 msgstr "GTK-Doc 1.10"
3750
3751 #. (itstool) path: sect1/para
3752 #: C/index.docbook:2329
3753 msgid ""
3754 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
3755 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
3756 "package&gt;.types</filename> is autogenerated and can be removed from the "
3757 "vcs. When using this feature it is important to also setup the "
3758 "<varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
3759 "code that is build conditionally."
3760 msgstr ""
3761
3762 #. (itstool) path: sect1/title
3763 #: C/index.docbook:2340
3764 msgid "GTK-Doc 1.16"
3765 msgstr "GTK-Doc 1.16"
3766
3767 #. (itstool) path: example/title
3768 #: C/index.docbook:2346
3769 msgid "Enable gtkdoc-check"
3770 msgstr ""
3771
3772 #. (itstool) path: example/programlisting
3773 #: C/index.docbook:2347
3774 #, no-wrap
3775 msgid ""
3776 "\n"
3777 "if ENABLE_GTK_DOC\n"
3778 "TESTS_ENVIRONMENT = \\\n"
3779 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3780 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3781 "TESTS = $(GTKDOC_CHECK)\n"
3782 "endif\n"
3783 msgstr ""
3784
3785 #. (itstool) path: sect1/para
3786 #: C/index.docbook:2342
3787 msgid ""
3788 "This version includes a new tool called gtkdoc-check. This tool can run a "
3789 "set of sanity checks on your documentation. It is enabled by adding these "
3790 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
3791 msgstr ""
3792
3793 #. (itstool) path: sect1/title
3794 #: C/index.docbook:2360
3795 msgid "GTK-Doc 1.20"
3796 msgstr "GTK-Doc 1.20"
3797
3798 #. (itstool) path: sect1/para
3799 #: C/index.docbook:2362
3800 msgid ""
3801 "Version 1.18 brought some initial markdown support. Using markdown in doc "
3802 "comments is less intrusive than writing docbook xml. This version improves a "
3803 "lot on this and add a lot more styles. The section that explains the <link "
3804 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
3805 msgstr ""
3806
3807 #. (itstool) path: sect1/title
3808 #: C/index.docbook:2372
3809 msgid "GTK-Doc 1.25"
3810 msgstr "GTK-Doc 1.25"
3811
3812 #. (itstool) path: example/title
3813 #: C/index.docbook:2383
3814 msgid "Use pre-generated entities"
3815 msgstr ""
3816
3817 #. (itstool) path: example/programlisting
3818 #: C/index.docbook:2384
3819 #, no-wrap
3820 msgid ""
3821 "\n"
3822 "&lt;?xml version=\"1.0\"?&gt;\n"
3823 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3824 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3825 "[\n"
3826 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3827 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3828 " %gtkdocentities;\n"
3829 "]&gt;\n"
3830 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3831 " &lt;bookinfo&gt;\n"
3832 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3833 " &lt;releaseinfo&gt;\n"
3834 " for &amp;package_string;.\n"
3835 " The latest version of this documentation can be found on-line at\n"
3836 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3837 " &lt;/releaseinfo&gt;\n"
3838 " &lt;/bookinfo&gt;\n"
3839 msgstr ""
3840
3841 #. (itstool) path: sect1/para
3842 #: C/index.docbook:2374
3843 msgid ""
3844 "The makefiles shipped with this version generate an entity file at "
3845 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
3846 "package_name and package_version. You can use this e.g. in the main xml file "
3847 "to avoid hardcoding the version number. Below is an example that shows how "
3848 "the entity file is included in the master template and how the entities are "
3849 "used. The entities can also be used in all generated files, GTK-Doc will use "
3850 "the same xml header in generated xml files. <_:example-1/>"
3851 msgstr ""
3852
3853 #. (itstool) path: chapter/title
3854 #: C/index.docbook:2409
3855 msgid "Documenting other interfaces"
3856 msgstr "为其它接口书写文档"
3857
3858 #. (itstool) path: chapter/para
3859 #: C/index.docbook:2411
3860 msgid ""
3861 "So far we have been using GTK-Doc to document the API of code. The next "
3862 "sections contain suggestions how the tools can be used to document other "
3863 "interfaces too."
3864 msgstr ""
3865
3866 #. (itstool) path: sect1/title
3867 #: C/index.docbook:2418
3868 msgid "Command line options and man pages"
3869 msgstr "命令行选项与 man 页面"
3870
3871 #. (itstool) path: sect1/para
3872 #: C/index.docbook:2420
3873 msgid ""
3874 "As one can generate man pages for a docbook refentry as well, it sounds like "
3875 "a good idea to use it for that purpose. This way the interface is part of "
3876 "the reference and one gets the man-page for free."
3877 msgstr ""
3878
3879 #. (itstool) path: sect2/title
3880 #: C/index.docbook:2427
3881 msgid "Document the tool"
3882 msgstr "为工具书写文档"
3883
3884 #. (itstool) path: sect2/para
3885 #: C/index.docbook:2429
3886 msgid ""
3887 "Create one refentry file per tool. Following <link linkend="
3888 "\"settingup_docfiles\">our example</link> we would call it <filename>meep/"
3889 "docs/reference/meeper/meep.xml</filename>. For the xml tags that should be "
3890 "used and can look at generated file in the xml subdirectory as well as "
3891 "examples e.g. in glib."
3892 msgstr ""
3893
3894 #. (itstool) path: sect2/title
3895 #: C/index.docbook:2439
3896 msgid "Adding the extra configure check"
3897 msgstr "添加额外的配置检查"
3898
3899 #. (itstool) path: example/title
3900 #: C/index.docbook:2442 C/index.docbook:2460
3901 msgid "Extra configure checks"
3902 msgstr "额外的配置检查"
3903
3904 #. (itstool) path: example/programlisting
3905 #: C/index.docbook:2443
3906 #, no-wrap
3907 msgid ""
3908 "\n"
3909 "AC_ARG_ENABLE(man,\n"
3910 " [AC_HELP_STRING([--enable-man],\n"
3911 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
3912 " enable_man=no)\n"
3913 "\n"
3914 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
3915 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
3916 msgstr ""
3917
3918 #. (itstool) path: sect2/title
3919 #: C/index.docbook:2457
3920 msgid "Adding the extra makefile rules"
3921 msgstr "添加额外的makefile规则"
3922
3923 #. (itstool) path: example/programlisting
3924 #: C/index.docbook:2461
3925 #, no-wrap
3926 msgid ""
3927 "\n"
3928 "man_MANS = \\\n"
3929 " meeper.1\n"
3930 "\n"
3931 "if ENABLE_GTK_DOC\n"
3932 "if ENABLE_MAN\n"
3933 "\n"
3934 "%.1 : %.xml\n"
3935 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
3936 "\n"
3937 "endif\n"
3938 "endif\n"
3939 "\n"
3940 "BUILT_EXTRA_DIST = $(man_MANS)\n"
3941 "EXTRA_DIST += meep.xml\n"
3942 msgstr ""
3943 "\n"
3944 "man_MANS = \\\n"
3945 " meeper.1\n"
3946 "\n"
3947 "if ENABLE_GTK_DOC\n"
3948 "if ENABLE_MAN\n"
3949 "\n"
3950 "%.1 : %.xml\n"
3951 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
3952 "\n"
3953 "endif\n"
3954 "endif\n"
3955 "\n"
3956 "BUILT_EXTRA_DIST = $(man_MANS)\n"
3957 "EXTRA_DIST += meep.xml\n"
3958
3959 #. (itstool) path: sect1/title
3960 #: C/index.docbook:2483
3961 msgid "DBus interfaces"
3962 msgstr "DBus接口"
3963
3964 #. (itstool) path: sect1/para
3965 #: C/index.docbook:2485
3966 msgid ""
3967 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
3968 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
3969 msgstr ""
3970
3971 #. (itstool) path: chapter/title
3972 #: C/index.docbook:2494
3973 msgid "Frequently asked questions"
3974 msgstr "常见问题"
3975
3976 #. (itstool) path: segmentedlist/segtitle
3977 #: C/index.docbook:2498
3978 msgid "Question"
3979 msgstr "问题"
3980
3981 #. (itstool) path: segmentedlist/segtitle
3982 #: C/index.docbook:2499
3983 msgid "Answer"
3984 msgstr "答案"
3985
3986 #. (itstool) path: seglistitem/seg
3987 #: C/index.docbook:2501
3988 msgid "No class hierarchy."
3989 msgstr "无类继承关系。"
3990
3991 #. (itstool) path: seglistitem/seg
3992 #: C/index.docbook:2502
3993 msgid ""
3994 "The objects <function>xxx_get_type()</function> function has not been "
3995 "entered into the <filename>&lt;package&gt;.types</filename> file."
3996 msgstr ""
3997 "对象的 <function>xxx_get_type()</function> 函数未进入 <filename>&lt;"
3998 "package&gt;.types</filename> 文件。"
3999
4000 #. (itstool) path: seglistitem/seg
4001 #: C/index.docbook:2508
4002 msgid "Still no class hierarchy."
4003 msgstr "仍无类继承关系。"
4004
4005 #. (itstool) path: seglistitem/seg
4006 #: C/index.docbook:2509
4007 msgid ""
4008 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4009 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4010 "October/msg00006.html\">explanation</ulink>)."
4011 msgstr ""
4012
4013 #. (itstool) path: seglistitem/seg
4014 #: C/index.docbook:2515
4015 msgid "Damn, I have still no class hierarchy."
4016 msgstr "该死,我仍然没有类继承关系。"
4017
4018 #. (itstool) path: seglistitem/seg
4019 #: C/index.docbook:2516
4020 msgid ""
4021 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
4022 "type>) part of the normal section (don't put this into Standard or Private "
4023 "subsections)."
4024 msgstr ""
4025
4026 #. (itstool) path: seglistitem/seg
4027 #: C/index.docbook:2523
4028 msgid "No symbol index."
4029 msgstr "无标识符索引。"
4030
4031 #. (itstool) path: seglistitem/seg
4032 #: C/index.docbook:2524
4033 msgid ""
4034 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
4035 "index that xi:includes the generated index?"
4036 msgstr ""
4037
4038 #. (itstool) path: seglistitem/seg
4039 #: C/index.docbook:2530
4040 msgid "Symbols are not linked to their doc-section."
4041 msgstr ""
4042
4043 #. (itstool) path: seglistitem/seg
4044 #: C/index.docbook:2531
4045 msgid ""
4046 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4047 "gtkdoc-fixxref warns about unresolvable xrefs."
4048 msgstr ""
4049
4050 #. (itstool) path: seglistitem/seg
4051 #: C/index.docbook:2537
4052 msgid "A new class does not appear in the docs."
4053 msgstr ""
4054
4055 #. (itstool) path: seglistitem/seg
4056 #: C/index.docbook:2538
4057 msgid ""
4058 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4059 "filename>."
4060 msgstr ""
4061
4062 #. (itstool) path: seglistitem/seg
4063 #: C/index.docbook:2544
4064 msgid "A new symbol does not appear in the docs."
4065 msgstr ""
4066
4067 #. (itstool) path: seglistitem/seg
4068 #: C/index.docbook:2545
4069 msgid ""
4070 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4071 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4072 "xrefs. Check if the symbol is correctly listed in the <filename>&lt;"
4073 "package&gt;-sections.txt</filename> in a public subsection."
4074 msgstr ""
4075
4076 #. (itstool) path: seglistitem/seg
4077 #: C/index.docbook:2553
4078 msgid "A type is missing from the class hierarchy."
4079 msgstr ""
4080
4081 #. (itstool) path: seglistitem/seg
4082 #: C/index.docbook:2554
4083 msgid ""
4084 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4085 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4086 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4087 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
4088 "or incidentally marked private it will not be shown."
4089 msgstr ""
4090
4091 #. (itstool) path: seglistitem/seg
4092 #: C/index.docbook:2563
4093 msgid "I get foldoc links for all gobject annotations."
4094 msgstr ""
4095
4096 #. (itstool) path: seglistitem/seg
4097 #: C/index.docbook:2564
4098 msgid ""
4099 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4100 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4101 msgstr ""
4102
4103 #. (itstool) path: seglistitem/seg
4104 #: C/index.docbook:2572
4105 msgid "Parameter described in source code comment block but does not exist"
4106 msgstr ""
4107
4108 #. (itstool) path: seglistitem/seg
4109 #: C/index.docbook:2573
4110 msgid ""
4111 "Check if the prototype in the header has different parameter names as in the "
4112 "source."
4113 msgstr ""
4114
4115 #. (itstool) path: seglistitem/seg
4116 #: C/index.docbook:2578
4117 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4118 msgstr ""
4119
4120 #. (itstool) path: seglistitem/seg
4121 #: C/index.docbook:2579
4122 msgid ""
4123 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
4124 "filename> file."
4125 msgstr ""
4126
4127 #. (itstool) path: seglistitem/seg
4128 #: C/index.docbook:2582
4129 msgid ""
4130 "Element typename in namespace '' encountered in para, but no template "
4131 "matches."
4132 msgstr ""
4133
4134 #. (itstool) path: chapter/title
4135 #: C/index.docbook:2589
4136 msgid "Tools related to gtk-doc"
4137 msgstr ""
4138
4139 #. (itstool) path: chapter/para
4140 #: C/index.docbook:2591
4141 msgid ""
4142 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4143 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4144 "integrates with the trac search."
4145 msgstr ""
4146
4147 #. (itstool) path: chapter/para
4148 #: C/index.docbook:2596
4149 msgid ""
4150 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
4151 "tags in the API to determine the minimum required version."
4152 msgstr ""
4153
4154 #. (itstool) path: appendixinfo/releaseinfo
4155 #: C/index.docbook:12 C/fdl-appendix.xml:12
4156 msgid "Version 1.1, March 2000"
4157 msgstr ""
4158
4159 #. (itstool) path: appendixinfo/copyright
4160 #: C/index.docbook:15
4161 msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
4162 msgstr "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
4163
4164 #. (itstool) path: para/address
4165 #: C/index.docbook:20
4166 #, no-wrap
4167 msgid ""
4168 "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
4169 " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
4170 " <postcode>02110-1301</postcode> <country>USA</country>"
4171 msgstr ""
4172
4173 #. (itstool) path: legalnotice/para
4174 #: C/index.docbook:19 C/fdl-appendix.xml:19
4175 msgid ""
4176 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
4177 "of this license document, but changing it is not allowed."
4178 msgstr ""
4179
4180 #. (itstool) path: appendix/title
4181 #. (itstool) path: para/quote
4182 #: C/index.docbook:28 C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4183 msgid "GNU Free Documentation License"
4184 msgstr "GNU 自由文档许可证"
4185
4186 #. (itstool) path: sect1/title
4187 #: C/index.docbook:31 C/fdl-appendix.xml:31
4188 msgid "0. PREAMBLE"
4189 msgstr ""
4190
4191 #. (itstool) path: sect1/para
4192 #: C/index.docbook:32
4193 msgid ""
4194 "The purpose of this License is to make a manual, textbook, or other written "
4195 "document <quote>free</quote> in the sense of freedom: to assure everyone the "
4196 "effective freedom to copy and redistribute it, with or without modifying it, "
4197 "either commercially or noncommercially. Secondarily, this License preserves "
4198 "for the author and publisher a way to get credit for their work, while not "
4199 "being considered responsible for modifications made by others."
4200 msgstr ""
4201
4202 #. (itstool) path: sect1/para
4203 #: C/index.docbook:43
4204 msgid ""
4205 "This License is a kind of <quote>copyleft</quote>, which means that "
4206 "derivative works of the document must themselves be free in the same sense. "
4207 "It complements the GNU General Public License, which is a copyleft license "
4208 "designed for free software."
4209 msgstr ""
4210
4211 #. (itstool) path: sect1/para
4212 #: C/index.docbook:50 C/fdl-appendix.xml:50
4213 msgid ""
4214 "We have designed this License in order to use it for manuals for free "
4215 "software, because free software needs free documentation: a free program "
4216 "should come with manuals providing the same freedoms that the software does. "
4217 "But this License is not limited to software manuals; it can be used for any "
4218 "textual work, regardless of subject matter or whether it is published as a "
4219 "printed book. We recommend this License principally for works whose purpose "
4220 "is instruction or reference."
4221 msgstr ""
4222
4223 #. (itstool) path: sect1/title
4224 #: C/index.docbook:62 C/fdl-appendix.xml:62
4225 msgid "1. APPLICABILITY AND DEFINITIONS"
4226 msgstr ""
4227
4228 #. (itstool) path: sect1/para
4229 #: C/index.docbook:63
4230 msgid ""
4231 "This License applies to any manual or other work that contains a notice "
4232 "placed by the copyright holder saying it can be distributed under the terms "
4233 "of this License. The <quote>Document</quote>, below, refers to any such "
4234 "manual or work. Any member of the public is a licensee, and is addressed as "
4235 "<quote>you</quote>."
4236 msgstr ""
4237
4238 #. (itstool) path: sect1/para
4239 #: C/index.docbook:72
4240 msgid ""
4241 "A <quote>Modified Version</quote> of the Document means any work containing "
4242 "the Document or a portion of it, either copied verbatim, or with "
4243 "modifications and/or translated into another language."
4244 msgstr ""
4245
4246 #. (itstool) path: sect1/para
4247 #: C/index.docbook:79
4248 msgid ""
4249 "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
4250 "section of the <link linkend=\"fdl-document\">Document</link> that deals "
4251 "exclusively with the relationship of the publishers or authors of the "
4252 "Document to the Document's overall subject (or to related matters) and "
4253 "contains nothing that could fall directly within that overall subject. (For "
4254 "example, if the Document is in part a textbook of mathematics, a Secondary "
4255 "Section may not explain any mathematics.) The relationship could be a matter "
4256 "of historical connection with the subject or with related matters, or of "
4257 "legal, commercial, philosophical, ethical or political position regarding "
4258 "them."
4259 msgstr ""
4260
4261 #. (itstool) path: sect1/para
4262 #: C/index.docbook:94
4263 msgid ""
4264 "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
4265 "secondary\"> Secondary Sections</link> whose titles are designated, as being "
4266 "those of Invariant Sections, in the notice that says that the <link linkend="
4267 "\"fdl-document\">Document</link> is released under this License."
4268 msgstr ""
4269
4270 #. (itstool) path: sect1/para
4271 #: C/index.docbook:103
4272 msgid ""
4273 "The <quote>Cover Texts</quote> are certain short passages of text that are "
4274 "listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says "
4275 "that the <link linkend=\"fdl-document\">Document</link> is released under "
4276 "this License."
4277 msgstr ""
4278
4279 #. (itstool) path: sect1/para
4280 #: C/index.docbook:111
4281 msgid ""
4282 "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
4283 "Document</link> means a machine-readable copy, represented in a format whose "
4284 "specification is available to the general public, whose contents can be "
4285 "viewed and edited directly and straightforwardly with generic text editors "
4286 "or (for images composed of pixels) generic paint programs or (for drawings) "
4287 "some widely available drawing editor, and that is suitable for input to text "
4288 "formatters or for automatic translation to a variety of formats suitable for "
4289 "input to text formatters. A copy made in an otherwise Transparent file "
4290 "format whose markup has been designed to thwart or discourage subsequent "
4291 "modification by readers is not Transparent. A copy that is not "
4292 "<quote>Transparent</quote> is called <quote>Opaque</quote>."
4293 msgstr ""
4294
4295 #. (itstool) path: sect1/para
4296 #: C/index.docbook:128 C/fdl-appendix.xml:128
4297 msgid ""
4298 "Examples of suitable formats for Transparent copies include plain ASCII "
4299 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
4300 "a publicly available DTD, and standard-conforming simple HTML designed for "
4301 "human modification. Opaque formats include PostScript, PDF, proprietary "
4302 "formats that can be read and edited only by proprietary word processors, "
4303 "SGML or XML for which the DTD and/or processing tools are not generally "
4304 "available, and the machine-generated HTML produced by some word processors "
4305 "for output purposes only."
4306 msgstr ""
4307
4308 #. (itstool) path: sect1/para
4309 #: C/index.docbook:141
4310 msgid ""
4311 "The <quote>Title Page</quote> means, for a printed book, the title page "
4312 "itself, plus such following pages as are needed to hold, legibly, the "
4313 "material this License requires to appear in the title page. For works in "
4314 "formats which do not have any title page as such, <quote>Title Page</quote> "
4315 "means the text near the most prominent appearance of the work's title, "
4316 "preceding the beginning of the body of the text."
4317 msgstr ""
4318
4319 #. (itstool) path: sect1/title
4320 #: C/index.docbook:153 C/fdl-appendix.xml:153
4321 msgid "2. VERBATIM COPYING"
4322 msgstr ""
4323
4324 #. (itstool) path: sect1/para
4325 #: C/index.docbook:154
4326 msgid ""
4327 "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
4328 "link> in any medium, either commercially or noncommercially, provided that "
4329 "this License, the copyright notices, and the license notice saying this "
4330 "License applies to the Document are reproduced in all copies, and that you "
4331 "add no other conditions whatsoever to those of this License. You may not use "
4332 "technical measures to obstruct or control the reading or further copying of "
4333 "the copies you make or distribute. However, you may accept compensation in "
4334 "exchange for copies. If you distribute a large enough number of copies you "
4335 "must also follow the conditions in <link linkend=\"fdl-section3\">section 3</"
4336 "link>."
4337 msgstr ""
4338
4339 #. (itstool) path: sect1/para
4340 #: C/index.docbook:169 C/fdl-appendix.xml:169
4341 msgid ""
4342 "You may also lend copies, under the same conditions stated above, and you "
4343 "may publicly display copies."
4344 msgstr ""
4345
4346 #. (itstool) path: sect1/title
4347 #: C/index.docbook:176 C/fdl-appendix.xml:176
4348 msgid "3. COPYING IN QUANTITY"
4349 msgstr ""
4350
4351 #. (itstool) path: sect1/para
4352 #: C/index.docbook:177
4353 msgid ""
4354 "If you publish printed copies of the <link linkend=\"fdl-document"
4355 "\">Document</link> numbering more than 100, and the Document's license "
4356 "notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</link>, you "
4357 "must enclose the copies in covers that carry, clearly and legibly, all these "
4358 "Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on "
4359 "the back cover. Both covers must also clearly and legibly identify you as "
4360 "the publisher of these copies. The front cover must present the full title "
4361 "with all words of the title equally prominent and visible. You may add other "
4362 "material on the covers in addition. Copying with changes limited to the "
4363 "covers, as long as they preserve the title of the <link linkend=\"fdl-"
4364 "document\">Document</link> and satisfy these conditions, can be treated as "
4365 "verbatim copying in other respects."
4366 msgstr ""
4367
4368 #. (itstool) path: sect1/para
4369 #: C/index.docbook:195 C/fdl-appendix.xml:195
4370 msgid ""
4371 "If the required texts for either cover are too voluminous to fit legibly, "
4372 "you should put the first ones listed (as many as fit reasonably) on the "
4373 "actual cover, and continue the rest onto adjacent pages."
4374 msgstr ""
4375
4376 #. (itstool) path: sect1/para
4377 #: C/index.docbook:202
4378 msgid ""
4379 "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</link> "
4380 "copies of the <link linkend=\"fdl-document\">Document</link> numbering more "
4381 "than 100, you must either include a machine-readable <link linkend=\"fdl-"
4382 "transparent\">Transparent</link> copy along with each Opaque copy, or state "
4383 "in or with each Opaque copy a publicly-accessible computer-network location "
4384 "containing a complete Transparent copy of the Document, free of added "
4385 "material, which the general network-using public has access to download "
4386 "anonymously at no charge using public-standard network protocols. If you use "
4387 "the latter option, you must take reasonably prudent steps, when you begin "
4388 "distribution of Opaque copies in quantity, to ensure that this Transparent "
4389 "copy will remain thus accessible at the stated location until at least one "
4390 "year after the last time you distribute an Opaque copy (directly or through "
4391 "your agents or retailers) of that edition to the public."
4392 msgstr ""
4393
4394 #. (itstool) path: sect1/para
4395 #: C/index.docbook:222
4396 msgid ""
4397 "It is requested, but not required, that you contact the authors of the <link "
4398 "linkend=\"fdl-document\">Document</link> well before redistributing any "
4399 "large number of copies, to give them a chance to provide you with an updated "
4400 "version of the Document."
4401 msgstr ""
4402
4403 #. (itstool) path: sect1/title
4404 #: C/index.docbook:231 C/fdl-appendix.xml:231
4405 msgid "4. MODIFICATIONS"
4406 msgstr "4. 修改"
4407
4408 #. (itstool) path: sect1/para
4409 #: C/index.docbook:232
4410 msgid ""
4411 "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
4412 "Version</link> of the <link linkend=\"fdl-document\">Document</link> under "
4413 "the conditions of sections <link linkend=\"fdl-section2\">2</link> and <link "
4414 "linkend=\"fdl-section3\">3</link> above, provided that you release the "
4415 "Modified Version under precisely this License, with the Modified Version "
4416 "filling the role of the Document, thus licensing distribution and "
4417 "modification of the Modified Version to whoever possesses a copy of it. In "
4418 "addition, you must do these things in the Modified Version:"
4419 msgstr ""
4420
4421 #. (itstool) path: formalpara/title
4422 #: C/index.docbook:248 C/fdl-appendix.xml:248
4423 msgid "A"
4424 msgstr "A"
4425
4426 #. (itstool) path: formalpara/para
4427 #: C/index.docbook:249
4428 msgid ""
4429 "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
4430 "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
4431 "document\">Document</link>, and from those of previous versions (which "
4432 "should, if there were any, be listed in the History section of the "
4433 "Document). You may use the same title as a previous version if the original "
4434 "publisher of that version gives permission."
4435 msgstr ""
4436
4437 #. (itstool) path: formalpara/title
4438 #: C/index.docbook:264 C/fdl-appendix.xml:264
4439 msgid "B"
4440 msgstr "B"
4441
4442 #. (itstool) path: formalpara/para
4443 #: C/index.docbook:265
4444 msgid ""
4445 "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as authors, "
4446 "one or more persons or entities responsible for authorship of the "
4447 "modifications in the <link linkend=\"fdl-modified\">Modified Version</link>, "
4448 "together with at least five of the principal authors of the <link linkend="
4449 "\"fdl-document\">Document</link> (all of its principal authors, if it has "
4450 "less than five)."
4451 msgstr ""
4452
4453 #. (itstool) path: formalpara/title
4454 #: C/index.docbook:279 C/fdl-appendix.xml:279
4455 msgid "C"
4456 msgstr "C"
4457
4458 #. (itstool) path: formalpara/para
4459 #: C/index.docbook:280
4460 msgid ""
4461 "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name of "
4462 "the publisher of the <link linkend=\"fdl-modified\">Modified Version</link>, "
4463 "as the publisher."
4464 msgstr ""
4465
4466 #. (itstool) path: formalpara/title
4467 #: C/index.docbook:291 C/fdl-appendix.xml:291
4468 msgid "D"
4469 msgstr "D"
4470
4471 #. (itstool) path: formalpara/para
4472 #: C/index.docbook:292
4473 msgid ""
4474 "Preserve all the copyright notices of the <link linkend=\"fdl-document"
4475 "\">Document</link>."
4476 msgstr ""
4477
4478 #. (itstool) path: formalpara/title
4479 #: C/index.docbook:301 C/fdl-appendix.xml:301
4480 msgid "E"
4481 msgstr "E"
4482
4483 #. (itstool) path: formalpara/para
4484 #: C/index.docbook:302 C/fdl-appendix.xml:302
4485 msgid ""
4486 "Add an appropriate copyright notice for your modifications adjacent to the "
4487 "other copyright notices."
4488 msgstr ""
4489
4490 #. (itstool) path: formalpara/title
4491 #: C/index.docbook:311 C/fdl-appendix.xml:311
4492 msgid "F"
4493 msgstr "F"
4494
4495 #. (itstool) path: formalpara/para
4496 #: C/index.docbook:312
4497 msgid ""
4498 "Include, immediately after the copyright notices, a license notice giving "
4499 "the public permission to use the <link linkend=\"fdl-modified\">Modified "
4500 "Version</link> under the terms of this License, in the form shown in the "
4501 "Addendum below."
4502 msgstr ""
4503
4504 #. (itstool) path: formalpara/title
4505 #: C/index.docbook:324 C/fdl-appendix.xml:324
4506 msgid "G"
4507 msgstr "G"
4508
4509 #. (itstool) path: formalpara/para
4510 #: C/index.docbook:325
4511 msgid ""
4512 "Preserve in that license notice the full lists of <link linkend=\"fdl-"
4513 "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
4514 "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-document"
4515 "\">Document's</link> license notice."
4516 msgstr ""
4517
4518 #. (itstool) path: formalpara/title
4519 #: C/index.docbook:337 C/fdl-appendix.xml:337
4520 msgid "H"
4521 msgstr "H"
4522
4523 #. (itstool) path: formalpara/para
4524 #: C/index.docbook:338 C/fdl-appendix.xml:338
4525 msgid "Include an unaltered copy of this License."
4526 msgstr ""
4527
4528 #. (itstool) path: formalpara/title
4529 #: C/index.docbook:346 C/fdl-appendix.xml:346
4530 msgid "I"
4531 msgstr "I"
4532
4533 #. (itstool) path: formalpara/para
4534 #: C/index.docbook:347
4535 msgid ""
4536 "Preserve the section entitled <quote>History</quote>, and its title, and add "
4537 "to it an item stating at least the title, year, new authors, and publisher "
4538 "of the <link linkend=\"fdl-modified\">Modified Version</link> as given on "
4539 "the <link linkend=\"fdl-title-page\">Title Page</link>. If there is no "
4540 "section entitled <quote>History</quote> in the <link linkend=\"fdl-document"
4541 "\">Document</link>, create one stating the title, year, authors, and "
4542 "publisher of the Document as given on its Title Page, then add an item "
4543 "describing the Modified Version as stated in the previous sentence."
4544 msgstr ""
4545
4546 #. (itstool) path: formalpara/title
4547 #: C/index.docbook:365 C/fdl-appendix.xml:365
4548 msgid "J"
4549 msgstr "J"
4550
4551 #. (itstool) path: formalpara/para
4552 #: C/index.docbook:366
4553 msgid ""
4554 "Preserve the network location, if any, given in the <link linkend=\"fdl-"
4555 "document\">Document</link> for public access to a <link linkend=\"fdl-"
4556 "transparent\">Transparent</link> copy of the Document, and likewise the "
4557 "network locations given in the Document for previous versions it was based "
4558 "on. These may be placed in the <quote>History</quote> section. You may omit "
4559 "a network location for a work that was published at least four years before "
4560 "the Document itself, or if the original publisher of the version it refers "
4561 "to gives permission."
4562 msgstr ""
4563
4564 #. (itstool) path: formalpara/title
4565 #: C/index.docbook:383 C/fdl-appendix.xml:383
4566 msgid "K"
4567 msgstr "K"
4568
4569 #. (itstool) path: formalpara/para
4570 #: C/index.docbook:384
4571 msgid ""
4572 "In any section entitled <quote>Acknowledgements</quote> or "
4573 "<quote>Dedications</quote>, preserve the section's title, and preserve in "
4574 "the section all the substance and tone of each of the contributor "
4575 "acknowledgements and/or dedications given therein."
4576 msgstr ""
4577
4578 #. (itstool) path: formalpara/title
4579 #: C/index.docbook:396 C/fdl-appendix.xml:396
4580 msgid "L"
4581 msgstr "L"
4582
4583 #. (itstool) path: formalpara/para
4584 #: C/index.docbook:397
4585 msgid ""
4586 "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</link> "
4587 "of the <link linkend=\"fdl-document\">Document</link>, unaltered in their "
4588 "text and in their titles. Section numbers or the equivalent are not "
4589 "considered part of the section titles."
4590 msgstr ""
4591
4592 #. (itstool) path: formalpara/title
4593 #: C/index.docbook:409 C/fdl-appendix.xml:409
4594 msgid "M"
4595 msgstr "M"
4596
4597 #. (itstool) path: formalpara/para
4598 #: C/index.docbook:410
4599 msgid ""
4600 "Delete any section entitled <quote>Endorsements</quote>. Such a section may "
4601 "not be included in the <link linkend=\"fdl-modified\">Modified Version</"
4602 "link>."
4603 msgstr ""
4604
4605 #. (itstool) path: formalpara/title
4606 #: C/index.docbook:421 C/fdl-appendix.xml:421
4607 msgid "N"
4608 msgstr "N"
4609
4610 #. (itstool) path: formalpara/para
4611 #: C/index.docbook:422
4612 msgid ""
4613 "Do not retitle any existing section as <quote>Endorsements</quote> or to "
4614 "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
4615 "Section</link>."
4616 msgstr ""
4617
4618 #. (itstool) path: sect1/para
4619 #: C/index.docbook:432
4620 msgid ""
4621 "If the <link linkend=\"fdl-modified\">Modified Version</link> includes new "
4622 "front-matter sections or appendices that qualify as <link linkend=\"fdl-"
4623 "secondary\">Secondary Sections</link> and contain no material copied from "
4624 "the Document, you may at your option designate some or all of these sections "
4625 "as invariant. To do this, add their titles to the list of <link linkend="
4626 "\"fdl-invariant\">Invariant Sections</link> in the Modified Version's "
4627 "license notice. These titles must be distinct from any other section titles."
4628 msgstr ""
4629
4630 #. (itstool) path: sect1/para
4631 #: C/index.docbook:444
4632 msgid ""
4633 "You may add a section entitled <quote>Endorsements</quote>, provided it "
4634 "contains nothing but endorsements of your <link linkend=\"fdl-modified"
4635 "\">Modified Version</link> by various parties--for example, statements of "
4636 "peer review or that the text has been approved by an organization as the "
4637 "authoritative definition of a standard."
4638 msgstr ""
4639
4640 #. (itstool) path: sect1/para
4641 #: C/index.docbook:453
4642 msgid ""
4643 "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
4644 "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a <link "
4645 "linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of the list "
4646 "of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the <link linkend="
4647 "\"fdl-modified\">Modified Version</link>. Only one passage of Front-Cover "
4648 "Text and one of Back-Cover Text may be added by (or through arrangements "
4649 "made by) any one entity. If the <link linkend=\"fdl-document\">Document</"
4650 "link> already includes a cover text for the same cover, previously added by "
4651 "you or by arrangement made by the same entity you are acting on behalf of, "
4652 "you may not add another; but you may replace the old one, on explicit "
4653 "permission from the previous publisher that added the old one."
4654 msgstr ""
4655
4656 #. (itstool) path: sect1/para
4657 #: C/index.docbook:470
4658 msgid ""
4659 "The author(s) and publisher(s) of the <link linkend=\"fdl-document"
4660 "\">Document</link> do not by this License give permission to use their names "
4661 "for publicity for or to assert or imply endorsement of any <link linkend="
4662 "\"fdl-modified\">Modified Version </link>."
4663 msgstr ""
4664
4665 #. (itstool) path: sect1/title
4666 #: C/index.docbook:480 C/fdl-appendix.xml:480
4667 msgid "5. COMBINING DOCUMENTS"
4668 msgstr ""
4669
4670 #. (itstool) path: sect1/para
4671 #: C/index.docbook:481
4672 msgid ""
4673 "You may combine the <link linkend=\"fdl-document\">Document</link> with "
4674 "other documents released under this License, under the terms defined in "
4675 "<link linkend=\"fdl-section4\">section 4</link> above for modified versions, "
4676 "provided that you include in the combination all of the <link linkend=\"fdl-"
4677 "invariant\">Invariant Sections</link> of all of the original documents, "
4678 "unmodified, and list them all as Invariant Sections of your combined work in "
4679 "its license notice."
4680 msgstr ""
4681
4682 #. (itstool) path: sect1/para
4683 #: C/index.docbook:492
4684 msgid ""
4685 "The combined work need only contain one copy of this License, and multiple "
4686 "identical <link linkend=\"fdl-invariant\">Invariant Sections</link> may be "
4687 "replaced with a single copy. If there are multiple Invariant Sections with "
4688 "the same name but different contents, make the title of each such section "
4689 "unique by adding at the end of it, in parentheses, the name of the original "
4690 "author or publisher of that section if known, or else a unique number. Make "
4691 "the same adjustment to the section titles in the list of Invariant Sections "
4692 "in the license notice of the combined work."
4693 msgstr ""
4694
4695 #. (itstool) path: sect1/para
4696 #: C/index.docbook:505
4697 msgid ""
4698 "In the combination, you must combine any sections entitled <quote>History</"
4699 "quote> in the various original documents, forming one section entitled "
4700 "<quote>History</quote>; likewise combine any sections entitled "
4701 "<quote>Acknowledgements</quote>, and any sections entitled "
4702 "<quote>Dedications</quote>. You must delete all sections entitled "
4703 "<quote>Endorsements.</quote>"
4704 msgstr ""
4705
4706 #. (itstool) path: sect1/title
4707 #: C/index.docbook:516 C/fdl-appendix.xml:516
4708 msgid "6. COLLECTIONS OF DOCUMENTS"
4709 msgstr ""
4710
4711 #. (itstool) path: sect1/para
4712 #: C/index.docbook:517
4713 msgid ""
4714 "You may make a collection consisting of the <link linkend=\"fdl-document"
4715 "\">Document</link> and other documents released under this License, and "
4716 "replace the individual copies of this License in the various documents with "
4717 "a single copy that is included in the collection, provided that you follow "
4718 "the rules of this License for verbatim copying of each of the documents in "
4719 "all other respects."
4720 msgstr ""
4721
4722 #. (itstool) path: sect1/para
4723 #: C/index.docbook:527 C/fdl-appendix.xml:527
4724 msgid ""
4725 "You may extract a single document from such a collection, and distribute it "
4726 "individually under this License, provided you insert a copy of this License "
4727 "into the extracted document, and follow this License in all other respects "
4728 "regarding verbatim copying of that document."
4729 msgstr ""
4730
4731 #. (itstool) path: sect1/title
4732 #: C/index.docbook:537 C/fdl-appendix.xml:537
4733 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
4734 msgstr ""
4735
4736 #. (itstool) path: sect1/para
4737 #: C/index.docbook:538
4738 msgid ""
4739 "A compilation of the <link linkend=\"fdl-document\">Document</link> or its "
4740 "derivatives with other separate and independent documents or works, in or on "
4741 "a volume of a storage or distribution medium, does not as a whole count as a "
4742 "<link linkend=\"fdl-modified\">Modified Version</link> of the Document, "
4743 "provided no compilation copyright is claimed for the compilation. Such a "
4744 "compilation is called an <quote>aggregate</quote>, and this License does not "
4745 "apply to the other self-contained works thus compiled with the Document , on "
4746 "account of their being thus compiled, if they are not themselves derivative "
4747 "works of the Document. If the <link linkend=\"fdl-cover-texts\">Cover Text</"
4748 "link> requirement of <link linkend=\"fdl-section3\">section 3</link> is "
4749 "applicable to these copies of the Document, then if the Document is less "
4750 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
4751 "placed on covers that surround only the Document within the aggregate. "
4752 "Otherwise they must appear on covers around the whole aggregate."
4753 msgstr ""
4754
4755 #. (itstool) path: sect1/title
4756 #: C/index.docbook:561 C/fdl-appendix.xml:561
4757 msgid "8. TRANSLATION"
4758 msgstr ""
4759
4760 #. (itstool) path: sect1/para
4761 #: C/index.docbook:562
4762 msgid ""
4763 "Translation is considered a kind of modification, so you may distribute "
4764 "translations of the <link linkend=\"fdl-document\">Document</link> under the "
4765 "terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing <link "
4766 "linkend=\"fdl-invariant\"> Invariant Sections</link> with translations "
4767 "requires special permission from their copyright holders, but you may "
4768 "include translations of some or all Invariant Sections in addition to the "
4769 "original versions of these Invariant Sections. You may include a translation "
4770 "of this License provided that you also include the original English version "
4771 "of this License. In case of a disagreement between the translation and the "
4772 "original English version of this License, the original English version will "
4773 "prevail."
4774 msgstr ""
4775
4776 #. (itstool) path: sect1/title
4777 #: C/index.docbook:580 C/fdl-appendix.xml:580
4778 msgid "9. TERMINATION"
4779 msgstr ""
4780
4781 #. (itstool) path: sect1/para
4782 #: C/index.docbook:581
4783 msgid ""
4784 "You may not copy, modify, sublicense, or distribute the <link linkend=\"fdl-"
4785 "document\">Document</link> except as expressly provided for under this "
4786 "License. Any other attempt to copy, modify, sublicense or distribute the "
4787 "Document is void, and will automatically terminate your rights under this "
4788 "License. However, parties who have received copies, or rights, from you "
4789 "under this License will not have their licenses terminated so long as such "
4790 "parties remain in full compliance."
4791 msgstr ""
4792
4793 #. (itstool) path: sect1/title
4794 #: C/index.docbook:594 C/fdl-appendix.xml:594
4795 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
4796 msgstr ""
4797
4798 #. (itstool) path: sect1/para
4799 #: C/index.docbook:595
4800 msgid ""
4801 "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
4802 "Software Foundation</ulink> may publish new, revised versions of the GNU "
4803 "Free Documentation License from time to time. Such new versions will be "
4804 "similar in spirit to the present version, but may differ in detail to "
4805 "address new problems or concerns. See <ulink type=\"http\" url=\"http://www."
4806 "gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
4807 msgstr ""
4808
4809 #. (itstool) path: sect1/para
4810 #: C/index.docbook:606
4811 msgid ""
4812 "Each version of the License is given a distinguishing version number. If the "
4813 "<link linkend=\"fdl-document\">Document</link> specifies that a particular "
4814 "numbered version of this License <quote>or any later version</quote> applies "
4815 "to it, you have the option of following the terms and conditions either of "
4816 "that specified version or of any later version that has been published (not "
4817 "as a draft) by the Free Software Foundation. If the Document does not "
4818 "specify a version number of this License, you may choose any version ever "
4819 "published (not as a draft) by the Free Software Foundation."
4820 msgstr ""
4821
4822 #. (itstool) path: sect1/title
4823 #: C/index.docbook:621 C/fdl-appendix.xml:621
4824 msgid "Addendum"
4825 msgstr ""
4826
4827 #. (itstool) path: sect1/para
4828 #: C/index.docbook:622 C/fdl-appendix.xml:622
4829 msgid ""
4830 "To use this License in a document you have written, include a copy of the "
4831 "License in the document and put the following copyright and license notices "
4832 "just after the title page:"
4833 msgstr ""
4834
4835 #. (itstool) path: blockquote/para
4836 #: C/index.docbook:629 C/fdl-appendix.xml:629
4837 msgid "Copyright YEAR YOUR NAME."
4838 msgstr ""
4839
4840 #. (itstool) path: blockquote/para
4841 #: C/index.docbook:632
4842 msgid ""
4843 "Permission is granted to copy, distribute and/or modify this document under "
4844 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
4845 "version published by the Free Software Foundation; with the <link linkend="
4846 "\"fdl-invariant\">Invariant Sections</link> being LIST THEIR TITLES, with "
4847 "the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</link> being LIST, "
4848 "and with the <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link> being "
4849 "LIST. A copy of the license is included in the section entitled <quote>GNU "
4850 "Free Documentation License</quote>."
4851 msgstr ""
4852
4853 #. (itstool) path: sect1/para
4854 #: C/index.docbook:647
4855 msgid ""
4856 "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
4857 "write <quote>with no Invariant Sections</quote> instead of saying which ones "
4858 "are invariant. If you have no <link linkend=\"fdl-cover-texts\">Front-Cover "
4859 "Texts</link>, write <quote>no Front-Cover Texts</quote> instead of "
4860 "<quote>Front-Cover Texts being LIST</quote>; likewise for <link linkend="
4861 "\"fdl-cover-texts\">Back-Cover Texts</link>."
4862 msgstr ""
4863
4864 #. (itstool) path: sect1/para
4865 #: C/index.docbook:657
4866 msgid ""
4867 "If your document contains nontrivial examples of program code, we recommend "
4868 "releasing these examples in parallel under your choice of free software "
4869 "license, such as the <ulink type=\"http\" url=\"http://www.gnu.org/copyleft/"
4870 "gpl.html\"> GNU General Public License</ulink>, to permit their use in free "
4871 "software."
4872 msgstr ""
4873
4874 #. (itstool) path: copyright/year
4875 #: C/fdl-appendix.xml:16
4876 msgid "2000"
4877 msgstr "2000"
4878
4879 #. (itstool) path: copyright/holder
4880 #: C/fdl-appendix.xml:16
4881 msgid "Free Software Foundation, Inc."
4882 msgstr "自由软件基金会, Inc."
4883
4884 #. (itstool) path: address/street
4885 #: C/fdl-appendix.xml:20
4886 msgid "51 Franklin Street, Suite 330"
4887 msgstr ""
4888
4889 #. (itstool) path: address/city
4890 #: C/fdl-appendix.xml:21
4891 msgid "Boston"
4892 msgstr ""
4893
4894 #. (itstool) path: address/state
4895 #: C/fdl-appendix.xml:21
4896 msgid "MA"
4897 msgstr "MA"
4898
4899 #. (itstool) path: address/postcode
4900 #: C/fdl-appendix.xml:22
4901 msgid "02110-1301"
4902 msgstr "02110-1301"
4903
4904 #. (itstool) path: address/country
4905 #: C/fdl-appendix.xml:22
4906 msgid "USA"
4907 msgstr "USA"
4908
4909 #. (itstool) path: para/address
4910 #: C/fdl-appendix.xml:20
4911 msgid ""
4912 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
4913 "postcode-4/> <_:country-5/>"
4914 msgstr ""
4915
4916 #. (itstool) path: para/quote
4917 #: C/fdl-appendix.xml:34
4918 msgid "free"
4919 msgstr ""
4920
4921 #. (itstool) path: sect1/para
4922 #: C/fdl-appendix.xml:32
4923 msgid ""
4924 "The purpose of this License is to make a manual, textbook, or other written "
4925 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
4926 "effective freedom to copy and redistribute it, with or without modifying it, "
4927 "either commercially or noncommercially. Secondarily, this License preserves "
4928 "for the author and publisher a way to get credit for their work, while not "
4929 "being considered responsible for modifications made by others."
4930 msgstr ""
4931
4932 #. (itstool) path: para/quote
4933 #: C/fdl-appendix.xml:44
4934 msgid "copyleft"
4935 msgstr "copyleft"
4936
4937 #. (itstool) path: sect1/para
4938 #: C/fdl-appendix.xml:43
4939 msgid ""
4940 "This License is a kind of <_:quote-1/>, which means that derivative works of "
4941 "the document must themselves be free in the same sense. It complements the "
4942 "GNU General Public License, which is a copyleft license designed for free "
4943 "software."
4944 msgstr ""
4945
4946 #. (itstool) path: para/quote
4947 #. (itstool) path: para/link
4948 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
4949 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
4950 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
4951 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
4952 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
4953 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
4954 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
4955 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
4956 #: C/fdl-appendix.xml:608
4957 msgid "Document"
4958 msgstr "文档"
4959
4960 #. (itstool) path: para/quote
4961 #: C/fdl-appendix.xml:69
4962 msgid "you"
4963 msgstr ""
4964
4965 #. (itstool) path: sect1/para
4966 #: C/fdl-appendix.xml:63
4967 msgid ""
4968 "This License applies to any manual or other work that contains a notice "
4969 "placed by the copyright holder saying it can be distributed under the terms "
4970 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
4971 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
4972 msgstr ""
4973
4974 #. (itstool) path: para/quote
4975 #. (itstool) path: para/link
4976 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
4977 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
4978 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
4979 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
4980 msgid "Modified Version"
4981 msgstr ""
4982
4983 #. (itstool) path: sect1/para
4984 #: C/fdl-appendix.xml:72
4985 msgid ""
4986 "A <_:quote-1/> of the Document means any work containing the Document or a "
4987 "portion of it, either copied verbatim, or with modifications and/or "
4988 "translated into another language."
4989 msgstr ""
4990
4991 #. (itstool) path: para/quote
4992 #: C/fdl-appendix.xml:80
4993 msgid "Secondary Section"
4994 msgstr ""
4995
4996 #. (itstool) path: sect1/para
4997 #: C/fdl-appendix.xml:79
4998 msgid ""
4999 "A <_:quote-1/> is a named appendix or a front-matter section of the <_:"
5000 "link-2/> that deals exclusively with the relationship of the publishers or "
5001 "authors of the Document to the Document's overall subject (or to related "
5002 "matters) and contains nothing that could fall directly within that overall "
5003 "subject. (For example, if the Document is in part a textbook of mathematics, "
5004 "a Secondary Section may not explain any mathematics.) The relationship could "
5005 "be a matter of historical connection with the subject or with related "
5006 "matters, or of legal, commercial, philosophical, ethical or political "
5007 "position regarding them."
5008 msgstr ""
5009
5010 #. (itstool) path: para/quote
5011 #. (itstool) path: para/link
5012 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
5013 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
5014 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
5015 msgid "Invariant Sections"
5016 msgstr ""
5017
5018 #. (itstool) path: para/link
5019 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
5020 msgid "Secondary Sections"
5021 msgstr ""
5022
5023 #. (itstool) path: sect1/para
5024 #: C/fdl-appendix.xml:94
5025 msgid ""
5026 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
5027 "being those of Invariant Sections, in the notice that says that the <_:"
5028 "link-3/> is released under this License."
5029 msgstr ""
5030
5031 #. (itstool) path: para/quote
5032 #. (itstool) path: para/link
5033 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
5034 #: C/fdl-appendix.xml:458
5035 msgid "Cover Texts"
5036 msgstr ""
5037
5038 #. (itstool) path: sect1/para
5039 #: C/fdl-appendix.xml:103
5040 msgid ""
5041 "The <_:quote-1/> are certain short passages of text that are listed, as "
5042 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:"
5043 "link-2/> is released under this License."
5044 msgstr ""
5045
5046 #. (itstool) path: para/quote
5047 #. (itstool) path: para/link
5048 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
5049 #: C/fdl-appendix.xml:369
5050 msgid "Transparent"
5051 msgstr ""
5052
5053 #. (itstool) path: para/quote
5054 #. (itstool) path: para/link
5055 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
5056 msgid "Opaque"
5057 msgstr ""
5058
5059 #. (itstool) path: sect1/para
5060 #: C/fdl-appendix.xml:111
5061 msgid ""
5062 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
5063 "represented in a format whose specification is available to the general "
5064 "public, whose contents can be viewed and edited directly and "
5065 "straightforwardly with generic text editors or (for images composed of "
5066 "pixels) generic paint programs or (for drawings) some widely available "
5067 "drawing editor, and that is suitable for input to text formatters or for "
5068 "automatic translation to a variety of formats suitable for input to text "
5069 "formatters. A copy made in an otherwise Transparent file format whose markup "
5070 "has been designed to thwart or discourage subsequent modification by readers "
5071 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
5072 msgstr ""
5073
5074 #. (itstool) path: para/quote
5075 #. (itstool) path: para/link
5076 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
5077 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
5078 msgid "Title Page"
5079 msgstr ""
5080
5081 #. (itstool) path: sect1/para
5082 #: C/fdl-appendix.xml:141
5083 msgid ""
5084 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
5085 "following pages as are needed to hold, legibly, the material this License "
5086 "requires to appear in the title page. For works in formats which do not have "
5087 "any title page as such, <_:quote-2/> means the text near the most prominent "
5088 "appearance of the work's title, preceding the beginning of the body of the "
5089 "text."
5090 msgstr ""
5091
5092 #. (itstool) path: para/link
5093 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
5094 msgid "section 3"
5095 msgstr ""
5096
5097 #. (itstool) path: sect1/para
5098 #: C/fdl-appendix.xml:154
5099 msgid ""
5100 "You may copy and distribute the <_:link-1/> in any medium, either "
5101 "commercially or noncommercially, provided that this License, the copyright "
5102 "notices, and the license notice saying this License applies to the Document "
5103 "are reproduced in all copies, and that you add no other conditions "
5104 "whatsoever to those of this License. You may not use technical measures to "
5105 "obstruct or control the reading or further copying of the copies you make or "
5106 "distribute. However, you may accept compensation in exchange for copies. If "
5107 "you distribute a large enough number of copies you must also follow the "
5108 "conditions in <_:link-2/>."
5109 msgstr ""
5110
5111 #. (itstool) path: sect1/para
5112 #: C/fdl-appendix.xml:177
5113 msgid ""
5114 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
5115 "and the Document's license notice requires <_:link-2/>, you must enclose the "
5116 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
5117 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
5118 "cover. Both covers must also clearly and legibly identify you as the "
5119 "publisher of these copies. The front cover must present the full title with "
5120 "all words of the title equally prominent and visible. You may add other "
5121 "material on the covers in addition. Copying with changes limited to the "
5122 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
5123 "these conditions, can be treated as verbatim copying in other respects."
5124 msgstr ""
5125
5126 #. (itstool) path: sect1/para
5127 #: C/fdl-appendix.xml:202
5128 msgid ""
5129 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
5130 "more than 100, you must either include a machine-readable <_:link-3/> copy "
5131 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
5132 "accessible computer-network location containing a complete Transparent copy "
5133 "of the Document, free of added material, which the general network-using "
5134 "public has access to download anonymously at no charge using public-standard "
5135 "network protocols. If you use the latter option, you must take reasonably "
5136 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
5137 "ensure that this Transparent copy will remain thus accessible at the stated "
5138 "location until at least one year after the last time you distribute an "
5139 "Opaque copy (directly or through your agents or retailers) of that edition "
5140 "to the public."
5141 msgstr ""
5142
5143 #. (itstool) path: sect1/para
5144 #: C/fdl-appendix.xml:222
5145 msgid ""
5146 "It is requested, but not required, that you contact the authors of the <_:"
5147 "link-1/> well before redistributing any large number of copies, to give them "
5148 "a chance to provide you with an updated version of the Document."
5149 msgstr ""
5150
5151 #. (itstool) path: para/link
5152 #: C/fdl-appendix.xml:236
5153 msgid "2"
5154 msgstr "2"
5155
5156 #. (itstool) path: para/link
5157 #: C/fdl-appendix.xml:237
5158 msgid "3"
5159 msgstr "3"
5160
5161 #. (itstool) path: sect1/para
5162 #: C/fdl-appendix.xml:232
5163 msgid ""
5164 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
5165 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
5166 "release the Modified Version under precisely this License, with the Modified "
5167 "Version filling the role of the Document, thus licensing distribution and "
5168 "modification of the Modified Version to whoever possesses a copy of it. In "
5169 "addition, you must do these things in the Modified Version:"
5170 msgstr ""
5171
5172 #. (itstool) path: formalpara/para
5173 #: C/fdl-appendix.xml:249
5174 msgid ""
5175 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
5176 "that of the <_:link-2/>, and from those of previous versions (which should, "
5177 "if there were any, be listed in the History section of the Document). You "
5178 "may use the same title as a previous version if the original publisher of "
5179 "that version gives permission."
5180 msgstr ""
5181
5182 #. (itstool) path: formalpara/para
5183 #: C/fdl-appendix.xml:265
5184 msgid ""
5185 "List on the <_:link-1/>, as authors, one or more persons or entities "
5186 "responsible for authorship of the modifications in the <_:link-2/>, together "
5187 "with at least five of the principal authors of the <_:link-3/> (all of its "
5188 "principal authors, if it has less than five)."
5189 msgstr ""
5190
5191 #. (itstool) path: formalpara/para
5192 #: C/fdl-appendix.xml:280
5193 msgid ""
5194 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
5195 "the publisher."
5196 msgstr ""
5197
5198 #. (itstool) path: formalpara/para
5199 #: C/fdl-appendix.xml:292
5200 msgid "Preserve all the copyright notices of the <_:link-1/>."
5201 msgstr ""
5202
5203 #. (itstool) path: formalpara/para
5204 #: C/fdl-appendix.xml:312
5205 msgid ""
5206 "Include, immediately after the copyright notices, a license notice giving "
5207 "the public permission to use the <_:link-1/> under the terms of this "
5208 "License, in the form shown in the Addendum below."
5209 msgstr ""
5210
5211 #. (itstool) path: para/link
5212 #: C/fdl-appendix.xml:330
5213 msgid "Document's"
5214 msgstr ""
5215
5216 #. (itstool) path: formalpara/para
5217 #: C/fdl-appendix.xml:325
5218 msgid ""
5219 "Preserve in that license notice the full lists of <_:link-1/> and required "
5220 "<_:link-2/> given in the <_:link-3/> license notice."
5221 msgstr ""
5222
5223 #. (itstool) path: para/quote
5224 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
5225 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
5226 msgid "History"
5227 msgstr ""
5228
5229 #. (itstool) path: formalpara/para
5230 #: C/fdl-appendix.xml:347
5231 msgid ""
5232 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
5233 "item stating at least the title, year, new authors, and publisher of the <_:"
5234 "link-2/> as given on the <_:link-3/>. If there is no section entitled <_:"
5235 "quote-4/> in the <_:link-5/>, create one stating the title, year, authors, "
5236 "and publisher of the Document as given on its Title Page, then add an item "
5237 "describing the Modified Version as stated in the previous sentence."
5238 msgstr ""
5239
5240 #. (itstool) path: formalpara/para
5241 #: C/fdl-appendix.xml:366
5242 msgid ""
5243 "Preserve the network location, if any, given in the <_:link-1/> for public "
5244 "access to a <_:link-2/> copy of the Document, and likewise the network "
5245 "locations given in the Document for previous versions it was based on. These "
5246 "may be placed in the <_:quote-3/> section. You may omit a network location "
5247 "for a work that was published at least four years before the Document "
5248 "itself, or if the original publisher of the version it refers to gives "
5249 "permission."
5250 msgstr ""
5251
5252 #. (itstool) path: para/quote
5253 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
5254 msgid "Acknowledgements"
5255 msgstr ""
5256
5257 #. (itstool) path: para/quote
5258 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
5259 msgid "Dedications"
5260 msgstr ""
5261
5262 #. (itstool) path: formalpara/para
5263 #: C/fdl-appendix.xml:384
5264 msgid ""
5265 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
5266 "title, and preserve in the section all the substance and tone of each of the "
5267 "contributor acknowledgements and/or dedications given therein."
5268 msgstr ""
5269
5270 #. (itstool) path: formalpara/para
5271 #: C/fdl-appendix.xml:397
5272 msgid ""
5273 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
5274 "in their titles. Section numbers or the equivalent are not considered part "
5275 "of the section titles."
5276 msgstr ""
5277
5278 #. (itstool) path: para/quote
5279 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
5280 msgid "Endorsements"
5281 msgstr ""
5282
5283 #. (itstool) path: formalpara/para
5284 #: C/fdl-appendix.xml:410
5285 msgid ""
5286 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
5287 "in the <_:link-2/>."
5288 msgstr ""
5289
5290 #. (itstool) path: para/link
5291 #: C/fdl-appendix.xml:425
5292 msgid "Invariant Section"
5293 msgstr ""
5294
5295 #. (itstool) path: formalpara/para
5296 #: C/fdl-appendix.xml:422
5297 msgid ""
5298 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
5299 "with any <_:link-2/>."
5300 msgstr ""
5301
5302 #. (itstool) path: sect1/para
5303 #: C/fdl-appendix.xml:432
5304 msgid ""
5305 "If the <_:link-1/> includes new front-matter sections or appendices that "
5306 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5307 "may at your option designate some or all of these sections as invariant. To "
5308 "do this, add their titles to the list of <_:link-3/> in the Modified "
5309 "Version's license notice. These titles must be distinct from any other "
5310 "section titles."
5311 msgstr ""
5312
5313 #. (itstool) path: sect1/para
5314 #: C/fdl-appendix.xml:444
5315 msgid ""
5316 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
5317 "but endorsements of your <_:link-2/> by various parties--for example, "
5318 "statements of peer review or that the text has been approved by an "
5319 "organization as the authoritative definition of a standard."
5320 msgstr ""
5321
5322 #. (itstool) path: para/link
5323 #: C/fdl-appendix.xml:455
5324 msgid "Front-Cover Text"
5325 msgstr ""
5326
5327 #. (itstool) path: para/link
5328 #: C/fdl-appendix.xml:457
5329 msgid "Back-Cover Text"
5330 msgstr ""
5331
5332 #. (itstool) path: sect1/para
5333 #: C/fdl-appendix.xml:453
5334 msgid ""
5335 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5336 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
5337 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
5338 "Text may be added by (or through arrangements made by) any one entity. If "
5339 "the <_:link-5/> already includes a cover text for the same cover, previously "
5340 "added by you or by arrangement made by the same entity you are acting on "
5341 "behalf of, you may not add another; but you may replace the old one, on "
5342 "explicit permission from the previous publisher that added the old one."
5343 msgstr ""
5344
5345 #. (itstool) path: sect1/para
5346 #: C/fdl-appendix.xml:470
5347 msgid ""
5348 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
5349 "give permission to use their names for publicity for or to assert or imply "
5350 "endorsement of any <_:link-2/>."
5351 msgstr ""
5352
5353 #. (itstool) path: para/link
5354 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
5355 msgid "section 4"
5356 msgstr ""
5357
5358 #. (itstool) path: sect1/para
5359 #: C/fdl-appendix.xml:481
5360 msgid ""
5361 "You may combine the <_:link-1/> with other documents released under this "
5362 "License, under the terms defined in <_:link-2/> above for modified versions, "
5363 "provided that you include in the combination all of the <_:link-3/> of all "
5364 "of the original documents, unmodified, and list them all as Invariant "
5365 "Sections of your combined work in its license notice."
5366 msgstr ""
5367
5368 #. (itstool) path: sect1/para
5369 #: C/fdl-appendix.xml:492
5370 msgid ""
5371 "The combined work need only contain one copy of this License, and multiple "
5372 "identical <_:link-1/> may be replaced with a single copy. If there are "
5373 "multiple Invariant Sections with the same name but different contents, make "
5374 "the title of each such section unique by adding at the end of it, in "
5375 "parentheses, the name of the original author or publisher of that section if "
5376 "known, or else a unique number. Make the same adjustment to the section "
5377 "titles in the list of Invariant Sections in the license notice of the "
5378 "combined work."
5379 msgstr ""
5380
5381 #. (itstool) path: para/quote
5382 #: C/fdl-appendix.xml:511
5383 msgid "Endorsements."
5384 msgstr ""
5385
5386 #. (itstool) path: sect1/para
5387 #: C/fdl-appendix.xml:505
5388 msgid ""
5389 "In the combination, you must combine any sections entitled <_:quote-1/> in "
5390 "the various original documents, forming one section entitled <_:quote-2/>; "
5391 "likewise combine any sections entitled <_:quote-3/>, and any sections "
5392 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
5393 msgstr ""
5394
5395 #. (itstool) path: sect1/para
5396 #: C/fdl-appendix.xml:517
5397 msgid ""
5398 "You may make a collection consisting of the <_:link-1/> and other documents "
5399 "released under this License, and replace the individual copies of this "
5400 "License in the various documents with a single copy that is included in the "
5401 "collection, provided that you follow the rules of this License for verbatim "
5402 "copying of each of the documents in all other respects."
5403 msgstr ""
5404
5405 #. (itstool) path: para/quote
5406 #: C/fdl-appendix.xml:546
5407 msgid "aggregate"
5408 msgstr ""
5409
5410 #. (itstool) path: para/link
5411 #: C/fdl-appendix.xml:550
5412 msgid "Cover Text"
5413 msgstr ""
5414
5415 #. (itstool) path: sect1/para
5416 #: C/fdl-appendix.xml:538
5417 msgid ""
5418 "A compilation of the <_:link-1/> or its derivatives with other separate and "
5419 "independent documents or works, in or on a volume of a storage or "
5420 "distribution medium, does not as a whole count as a <_:link-2/> of the "
5421 "Document, provided no compilation copyright is claimed for the compilation. "
5422 "Such a compilation is called an <_:quote-3/>, and this License does not "
5423 "apply to the other self-contained works thus compiled with the Document , on "
5424 "account of their being thus compiled, if they are not themselves derivative "
5425 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
5426 "applicable to these copies of the Document, then if the Document is less "
5427 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
5428 "placed on covers that surround only the Document within the aggregate. "
5429 "Otherwise they must appear on covers around the whole aggregate."
5430 msgstr ""
5431
5432 #. (itstool) path: sect1/para
5433 #: C/fdl-appendix.xml:562
5434 msgid ""
5435 "Translation is considered a kind of modification, so you may distribute "
5436 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:"
5437 "link-3/> with translations requires special permission from their copyright "
5438 "holders, but you may include translations of some or all Invariant Sections "
5439 "in addition to the original versions of these Invariant Sections. You may "
5440 "include a translation of this License provided that you also include the "
5441 "original English version of this License. In case of a disagreement between "
5442 "the translation and the original English version of this License, the "
5443 "original English version will prevail."
5444 msgstr ""
5445
5446 #. (itstool) path: sect1/para
5447 #: C/fdl-appendix.xml:581
5448 msgid ""
5449 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
5450 "as expressly provided for under this License. Any other attempt to copy, "
5451 "modify, sublicense or distribute the Document is void, and will "
5452 "automatically terminate your rights under this License. However, parties who "
5453 "have received copies, or rights, from you under this License will not have "
5454 "their licenses terminated so long as such parties remain in full compliance."
5455 msgstr ""
5456
5457 #. (itstool) path: para/ulink
5458 #: C/fdl-appendix.xml:597
5459 msgid "Free Software Foundation"
5460 msgstr "自由软件基金会"
5461
5462 #. (itstool) path: para/ulink
5463 #: C/fdl-appendix.xml:603
5464 msgid "http://www.gnu.org/copyleft/"
5465 msgstr "http://www.gnu.org/copyleft/"
5466
5467 #. (itstool) path: sect1/para
5468 #: C/fdl-appendix.xml:595
5469 msgid ""
5470 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
5471 "Documentation License from time to time. Such new versions will be similar "
5472 "in spirit to the present version, but may differ in detail to address new "
5473 "problems or concerns. See <_:ulink-2/>."
5474 msgstr ""
5475
5476 #. (itstool) path: para/quote
5477 #: C/fdl-appendix.xml:610
5478 msgid "or any later version"
5479 msgstr ""
5480
5481 #. (itstool) path: sect1/para
5482 #: C/fdl-appendix.xml:606
5483 msgid ""
5484 "Each version of the License is given a distinguishing version number. If the "
5485 "<_:link-1/> specifies that a particular numbered version of this License <_:"
5486 "quote-2/> applies to it, you have the option of following the terms and "
5487 "conditions either of that specified version or of any later version that has "
5488 "been published (not as a draft) by the Free Software Foundation. If the "
5489 "Document does not specify a version number of this License, you may choose "
5490 "any version ever published (not as a draft) by the Free Software Foundation."
5491 msgstr ""
5492
5493 #. (itstool) path: para/link
5494 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
5495 msgid "Front-Cover Texts"
5496 msgstr ""
5497
5498 #. (itstool) path: para/link
5499 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
5500 msgid "Back-Cover Texts"
5501 msgstr ""
5502
5503 #. (itstool) path: blockquote/para
5504 #: C/fdl-appendix.xml:632
5505 msgid ""
5506 "Permission is granted to copy, distribute and/or modify this document under "
5507 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5508 "version published by the Free Software Foundation; with the <_:link-1/> "
5509 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:"
5510 "link-3/> being LIST. A copy of the license is included in the section "
5511 "entitled <_:quote-4/>."
5512 msgstr ""
5513
5514 #. (itstool) path: para/quote
5515 #: C/fdl-appendix.xml:649
5516 msgid "with no Invariant Sections"
5517 msgstr ""
5518
5519 #. (itstool) path: para/quote
5520 #: C/fdl-appendix.xml:652
5521 msgid "no Front-Cover Texts"
5522 msgstr ""
5523
5524 #. (itstool) path: para/quote
5525 #: C/fdl-appendix.xml:653
5526 msgid "Front-Cover Texts being LIST"
5527 msgstr ""
5528
5529 #. (itstool) path: sect1/para
5530 #: C/fdl-appendix.xml:647
5531 msgid ""
5532 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
5533 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:"
5534 "quote-5/>; likewise for <_:link-6/>."
5535 msgstr ""
5536
5537 #. (itstool) path: para/ulink
5538 #: C/fdl-appendix.xml:661
5539 msgid "GNU General Public License"
5540 msgstr "GNU 自由文档许可证"
5541
5542 #. (itstool) path: sect1/para
5543 #: C/fdl-appendix.xml:657
5544 msgid ""
5545 "If your document contains nontrivial examples of program code, we recommend "
5546 "releasing these examples in parallel under your choice of free software "
5547 "license, such as the <_:ulink-1/>, to permit their use in free software."
5548 msgstr ""
5549
5550 #~ msgid "1.18.1"
5551 #~ msgstr "1.18.1"
5552
5553 #, fuzzy
5554 #~ msgid ""
5555 #~ "<guilabel>Generating the \"template\" files.</guilabel> "
5556 #~ "<application>gtkdoc-mktmpl</application> creates a number of files in the "
5557 #~ "<filename class=\"directory\">tmpl/</filename> subdirectory, using the "
5558 #~ "information gathered in the first step. (Note that this can be run "
5559 #~ "repeatedly. It will try to ensure that no documentation is ever lost.)"
5560 #~ msgstr ""
5561 #~ "<guilabel>生成文件 \"模板\" .</guilabel><application>gtkdoc-mktmpl</"
5562 #~ "application>用在第一步收集的信息,在filename class=\"directory\">tmpl/</"
5563 #~ "filename>子目录中创建一定数量的文件。(注意:它能够良好地运行,它将保障没"
5564 #~ "有任何文档丢失。)"
5565
5566 #, fuzzy
5567 #~ msgid ""
5568 #~ "Since GTK-Doc 1.9 the templates can be avoided. We encourage people to "
5569 #~ "keep documentation in the code. <application>gtkdocize</application> "
5570 #~ "supports now a <option>--flavour no-tmpl</option> option that chooses a "
5571 #~ "makefile that skips tmpl usage totally. If you have never changed file in "
5572 #~ "tmpl by hand, please remove the directory (e.g. from version control "
5573 #~ "system)."
5574 #~ msgstr ""
5575 #~ "由于GTK-Doc 1.9模板可以避免使用,我们鼓励人们在代码中保留文档。"
5576 #~ "<application>gtkdocize</application>支持<option>--flavour no-tmpl</option>"
5577 #~ "这个选项,以跳过tpml目录的使用来选择一个makefile文件。如果你从未手动修改过"
5578 #~ "tpml里的文件,请删除这个目录(比如:在版本控制系统中做这件事)。"
5579
5580 #~ msgid ""
5581 #~ "<guilabel>DocBook DTD v3.0</guilabel> - This is the DocBook SGML DTD. "
5582 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora."
5583 #~ "com/davenport</ulink>"
5584 #~ msgstr ""
5585 #~ "<guilabel>DocBook DTD v3.0</guilabel> - 这是DocBook SGML DTD的链接. "
5586 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora."
5587 #~ "com/davenport</ulink>"
5588
5589 #~ msgid ""
5590 #~ "<guilabel>Jade v1.1</guilabel> - This is a DSSSL processor for converting "
5591 #~ "SGML to various formats. <ulink url=\"http://www.jclark.com/jade\" type="
5592 #~ "\"http\">http://www.jclark.com/jade</ulink>"
5593 #~ msgstr ""
5594 #~ "<guilabel>Jade v1.1</guilabel> -这是一个DSSSL处理器,用来把SGML转换为各种"
5595 #~ "格式。<ulink url=\"http://www.jclark.com/jade\" type=\"http\">http://www."
5596 #~ "jclark.com/jade</ulink>"
5597
5598 #, fuzzy
5599 #~ msgid ""
5600 #~ "<guilabel>Modular DocBook Stylesheets</guilabel> This is the DSSSL code "
5601 #~ "to convert DocBook to HTML (and a few other formats). It's used together "
5602 #~ "with jade. I've customized the DSSSL code slightly, in gtk-doc.dsl, to "
5603 #~ "colour the program code listings/declarations, and to support global "
5604 #~ "cross-reference indices in the generated HTML. <ulink url=\"http://nwalsh."
5605 #~ "com/docbook/dsssl\" type=\"http\">http://nwalsh.com/docbook/dsssl</ulink>"
5606 #~ msgstr ""
5607 #~ "<guilabel>Modular DocBook Stylesheets</guilabel> 这是把DocBook转换为"
5608 #~ "HTML(和一些其它格式)格式的DSSSL代码。它与jade共同使用。我稍微地修改了"
5609 #~ "DSSSL代码,在 gtk-doc.dsl中,用于给程序代码的列表/声明,并且支持在已生成"
5610 #~ "的HTML文档中的全局链接。<ulink url=\"http://nwalsh.com/docbook/dsssl\" "
5611 #~ "type=\"http\">http://nwalsh.com/docbook/dsssl</ulink>。"
5612
5613 #, fuzzy
5614 #~ msgid ""
5615 #~ "<guilabel>docbook-to-man</guilabel> - if you want to create man pages "
5616 #~ "from the DocBook. I've customized the 'translation spec' slightly, to "
5617 #~ "capitalise section headings and add the 'GTK Library' title at the top of "
5618 #~ "the pages and the revision date at the bottom. There is a link to this on "
5619 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora."
5620 #~ "com/davenport</ulink> NOTE: This does not work yet."
5621 #~ msgstr ""
5622 #~ "<guilabel>docbook-to-man</guilabel>-如果你想用DocBook创建用户手册。我已经"
5623 #~ "稍微地修改了'translation spec',以便描述文件头部和第页顶部的 'GTK "
5624 #~ "Library'标题与底部的修订时间。这里有一个到它的链接:<ulink url=\"http://"
5625 #~ "www.ora.com/davenport\" type=\"http\">http://www.ora.com/davenport</ulink>"
5626 #~ "注意:它可能已经无效了。"
5627
5628 #~ msgid ""
5629 #~ "There is no standard place where the DocBook Modular Stylesheets are "
5630 #~ "installed."
5631 #~ msgstr "DocBook Modular Stylesheets没有标准的安装位置。"
5632
5633 #~ msgid ""
5634 #~ "GTK-Doc's configure script searches these 3 directories automatically:"
5635 #~ msgstr "GTK-Doc 的配置脚本会自动地查找这三个目录:"
5636
5637 #~ msgid ""
5638 #~ "<filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (used by "
5639 #~ "RedHat)"
5640 #~ msgstr ""
5641 #~ "<filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (在 "
5642 #~ "RedHat 中使用)"
5643
5644 #~ msgid ""
5645 #~ "<filename> /usr/lib/dsssl/stylesheets/docbook </filename> (used by Debian)"
5646 #~ msgstr ""
5647 #~ "<filename> /usr/lib/dsssl/stylesheets/docbook </filename> (在 Debian 中使"
5648 #~ "用)"
5649
5650 #~ msgid "<filename> /usr/share/sgml/docbkdsl </filename> (used by SuSE)"
5651 #~ msgstr "<filename> /usr/share/sgml/docbkdsl </filename> (在 SuSE 中使用)"
5652
5653 #~ msgid ""
5654 #~ "If you have the stylesheets installed somewhere else, you need to "
5655 #~ "configure GTK-Doc using the option: <command> --with-dsssl-dir=&lt;"
5656 #~ "PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>"
5657 #~ msgstr ""
5658 #~ "如果把样式表安装在其它地方,您必须用这个选项来配置GTK-Doc:<command> --"
5659 #~ "with-dsssl-dir=&lt;PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>。"
5660
5661 #~ msgid "Setting up your project"
5662 #~ msgstr "设置您的项目"
5663
5664 #, fuzzy
5665 #~ msgid ""
5666 #~ "The next sections describe what steps to perform to integrate GTK-Doc "
5667 #~ "into your project. Theses sections assume we work on a project called "
5668 #~ "'meep'. This project contains a library called 'libmeep' and an end-user "
5669 #~ "app called 'meeper'. We also assume you will be using autoconf and "
5670 #~ "automake. In addition section <link linkend=\"plain_makefiles\">plain "
5671 #~ "makefiles or other build systems</link> will describe the basics needed "
5672 #~ "to work in a different build setup."
5673 #~ msgstr ""
5674 #~ "下面这些部分描述了要在你的项目中实现完整的GTK-Doc应当经历哪些步骤。这些部"
5675 #~ "分假定我们在做一个名为'meep'的项目。该项目包含了一个叫做 'libmeep' 的库和"
5676 #~ "一个称为'meeper'的终端用户应用程序。我们同样也假定你使用autoconf与"
5677 #~ "automake。在附加的部分<link linkend=\"plain_makefiles\">plain makefiles "
5678 #~ "or other build systems</link> 将描述构建一个不同的项目所需的基本的工作."
5679
5680 #, fuzzy
5681 #~ msgid ""
5682 #~ "Under your top-level project directory create folders called docs/"
5683 #~ "reference (this way you can also have docs/help for end-user "
5684 #~ "documentation). It is recommended to create another subdirectory with the "
5685 #~ "name of the doc-package. For packages with just one library this step is "
5686 #~ "not necessary."
5687 #~ msgstr ""
5688 #~ "在你的项目的顶级目录里创建一些名字叫做docs/reference的文件夹(用这种方法也"
5689 #~ "可以为终端用户建立docs/help文件夹)。建议你以文件包的名字创建另一个子目"
5690 #~ "录。仅一个库对应多个包,这一步骤是没有必要的。"
5691
5692 #~ msgid "Example directory structure"
5693 #~ msgstr "范例目录结构"
5694
5695 #~ msgid "This can then look as shown below: <_:example-1/>"
5696 #~ msgstr "目录结构将会如下所示:<_:example-1/>"
5697
5698 #~ msgid ""
5699 #~ "Very easy! Just add one line to your <filename>configure.ac</filename> "
5700 #~ "script."
5701 #~ msgstr ""
5702 #~ "非常容易!只需在您的 <filename>configure.ac</filename> 脚本中添加一行。"
5703
5704 #~ msgid ""
5705 #~ "\n"
5706 #~ "\n"
5707 #~ "# check for gtk-doc\n"
5708 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
5709 #~ "\n"
5710 #~ " "
5711 #~ msgstr ""
5712 #~ "\n"
5713 #~ "\n"
5714 #~ "# 检查 gtk-doc\n"
5715 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
5716 #~ "\n"
5717 #~ " "
5718
5719 #~ msgid "Keep gtk-doc optional"
5720 #~ msgstr "让gtk-doc为可选"
5721
5722 #~ msgid ""
5723 #~ "\n"
5724 #~ "\n"
5725 #~ "# check for gtk-doc\n"
5726 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
5727 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
5728 #~ "],[\n"
5729 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
5730 #~ "])\n"
5731 #~ "\n"
5732 #~ " "
5733 #~ msgstr ""
5734 #~ "\n"
5735 #~ "\n"
5736 #~ "# 检查 gtk-doc\n"
5737 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
5738 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
5739 #~ "],[\n"
5740 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
5741 #~ "])\n"
5742 #~ "\n"
5743 #~ " "
5744
5745 #, fuzzy
5746 #~ msgid ""
5747 #~ "This will require all developers to have gtk-doc installed. If it is okay "
5748 #~ "for your project to have optional api-doc build setup, you can solve this "
5749 #~ "as below. Keep it as is, as gtkdocize is looking for "
5750 #~ "<function>GTK_DOC_CHECK</function> at the start of a line. <_:example-1/>"
5751 #~ msgstr ""
5752 #~ "这将要求所有的开发人员都安装了gtk-doc。如果对于你的项目拥有可选的api-doc构"
5753 #~ "建是可行的,你可以像下面一样解决问题。让它保持正确,就像gtkdocize在一个行"
5754 #~ "的起始寻找<function>GTK_DOC_CHECK</function>一样。 <placeholder-1/>"
5755
5756 #~ msgid ""
5757 #~ "Furthermore it is recommended that you have the following line inside you "
5758 #~ "<filename>configure.ac</filename> script. This allows "
5759 #~ "<application>gtkdocize</application> to automatically copy the macro "
5760 #~ "definition for <function>GTK_DOC_CHECK</function> to your project."
5761 #~ msgstr ""
5762 #~ "而且建议你在<filename>configure.ac</filename>脚本里拥有这样一行。它允许"
5763 #~ "<application>gtkdocize</application>将<function>GTK_DOC_CHECK</function>的"
5764 #~ "宏定义复制到您的项目中去。"
5765
5766 #~ msgid "Preparation for gtkdocize"
5767 #~ msgstr "准备gtkdocize"
5768
5769 #~ msgid ""
5770 #~ "\n"
5771 #~ "\n"
5772 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
5773 #~ "\n"
5774 #~ " "
5775 #~ msgstr ""
5776 #~ "\n"
5777 #~ "\n"
5778 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
5779 #~ "\n"
5780 #~ " "
5781
5782 #, fuzzy
5783 #~ msgid ""
5784 #~ "You may also want to enable GTK-Doc for the distcheck make target. Just "
5785 #~ "add the one line shown in the next example to your top-level "
5786 #~ "<filename>Makefile.am</filename>:"
5787 #~ msgstr ""
5788 #~ "你可能也需要打开GTK-Doc为distcheck制造目标。只要加入一行像下个例子展示的,"
5789 #~ "你的顶级<filename>Makefile.am</filename>:"
5790
5791 #~ msgid "Enable GTK-Doc during make distcheck"
5792 #~ msgstr "在make distcheck过程中启用GTK-Doc"
5793
5794 #~ msgid ""
5795 #~ "\n"
5796 #~ "\n"
5797 #~ "DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc\n"
5798 #~ "\n"
5799 #~ " "
5800 #~ msgstr ""
5801 #~ "\n"
5802 #~ "\n"
5803 #~ "DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc\n"
5804 #~ "\n"
5805 #~ " "
5806
5807 #, fuzzy
5808 #~ msgid ""
5809 #~ "Historically GTK-Doc was generating template files where developers "
5810 #~ "entered the docs. This turned out to be not so good (e.g. the need for "
5811 #~ "having generated files under version control). Since GTK-Doc 1.9 the "
5812 #~ "tools can get all the information from source comments and thus the "
5813 #~ "templates can be avoided. We encourage people to keep documentation in "
5814 #~ "the code. <application>gtkdocize</application> supports now a <option>--"
5815 #~ "flavour no-tmpl</option> option that chooses a makefile that skips tmpl "
5816 #~ "usage totally. Besides adding the option directly to the command "
5817 #~ "invocation, they can be added also to an environment variable called "
5818 #~ "<symbol>GTKDOCIZE_FLAGS</symbol> or set as a 2nd parameter in "
5819 #~ "<symbol>GTK_DOC_CHECK</symbol> macro in the configure script. If you have "
5820 #~ "never changed file in tmpl by hand and migrating from older gtkdoc "
5821 #~ "versions, please remove the directory (e.g. from version control system)."
5822 #~ msgstr ""
5823 #~ "历史上,GTK-Doc在开发人员进入文档时生成模板文件。这样的结果是不是那么好的"
5824 #~ "(比如:在版本控制下生成文件的需求)。由于GTK-Doc 1.9 工具能从源代码中获得"
5825 #~ "所有的信息从而可以获得模板。我们鼓励人们在代码中保留文档。"
5826 #~ "<application>gtkdocize</application> 支持现在的一个<option>--flavour no-"
5827 #~ "tmpl</option>选项用以选择一个makefile来完整地跳过tmpl的使用。除了给命令调"
5828 #~ "用直接加入此选项之外,它们也能添加到一个名为<symbol>GTKDOCIZE_FLAGS</"
5829 #~ "symbol>的环境变量中。或者在配置脚本中作为<symbol>GTK_DOC_CHECK</symbol>宏"
5830 #~ "的第二个参数。如果你从未手工修改过tmpl目录里的文件以及从旧版本的gtkdoc中迁"
5831 #~ "移过文件,请删除这个目录(比如从版本控制系统)。"
5832
5833 #, fuzzy
5834 #~ msgid ""
5835 #~ "Now you can point your browser to <filename>docs/reference/&lt;"
5836 #~ "package&gt;/index.html</filename>. Yes, it's a bit disappointing still. "
5837 #~ "But hang-on, during the next chapter we tell you how to fill the pages "
5838 #~ "with life."
5839 #~ msgstr ""
5840 #~ "现在你可以用你的浏览器指向<filename>docs/reference/&lt;package&gt;/index."
5841 #~ "html</filename>了.是的,它仍有一点小小遗憾。不过请你坚持住,在下一章里我们"
5842 #~ "会告诉你怎样用文件来填充页面。 "
5843
5844 #~ msgid "Documentation placement"
5845 #~ msgstr "文档位置"
5846
5847 #~ msgid ""
5848 #~ "In the past most documentation had to be filled into files residing "
5849 #~ "inside the <filename>tmpl</filename> directory. This has the "
5850 #~ "disadvantages that the information is often not updated and also that the "
5851 #~ "file tend to cause conflicts with version control systems."
5852 #~ msgstr ""
5853 #~ "在过去,多数文档不得不写入驻留在<filename>tmpl</filename>目录的文件中。这"
5854 #~ "样会出现一些糟糕的情况:其信息常常没有更新,而且文件也倾向于与版本控制系统"
5855 #~ "发生冲突。"
5856
5857 #~ msgid ""
5858 #~ "The avoid the aforementioned problems we suggest putting the "
5859 #~ "documentation inside the sources. This manual will only describe this way "
5860 #~ "of documenting code."
5861 #~ msgstr ""
5862 #~ "为避免上述的问题,我们建议把注释文档放入源代码中去。本手册仅描述此种编写代"
5863 #~ "码文档的方法。"
5864
5865 #~ msgid ""
5866 #~ "\n"
5867 #~ "\n"
5868 #~ "/**\n"
5869 #~ " * identifier:\n"
5870 #~ " *\n"
5871 #~ " * documentation ...\n"
5872 #~ " *\n"
5873 #~ " * # Sub heading #\n"
5874 #~ " *\n"
5875 #~ " * more documentation:\n"
5876 #~ " * - list item 1\n"
5877 #~ " * - list item 2\n"
5878 #~ " *\n"
5879 #~ " * Even more docs.\n"
5880 #~ " */\n"
5881 #~ "\n"
5882 #~ " "
5883 #~ msgstr ""
5884 #~ "\n"
5885 #~ "\n"
5886 #~ "/**\n"
5887 #~ " * 标识符:\n"
5888 #~ " *\n"
5889 #~ " * 文档内容 ...\n"
5890 #~ " *\n"
5891 #~ " * # 小标题 #\n"
5892 #~ " *\n"
5893 #~ " * 更多文档:\n"
5894 #~ " * - 列表项1\n"
5895 #~ " * - 列表项2\n"
5896 #~ " *\n"
5897 #~ " * 其余更多文档。\n"
5898 #~ " */\n"
5899 #~ "\n"
5900 #~ " "
5901
5902 #~ msgid ""
5903 #~ "Since GTK-Doc-1.18 the tool supports a subset or the <ulink url=\"http://"
5904 #~ "daringfireball.net/projects/markdown/\">markdown language</ulink>. One "
5905 #~ "can use it for sub-headings and simple itemized lists. On older GTK-Doc "
5906 #~ "versions the content will be rendered as it (the list items will appear "
5907 #~ "in one line separated by dashes). <_:example-1/>"
5908 #~ msgstr ""
5909 #~ "从 GTK-Doc-1.18 版本开始,该工具支持 <ulink url=\"http://daringfireball."
5910 #~ "net/projects/markdown/\">markdown 标记语言</ulink> 的一个子集。可以用它定"
5911 #~ "义小标题和简单的项目列表。在较早的 GTK-Doc 版本中,内容会原样渲染(列表项会"
5912 #~ "显示在一行,以短划线隔开)。<_:example-1/>"
5913
5914 #~ msgid "(FIXME : Stability information)"
5915 #~ msgstr "(FIXME : 稳定性信息)"
5916
5917 #, fuzzy
5918 #~| msgid ""
5919 #~| "Also, take a look at gobject introspection annotation tags: http://live."
5920 #~| "gnome.org/GObjectIntrospection/Annotations"
5921 #~ msgid ""
5922 #~ "Also, take a look at GObject Introspection annotation tags: http://live."
5923 #~ "gnome.org/GObjectIntrospection/Annotations"
5924 #~ msgstr ""
5925 #~ "另请参阅gobject内省(introspection)标记的介绍:http://live.gnome.org/"
5926 #~ "GObjectIntrospection/Annotations"
5927
5928 #~ msgid "Example types file snippet"
5929 #~ msgstr "示例类型文件代码段"
5930
5931 #~ msgid "Chris"
5932 #~ msgstr "Chris"
5933
5934 #~ msgid "Lyttle"
5935 #~ msgstr "Lyttle"
5936
5937 #~ msgid "[email protected]"
5938 #~ msgstr "[email protected]"
5939
5940 #~ msgid "Dan"
5941 #~ msgstr "Dan"
5942
5943 #~ msgid "Mueth"
5944 #~ msgstr "Mueth"
5945
5946 #~ msgid "[email protected]"
5947 #~ msgstr "[email protected]"
5948
5949 #~ msgid "Stefan"
5950 #~ msgstr "Stefan"
5951
5952 #~ msgid "Kost"
5953 #~ msgstr "Kost"
5954
5955 #~ msgid "[email protected]"
5956 #~ msgstr "[email protected]"
5957
5958 #~ msgid "[email protected]"
5959 #~ msgstr "[email protected]"
5960
5961 #~| msgid "2000, 2005, 2007-2009"
5962 #~ msgid "2000, 2005"
5963 #~ msgstr "2000, 2005"
5964
5965 #~| msgid "Dan Mueth and Chris Lyttle and Stefan Kost"
5966 #~ msgid "Dan Mueth and Chris Lyttle"
5967 #~ msgstr "Dan Mueth and Chris Lyttle"
5968
5969 #~| msgid "2000"
5970 #~ msgid "2007-2011"
5971 #~ msgstr "2007-2011"
5972
5973 #~ msgid "Stefan Sauer (Kost)"
5974 #~ msgstr "Stefan Sauer (Kost)"
5975
5976 #~| msgid "26 Feb 2011"
5977 #~ msgid "20 Sep 2011"
5978 #~ msgstr "2011年二月二十日"
5979
5980 #~ msgid "ss"
5981 #~ msgstr "ss"
5982
5983 #~ msgid "development version"
5984 #~ msgstr "开发版本"
5985
5986 #~| msgid "1.15"
5987 #~ msgid "1.18"
5988 #~ msgstr "1.18"
5989
5990 #~| msgid "14 Jan 2011"
5991 #~ msgid "14 sep 2011"
5992 #~ msgstr "2011年一月十四日"
5993
5994 #~ msgid "bug fixes, speedups, markdown support"
5995 #~ msgstr "补漏, speedups, markdown support"
5996
5997 #~ msgid "1.17"
5998 #~ msgstr "1.17"
5999
6000 #~ msgid "26 Feb 2011"
6001 #~ msgstr "2011年二月二十六日"
6002
6003 #~ msgid "sk"
6004 #~ msgstr "sk"
6005
6006 #~ msgid "urgent bug fix update"
6007 #~ msgstr "紧急的bug修复更新"
6008
6009 #~ msgid "1.16"
6010 #~ msgstr "1.16"
6011
6012 #~ msgid "14 Jan 2011"
6013 #~ msgstr "2011年一月十四日"
6014
6015 #~ msgid "bugfixes, layout improvements"
6016 #~ msgstr "错误修正,布局的改进"
6017
6018 #~ msgid "1.15"
6019 #~ msgstr "1.15"
6020
6021 #~ msgid "21 May 2010"
6022 #~ msgstr "2010年五月二十一日"
6023
6024 #~ msgid "bug and regression fixes"
6025 #~ msgstr "错误与复原修补"
6026
6027 #~ msgid "1.14"
6028 #~ msgstr "1.14"
6029
6030 #~ msgid "28 March 2010"
6031 #~ msgstr "2010三月二十八日"
6032
6033 #~ msgid "bugfixes and performance improvements"
6034 #~ msgstr "补漏与性能提高"
6035
6036 #~ msgid "1.13"
6037 #~ msgstr "1.13"
6038
6039 #~ msgid "18 December 2009"
6040 #~ msgstr "2009年十二月十八日"
6041
6042 #~ msgid "broken tarball update"
6043 #~ msgstr "不完整的tarball升级"
6044
6045 #~ msgid "1.12"
6046 #~ msgstr "1.12"
6047
6048 #~ msgid "new tool features and bugfixes"
6049 #~ msgstr "工具的新功能和错误修正"
6050
6051 #~ msgid "1.11"
6052 #~ msgstr "1.11"
6053
6054 #~ msgid "16 Novemebr 2008"
6055 #~ msgstr "2008年十一月十六日"
6056
6057 #~ msgid "mal"
6058 #~ msgstr "不良品"
6059
6060 #~ msgid "GNOME doc-utils migration"
6061 #~ msgstr "GNOME文档组件迁移"
6062
6063 #~ msgid "xxx_get_type()"
6064 #~ msgstr "xxx_get_type()"
6065
6066 #~ msgid "&lt;package&gt;-sections.txt"
6067 #~ msgstr "&lt;package&gt;-sections.txt"
6068
6069 #~ msgid "explanation"
6070 #~ msgstr "解释"
6071
6072 #~ msgid ""
6073 #~ "Missing or wrong naming in <placeholder-1/> file (see <placeholder-2/>)."
6074 #~ msgstr "在<placeholder-1/>文件中缺失或错误的命名(参看<placeholder-2/>)."
6075
6076 #~ msgid "GtkWidget"
6077 #~ msgstr "GtkWidget"
6078
6079 #~ msgid "&lt;package&gt;-docs.{xml,sgml}"
6080 #~ msgstr "&lt;package&gt;-docs.{xml,sgml}"