[gtk-doc] Updated Spanish translation
- From: Daniel Mustieles García <dmustieles src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk-doc] Updated Spanish translation
- Date: Wed, 20 Dec 2017 17:14:29 +0000 (UTC)
commit e08245ac205366402a37588812d2434c49186f58
Author: Daniel Mustieles <daniel mustieles gmail com>
Date: Wed Dec 20 18:14:21 2017 +0100
Updated Spanish translation
help/manual/es/es.po | 742 +++++++++++++++++++++++++------------------------
1 files changed, 379 insertions(+), 363 deletions(-)
---
diff --git a/help/manual/es/es.po b/help/manual/es/es.po
index b7a043e..73a5753 100644
--- a/help/manual/es/es.po
+++ b/help/manual/es/es.po
@@ -8,8 +8,8 @@
msgid ""
msgstr ""
"Project-Id-Version: gtk-doc-help.master\n"
-"POT-Creation-Date: 2017-08-11 11:08+0000\n"
-"PO-Revision-Date: 2017-09-05 12:31+0200\n"
+"POT-Creation-Date: 2017-12-07 14:48+0000\n"
+"PO-Revision-Date: 2017-12-15 12:02+0100\n"
"Last-Translator: Daniel Mustieles <daniel mustieles gmail com>\n"
"Language-Team: es <gnome-es-list gnome org>\n"
"Language: \n"
@@ -126,23 +126,30 @@ msgstr ""
#. (itstool) path: revhistory/revision
#: C/index.docbook:83
#| msgid ""
-#| "<revnumber>1.25.1</revnumber> <date>21 March 2016</date> "
-#| "<authorinitials>ss</authorinitials> <revremark>development version</"
-#| "revremark>"
+#| "<revnumber>1.26.1</revnumber> <date>11 Aug 2017</date> "
+#| "<authorinitials>ss</authorinitials> <revremark>development</revremark>"
msgid ""
-"<revnumber>1.26.1</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
-"authorinitials> <revremark>development</revremark>"
+"<revnumber>1.27.1</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
+"authorinitials> <revremark>developemnt</revremark>"
msgstr ""
-"<revnumber>1.26.1</revnumber> <date>11 de agosto de 2017</date> "
-"<authorinitials>ss</authorinitials> <revremark>versión de desarrollo</"
-"revremark>"
+"<revnumber>1.27.1</revnumber> <date>07 de diciembre de 2017</date> "
+"<authorinitials>ss</authorinitials> <revremark>desarrollo</revremark>"
#. (itstool) path: revhistory/revision
#: C/index.docbook:89
#| msgid ""
-#| "<revnumber>1.25.1</revnumber> <date>21 March 2016</date> "
-#| "<authorinitials>ss</authorinitials> <revremark>development version</"
-#| "revremark>"
+#| "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
+#| "authorinitials> <revremark>bug fix</revremark>"
+msgid ""
+"<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
+"authorinitials> <revremark>fine tuning of the python port</revremark>"
+msgstr ""
+"<revnumber>1.27</revnumber> <date>07 de diciembre de 2017</date> "
+"<authorinitials>ss</authorinitials> <revremark>ajustes para la migración a "
+"python</revremark>"
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:95
msgid ""
"<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
"authorinitials> <revremark>port all tools from perl/bash to python</"
@@ -153,7 +160,7 @@ msgstr ""
"de perl/bash a python</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:95
+#: C/index.docbook:101
msgid ""
"<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes, test cleanups</revremark>"
@@ -163,7 +170,7 @@ msgstr ""
"limpieza</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:101
+#: C/index.docbook:107
msgid ""
"<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fix</revremark>"
@@ -173,7 +180,7 @@ msgstr ""
"revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:107
+#: C/index.docbook:113
msgid ""
"<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fix</revremark>"
@@ -183,7 +190,7 @@ msgstr ""
"revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:113
+#: C/index.docbook:119
msgid ""
"<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes, dropping deprecated features</"
@@ -194,7 +201,7 @@ msgstr ""
"eliminadas funcionalidades obsoletas</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:119
+#: C/index.docbook:125
msgid ""
"<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes, dropping deprecated features</"
@@ -205,7 +212,7 @@ msgstr ""
"eliminadas funcionalidades obsoletas</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:125
+#: C/index.docbook:131
msgid ""
"<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes, markdown support, style improvements</"
@@ -216,7 +223,7 @@ msgstr ""
"de marcado, mejoras en los estilos</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:131
+#: C/index.docbook:137
msgid ""
"<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes</revremark>"
@@ -226,7 +233,7 @@ msgstr ""
"revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:137
+#: C/index.docbook:143
msgid ""
"<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
@@ -236,7 +243,7 @@ msgstr ""
"mejoras en la velocidad y soporte de marcado</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:143
+#: C/index.docbook:149
msgid ""
"<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
"authorinitials> <revremark>urgent bug fix update</revremark>"
@@ -246,7 +253,7 @@ msgstr ""
"corrección de error</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:149
+#: C/index.docbook:155
msgid ""
"<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
"authorinitials> <revremark>bugfixes, layout improvements</revremark>"
@@ -256,7 +263,7 @@ msgstr ""
"mejoras en la distribución</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:155
+#: C/index.docbook:161
msgid ""
"<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
"authorinitials> <revremark>bug and regression fixes</revremark>"
@@ -266,7 +273,7 @@ msgstr ""
"regresiones</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:161
+#: C/index.docbook:167
msgid ""
"<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
"authorinitials> <revremark>bugfixes and performance improvements</revremark>"
@@ -276,7 +283,7 @@ msgstr ""
"mejoras en el rendimiento</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:167
+#: C/index.docbook:173
msgid ""
"<revnumber>1.13</revnumber> <date>18 December 2009</date> "
"<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
@@ -287,7 +294,7 @@ msgstr ""
"roto</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:173
+#: C/index.docbook:179
msgid ""
"<revnumber>1.12</revnumber> <date>18 December 2009</date> "
"<authorinitials>sk</authorinitials> <revremark>new tool features and "
@@ -298,7 +305,7 @@ msgstr ""
"nuevas características</revremark>"
#. (itstool) path: revhistory/revision
-#: C/index.docbook:179
+#: C/index.docbook:185
msgid ""
"<revnumber>1.11</revnumber> <date>16 November 2008</date> "
"<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
@@ -309,12 +316,12 @@ msgstr ""
"revremark>"
#. (itstool) path: chapter/title
-#: C/index.docbook:192
+#: C/index.docbook:198
msgid "Introduction"
msgstr "Introducción"
#. (itstool) path: chapter/para
-#: C/index.docbook:194
+#: C/index.docbook:200
msgid ""
"This chapter introduces GTK-Doc and gives an overview of what it is and how "
"it is used."
@@ -323,12 +330,12 @@ msgstr ""
"es y cómo usarlo."
#. (itstool) path: sect1/title
-#: C/index.docbook:200
+#: C/index.docbook:206
msgid "What is GTK-Doc?"
msgstr "¿Qué es GTK-Doc?"
#. (itstool) path: sect1/para
-#: C/index.docbook:202
+#: C/index.docbook:208
msgid ""
"GTK-Doc is used to document C code. It is typically used to document the "
"public API of libraries, such as the GTK+ and GNOME libraries. But it can "
@@ -339,12 +346,12 @@ msgstr ""
"Pero también se puede usar para documentar código de aplicaciones."
#. (itstool) path: sect1/title
-#: C/index.docbook:210
+#: C/index.docbook:216
msgid "How Does GTK-Doc Work?"
msgstr "¿Cómo funciona GTK-Doc?"
#. (itstool) path: sect1/para
-#: C/index.docbook:212
+#: C/index.docbook:218
msgid ""
"GTK-Doc works by using documentation of functions placed inside the source "
"files in specially-formatted comment blocks, or documentation added to the "
@@ -359,10 +366,7 @@ msgstr ""
"archivos de cabecera; no produce salida para funciones estáticas)."
#. (itstool) path: sect1/para
-#: C/index.docbook:219
-#| msgid ""
-#| "GTK-Doc consists of a number of perl scripts, each performing a different "
-#| "step in the process."
+#: C/index.docbook:225
msgid ""
"GTK-Doc consists of a number of python scripts, each performing a different "
"step in the process."
@@ -371,12 +375,12 @@ msgstr ""
"diferente en el proceso."
#. (itstool) path: sect1/para
-#: C/index.docbook:224
+#: C/index.docbook:230
msgid "There are 5 main steps in the process:"
msgstr "Existen 5 pasos importantes en el proceso:"
#. (itstool) path: listitem/para
-#: C/index.docbook:231
+#: C/index.docbook:237
msgid ""
"<guilabel>Writing the documentation.</guilabel> The author fills in the "
"source files with the documentation for each function, macro, union etc. (In "
@@ -389,7 +393,7 @@ msgstr ""
"lo que ya no se recomienda)."
#. (itstool) path: listitem/para
-#: C/index.docbook:241
+#: C/index.docbook:247
msgid ""
"<guilabel>Gathering information about the code.</guilabel> "
"<application>gtkdoc-scan</application> scans the header files of the code "
@@ -425,7 +429,7 @@ msgstr ""
"txt</filename> dentro de <filename><module>-overrides.txt</filename>."
#. (itstool) path: listitem/para
-#: C/index.docbook:258
+#: C/index.docbook:264
msgid ""
"<application>gtkdoc-scangobj</application> can also be used to dynamically "
"query a library about any GObject subclasses it exports. It saves "
@@ -439,7 +443,7 @@ msgstr ""
"que proporciona."
#. (itstool) path: listitem/para
-#: C/index.docbook:264
+#: C/index.docbook:270
msgid ""
"<application>gtkdoc-scanobj</application> should not be used anymore. It was "
"needed in the past when GObject was still GtkObject inside gtk+."
@@ -448,7 +452,7 @@ msgstr ""
"necesitó en el pasado, cuando GObject todavía era GtkObject dentro de GTK+."
#. (itstool) path: listitem/para
-#: C/index.docbook:271
+#: C/index.docbook:277
msgid ""
"<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
"mkdb</application> turns the template files into XML files in the <filename "
@@ -465,7 +469,7 @@ msgstr ""
"obtiene los documentos de los fuentes y los datos obtenidos en introspección."
#. (itstool) path: listitem/para
-#: C/index.docbook:280
+#: C/index.docbook:286
msgid ""
"<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
"in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
@@ -479,7 +483,7 @@ msgstr ""
"paquete>.pdf</filename>."
#. (itstool) path: listitem/para
-#: C/index.docbook:286
+#: C/index.docbook:292
msgid ""
"Files in <filename class=\"directory\">xml/</filename> and <filename class="
"\"directory\">html/</filename> directories are always overwritten. One "
@@ -490,7 +494,7 @@ msgstr ""
"Nunca se deben editar directamente."
#. (itstool) path: listitem/para
-#: C/index.docbook:294
+#: C/index.docbook:300
msgid ""
"<guilabel>Fixing up cross-references between documents.</guilabel> After "
"installing the HTML files, <application>gtkdoc-fixxref</application> can be "
@@ -513,18 +517,17 @@ msgstr ""
"esa documentación está instalada)."
#. (itstool) path: sect1/title
-#: C/index.docbook:312
+#: C/index.docbook:318
msgid "Getting GTK-Doc"
msgstr "Obtener GTK-Doc"
#. (itstool) path: sect2/title
-#: C/index.docbook:315
+#: C/index.docbook:321
msgid "Requirements"
msgstr "Requerimientos"
#. (itstool) path: sect2/para
-#: C/index.docbook:316
-#| msgid "<guilabel>Perl v5</guilabel> - the main scripts are in Perl."
+#: C/index.docbook:322
msgid ""
"<guilabel>python 2/3</guilabel> - the main scripts are written in python."
msgstr ""
@@ -532,7 +535,7 @@ msgstr ""
"python."
#. (itstool) path: sect2/para
-#: C/index.docbook:319
+#: C/index.docbook:325
msgid ""
"<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="
"\"http://xmlsoft.org/XSLT/\"; type=\"http\">xmlsoft.org/XSLT/</ulink>"
@@ -541,7 +544,7 @@ msgstr ""
"\"http://xmlsoft.org/XSLT/\"; type=\"http\">xmlsoft.org/XSLT/</ulink>"
#. (itstool) path: sect2/para
-#: C/index.docbook:323
+#: C/index.docbook:329
msgid ""
"<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url="
"\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\"; type=\"http"
@@ -552,7 +555,7 @@ msgstr ""
"\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
#. (itstool) path: sect2/para
-#: C/index.docbook:327
+#: C/index.docbook:333
msgid ""
"One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
"or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
@@ -563,17 +566,17 @@ msgstr ""
"los ejemplos."
#. (itstool) path: sect1/title
-#: C/index.docbook:335
+#: C/index.docbook:341
msgid "About GTK-Doc"
msgstr "Acerca de GTK-Doc"
#. (itstool) path: sect1/para
-#: C/index.docbook:337 C/index.docbook:351
+#: C/index.docbook:343 C/index.docbook:357
msgid "(FIXME)"
msgstr "(ARRÉGLAME)"
#. (itstool) path: sect1/para
-#: C/index.docbook:341
+#: C/index.docbook:347
msgid ""
"(History, authors, web pages, mailing list, license, future plans, "
"comparison with other similar systems.)"
@@ -582,22 +585,22 @@ msgstr ""
"futuros, comparación con otros sistemas similares.)"
#. (itstool) path: sect1/title
-#: C/index.docbook:349
+#: C/index.docbook:355
msgid "About this Manual"
msgstr "Acerca de este manual"
#. (itstool) path: sect1/para
-#: C/index.docbook:355
+#: C/index.docbook:361
msgid "(who it is meant for, where you can get it, license)"
msgstr "(a quién está dirigido, dónde puede obtenerse, licencia)"
#. (itstool) path: chapter/title
-#: C/index.docbook:364
+#: C/index.docbook:370
msgid "Setting up your project"
msgstr "Configurando su proyecto"
#. (itstool) path: chapter/para
-#: C/index.docbook:366
+#: C/index.docbook:372
msgid ""
"The next sections describe what steps to perform to integrate GTK-Doc into "
"your project. Theses sections assume we work on a project called 'meep'. "
@@ -617,12 +620,12 @@ msgstr ""
"construcción diferente."
#. (itstool) path: sect1/title
-#: C/index.docbook:377
+#: C/index.docbook:383
msgid "Setting up a skeleton documentation"
msgstr "Configurar el esquema de la documentación"
#. (itstool) path: sect1/para
-#: C/index.docbook:379
+#: C/index.docbook:385
msgid ""
"Under your top-level project directory create folders called docs/reference "
"(this way you can also have docs/help for end-user documentation). It is "
@@ -635,12 +638,12 @@ msgstr ""
"Para paquetes con una sola biblioteca este paso no es necesario."
#. (itstool) path: example/title
-#: C/index.docbook:388
+#: C/index.docbook:394
msgid "Example directory structure"
msgstr "Ejemplo de estructura de carpetas"
#. (itstool) path: example/programlisting
-#: C/index.docbook:389
+#: C/index.docbook:395
#, no-wrap
msgid ""
"\n"
@@ -664,18 +667,18 @@ msgstr ""
" meeper/\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:386
+#: C/index.docbook:392
msgid "This can then look as shown below: <_:example-1/>"
msgstr "Esto después aparecerá como se muestra debajo: <_:example-1/>"
#. (itstool) path: sect1/title
#. (itstool) path: example/title
-#: C/index.docbook:404 C/index.docbook:411
+#: C/index.docbook:410 C/index.docbook:417
msgid "Integration with autoconf"
msgstr "Integración con autoconf"
#. (itstool) path: sect1/para
-#: C/index.docbook:406
+#: C/index.docbook:412
msgid ""
"Very easy! Just add one line to your <filename>configure.ac</filename> "
"script."
@@ -684,7 +687,7 @@ msgstr ""
"filename>."
#. (itstool) path: example/programlisting
-#: C/index.docbook:412
+#: C/index.docbook:418
#, no-wrap
msgid ""
"\n"
@@ -696,12 +699,12 @@ msgstr ""
"GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
#. (itstool) path: example/title
-#: C/index.docbook:424
+#: C/index.docbook:430
msgid "Keep gtk-doc optional"
msgstr "Mantener gtk-doc como opcional"
#. (itstool) path: example/programlisting
-#: C/index.docbook:425
+#: C/index.docbook:431
#, no-wrap
msgid ""
"\n"
@@ -721,7 +724,7 @@ msgstr ""
"])\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:419
+#: C/index.docbook:425
msgid ""
"This will require all developers to have gtk-doc installed. If it is okay "
"for your project to have optional api-doc build setup, you can solve this as "
@@ -735,7 +738,7 @@ msgstr ""
"<_:example-1/>"
#. (itstool) path: sect1/para
-#: C/index.docbook:436
+#: C/index.docbook:442
msgid ""
"The first argument is used to check for the gtkdocversion at configure time. "
"The 2nd, optional argument is used by <application>gtkdocize</application>. "
@@ -748,19 +751,19 @@ msgstr ""
"symbol> también añade diversas opciones de configuración:"
#. (itstool) path: listitem/para
-#: C/index.docbook:442
+#: C/index.docbook:448
msgid "--with-html-dir=PATH : path to installed docs"
msgstr "--with-html-dir=RUTA: ruta a los documentos instalados"
#. (itstool) path: listitem/para
-#: C/index.docbook:443
+#: C/index.docbook:449
msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
msgstr ""
"--enable-gtk-doc: usar gtk-doc para construir la documentación "
"[predeterminado=no]"
#. (itstool) path: listitem/para
-#: C/index.docbook:444
+#: C/index.docbook:450
msgid ""
"--enable-gtk-doc-html : build documentation in html format [default=yes]"
msgstr ""
@@ -768,14 +771,14 @@ msgstr ""
"[predeterminado=sí]"
#. (itstool) path: listitem/para
-#: C/index.docbook:445
+#: C/index.docbook:451
msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
msgstr ""
"--enable-gtk-doc: usar gtk-doc para construir la documentación "
"[predeterminado=no]"
#. (itstool) path: important/para
-#: C/index.docbook:449
+#: C/index.docbook:455
msgid ""
"GTK-Doc is disabled by default! Remember to pass the option <option>'--"
"enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
@@ -789,7 +792,7 @@ msgstr ""
"desarrolladores)."
#. (itstool) path: sect1/para
-#: C/index.docbook:457
+#: C/index.docbook:463
msgid ""
"Furthermore it is recommended that you have the following line inside your "
"<filename>configure.ac</filename> script. This allows "
@@ -802,12 +805,12 @@ msgstr ""
"<function>GTK_DOC_CHECK</function> a su proyecto."
#. (itstool) path: example/title
-#: C/index.docbook:465
+#: C/index.docbook:471
msgid "Preparation for gtkdocize"
msgstr "Preparación para gtkdocize"
#. (itstool) path: example/programlisting
-#: C/index.docbook:466
+#: C/index.docbook:472
#, no-wrap
msgid ""
"\n"
@@ -817,7 +820,7 @@ msgstr ""
"AC_CONFIG_MACRO_DIR(m4)\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:471
+#: C/index.docbook:477
msgid ""
"After all changes to <filename>configure.ac</filename> are made, update the "
"<filename>configure</filename> file. This can be done by re-running "
@@ -828,12 +831,12 @@ msgstr ""
"volviendo a ejecutar <code>autoreconf -i</code> o <code>autogen.sh</code>."
#. (itstool) path: sect1/title
-#: C/index.docbook:479
+#: C/index.docbook:485
msgid "Integration with automake"
msgstr "Integración con automake"
#. (itstool) path: sect1/para
-#: C/index.docbook:481
+#: C/index.docbook:487
msgid ""
"First copy the <filename>Makefile.am</filename> from the <filename class="
"\"directory\">examples</filename> sub directory of the <ulink url=\"https://";
@@ -854,7 +857,7 @@ msgstr ""
"repítalo para cada uno de ellos."
#. (itstool) path: sect1/para
-#: C/index.docbook:492
+#: C/index.docbook:498
msgid ""
"The next step is to edit the settings inside the <filename>Makefile.am</"
"filename>. All the settings have a comment above that describes their "
@@ -871,12 +874,12 @@ msgstr ""
"soportan <option>--help</option> para listar los parámetros que soportan."
#. (itstool) path: sect1/title
-#: C/index.docbook:506
+#: C/index.docbook:512
msgid "Integration with autogen"
msgstr "Integración con autogen"
#. (itstool) path: sect1/para
-#: C/index.docbook:508
+#: C/index.docbook:514
msgid ""
"Most projects will have an <filename>autogen.sh</filename> script to setup "
"the build infrastructure after a checkout from version control system (such "
@@ -892,12 +895,12 @@ msgstr ""
"automake o autoconf."
#. (itstool) path: example/title
-#: C/index.docbook:517
+#: C/index.docbook:523
msgid "Running gtkdocize from autogen.sh"
msgstr "Ejecutar gtkdocize desde autogen.sh"
#. (itstool) path: example/programlisting
-#: C/index.docbook:518
+#: C/index.docbook:524
#, no-wrap
msgid ""
"\n"
@@ -907,7 +910,7 @@ msgstr ""
"gtkdocize || exit 1\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:524
+#: C/index.docbook:530
msgid ""
"When running <application>gtkdocize</application> it copies <filename>gtk-"
"doc.make</filename> to your project root (or any directory specified by the "
@@ -923,7 +926,7 @@ msgstr ""
"<application>gtkdocize</application>."
#. (itstool) path: sect1/para
-#: C/index.docbook:533
+#: C/index.docbook:539
msgid ""
"Historically GTK-Doc was generating template files where developers entered "
"the docs. This turned out to be not so good (e.g. the need for having "
@@ -957,12 +960,12 @@ msgstr ""
#. (itstool) path: sect1/title
#. (itstool) path: example/title
-#: C/index.docbook:550 C/index.docbook:567
+#: C/index.docbook:556 C/index.docbook:573
msgid "Running the doc build"
msgstr "Ejecutar la construcción de la documentación"
#. (itstool) path: sect1/para
-#: C/index.docbook:552
+#: C/index.docbook:558
msgid ""
"After the previous steps it's time to run the build. First we need to rerun "
"<filename>autogen.sh</filename>. If this script runs configure for you, then "
@@ -976,7 +979,7 @@ msgstr ""
"<filename>configure</filename> con esta opción."
#. (itstool) path: sect1/para
-#: C/index.docbook:559
+#: C/index.docbook:565
msgid ""
"The first make run generates several additional files in the doc-"
"directories. The important ones are: <filename><package>.types</"
@@ -989,7 +992,7 @@ msgstr ""
"pasado), <filename><paquete>-sections.txt</filename>."
#. (itstool) path: example/programlisting
-#: C/index.docbook:568
+#: C/index.docbook:574
#, no-wrap
msgid ""
"\n"
@@ -1001,7 +1004,7 @@ msgstr ""
"make\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:574
+#: C/index.docbook:580
msgid ""
"Now you can point your browser to <filename>docs/reference/<package>/"
"index.html</filename>. Yes, it's a bit disappointing still. But hang-on, "
@@ -1013,12 +1016,12 @@ msgstr ""
"información."
#. (itstool) path: sect1/title
-#: C/index.docbook:582
+#: C/index.docbook:588
msgid "Integration with version control systems"
msgstr "Integración con los sistemas de control de versiones"
#. (itstool) path: sect1/para
-#: C/index.docbook:584
+#: C/index.docbook:590
msgid ""
"As a rule of thumb, it's the files you edit which should go under version "
"control. For typical projects it's these files: <filename><package>."
@@ -1033,7 +1036,7 @@ msgstr ""
"txt</filename>, <filename>Makefile.am</filename>."
#. (itstool) path: sect1/para
-#: C/index.docbook:592
+#: C/index.docbook:598
msgid ""
"Files in the <filename>xml/</filename> and <filename>html/</filename> "
"directories should not go under version control. Neither should any of the "
@@ -1044,12 +1047,12 @@ msgstr ""
"los archivos <filename>.stamp</filename>."
#. (itstool) path: sect1/title
-#: C/index.docbook:600
+#: C/index.docbook:606
msgid "Integration with plain makefiles or other build systems"
msgstr "Integración con makefiles u otros sistemas de construcción"
#. (itstool) path: sect1/para
-#: C/index.docbook:602
+#: C/index.docbook:608
msgid ""
"In the case one does not want to use automake and therefore <filename>gtk-"
"doc.mak</filename> one will need to call the gtkdoc tools in the right order "
@@ -1060,12 +1063,12 @@ msgstr ""
"makefiles propios (o en otras herramientas de construcción)."
#. (itstool) path: example/title
-#: C/index.docbook:609
+#: C/index.docbook:615
msgid "Documentation build steps"
msgstr "Pasos de construcción de la documentación"
#. (itstool) path: example/programlisting
-#: C/index.docbook:610
+#: C/index.docbook:616
#, no-wrap
msgid ""
"\n"
@@ -1091,7 +1094,7 @@ msgstr ""
"gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:624
+#: C/index.docbook:630
msgid ""
"One will need to look at the <filename>Makefile.am</filename> and "
"<filename>gtk-doc.mak</filename> to pick the extra options needed."
@@ -1100,12 +1103,12 @@ msgstr ""
"doc.mak</filename> para elegir las opciones adicionales necesarias."
#. (itstool) path: sect1/title
-#: C/index.docbook:631
+#: C/index.docbook:637
msgid "Integration with CMake build systems"
msgstr "Integración con sistemas de construcción CMake"
#. (itstool) path: sect1/para
-#: C/index.docbook:633
+#: C/index.docbook:639
msgid ""
"GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
"the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
@@ -1119,12 +1122,12 @@ msgstr ""
"filename>."
#. (itstool) path: example/title
-#: C/index.docbook:643
+#: C/index.docbook:649
msgid "Example of using GTK-Doc from CMake"
msgstr "Ejeplo de uso de GTK-Doc desde CMake"
#. (itstool) path: example/programlisting
-#: C/index.docbook:644
+#: C/index.docbook:650
#, no-wrap
msgid ""
"\n"
@@ -1166,17 +1169,17 @@ msgstr ""
" DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:641
+#: C/index.docbook:647
msgid "The following example shows how to use this command. <_:example-1/>"
msgstr "El siguiente ejemplo muestra cómo usar este comando. <_:example-1/>"
#. (itstool) path: chapter/title
-#: C/index.docbook:669
+#: C/index.docbook:675
msgid "Documenting the code"
msgstr "Documentar el código"
#. (itstool) path: chapter/para
-#: C/index.docbook:671
+#: C/index.docbook:677
msgid ""
"GTK-Doc uses source code comment with a special syntax for code "
"documentation. Further it retrieves information about your project structure "
@@ -1189,12 +1192,12 @@ msgstr ""
"acerca de la sintaxis de los comentarios."
#. (itstool) path: note/title
-#: C/index.docbook:679
+#: C/index.docbook:685
msgid "Documentation placement"
msgstr "Ubicación de la documentación"
#. (itstool) path: note/para
-#: C/index.docbook:680
+#: C/index.docbook:686
msgid ""
"In the past most documentation had to be filled into files residing inside "
"the <filename>tmpl</filename> directory. This has the disadvantages that the "
@@ -1208,7 +1211,7 @@ msgstr ""
"conflictos con los sistemas de control de versiones."
#. (itstool) path: note/para
-#: C/index.docbook:686
+#: C/index.docbook:692
msgid ""
"The avoid the aforementioned problems we suggest putting the documentation "
"inside the sources. This manual will only describe this way of documenting "
@@ -1219,12 +1222,12 @@ msgstr ""
"documentar el código."
#. (itstool) path: example/title
-#: C/index.docbook:697 C/index.docbook:723
+#: C/index.docbook:703 C/index.docbook:729
msgid "GTK-Doc comment block"
msgstr "Bloque de comentario de GTK-Doc"
#. (itstool) path: example/programlisting
-#: C/index.docbook:698
+#: C/index.docbook:704
#, no-wrap
msgid ""
"\n"
@@ -1238,7 +1241,7 @@ msgstr ""
"#endif\n"
#. (itstool) path: chapter/para
-#: C/index.docbook:693
+#: C/index.docbook:699
msgid ""
"The scanner can handle the majority of C headers fine. In the case of "
"receiving warnings from the scanner that look like a special case, one can "
@@ -1249,12 +1252,12 @@ msgstr ""
"GTK-Doc que los omita. <_:example-1/>"
#. (itstool) path: note/title
-#: C/index.docbook:707
+#: C/index.docbook:713
msgid "Limitations"
msgstr "Limitaciones"
#. (itstool) path: note/para
-#: C/index.docbook:708
+#: C/index.docbook:714
msgid ""
"Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
"not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
@@ -1263,12 +1266,12 @@ msgstr ""
"pero <code>#if !defined(__GTK_DOC_IGNORE__)</code> u otras combinaciones."
#. (itstool) path: sect1/title
-#: C/index.docbook:718
+#: C/index.docbook:724
msgid "Documentation comments"
msgstr "Comentarios de la documentación"
#. (itstool) path: example/programlisting
-#: C/index.docbook:724
+#: C/index.docbook:730
#, no-wrap
msgid ""
"\n"
@@ -1284,7 +1287,7 @@ msgstr ""
" */\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:720
+#: C/index.docbook:726
msgid ""
"A multiline comment that starts with an additional '*' marks a documentation "
"block that will be processed by the GTK-Doc tools. <_:example-1/>"
@@ -1293,7 +1296,7 @@ msgstr ""
"bloque de documentación que GTK-Doc tools procesarán. <_:example-1/>"
#. (itstool) path: sect1/para
-#: C/index.docbook:733
+#: C/index.docbook:739
msgid ""
"The 'identifier' is one line with the name of the item the comment is "
"related to. The syntax differs a little depending on the item. (TODO add "
@@ -1304,7 +1307,7 @@ msgstr ""
"hacer: añadir una tabla mostrando los identificadores)"
#. (itstool) path: sect1/para
-#: C/index.docbook:739
+#: C/index.docbook:745
msgid ""
"The 'documentation' block is also different for each symbol type. Symbol "
"types that get parameters such as functions or macros have the parameter "
@@ -1324,7 +1327,7 @@ msgstr ""
"espacio). Esto es útil para texto preformateado (listados de código)."
#. (itstool) path: listitem/para
-#: C/index.docbook:756
+#: C/index.docbook:762
msgid ""
"What it is: The name for a class or function can sometimes be misleading for "
"people coming from a different background."
@@ -1333,24 +1336,24 @@ msgstr ""
"personas que provengan de otros entornos."
#. (itstool) path: listitem/para
-#: C/index.docbook:762
+#: C/index.docbook:768
msgid ""
"What it does: Tell about common uses. Put it in relation with the other API."
msgstr "Qué hace: indique los usos comunes, en relación con las otras API."
#. (itstool) path: tip/para
-#: C/index.docbook:752
+#: C/index.docbook:758
msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
msgstr "Al documentar código, describa dos aspectos: <_:itemizedlist-1/>"
#. (itstool) path: listitem/para
-#: C/index.docbook:777
+#: C/index.docbook:783
msgid "Use function() to refer to functions or macros which take arguments."
msgstr ""
"Use función() para referirse a funciones o macros que toman argumentos."
#. (itstool) path: listitem/para
-#: C/index.docbook:782
+#: C/index.docbook:788
msgid ""
"Use @param to refer to parameters. Also use this when referring to "
"parameters of other functions, related to the one being described."
@@ -1359,12 +1362,12 @@ msgstr ""
"parámetros de otras funciones, relacionados al que se describe."
#. (itstool) path: listitem/para
-#: C/index.docbook:788
+#: C/index.docbook:794
msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
msgstr "Use %constant para referirse a una constante, ej: %G_TRAVERSE_LEAFS."
#. (itstool) path: listitem/para
-#: C/index.docbook:793
+#: C/index.docbook:799
msgid ""
"Use #symbol to refer to other types of symbol, e.g. structs and enums and "
"macros which don't take arguments."
@@ -1373,17 +1376,17 @@ msgstr ""
"estructuras, enumeraciones y macros que no toman argumentos."
#. (itstool) path: listitem/para
-#: C/index.docbook:799
+#: C/index.docbook:805
msgid "Use #Object::signal to refer to a GObject signal."
msgstr "Use #Object::signal para referirse a una señal de GObject."
#. (itstool) path: listitem/para
-#: C/index.docbook:804
+#: C/index.docbook:810
msgid "Use #Object:property to refer to a GObject property."
msgstr "Use #Object:property para referirse a una propiedad de GObject."
#. (itstool) path: listitem/para
-#: C/index.docbook:809
+#: C/index.docbook:815
msgid ""
"Use #Struct.field to refer to a field inside a structure and #GObjectClass."
"foo_bar() to refer to a vmethod."
@@ -1392,7 +1395,7 @@ msgstr ""
"#GObjectClass.foo_bar() para referirse a un vmethod."
#. (itstool) path: sect1/para
-#: C/index.docbook:771
+#: C/index.docbook:777
msgid ""
"One advantage of hyper-text over plain-text is the ability to have links in "
"the document. Writing the correct markup for a link can be tedious though. "
@@ -1405,7 +1408,7 @@ msgstr ""
"itemizedlist-1/>"
#. (itstool) path: tip/para
-#: C/index.docbook:818
+#: C/index.docbook:824
msgid ""
"If you need to use the special characters '<', '>', '()', '@', '%', or "
"'#' in your documentation without GTK-Doc changing them you can use the XML "
@@ -1420,7 +1423,7 @@ msgstr ""
"doble «\\»."
#. (itstool) path: sect1/para
-#: C/index.docbook:827
+#: C/index.docbook:833
msgid ""
"DocBook can do more than just links. One can also have lists, examples, "
"headings, and images. As of version 1.20, the preferred way is to use a "
@@ -1438,7 +1441,7 @@ msgstr ""
"elementos de una lista aparecerán como líneas que empiezan con un guión."
#. (itstool) path: sect1/para
-#: C/index.docbook:838
+#: C/index.docbook:844
msgid ""
"While markdown is now preferred one can mix both. One limitation here is "
"that one can use docbook xml within markdown, but markdown within docbook "
@@ -1449,7 +1452,7 @@ msgstr ""
"xml no está soportado."
#. (itstool) path: sect1/para
-#: C/index.docbook:844
+#: C/index.docbook:850
msgid ""
"In older GTK-Doc releases, if you need support for additional formatting, "
"you would need to enable the usage of docbook XML tags inside doc-comments "
@@ -1464,12 +1467,12 @@ msgstr ""
"<filename>Makefile.am</filename>."
#. (itstool) path: example/title
-#: C/index.docbook:853
+#: C/index.docbook:859
msgid "GTK-Doc comment block using Markdown"
msgstr "Bloque de comentario de GTK-Doc usando marcado"
#. (itstool) path: example/programlisting
-#: C/index.docbook:854
+#: C/index.docbook:860
#, no-wrap
msgid ""
"\n"
@@ -1545,7 +1548,7 @@ msgstr ""
" */\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:893
+#: C/index.docbook:899
msgid ""
"More examples of what markdown tags are supported can be found in the <ulink "
"url=\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown";
@@ -1557,7 +1560,7 @@ msgstr ""
"GTK+</ulink>."
#. (itstool) path: tip/para
-#: C/index.docbook:899
+#: C/index.docbook:905
msgid ""
"As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
"cannot write documentation for static symbols. Nevertheless it is good to "
@@ -1578,12 +1581,12 @@ msgstr ""
"secciones."
#. (itstool) path: sect1/title
-#: C/index.docbook:913
+#: C/index.docbook:919
msgid "Documenting sections"
msgstr "Documentar secciones"
#. (itstool) path: sect1/para
-#: C/index.docbook:915
+#: C/index.docbook:921
msgid ""
"Each section of the documentation contains information about one class or "
"module. To introduce the component one can write a section block. The short "
@@ -1596,12 +1599,12 @@ msgstr ""
"los campos @ son opcionales."
#. (itstool) path: example/title
-#: C/index.docbook:923
+#: C/index.docbook:929
msgid "Section comment block"
msgstr "Bloque de comentarios en una sección"
#. (itstool) path: example/programlisting
-#: C/index.docbook:924
+#: C/index.docbook:930
#, no-wrap
msgid ""
"\n"
@@ -1633,12 +1636,12 @@ msgstr ""
" */\n"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:943
+#: C/index.docbook:949
msgid "SECTION:<name>"
msgstr "SECCIÓN <nombre>"
#. (itstool) path: listitem/para
-#: C/index.docbook:945
+#: C/index.docbook:951
msgid ""
"The name links the section documentation to the respective part in the "
"<filename><package>-sections.txt</filename> file. The name given here "
@@ -1651,12 +1654,12 @@ msgstr ""
"archivo <filename><paquete>-sections.txt</filename>."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:954
+#: C/index.docbook:960
msgid "@short_description"
msgstr "@short_description"
#. (itstool) path: listitem/para
-#: C/index.docbook:956
+#: C/index.docbook:962
msgid ""
"A one line description of the section, that later will appear after the "
"links in the TOC and at the top of the section page."
@@ -1665,12 +1668,12 @@ msgstr ""
"TOC y en la página de la sección."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:963
+#: C/index.docbook:969
msgid "@title"
msgstr "@title"
#. (itstool) path: listitem/para
-#: C/index.docbook:965
+#: C/index.docbook:971
msgid ""
"The section title defaults to <name> from the SECTION declaration. It "
"can be overridden with the @title field."
@@ -1679,12 +1682,12 @@ msgstr ""
"declaración SECTION. Se puede sobrescribir con el campo @title."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:972
+#: C/index.docbook:978
msgid "@section_id"
msgstr "@section_id"
#. (itstool) path: listitem/para
-#: C/index.docbook:974
+#: C/index.docbook:980
msgid ""
"Overrides the use of title as a section identifier. For GObjects the <"
"title> is used as a section_id and for other sections it is <"
@@ -1695,22 +1698,22 @@ msgstr ""
"para otra sección es <MÓDULO>-<title>."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:982
+#: C/index.docbook:988
msgid "@see_also"
msgstr "@see_also"
#. (itstool) path: listitem/para
-#: C/index.docbook:984
+#: C/index.docbook:990
msgid "A list of symbols that are related to this section."
msgstr "Una lista de símbolos relacionados con esta sección."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:990
+#: C/index.docbook:996
msgid "@stability"
msgstr "@stability"
#. (itstool) path: listitem/para
-#: C/index.docbook:997
+#: C/index.docbook:1003
msgid ""
"Stable - The intention of a Stable interface is to enable arbitrary third "
"parties to develop applications to these interfaces, release them, and have "
@@ -1728,7 +1731,7 @@ msgstr ""
"de haberlos habrá buenas razones para ello."
#. (itstool) path: listitem/para
-#: C/index.docbook:1009
+#: C/index.docbook:1015
msgid ""
"Unstable - Unstable interfaces are experimental or transitional. They are "
"typically used to give outside developers early access to new or rapidly "
@@ -1744,7 +1747,7 @@ msgstr ""
"publicación menor a la siguiente."
#. (itstool) path: listitem/para
-#: C/index.docbook:1021
+#: C/index.docbook:1027
msgid ""
"Private - An interface that can be used within the GNOME stack itself, but "
"that is not documented for end-users. Such functions should only be used in "
@@ -1755,7 +1758,7 @@ msgstr ""
"deberían usar de formas especificadas y documentadas."
#. (itstool) path: listitem/para
-#: C/index.docbook:1030
+#: C/index.docbook:1036
msgid ""
"Internal - An interface that is internal to a module and does not require "
"end-user documentation. Functions that are undocumented are assumed to be "
@@ -1766,7 +1769,7 @@ msgstr ""
"son internas."
#. (itstool) path: listitem/para
-#: C/index.docbook:992
+#: C/index.docbook:998
msgid ""
"An informal description of the stability level this API has. We recommend "
"the use of one of these terms: <_:itemizedlist-1/>"
@@ -1775,12 +1778,12 @@ msgstr ""
"recomienda el uso de uno de estos términos: <_:itemizedlist-1/>"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1042
+#: C/index.docbook:1048
msgid "@include"
msgstr "@include"
#. (itstool) path: listitem/para
-#: C/index.docbook:1044
+#: C/index.docbook:1050
msgid ""
"The <literal>#include</literal> files to show in the section synopsis (a "
"comma separated list), overriding the global value from the <link linkend="
@@ -1793,12 +1796,12 @@ msgstr ""
"línea de comandos. Este elemento es opcional."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1053
+#: C/index.docbook:1059
msgid "@image"
msgstr "@image"
#. (itstool) path: listitem/para
-#: C/index.docbook:1055
+#: C/index.docbook:1061
msgid ""
"The image to display at the top of the reference page for this section. This "
"will often be some sort of a diagram to illustrate the visual appearance of "
@@ -1811,7 +1814,7 @@ msgstr ""
"Este elemento es opcional."
#. (itstool) path: tip/para
-#: C/index.docbook:1066
+#: C/index.docbook:1072
msgid ""
"To avoid unnecessary recompilation after doc-changes put the section docs "
"into the c-source where possible."
@@ -1821,12 +1824,12 @@ msgstr ""
"sea posible."
#. (itstool) path: sect1/title
-#: C/index.docbook:1075
+#: C/index.docbook:1081
msgid "Documenting symbols"
msgstr "Documentar símbolos"
#. (itstool) path: sect1/para
-#: C/index.docbook:1077
+#: C/index.docbook:1083
msgid ""
"Each symbol (function, macro, struct, enum, signal and property) is "
"documented in a separate block. The block is best placed close to the "
@@ -1842,12 +1845,12 @@ msgstr ""
#. (itstool) path: sect2/title
#. (itstool) path: example/title
-#: C/index.docbook:1085 C/index.docbook:1151
+#: C/index.docbook:1091 C/index.docbook:1157
msgid "General tags"
msgstr "Etiquetas generales"
#. (itstool) path: sect2/para
-#: C/index.docbook:1087
+#: C/index.docbook:1093
msgid ""
"You can add versioning information to all documentation elements to tell "
"when an API was introduced, or when it was deprecated."
@@ -1857,27 +1860,27 @@ msgstr ""
"obsoleta."
#. (itstool) path: variablelist/title
-#: C/index.docbook:1092
+#: C/index.docbook:1098
msgid "Versioning Tags"
msgstr "Versionado de etiquetas"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1093
+#: C/index.docbook:1099
msgid "Since:"
msgstr "Desde:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1095
+#: C/index.docbook:1101
msgid "Description since which version of the code the API is available."
msgstr "Descripción desde qué versión del código está disponible la API."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1100
+#: C/index.docbook:1106
msgid "Deprecated:"
msgstr "Obsoleto:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1102
+#: C/index.docbook:1108
msgid ""
"Paragraph denoting that this function should no be used anymore. The "
"description should point the reader to the new API."
@@ -1886,7 +1889,7 @@ msgstr ""
"debería informar al lector de la nueva API."
#. (itstool) path: sect2/para
-#: C/index.docbook:1110
+#: C/index.docbook:1116
msgid ""
"You can also add stability information to all documentation elements to "
"indicate whether API stability is guaranteed for them for all future minor "
@@ -1897,7 +1900,7 @@ msgstr ""
"todas las versiones menores futuras del proyecto."
#. (itstool) path: sect2/para
-#: C/index.docbook:1116
+#: C/index.docbook:1122
msgid ""
"The default stability level for all documentation elements can be set by "
"passing the <option>--default-stability</option> argument to "
@@ -1909,17 +1912,17 @@ msgstr ""
"siguientes valores."
#. (itstool) path: variablelist/title
-#: C/index.docbook:1122
+#: C/index.docbook:1128
msgid "Stability Tags"
msgstr "Etiquetas de estabilidad"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1123
+#: C/index.docbook:1129
msgid "Stability: Stable"
msgstr "Estabilidad: estable"
#. (itstool) path: listitem/para
-#: C/index.docbook:1125
+#: C/index.docbook:1131
msgid ""
"Mark the element as stable. This is for public APIs which are guaranteed to "
"remain stable for all future minor releases of the project."
@@ -1929,12 +1932,12 @@ msgstr ""
"proyecto."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1132
+#: C/index.docbook:1138
msgid "Stability: Unstable"
msgstr "Estabilidad: inestable"
#. (itstool) path: listitem/para
-#: C/index.docbook:1134
+#: C/index.docbook:1140
msgid ""
"Mark the element as unstable. This is for public APIs which are released as "
"a preview before being stabilised."
@@ -1943,12 +1946,12 @@ msgstr ""
"publican como versión previa antes de estabilizarse."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1140
+#: C/index.docbook:1146
msgid "Stability: Private"
msgstr "Estabilidad: privado"
#. (itstool) path: listitem/para
-#: C/index.docbook:1142
+#: C/index.docbook:1148
msgid ""
"Mark the element as private. This is for interfaces which can be used by "
"tightly coupled modules, but not by arbitrary third parties."
@@ -1957,7 +1960,7 @@ msgstr ""
"en módulos fuertemente acoplados, pero no en terceras partes aleatorias."
#. (itstool) path: example/programlisting
-#: C/index.docbook:1152
+#: C/index.docbook:1158
#, no-wrap
msgid ""
"\n"
@@ -1996,12 +1999,12 @@ msgstr ""
#. (itstool) path: sect2/title
#. (itstool) path: example/title
-#: C/index.docbook:1172 C/index.docbook:1182
+#: C/index.docbook:1178 C/index.docbook:1188
msgid "Annotations"
msgstr "Anotaciones"
#. (itstool) path: sect2/para
-#: C/index.docbook:1174
+#: C/index.docbook:1180
msgid ""
"Documentation blocks can contain annotation-tags. These tags will be "
"rendered with tooltips describing their meaning. The tags are used by "
@@ -2017,7 +2020,7 @@ msgstr ""
"type=\"http\">el wiki</ulink>."
#. (itstool) path: example/programlisting
-#: C/index.docbook:1183
+#: C/index.docbook:1189
#, no-wrap
msgid ""
"\n"
@@ -2058,12 +2061,12 @@ msgstr ""
#. (itstool) path: sect2/title
#. (itstool) path: example/title
-#: C/index.docbook:1204 C/index.docbook:1233
+#: C/index.docbook:1210 C/index.docbook:1239
msgid "Function comment block"
msgstr "Bloque de comentario de función"
#. (itstool) path: listitem/para
-#: C/index.docbook:1210
+#: C/index.docbook:1216
msgid ""
"Document whether returned objects, lists, strings, etc, should be freed/"
"unrefed/released."
@@ -2072,26 +2075,26 @@ msgstr ""
"debería liberarse/desreferenciarse/etc."
#. (itstool) path: listitem/para
-#: C/index.docbook:1216
+#: C/index.docbook:1222
msgid "Document whether parameters can be NULL, and what happens if they are."
msgstr ""
"El documento, dependiendo de si sus parámetros pueden ser nulos, y qué "
"sucede si lo son."
#. (itstool) path: listitem/para
-#: C/index.docbook:1221
+#: C/index.docbook:1227
msgid ""
"Mention interesting pre-conditions and post-conditions where appropriate."
msgstr ""
"Mencionar precondiciones y postcondiciones interesantes donde sea apropiado."
#. (itstool) path: sect2/para
-#: C/index.docbook:1206 C/index.docbook:1292
+#: C/index.docbook:1212 C/index.docbook:1298
msgid "Please remember to: <_:itemizedlist-1/>"
msgstr "Recuerde: <_:itemizedlist-1/>"
#. (itstool) path: sect2/para
-#: C/index.docbook:1228
+#: C/index.docbook:1234
msgid ""
"Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
"private. They are treated like static functions."
@@ -2100,7 +2103,7 @@ msgstr ""
"«_» son privados. Se tratan como funciones estáticas."
#. (itstool) path: example/programlisting
-#: C/index.docbook:1234
+#: C/index.docbook:1240
#, no-wrap
msgid ""
"\n"
@@ -2142,27 +2145,27 @@ msgstr ""
" */\n"
#. (itstool) path: variablelist/title
-#: C/index.docbook:1255
+#: C/index.docbook:1261
msgid "Function tags"
msgstr "Etiquetas de funciones"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1256 C/index.docbook:1463
+#: C/index.docbook:1262 C/index.docbook:1469
msgid "Returns:"
msgstr "Devuelve:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1258
+#: C/index.docbook:1264
msgid "Paragraph describing the returned result."
msgstr "Párrafo que describe el resultado devuelto."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1263
+#: C/index.docbook:1269
msgid "@...:"
msgstr "@...:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1265
+#: C/index.docbook:1271
msgid ""
"In case the function has variadic arguments, you should use this tag "
"(@Varargs: does also work for historic reasons)."
@@ -2172,12 +2175,12 @@ msgstr ""
#. (itstool) path: sect2/title
#. (itstool) path: example/title
-#: C/index.docbook:1275 C/index.docbook:1277
+#: C/index.docbook:1281 C/index.docbook:1283
msgid "Property comment block"
msgstr "Bloque de comentario de propiedad"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1278
+#: C/index.docbook:1284
#, no-wrap
msgid ""
"\n"
@@ -2198,12 +2201,12 @@ msgstr ""
#. (itstool) path: sect2/title
#. (itstool) path: example/title
-#: C/index.docbook:1290 C/index.docbook:1309
+#: C/index.docbook:1296 C/index.docbook:1315
msgid "Signal comment block"
msgstr "Bloque de comentario de señal"
#. (itstool) path: listitem/para
-#: C/index.docbook:1296
+#: C/index.docbook:1302
msgid ""
"Document when the signal is emitted and whether it is emitted before or "
"after other signals."
@@ -2212,13 +2215,26 @@ msgstr ""
"otras señales."
#. (itstool) path: listitem/para
-#: C/index.docbook:1302
+#: C/index.docbook:1308
msgid "Document what an application might do in the signal handler."
msgstr "Documentar qué aplicación debe gestionar las señales."
#. (itstool) path: example/programlisting
-#: C/index.docbook:1310
+#: C/index.docbook:1316
#, no-wrap
+#| msgid ""
+#| "\n"
+#| "/**\n"
+#| " * FooWidget::foobarized:\n"
+#| " * @widget: the widget that received the signal\n"
+#| " * @foo: some foo\n"
+#| " * @bar: some bar\n"
+#| " *\n"
+#| " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
+#| " */\n"
+#| "foo_signals[FOOBARIZE] =\n"
+#| " g_signal_new (\"foobarize\",\n"
+#| " ...\n"
msgid ""
"\n"
"/**\n"
@@ -2229,8 +2245,8 @@ msgid ""
" *\n"
" * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
" */\n"
-"foo_signals[FOOBARIZE] =\n"
-" g_signal_new (\"foobarize\",\n"
+"foo_signals[FOOBARIZED] =\n"
+" g_signal_new (\"foobarized\",\n"
" ...\n"
msgstr ""
"\n"
@@ -2242,18 +2258,18 @@ msgstr ""
" *\n"
" * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
" */\n"
-"foo_signals[FOOBARIZE] =\n"
-" g_signal_new (\"foobarize\",\n"
+"foo_signals[FOOBARIZED] =\n"
+" g_signal_new (\"foobarized\",\n"
" ...\n"
#. (itstool) path: sect2/title
#. (itstool) path: example/title
-#: C/index.docbook:1327 C/index.docbook:1328
+#: C/index.docbook:1333 C/index.docbook:1334
msgid "Struct comment block"
msgstr "Bloque de comentario de estructura"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1329
+#: C/index.docbook:1335
#, no-wrap
msgid ""
"\n"
@@ -2283,7 +2299,7 @@ msgstr ""
"} FooWidget;\n"
#. (itstool) path: sect2/para
-#: C/index.docbook:1344
+#: C/index.docbook:1350
msgid ""
"Use <code>/*< private >*/</code> before the private struct fields you "
"want to hide. Use <code>/*< public >*/</code> for the reverse "
@@ -2294,7 +2310,7 @@ msgstr ""
"revertir el comportamiento anterior."
#. (itstool) path: sect2/para
-#: C/index.docbook:1350
+#: C/index.docbook:1356
msgid ""
"If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
"it will be considered private automatically and doesn't need to be mentioned "
@@ -2305,7 +2321,7 @@ msgstr ""
"bloque de comentario."
#. (itstool) path: sect2/para
-#: C/index.docbook:1356
+#: C/index.docbook:1362
msgid ""
"Struct comment blocks can also be used for GObjects and GObjectClasses. It "
"is usually a good idea to add a comment block for a class, if it has "
@@ -2325,12 +2341,12 @@ msgstr ""
#. (itstool) path: sect2/title
#. (itstool) path: example/title
-#: C/index.docbook:1368 C/index.docbook:1369
+#: C/index.docbook:1374 C/index.docbook:1375
msgid "Enum comment block"
msgstr "Enumerar bloques de comentarios"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1370
+#: C/index.docbook:1376
#, no-wrap
msgid ""
"\n"
@@ -2364,7 +2380,7 @@ msgstr ""
"} Something;\n"
#. (itstool) path: sect2/para
-#: C/index.docbook:1387
+#: C/index.docbook:1393
msgid ""
"Use <code>/*< private >*/</code> before the private enum values you "
"want to hide. Use <code>/*< public >*/</code> for the reverse "
@@ -2375,12 +2391,12 @@ msgstr ""
"comportamiento anterior."
#. (itstool) path: sect1/title
-#: C/index.docbook:1398
+#: C/index.docbook:1404
msgid "Inline program documentation"
msgstr "Documentación en línea del programa"
#. (itstool) path: sect1/para
-#: C/index.docbook:1399
+#: C/index.docbook:1405
msgid ""
"You can document programs and their commandline interface using inline "
"documentation."
@@ -2389,37 +2405,37 @@ msgstr ""
"documentación en línea."
#. (itstool) path: variablelist/title
-#: C/index.docbook:1405
+#: C/index.docbook:1411
msgid "Tags"
msgstr "Etiquetas"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1407
+#: C/index.docbook:1413
msgid "PROGRAM"
msgstr "PROGRAM"
#. (itstool) path: listitem/para
-#: C/index.docbook:1410
+#: C/index.docbook:1416
msgid "Defines the start of a program documentation."
msgstr "Define el inicio de la documentación de un programa."
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1417
+#: C/index.docbook:1423
msgid "@short_description:"
msgstr "@short_description:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1419
+#: C/index.docbook:1425
msgid "Defines a short description of the program. (Optional)"
msgstr "Define una descripción corta del programa. (Opcional)"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1426
+#: C/index.docbook:1432
msgid "@synopsis:"
msgstr "@synopsis:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1428
+#: C/index.docbook:1434
msgid ""
"Defines the arguments, or list of arguments that the program can take. "
"(Optional)"
@@ -2428,52 +2444,52 @@ msgstr ""
"(Opcional)"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1436
+#: C/index.docbook:1442
msgid "@see_also:"
msgstr "@see_also:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1438
+#: C/index.docbook:1444
msgid "See Also manual page section. (Optional)"
msgstr "Página del manual Ver también. (Opcional)"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1445
+#: C/index.docbook:1451
msgid "@arg:"
msgstr "@arg:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1447
+#: C/index.docbook:1453
msgid "Argument(s) passed to the program and their description. (Optional)"
msgstr "Argumentos pasados al programa y su descripción. (Opcional)"
#. (itstool) path: varlistentry/term
-#: C/index.docbook:1454
+#: C/index.docbook:1460
msgid "Description:"
msgstr "Description:"
#. (itstool) path: listitem/para
-#: C/index.docbook:1456
+#: C/index.docbook:1462
msgid "A longer description of the program."
msgstr "Una descripción más larga del programa."
#. (itstool) path: listitem/para
-#: C/index.docbook:1465
+#: C/index.docbook:1471
msgid "Specificy what value(s) the program returns. (Optional)"
msgstr "Especifique qué valores devuelve el programa. (Opcional)"
#. (itstool) path: sect2/title
-#: C/index.docbook:1474
+#: C/index.docbook:1480
msgid "Example of program documentation."
msgstr "Ejemplo de documentación de un programa."
#. (itstool) path: example/title
-#: C/index.docbook:1475
+#: C/index.docbook:1481
msgid "Program documentation block"
msgstr "Bloque de documentación del programa"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1476
+#: C/index.docbook:1482
#, no-wrap
msgid ""
"\n"
@@ -2517,19 +2533,19 @@ msgstr ""
"}\n"
#. (itstool) path: sect1/title
-#: C/index.docbook:1502
+#: C/index.docbook:1508
msgid "Useful DocBook tags"
msgstr "Etiquetas DocBook útiles"
#. (itstool) path: sect1/para
-#: C/index.docbook:1504
+#: C/index.docbook:1510
msgid ""
"Here are some DocBook tags which are most useful when documenting the code."
msgstr ""
"Aquí están varias etiquetas de DocBook muy útiles al documentar código."
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1513
+#: C/index.docbook:1519
#, no-wrap
msgid ""
"\n"
@@ -2539,7 +2555,7 @@ msgstr ""
"<link linkend=\"glib-Hash-Tables\">Hash Tables</link>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1509
+#: C/index.docbook:1515
msgid ""
"To link to another section in the GTK docs: <_:informalexample-1/> The "
"linkend is the SGML/XML id on the top item of the page you want to link to. "
@@ -2555,7 +2571,7 @@ msgstr ""
"ajustarse a SGML/XML."
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1526
+#: C/index.docbook:1532
#, no-wrap
msgid ""
"\n"
@@ -2565,7 +2581,7 @@ msgstr ""
"<function>...</function>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1523
+#: C/index.docbook:1529
msgid ""
"To refer to an external function, e.g. a standard C function: <_:"
"informalexample-1/>"
@@ -2574,7 +2590,7 @@ msgstr ""
"informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1535
+#: C/index.docbook:1541
#, no-wrap
msgid ""
"\n"
@@ -2594,7 +2610,7 @@ msgstr ""
"</example>\n"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1546
+#: C/index.docbook:1552
#, no-wrap
msgid ""
"\n"
@@ -2612,7 +2628,7 @@ msgstr ""
"</informalexample>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1532
+#: C/index.docbook:1538
msgid ""
"To include example code: <_:informalexample-1/> or possibly this, for very "
"short code fragments which don't need a title: <_:informalexample-2/> For "
@@ -2623,7 +2639,7 @@ msgstr ""
"informalexample-2/>. El último GTK-Doc también soporta abreviación: |[ ... ]|"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1565
+#: C/index.docbook:1571
#, no-wrap
msgid ""
"\n"
@@ -2655,12 +2671,12 @@ msgstr ""
"</itemizedlist>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1562
+#: C/index.docbook:1568
msgid "To include bulleted lists: <_:informalexample-1/>"
msgstr "Para incluir listas de topos: <_:informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1585
+#: C/index.docbook:1591
#, no-wrap
msgid ""
"\n"
@@ -2678,13 +2694,13 @@ msgstr ""
"</note>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1582
+#: C/index.docbook:1588
msgid ""
"To include a note which stands out from the text: <_:informalexample-1/>"
msgstr "Para incluir una nota que sobresale del texto: <_:informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1598
+#: C/index.docbook:1604
#, no-wrap
msgid ""
"\n"
@@ -2694,12 +2710,12 @@ msgstr ""
"<type>unsigned char</type>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1595
+#: C/index.docbook:1601
msgid "To refer to a type: <_:informalexample-1/>"
msgstr "Para referirse a un tipo: <_:informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1607
+#: C/index.docbook:1613
#, no-wrap
msgid ""
"\n"
@@ -2709,7 +2725,7 @@ msgstr ""
"<structname>XFontStruct</structname>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1604
+#: C/index.docbook:1610
msgid ""
"To refer to an external structure (not one described in the GTK docs): <_:"
"informalexample-1/>"
@@ -2718,7 +2734,7 @@ msgstr ""
"de GTK): <_:informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1616
+#: C/index.docbook:1622
#, no-wrap
msgid ""
"\n"
@@ -2728,12 +2744,12 @@ msgstr ""
"<structfield>len</structfield>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1613
+#: C/index.docbook:1619
msgid "To refer to a field of a structure: <_:informalexample-1/>"
msgstr "Para referirse a un campo o a una estructura: <_:informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1625
+#: C/index.docbook:1631
#, no-wrap
msgid ""
"\n"
@@ -2743,7 +2759,7 @@ msgstr ""
"<classname>GtkWidget</classname>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1622
+#: C/index.docbook:1628
msgid ""
"To refer to a class name, we could possibly use: <_:informalexample-1/> but "
"you'll probably be using #GtkWidget instead (to automatically create a link "
@@ -2756,7 +2772,7 @@ msgstr ""
"\"documenting_syntax\">abreviaciones</link>)."
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1636
+#: C/index.docbook:1642
#, no-wrap
msgid ""
"\n"
@@ -2766,12 +2782,12 @@ msgstr ""
"<emphasis>This is important</emphasis>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1633
+#: C/index.docbook:1639
msgid "To emphasize text: <_:informalexample-1/>"
msgstr "Para enfatizar un texto: <_:informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1645
+#: C/index.docbook:1651
#, no-wrap
msgid ""
"\n"
@@ -2781,12 +2797,12 @@ msgstr ""
"<filename>/home/user/documents</filename>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1642
+#: C/index.docbook:1648
msgid "For filenames use: <_:informalexample-1/>"
msgstr "Para uso de nombres de archivo: <_:informalexample-1/>"
#. (itstool) path: informalexample/programlisting
-#: C/index.docbook:1654
+#: C/index.docbook:1660
#, no-wrap
msgid ""
"\n"
@@ -2796,17 +2812,17 @@ msgstr ""
"<keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1651
+#: C/index.docbook:1657
msgid "To refer to keys use: <_:informalexample-1/>"
msgstr "Para referirse a claves: <_:informalexample-1/>"
#. (itstool) path: chapter/title
-#: C/index.docbook:1664
+#: C/index.docbook:1670
msgid "Filling the extra files"
msgstr "Rellenar campos adicionales"
#. (itstool) path: chapter/para
-#: C/index.docbook:1666
+#: C/index.docbook:1672
msgid ""
"There are a couple of extra files, that need to be maintained along with the "
"inline source code comments: <filename><package>.types</filename>, "
@@ -2819,12 +2835,12 @@ msgstr ""
"pasado) y <filename><paquete>-sections.txt</filename>."
#. (itstool) path: sect1/title
-#: C/index.docbook:1675
+#: C/index.docbook:1681
msgid "Editing the types file"
msgstr "Editar los tipos de archivo"
#. (itstool) path: sect1/para
-#: C/index.docbook:1677
+#: C/index.docbook:1683
msgid ""
"If your library or application includes GObjects, you want their signals, "
"arguments/parameters and position in the hierarchy to be shown in the "
@@ -2839,12 +2855,12 @@ msgstr ""
"<filename><paquete>.types</filename>."
#. (itstool) path: example/title
-#: C/index.docbook:1686
+#: C/index.docbook:1692
msgid "Example types file snippet"
msgstr "Fragmento de ejemplo de tipos de archivo"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1687
+#: C/index.docbook:1693
#, no-wrap
msgid ""
"\n"
@@ -2864,7 +2880,7 @@ msgstr ""
"gtk_arrow_get_type\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1698
+#: C/index.docbook:1704
msgid ""
"Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
"list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
@@ -2877,12 +2893,12 @@ msgstr ""
"los tipos de archivo ni tenerlos bajo el control de versiones."
#. (itstool) path: sect1/title
-#: C/index.docbook:1707
+#: C/index.docbook:1713
msgid "Editing the master document"
msgstr "Editar la sección maestra del documento"
#. (itstool) path: sect1/para
-#: C/index.docbook:1709
+#: C/index.docbook:1715
msgid ""
"GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
"inline source comments, the GTK-Doc tools generate one documentation page "
@@ -2895,7 +2911,7 @@ msgstr ""
"documento maestro las incluye y ordena."
#. (itstool) path: sect1/para
-#: C/index.docbook:1716
+#: C/index.docbook:1722
msgid ""
"While GTK-Doc creates a template master document for you, later runs will "
"not touch it again. This means that one can freely structure the "
@@ -2912,7 +2928,7 @@ msgstr ""
"vez en cuando para ver si se han introducido algunas mejoras."
#. (itstool) path: tip/para
-#: C/index.docbook:1726
+#: C/index.docbook:1732
msgid ""
"Do not create tutorials as extra documents. Just write extra chapters. The "
"benefit of directly embedding the tutorial for your library into the API "
@@ -2927,7 +2943,7 @@ msgstr ""
"el tutorial junto con la biblioteca son mayores."
#. (itstool) path: sect1/para
-#: C/index.docbook:1735
+#: C/index.docbook:1741
msgid ""
"So what are the things to change inside the master document? For a start is "
"only a little. There are some placeholders (text in square brackets) there "
@@ -2938,12 +2954,12 @@ msgstr ""
"que habría que encargarse."
#. (itstool) path: example/title
-#: C/index.docbook:1742
+#: C/index.docbook:1748
msgid "Master document header"
msgstr "Cabecera del documento maestro"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1743
+#: C/index.docbook:1749
#, no-wrap
msgid ""
"\n"
@@ -2973,7 +2989,7 @@ msgstr ""
" <title>[Insert title here]</title>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1759
+#: C/index.docbook:1765
msgid ""
"In addition a few option elements are created in commented form. You can "
"review these and enable them as you like."
@@ -2982,12 +2998,12 @@ msgstr ""
"Puede revisarlos y activarlos como quiera."
#. (itstool) path: example/title
-#: C/index.docbook:1765
+#: C/index.docbook:1771
msgid "Optional part in the master document"
msgstr "Parte opcional en el documento maestro"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1766
+#: C/index.docbook:1772
#, no-wrap
msgid ""
"\n"
@@ -3001,7 +3017,7 @@ msgstr ""
" --> \n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1774
+#: C/index.docbook:1780
msgid ""
"Finally you need to add new section whenever you introduce one. The <link "
"linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
@@ -3013,12 +3029,12 @@ msgstr ""
"todavía en la documentación."
#. (itstool) path: example/title
-#: C/index.docbook:1782 C/index.docbook:1817
+#: C/index.docbook:1788 C/index.docbook:1823
msgid "Including generated sections"
msgstr "Incluir secciones generadas"
#. (itstool) path: example/programlisting
-#: C/index.docbook:1783
+#: C/index.docbook:1789
#, no-wrap
msgid ""
"\n"
@@ -3034,12 +3050,12 @@ msgstr ""
" ...\n"
#. (itstool) path: sect1/title
-#: C/index.docbook:1795
+#: C/index.docbook:1801
msgid "Editing the section file"
msgstr "Editar el archivo de sección"
#. (itstool) path: sect1/para
-#: C/index.docbook:1797
+#: C/index.docbook:1803
msgid ""
"The section file is used to organise the documentation output by GTK-Doc. "
"Here one specifies which symbol belongs to which module or class and control "
@@ -3050,7 +3066,7 @@ msgstr ""
"y el control de la visibilidad (pública o privada)."
#. (itstool) path: sect1/para
-#: C/index.docbook:1803
+#: C/index.docbook:1809
msgid ""
"The section file is a plain text file with tags delimiting sections. Blank "
"lines are ignored and lines starting with a '#' are treated as comment lines."
@@ -3060,7 +3076,7 @@ msgstr ""
"comiencen con «#» se tratan como comentarios."
#. (itstool) path: note/para
-#: C/index.docbook:1810
+#: C/index.docbook:1816
msgid ""
"While the tags make the file look like xml, it is not. Please do not close "
"tags like <SUBSECTION>."
@@ -3069,7 +3085,7 @@ msgstr ""
"etiquetas del tipo <SUBSECTION>."
#. (itstool) path: example/programlisting
-#: C/index.docbook:1818
+#: C/index.docbook:1824
#, no-wrap
msgid ""
"\n"
@@ -3101,7 +3117,7 @@ msgstr ""
"</SECTION>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:1835
+#: C/index.docbook:1841
msgid ""
"The <FILE> ... </FILE> tag is used to specify the file name, "
"without any suffix. For example, using '<FILE>gnome-config</"
@@ -3124,7 +3140,7 @@ msgstr ""
"clase de GObject convertido a minúscula.)"
#. (itstool) path: sect1/para
-#: C/index.docbook:1847
+#: C/index.docbook:1853
msgid ""
"The <TITLE> ... </TITLE> tag is used to specify the title of the "
"section. It is only useful before the templates (if used) are initially "
@@ -3138,7 +3154,7 @@ msgstr ""
"obsoleto."
#. (itstool) path: sect1/para
-#: C/index.docbook:1854
+#: C/index.docbook:1860
msgid ""
"You can group items in the section by using the <SUBSECTION> tag. "
"Currently it outputs a blank line between subsections in the synopsis "
@@ -3168,7 +3184,7 @@ msgstr ""
"públicas (variables, vmethods)."
#. (itstool) path: sect1/para
-#: C/index.docbook:1873
+#: C/index.docbook:1879
msgid ""
"You can also use <INCLUDE> ... </INCLUDE> to specify the "
"#include files which are shown in the synopsis sections. It contains a comma-"
@@ -3184,12 +3200,12 @@ msgstr ""
"a esa sección."
#. (itstool) path: chapter/title
-#: C/index.docbook:1887
+#: C/index.docbook:1893
msgid "Controlling the result"
msgstr "Controlar el resultado"
#. (itstool) path: chapter/para
-#: C/index.docbook:1889
+#: C/index.docbook:1895
msgid ""
"A GTK-Doc run generates report files inside the documentation directory. The "
"generated files are named: <filename><package>-undocumented.txt</"
@@ -3204,7 +3220,7 @@ msgstr ""
"archivos de texto plano y se pueden ver y posprocesar fácilmente."
#. (itstool) path: chapter/para
-#: C/index.docbook:1898
+#: C/index.docbook:1904
msgid ""
"The <filename><package>-undocumented.txt</filename> file starts with "
"the documentation coverage summary. Below are two sections divided by blank "
@@ -3220,7 +3236,7 @@ msgstr ""
"documentación pero dónde; p.e. se ha añadido un parámetro nuevo."
#. (itstool) path: chapter/para
-#: C/index.docbook:1907
+#: C/index.docbook:1913
msgid ""
"The <filename><package>-undeclared.txt</filename> file lists symbols "
"given in the <filename><package>-sections.txt</filename> but not found "
@@ -3232,7 +3248,7 @@ msgstr ""
"eliminado o no se han escrito correctamente."
#. (itstool) path: chapter/para
-#: C/index.docbook:1914
+#: C/index.docbook:1920
msgid ""
"The <filename><package>-unused.txt</filename> file lists symbol names, "
"where the GTK-Doc scanner has found documentation, but does not know where "
@@ -3245,7 +3261,7 @@ msgstr ""
"todavía al archivo <filename><paquete>-sections.txt</filename>."
#. (itstool) path: tip/para
-#: C/index.docbook:1922
+#: C/index.docbook:1928
msgid ""
"Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile."
"am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
@@ -3256,7 +3272,7 @@ msgstr ""
"de integridad durante la ejecución de make check."
#. (itstool) path: chapter/para
-#: C/index.docbook:1929
+#: C/index.docbook:1935
msgid ""
"One can also look at the files produced by the source code scanner: "
"<filename><package>-decl-list.txt</filename> and <filename><"
@@ -3273,7 +3289,7 @@ msgstr ""
"si este archivo lo contiene."
#. (itstool) path: chapter/para
-#: C/index.docbook:1938
+#: C/index.docbook:1944
msgid ""
"If the project is GObject based, one can also look into the files produced "
"by the object scanner: <filename><package>.args.txt</filename>, "
@@ -3294,12 +3310,12 @@ msgstr ""
"ejecutándolo como <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
#. (itstool) path: chapter/title
-#: C/index.docbook:1953
+#: C/index.docbook:1959
msgid "Modernizing the documentation"
msgstr "Modernizar la documentación"
#. (itstool) path: chapter/para
-#: C/index.docbook:1955
+#: C/index.docbook:1961
msgid ""
"GTK-Doc has been around for quite some time. In this section we list new "
"features together with the version since when it is available."
@@ -3308,12 +3324,12 @@ msgstr ""
"características nuevas junto con la versión desde la que están disponibles."
#. (itstool) path: sect1/title
-#: C/index.docbook:1961
+#: C/index.docbook:1967
msgid "GTK-Doc 1.9"
msgstr "GTK-Doc 1.9"
#. (itstool) path: sect1/para
-#: C/index.docbook:1963
+#: C/index.docbook:1969
msgid ""
"When using xml instead of sgml, one can actually name the master document "
"<filename><package>-docs.xml</filename>."
@@ -3322,7 +3338,7 @@ msgstr ""
"maestro <filename><paquete>-docs.xml</filename>."
#. (itstool) path: sect1/para
-#: C/index.docbook:1968
+#: C/index.docbook:1974
msgid ""
"This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
"<filename>Makefile.am</filename>. When this is enabled, the <filename><"
@@ -3343,7 +3359,7 @@ msgstr ""
"paquete>-decl-list.txt <paquete>-sections.txt</code>."
#. (itstool) path: sect1/para
-#: C/index.docbook:1979
+#: C/index.docbook:1985
msgid ""
"Version 1.8 already introduced the syntax for documenting sections in the "
"sources instead of the separate files under <filename class=\"directory"
@@ -3365,12 +3381,12 @@ msgstr ""
"<filename>configure.ac</filename> y lo tendrá hecho."
#. (itstool) path: sect1/title
-#: C/index.docbook:1991
+#: C/index.docbook:1997
msgid "GTK-Doc 1.10"
msgstr "GTK-Doc 1.10"
#. (itstool) path: sect1/para
-#: C/index.docbook:1993
+#: C/index.docbook:1999
msgid ""
"This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
"<filename>Makefile.am</filename>. When this is enabled, the <filename><"
@@ -3388,17 +3404,17 @@ msgstr ""
"condicional."
#. (itstool) path: sect1/title
-#: C/index.docbook:2004
+#: C/index.docbook:2010
msgid "GTK-Doc 1.16"
msgstr "GTK-Doc 1.16"
#. (itstool) path: example/title
-#: C/index.docbook:2010
+#: C/index.docbook:2016
msgid "Enable gtkdoc-check"
msgstr "Activar gtkdoc-check"
#. (itstool) path: example/programlisting
-#: C/index.docbook:2011
+#: C/index.docbook:2017
#, no-wrap
msgid ""
"\n"
@@ -3418,7 +3434,7 @@ msgstr ""
"endif\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:2006
+#: C/index.docbook:2012
msgid ""
"This version includes a new tool called gtkdoc-check. This tool can run a "
"set of sanity checks on your documentation. It is enabled by adding these "
@@ -3430,12 +3446,12 @@ msgstr ""
"archivo <filename>Makefile.am</filename>. <_:example-1/>"
#. (itstool) path: sect1/title
-#: C/index.docbook:2024
+#: C/index.docbook:2030
msgid "GTK-Doc 1.20"
msgstr "GTK-Doc 1.20"
#. (itstool) path: sect1/para
-#: C/index.docbook:2026
+#: C/index.docbook:2032
msgid ""
"Version 1.18 brought some initial markdown support. Using markdown in doc "
"comments is less intrusive than writing docbook xml. This version improves a "
@@ -3449,17 +3465,17 @@ msgstr ""
"comentarios</link> contiene todos los detalles."
#. (itstool) path: sect1/title
-#: C/index.docbook:2036
+#: C/index.docbook:2042
msgid "GTK-Doc 1.25"
msgstr "GTK-Doc 1.25"
#. (itstool) path: example/title
-#: C/index.docbook:2046
+#: C/index.docbook:2052
msgid "Use pre-generated entities"
msgstr "Usar entidades generadas previamenet"
#. (itstool) path: example/programlisting
-#: C/index.docbook:2047
+#: C/index.docbook:2053
#, no-wrap
msgid ""
"\n"
@@ -3501,7 +3517,7 @@ msgstr ""
" </bookinfo>\n"
#. (itstool) path: sect1/para
-#: C/index.docbook:2038
+#: C/index.docbook:2044
msgid ""
"The makefiles shipped with this version generate an entity file at "
"<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
@@ -3521,12 +3537,12 @@ msgstr ""
"archivos XML generados. <_:example-1/>"
#. (itstool) path: chapter/title
-#: C/index.docbook:2072
+#: C/index.docbook:2078
msgid "Documenting other interfaces"
msgstr "Documentar otras interfaces"
#. (itstool) path: chapter/para
-#: C/index.docbook:2074
+#: C/index.docbook:2080
msgid ""
"So far we have been using GTK-Doc to document the API of code. The next "
"sections contain suggestions how the tools can be used to document other "
@@ -3537,12 +3553,12 @@ msgstr ""
"herramientas para documentar otras interfaces."
#. (itstool) path: sect1/title
-#: C/index.docbook:2081
+#: C/index.docbook:2087
msgid "Command line options and man pages"
msgstr "Opciones de la línea de comandos y páginas man"
#. (itstool) path: sect1/para
-#: C/index.docbook:2083
+#: C/index.docbook:2089
msgid ""
"As one can generate man pages for a docbook refentry as well, it sounds like "
"a good idea to use it for that purpose. This way the interface is part of "
@@ -3553,12 +3569,12 @@ msgstr ""
"interfaz es parte de la referencia y se obtienen las páginas man sin trabajo."
#. (itstool) path: sect2/title
-#: C/index.docbook:2090
+#: C/index.docbook:2096
msgid "Document the tool"
msgstr "Documentar la herramienta"
#. (itstool) path: sect2/para
-#: C/index.docbook:2092
+#: C/index.docbook:2098
msgid ""
"Create one refentry file per tool. Following <link linkend="
"\"settingup_docfiles\">our example</link> we would call it <filename>meep/"
@@ -3573,17 +3589,17 @@ msgstr ""
"así como los ejemplos en, por ejemplo, glib."
#. (itstool) path: sect2/title
-#: C/index.docbook:2102
+#: C/index.docbook:2108
msgid "Adding the extra configure check"
msgstr "Añadir la comprobación de configuración adicional"
#. (itstool) path: example/title
-#: C/index.docbook:2105 C/index.docbook:2123
+#: C/index.docbook:2111 C/index.docbook:2129
msgid "Extra configure checks"
msgstr "Comprobaciones de configuración adicionales"
#. (itstool) path: example/programlisting
-#: C/index.docbook:2106
+#: C/index.docbook:2112
#, no-wrap
msgid ""
"\n"
@@ -3605,12 +3621,12 @@ msgstr ""
"AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
#. (itstool) path: sect2/title
-#: C/index.docbook:2120
+#: C/index.docbook:2126
msgid "Adding the extra makefile rules"
msgstr "Añadir reglas de makefile adicionales"
#. (itstool) path: example/programlisting
-#: C/index.docbook:2124
+#: C/index.docbook:2130
#, no-wrap
msgid ""
"\n"
@@ -3646,12 +3662,12 @@ msgstr ""
"EXTRA_DIST += meep.xml\n"
#. (itstool) path: sect1/title
-#: C/index.docbook:2146
+#: C/index.docbook:2152
msgid "DBus interfaces"
msgstr "Interfaces de DBus"
#. (itstool) path: sect1/para
-#: C/index.docbook:2148
+#: C/index.docbook:2154
msgid ""
"(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://";
"cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
@@ -3660,27 +3676,27 @@ msgstr ""
"cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
#. (itstool) path: chapter/title
-#: C/index.docbook:2157
+#: C/index.docbook:2163
msgid "Frequently asked questions"
msgstr "Preguntas más frecuentes"
#. (itstool) path: segmentedlist/segtitle
-#: C/index.docbook:2161
+#: C/index.docbook:2167
msgid "Question"
msgstr "Pregunta"
#. (itstool) path: segmentedlist/segtitle
-#: C/index.docbook:2162
+#: C/index.docbook:2168
msgid "Answer"
msgstr "Respuesta"
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2164
+#: C/index.docbook:2170
msgid "No class hierarchy."
msgstr "Sin jerarquía de clases."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2165
+#: C/index.docbook:2171
msgid ""
"The objects <function>xxx_get_type()</function> function has not been "
"entered into the <filename><package>.types</filename> file."
@@ -3689,12 +3705,12 @@ msgstr ""
"introducido en el archivo <filename><package>.types</filename>."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2171
+#: C/index.docbook:2177
msgid "Still no class hierarchy."
msgstr "Aún sin jerarquía de clases."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2172
+#: C/index.docbook:2178
msgid ""
"Missing or wrong naming in <filename><package>-sections.txt</filename> "
"file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-";
@@ -3705,12 +3721,12 @@ msgstr ""
"doc-list/2003-October/msg00006.html\">explicación</ulink>)."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2178
+#: C/index.docbook:2184
msgid "Damn, I have still no class hierarchy."
msgstr "Maldición, aún no hay una jerarquía de clases."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2179
+#: C/index.docbook:2185
msgid ""
"Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
"type>) part of the normal section (don't put this into Standard or Private "
@@ -3721,12 +3737,12 @@ msgstr ""
"Estándar o Privado)."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2186
+#: C/index.docbook:2192
msgid "No symbol index."
msgstr "Sin índice de símbolos."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2187
+#: C/index.docbook:2193
msgid ""
"Does the <filename><package>-docs.{xml,sgml}</filename> contain a "
"index that xi:includes the generated index?"
@@ -3735,12 +3751,12 @@ msgstr ""
"«xi:includes» el índice generado?"
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2193
+#: C/index.docbook:2199
msgid "Symbols are not linked to their doc-section."
msgstr "Los símbolos no se enlazan con su sección en el documento."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2194
+#: C/index.docbook:2200
msgid ""
"Is the doc-comment using the correct markup (added #,% or ())? Check if the "
"gtkdoc-fixxref warns about unresolvable xrefs."
@@ -3749,12 +3765,12 @@ msgstr ""
"si gtk-doc-fixxref avisa de alguna referencia xref sin resolver."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2200
+#: C/index.docbook:2206
msgid "A new class does not appear in the docs."
msgstr "Una clase nueva no aparece en la documentación."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2201
+#: C/index.docbook:2207
msgid ""
"Is the new page xi:included from <filename><package>-docs.{xml,sgml}</"
"filename>."
@@ -3763,12 +3779,12 @@ msgstr ""
"sgml}</filename>."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2207
+#: C/index.docbook:2213
msgid "A new symbol does not appear in the docs."
msgstr "Un símbolo nuevo no aparece en la documentación."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2208
+#: C/index.docbook:2214
msgid ""
"Is the doc-comment properly formatted. Check for spelling mistakes in the "
"begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
@@ -3782,12 +3798,12 @@ msgstr ""
"txt</filename> en una subsección pública."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2216
+#: C/index.docbook:2222
msgid "A type is missing from the class hierarchy."
msgstr "Falta un tipo en la clase de jerarquías"
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2217
+#: C/index.docbook:2223
msgid ""
"If the type is listed in <filename><package>.hierarchy</filename> but "
"not in <filename>xml/tree_index.sgml</filename> then double check that the "
@@ -3803,14 +3819,14 @@ msgstr ""
"privada."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2226
+#: C/index.docbook:2232
msgid "I get foldoc links for all gobject annotations."
msgstr ""
"Obtengo enlaces de seguimiento de documentos para todas las anotaciones "
"gobject."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2227
+#: C/index.docbook:2233
msgid ""
"Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
"from <filename><package>-docs.{xml,sgml}</filename>."
@@ -3819,14 +3835,14 @@ msgstr ""
"included» desde <filename><package>-docs.{xml,sgml}</filename>."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2235
+#: C/index.docbook:2241
msgid "Parameter described in source code comment block but does not exist"
msgstr ""
"Parámetro descrito en el bloque de comentarios del código fuente pero no "
"existe"
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2236
+#: C/index.docbook:2242
msgid ""
"Check if the prototype in the header has different parameter names as in the "
"source."
@@ -3835,12 +3851,12 @@ msgstr ""
"diferentes de la fuente."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2241
+#: C/index.docbook:2247
msgid "multiple \"IDs\" for constraint linkend: XYZ"
msgstr "múltiples «ID» para la restricción enlazada: XYZ"
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2242
+#: C/index.docbook:2248
msgid ""
"Symbol XYZ appears twice in <filename><package>-sections.txt</"
"filename> file."
@@ -3849,7 +3865,7 @@ msgstr ""
"sections.txt</filename>."
#. (itstool) path: seglistitem/seg
-#: C/index.docbook:2245
+#: C/index.docbook:2251
msgid ""
"Element typename in namespace '' encountered in para, but no template "
"matches."
@@ -3858,12 +3874,12 @@ msgstr ""
"coincide."
#. (itstool) path: chapter/title
-#: C/index.docbook:2252
+#: C/index.docbook:2258
msgid "Tools related to gtk-doc"
msgstr "Herramientas relacionadas con GTK-Doc"
#. (itstool) path: chapter/para
-#: C/index.docbook:2254
+#: C/index.docbook:2260
msgid ""
"GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\";>Trac "
"GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
@@ -3874,7 +3890,7 @@ msgstr ""
"a un sitio «trac» y se integra con la búsqueda de «trac»."
#. (itstool) path: chapter/para
-#: C/index.docbook:2259
+#: C/index.docbook:2265
msgid ""
"Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
"tags in the API to determine the minimum required version."
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
