GNOME.org
 

[gtk-doc] es-manual: fix one xml link id typo

commit 6279a2a0f332f4eeba8b34039038fdb07004768f
Author: Stefan Kost <ensonic users sf net>
Date:   Thu Jun 25 09:39:11 2009 +0300

    es-manual: fix one xml link id typo
    
    There are still two "<placeholder-1/>" tags. Are they serve any purpose. Could
    they be xml comments like "<!--placeholder-1-->". They break make check.

 help/manual/es/gtk-doc-manual.xml | 1183 +++++++++++++++++++++++++++++++++++++
 1 files changed, 1183 insertions(+), 0 deletions(-)
---
diff --git a/help/manual/es/gtk-doc-manual.xml b/help/manual/es/gtk-doc-manual.xml
new file mode 100644
index 0000000..f5aad09
--- /dev/null
+++ b/help/manual/es/gtk-doc-manual.xml
@@ -0,0 +1,1183 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<?xml-stylesheet type="text/xml" href="params.xsl"?>
+<!-- vim: set ai tw=80 ts=3 sw=3: -->
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "
+              http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
+<!ENTITY FDL SYSTEM "fdl-appendix.xml">
+<!ENTITY FDLlink "<link linkend='fdl'>included</link>">
+]>
+<!-- =============Document Header ============================= -->
+<book id="index" lang="es">
+  <bookinfo>
+    <title>Manual de GTK-Doc</title>
+    <edition>1.12</edition>
+    <abstract role="description"><para>Manual del usuario para desarrolladores con instrucciones del uso de GTK-Doc.</para></abstract>
+    <authorgroup>
+      <author>
+        <firstname>Chris</firstname>
+        <surname>Lyttle</surname>
+        <affiliation>
+          <address>
+            <email>chris wilddev net</email>
+          </address>
+        </affiliation>
+      </author>
+      <author>
+        <firstname>Dan</firstname>
+        <surname>Mueth</surname>
+        <affiliation>
+          <address>
+            <email>d-mueth uchicago edu</email>
+          </address>
+        </affiliation>
+      </author>
+      <author>
+        <firstname>Stefan</firstname>
+        <surname>Kost</surname>
+        <affiliation>
+          <address>
+            <email>ensonic users sf net</email>
+          </address>
+        </affiliation>
+      </author>
+    </authorgroup>
+    <publisher role="maintainer">
+      <publishername>Proyecto GTK-Doc</publishername>
+      <address><email>gtk-doc-list gnome org</email></address>
+    </publisher>
+    <copyright>
+      <year>2000, 2005, 2007-2009</year>
+      <holder>Dan Mueth, Chris Lyttle y Stefan Kost</holder>
+    </copyright><copyright><year>2009</year><holder>Francisco Javier F. Serrador (serrrador svn gnome org)</holder></copyright><copyright><year>2009</year><holder>Jorge González (jorgegonz svn gnome org)</holder></copyright>
+
+    <!-- translators: uncomment this:
+    <copyright>
+      <year>2000</year>
+      <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+    </copyright>
+    -->
+
+    <legalnotice>
+      <para>Se concede autorización para copiar, distribuir o modificar este documento según los términos de la <citetitle>GNU Free Documentation License</citetitle>, Versión 1.1, o cualquier otra versión posterior publicada por Free Software Foundation sin secciones invariables, textos de portada ni textos de contraportada. Se <link linkend="fdl">incluye</link> una copia de la licencia.</para>
+      <para>Muchos de los nombres usados por compañías para distinguir sus productos y servicios se mencionan como marcas comerciales. Donde aparezcan dichos nombres en cualquier documentación GNOME, y para que los miembros del proyecto de documentación las reconozcan dichas marcas comerciales, dichos nombres se imprimen en mayúsculas o iniciales mayúsculas.</para>
+    </legalnotice>
+    
+    <revhistory>
+      <revision>
+	<revnumber>1.11</revnumber>
+	<date>22 de marzo de 2008</date>
+	<authorinitials>mal</authorinitials>
+	<revremark>Migración de GNOME doc-utils</revremark>
+      </revision>
+    </revhistory>
+
+  </bookinfo>
+
+  <!-- ======== Chapter 1: Introduction ======================== -->
+
+  <chapter id="introduction">
+    <title>Introducción</title>
+
+    <para>Este capítulo introduce GTK-Doc y proporciona una visión general de lo que es y cómo usarlo.</para>
+
+    <sect1 id="whatisgtkdoc">
+      <title>¿Qué es GTK-Doc?</title>
+
+      <para>GTK-Doc se usa para documentar código C. Generalmente se usa para documentar la API pública de bibliotecas, tales como las bibliotecas GTK+ y de GNOME. Pero también se puede usar para documentar código de aplicaciones.</para>
+    </sect1>
+
+    <sect1 id="howdoesgtkdocwork">
+      <title>¿Cómo funciona GTK-Doc?</title>
+
+      <para>GTK-Doc funciona usando documentación de las funciones ubicadas dentro de los archivos de fuentes en bloques de comentarios especialmente formateados, o documentación añadida a los archivos de plantillas que GTK-Doc usa (aunque debe notar que GTK-Doc sólo documentará las funciones declaradas en los archivos de cabecera; no produce salida para funciones estáticas).</para>
+
+      <para>GTK-Doc consiste en un número de scripts en Perl, cada uno realiza un paso diferente en el proceso.</para>
+
+      <para>Existen 5 pasos importantes en el proceso:</para>
+
+      <orderedlist>
+
+        <listitem>
+          <para><guilabel>Escribir la documentación.</guilabel> El autor rellena los archivos de fuentes con la documentación para cada función, macro, unión, etc. (En el pasado la información se introducía en archivos de plantillas, lo que ya no se recomienda).</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Obtener información acerca del código</guilabel><application>gtkdoc-scan</application> analiza los archivos de cabecera del código buscando declaraciones de funciones, macros, enumeraciones, estructuras y uniones. Crea el archivo <filename>&lt;module&gt;-decl-list.txt</filename> conteniendo una lista de las declaraciones, ubicándolas en secciones de acuerdo con el archivo de cabecera en el que están. Durante la primera ejecución este archivo se copia en <filename>&lt;module&gt;-sections.txt</filename>. El autor puede reordenar las secciones y el orden de las declaraciones en ellas, para producir la salida deseada. El segundo archivo que genera es <filename>&lt;module&gt;-decl.txt</filename>. Este archivo contiene las declaraciones completas que encontró el análisis. Si por alguna razón un programador quisiese que algunos símbolos apareciesen en los documentos, donde el análisis no puede encontrar la declaración completa o la declaración
  debería aparecer de forma diferente, puede introducir entradas de forma similar a las que hay en <filename>&lt;module&gt;-decl.txt</filename> dentro de <filename>&lt;module&gt;-overrides.txt</filename>. También se puede usar <application>gtkdoc-scanobj</application> para consultar dinámicamente una biblioteca acerca de las subclases GtkObject que exporta. Ahorra información acerca de la posición de cada objeto en la jerarquía de clases y acerca de cualquier señal y argumentos GTK que proporciona.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Generar los archivos «plantilla».</guilabel> <application>gtkdoc-mktmpl</application> crea un número de archivos en el subdirectorio <filename class="directory">tmpl/</filename>, usando la información obtenida en el primer paso. (Note que esto se puede ejecutar de forma separada. Intentará asegurarse de que la documentación nunca se pierde.)</para>
