diff options
author | Daniel Mustieles <daniel.mustieles@gmail.com> | 2017-12-20 18:14:21 +0100 |
---|---|---|
committer | Daniel Mustieles <daniel.mustieles@gmail.com> | 2017-12-20 18:14:21 +0100 |
commit | e08245ac205366402a37588812d2434c49186f58 (patch) | |
tree | 11f11b1d9e105e3f6e9982c9d664a9bdf6feb676 | |
parent | 1e1117e5f5d00a2e3ac4132255e4e3911da03746 (diff) | |
download | gtk-doc-e08245ac205366402a37588812d2434c49186f58.tar.gz |
Updated Spanish translation
-rw-r--r-- | 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." |