+          <note>
+            <para>Ya que las plantillas de gtk-doc 1.9 se pueden evitar. Animamos a la gente a que mantenga la documentación en el código. <application>gtkdocize</application> ahora soporta una opción <command>--flavour no-tmpl</command> que elige un archivo makefile que omite completamente el uso de tmpl. Si nunca ha cambiado a mano el archivo tmpl, elimine el directorio una vez.</para>
+          </note>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Generar el GSML/XML y el HTML.</guilabel><application>gtkdoc-mkdb</application> convierte los archivos de plantilla en archivos SGML o XML en el subdirectorio <filename class="directory">sgml/</filename> o <filename class="directory">xml/</filename>. Si el código fuente contiene documentación de funciones, usando los bloques especiales de comentarios, entonces se mezclarán aquí. Si no se usan archivos tmpl sólo obtiene los documentos de los fuentes y los datos obtenidos en introspección. <application>gtkdoc-mkhtml</application> convierte los archivos SGML en archivos HTML en el subdirectorio <filename class="directory">html/</filename>. Los archivos en el subdirectorio <filename class="directory">sgml/</filename> o <filename class="directory">xml/</filename> y <filename class="directory">html/</filename> siempre se sobreescriben. No se deberían editar directamente.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Arreglar referencias cruzadas entre documentos.</guilabel> Después de instalar los archivos HTML se puede ejecutar <application>gtkdoc-fixxref</application> para arreglar cualquier referencia cruzada entre documentos separados. Por ejemplo, la documentación GTK+ contiene muchas referencias cruzadas a tipos documentados en el manual de GLib. Al crear los archivadores «tarball» para su distribución, <application>gtkdoc-rebase</application> convierte todos los enlaces externos en enlaces web. Al instalar la documentación distribuida (pregenerada) la misma aplicación intentará convertir de nuevo los enlaces, esta vez a enlaces locales (donde esa documentación está instalada).</para>
+        </listitem>
+      </orderedlist>
+
+    </sect1>
+
+    <sect1 id="gettinggtkdoc">
+      <title>Obtener GTK-Doc</title>
+
+      <sect2 id="requirements">
+        <title>Requerimientos</title>
+        <para><guilabel>Perl v5</guilabel>: los scripts principales están en Perl.</para>
+        <para><guilabel>DocBook DTD v3.0</guilabel>: Este es el DocBook SGML DTD. <ulink url="http://www.ora.com/davenport"; type="http">http://www.ora.com/davenport</ulink></para>
+        <para><guilabel>Jade v1.1</guilabel>: Este es el procesador DSSSL para convertir SGML a varios formatos. <ulink url="http://www.jclark.com/jade"; type="http">http://www.jclark.com/jade</ulink></para>
+        <para><guilabel>Hojas de estilo DocBook modulares:</guilabel> �ste es el código DSSSL para convertir DocBook a HTML (y otros cuantos formatos). Se usa junto con jade. El código DSSSL está algo personalizado, en GTK-Doc dsl, para colorear el código de listas/declaraciones del programa y soportar índices de referencias cruzadas globales en el HTML generado. <ulink url="http://nwalsh.com/docbook/dsssl"; type="http">http://nwalsh.com/docbook/dsssl</ulink>.</para>
+        <para><guilabel>docbook-to-man</guilabel>: Si quiere crear páginas man desde el DocBook. «translation spec» se ha personalizado un poco para capitalizar la sección de cabeceras y añadir un título de «Biblioteca GTK» en la parte superior de las páginas y la fecha de revisión al final. Existe un enlace acerca de esto en <ulink url="http://www.ora.com/davenport"; type="http">http://www.ora.com/davenport</ulink>. NOTA: Esto aún no funciona.</para>
+      </sect2>
+
+      <sect2 id="installation">
+        <title>Instalación</title>
+        <para>No existe ningún sitio estándar donde se instalan las hojas de estilo modulares de DocBook.</para>
+        <para>El script de configuración de gtk-doc busca estos tres directorios automáticamente:</para>
+        <para><filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (usado por RedHat)</para>
+        <para><filename> /usr/lib/dsssl/stylesheets/docbook </filename> (usado por Debian)</para>
+        <para><filename> /usr/share/sgml/docbkdsl </filename> (usado por SuSE)</para>
+        <para>Si tiene las hojas de estilo instaladas en algún otro sitio, deberá configurar gtk-doc usando la opción: <command> --with-dsssl-dir=&lt;RUTA_AL_DIRECTORIO_DE_NIVEL_SUPERIOR_DE_LAS_HOJAS_DE_ESTILO&gt; </command></para>
+      </sect2>
+
+    </sect1>
+
+    <!-- not realy worth a section
+    <sect1 id="whentousegtkdoc">
+      <title>When to Use GTK-Doc</title>
+
+      <para>
+        (What things GTK-Doc should, and shouldn't, be used for.)
+        (- ???)
+        (+ Tutorials)
+      </para>
+
+    </sect1>
+    -->
+
+    <sect1 id="aboutgtkdoc">
+      <title>Acerca de GTK-Doc</title>
+
+      <para>(ARRÃ?GLAME)</para>
+
+      <para>(Historia, autores, páginas web, licencias, planes futuros, comparación con otros sistemas similares.)</para>
+
+    </sect1>
+
+    <sect1 id="aboutthismanual">
+      <title>Acerca de este manual</title>
+
+      <para>(ARRÃ?GLAME)</para>
+
+      <para>(a quién está dirigido, dónde puede obtenerse, licencia)</para>
+
+    </sect1>
+
+  </chapter>
+
+  <chapter id="settingup">
+    <title>Configurando su proyecto</title>
+
+    <para>Las siguientes secciones describen los pasos que realizar para integrar GTK-Doc en su proyecto. Estas secciones asumen que se trabaja en un proyecto llamado «meep». Este proyecto contiene una biblioteca llamada «libmeep» y una aplicación final de usuario llamada «meeper».</para>
+
+    <sect1 id="settingup_docfiles">
+      <title>Configurar el esquema de la documentación</title>
+
+      <para>Bajo su directorio de nivel superior cree carpetas llamadas docs/reference (de esta forma también puede tener docs/help para la documentación final de usuario). Se recomienda crear otro subdirectorio con el nombre doc-package. Para paquetes con una sola biblioteca este paso no es necesario.</para>
+
+      <para>Esto después aparecerá como se muestra debajo: <example><title>Ejemplo de estructura de directorios</title>
+          <programlisting>
+<![CDATA[
+meep/
+  docs/
+    reference/
+      libmeep/
+      meeper/
+  src/
+    libmeep/
+    meeper/
+]]>
+          </programlisting>
+        </example></para>
+    </sect1>
+
+    <sect1 id="settingup_autoconf">
+      <title>Integración con autoconf</title>
+
+      <para>Muy fácil, simplemente añada una línea a su script <filename>configure.ac</filename>.</para>
+
+      <para>
+        <example><title>Integración con autoconf</title>
+          <programlisting>
+<![CDATA[
+# check for gtk-doc
+GTK_DOC_CHECK(1.9)
+]]>
+          </programlisting>
+        </example>
+      </para>
+
+      <para>Además de comprobar la versión de GTK-Doc necesaria, esto añade dos claves:</para>
+      <orderedlist>
+        <listitem><para>--with-html-dir=RUTA: ruta a los documentos instalados</para></listitem>
+        <listitem><para>--enable-gtk-doc: usar gtk-doc para construir la documentación</para></listitem>
+      </orderedlist>
+
+      <important>
+      	<para>GTK-Doc está desactivado de forma predeterminada. Recuerde pasar la opción <option>«--enable-gtk-doc»</option> en la siguiente ejecución de <filename>configure</filename>. De otra forma, la documentación pregenerada se instala (lo que tiene sentido para usuarios, pero no para desarrolladores).</para>
+      </important>
+
+      <para>Aún más, se recomienda que tenga la siguiente línea en su script <filename>configure.ac</filename>. Esto permite que <filename>gtkdocize</filename> copie automáticamente la definición del macro para <function>GTK_DOC_CHECK</function> a su proyecto.</para>
+
+      <para>
+        <example><title>Preparación para gtkdocize</title>
+          <programlisting>
+<![CDATA[
+AC_CONFIG_MACRO_DIR(m4)
+]]>
+          </programlisting>
+        </example>
+      </para>
+    </sect1>
+
+    <sect1 id="settingup_automake">
+      <title>Integración con automake</title>
+
+      <para>Primero copie el archivo <filename>Makefile.am</filename> del subdirectorio de ejemplos de gtkdoc-sources al directorio de documentación de la API de su proyecto (<filename class="directory">./docs/reference/&lt;paquete&gt;</filename>). Si tiene varios paquetes de documentación, repítalo para cada uno de ellos.</para>
+
+      <para>El siguiente paso es editar la configuración dentro de <filename>Makefile.am</filename>. Todos los ajustes tienen un comentario encima que describe su propósito. Muchos ajustes son opciones adicionales pasadas a las respectivas herramientas. Cada herramienta tiene una variable de la forma <option>&lt;NOMBRE_DE_LA_HERRAMIENTA&gt;_OPCIONES</option>. Todas las herramientas soportan <option>--help</option> para listar los parámetros que soportan.</para>
+
+      <!-- FIXME: explain options ? -->
+
+      <para>Puede que también quiera activar GTK-Doc para el objetivo distcheckmate. Simplemente añada la línea mostrada en el siguiente ejemplo a su nivel superior de <filename>Makefile.am</filename>:</para>
+
+      <para>
+        <example><title>Activar gtk-doc durante make distcheck</title>
+          <programlisting>
+<![CDATA[
+DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc
+]]>
+          </programlisting>
+        </example>
+      </para>
+
+    </sect1>
+
+    <sect1 id="settingup_autogen">
+      <title>Integración con autogen</title>
+
+      <para>La mayoría de los proyectos tienen un script <filename>autogen.sh</filename> para configurar la infraestructura de construcción después de hacer un «checkout» desde los sistemas de control de versiones (tales como cvs). GTK-Doc tiene una herramienta llamada <filename>gtkdocize</filename> que se puede usar en tal script. Se debería ejecutar antes que autoheader, automake o autoconf.</para>
+
+      <para>
+        <example><title>Ejecutar gtkdocize desde autogen.sh</title>
+          <programlisting>
+<![CDATA[
+gtkdocize || exit 1
+]]>
+          </programlisting>
+        </example>
+      </para>
+
+      <para>Al ejecutar <filename>gtkdocize</filename> se copia <filename>gtk-doc.make</filename> a la raíz de su proyecto (o cualquier directorio especificado por la opción --docdir). También comprueba su script de configuración para la invocación de <function>GTK_DOC_CHECK</function>.</para>
+
+      <para>Históricamente GTK-Doc generaba plantillas de archivos donde los desarrolladores introducían los documentos. Al final esto resulto no ser muy bueno. Desde las primeras versiones GTK-Doc también podría obtener toda la documentación desde los comentarios del código. Desde GTK-Doc 1.9 se pueden omitir las plantillas. Se anima a los desarrolladores a mantener su documentación en el código. <application>gtkdocize</application> ahora soporta una opción «--flavour=no-tmpl» que elije un makefile que omite completamente el uso de plantillas. Si nunca ha cambiado un archivo tmpl (plantilla) a mano, elimine el directorio una vez.</para>
+    </sect1>
+
+    <sect1 id="settingup_firstrun">
+      <title>Ejecutar la construcción de la documentación</title>
+
+      <para>Después de los pasos anteriores es hora de ejecutar el constructor. Primero se debe volver a ejecutar <filename>autogen.sh</filename>. Si este script ejecuta configure automáticamente, entonces debe pasar la opción <option>--enable-gtk-doc</option>. De otra forma, ejecute posteriormente <filename>configure</filename> con esta opción.</para>
+      <para>El primer make genera diversas líneas adicionales en los directorios de documentación. Las importantes son: <filename>&lt;paquete&gt;.types</filename>, <filename>&lt;paquete&gt;-docs.sgml</filename>, <filename>&lt;paquete&gt;-sections.txt</filename>.</para>
+      <para>
+        <example><title>Ejecutar la construcción de la documentación</title>
+          <programlisting>
+<![CDATA[
+./autogen.sh --enable-gtk-doc
+make
+]]>
+          </programlisting>
+        </example>
+      </para>
+      <para>Ahora puede apuntar su navegador a <filename>docs/reference/&lt;paquete&gt;/index.html</filename>. Sí, aún es un poco decepcionante. Pero espere, durante el siguiente capítulo aprenderá a rellenar las páginas con información.</para>
+    </sect1>
+
+    <sect1 id="settingup_vcs">
+      <title>Integración con los sistemas de control de versiones</title>
+
+      <para>Como regla principal, son los archivos que edita, los que deberían estar bajo el control de versiones. Para proyectos típicos son los archivos: <filename>&lt;paquete&gt;.types</filename>, <filename>&lt;paquete&gt;-docs.sgml</filename>, <filename>&lt;paquete&gt;-sections.txt</filename> y <filename>Makefile.am</filename>.</para>
+    </sect1>
+
+  </chapter>
+
+  <chapter id="documenting">
+    <title>Documentar el código</title>
+
+    <para>GTK-Doc usa código fuente comentado con una sintaxis especial para documentar el código. Además obtiene información acerca de la estructura de su proyecto de otras fuentes. En la siguiente sección encontrará información acerca de la sintaxis de los comentarios.</para>
+
+    <note>
+      <title>Ubicación de la documentación</title>
+      <para>En el pasado la mayoría de la documentación se debía rellenar en campos dentro del directorio <filename>tmpl</filename>. Esto tiene las desventajas de que la información. Esto tiene las desventajas de que la información no se actualiza muy a menudo y que el archivo tiene tendencia a causar conflictos con los sistemas de control de versiones.</para>
+      <para>Para evitar los problemas anteriormente mencionados, se sugiere dejar la documentación dentro de los fuentes. Este manual sólo describe esta forma de documentar el código.</para>
+    </note>
+
+    <!--  -->
+
+    <sect1 id="documenting_syntax">
+      <title>Comentarios de la documentación</title>
+
+      <para>Un comentario de varias líneas que comienza con un «*» adicional marca un bloque de documentación que GTK-Doc tools procesarán. <example><title>Bloque de comentario de GTK-Doc</title>
+          <programlisting>
+<![CDATA[
+/**
+ * identifier:
+ * documentation ...
+ */
+]]>
+          </programlisting>
+        </example></para>
+
+      <para>El «identificador» es una línea con el nombre del elemento relacionado con el comentario. La sintaxis difiere un poco dependiendo del elemento. (Por hacer: añadir una tabla mostrando los identificadores)</para>
+
+      <para>El bloque de «Documentación» también es diferente para cada tipo de símbolo. Los tipos de símbolos que obtienen parámetros tales como funciones o macros, tienen primero las descripciones seguidas por una línea blanca (exactamente un «*»). Después siguen las descripciones detalladas. Todas las líneas (fuera de los programas; listaso y CDATA de la secciones) que solo contengan un « *» (asterisco con espacio) son convertidos en párrafos. Si no quiere un espaciado de párrafo, cámbielo a un « * » (espacio-asterisco-espacio).</para>
+
+      <para>Una ventaja del hipertexto sobre el texto plano es la capacidad de tener enlaces en el documento. Escribir las marcas adecuadas para un enlace puede ser tedioso aunque GTK-Doc le ayuda proporcionando abreviaturas útiles. <itemizedlist>
+          <listitem>
+            <para>Use función() para referirse a funciones o macros que toman argumentos.</para>
+          </listitem>
+          <listitem>
+            <para>Use @parámetro para referirse a parámetros. �selo también al referirse a parámetros de otras funciones, relacionados al que se describe.</para>
+          </listitem>
+          <listitem>
+            <para>Use %constant para referirse a una constante, ej: %G_TRAVERSE_LEAFS.</para>
+          </listitem>
+          <listitem>
+            <para>Use #símbolo para referirse a otro tipo de símbolos, como por ejemplo estructuras, enumeraciones y macros que no toman argumentos.</para>
+          </listitem>
+          <listitem>
+            <para>Use #Object::signal para referirse a una señal de GObject</para>
+          </listitem>
+          <listitem>
+            <para>Use #Object:property para referirse a una propiedad de GObject</para>
+          </listitem>
+          <listitem>
+            <para>Use #Struct.field para referirse a un campo dentro de una estructura</para>
+          </listitem>
+        </itemizedlist></para>
+
+      <tip>
+	<para>Si necesita usar los caracteres especiales «()», « », «%», o «#» en su documentación sin que GTK-Doc los cambie, puede usar las entidades XML "amp;lpar;" "amp;rpar;" "amp;commat;" "&amp;percnt;" y "&amp;num;" respectivamente o escaparlas con una contrabarra doble «\».</para>
+      </tip>
+
+      <para>DocBook puede hacer más que insertar enlaces. Puede tener listas, tablas y ejemplos. Para activar el uso de etiquetas SGML/XML dentro de comentarios en la documentación debe tener <option>--sgml-mode</option> en la variable <symbol>MKDB_OPTIONS</symbol> dentro de <filename>Makefile.am</filename>.</para>
+
+      <tip>
+	<para>Tal y como se ha mencionado antes, la documentación anterior de GTK-Doc es para documentar la API pública .Por ello, no se puede escribir documentación para los símbolos estáticos. No obstante es una buena práctica comentar los símbolos. Esto ayuda a que otros entiendan su código. Por ello se recomienda comentarlos usando comentarios normales (sin el segundo «*» en la primera línea). Si la función, posteriormente, se debe hacer pública, todo lo que el programador debe hacer es añadir otro «*» en el bloque de comentario e introducir el nombre del símbolo en la parte derecha dentro del archivo de secciones.</para>
+      </tip>
+    </sect1>
+
+    <sect1 id="documenting_sections">
+      <title>Documentar secciones</title>
+
+      <para>Cada sección del documento contiene información acerca de una clase o un módulo. Para introducir el componente puede escribir un bloque de sección. La descripción corta además se usa dentro de la tabla de contenidos.</para>
+
+      <para>
+        <example><title>Bloque de comentarios en una sección</title>
+          <programlisting>
+<![CDATA[
+/**
+ * SECTION:meepapp
+ * @short_description: the application class
+ * @see_also: #MeepSettings
+ * @stability: Stable
+ * @include: meep/app.h
+ *
+ * The application class handles ...
+ */
+]]>
+          </programlisting>
+        </example>
+      </para>
+
+      <variablelist>
+        <varlistentry>
+          <term>@short_description</term>
+          <listitem>
+            <para>Una línea descrita en la sección, que después aparece tras los enlaces en el TOC y en la página de la sección.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>@see_also</term>
+          <listitem>
+            <para>Una lista de símbolos relacionados con esta sección.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>@stability</term>
+          <listitem>
+            <para>Esta API tiene una descripción informal del nivel de estabilidad. Se recomienda el uso de uno de estos términos: <itemizedlist>
+                <listitem>
+                  <para>Estable: La intención de una interfaz estable es la de permitir que terceras partes arbitrarias desarrollen aplicaciones para esas interfaces, las liberen, y confíen que que se podrán ejecutar en todas las publicaciones menores del producto (después de que se introdujese la interfaz en una de ellas, y dentro de la misma versión principal de la publicación). Incluso en publicaciones importantes no se espera que existan cambios incompatibles, y de haberlos habrá buenas razones para ello.</para>
+                </listitem>
+                <listitem>
+                  <para>Inestable: Las interfaces inestables son experimentales o de transición. Generalmente se usan para dar a los desarrolladores externos acceso a tecnología nueva o cambiante, o para proporcionar una solución a un problema, anticipándose a una solución más general. No se realizan reclamaciones acerca de la compatibilidad del código o del binario desde una publicación menor a la siguiente.</para>
+                </listitem>
+                <listitem>
+                  <para>Privada: Una interfaz que se puede usar en la pila de GNOME en si misma, pero que no está documentada para usuarios finales. Tales funciones sólo se deberían usar de formas especificadas y documentadas.</para>
+                </listitem>
+                <listitem>
+                  <para>Interna: Una interfaz que es interna a un módulo y no requiere documentación para el usuario final. Se asume que las funciones que están sin documentar son internas.</para>
+                </listitem>
+              </itemizedlist></para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>@include</term>
+          <listitem>
+            <para>Los archivos <literal>#include</literal> para mostrar en la sección del resumen (una lista separada por comas), sobreescribiendo el valor global del <link linkend="metafiles_sections">archivo de secciones</link> o de la línea de comandos. Este elemento es opcional.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+
+      <para>ARREGLAR tener @title aquí pondrá este título en una nueva sección de archivo generada, pero después se quedará obsoleto (¿es así?)</para>
+
+      <tip>
+        <para>Para evitar recompilaciones innecesarias después de cambios en la documentación ponga los documentos de sección en el código fuente C cuando sea posible.</para>
+      </tip>
+
+    </sect1>
+
+    <sect1 id="documenting_symbols">
+      <title>Documentar símbolos</title>
+
+      <para>Cada símbolo (función, macro, estructura, enum, señal y propiedad) está documentado en un bloque separado. La mejor posición para el bloque es junto a la definición del símbolo de tal forma que sea fácil mantenerlos sincronizados. Por ello las funciones generalmente se documentan en el código C y las macros, estructuras y enum en el archivo de cabecera.</para>
+
+      <para>
+        <example><title>Bloque de comentario de función</title>
+          <programlisting>
+<![CDATA[
+/**
+ * function_name:
+ * @par1:  description of parameter 1. These can extend over more than
+ * one line.
+ * @par2:  description of parameter 2
+ *
+ * The function description goes here. You can use @par1 to refer to parameters
+ * so that they are highlighted in the output. You can also use %constant
+ * for constants, function_name2() for functions and #GtkWidget for links to
+ * other declarations (which may be documented elsewhere).
+ *
+ * Returns: an integer.
+ */
+]]>
+          </programlisting>
+        </example>
+      </para>
+
+      <variablelist>
+        <varlistentry>
+          <term>Devuelve:</term>
+          <listitem>
+            <para>Párrafo que describe el resultado devuelto.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Obsoleto:</term>
+          <listitem>
+            <para>Párrafo que denota que esta función no se debería usar más. La descripción debería informar al lector de la nueva API.</para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>Desde:</term>
+          <listitem>
+            <para>Descripción desde qué versión del código está disponible la API.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+
+      <para>GTK-Doc asume que todos los símbolos (macros, funciones) que empiezan por «_» son privados. Se tratan como funciones estáticas.</para>
+
+      <para>(ARREGLAR) (estabilidad) (glib-enums, ...)</para>
+
+      <example><title>Bloque de comentario de propiedad</title>
+        <programlisting>
+<![CDATA[
+/**
+ * SomeWidget:some-property:
+ *
+ * Here you can document a property.
+ */
+g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);
+]]></programlisting>
+      </example>
+
+      <example><title>Bloque de comentario de señal</title>
+        <programlisting>
+<![CDATA[
+/**
+ * FooWidget::foobarized:
+ * @widget: the widget that received the signal
+ * @foo: some foo
+ * @bar: some bar
+ *
+ * The ::foobarized signal is emitted each time someone tries to foobarize @widget.
+ */
+foo_signals[FOOBARIZE] =
+  g_signal_new ("foobarize",
+                ...
+]]></programlisting>
+      </example>
+
+         <example><title>Bloque de comentario de estructura</title>
+        <programlisting>
+<![CDATA[
+/**
+ * FooWidget:
+ * @bar: some #gboolean
+ *
+ * This is the best widget, ever.
+ */
+typedef struct _FooWidget {
+  GtkWidget parent;
+  /*< public >*/
+  gboolean bar;
+} FooWidget;
+]]></programlisting>
+      </example>
+    </sect1>
+
+    <sect1 id="documenting_docbook">
+      <title>Etiquetas DocBook útiles</title>
+
+      <para>Aquí están varias etiquetas de DocBook muy útiles al documentar código.</para>
+
+      <para>
+        To link to another section in the GTK docs:
+
+        <informalexample>
+          <programlisting>
+<![CDATA[
+<link linkend="glib-Hash-Tables">Hash Tables</link>
+]]>
+          </programlisting>
+        </informalexample>
+        The linkend is the SGML id on the top item of the page you want to link to.
+        For most pages this is currently the part ("gtk", "gdk", glib") and then
+        the page title ("Hash Tables"). For widgets it is just the class name.
+        Spaces and underscores are converted to '-' to conform to SGML.
+      </para>
+
+      <para>
+        To refer to an external function, e.g. a standard C function:
+        <informalexample>
+          <programlisting>
+<![CDATA[
+<function>...</function>
+]]>
+          </programlisting>
+        </informalexample>
+      </para>
+
+      <para>Para incluir un código de ejemplo: <informalexample>
+          <programlisting>
+<![CDATA[
+<example>
+  <title>Using a GHashTable.</title>
+  <programlisting>
+      ...
+  </programlisting>
+</example>
+]]>
+          </programlisting>
+        </informalexample> o posiblemente este, para fragmentos de código muy cortos que no necesitan título: <informalexample>
+          <programlisting>
+<![CDATA[
+<informalexample>
+  <programlisting>
+  ...
+  </programlisting>
+</informalexample>
+]]>
+          </programlisting>
+        </informalexample>. Para el último, GTK-Doc también soporta abreviación: <![CDATA[
+|[
+  ...
+]|
+]]></para>
+
+      <para>Para incluir listas de topos: <informalexample>
+          <programlisting>
+<![CDATA[
+<itemizedlist>
+  <listitem>
+    <para>
+      ...
+    </para>
+  </listitem>
+  <listitem>
+    <para>
+      ...
+    </para>
+  </listitem>
+</itemizedlist>
+]]>
+          </programlisting>
+        </informalexample></para>
+
+      <para>
+        To include a note which stands out from the text:
+        <informalexample>
+          <programlisting>
+<![CDATA[
+<note>
+  <para>
+    Make sure you free the data after use.
+  </para>
+</note>
+]]>
+          </programlisting>
+        </informalexample>
+      </para>
+
+      <para>Para referirse a un tipo: <informalexample>
+          <programlisting>
+<![CDATA[
+<type>unsigned char</type>
+]]>
+          </programlisting>
+        </informalexample></para>
+
+      <para>Para referirse a una estructura externa (no una descrita en la documentación de GTK): <placeholder-1/></para>
+
+      <para>Para referirse a un campo o a una estructura: <informalexample>
+          <programlisting>
+<![CDATA[
+<structfield>len</structfield>
+]]>
+          </programlisting>
+        </informalexample></para>
+
+      <para>Para referirse a un nombre de clase, se podría usar: <placeholder-1/> pero probablemente estará usando #GtkWidget en su lugar (para crear automaticamenteun enlace a la página GtkWidget; consulte <link linkend="documenting_syntax">abreviaciones</link>).</placeholder-1></para>
+
+      <para>Para enfatizar un texto: <informalexample>
+          <programlisting>
+<![CDATA[
+<emphasis>This is important</emphasis>
+]]>
+          </programlisting>
+        </informalexample></para>
+
+      <para>Para uso de nombres de archivo: <informalexample>
+          <programlisting>
+<![CDATA[
+<filename>/home/user/documents</filename>
+]]>
+          </programlisting>
+        </informalexample></para>
+
+    </sect1>
+  </chapter>
+
+  <chapter id="metafiles">
+    <title>Rellenar campos adicionales</title>
+
+    <para>
+      There are a couple of extra file, that need to be maintained along with
+      the inline source code comments:
+      <filename>&lt;package&gt;.types</filename>,
+      <filename>&lt;package&gt;-docs.sgml</filename>,
+      <filename>&lt;package&gt;-sections.txt</filename>.
+    </para>
+
+    <sect1 id="metafiles_types">
+      <title>Editar los tipos de archivo</title>
+
+      <para>
+        If your library or application includes GtkObjects/GObjects, you want
+        their signals, arguments/parameters and position in the hierarchy to be
+        shown in the documentation. All you need to do, is to list the
+        <function>xxx_get_type</function> functions together with their include
+        inside the <filename>&lt;package&gt;.types</filename> file.
+      </para>
+
+      <para>
+        <example><title>Example types file snippet</title>
+          <programlisting>
+<![CDATA[
+#include <gtk/gtk.h>
+
+gtk_accel_label_get_type
+gtk_adjustment_get_type
+gtk_alignment_get_type
+gtk_arrow_get_type
+]]>
+          </programlisting>
+        </example>
+      </para>
+
+      <para>Desde GTK-Doc 1.8 <application>gtkdoc-scan</application> puede genera esta lista. Simplemente añada «--rebuild-types» a SCAN_OPTIONS en el <filename>Makefile.am</filename>. Si usa esto no debería ejecutar dist sobre los tipos de archivo ni tenerlos bajo el control de versiones.</para>
+
+    </sect1>
+
+    <sect1 id="metafiles_master">
+      <title>Editar la sección maestra del documento</title>
+
+      <para>
+        Gtk-Doc produces documentation in DocBook SGML/XML. When processing the
+        inline source comments, the Gtk-Doc tools generate one documentation
+        page per class or module as a separate file. The master document
+        includes them and place them in a order.
+      </para>
+
+      <para>
+        While Gtk-Doc creates a template master document for you, later run will
+        not touch it again. This means that one can freely structure the
+        documentation. That includes grouping pages and adding extra pages.
+        Gtk-doc has now a test suite, where also the master-document is recreated from scratch.
+        Its a good idea to look at this from time to time to see if there are some new goodies
+        introduced there.
+      </para>
+
+      <tip>
+        <para>
+          Do not create tutorials as extra documents. Just write extra chapters.
+          The benefit of directly embedding the tutorial for your library into
+          the API documentation is that it is easy to link for the tutorial to
+          symbol documentation. Apart chances are higher that the tutorial gets
+          updates along with the library.
+        </para>
+      </tip>
+
+      <para>
+        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 which you should take care of.
+      </para>
+
+      <para>
+        <example><title>Cabecera del documento maestro</title>
+          <programlisting>
+<![CDATA[
+<bookinfo>
+  <title>MODULENAME Reference Manual</title>
+  <releaseinfo>
+    for MODULENAME [VERSION]
+    The latest version of this documentation can be found on-line at
+    <ulink role="online-location" url="http://[SERVER]/MODULENAME/index.html";>http://[SERVER]/MODULENAME/</ulink>.
+  </releaseinfo>
+</bookinfo>
+
+<chapter>
+  <title>[Insert title here]</title>
+]]>
+          </programlisting>
+        </example>
+      </para>
+
+    </sect1>
+
+    <sect1 id="metafiles_sections">
+      <title>Editar la sección del archivo</title>
+
+      <para>
+        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 the visibility (public or private).
+      </para>
+
+      <para>
+        The section file is a plain test file with xml like syntax (using tags).
+        Blank lines are ignored and lines starting with a '#' are treated as
+        comment lines.
+      </para>
+
+      <para>
+        The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name,
+        without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/FILE&gt;'
+        will result in the section declarations being output in the template
+        file <filename>tmpl/gnome-config.sgml</filename>, which will be
+        converted into the DocBook SGML file <filename>sgml/gnome-config.sgml</filename>
+        or .DocBook XML file <filename>xml/gnome-config.xml</filename>.
+        (The name of the html file is based on the module name and the section
+        title, or for gobjects it is based on the gobjects class name converted
+        to lower case).
+      </para>
+
+      <para>
+        The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of
+        the section. It is only useful before the templates are initially
+        created, since the title set in the template file overrides this.
+      </para>
+
+      <para>
+        You can group items in the section by using the &lt;SUBSECTION&gt; tag.
+        Currently it outputs a blank line between subsections in the synopsis
+        section.
+        You can also use &lt;SUBSECTION Standard&gt; for standard GObject
+        declarations (e.g. the functions like g_object_get_type and macros like
+        G_OBJECT(), G_IS_OBJECT() etc.).
+        Currently these are left out of the documentation.
+        You can also use &lt;SUBSECTION Private&gt; for private declarations
+        which will not be output (It is a handy way to avoid warning messages
+        about unused declarations.).
+        If your library contains private types which you don't want to appear in
+        the object hierarchy and the list of implemented or required interfaces,
+        add them to a Private subsection.
+      </para>
+
+      <para>
+        You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the
+        #include files which are shown in the synopsis sections.
+        It contains a comma-separate list of #include files, without the angle
+        brackets. If you set it outside of any sections, it acts for all
+        sections until the end of the file. If you set it within a section, it
+        only applies to that section.
+      </para>
+
+    </sect1>
+
+  </chapter>
+
+  <chapter id="reports">
+    <title>Controlar el resultado</title>
+
+    <para>
+      A Gtk-Doc run generates report files inside the documentation directory.
+      The generated files are named:
+      <filename>&lt;package&gt;-undocumented.txt</filename>,
+      <filename>&lt;package&gt;-undeclared.txt</filename> and
+      <filename>&lt;package&gt;-unused.txt</filename>.
+      All those are plain text files that can be viewed and postprocessed easily.
+    </para>
+
+    <para>
+      The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with
+      the documentation coverage summary. Below are two sections divided by
+      blank lines. The first section lists undocumented or incomplete symbols.
+      The second section does the same for section docs. Incomplete entries are
+      those, which have documentation, but where e.g. a new parameter has been
+      added.
+    </para>
+
+    <para>
+      The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols
+      given in the <filename>&lt;package&gt;-section.txt</filename> but not
+      found in the sources. Check if they have been removed or if they are
+      misspelled.
+    </para>
+
+    <para>
+      The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol
+      names, where the Gtk-Doc scanner has found documentation, but does not
+      know where to put it. This means that the symbol has not yet been added to
+      the <filename>&lt;package&gt;-section.txt</filename> file.
+    </para>
+
+    <tip>
+      <para>
+        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
+        make check run.
+      </para>
+    </tip>
+
+  </chapter>
+
+  <chapter id="faq">
+    <title>Preguntas más frecuentes</title>
+
+    <segmentedlist>
+      <?dbhtml list-presentation="list"?>
+      <segtitle>Pregunta</segtitle>
+      <segtitle>Respuesta</segtitle>
+      <seglistitem>
+	<seg>No class hierarchy.</seg>
+	<seg>The objects _get_type() function has not been entered into the <filename>.types</filename> file.</seg>
+      </seglistitem>
+      <seglistitem>
+	<seg>Aún sin jerarquía de clases.</seg>
+	<seg>Nombres erróneos en el archivo de sección (consultar <ulink url="http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html";>explicación</ulink>)</seg>
+      </seglistitem>
+      <seglistitem>
+	<seg>Maldición, aún no hay una jerarquía de clases.</seg>
+	<seg>Is the object name (name of the instance struct) part of the normal section (don't put this into Standard or Private).</seg>
+      </seglistitem>
+      <seglistitem>
+	<seg>Sin índice de símbolos.</seg>
+	<seg>FIXME (&lt;index&gt; tag in main sgml file)</seg>
+      </seglistitem>
+      <seglistitem>
+	<seg>Los símbolos no se enlazan con su sección en el documento.</seg>
+	<seg>FIXME (added #,% or () ?)</seg>
+      </seglistitem>
+      <seglistitem>
+	<seg>Una clase nueva no aparece en la documentación.</seg>
+	<seg>FIXME (section file, types file, main-sgml file)</seg>
+      </seglistitem>
+      <seglistitem>
+	<seg>Un símbolo nuevo no aparece en la documentación.</seg>
+	<seg>FIXME (section file, proper doc comment)</seg>
+      </seglistitem>
+
+      <!-- gtk-doc warnings: -->
+      <seglistitem>
+	<seg>Parameter described in source code comment block but does not exist</seg>
+	<seg>Compruebe si el prototipo en la cabecera tiene nombres de parámetro diferentes de la fuente.</seg>
+      </seglistitem>
+      <!-- docbook warnings: -->
+      <seglistitem>
+	<seg>«ID» múltiples para la restricción enlazada: XYZ</seg>
+	<seg>El símbolo XYZ aparece dos veces en el archivo -section.txt</seg>
+      </seglistitem>
+      <seglistitem>
+	<seg>Element typename in namespace '' encountered in para, but no template matches.</seg>
+        <seg/>
+      </seglistitem>
+    </segmentedlist>
+  </chapter>
+
+  <!-- ======== Appendix: FDL ================================== -->
+  <!--  
+     The GNU Free Documentation License 1.1 in DocBook
+     Markup by Eric Baudais <baudais okstate edu>
+     Maintained by the GNOME Documentation Project
+     http://developer.gnome.org/projects/gdp
+     Version: 1.0.1
+     Last Modified: Nov 16, 2000
+-->
+
+<appendix id="fdl">
+  <appendixinfo>
+    <releaseinfo>Versión 1.1, marzo de 2000</releaseinfo>
+    <copyright>
+      <year>2000</year><holder>Free Software Foundation, Inc.</holder>
+    </copyright>
+    <legalnotice id="fdl-legalnotice">
+      <para><address>Free Software Foundation, Inc. <street>51 Franklin Street, Suite 330</street>, <city>Boston</city>, <state>MA</state><postcode>02110-1301</postcode><country>EE. UU.</country></address> Se permite la copia y distribución de este documento de licencia, pero no se permite su modificación.</para>
+    </legalnotice>
+  </appendixinfo>
+  <title>GNU Free Documentation License</title>
+
+  <sect1 id="fdl-preamble">
+    <title>0. PREÃ?MBULO</title>
+    <para>El propósito de esta Licencia es permitir que un manual, libro de texto, u otro documento escrito sea <quote>libre</quote> en el sentido de libertad: asegurar a todo el mundo la libertad efectiva de copiarlo y redistribuirlo, con o sin modificaciones, de manera comercial o no. En segundo término, esta Licencia proporciona al autor y al editor una manera de obtener reconocimiento por su trabajo, sin que se le considere responsable de las modificaciones realizadas por otros.</para>
+    
+    <para> Esta Licencia es de tipo <quote>copyleft</quote>, lo que significa que los trabajos derivados del documento deben a su vez ser libres en el mismo sentido. Complementa la Licencia Pública General de GNU, que es una licencia tipo copyleft diseñada para el software libre.</para>
+    
+    <para>Hemos diseñado esta Licencia para usarla en manuales de software libre, ya que el software libre necesita documentación libre: Un programa libre debe venir con los manuales que ofrezcan la mismas libertades que da el software. Pero esta licencia no se limita a manuales de software; puede ser usada para cualquier trabajo textual, sin tener en cuenta su temática o si se publica como libro impreso. Recomendamos esta licencia principalmente para trabajos cuyo fin sea instructivo o de referencia.</para>
+  </sect1>
+  <sect1 id="fdl-section1">
+    <title>1. APLICABILIDAD Y DEFINICIONES</title>
+    <para id="fdl-document">Esta Licencia se aplica a cualquier manual u otro trabajo que contenga un aviso colocado por el poseedor del copyright diciendo que puede distribuirse bajo los términos de esta Licencia. El <quote>Documento</quote>, abajo, se refiere a cualquier manual o trabajo. Cualquier miembro del público es un licenciatario,y será referido como <quote>Usted</quote>.</para>
+    
+    <para id="fdl-modified">Una <quote>Versión Modificada</quote> del Documento significa cualquier trabajo que contenga el Documento o una porción del mismo, ya sea una copia literal o con modificaciones y/o traducciones a otro idioma.</para>
+	
+    <para id="fdl-secondary">Una <quote>Sección Secundaria</quote> es un apéndice con título o una sección preliminar del Documento que trata exclusivamente de la relación entre los autores o editores y el tema general del<link linkend="fdl-document">Documento</link> que trata exclusivamente con la relación entre los editores o autores del Documento con el asunto general del Documento (o asuntos relacionados) y no contiene nada que pueda considerarse dentro del tema principal. (Por ejemplo, si el Documento es en parte un libro de texto de matemáticas, una Sección Secundaria no explicará nada de matemáticas.) La relación puede ser una conexión histórica con el asunto o temas relacionados, o una opinión legal, comercial, filosófica, ética o política acerca de ellos.</para>
+
+    <para id="fdl-invariant">Las <quote>Secciones Invariantes</quote> son ciertas <link linkend="fdl-secondary">Secciones Secundarias</link> cuyos títulos son designados como Secciones Invariantes en la nota que indica que el <link linkend="fdl-document">Documento</link> se publica bajo esta Licencia.</para>
+    
+    <para id="fdl-cover-texts"> Los <quote>Textos de Cubierta</quote> son ciertos pasajes cortos de texto que se listan como Textos de Cubierta Delantera o Textos de Cubierta Trasera en la nota que indica que el <link linkend="fdl-document">Documento</link> se publica bajo esta Licencia.</para>
+	
+    <para id="fdl-transparent"> Una copia <quote>Transparente</quote> del <link linkend="fdl-document">Documento</link>, significa una copia para lectura en máquina, representada en un formato cuya especificación está disponible al público en general, cuyo contenido puede ser visto y editados directamente con editores de texto genéricos o (para imágenes compuestas por píxeles) con programas genéricos de manipulación de imágenes o (para dibujos) con algún editor de dibujos ampliamente disponible, y que sea adecuado como entrada para formateadores de texto o para su traducción automática a formatos adecuados para formateadores de texto. Una copia hecha en un formato definido como Transparente, pero cuyo marcaje o ausencia de él haya sido diseñado para impedir o dificultar modificaciones posteriores por parte de los lectores no es Transparente. Una copia que no es <quote>Transparente</quote> se denomina <quote>Opaca</quote>.</para>
+    
+    <para>Como ejemplos de formatos adecuados para copias Transparentes están ASCII puro sin marcaje, formato de entrada de Texinfo, formato de entrada de LaTeX, SGML o XML usando una DTD disponible públicamente, y HTML, PostScript o PDF simples, que sigan los estándares y diseños para que los modifiquen personas.Los formatos Opacos incluyen formatos propietarios que pueden ser leídos y editados únicamente en procesadores de textos propietarios, SGML o XML para los cuáles las DTD y/o herramientas de procesamiento no estén ampliamente disponibles, y HTML, PostScript o PDF generados por algunos procesadores de textos sólo como salida.</para>
+    
+    <para id="fdl-title-page"> La <quote>Portada</quote> significa, en un libro impreso, la página de título, más las páginas siguientes que sean necesarias para mantener legiblemente el material que esta Licencia requiere en la portada. Para trabajos en formatos que no tienen página de portada como tal, <quote>Portada</quote>significa el texto cercano a la aparición más prominente del título del trabajo,precediendo el comienzo del cuerpo del texto.</para>
+  </sect1>
+    
+  <sect1 id="fdl-section2">
+    <title>2. COPIA VERBATIM</title>
+    <para>Usted puede copiar y distribuir el <link linkend="fdl-document">Documento</link> en cualquier medio, sea en forma comercial o no, siempre y cuando proporcione esta Licencia, las notas de copyright y la nota que indica que esta Licencia se aplica al Documento reproduciéndola en todas las copias y que usted no añada ninguna otra condición a las expuestas en esta Licencia. Usted no puede usar medidas técnicas para obstruir o controlar la lectura o copia posterior de las copias que usted haga o distribuya. Sin embargo, usted puede aceptar compensación a cambio de las copias. Si distribuye un número suficientemente grande de copias también deberá seguir las condiciones de la <link linkend="fdl-section3">sección 3</link>.</para>
+    
+    <para> Usted también puede prestar copias, bajo las mismas condiciones establecidas anteriormente, y puede exhibir copias públicamente.</para>
+    </sect1>
+    
+  <sect1 id="fdl-section3">
+    <title>3. COPIAR EN CANTIDAD</title>
+    <para> Si publica copias impresas del <link linkend="fdl-document">Documento</link> que sobrepasen las 100, y la nota de licencia del Documento exige <link linkend="fdl-cover-texts">Textos de Cubierta</link>, debe incluirlas copias con cubiertas que lleven en forma clara y legible todos esos Textos de Cubierta: Textos de Cubierta Delantera en la cubierta delantera y Textos de Cubierta Trasera en la cubierta trasera. Ambas cubiertas deben identificarlo a Usted clara y legiblemente como editor de tales copias. La cubierta debe mostrar el título completo con todas las palabras igualmente prominentes y visibles. Además puede añadir otro material en las cubiertas. Las copias con cambios limitados a las cubiertas, siempre que conserven el título del <link linkend="fdl-document">Documento</link> y satisfagan estas condiciones, pueden considerarse como copias literales en todos los aspectos.</para>
+    
+    <para> Si los textos requeridos para la cubierta son muy voluminosos para que ajusten legiblemente, debe colocar los primeros (tantos como sea razonable colocar) en la verdadera cubierta y situar el resto en páginas adyacentes.</para>
+    
+    <para> Si Usted publica o distribuye copias <link linkend="fdl-transparent">Opacas</link> del <link linkend="fdl-document">Documento</link> cuya cantidad exceda las 100, debe incluir una copia <link linkend="fdl-transparent">Transparente</link>, que pueda ser leída por una máquina, con cada copia Opaca, o bien mostrar, en cada copia Opaca, una dirección de red donde cualquier usuario de la misma tenga acceso por medio de protocolos públicos y estandarizados a una copia Transparente del Documento completa, sin material adicional. Si usted hace uso de la última opción, deberá tomar las medidas necesarias, cuando comience la distribución de las copias Opacas en cantidad, para asegurar que esta copia Transparente permanecerá accesible en el sitio establecido por lo menos un año después de la última vez que distribuya una copia Opaca de esa edición al público (directamente o a través de sus agentes o distribuidores).</para>
+    
+    <para>Se solicita, aunque no es requisito, que se ponga en contacto con los autores del <link linkend="fdl-document">Documento</link> antes de redistribuir gran número de copias, para darles la oportunidad de que le proporcionen una versión actualizada del Documento.</para>
+    </sect1>
+    
+  <sect1 id="fdl-section4">
+    <title>4. MODIFICACIONES</title>
+    <para>Puede copiar y distribuir una <link linkend="fdl-modified">Versión Modificada</link> del <link linkend="fdl-document">Documento</link> bajo las condiciones de las secciones <link linkend="fdl-section2">2</link> y <link linkend="fdl-section3">3</link> anteriores, siempre que Usted libere la Versión Modificada bajo esta misma Licencia, con la Versión Modificada haciendo el rol del Documento, por lo tanto dando Licencia de distribución y modificación de la Versión Modificada a quienquiera posea una copia de la misma. Además, debe hacer lo siguiente en la Versión Modificada:</para>
+    
+    <itemizedlist mark="opencircle">
+      <listitem>
+	<formalpara>
+	  <title>A</title>
+	  <para>Usar en la <link linkend="fdl-title-page">Portada</link> (y en las cubiertas, si hay alguna) un título distinto al del <link linkend="fdl-document">Documento</link> y de sus versiones anteriores (que deberían, si hay alguna, estar listadas en la sección de Historia del Documento). Puede usar el mismo título de versiones anteriores al original siempre y cuando quien las publicó originalmente otorgue permiso.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>B</title>
+	  <para>Listar en la <link linkend="fdl-title-page">Portada</link>, como autores, una o más personas o entidades responsables de la autoría de las modificaciones de la <link linkend="fdl-modified">Versión Modificada</link>, junto con por lo menos cinco de los autores principales del <link linkend="fdl-document">Documento</link> (todos sus autores principales, si hay menos de cinco), a menos que le eximan de tal requisito.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>C</title>
+	  <para>Mostrar en la <link linkend="fdl-title-page">Portada</link>  como editor el nombre del editor de la <link linkend="fdl-modified">Versión Modificada</link></para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>D</title>
+	  <para>Conservar todas las notas de copyright del <link linkend="fdl-document">Documento</link>.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>E</title>
+	  <para>Añadir una nota de copyright apropiada a sus modificaciones, adyacente a las otras notas de copyright.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>F</title>
+	  <para>Incluir, inmediatamente después de los avisos de copyright, una nota de licencia dando el permiso público para usar la <link linkend="fdl-modified">Versión Modificada</link> bajo los términos de esta Licencia, de la forma mostrada en el Adenda de más abajo.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>G</title>
+	  <para>Incluir, inmediatamente después de ese aviso de licencia, la lista completa de <link linkend="fdl-invariant">Secciones invariantes</link> y de los <link linkend="fdl-cover-texts">Textos de Cubierta</link> que sean requeridos en el aviso de Licencia del <link linkend="fdl-document">Documento</link> original.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>H</title>
+	  <para>Incluir una copia sin modificación de esta Licencia.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>I</title>
+	  <para>Conservar la sección titulada <quote>Historia</quote>, conservar su Título y añadirle un elemento que declare al menos el título, el año, los nuevos autores y el editor de la <link linkend="fdl-modified">Versión Modificada</link>, tal como figuran en la <link linkend="fdl-title-page">Portada</link>. Si no hay una sección titulada <quote>Historia</quote> en el <link linkend="fdl-document">Documento</link>, crear una estableciendo el título, el año, los autores y el editor del Documento, tal como figuran en su Portada, añadiendo además un elemento describiendo la Versión Modificada, como se estableció en la sentencia anterior.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>J</title>
+	  <para>Conservar la dirección en red, si la hay, dada en el <link linkend="fdl-document">Documento</link> para el acceso público a una copia <link linkend="fdl-transparent">Transparente</link> del mismo, así como las otras direcciones de red dadas en el Documento para versiones anteriores en las que estuviese basado. Pueden ubicarse en la sección <quote>Historia</quote>. Se puede omitir la ubicación en red de un trabajo que haya sido publicado por lo menos cuatro años antes que el Documento mismo, o si el editor original de dicha versión da permiso.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>K</title>
+	  <para>En cualquier sección titulada <quote>Agradecimientos</quote> o <quote>Dedicatorias</quote>, conservar el título de la sección y conservar en ella toda la sustancia y el tono de los agradecimientos y/o dedicatorias incluidas por cada contribuyente.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>L</title>
+	  <para>Conservar todas las <link linkend="fdl-invariant">Secciones Invariantes</link> del <link linkend="fdl-document">Documento</link>, sin alterar su texto ni sus títulos. Los números de sección o equivalentes no se consideran parte de los títulos de la sección.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>M</title>
+	  <para>Borrar cualquier sección titulada <quote>Aprobaciones</quote>. Tales secciones no pueden estar incluidas en las <link linkend="fdl-modified">Versiones Modificadas</link>.</para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>N</title>
+	  <para>No cambiar el título de ninguna sección existente a <quote>Aprobaciones</quote> ni a uno que entre en conflicto con el de alguna <link linkend="fdl-invariant">Sección Invariante</link>.</para>
+	</formalpara>
+      </listitem>
+    </itemizedlist>
+    
+    <para> Si la <link linkend="fdl-modified">Versión Modificada</link> incluye secciones o apéndices nuevos que cualifiquen como <link linkend="fdl-secondary">Secciones Secundarias</link> y no contienen ningún material copiado del Documento, puede opcionalmente designar algunas o todas esas secciones como invariantes. Para hacerlo, añada sus títulos a la lista de <link linkend="fdl-invariant">Secciones Invariantes</link> en el aviso de licencia de la Versión Modificada. Tales títulos deben ser distintos de cualquier otro título de sección.</para>
+    
+    <para>Puede añadir una sección titulada <quote>Aprobaciones</quote>, siempre que contenga únicamente aprobaciones de su <link linkend="fdl-modified">Versión Modificada</link> por otras fuentes --por ejemplo, observaciones de compañeros o que el texto ha sido aprobado por una organización como definición oficial de un estándar.</para>
+    
+    <para>Puede añadir un pasaje de hasta cinco palabras como <link linkend="fdl-cover-texts">Texto de Cubierta Delantera</link> y un pasaje de hasta 25 palabras como <link linkend="fdl-cover-texts">Texto de Cubierta Trasera</link> al final de la lista de <link linkend="fdl-cover-texts">Texto de Cubierta</link> en la <link linkend="fdl-modified">Versión Modificada</link>. Una entidad sólo puede añadir (o hacer que se añada) un pasaje al Texto de Cubierta Delantera y uno al de Cubierta Trasera. Si el <link linkend="fdl-document">Documento</link> ya incluye un textos de cubiertas añadidos previamente por usted o por acuerdo previo con la entidad que usted representa, usted no puede añadir otro; pero puede reemplazar el anterior, con permiso explícito del editor anterior que agregó el texto anterior.</para>
+    
+    <para>Con esta Licencia ni los autores ni los editores del <link linkend="fdl-document">Documento</link> dan permiso para usar sus nombres para publicidad ni para asegurar o implicar aprobación de cualquier <link linkend="fdl-modified">Versión Modificada</link>.</para>
+  </sect1>
+    
+  <sect1 id="fdl-section5">
+    <title>5. COMBINAR DE DOCUMENTOS</title>
+    <para>Usted puede combinar el <link linkend="fdl-document">Documento</link> con otros documentos liberados bajo esta Licencia, bajo los términos definidos en la sección <link linkend="fdl-section4">section 4</link> más arriba para versiones modificadas, siempre que incluya en la combinación todas las <link linkend="fdl-invariant">Secciones Invariantes</link> de todos los documentos originales, sin modificaciones, y las liste todas como Secciones Invariantes de su trabajo combinado en su aviso de licencia.</para>
+    
+    <para>El trabajo combinado necesita contener solamente una copia de esta Licencia, y múltiples <link linkend="fdl-invariant">Secciones Invariantes</link> idénticas pueden reemplazarse por una sola copia. Si hay múltiples Secciones Invariantes con el mismo nombre pero con contenidos diferentes, haga el título de cada una de estas secciones único añadiéndolo al final de este, entre paréntesis, el nombre del autor o de quien editó originalmente esa sección, si es conocido, o si no, un número único. Haga el mismo ajuste a los títulos de sección en la lista de Secciones Invariantes en la nota de licencia del trabajo combinado.</para>
+    
+    <para>En la combinación, debe combinar cualquier sección titulada <quote>Historia</quote> de los distintos documentos originales, formando una sección titulada <quote>Historia</quote>; de la misma forma, combine cualquier sección titulada <quote>Reconocimientos</quote> y cualquier sección titulada <quote>Dedicatorias</quote>. Debe borrar todas las secciones tituladas <quote>Aprobaciones</quote>.</para>
+    </sect1>
+    
+  <sect1 id="fdl-section6">
+    <title>6. COLECCIONES DE DOCUMENTOS</title>
+    <para> Puede hacer una colección que conste del <link linkend="fdl-document">Documento</link> y de otros documentos publicados bajo esta Licencia, y reemplazar las copias individuales de esta Licencia en todos los documentos por una sola copia que esté incluida en la colección, siempre que siga las reglas de esta Licencia para cada copia literal de cada uno de los documentos en cualquiera de los demás aspectos.</para>
+    
+    <para> Puede extraer un solo documento de una de tales colecciones y distribuirlo individualmente bajo esta Licencia, siempre que inserte una copia de esta Licencia en el documento extraído, y siga esta Licencia en todos los demás aspectos relativos a la copia literal de dicho documento.</para>
+    </sect1>
+    
+  <sect1 id="fdl-section7">
+    <title>7. AGREGACIONES CON TRABAJOS INDEPENDIENTES</title>
+    <para>Una recopilación que conste del <link linkend="fdl-document">Documento</link> o sus derivados y de otros documentos o trabajos separados e independientes, en cualquier soporte de almacenamiento o distribución, no cuenta como un todo como una <link linkend="fdl-modified">Versión Modificada</link> del Documento, siempre que no se reclame ningún derecho de copyright por la compilación. Dicha compilación se denomina un <quote>agregado</quote>, y esta Licencia no se aplica a otros trabajos  autocontenidos incluidos con el Documento. teniendo en cuenta que son compilados, si no son los mismos trabajos derivados del Documento. Si el requisito de <link linkend="fdl-cover-texts">Texto de Cubierta</link> de la <link linkend="fdl-section3">sección 3</link> es aplicable a estas copias del Documento, entonces si el Documento es menor que un cuarto del agregado completo, los Textos de Cubierta del Documento pueden colocarse en cubiertas que enmarquen solamente el Document
 o dentro del agregado. En caso contrario deben aparecer en cubiertas impresas enmarcando todo el agregado.</para>
+    </sect1>
+    
+  <sect1 id="fdl-section8">
+    <title>8. TRADUCCIÃ?N</title>
+    <para>La traducción se considera un tipo de modificación, así que puede distribuir traducciones del <link linkend="fdl-document">Documento</link> bajo los términos de la <link linkend="fdl-section4">sección 4</link>. Reemplazar las <link linkend="fdl-invariant">Secciones invariantes</link> con traducciones requiere permiso especial de los mantenedores de la propietarios del copyright, pero puede incluir traducciones de algunos o todas las Secciones invariantes. Puede incluir una traducción de esta licencia proporcionada que además incluya la versión original de esta Sección invariante en adición de esta licencia. En caso de desacuerdo prevalecerá la versión original en inglés.</para>
+    </sect1>
+    
+  <sect1 id="fdl-section9">
+    <title>9. TERMINACIÃ?N</title>
+    <para> Usted no puede copiar, modificar, sublicenciar o distribuir el <link linkend="fdl-document">Documento</link> salvo por lo permitido expresamente por esta Licencia. Cualquier otro intento de copia, modificación, sublicenciamiento o distribución del Documento es nulo, y dará por terminados automáticamente sus derechos bajo esa Licencia. Sin embargo, los terceros que hayan recibido copias, o derechos, de usted bajo esta Licencia no verán terminadas sus licencias, siempre que permanezcan en total conformidad con ella.</para>
+    </sect1>
+    
+  <sect1 id="fdl-section10">
+    <title>10. REVISIONES FUTURAS DE ESTA LICENCIA</title>
+    <para>La <ulink type="http" url="http://www.gnu.org/fsf/fsf.html";>Free Software Foundation</ulink> puede publicar versiones nuevas y revisadas de la Licencia de Documentación Libre GNU de vez en cuando. Dichas versiones nuevas serán similares en espíritu a la presente versión, pero pueden diferir en detalles para solucionar nuevos problemas o preocupaciones. Vea <ulink type="http" url="http://www.gnu.org/copyleft";>http://www.gnu.org/copyleft/</ulink>.</para>
+    
+    <para>Cada versión de la licencia tiene un número de versión. Si la <link linkend="fdl-document">Documentación</link> especifica que el número particular de versión de esta Licencia <quote>o cualquier posterior versión</quote> aplicado sobre él, tiene la opción de seguir los términos y condiciones de cualquiera de esas versiones especificadas o de cualquiera de las versiones publicadas (no como borrador) por la Free Software Foundation. Si el Documento no especifica un número de versión de la licencia, puede elegir cualquier versión publicada (no como borrador) por la Free Software Foundation.</para>
+  </sect1>
+
+  <sect1 id="fdl-using">
+    <title>Addendum</title>
+    <para>Para usar esta licencia en un documento que ha escrito, incluya una copia de la Licencia en el documento y ponga el siguiente copyright y las notas justo después del título de la página.</para>
+    
+    <blockquote>
+      <para>Copyright AÃ?O SU NOMBRE.</para>
+      <para>Se otorga permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de Documentación Libre de GNU, Versión 1.1 o cualquier otra versión posterior publicada por la Free Software Foundation; con las <link linkend="fdl-invariant">Secciones Invariantes</link> siendo su LISTE SUS T�TULOS, con <link linkend="fdl-cover-texts">Textos de Cubierta Delantera</link> siendo LISTA, y con los <link linkend="fdl-cover-texts">Textos de Cubierta Trasera</link> siendo LISTA. Una copia de la licencia está incluida en la sección titulada <quote>GNU Free Documentation License</quote>.</para>
+    </blockquote>
+      
+    <para>Si no tiene <link linkend="fdl-invariant">Secciones Invariantes</link>, escriba <quote>sin Secciones Invariantes</quote> en vez de decir cuáles son invariantes. Si no tiene <link linkend="fdl-cover-texts">Textos de Cubierta Frontal</link>, escriba <quote>sin Textos de Cubierta Frontal</quote>; de la misma manera para <link linkend="fdl-cover-texts">Textos de Cubierta Trasera</link>.</para>
+    
+    <para>Si su documento contiene ejemplos de código de programa no triviales, recomendamos liberar estos ejemplos en paralelo bajo la licencia de software libre que usted elija, como la <ulink type="http" url="http://www.gnu.org/copyleft/gpl.html";>Licencia Pública General de GNU (GNU General Public License)</ulink>, para permitir su uso en software libre.</para>
+  </sect1>
+</appendix>  
+
+
+
+
+
+
+
+
+</book>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]