maint-guide 1.116 - en to es translation catalogue (927 entries)

note: type: Attribute 'lang' of: <book>
en: en
es: es

note: type: Content of: <book><title>
en: Debian New Maintainers' Guide
es: Guía del nuevo desarrollador de Debian

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: original contents
es: contenidos originales

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: updated contents
es: contenidos actualizados

note: type: Content of: <book><bookinfo><releaseinfo>
en: version &docversion;
es: versión &docversion;

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document was made using these two documents as examples:
es: Este documento se ha escrito usando estos dos documentos como ejemplo:

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: Making a Debian Package (AKA the Debmake Manual), copyright © 1997 Jaldhar Vyas.
es: «Making a Debian Package (AKA the Debmake Manual)», copyright © 1997 Jaldhar Vyas.

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: The New-Maintainer's Debian Packaging Howto, copyright © 1997 Will Lowe.
es: «The New-Maintainer's Debian Packaging Howto», copyright © 1997 Will Lowe.

note: type: Content of: <book><chapter><title>
en: Getting started The Right Way
es: Empezando «de la forma correcta».

note: type: Content of: <book><chapter><para>
en: This document tries to describe the building of a Debian package to ordinary Debian users and prospective developers.  It uses fairly non-technical language, and it's well covered with working examples.  There is an old Latin saying: <emphasis>Longum iter est per praecepta, breve et efficax per exempla</emphasis> (It's a long way by the rules, but short and efficient with examples).
es: Este documento tratará de describir cómo se construye un paquete Debian GNU/Linux para el usuario común de Debian y para futuros desarrolladores en un lenguaje informal, y con multitud de ejemplos.  Hay un antiguo dicho romano que dice, «<emphasis>Longum iter est per preaecepta, breve et efficax per exempla!</emphasis>» (¡Es un largo camino con las reglas, pero corto y eficiente con ejemplos!).

note: type: Content of: <book><chapter><para><footnote><para>
en: The document assumes you are using a <literal>&base-release;</literal> or newer system.  If you need to follow this text in an older system (including an older Ubuntu system etc.), you must install backported <systemitem role="package">dpkg</systemitem> and <systemitem role="package">debhelper</systemitem> packages, at least.
es: El documento asume que estás utilizando la versión <literal>&base-release;</literal>.  Si quieres utilizar este documento con una versión anterior (incluidas versiones anteriores de Ubuntu u otras) debes instalar (como mínimo) la versión «backport» de los paquetes <systemitem role="package">dpkg</systemitem> y <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><para><footnote><para>
en: You can learn about the basic handling of a Debian system from the <ulink url="&debref;">Debian Reference</ulink>.  It contains some pointers to learn about Unix programming, too.
es: Puedes aprender las operaciones básicas del sistema Debian en <ulink url="&debref;">Debian Reference</ulink>. Ese documento también trata algunos aspectos sobre programación en UNIX.

note: type: Content of: <book><chapter><para>
en: One of the things that makes Debian such a top-notch distribution is its package system.  While there is a vast quantity of software already in the Debian format, sometimes you need to install software that isn't.  You may be wondering how you can make your own packages; and perhaps you think it is a very difficult task.  Well, if you are a real novice on Linux, it is hard, but if you were a rookie, you wouldn't be reading this document now&nbsp;:-)  You do need to know a little about Unix programming but you certainly don't need to be a wizard.  <placeholder type="footnote" id="0"/>
es: Una de las cosas que hace a Debian una de las distribuciones más importantes del mercado es su sistema de paquetes.  Aunque hay una gran cantidad de programas disponibles en forma de paquetes de Debian, algunas veces necesitarás instalar programas que no están disponible en este formato.  Puede que te preguntes cómo hacer tus propios paquetes y que pienses que quizás ésta es una tarea demasiado difícil.  Bueno, si eres un principiante en GNU/Linux, sí es duro, pero si eres un novato, no deberías estar leyendo esto ahora mismo.  :-) Necesitas saber algo sobre programación en Unix, pero, desde luego, no tienes que ser un maestro <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><para>
en: One thing is certain, though: to properly create and maintain Debian packages takes many hours.  Make no mistake, for our system to work the maintainers need to be both technically competent and diligent.
es: Sin embargo, hay una cosa que es verdad: para construir y mantener paquetes Debian adecuadamente, necesitarás muchas horas.  Para que nuestro sistema trabaje sin errores, nuestros desarrolladores necesitan ser técnicamente competentes y concienzudos.

note: type: Content of: <book><chapter><para>
en: Newer versions of this document should always be available online at <ulink url="&maint-guide;"/> and in the <systemitem role="package">maint-guide</systemitem> package.  The translations may be available in packages such as <systemitem role="package">maint-guide-es</systemitem>.  Please note that this documentation may be slightly outdated.
es: Las nuevas versiones de este documento están en <ulink url="&maint-guide;"/> y en el paquete <systemitem role="package">maint-guide</systemitem>. Las traducciones pueden obtenerse en paquetes como <systemitem role="package">maint-guide-es</systemitem>. Debe tenerse presente que las traducciones pueden estar desactualizadas.

note: type: Content of: <book><chapter><para>
en: Since this is a tutorial, I choose to explain each detailed step for some important topics.  Some of them may look irrelevant to you.  Please be patient.  I have also intentionally skipped some corner cases and provided only pointers to keep this document simple.
es: Como se trata de un tutorial, he optado por explicar cada paso detalladamente en algunos temas importantes. Algunas explicaciones pueden parecerte irrelevantes. Te ruego que seas paciente. También he omitido intencionalmente algunos casos extremos y algunos aspectos sólo se mencionan con la intención de que el documento sea sencillo.

note: type: Content of: <book><chapter><section><title>
en: Social dynamics of Debian
es: Dinamismo social en Debian

note: type: Content of: <book><chapter><section><para>
en: Here are some observations of Debian's social dynamics, presented in the hope that it will prepare you for interactions with Debian:
es: Aquí explico mis observaciones sobre la dinámica social en Debian. Espero que esto te preparará para la interacción con Debian:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: We all are volunteers.
es: Todos somos voluntarios.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You cannot impose on others what to do.
es: No puedes imponer a los demás lo que debe hacerse.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be motivated to do things by yourself.
es: Debes estar motivado para hacer las cosas por ti mismo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Friendly cooperation is the driving force.
es: La cooperación amistosa es la fuerza motriz.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution should not overstrain others.
es: Tu contribución no debe estresar a los demás.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution is valuable only when others appreciate it.
es: Tu contribución es valiosa sólo cuando los demás te lo agradecen..

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is not your school where you get automatic attention of teachers.
es: Debian no es la escuela donde recibir atención automática de los profesores.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be able to learn many things by yourself.
es: Debes ser capaz de aprender muchas cosas por ti mismo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Attention from other volunteers is a very scarce resource.
es: La atención por parte de otros voluntarios es un recurso muy escaso.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is constantly improving.
es: Debian está mejorando constantemente.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You are expected to make high quality packages.
es: Se espera que generes paquetes de alta calidad.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should adapt yourself to change.
es: Debes adaptarte al cambio.

note: type: Content of: <book><chapter><section><para>
en: There are several types of people interacting around Debian with different roles:
es: Se utilizan distintos nombres para referirse a los roles dentro de Debian:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream author</emphasis>: the person who made the original program.
es: <emphasis role="strong">autor original</emphasis> («upstream author»): para referirse a la persona que ha escrito el código original del programa (o la documentación original en el caso de paquetes de documentación).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream maintainer</emphasis>: the person who currently maintains the program.
es: <emphasis role="strong">desarrollador original</emphasis> («upstream maintainer»): la persona que se encarga de mantener el programa (el código fuente) en la actualidad.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">maintainer</emphasis>: the person making the Debian package of the program.
es: <emphasis role="strong">empaquetador (desarrollador)</emphasis> («maintainer»): la persona que se encarga de construir y mantener actualizados paquetes para Debian (N.  del t.: hay una cierta ambigüedad en la traducción de «maintainer» por desarrollador puesto que se puede confundir con la traducción de «Debian Developer», desarrollador que pertenece al proyecto, y de «upstream maintainer», desarrollador del programa original).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">sponsor</emphasis>: a person who helps maintainers to upload packages to the official Debian package archive (after checking their contents).
es: <emphasis role="strong">patrocinador</emphasis> («sponsor»): la persona (que debe ser un DD o DM, véase más adelante) que transfiere los paquetes elaborados por el desarrollador al archivo de paquetes de Debian (al repositorio de Debian) después de comprobar que el paquete cumple los requisitos exigidos.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">mentor</emphasis>: a person who helps novice maintainers with packaging etc.
es: <emphasis role="strong">mentor</emphasis>: la persona que ayuda a los desarrolladores principiantes a iniciarse en la construcción y mantenimiento de paquetes.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Developer</emphasis> (DD): a member of the Debian project with full upload rights to the official Debian package archive.
es: <emphasis role="strong">desarrollador de Debian (DD)</emphasis> («Debian Developer»): la persona que es miembro de Debian.  Tiene permiso total para transferir paquetes al repositorio oficial de Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Maintainer</emphasis> (DM): a person with limited upload rights to the official Debian package archive.
es: <emphasis role="strong">empaquetador de Debian (DM)</emphasis> («Debian Maintainer»): la persona que tiene permiso limitado para transferir paquetes al repositorio oficial de Debian.

note: type: Content of: <book><chapter><section><para>
en: Please note that you cannot become an official <emphasis role="strong">Debian Developer</emphasis> (DD) overnight, because it takes more than technical skill.  Please do not be discouraged by this.  If it is useful to others, you can still upload your package either as a <emphasis role="strong">maintainer</emphasis> through a <emphasis role="strong">sponsor</emphasis> or as a <emphasis role="strong">Debian Maintainer</emphasis>.
es: No puedes convertirte en <emphasis role="strong">desarrollador oficial de Debian</emphasis> (DD) de la noche a la mañana porque hace falta algo más que habilidades técnicas.  No te sientas desilusionado por esto.  Aún puedes subir tu paquete, si es útil a otras personas, como <emphasis role="strong">empaquetador</emphasis> a través de un <emphasis role="strong">patrocinador</emphasis> o un <emphasis role="strong">empaquetador de Debian</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Please note that you do not need to create any new package to become an official Debian Developer.  Contributing to the existing packages can provide a path to becoming an official Debian Developer too.  There are many packages waiting for good maintainers (see <xref linkend="choose"/>).
es: Ten en cuenta que no es necesario construir un paquete nuevo para poder convertirte en desarrollador oficial de Debian.  Una opción para ser desarrollador oficial es contribuir al mantenimiento de los paquetes ya existentes en la distribución.  Hay muchos paquetes esperando un buen responsable (véase <xref linkend="choose"/> ).

note: type: Content of: <book><chapter><section><para>
en: Since we focus only on technical aspects of packaging in this document, please refer to the following to learn how Debian functions and how you can get involved:
es: Dado que nos concentramos sólo en los aspectos técnicos del mantenimiento de paquetes en este documento, consulta las siguientes referencias para aprender cómo funciona Debian y cómo puedes participar:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&logiciellibre;">Debian: 17 years of Free Software, "do-ocracy", and democracy</ulink> (Introductory slides)
es: <ulink url="&logiciellibre;">Debian: 17 años de software libre, "meritocracia" y democracia</ulink> (diapositivas de introducción en inglés)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianorghelp;">How can you help Debian?</ulink> (official)
es: <ulink url="&debianorghelp;">¿Cómo puedo ayudar a Debian?</ulink> (documentación oficial)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianfaqhelp;">The Debian GNU/Linux FAQ, Chapter 13 - "Contributing to the Debian Project"</ulink> (semi-official)
es: <ulink url="&debianfaqhelp;">Las Preguntas Frecuentes de Debian GNU/Linux FAQ, capítulo 13 - 'Contribuir al proyecto Debian' </ulink> (documentación semi-oficial)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (supplemental)
es: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (documentación complementaria)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&nm-do;">Debian New Member site</ulink> (official)
es: <ulink url="&nm-do;">Sitio web de nuevos miembros de Debian</ulink> (documentación oficial)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (supplemental)
es: <ulink url="&debianmentorfaq;">PUF de mentores en Debian</ulink> (documentación complementaria)

note: type: Content of: <book><chapter><section><title>
en: Programs needed for development
es: Programas necesarios para el desarrollo

note: type: Content of: <book><chapter><section><para>
en: Before you start anything, you should make sure that you have properly installed some additional packages needed for development.  Note that the list doesn't contain any packages marked <literal>essential</literal> or <literal>required</literal> - we expect that you have those installed already.
es: Antes de empezar, debes asegurarte que tienes instalados algunos paquetes adicionales necesarios para el desarrollo. Observa que la lista no contiene paquetes marcados como  <literal>esencial</literal> o <literal>requerido</literal> - al dar por supuesto que ya los tienes instalados.

note: type: Content of: <book><chapter><section><para>
en: The most important package to install on your development system is the <systemitem role="package">build-essential</systemitem> package.  Once you try to install that, it will <emphasis>pull in</emphasis> other packages required to have a basic build environment.
es: El paquete imprescindible para el desarrollo es <systemitem role="package">build-essential</systemitem>.  Al instalarlo, <emphasis>también se instalaran otros paquetes</emphasis> requeridos, consiguiendo una instalación básica para la construcción de paquetes.

note: type: Content of: <book><chapter><section><para>
en: For some types of packages, that is all you will require; however, there is another set of packages that while not essential for all package builds are useful to have installed or may be required by your package:
es: Para la construcción de algunos paquetes esto seria suficiente, pero hay otros paquetes que, no siendo esenciales en general para la construcción de nuevos paquetes, puede ser útil tener instalados o, incluso, necesarios para el paquete que estás construyendo:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem>, and <systemitem role="package">autotools-dev</systemitem> - many newer programs use configure scripts and <filename>Makefile</filename> files preprocessed with the help of programs like these (see <literal>info autoconf</literal>, <literal>info automake</literal>).  <systemitem role="package">autotools-dev</systemitem> keeps up-to-date versions of certain auto files and has documentation about the best way to use those files.
es: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem> y <systemitem role="package">autotools-dev</systemitem> - muchos programas nuevos usan ficheros de configuración y ficheros <filename>Makefile</filename> que se procesan con la ayuda de programas como éstos (véase <literal>info autoconf</literal>, <literal>info automake</literal>).  El paquete <systemitem role="package">autotools-dev</systemitem> permite mantener versiones actualizadas de los archivos autoconf y automake y tiene documentación para usar eficientemente ese tipo de archivos.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: There are also some more specialized but similar packages such as <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, etc.
es: Hay varios paquetes similares pero más específicos como <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, etc.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debhelper</systemitem> and <systemitem role="package">dh-make</systemitem> - <systemitem role="package">dh-make</systemitem> is necessary to create the skeleton of our example package, and it will use some of the <systemitem role="package">debhelper</systemitem> tools for creating packages.  They are not essential for this purpose, but are <emphasis>highly</emphasis> recommended for new maintainers.  It makes the whole process very much easier to start, and to control afterwards.  (See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.) <placeholder type="footnote" id="0"/>
es: <systemitem role="package">dh-make</systemitem> y <systemitem role="package">debhelper</systemitem> - <systemitem role="package">dh-make</systemitem> es necesario para construir el esqueleto de nuestro paquete ejemplo, y se usarán algunas de las herramientas de <systemitem role="package">debhelper</systemitem> para construir los paquetes.  Aunque no son imprescindibles para la construcción de paquetes se recomiendan <emphasis>encarecidamente</emphasis> para nuevos desarrolladores.  Hacen el proceso mucho más fácil al principio, y más fácil de controlar en el futuro (véase <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The new <systemitem role="package">debmake</systemitem> may be used as the alternative to the standard <systemitem role="package">dh-make</systemitem>.  It does more and comes with HTML documentation with extensive packaging examples in <systemitem role="package">debmake-doc</systemitem>.
es: El nuevo <systemitem role="package">debmake</systemitem> puede utilizarse como alternativa al sistema estándar <systemitem role="package">dh-make</systemitem>.  Tiene más funcionalidades y una extensa documentación en formato HTML con ejemplos para la construcció de paquetes en <systemitem role="package">debmake-doc</systemitem>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">devscripts</systemitem> - this package contains some useful scripts that can be helpful for maintainers, but they are also not necessary for building packages.  Packages recommended and suggested by this package are worth looking into.  (See <filename>&devscripts-readme;</filename>.)
es: <systemitem role="package">devscripts</systemitem> - este paquete contiene algunos guiones útiles para los desarrolladores, pero no son necesarios para construir paquetes.  Vale la pena mirar los paquetes recomendados y sugeridos por este paquete (véase <filename>&devscripts-readme;</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">file</systemitem> - this handy program can determine what type a file is.  (See <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
es: <systemitem role="package">file</systemitem> - este útil programa puede determinar de qué tipo es un fichero (véase <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gfortran</systemitem> - the GNU Fortran 95 compiler, necessary if your program is written in Fortran.  (See <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
es: <systemitem role="package">gfortran</systemitem> - el compilador GNU de Fortran 95, necesario si el programa está escrito en Fortran (véase <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git</systemitem> - this package provides a popular version control system designed to handle very large projects with speed and efficiency; it is used for many high profile open source projects, most notably the Linux kernel.  (See <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, git Manual (<filename>&git-doc;</filename>).)
es: <systemitem role="package">git</systemitem> - este paquete instala el popular sistema de control de versiones, diseñado para hacer el seguimiento de proyectos grandes con eficacia y rapidez; se utiliza para proyectos de código libre importantes como es el caso del núcleo («kernel») de Linux (véase <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> y git Manual (<filename>&git-doc;</filename>)).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gpc</systemitem> - the GNU Pascal compiler, necessary if your program is written in Pascal.  Worthy of note here is <systemitem role="package">fp-compiler</systemitem>, the Free Pascal Compiler, which is also good at this task.  (See <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
es: <systemitem role="package">gpc</systemitem> - el compilador GNU de Pascal, necesario si el programa está escrito en Pascal.  Merece la pena mencionar aquí <systemitem role="package">fp-compiler</systemitem>, un compilador libre de Pascal, que también es bueno en esta tarea (véase <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patch</systemitem> - this very useful utility will take a file containing a difference listing (produced by the <command>diff</command> program) and apply it to the original file, producing a patched version.  (See <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
es: <systemitem role="package">patch</systemitem> - esta utilidad es muy práctica para modificar el original de un archivo a partir de un archivo de diferencias (elaborado por el programa <command>diff</command>) produciendo un archivo parcheado (véase <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patchutils</systemitem> - this package contains some utilities to work with patches such as the <command>lsdiff</command>, <command>interdiff</command> and <command>filterdiff</command> commands.
es: <systemitem role="package">patchutils</systemitem> - este paquete contiene programas para trabajar con los «parches» como <command>lsdiff</command>, <command>interdiff</command> y <command>filterdiff</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">perl</systemitem> - Perl is one of the most used interpreted scripting languages on today's Unix-like systems, often referred to as Unix's Swiss Army Chainsaw. (See <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
es: <systemitem role="package">perl</systemitem> - Perl es uno de los lenguajes interpretados para hacer guiones (o «scripts») más usados en los sistemas Un*x de hoy en día, comúnmente se refiere a él como la «navaja suiza de Unix» (véase <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">python</systemitem> - Python is another of the most used interpreted scripting languages on the Debian system, combining remarkable power with very clear syntax. (See <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
es: <systemitem role="package">python</systemitem> - Python es otro de los lenguajes interpretados para hacer guiones (o «scripts») en Debian debido a la combinación de su poder y sintaxis clara (véase <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">quilt</systemitem> - this package helps you to manage large numbers of patches by keeping track of the changes each patch makes. Patches can be applied, un-applied, refreshed, and more.  (See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, and <filename>&quilt-pdf;</filename>.)
es: <systemitem role="package">quilt</systemitem> - este paquete ayuda a aplicar modificaciones («parches») y hacer el seguimiento de los cambios realizados.  Aplica las modificaciones ordenadamente en pila, y es posible aplicar, deshacer y actualizar las modificaciones fácilmente recorriendo la pila (véase <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> y <filename>&quilt-pdf;</filename>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">xutils-dev</systemitem> - some programs, usually those made for X11, also use these programs to generate <filename>Makefile</filename> files from sets of macro functions.  (See <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
es: <systemitem role="package">xutils-dev</systemitem> - algunos programas, normalmente aquellos hechos para X11, también usan programas para generar <filename>Makefile</filename> ejecutando un conjunto de funciones de macro (véase <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><para>
en: The short descriptions that are given above only serve to introduce you to what each package does.  Before continuing please read the documentation of each relevant program including ones installed through the package dependency such as <command>make</command>, at least, for the standard usage.  It may seem like heavy going now, but later on you'll be <emphasis>very</emphasis> glad you read it.  If you have specific questions later, I would suggest re-reading the documents mentioned above.
es: Las breves descripciones dadas anteriormente sólo sirven para introducirte a lo que hace cada paquete.  Antes de continuar, por favor, lee la documentación de cada programa, al menos para su uso normal.  Puede parecerte algo duro ahora, pero más adelante estarás <emphasis>muy</emphasis> contento de haberla leído.

note: type: Content of: <book><chapter><section><title>
en: Documentation needed for development
es: Documentos necesarios para el desarrollo

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>very important</emphasis> documentation which you should read along with this document:
es: Por último, la documentación que se indica a continuación es de <emphasis>gran importancia</emphasis> y debería leerse junto con este documento:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debian-policy</systemitem> - the <ulink url="&debian-policy;">Debian Policy Manual</ulink> includes explanations of the structure and contents of the Debian archive, several OS design issues, the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS, which says where each file and directory should be), etc.  For you, the most important thing is that it describes requirements that each package must satisfy to be included in the distribution. (See the local copies of <filename>&policy-pdf;</filename> and <filename>&fhs-pdf;</filename>.)
es: <systemitem role="package">debian-policy</systemitem> - el <ulink url="&debian-policy;">manual de normas de Debian</ulink> incluye la descripción de la estructura y contenidos del archivo, ciertas notas sobre el diseño del sistema operativo, el <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> («FHS», que explica dónde deberían estar cada fichero y directorio), y, lo más importante para ti, describe los requisitos que debe satisfacer cada paquete para ser incluido en la distribución (véase la copias locales en <filename>&policy-pdf;</filename> y <filename>&fhs-pdf;</filename>).

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>important</emphasis> documentation which you should read along with this document:
es: Por último, la documentación que se indica a continuación es de <emphasis>gran importancia</emphasis> y debería leerse junto con este documento:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnu-standards</systemitem> - this package contains two pieces of documentation from the GNU project: <ulink url="&gnu-standard;">GNU Coding Standards</ulink>, and <ulink url="&gnu-maintainer;">Information for Maintainers of GNU Software</ulink>.  Although Debian does not require these to be followed, these are still helpful as guidelines and common sense.  (See the local copies of <filename>&gnu-standard-pdf;</filename> and <filename>&gnu-maintainer-pdf;</filename>.)
es: <systemitem role="package">gnu-standards</systemitem> - este paquete contiene dos documentos del proyecto GNU: <ulink url="&gnu-standard;">«GNU Coding Standards»</ulink>, y <ulink url="&gnu-maintainer;">«Information for Maintainers of GNU Software»</ulink>.  Aunque no se exige su cumplimiento en Debian, son útiles como orientación y sentido común (véase las copias locales en <filename>&gnu-standard-pdf;</filename> y <filename>&gnu-maintainer-pdf;</filename>).

note: type: Content of: <book><chapter><section><para>
en: If this document contradicts any of the documents mentioned above, they are correct.  Please file a bug report on the <systemitem role="package">maint-guide</systemitem> package using <command>reportbug</command>.
es: Si este documento contradice en algún aspecto a los documentos mencionados anteriormente, prevalecen estos últimos.  Por favor, envía un informe de error del paquete <systemitem role="package">maint-guide</systemitem> utilizando la orden <command>reportbug</command>.

note: type: Content of: <book><chapter><section><title>
en: Where to ask for help
es: Dónde pedir ayuda

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: files in <filename>/usr/share/doc/<replaceable>package</replaceable></filename> for all pertinent packages
es: archivos en <filename>/usr/share/doc/<replaceable>package</replaceable></filename> para cada uno de los paquetes

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>man</command> <replaceable>command</replaceable></literal> for all pertinent commands
es: contenidos de <literal><command>man</command> <replaceable>command</replaceable></literal> para todos los comandos pertinentes

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>info</command> <replaceable>command</replaceable></literal> for all pertinent commands
es: contenidos de <literal><command>info</command> <replaceable>command</replaceable></literal> para todos los comandos pertinentes

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list archive</ulink>
es: contenidos de <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org archivo de la lista de correo</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list archive</ulink>
es: contenidos de <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list archive</ulink>

note: type: Content of: <book><chapter><section><para>
en: You can use web search engines more effectively by including search strings such as <literal>site:lists.debian.org</literal> to limit the domain.
es: Considera el uso eficaz de los motores de búsqueda en la web incluyendo <literal>site:lists.debian.org</literal> en la cadena de búsqueda, para limitar el dominio.

note: type: Content of: <book><chapter><section><para>
en: Making a small test package is a good way to learn details of packaging.  Inspecting existing well maintained packages is the best way to learn how other people make packages.
es: Construir un paquete pequeño es una buena forma de aprender los detalles del mantenimiento de paquetes. Inspeccionar paquetes bien mantenidos es la mejor forma de aprender cómo otros mantienen paquetes.

note: type: Content of: <book><chapter><section><para>
en: If you still have questions about packaging that you couldn't find answers to in the available documentation and web resources, you can ask them interactively:
es: Si todavía tienes preguntas acerca de la construcción de paquetes a las que no puedes encontrar respuesta en la documentación disponible y los recursos web, puedes formularlas interactivamente:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (This mailing list is for the novice.)
es: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (Esta lista de correo es para los principiantes.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list</ulink>. (This mailing list is for the expert.)
es: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list</ulink>. (Esta lista de correo es para expertos.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&irc-debian;">IRC</ulink> such as <literal>#debian-mentors</literal>.
es: <ulink url="&irc-debian;">IRC</ulink> tal como <literal>#debian-mentors</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Teams focusing on a specific set of packages. (Full list at <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>)
es: Los equipos se centran en un conjunto específico de paquetes.(La lista completa está en <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Language-specific mailing lists such as debian-devel-{french,italian,portuguese,spanish}@lists.debian.org or debian-devel@debian.or.jp. (Full listing at <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> and <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>)
es: Listas de correo en un idioma concreto como  debian-devel-{french,italian,portuguese,spanish}@lists.debian.org o bien debian-devel@debian.or.jp.  (La lista completa está disponible en  <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> and <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>)

note: type: Content of: <book><chapter><section><para>
en: The more experienced Debian developers will gladly help you, if you ask properly after making your required efforts.
es: Los desarrolladores de Debian con más experiencia te ayudaran con gusto, si haces las preguntas después realizar el esfuerzo requerido.

note: type: Content of: <book><chapter><section><para>
en: When you receive a bug report (yes, actual bug reports!), you will know that it is time for you to dig into the <ulink url="&bts;">Debian Bug Tracking System</ulink> and read the documentation there, to be able to deal with the reports efficiently.  I highly recommend reading the <ulink url="&devref-bug-handling;">Debian Developer's Reference, 5.8.  "Handling bugs"</ulink>.
es: Cuando recibas un aviso de fallo (sí, avisos de fallos, ¡de verdad!) sabrás que es el momento de indagar en el <ulink url="&bts;">Sistema de seguimiento de fallos de Debian</ulink> y leer su documentación para poder tratar los informes de forma eficiente.  Te recomiendo la lectura de la Referencia del Desarrollador, en particular el capítulo de «<ulink url="&devref-bug-handling;">Referencia del desarrollador sección 5.8 - Manejo de fallos</ulink>» («Handling Bugs»).

note: type: Content of: <book><chapter><section><para>
en: Relax and be ready for bug reports, because there is a lot more work to be done before your package will be fully in line with Debian policies and its best practice guidelines (once again, read the <emphasis>real documentation</emphasis> for details).  Good luck!
es: Relájate y prepárate para recibir informes de fallos, porque hay mucho más trabajo que realizar antes de que tu paquete cumpla las Normas de Debian (una vez más lee la <emphasis>documentación real</emphasis> para más detalles).  ¡Buena suerte!

note: type: Content of: <book><chapter><title>
en: First steps
es: Primeros pasos

note: type: Content of: <book><chapter><para>
en: Let's start by creating a package of your own (or, even better, adopting an existing one).
es: Vamos a construir nuestro propio paquete (o, mejor aún, adoptar un paquete ya existente).

note: type: Content of: <book><chapter><section><title>
en: Debian package building workflow
es: Plan de trabajo para la construcción de paquetes Debian

note: type: Content of: <book><chapter><section><para>
en: If you are making a Debian package with an upstream program, the typical workflow of Debian package building involves generating several specifically named files for each step as follows:
es: Si estas construyendo un paquete Debian con las fuentes originales, el plan de trabajo típico implica varias etapas (en las cuales se generan archivos con nombres específicos) y que se explican a continuación:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Get a copy of the upstream software, usually in a compressed tar format.
es: Conseguimos las fuentes originales del programa, normalmente en un archivo comprimido en formato «tar».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>-<replaceable>version</replaceable>.tar.gz
es: <replaceable>nombre_del_paquete</replaceable>-<replaceable>versión</replaceable>.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add Debian-specific packaging modifications to the upstream program under the <filename>debian</filename> directory, and create a non-native source package (that is, the set of input files used for Debian package building) in <literal>3.0 (quilt)</literal> format.
es: Añadir las modificaciones específicas de Debian al programa original en el directorio <filename>debian</filename>, y construir un paquete de fuentes no nativo (es decir, el conjunto de archivos de entrada utilizados para la construcción de paquetes Debian) en formato <literal>3.0 (quilt)</literal>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.orig.tar.gz
es: <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>.orig.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.debian.tar.gz
es: <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>-<replaceable>revisión</replaceable>.debian.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><footnote><para>
en: For the older style of non-native Debian source packages in <literal>1.0</literal> format, <literal><replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.diff.gz</literal> is used instead.
es: Para paquetes no nativos Debian construidos en el formato anterior <literal>1.0</literal>, se utiliza <literal><replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>-<replaceable>revisión</replaceable>.diff.gz</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.dsc
es: <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>-<replaceable>revisión</replaceable>.dsc

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Build Debian binary packages, which are ordinary installable package files in <literal>.deb</literal> format (or <literal>.udeb</literal> format, used by the Debian Installer) from the Debian source package.
es: Construimos los paquetes binarios Debian, que son archivos instalables ordinarios en formato <literal>.deb</literal>  (o en formato <literal>.udeb</literal>, utilizado por el instalador de Debian), desde el paquete fuente de Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>arch</replaceable>.deb
es: <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>-<replaceable>revisión</replaceable>_<replaceable>arquitectura</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: Please note that the character separating <literal><replaceable>package</replaceable></literal> and <literal><replaceable>version</replaceable></literal> was changed from <literal>-</literal> (hyphen) in the tarball name to <literal>_</literal> (underscore) in the Debian package filenames.
es: Fíjate que el carácter que separa <literal><replaceable>nombre_del_paquete</replaceable></literal> y <literal><replaceable>versión</replaceable></literal> se ha cambiado de <literal>-</literal> (guión) a <literal>_</literal> (guión bajo).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, and <ulink url="&policy-version;">5.6.12 "Version"</ulink>.  The <emphasis role="strong">package architecture</emphasis> follows the <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> and is automatically assigned by the package build process.
es: Consulta <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, and <ulink url="&policy-version;">5.6.12 "Version"</ulink>. La <emphasis role="strong">arquitectura del paquete</emphasis> sigue el <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> y se asigna automáticamente en el proceso de compilación del paquete.

note: type: Content of: <book><chapter><section><para>
en: In the file names above, replace the <literal><replaceable>package</replaceable></literal> part with the <emphasis role="strong">package name</emphasis>, the <literal><replaceable>version</replaceable></literal> part with the <emphasis role="strong">upstream version</emphasis>, the <literal><replaceable>revision</replaceable></literal> part with the <emphasis role="strong">Debian revision</emphasis>, and the <literal><replaceable>arch</replaceable></literal> part with the <emphasis role="strong">package architecture</emphasis>, as defined in the Debian Policy Manual.  <placeholder type="footnote" id="0"/>
es: En los nombres de archivo que siguen, <literal><replaceable>nombre_del_paquete</replaceable></literal> se substituye por el <emphasis role="strong">nombre del paquete</emphasis>, <literal><replaceable>versión</replaceable></literal> por la <emphasis role="strong">versión del código fuente</emphasis>, <literal><replaceable>revisión</replaceable></literal> por la <emphasis role="strong">revisión Debian</emphasis>, <literal><replaceable>arquitectura</replaceable></literal> por la <emphasis role="strong">arquitectura del paquete</emphasis>   <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Each step of this outline is explained with detailed examples in later sections.
es: Cada paso de este esquema se explica con ejemplos detallados en secciones posteriores.

note: type: Content of: <book><chapter><section><title>
en: Choose your program
es: Elige el programa

note: type: Content of: <book><chapter><section><para>
en: You have probably chosen the package you want to create.  The first thing you need to do is check if the package is in the distribution archive already by using the following:
es: Probablemente hayas escogido ya el paquete que deseas construir.  Lo primero que debes hacer es comprobar si el paquete está ya en el archivo de la distribución utilizando:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <command>aptitude</command> command
es: la orden <command>aptitude</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&packages-do;">Debian packages</ulink> web page
es: la página web <ulink url="&packages-do;">Debian packages</ulink>

note: type: Content of: <book><chapter><section><para>
en: If the package already exists, well, install it! :-) If it happens to be <emphasis role="strong">orphaned</emphasis> (that is, if its maintainer is set to <ulink url="&qa-do;">Debian QA Group</ulink>), you may be able to pick it up if it's still available.  You may also adopt a package whose maintainer has filed a Request for Adoption (<emphasis role="strong">RFA</emphasis>).<placeholder type="footnote" id="0"/>
es: Si el paquete ya existe, ¡instálalo! :-) Si te encuentras con que el paquete es un paquete <emphasis role="strong">huérfano</emphasis> (cuando su desarrollador es el <ulink url="&qa-do;">Debian QA Group</ulink>, es decir, el grupo de calidad de Debian), puedes adoptarlo (convertirte en el responsable de empaquetarlo y mantenerlo) si está disponible. También puedes adoptar un paquete para el cual se ha emitido una «solicitud de adopción» (Request for Adoption o <emphasis role="strong">RFA</emphasis>) por su desarrollador o por un DD <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: There are several package ownership status resources:
es: Hay varios recursos para conocer el estado de los paquetes:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <command>wnpp-alert</command> command from the <systemitem role="package">devscripts</systemitem> package
es: La orden <command>wnpp-alert</command> del paquete <systemitem role="package">devscripts</systemitem>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink>
es: <ulink url="&wnpp-do;">Paquetes pendientes y futuros nuevos paquetes</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-bts;">Debian Bug report logs: Bugs in pseudo-package <systemitem role="package">wnpp</systemitem> in <literal>unstable</literal></ulink>
es: <ulink url="&wnpp-bts;">Registro de informes de fallos de Debian: errores en el paquete <systemitem role="package">wnpp</systemitem> en la versión <literal>unstable</literal></ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-dn;">Debian Packages that Need Lovin'</ulink>
es: <ulink url="&wnpp-dn;">Paquetes Debian que necesitan cariño</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-debtags;">Browse <systemitem role="package">wnpp</systemitem> bugs based on debtags</ulink>
es: <ulink url="&wnpp-debtags;">Búsqueda de errores <systemitem role="package">wnpp</systemitem> basada en palabras clave</ulink>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Having said that, there will of course always be new programs that are worth packaging.
es: Dicho esto, por supuesto, hay nuevos programas que vale la pena empaquetar para Debian.

note: type: Content of: <book><chapter><section><para>
en: As a side note, it's important to point out that Debian already has packages for most kinds of programs, and the number of packages already in the Debian archive is much larger than that of contributors with upload rights.  Thus, contributions to packages already in the archive are far more appreciated (and more likely to receive sponsorship) by other developers <placeholder type="footnote" id="0"/>.  You can contribute in various ways:
es: A modo de nota al margen, es importante tener presente que Debian incorpora paquetes de un gran número de programas de todo tipo, y que la cantidad de paquetes disponibles en el repositorio de Debian es mucho mayor al de colaboradores con permiso para incorporar paquetes al repositorio.  En consecuencia, la colaboración en el mantenimiento de paquetes que ya están en el repositorio se valora muy positivamente (y es más fácil conseguir patrocinador) por el resto de desarrolladores <placeholder type="footnote" id="0"/>.  Puedes hacer esto de distintas formas:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: taking over orphaned, yet actively used, packages
es: hacerte cargo de paquetes huérfanos pero que son utilizados frecuentemente por otros usuarios

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: joining <ulink url="&teams;">packaging teams</ulink>
es: incorporándote a los <ulink url="&teams;">equipos de desarrolladores</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: triaging bugs of very popular packages
es: seleccionando errores de los paquetes más populares

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: preparing <ulink url="&devref-nmu;">QA or NMU uploads</ulink>
es: preparando <ulink url="&devref-nmu;">paquetes QA o NMU</ulink>

note: type: Content of: <book><chapter><section><para>
en: If the package is new, and you decide you'd like to see it in Debian, proceed as follows:
es: Si el paquete es nuevo y decides que te gustaría verlo en Debian debes seguir los pasos indicados a continuación:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: First, you must know that the program works, and have tried it for some time to confirm its usefulness.
es: En primer lugar deberías saber cómo funciona, y haberlo utilizado durante algún tiempo (para confirmar su utilidad).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The software <emphasis role="strong">must have a license</emphasis>.
es: El programa <emphasis role="strong">debe tener una licencia</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>main</literal> section, Debian Policy requires it <emphasis role="strong">to be fully compliant with the Debian Free Software Guidelines</emphasis> (<ulink url="&dfsg;">DFSG</ulink>)  and <emphasis role="strong">not to require a package outside of <literal>main</literal></emphasis> for compilation or execution.  This is the desired case.
es: Si el paquete debe pertenecer a la sección <literal>main</literal> el programa <emphasis role="strong">debe cumplir con las Directrices de Debian para el software libre </emphasis>(<ulink url="&dfsg;">DFSG</ulink>) y <emphasis role="strong">no debe precisar la instalación de otro paquete que no pertenezca a la sección <literal>main</literal></emphasis> para su compilación o ejecución como requiere la directiva de Debian («Debian Policy»). Es la situación deseada.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>contrib</literal> section, it must comply with the DFSG but it may require a package outside of <literal>main</literal> for compilation or execution.
es: Para paquetes de la sección <literal>contrib</literal> la licencia debe cumplir todos los requisitos de la DFSG pero puede precisar la instalación de otro paquete que no sea de la sección <literal>main</literal> para su compilación o ejecución.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>non-free</literal> section, it may be non-compliant with the DFSG but it <emphasis role="strong">must be distributable</emphasis>.
es: Para paquetes de la sección <literal>non-free</literal>, no es necesario que la licencia cumpla todos los requisitos de la DFSG pero <emphasis role="strong">debe permitir la distribución del programa</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If you are unsure about where it should go, post the license text on <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> and ask for advice.
es: Si no estás seguro sobre en qué lugar debería ir, envía el texto de la licencia y pide consejo con un correo (en inglés) dirigido a <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should contact the program's author(s) to check if they agree with packaging it and are amicable to Debian.  It is important to be able to consult with the author(s)  in case of any problems with the program, so don't try to package unmaintained software.
es: Deberías contactar con el autor o autores del programa para comprobar su conformidad con el empaquetado.  Es importante que el autor o autores sigan manteniendo el programa para que puedas en el futuro consultarle/s en caso de que haya problemas específicos.  No deberías intentar empaquetar programas que no estén mantenidos.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program certainly should <emphasis role="strong">not</emphasis> run setuid root, or even better, it shouldn't need to be setuid or setgid to anything.
es: El programa <emphasis role="strong">no</emphasis> debería ejecutarse con «setuid root», o aún mejor: no debería ser «setuid» ni «setgid».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should not be a daemon, or go in an <filename>*/sbin</filename> directory, or open a port as root.
es: El programa no debería ser un demonio, o algo que vaya en los directorios <filename>*/sbin</filename>, o abrir un puerto como usuario administrador.

note: type: Content of: <book><chapter><section><para>
en: As a new maintainer, you are encouraged to get some experience in packaging with easier packages and discouraged from creating complicated packages.
es: Como nuevo desarrollador, es aconsejable que adquieras experiencia con la construcción de paquetes sencillos y se desaconseja construir paquetes complicados.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Simple packages
es: Paquetes sencillos

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (collection of data such as wallpaper graphics)
es: archivo binario único, arquitectura = todas (colección de datos como gráficos de fondo de pantalla)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (executables written in an interpreted language such as POSIX shell)
es: archivo binario único, arquitectura = todas (ejecutables escritos en lenguajes interpretados como POSIX)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Intermediate complexity packages
es: Paquetes de complejidad intermedia

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = any (ELF binary executables compiled from languages such as C and C++)
es: paquete binario simple, arquitectura = todas (ejecutables ELF escritos en lenguajes compilados tales como C y C + +)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages, arch = any + all (packages for ELF binary executables + documentation)
es: paquete binario múltiple, arquitectura = todas y cualquiera (paquetes de ejecutables ELF y documentación)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source in a format other than <filename>tar.gz</filename> or <filename>tar.bz2</filename>
es: paquetes en los que el formato del archivo fuente no es <filename>tar.gz</filename> ni <filename>tar.bz2</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source containing undistributable contents
es: paquetes cuyas fuentes contienen partes que no se pueden distribuir.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: High complexity packages
es: Paquetes muy complejos

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: interpreter module package used by other packages
es: paquete de módulos de lenguaje interpretado utilizado por otros paquetes

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: generic ELF library package used by other packages
es: paquetes de bibliotecas ELF genéricas utilizadas por otros paquetes

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages including an ELF library package
es: múltiples paquetes binarios incluyendo un paquete(s) de bibliotecas ELF

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: source package with multiple upstream sources
es: paquetes de fuentes con múltiples originales

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel module packages
es: paquetes de módulos del núcleo

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel patch packages
es: paquetes de parches del núcleo,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: any package with non-trivial maintainer scripts
es: cualquier paquete de guiones de desarrollador no triviales

note: type: Content of: <book><chapter><section><para>
en: Packaging high complexity packages is not too hard, but it requires a bit more knowledge. You should seek specific guidance for every complex feature. For example, some languages have their own sub-policy documents:
es: Construir paquetes de alta complejidad no es demasiado difícil, pero requiere más conocimientos. Debes buscar las orientaciones específicas para cada caso según su complejidad. Por ejemplo, algunos lenguajes interpretados tienen sus normas específicas.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-python;">Python policy</ulink>
es: <ulink url="&policy-python;">Normas para Python</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-java;">Java policy</ulink>
es: <ulink url="&policy-java;">Normas para Java</ulink>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Do not worry about the missing <filename>Makefile</filename>.  You can install the <command>hello</command> command by simply using <command>debhelper</command> as in <xref linkend="install"/>, or by modifying the upstream source to add a new <filename>Makefile</filename> with the <literal>install</literal> target as in <xref linkend="modify"/>.
es: No debes preocuparte por perder el <filename>Makefile</filename>. Puedes instalar la orden <command>hello</command> simplemente utilizando <command>debhelper</command> como en <xref linkend="install"/>, o modificando las fuentes originales agregando un nuevo <filename>Makefile</filename> con el objetivo <literal>install</literal> como en <xref linkend="modify"/>.

note: type: Content of: <book><chapter><section><title>
en: Get the program, and try it out
es: Obtén el programa y pruébalo

note: type: Content of: <book><chapter><section><para>
en: So the first thing to do is to find and download the original source code.  Presumably you already have the source file that you picked up at the author's homepage.  Sources for free Unix programs usually come in <command>tar</command>+<command>gzip</command> format with the extension <filename>.tar.gz</filename>, <command>tar</command>+<command>bzip2</command> format with the extension <filename>.tar.bz2</filename>, or <command>tar</command>+<command>xz</command> format with the extension <filename>.tar.xz</filename>.  These usually contain a directory called <filename><replaceable>package</replaceable>-<replaceable>version</replaceable></filename> with all the sources inside.
es: Lo primero que debes hacer es encontrar y descargar el código fuente original.  A partir de este punto se da por supuesto que ya tienes el código fuente que obtuviste de la página del autor.  Las fuentes de los programas libres de Unix (y GNU/Linux) generalmente vienen en formato <command>tar</command>+<command>gzip</command>, con extensión <filename>.tar.gz</filename> o en formato <command>tar</command>+<command>bzip2</command> con extensión <filename>.tar.bz2</filename>, y generalmente contienen un subdirectorio llamado <filename><replaceable>programa</replaceable>-<replaceable>versión</replaceable></filename> con todas las fuentes en él.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can identify the archive format using the <command>file</command> command when the file extension is not enough.
es: Puedes identificar el formato de archivo utilizando la herramienta <command>file</command> cuando no es suficiente con la extensión de fichero.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes as some other sort of archive (for instance, the filename ends in <filename>.Z</filename> or <filename>.zip</filename><placeholder type="footnote" id="0"/>), you should also unpack it with the appropriate tools and repack it.
es: Si tu programa viene en otro tipo de archivo (por ejemplo, el fichero termina en <filename>.Z</filename> o <filename>.zip</filename><placeholder type="footnote" id="0"/>), descomprímelo con las herramientas adecuadas y reconstrúyelo de nuevo.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes with some contents which do not comply with DFSG, you should also unpack it to remove such contents and repack it with a modified upstream version containing <literal>dfsg</literal>.
es: Si el código fuente del programa viene con algunos contenidos que no cumplan con las DFSG, debes descomprimirlo para eliminar dichos contenidos y volver a comprimirlo modificando el código de versión original añadiendo <literal>dfsg</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This program is already packaged. The <ulink url="&gentoo-package;">current version</ulink> uses Autotools as its build structure and is substantially different from the following examples, which were based on version 0.9.12.
es: Ten en cuenta que el programa ya ha sido empaquetado previamente.  La <ulink url="&gentoo-package;">versión actual</ulink> utiliza las «Autotools» en su construcción y ha cambiado sustancialmente de la versión 0.9.12 que se utiliza en los ejemplos mostrados a continuación.

note: type: Content of: <book><chapter><section><para>
en: As an example, I'll use a program called <command>gentoo</command>, a GTK+ file manager.  <placeholder type="footnote" id="0"/>
es: Como ejemplo, usaré el programa conocido como <command>gentoo</command>, un gestor de ficheros de X11 en GTK+ <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Create a subdirectory under your home directory named <filename>debian</filename> or <filename>deb</filename> or anything you find appropriate (e.g.  just <filename>~/gentoo</filename> would do fine in this case).  Place the downloaded archive in it, and extract it (with <literal>tar xzf gentoo-0.9.12.tar.gz</literal>).  Make sure there are no warning messages, even <emphasis>irrelevant</emphasis> ones, because other people's unpacking tools may or may not ignore these anomalies, so they may have problems unpacking them.  Your shell command line may look something like this:
es: Crea un subdirectorio en tu directorio personal llamado <filename>debian</filename> o <filename>deb</filename> o lo que creas apropiado (por ejemplo <filename>~/gentoo/</filename> estaría bien en este caso).  Mueve a él el archivo que has descargado, y descomprímelo de la siguiente forma: <literal>tar xzf gentoo-0.9.12.tar.gz</literal>.  Asegúrate de que no hay errores, incluso errores <emphasis>irrelevantes</emphasis>, porque es muy probable que haya problemas al desempaquetarlo en sistemas de otras personas, cuyas herramientas de desempaquetado puede que no ignoren estas anomalías.  En el terminal de órdenes, deberías ver lo siguiente.

note: type: Content of: <book><chapter><section><para>
en: Now you have another subdirectory, called <filename>gentoo-0.9.12</filename>.  Change to that directory and <emphasis>thoroughly</emphasis> read the provided documentation.  Usually there are files named <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> or <filename>*.html</filename>.  You must find instructions on how to compile and install the program (most probably they'll assume you want to install to the <filename>/usr/local/bin</filename> directory; you won't be doing that, but more on that later in <xref linkend="destdir"/>).
es: Ahora tienes otro subdirectorio, con el nombre <filename>gentoo-0.9.12</filename>. Accede a ese directorio y lee <emphasis>atentamente</emphasis> la documentación. Habitualmente encontrarás archivos con el nombre <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> o <filename>*.html</filename>. Deberías encontrar instrucciones sobre cómo compilar e instalar el programa (probablemente se asumirá que la instalación será en el directorio <filename>/usr/local/bin</filename>, aunque tú no lo harás eso, como se explica más adelante en <xref linkend="destdir"/> ).

note: type: Content of: <book><chapter><section><para>
en: You should start packaging with a completely clean (pristine) source directory, or simply with freshly unpacked sources.
es: Deberías empezar a construir tu paquete en un directorio de fuentes completamente limpio, o simplemente con las fuentes recién desempaquetadas.

note: type: Content of: <book><chapter><section><title>
en: Simple build systems
es: Métodos de compilación simple

note: type: Content of: <book><chapter><section><para>
en: Simple programs usually come with a <filename>Makefile</filename> and can be compiled just by invoking <literal>make</literal>.<placeholder type="footnote" id="0"/> Some of them support <literal>make check</literal>, which runs included self-tests.  Installation to the destination directories is usually done with <literal>make install</literal>.
es: Los programas sencillos incluyen un fichero <filename>Makefile</filename> y pueden (generalmente) compilarse con «<literal>make</literal>»<placeholder type="footnote" id="0"/>.  Algunos de ellos soportan <literal>make check</literal>, esta orden ejecuta las comprobaciones automáticas que estén definidas. Generalmente se instalarán en sus directorios de destino ejecutando <literal>make install</literal>.

note: type: Content of: <book><chapter><section><para>
en: Now try to compile and run your program, to make sure it works properly and doesn't break something else while it's installing or running.
es: Ahora intenta compilar y ejecutar el programa, para asegurarte que funciona bien y que no genera errores en el sistema mientras está instalándose o ejecutándose.

note: type: Content of: <book><chapter><section><para>
en: Also, you can usually run <literal>make clean</literal> (or better <literal>make distclean</literal>) to clean up the build directory.  Sometimes there's even a <literal>make uninstall</literal> which can be used to remove all the installed files.
es: También, generalmente, puedes ejecutar <literal>make clean</literal> (o mejor <literal>make distclean</literal>) para limpiar el directorio donde se compila el programa.  A veces hay incluso un <literal>make uninstall</literal> que se puede utilizar para borrar todos los archivos instalados.

note: type: Content of: <book><chapter><section><title>
en: Popular portable build systems
es: Métodos de compilación portables populares

note: type: Content of: <book><chapter><section><para>
en: A lot of free software programs are written in the <ulink url="&c-program;">C</ulink> and <ulink url="&cxx;">C++</ulink> languages.  Many of these use Autotools or CMake to make them portable across different platforms.  These build tools need to be used to generate the <filename>Makefile</filename> and other required source files first.  Then, such programs are built using the usual <literal>make; make install</literal>.
es: Buena parte de los programas libres están escritos en lenguaje <ulink url="&c-program;">C</ulink> y <ulink url="&cxx;">C++</ulink>.  Muchos utilizan las «Autotools» y «CMake» para compilar en diferentes plataformas. Estas herramientas se utilizan para generar un archivo <filename>Makefile</filename> y otros archivos necesarios para la compilación. Así, muchos programas se compilan ejecutando «<literal>make; make install</literal>».

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&gnu-build-system;">Autotools</ulink> is the GNU build system comprising <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink>, and <ulink url="&gettext;">gettext</ulink>.  You can recognize such sources by the <filename>configure.ac</filename>, <filename>Makefile.am</filename>, and <filename>Makefile.in</filename> files.  <placeholder type="footnote" id="0"/>
es: <ulink url="&gnu-build-system;">Las Autotools</ulink> son el sistema de compilación GNU e incluyen <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink> y <ulink url="&gettext;">gettext</ulink>. Confirmarás que el programa utiliza las autoools por la presencia de los archivos <filename>configure.ac</filename>, <filename>Makefile.am</filename>, y <filename>Makefile.in</filename> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: The first step of the Autotools workflow is usually that upstream runs <literal>autoreconf -i -f</literal> in the source directory and distributes the generated files along with the source.
es: El primer paso en el uso de «Autotools» es la ejecución por parte del autor de la orden <literal>autoreconf -i -f</literal> la cual genera, a partir de los archivos fuente (a la izquierda del gráfico) los archivos que utilizará la orden «configure» (a la derecha del gráfico).

note: type: Content of: <book><chapter><section><para>
en: Editing <filename>configure.ac</filename> and <filename>Makefile.am</filename> files requires some knowledge of <command>autoconf</command> and <command>automake</command>.  See <literal>info autoconf</literal> and <literal>info automake</literal>.
es: La edición de los archivos <filename>configure.ac</filename> y <filename>Makefile.am</filename> requiere conocer el funcionamiento de <command>autoconf</command> y <command>automake</command>.  Véase «<literal>info autoconf</literal>» y «<literal>info automake</literal>» (ejecutando las órdenes en el terminal).

note: type: Content of: <book><chapter><section><para>
en: The second step of the Autotools workflow is usually that the user obtains this distributed source and runs <literal>./configure &amp;&amp; make</literal> in the source directory to compile the program into an executable command <command><replaceable>binary</replaceable></command>.
es: El segundo paso en el uso de «Autotools« es la ejecución de «<literal>./configure &amp;&amp; make</literal>» en el directorio del código fuente para compilar el programa generando un archivo <command><replaceable>binario</replaceable></command>.

note: type: Content of: <book><chapter><section><para>
en: You can change many things in the <filename>Makefile</filename>; for instance you can change the default location for file installation using the option <literal>./configure --prefix=/usr</literal>.
es: Puedes hacer cambios en el archivo <filename>Makefile</filename>, por ejemplo cambiando el directorio de instalación predeterminado usando las opciones de la orden ejecutando: <command>./configure --prefix=/usr</command>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can automate this by using <systemitem role="package">dh-autoreconf</systemitem> package.  See <xref linkend="customrules"/>.
es: Añade el paquete <systemitem role="package">dh-autoreconf</systemitem> en el campo <literal>Build-Depends</literal>. Véase <xref linkend="customrules"/>.

note: type: Content of: <book><chapter><section><para>
en: Although it is not required, updating the <filename>configure</filename> and other files with <literal>autoreconf -i -f</literal> may improve the compatibility of the source.  <placeholder type="footnote" id="0"/>
es: Aunque no es necesario, la actualización del archivo <filename>configure</filename> y de otros archivos con la orden <literal>autoreconf -i -f</literal> es la mejor manera para mejorar la compatibilidad del código fuente <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&cmake;">CMake</ulink> is an alternative build system.  You can recognize such sources by the <filename>CMakeLists.txt</filename> file.
es: <ulink url="&cmake;">CMake</ulink> es un sistema de compilación alternativo. La presencia del archivo <filename>CMakeLists.txt</filename> te indicará que se utiliza esta opción para compilar el programa.

note: type: Content of: <book><chapter><section><title>
en: Package name and version
es: Nombre del paquete y versión

note: type: Content of: <book><chapter><section><para>
en: If the upstream source comes as <filename>gentoo-0.9.12.tar.gz</filename>, you can take <literal>gentoo</literal> as the (source) <emphasis role="strong">package name</emphasis> and <literal>0.9.12</literal> as the <emphasis role="strong">upstream version</emphasis>.  These are used in the <filename>debian/changelog</filename> file described later in <xref linkend="changelog"/>, too.
es: Si el código original se presenta como <filename>gentoo-0.9.12.tar.gz</filename>, puedes poner como <emphasis role="strong">nombre del paquete</emphasis> <literal>gentoo</literal> y como <emphasis role="strong">versión original</emphasis> <literal>0.9.12</literal>. Estas referencias se utilizan en el archivo <filename>debian/changelog</filename> descrito más adelante en <xref linkend="changelog"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default package name field length of <command>aptitude</command> is 30.  For more than 90% of packages, the package name is less than 24 characters.
es: La longitud predeterminada del nombre del paquete en la orden <command>aptitude</command> es 30. En más del 90% de los paquetes, la longitud del nombre del paquete es inferior a 24 caracteres.

note: type: Content of: <book><chapter><section><para>
en: If upstream uses some generic term such as <literal>test-suite</literal> for its name, it is a good idea to rename it to identify its contents explicitly and avoid namespace pollution.  <placeholder type="footnote" id="0"/>
es: Si el código fuente original utiliza palabras genéricas tales como <literal>prueba-privada</literal> por nombre, es buena idea cambiarlo para no «contaminar» el espacio de nombres y para identificar su contenido en forma explícita <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This stricter rule should help you avoid confusing file names.
es: Esta norma más estricta debería ayudar a evitar confundir los nombres de archivo.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default version field length of <command>aptitude</command> is 10.  The Debian revision with preceding hyphen usually consumes 2.  For more than 80% of packages, the upstream version is less than 8 characters and the Debian revision is less than 2 characters.  For more than 90% of packages, the upstream version is less than 10 characters and the Debian revision is less than 3 characters.
es: El valor predeterminado para la longitud de la versión de la orden <command>aptitude</command> es 10. El código de la revisión Debian precedida por un guión consume 2. Para más del 80% de los paquetes, el código de la versión original es de menos de 8 caracteres y el de la revisión Debian es de menos de 2 caracteres. Para más del 90% de los paquetes, la versión original es de menos de 10 caracteres y la revisión Debian es de menos de 3 caracteres.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Version strings may be <emphasis role="strong">upstream version</emphasis> (<literal><replaceable>version</replaceable></literal>), <emphasis role="strong">Debian revision</emphasis> (<literal><replaceable>revision</replaceable></literal>), or <emphasis role="strong">version</emphasis> (<literal><replaceable>version</replaceable>-<replaceable>revision</replaceable></literal>).  See <xref linkend="newrevision"/> for how the <emphasis role="strong">Debian revision</emphasis> is incremented.
es: Las cadenas de versión pueden ser <emphasis role="strong">la versión del código fuente</emphasis> (<literal><replaceable>versión</replaceable></literal>), <emphasis role="strong">la revisión Debian</emphasis> (<literal><replaceable>revisión</replaceable></literal>), o <emphasis role="strong">versión</emphasis> (<literal><replaceable>versión</replaceable>-<replaceable>revisión</replaceable></literal>).  Consulta <xref linkend="newrevision"/> para saber cómo debe incrementarse <emphasis role="strong">la revisión Debian</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Version strings <placeholder type="footnote" id="0"/> can be compared using <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
es: El código de la versión <placeholder type="footnote" id="0"/> será comparado por <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> como sigue:

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg --compare-versions <replaceable>ver1</replaceable> <replaceable>op</replaceable> <replaceable>ver2</replaceable>
es: $ dpkg --compare-versions <replaceable>versión_1</replaceable> <replaceable>op</replaceable> <replaceable>versión_2</replaceable>

note: type: Content of: <book><chapter><section><para>
en: The version comparison rule can be summarized as:
es: La regla de comparación de versiones se pueden resumir de la siguiente manera.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Strings are compared from the head to the tail.
es: Las cadenas se comparan desde el inicio hasta el final.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are larger than digits.
es: Los caracteres (letras y símbolos) son anteriores a los números.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Numbers are compared as integers.
es: Los números se comparan como enteros.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are compared in ASCII code order.
es: Los caracteres (letras y símbolos) se comparan en el orden del código ASCII.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: There are special rules for period (<literal>.</literal>), plus (<literal>+</literal>), and tilde (<literal>~</literal>) characters, as follows:
es: Hay algunas reglas especiales para los puntos (<literal>.</literal> ), símbolo de suma (<literal>+</literal>) y tildes (<literal>~</literal>) como se explica a continuación:

note: type: Content of: <book><chapter><section><para>
en: One tricky case occurs when upstream releases <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> as the pre-release of <filename>gentoo-0.9.12.tar.gz</filename>.  You need to make sure that the upgrade works properly by renaming the upstream source to <filename>gentoo-0.9.12~rc99.tar.gz</filename>.
es: Uno de los casos difíciles sucede cuando la versions del código fuente <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename>  se utiliza como el pre-lanzamiento de  <filename>gentoo-0.9.12.tar.gz</filename>. Debes asegurarte que la actualización funciona correctamente cambiando el nombre a las fuentes originales por  <filename>gentoo-0.9.12~rc99.tar.gz</filename>.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>dh_make</command>
es: Configurar <command>dh_make</command>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The following text assumes you are using Bash as your login shell.  If you use some other login shell such as Z shell, use their corresponding configuration files instead of <filename>~/.bashrc</filename>.
es: El texto mostrado a continuación da por supuesto que estás ejecutando «bash» como tu intérprete de línea de órdenes.  Si utilizas otros intérpretes, como «Z shell», deberás utilizar sus correspondientes ficheros de configuración en lugar de <filename>~/.bashrc</filename>.

note: type: Content of: <book><chapter><section><para>
en: Set up the shell environment variables <literal>$DEBEMAIL</literal> and <literal>$DEBFULLNAME</literal> so that various Debian maintenance tools recognize your email address and name to use for packages. <placeholder type="footnote" id="0"/>
es: Primero debes configurar las variables de entorno «shell» <literal>$DEBEMAIL</literal> y <literal>$DEBFULLNAME</literal> que son utilizadas por varias herramientas de mantenimiento de Debian para obtener tu nombre y correo electrónico como se indica a continuación <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><screen>
en: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="your.email.address@example.org"
    DEBFULLNAME="Firstname Lastname"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc
es: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="tu.direccion.de.correo@ejemplo.org"
    DEBFULLNAME="Nombre Apellido"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc

note: type: Content of: <book><chapter><section><title>
en: Initial non-native Debian package
es: Paquete no nativo Debian inicial

note: type: Content of: <book><chapter><section><para>
en: Normal Debian packages are non-native Debian packages made from upstream programs.  If you wish to create a non-native Debian package of an upstream source <filename>gentoo-0.9.12.tar.gz</filename>, you can create an initial non-native Debian package for it by issuing the <command>dh_make</command> command as follows:
es: Los paquetes Debian normales son paquetes no nativos construidos a partir de los programas originales de los autores. Si deseas construir un paquete Debian no nativo a partir del código fuente original  <filename>gentoo-0.9.12.tar.gz</filename>, puedes construir un primer paquete de Debian no nativo ejecutando la orden <command>dh_make</command> como sigue:

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of your original source archive.  <placeholder type="footnote" id="0"/> See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> for details.
es: Deberás cambiar el nombre del archivo por el correspondiente a tus fuentes <placeholder type="footnote" id="0"/>.  Véase <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> para una descripción más detallada.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are several choices here: <literal>s</literal> for Single binary package, <literal>i</literal> for arch-Independent package, <literal>m</literal> for Multiple binary packages, <literal>l</literal> for Library package, <literal>k</literal> for Kernel module package, <literal>n</literal> for kernel patch package, and <literal>b</literal> for <systemitem role="package">cdbs</systemitem> package.  This document focuses on the use of the <command>dh</command> command (from the package <systemitem role="package">debhelper</systemitem>) to create a single binary package, but also touches on how to use it for arch-independent or multiple binary packages.  The package <systemitem role="package">cdbs</systemitem> offers an alternative packaging script infrastructure to the <command>dh</command> command and is outside the scope of this document.
es: Se ofrecen varias opciones aquí: <literal>s</literal> para un binario,<literal>i</literal> para un paquete independiente de la arquitectura (sólo código fuente o bien documentación), <literal>m</literal> para más de un binario, <literal>l</literal> para una biblioteca, <literal>k</literal> para un módulo del núcleo («kernel»), <literal>n</literal> para un  parche del núcleo y <literal>b</literal> para paquetes <systemitem role="package">cdbs</systemitem>. Este documento se centra en el uso del paquete <systemitem role="package">debhelper</systemitem> con la orden <command>dh</command> para la construcción de paquetes con un binario y trata solo parcialmente su uso en la construcción de paquetes independientes de la arquitectura y con más de un binario. El paquete <systemitem role="package">cdbs</systemitem> ofrece guiones alternativos a la orden <command>dh</command> y su uso queda fuera de este documento.

note: type: Content of: <book><chapter><section><para>
en: This execution of <command>dh_make</command> creates a copy of the upstream tarball as <filename>gentoo_0.9.12.orig.tar.gz</filename> in the parent directory to accommodate the creation of the non-native Debian source package with the name <filename>debian.tar.gz</filename> later:
es: Tras ejecutar <command>dh_make</command>, se genera una copia del código original con el nombre <filename>gentoo_0.9.12.orig.tar.gz</filename> en el directorio raíz para facilitar la construcción del paquete de fuentes no nativo de Debian con el archivo <filename>debian.tar.gz</filename>:

note: type: Content of: <book><chapter><section><para>
en: Please note two key features of this filename <filename>gentoo_0.9.12.orig.tar.gz</filename>:
es: Observa que hay dos cambios clave en el nombre del fichero <filename>gentoo_0.9.12.orig.tar.gz</filename>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Package name and version are separated by the character <literal>_</literal> (underscore).
es: El nombre del paquete y la versión están separados por «<literal>_</literal>».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The string <filename>.orig</filename> is inserted before the <filename>.tar.gz</filename>.
es: Hay un <filename>.orig</filename> antes de <filename>.tar.gz</filename>.

note: type: Content of: <book><chapter><section><para>
en: You should also notice that many template files are created in the source under the <filename>debian</filename> directory.  These will be explained in <xref linkend="dreq"/> and <xref linkend="dother"/>.  You should also understand that packaging cannot be a fully automated process.  You will need to modify the upstream source for Debian (see <xref linkend="modify"/>).  After this, you need to use the proper methods for building Debian packages (<xref linkend="build"/>), testing them (<xref linkend="checkit"/>), and uploading them (<xref linkend="upload"/>).  All the steps will be explained.
es: Observa que la ejecución de la orden ha generado varios archivos de plantilla en el directorio <filename>debian</filename>. Se tratará sobre ellos en <xref linkend="dreq"/> y <xref linkend="dother"/>. El proceso de empaquetado no está totalmente automatizado. Se tratará la modificación de los archivos Debian en <xref linkend="modify"/>.  A continuación se compilará el paquete Debian en el apartado <xref linkend="build"/>, la revisión del resultado en <xref linkend="checkit"/> y el envío del paquete en <xref linkend="upload"/>. Se explicará cada una de estas etapas a continuación.

note: type: Content of: <book><chapter><section><para>
en: If you accidentally erased some template files while working on them, you can recover them by running <command>dh_make</command> with the <literal>--addmissing</literal> option again in a Debian package source tree.
es: Si accidentalmente has eliminado alguna de las plantillas mientras trabajabas en ellas, puedes regenerarlas ejecutando <command>dh_make</command> con la opción <literal>--addmissing</literal> desde el directorio con las fuentes del paquete Debian.

note: type: Content of: <book><chapter><section><para>
en: Updating an existing package may get complicated since it may be using older techniques.  While learning the basics, please stick to creating a fresh package; further explanations are given in <xref linkend="update"/>.
es: Actualizar un paquete existente puede complicarse debido a que puede estar construido con técnicas más antiguas. Para aprender lo básico, es mejor limitarse a la construcción de un paquete nuevo; se amplia la explicación en <xref linkend="update"/>.

note: type: Content of: <book><chapter><title>
en: Modifying the source
es: Modificar las fuentes

note: type: Content of: <book><chapter><para>
en: Please note that there isn't space here to go into <emphasis>all</emphasis> the details of fixing upstream sources, but here are some basic steps and problems people often run across.
es: Ten en cuenta que no hay espacio aquí para entrar en <emphasis>todos</emphasis> los detalles respecto a los cambios que deben hacerse en las fuentes originales.  Sin embargo, a continuación se detallan algunos de los problemas más frecuentes.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>quilt</command>
es: Configurar <command>quilt</command>

note: type: Content of: <book><chapter><section><para>
en: The program <command>quilt</command> offers a basic method for recording modifications to the upstream source for Debian packaging.  It's useful to have a slightly customized default, so let's create an alias <command>dquilt</command> for Debian packaging by adding the following lines to <filename>~/.bashrc</filename>.  The second line provides the same shell completion feature of the <command>quilt</command> command to the <command>dquilt</command> command:
es: El programa <command>quilt</command> ofrece un método básico para realizar y guardar las modificaciones del código fuente para construir paquetes Debian. Para empaquetar, es preferible realizar algunos cambios en la configuración predeterminada del programa, vamos a generar un alias <command>dquilt</command> para la generación de paquetes Debian añadiendo la siguiente linea en el archivo <filename>~/.bashrc</filename>. La segunda línea garantiza que el alias tendrá los mismos beneficios que el programa «quilt» con la función de auto-completar del «shell»:

note: type: Content of: <book><chapter><section><para>
en: Then let's create <filename>~/.quiltrc-dpkg</filename> as follows:
es: A continuación, vamos a generar el archivo <filename>~/.quiltrc-dpkg</filename> de la siguiente manera:

note: type: Content of: <book><chapter><section><para>
en: See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <filename>&quilt-pdf;</filename> on how to use <command>quilt</command>.
es: Véase <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> y <filename>&quilt-pdf;</filename> para utilizar <command>quilt</command>.

note: type: Content of: <book><chapter><section><title>
en: Fixing upstream bugs
es: Corregir un error en el código fuente

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <filename>debian/patches</filename> directory should exist now if you ran <command>dh_make</command> as described before.  This example operation creates it just in case you are updating an existing package.
es: El directorio <filename>debian/patches</filename> debería haberse creado en la anterior ejecución de <command>dh_make</command>.  Sólo debes generarlo si no existe o bien si estás actualizando un paquete.

note: type: Content of: <book><chapter><section><para>
en: Let's fix this and record it with the <command>dquilt</command> command as <filename>fix-gentoo-target.patch</filename>: <placeholder type="footnote" id="0"/>
es: Vamos a arreglar este error con la orden <command>dquilt</command> y conservar las modificaciones a realizar en el archivo <filename>fix-gentoo-target.patch</filename> <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: You change the <filename>Makefile</filename> file as follows:
es: Ahora cambia el archivo <filename>Makefile</filename> (con un editor) original como se muestra a continuación:

note: type: Content of: <book><chapter><section><para>
en: Ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/fix-gentoo-target.patch</filename> and add its description following <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:
es: A continuación ejecuta <command>dquilt</command> para que actualice el parche generando el archivo <filename>debian/patches/fix-gentoo-target.patch</filename> y añade la descripción del parche como se describe en <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt refresh
    $ dquilt header -e
    ... describe patch
es: $ dquilt refresh
    $ dquilt header -e
    ... describe el parche

note: type: Content of: <book><chapter><section><title>
en: Installation of files to their destination
es: Instalación de los archivos en su destino

note: type: Content of: <book><chapter><section><para>
en: Most third-party software installs itself in the <filename>/usr/local</filename> directory hierarchy.  On Debian this is reserved for private use by the system administrator, so packages must not use directories such as <filename>/usr/local/bin</filename> but should instead use system directories such as <filename>/usr/bin</filename>, obeying the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS).
es: Por lo general, los programas se instalan a sí mismos en el subdirectorio <filename>/usr/local</filename>. Pero los paquetes Debian no pueden utilizar este directorio ya que está reservado para el uso privado del administrador (o de los usuarios), sino que deben utilizar los directorios del sistema como <filename>/usr/bin</filename> según lo establecido por la normativa de jerarquía del sistema de archivos («Filesystem Hierarchy Standard» <ulink url="&fhs;">FHS</ulink>).

note: type: Content of: <book><chapter><section><para>
en: Normally, <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> is used to automate building the program, and executing <literal>make install</literal> installs programs directly to the desired destination (following the <literal>install</literal> target in the <filename>Makefile</filename>).  In order for Debian to provide pre-built installable packages, it modifies the build system to install programs into a file tree image created under a temporary directory instead of the actual destination.
es: Es frecuente la utilización de <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> para la construcción automatizada del programa y la ejecución de la orden <literal>make install</literal> instala directamente el programa en la ubicación deseada ejecutando la sección <literal>install</literal> del archivo <filename>Makefile</filename>.  En la construcción de los paquetes binarios de Debian, el sistema de construcción instala los programas en una reconstrucción de la estructura de directorios del programa en un directorio temporal en lugar de hacerlo en su destino real.

note: type: Content of: <book><chapter><section><para>
en: These two differences between normal program installation on one hand and the Debian packaging system on the other can be transparently addressed by the <systemitem role="package">debhelper</systemitem> package through the <command>dh_auto_configure</command> and <command>dh_auto_install</command> commands if the following conditions are met:
es: Estas dos diferencias entre la instalación del programa y el proceso de construcción del paquete es manejado en Debian de forma transparente por <systemitem role="package">debhelper</systemitem> con las órdenes <command>dh_auto_configure</command> y <command>dh_auto_install</command> siempre que se cumplan los requisitos indicados a continuación:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.
es: Consulta <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <filename>Makefile</filename> must follow GNU conventions and support the <literal>$(DESTDIR)</literal> variable.  <placeholder type="footnote" id="0"/>
es: El archivo <filename>Makefile</filename> debe seguir las convenciones GNU de forma que admita la variable <literal>$(DESTDIR)</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The source must follow the Filesystem Hierarchy Standard (FHS).
es: El código fuente sigue el estándar de la jerarquía del sistema de ficheros.  («Filesystem Hierarchy Standard» o FHS).

note: type: Content of: <book><chapter><section><para>
en: Programs that use GNU <command>autoconf</command> follow the GNU conventions automatically, so they can be trivial to package.  On the basis of this and other heuristics, it is estimated that the <systemitem role="package">debhelper</systemitem> package will work for about 90% of packages without making any intrusive changes to their build system.  So packaging is not as complicated as it may seem.
es: Los programas que usan <command>autoconf</command> de GNU cumplen <emphasis>automáticamente</emphasis> con las convenciones GNU y su empaquetamiento es casi <emphasis>automático</emphasis>.  Con estos requisitos y la heurística que aplica el paquete <systemitem role="package">debhelper</systemitem>, se estima que funciona sobre el 90% de paquetes sin tener que realizar ningún cambio intrusivo en su sistema de construcción.  El empaquetado no es tan complicado como puede parecer.

note: type: Content of: <book><chapter><section><para>
en: If you need to make changes in the <filename>Makefile</filename>, you should be careful to support the <literal>$(DESTDIR)</literal> variable.  Although it is unset by default, the <literal>$(DESTDIR)</literal> variable is prepended to each file path used for the program installation.  The packaging script will set <literal>$(DESTDIR)</literal> to the temporary directory.
es: Si debes hacer cambios en el archivo <filename>Makefile</filename>, debes asegurarte que admite la variable <literal>$(DESTDIR)</literal>.  La variable <literal>$(DESTDIR)</literal> no está definida en el archivo y se añadirá en todas las rutas de directorios usadas en la instalación del programa.  El guión de empaquetamiento establece el valor de la variable <literal>$(DESTDIR)</literal> al valor del directorio temporal de instalación del programa en el proceso de construcción del paquete.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: For a source package generating multiple binary packages, the <command>dh_auto_install</command> command uses <filename>debian/tmp</filename> as the temporary directory while the <command>dh_install</command> command with the help of <filename>debian/<replaceable>package-1</replaceable>.install</filename> and <filename>debian/<replaceable>package-2</replaceable>.install</filename> files will split the contents of <filename>debian/tmp</filename> into <filename>debian/<replaceable>package-1</replaceable></filename> and <filename>debian/<replaceable>package-2</replaceable></filename> temporary directories, to create <filename><replaceable>package-1</replaceable>_*.deb</filename> and <filename><replaceable>package-2</replaceable>_*.deb</filename> binary packages.
es: Para paquetes con más de un archivo binario, la orden <command>dh_auto_install</command> utiliza como directorio temporal <filename>debian/tmp</filename> mientras que la orden <command>dh_install</command> con la ayuda de los archivos <filename>debian/<replaceable>paquete-1</replaceable>.install</filename> y <filename>debian/<replaceable>paquete-2</replaceable>.install</filename> distribuirá el contenido del directorio <filename>debian/tmp</filename> en los directorios temporales <filename>debian/<replaceable>paquete-1</replaceable></filename> y <filename>debian/<replaceable>paquete-2</replaceable></filename> para construir los paquetes binarios  <filename><replaceable>package-1</replaceable>_*.deb</filename> y <filename><replaceable>package-2</replaceable>_*.deb</filename>.

note: type: Content of: <book><chapter><section><para>
en: For a source package generating a single binary package, the temporary directory used by the <command>dh_auto_install</command> command will be set to <filename>debian/<replaceable>package</replaceable></filename>.  <placeholder type="footnote" id="0"/> Everything that is contained in the temporary directory will be installed on users' systems when they install your package; the only difference is that <command>dpkg</command> will be installing the files to paths relative to the root directory rather than your working directory.
es: El directorio temporal usado por la orden <command>dh_auto_install</command> es <filename>debian/<replaceable>nombre_de_paquete</replaceable></filename> para paquetes con un binario <placeholder type="footnote" id="0"/>.  El contenido completo del directorio temporal será instalado en el sistema del usuario cuando se instale el paquete, con la diferencia que con <command>dpkg</command> la instalación se realizará a partir del directorio raíz del sistema.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that even though your program installs in <filename>debian/<replaceable>package</replaceable></filename>, it still needs to behave correctly when installed from the <filename>.deb</filename> package under the root directory.  So you must not allow the build system to hardcode strings like <literal>/home/me/deb/<replaceable>package</replaceable>-<replaceable>version</replaceable>/usr/share/<replaceable>package</replaceable></literal> into files in the package.
es: Aunque el programa se instale en el directorio <filename>debian/<replaceable>nombre_del_paquete</replaceable></filename> será necesario que se comporte correctamente cuando se instale en el directorio raíz, esto es, cuando se instale usando el archivo <filename>.deb</filename>.  Deberías evitar que el sistema de compilación incluya cadenas del tipo <literal>/home/mi/deb/<replaceable>nombre_del_paquete</replaceable>-<replaceable>versión</replaceable>/usr/share/<replaceable>nombre_del_paquete</replaceable></literal> en los archivos del paquete.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This is just an example to show what a <filename>Makefile</filename> should look like.  If the <filename>Makefile</filename> is created by the <command>./configure</command> command, the correct way to fix this kind of <filename>Makefile</filename> is to execute <command>./configure</command> from the <command>dh_auto_configure</command> command with default options including <literal>--prefix=/usr</literal>.
es: Se trata solo de un ejemplo del contenido del archivo <filename>Makefile</filename>. Si el archivo <filename>Makefile</filename> se construye con la orden <command>./configure</command>, la forma correcta de solucionar este tipo de errores en los archivos <filename>Makefile</filename> es ejecutando la orden <command>./configure</command> desde la orden <command>dh_auto_configure</command> con las opciones predeterminadas añadiendo <literal>--prefix=/usr</literal>.

note: type: Content of: <book><chapter><section><para>
en: Here's the relevant part of <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename><placeholder type="footnote" id="0"/>:
es: Esta es la parte importante del archivo <filename>Makefile</filename> de <systemitem role="package">gentoo</systemitem> <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><screen>
en: # Where to put executable commands on 'make install'?
    BIN     = /usr/local/bin
    # Where to put icons on 'make install'?
    ICONS   = /usr/local/share/gentoo
es: # ¿Dónde se colocaran los ejecutables con 'make install'?
    BIN     = /usr/local/bin
    # ¿Dónde se colocaran los iconos con 'make install'?
    ICONS   = /usr/local/share/gentoo

note: type: Content of: <book><chapter><section><screen>
en: # Where to put executable commands on 'make install'?
    BIN     = $(DESTDIR)/usr/bin
    # Where to put icons on 'make install'?
    ICONS   = $(DESTDIR)/usr/share/gentoo
es: # ¿Dónde se colocaran los ejecutables con 'make install'?
    BIN     = $(DESTDIR)/usr/bin
    # ¿Dónde se colocaran los iconos con 'make install'?
    ICONS   = $(DESTDIR)/usr/share/gentoo

note: type: Content of: <book><chapter><section><para>
en: The exact locations that should be used for binaries, icons, documentation, etc. are specified in the Filesystem Hierarchy Standard (FHS).  You should browse through it and read the sections relevant to your package.
es: La ubicación correcta de los binarios, iconos, documentación, etc, está especificada en el «Estándar de la jerarquía del sistema de ficheros». Te recomiendo que leas las secciones que podrían aplicarse a tu paquete.

note: type: Content of: <book><chapter><section><para>
en: So, we should install executable commands in <filename>/usr/bin</filename> instead of <filename>/usr/local/bin</filename>, the manual page in <filename>/usr/share/man/man1</filename> instead of <filename>/usr/local/man/man1</filename>, and so on.  Notice how there's no manual page mentioned in <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename>, but since Debian Policy requires that every program has one, we'll make one later and install it in <filename>/usr/share/man/man1</filename>.
es: Así pues, deberíamos instalar el binario en <filename>/usr/bin</filename> en lugar de <filename>/usr/local/bin</filename> y la página de manual en <filename>/usr/share/man/man1</filename> en lugar de <filename>/usr/local/man/man1</filename>. No hemos mencionado ninguna página de manual en el <filename>Makefile</filename> de <systemitem role="package">gentoo</systemitem>, pero la normativa de Debian requiere que cada programa debe tener una, así que haremos una más tarde y la instalaremos en <filename>/usr/share/man/man1</filename>.

note: type: Content of: <book><chapter><section><para>
en: Some programs don't use <filename>Makefile</filename> variables to define paths such as these.  This means you might have to edit some real C sources in order to fix them to use the right locations.  But where to search, and exactly what for? You can find this out by issuing:
es: Algunos programas no usan variables en el <filename>makefile</filename> para definir rutas como éstas.  Esto significa que tendrás que editar algunos de los ficheros de código C para arreglarlos y que usen las rutas correctas.  Pero, ¿dónde buscar?, y exactamente, ¿el qué? Puedes probar a encontrarlos usando:

note: type: Content of: <book><chapter><section><para>
en: <command>grep</command> will run recursively through the source tree and tell you the filename and the line number for all matches.
es: <command>grep</command> buscará recursivamente en los subdirectorios y te indicará el nombre del fichero y la línea cuando encuentre una concordancia con la cadena.

note: type: Content of: <book><chapter><section><para>
en: Edit those files and in those lines replace <literal>usr/local/lib</literal> with <literal>usr/lib</literal>.  This can be done automatically as follows:
es: Ahora edita esos ficheros y cambia en esas líneas <literal>usr/local/lib</literal> por <literal>usr/lib</literal>. Esto se puede hacer de forma automática como sigue:

note: type: Content of: <book><chapter><section><para>
en: If you want to confirm each substitution instead, this can be done interactively as follows:
es: Si deseas confirmar cada sustitución, puedes hacerlo de forma interactiva de la siguiente manera:

note: type: Content of: <book><chapter><section><para>
en: Next you should find the <literal>install</literal> target (searching for the line that starts with <literal>install:</literal> will usually work) and rename all references to directories other than ones defined at the top of the <filename>Makefile</filename>.
es: Después de esto deberías encontrar (en el archivo <filename>Makefile</filename>) el objetivo «install» (busca una línea que comience por <literal>install:</literal>) y renombra todas las referencias a directorios distintos de los definidos al comienzo del <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Originally, <systemitem role="package">gentoo</systemitem>'s <literal>install</literal> target said:
es: En el original, el objetivo «install» de <systemitem role="package">gentoo</systemitem> declaraba:

note: type: Content of: <book><chapter><section><para>
en: Let's fix this upstream bug and record it with the <command>dquilt</command> command as <filename>debian/patches/install.patch</filename>.
es: Ahora corregiremos el error, conservando las modificaciones en el archivo <filename>debian/patches/install.patch</filename> con la orden <command>dquilt</command>.

note: type: Content of: <book><chapter><section><para>
en: In your editor, change this for the Debian package as follows:
es: Y ahora escribe los cambios con el editor:

note: type: Content of: <book><chapter><section><para>
en: You'll have noticed that there's now an <literal>install -d</literal> command before the other commands in the rule.  The original <filename>Makefile</filename> didn't have it because usually <literal>/usr/local/bin</literal> and other directories already exist on the system where you are running <literal>make install</literal>.  However, since we will be installing into a newly created private directory tree, we will have to create each and every one of those directories.
es: Seguramente has notado que ahora hay una orden <literal>install -d</literal> antes de las demás órdenes de la regla.  El <filename>Makefile</filename> original no la tenía porque normalmente <literal>/usr/local/bin</literal> y otros directorios ya existen en el sistema donde se ejecuta <literal>make install</literal>.  Sin embargo, dado que lo instalaremos en un directorio vacío (o incluso inexistente), tendremos que generar cada uno de estos directorios.

note: type: Content of: <book><chapter><section><para>
en: We can also add in other things at the end of the rule, like the installation of additional documentation that the upstream authors sometimes omit:
es: También podemos añadir otras cosas al final de la regla, como la instalación de documentación adicional que los desarrolladores originales a veces omiten:

note: type: Content of: <book><chapter><section><screen>
en:         install -d $(DESTDIR)/usr/share/doc/gentoo/html
            cp -a docs/* $(DESTDIR)/usr/share/doc/gentoo/html
es:        install -d $(DESTDIR)/usr/share/doc/gentoo/html
           cp -a docs/* $(DESTDIR)/usr/share/doc/gentoo/html

note: type: Content of: <book><chapter><section><para>
en: Check carefully, and if everything is okay, ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/install.patch</filename> and add its description:
es: Después de comprobar que sea todo correcto, ejecuta <command>dquilt</command> para actualizar la modificación en el archivo <filename>debian/patches/install.patch</filename> y añade la descripción en la cabecera del archivo:

note: type: Content of: <book><chapter><section><para>
en: Now you have a series of patches.
es: Ahora ya tienes un par de parches en el paquete.

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Upstream bug fix: <filename>debian/patches/fix-gentoo-target.patch</filename>
es: Corrección de un error en el código fuente: <filename>debian/patches/fix-gentoo-target.patch</filename>

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Debian specific packaging modification: <filename>debian/patches/install.patch</filename>
es: Una modificación específica del empaquetado Debian: <filename>debian/patches/install.patch</filename>

note: type: Content of: <book><chapter><section><para>
en: Note that you don't have to send the <filename>debian/*</filename> files upstream.
es: Ten en cuenta que no tienes que enviar ninguno de los ficheros <filename>debian/*</filename> al desarrollador original.

note: type: Content of: <book><chapter><section><title>
en: Differing libraries
es: Diferencias en las bibliotecas

note: type: Content of: <book><chapter><section><para>
en: Let's assume a line in your program's <filename>Makefile</filename> (or <filename>Makefile.in</filename>) as the following.
es: Vamos a suponer que en el archivo <filename>Makefile</filename> (o <filename>Makefile.in</filename>) de tu programa se declara algo como lo siguiente.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If there are API changes from the <literal>foo</literal> library to the <literal>foo2</literal> library, required changes to the source code need to be made to match the new API.
es: Si hay cambios en el API de la biblioteca <literal>nombre_biblioteca</literal> a <literal>nombre_biblioteca2</literal>, se deberá cambiar el código fuente para que se corresponda con la nueva API.

note: type: Content of: <book><chapter><section><para>
en: If your program doesn't compile since the <literal>foo</literal> library doesn't exist and its equivalent is provided by the <literal>foo2</literal> library on the Debian system, you can fix this build problem as <filename>debian/patches/foo2.patch</filename> by changing <literal>foo</literal> into <literal>foo2</literal>:<placeholder type="footnote" id="0"/>
es: Si el programa no se compila debido a que ya no existe la biblioteca <literal>nombre_biblioteca</literal> y su equivalente es proporcionada por la biblioteca  <literal>nombre_biblioteca2</literal> en el sistema Debian, puedes solucionar este problema de compilación, cambiando (en el archivo <filename>debian/patches/parche2.patch</filename>) <literal>nombre_biblioteca</literal> por <literal>nombre_biblioteca2</literal> <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
es: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    ... describe el cambio

note: type: Content of: <book><chapter><title>
en: Required files under the <filename>debian</filename> directory
es: Archivos necesarios en el directorio <filename>debian</filename>

note: type: Content of: <book><chapter><para>
en: In this chapter, files in the <filename>debian</filename> directory are referred to without the leading <filename>debian/</filename> for simplicity whenever the meaning is obvious.
es: En este capitulo, los archivos del directorio <filename>debian</filename> se nombran sin el antecedente <filename>debian/</filename> para simplificar y siempre que no haya posibilidad de equívocos.

note: type: Content of: <book><chapter><para>
en: There is a new subdirectory under the program's source directory, called <filename>debian</filename>.  There are a number of files in this directory that we should edit in order to customize the behavior of the package.  The most important of them are <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename>, and <filename>rules</filename>, which are required for all packages.  <placeholder type="footnote" id="0"/>
es: Ahora hay un nuevo subdirectorio bajo el directorio principal del programa («gentoo-0.9.12»), que se llama <filename>debian</filename>.  Hay algunos ficheros en este directorio que debemos editar para adaptar el comportamiento del paquete. La parte más importante es modificar los ficheros <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename> y <filename>rules</filename> que son necesarios en todos los paquetes.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: <filename>control</filename>
es: El archivo <filename>control</filename>

note: type: Content of: <book><chapter><section><para>
en: This file contains various values which <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command>, and other package management tools will use to manage the package.  It is defined by the <ulink url="&policy-control;">Debian Policy Manual, 5 "Control files and their fields"</ulink>.
es: Este fichero contiene varios valores que <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command> y otras herramientas de gestión de paquetes usarán para gestionar el paquete.  Su contenido está concretado en <ulink url="&policy-control;">Debian Policy Manual, 5 'Control files and their fields'</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is the <filename>control</filename> file <command>dh_make</command> created for us:
es: Aquí está el fichero de  <filename>control</filename> que <command>dh_make</command> construye para nosotros:

note: type: Content of: <book><chapter><section><para>
en: (I've added the line numbers.)
es: (He añadido los números de línea)

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the name of the source package.
es: La línea 1 es el nombre del paquete fuente.

note: type: Content of: <book><chapter><section><para>
en: Line 2 is the section of the distribution the source package goes into.
es: La línea 2 es la sección de la distribución dentro de la que estará este paquete.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-subsections;">Debian Policy Manual, 2.4 "Sections"</ulink> and <ulink url="&sections-unstable;">List of sections in <literal>sid</literal></ulink>.
es: Consulta <ulink url="&policy-subsections;">normas de Debian, 2.4 'Secciones'</ulink> y <ulink url="&sections-unstable;">Lista de secciones en <literal>sid</literal></ulink>.

note: type: Content of: <book><chapter><section><para>
en: As you may have noticed, the Debian archive is divided into multiple areas: <literal>main</literal> (the free software), <literal>non-free</literal> (the not really free software) and <literal>contrib</literal> (free software that depends on non-free software).  Each of these is divided into sections that classify packages into rough categories.  So we have <literal>admin</literal> for administrator-only programs, <literal>devel</literal> for programmer tools, <literal>doc</literal> for documentation, <literal>libs</literal> for libraries, <literal>mail</literal> for email readers and daemons, <literal>net</literal> for network apps and daemons, <literal>x11</literal> for X11 programs that don't fit anywhere else, and many more.  <placeholder type="footnote" id="0"/>
es: Como puede que hayas notado, Debian está dividida en secciones: <literal>main</literal> (principal, los programas libres o de código abierto), <literal>non-free</literal> (no libre, los programas que no son libres, que son de propietario) y <literal>contrib</literal> (programas libres que dependen de programas no libre o de propietario).  Bajo ellas hay subdivisiones lógicas que describen en una palabra qué paquetes hay dentro.  Así que tenemos <literal>admin</literal> para programas que sólo usa un administrador, <literal>base</literal> para las herramientas básicas, <literal>devel</literal> para las herramientas de programación, <literal>doc</literal> para la documentación, <literal>libs</literal> para las bibliotecas, <literal>mail</literal> para lectores y demonios de correo-e, <literal>net</literal> para aplicaciones y demonios de red, <literal>x11</literal> para programas específicos de X11, y muchos más.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Let's change it then to x11.  (A <literal>main/</literal> prefix is implied so we can omit it.)
es: Vamos a cambiarla para que ponga «x11». El prefijo <literal>main/</literal> ya va implícito, así que podemos omitirlo.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink>.
es: Véase <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 'Priorities'</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 3 describes how important it is that the user installs this package.  <placeholder type="footnote" id="0"/>
es: La línea 3 describe cómo de importante es para el usuario la instalación de este paquete <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <literal>optional</literal> priority will usually work for new packages that do not conflict with others claiming <literal>required</literal>, <literal>important</literal>, or <literal>standard</literal> priority.
es: La prioridad <literal>optional</literal> se utiliza para paquetes nuevos que no entran en conflicto con otros de prioridad <literal>required</literal>, <literal>important</literal> o <literal>standard</literal>.

note: type: Content of: <book><chapter><section><para>
en: Section and priority are used by front-ends like <command>aptitude</command> when they sort packages and select defaults.  Once you upload the package to Debian, the value of these two fields can be overridden by the archive maintainers, in which case you will be notified by email.
es: «Section» y «Priority» se usan en las interfaces como <command>aptitude</command> cuando ordenan los paquetes y seleccionan los predeterminados.  Una vez que envíes el paquete a Debian, el valor de estos dos campos puede no ser aceptado por los responsables del archivo, en cuyo caso te lo notificarán por correo electrónico.

note: type: Content of: <book><chapter><section><para>
en: As this is a normal priority package and doesn't conflict with anything else, we will change the priority to <literal>optional</literal>.
es: Como es un paquete de prioridad normal y no tiene conflictos con ningún otro, lo dejaremos con prioridad <literal>optional</literal> (opcional).

note: type: Content of: <book><chapter><section><para>
en: Line 4 is the name and email address of the maintainer.  Make sure that this field includes a valid <literal>To</literal> header for email, because after you upload it, the bug tracking system will use it to deliver bug emails to you.  Avoid using commas, ampersands, or parentheses.
es: La línea 4 es el nombre y correo electrónico del desarrollador.  Asegúrate de que este campo incluye una cabecera válida <literal>To</literal> («A:»), para una dirección de correo electrónico, porque después de que envíes el paquete, el sistema de seguimiento de errores («Bug Tracking System»)  utilizará esta dirección para enviarte los mensajes de los errores.  Evita usar comas, el signo «&amp;» y paréntesis.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, 7.7 "Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep"</ulink>.
es: Consulta <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, 7.7 'Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep'</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For all packages packaged with the <command>dh</command> command in the <filename>debian/rules</filename> file, you must have <literal>debhelper (&gt;=9)</literal> in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
es: Para todos los paquetes construidos con la orden <command>dh</command> en el archivo <filename>debian/rules</filename>, estará <literal>debhelper (&gt;=9)</literal> en el campo <literal>Build-Depends</literal> para ajustarse a las normas de Debian respecto al objetivo <literal>clean</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For source packages with binary packages all of which are <literal>Architecture: all</literal>, the <literal>Build-Depends-Indep</literal> field may list all the required packages unless they are already listed in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
es: En el caso de los paquetes de fuentes que incluyen paquetes binarios únicamente del tipo <literal>Architecture: all</literal>, el campo <literal>Build-Depends-Indep</literal> debe listar todos los paquetes excepto los listados en el campo <literal>Build-Depends</literal> para satisfacer los requerimientos de las normas de Debian respecto al objetivo <literal>clean</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This somewhat strange situation is a feature well documented in the <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>.  This is not due to the use of the <command>dh</command> command in the <filename>debian/rules</filename> file but due to how the <command>dpkg-buildpackage</command> works.  The same situation applies to the <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">auto build system for Ubuntu</ulink>.
es: Este caso poco frecuente, está documentado en <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>.  Esto se debe al funcionamiento de <command>dpkg-buildpackage</command>, no al uso de la orden <command>dh</command> en el archivo <filename>debian/rules</filename>.  Esto también se aplica al <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">«auto build system for Ubuntu»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If you are not sure which one should be used, use the <literal>Build-Depends</literal> field to be on the safe side.  <placeholder type="footnote" id="0"/>
es: En caso de duda, utiliza el campo <literal>Build-Depends</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: To find out what packages your package needs to be built run the command:
es: Para saber qué paquetes son necesarios para compilar el tuyo ejecuta esta orden:

note: type: Content of: <book><chapter><section><para>
en: To manually find exact build dependencies for <command><replaceable>/usr/bin/foo</replaceable></command>, execute
es: Para buscar manualmente las dependencias de compilación para el paquete <command><replaceable>/usr/bin/nombre_del_paquete</replaceable></command>, deberías ejecutar:

note: type: Content of: <book><chapter><section><screen>
en: $ objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED
es: $ objdump -p <replaceable>/usr/bin/nombre_del_paquete</replaceable> | grep NEEDED

note: type: Content of: <book><chapter><section><para>
en: Then just take the <literal>-dev</literal> version of every package as a <literal>Build-Depends</literal> entry.  If you use <command>ldd</command> for this purpose, it will report indirect lib dependencies as well, resulting in the problem of excessive build dependencies.
es: Debes utilizar la versión <literal>-dev</literal> de cada uno de los paquetes dentro de la entrada <literal>Build-Depends</literal>. Si usas <command>ldd</command> para este propósito, también te informará de las dependencias de bibliotecas indirectas, lo que puede llevar a que se introduzcan demasiadas dependencias de construcción.

note: type: Content of: <book><chapter><section><para>
en: <systemitem role="package">gentoo</systemitem> also happens to require <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> and <systemitem role="package">libglib1.2-dev</systemitem> to build, so we'll add them here next to <systemitem role="package">debhelper</systemitem>.
es: <systemitem role="package">gentoo</systemitem> también depende de <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> y <systemitem role="package">libglib1.2-dev</systemitem> para su construcción, así que lo añadiremos junto a <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: Line 6 is the version of the <ulink url="&debian-policy;">Debian Policy Manual</ulink> standards this package follows, the one you read while making your package.
es: La línea 6 es la versión de los estándares definidos en las normas de Debian que sigue este paquete, es decir, la versión del manual de normas que has leído mientras haces tu paquete (véase <ulink url="&debian-policy;">«Debian Policy Manual»</ulink>).

note: type: Content of: <book><chapter><section><para>
en: On line 7 you can put the URL of the software's upstream homepage.
es: En la línea 7 está la dirección URL de la página web del programa (donde has obtenido las fuentes).

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the name of the binary package.  This is usually the same as the name of the source package, but it doesn't necessarily have to be that way.
es: La línea 9 es el nombre del paquete binario.  Este suele ser el mismo que el del paquete fuente, aunque no es necesario que sea así siempre.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> for exact details.
es: Véase <ulink url="&policy-architecture;">Debian Policy Manual 5.6.8 "Architecture"</ulink> para más detalles.

note: type: Content of: <book><chapter><section><para>
en: Line 10 describes the architectures the binary package can be compiled for.  This value is usually one of the following depending on the type of the binary package: <placeholder type="footnote" id="0"/>
es: La linea 10 describe las arquitecturas en las que puede compilarse el paquete binario. Este valor suele ser uno de los listados a continuación dependiendo del tipo de paquete <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture dependent one usually in a compiled language.
es: El paquete binario generado depende de la arquitectura si consiste en un programa escrito en un lenguaje compilado.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture independent one usually consisting of text, images, or scripts in an interpreted language.
es: El paquete binario generado es independiente de la arquitectura si consiste en archivos de texto, imágenes o guiones escritos en lenguajes interpretados.

note: type: Content of: <book><chapter><section><para>
en: We leave line 10 as is since this is written in C.  <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> will fill in the appropriate architecture value for any machine this source package gets compiled on.
es: Eliminamos la línea 10 debido a que el programa está escrito en C. <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> la rellenará con el valor apropiado cuando se compile este paquete en cualquier arquitectura para la cual pueda ser compilado.

note: type: Content of: <book><chapter><section><para>
en: If your package is architecture independent (for example, a shell or Perl script, or a document), change this to <literal>all</literal>, and read later in <xref linkend="rules"/> about using the <literal>binary-indep</literal> rule instead of <literal>binary-arch</literal> for building the package.
es: Si tu paquete es independiente de la arquitectura (por ejemplo, un documento, un guión escrito en Perl o para el intérprete de órdenes), cambia esto a <literal>all</literal>, y consulta más adelante <xref linkend="rules"/> sobre cómo usar la regla <literal>binary-indep</literal> en lugar de <literal>binary-arch</literal> para construir el paquete.

note: type: Content of: <book><chapter><section><para>
en: Line 11 shows one of the most powerful features of the Debian packaging system.  Packages can relate to each other in various ways.  Apart from <literal>Depends</literal>, other relationship fields are <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal>, and <literal>Replaces</literal>.
es: La línea 11 muestra una de las más poderosas posibilidades del sistema de paquetes de Debian.  Los paquetes se pueden relacionar unos con otros de diversas formas.  Aparte de <literal>Depends</literal> (depende de) otros campos de relación son <literal>Recommends</literal> (recomienda), <literal>Suggests</literal> (sugiere), <literal>Pre-Depends</literal> (predepende de), <literal>Breaks</literal> (rompe a), <literal>Conflicts</literal> (entra en conflicto con), <literal>Provides</literal> (provee), <literal>Replaces</literal> (reemplaza a).

note: type: Content of: <book><chapter><section><para>
en: The package management tools usually behave the same way when dealing with these relations; if not, it will be explained.  (See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, etc.)
es: Las herramientas de gestión de paquetes se comportan habitualmente de la misma forma cuando tratan con esas relaciones entre paquetes; si no es así, se explicará en cada caso.  (véase <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, etc.)

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink>.
es: Consulta <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is a simplified description of package relationships: <placeholder type="footnote" id="0"/>
es: He aquí una descripción simplificada de relaciones entre paquetes:  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Depends</literal>
es: <literal>Depends</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed unless the packages it depends on are installed.  Use this if your program absolutely will not run (or will cause severe breakage) unless a particular package is present.
es: No se instalará el programa a menos que los paquetes de los que depende estén ya instalados.  Usa esto si tu programa no funcionará de ninguna forma (o se romperá fácilmente) a no ser que se haya instalado un paquete determinado.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Recommends</literal>
es: <literal>Recommends</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages that are not strictly necessary but are typically used with your program.  When a user installs your program, all front-ends will probably prompt them to install the recommended packages.  <command>aptitude</command> and <command>apt-get</command> install recommended packages along with your package by default (but the user can disable this behavior).  <command>dpkg</command> will ignore this field.
es: Esta opción es para paquetes cuya instalación no es estrictamente necesaria para el funcionamiento de tu programa pero que suelen utilizarse junto con tu programa.  Cuando los usuarios instalen tu paquete, todas las interfaces de instalación aconsejaran la instalación de los paquetes recomendados.  <command>aptitude</command> y <command>apt-get</command> instalan los paquetes recomendados (pero el usuario puede decidir no hacerlo).  <command>dpkg</command> ignora el contenido de este campo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Suggests</literal>
es: <literal>Suggests</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages which will work nicely with your program but are not at all necessary.  When a user installs your program, they will probably not be prompted to install suggested packages.  <command>aptitude</command> can be configured to install suggested packages along with your package but this is not its default.  <command>dpkg</command> and <command>apt-get</command> will ignore this field.
es:  Utiliza esto para paquetes que funcionarán bien con tu programa pero que no son necesarios en absoluto.  Es posible configurar <command>aptitude</command> para que instale los paquetes sugeridos, aunque no es la opción predeterminada. <command>dpkg</command> y <command>apt-get</command> ignorarán estas dependencias.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Pre-Depends</literal>
es: <literal>Pre-Depends</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is stronger than <literal>Depends</literal>.  The package will not be installed unless the packages it pre-depends on are installed and <emphasis>correctly configured</emphasis>.  Use this <emphasis>very</emphasis> sparingly and only after discussing it on the <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink> mailing list.  Read: don't use it at all.  :-)
es: Esto es más fuerte que <literal>Depends</literal>.  El paquete no se instalará a menos que los paquetes de los que pre-dependa estén instalados y <emphasis>correctamente configurados</emphasis>.  Utiliza esto <emphasis>muy</emphasis> poco y sólo después de haberlo discutido en la lista de distribución (<ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink>).  En resumidas cuentas: no lo utilices en absoluto :-)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Conflicts</literal>
es: <literal>Conflicts</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed until all the packages it conflicts with have been removed.  Use this if your program absolutely will not run or will cause severe problems if a particular package is present.
es: El paquete no se instalará hasta que todos los paquetes con los que entra en conflicto hayan sido eliminados.  Utiliza esto si tu programa no funcionará en absoluto (o fallará fácilmente) si un paquete en concreto está instalado.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Breaks</literal>
es: <literal>Breaks</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: When installed the package will break all the listed packages.  Normally a <literal>Breaks</literal> entry specifies that it applies to versions earlier than a certain value.  The resolution is generally to use higher-level package management tools to upgrade the listed packages.
es: Si el paquete se instala, todos los paquetes de la lista se romperán.  Normalmente, los paquetes incluidos en la lista <literal>Breaks</literal> tienen una cláusula de versión anterior.  La solución es actualizar los paquetes de la lista a la versión más actual.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Provides</literal>
es: <literal>Provides</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Replaces</literal>
es: <literal>Replaces</literal>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this when your program replaces files from another package, or completely replaces another package (used in conjunction with <literal>Conflicts</literal>).  Files from the named packages will be overwritten with the files from your package.
es: Usa esto si tu programa reemplaza ficheros de otro paquete o reemplaza totalmente otro paquete (generalmente se usa conjuntamente con <literal>Conflicts</literal>).  Se sobrescribirán los ficheros de los paquetes indicados con los ficheros de tu paquete.

note: type: Content of: <book><chapter><section><para>
en: All these fields have uniform syntax.  They are a list of package names separated by commas.  These package names may also be lists of alternative package names, separated by vertical bar symbols <literal>|</literal> (pipe symbols).
es: Todos estos campos tienen una sintaxis uniforme: se trata de una lista de nombres de paquetes separados por comas.  Estos nombres de paquetes también puede ser listas de paquetes alternativos, separados por los símbolos de barra vertical «<literal>|</literal>» (símbolos tubería).

note: type: Content of: <book><chapter><section><para>
en: The fields may restrict their applicability to particular versions of each named package.  The restriction of each individual package is listed in parentheses after its name, and should contain a relation from the list below followed by a version number value.  The relations allowed are: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal>, and <literal>&gt;&gt;</literal> for strictly lower, lower or equal, exactly equal, greater or equal, and strictly greater, respectively.  For example,
es: Los campos pueden restringir su aplicación a versiones determinadas de cada paquete nombrado.  Esto se hace listando después de cada nombre de paquete individual las versiones entre paréntesis, e indicando antes del número de versión una relación de la siguiente lista.  Las relaciones permitidas son: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal> y <literal>&gt;&gt;</literal> para estrictamente anterior, anterior o igual, exactamente igual, posterior o igual o estrictamente posterior, respectivamente.  Por ejemplo:

note: type: Content of: <book><chapter><section><para>
en: The last feature you need to know about is <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
es: La última funcionalidad que necesitas conocer es <literal>${shlibs:Depends}</literal>,<literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates shared library dependencies for binary packages.  It generates a list of <ulink url="&elf;">ELF</ulink> executables and shared libraries it has found for each binary package.  This list is used for substituting <literal>${shlibs:Depends}</literal>.
es: Después de que tu paquete se compile y se instale en el directorio temporal, <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> lo escaneará en busca de binarios y bibliotecas para determinar las dependencias de bibliotecas compartidas. Esta lista se utiliza para la sustitución de <literal>${shlibs:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates Perl dependencies.  It generates a list of a dependencies on <literal>perl</literal> or <literal>perlapi</literal> for each binary package.  This list is used for substituting <literal>${perl:Depends}</literal>.
es: La orden <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> genera las dependencias de Perl. Genera la lista de dependencias de <literal>perl</literal> o <literal>perlapi</literal> para cada paquete binario. Esta lista es utilizada para substituir a <literal>${perl:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: Some <systemitem role="package">debhelper</systemitem> commands may cause the generated package to depend on some additional packages.  All such commands generate a list of required packages for each binary package.  This list is used for substituting <literal>${misc:Depends}</literal>.
es: Algunas órdenes de <systemitem role="package">debhelper</systemitem> determinan las dependencias de los paquetes listados anteriormente. Cada orden generar una lista de los paquetes necesarios para cada paquete binario. La lista de estos paquetes se usará para substituir a <literal>${misc:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> generates <filename>DEBIAN/control</filename> for each binary package while substituting <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
es: La orden <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> genera el archivo <filename>DEBIAN/control</filename> para cada paquete binario substituyendo <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.

note: type: Content of: <book><chapter><section><para>
en: Having said all that, we can leave the <literal>Depends</literal> field exactly as it is now, and insert another line after it saying <literal>Suggests: file</literal>, because <systemitem role="package">gentoo</systemitem> can use some features provided by the <systemitem role="package">file</systemitem> package.
es: Después de decir todo esto, podemos dejar la línea de <literal>Depends</literal> exactamente como está ahora e insertar otra línea tras ésta con el texto <literal>Suggests: file</literal>, porque <systemitem role="package">gentoo</systemitem> utiliza algunas funciones proporcionadas por el paquete/programa <systemitem role="package">file</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the Homepage URL.  Let's assume this to be at <ulink url="&gentoo;"/>.
es: La línea 9 es la dirección URL del programa. Supongamos que es <ulink url="&gentoo;"/>.

note: type: Content of: <book><chapter><section><para>
en: Line 12 is the short description.  Terminals are conventionally 80 columns wide so this shouldn't be longer than about 60 characters.  I'll change it to <literal>fully GUI-configurable, two-pane X file manager</literal>.
es: La línea 12 es una descripción corta.  La mayor parte de los monitores (en realidad, de las terminales en modo de texto) de la gente son de 80 columnas de ancho, así que no debería tener más de 60 caracteres.  Cambiaré esto a <literal>fully GUI-configurable, two-pane X file manager</literal>. («Gestor de ficheros GTK+ completamente configurable por GUI»).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: These descriptions are in English.  Translations of these descriptions are provided by <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.
es: Las descripciones deben redactarse en inglés. Las traducciones de estas descripciones son proporcionados por <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 13 is where the long description goes.  This should be a paragraph which gives more details about the package.  Column 1 of each line should be empty.  There must be no blank lines, but you can put a single <literal>.</literal> (dot) in a column to simulate that.  Also, there must be no more than one blank line after the long description. <placeholder type="footnote" id="0"/>
es: La línea 13 es donde va la descripción larga del paquete. Debería ser al menos de un párrafo que dé más detalles del paquete. La primera columna de cada línea debería estar vacía. No puede haber líneas en blanco, pero puedes poner un <literal>.</literal> (punto) en una columna para simularlo. Tampoco debe haber más de una línea en blanco después de la descripción completa <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-bpp-vcs;">Debian Developer's Reference, 6.2.5. "Version Control System location"</ulink>.
es: Véase <ulink url="&devref-bpp-vcs;">Developer's Reference, 6.2.5.  "Version Control System location"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: We can insert <literal>Vcs-*</literal> fields to document the Version Control System (VCS) location between lines 6 and 7.  <placeholder type="footnote" id="0"/> Let's assume that the <systemitem role="package">gentoo</systemitem> package has its VCS located in the Debian Alioth Git Service at <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.
es: Vamos a añadir los campos <literal>Vcs-*</literal> para documentar la localización del sistema de control de versiones (VCS) entre las lineas 6 y 7 <placeholder type="footnote" id="0"/>. Se supone que el paquete <systemitem role="package">gentoo</systemitem> está alojado en el servicio «Debian Alioth Git» en <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.

note: type: Content of: <book><chapter><section><para>
en: Finally, here is the updated <filename>control</filename> file:
es: Aquí está el archivo <filename>control</filename> actualizado:

note: type: Content of: <book><chapter><section><title>
en: <filename>copyright</filename>
es: El archivo <filename>copyright</filename>

note: type: Content of: <book><chapter><section><para>
en: This file contains information about the copyright and license of the upstream sources.  <ulink url="&policy-copyright;">Debian Policy Manual, 12.5 "Copyright information"</ulink> dictates its content and <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> provides guidelines for its format.
es: Este fichero contiene la información sobre los recursos, licencia y derechos de autoría de las fuentes originales del paquete.  El formato no está definido en las normas, pero sí sus contenidos en <ulink url="&policy-copyright;">«Debian Policy Manual, 12.5 "Copyright information"</ulink> y <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> proporciona directrices sobre su formato.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> can give you a template <filename>copyright</filename> file.  Let's use the <literal>--copyright gpl2</literal> option here to get a template file for the <systemitem role="package">gentoo</systemitem> package released under GPL-2.
es: <command>dh_make</command> proporciona una plantilla para el archivo <filename>copyright</filename>.  Con la opción <literal>--copyright gpl2</literal> se consigue la plantilla para el paquete <systemitem role="package">gentoo</systemitem> con la licencia GPL-2.

note: type: Content of: <book><chapter><section><para>
en: In short, here's what <systemitem role="package">gentoo</systemitem>'s <filename>copyright</filename> file should look like:
es: En resumen, el archivo <filename>copyright</filename> del paquete <systemitem role="package">gentoo</systemitem> debería ser similar a esto:

note: type: Content of: <book><chapter><section><para>
en: Please follow the HOWTO provided by the ftpmasters and sent to debian-devel-announce: <ulink url="&howto-copyright;"/>.
es: Por favor, sigue el COMO redactado por «ftpmasters» y enviado a «debian-devel-announce»: <ulink url="&howto-copyright;"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>changelog</filename>
es: El archivo <filename>changelog</filename>

note: type: Content of: <book><chapter><section><para>
en: This is a required file, which has a special format described in <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>.  This format is used by <command>dpkg</command> and other programs to obtain the version number, revision, distribution, and urgency of your package.
es: Este es un fichero requerido, con un formato especial descrito en <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>. Este es el formato utilizado por <command>dpkg</command> y otros programas para obtener el número de versión, revisión, distribución y urgencia de tu paquete.

note: type: Content of: <book><chapter><section><para>
en: For you, it is also important, since it is good to have documented all changes you have done.  It will help people downloading your package to see whether there are issues with the package that they should know about.  It will be saved as <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> in the binary package.
es: Para ti es también importante, ya que es bueno tener documentados todos los cambios que hayas hecho.  Esto ayudará a las personas que se descarguen tu paquete para ver si hay temas pendientes en el paquete que deberían conocer de forma inmediata.  Se guardará como <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> en el paquete binario.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one, and this is what it looks like:
es: <command>dh_make</command> genera uno predeterminado, el cual es como sigue:

note: type: Content of: <book><chapter><section><para>
en: You will end up with something like this:
es: Terminarás con algo así:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: If you use the <literal>dch -r</literal> command to make this last change, please make sure to save the <filename>changelog</filename> file explicitly by the editor.
es: Si utiliza la orden <literal>dch -r</literal> para realizar este último cambio, asegúrese que guarda el archivo <filename>changelog</filename> explícitamente con el editor.

note: type: Content of: <book><chapter><section><para>
en: Once you are satisfied with all the changes and documented them in <filename>changelog</filename>, you should change the distribution value from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).  <placeholder type="footnote" id="0"/>
es: Cuando estés satisfecho con los cambios realizados y estén documentados en el fichero <filename>changelog</filename>, entonces cambie el nombre de la distribución de <literal>UNRELEASED</literal> a <literal>unstable</literal> (o bien a <literal>experimental</literal>). <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can read more about updating the <filename>changelog</filename> file later in <xref linkend="update"/>.
es: Puedes leer más sobre cómo actualizar el fichero <filename>changelog</filename> más adelante en <xref linkend="update"/> .

note: type: Content of: <book><chapter><section><title>
en: <filename>rules</filename>
es: El archivo <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><title>
en: Targets of the <filename>rules</filename> file
es: Objetivos del archivo <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink> explains the details.
es: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink> explica los detalles.

note: type: Content of: <book><chapter><section><section><para>
en: Every <filename>rules</filename> file, like any other <filename>Makefile</filename>, consists of several rules, each of which defines a target and how it is carried out.  <placeholder type="footnote" id="0"/> A new rule begins with its target declaration in the first column.  The following lines beginning with the TAB code (ASCII 9) specify the recipe for carrying out that target.  Empty lines and lines beginning with <literal>#</literal> (hash) are treated as comments and ignored.  <placeholder type="footnote" id="1"/>
es: Cada archivo <filename>rules</filename>, como cualquier otro archivo <filename>Makefile</filename>, se compone de varias reglas, cada una de ellas define el objetivo y cómo se ejecuta <placeholder type="footnote" id="0"/>. Cada nueva regla empieza con la declaración del objetivo en la primera columna. Las líneas siguientes empiezan con un código de tabulación (ASCII 9) y especifican cómo llevar a cabo ese objetivo. Las líneas en blanco o que empiezan con <literal>#</literal> se tratan como comentarios y se ignoran <placeholder type="footnote" id="1"/>.

note: type: Content of: <book><chapter><section><section><para>
en: Here is a simplified explanation of the targets:
es: A continuación se proporciona una explicación simplificada de los distintos objetivos.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>clean</literal> target: to clean all compiled, generated, and useless files in the build-tree.  (Required)
es: <literal>clean</literal> (obligatorio): elimina todos los archivos generados, compilados o innecesarios del árbol de directorios de las fuentes.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build</literal> target: to build the source into compiled programs and formatted documents in the build-tree.  (Required)
es: <literal>build</literal> (obligatorio): para la construcción de archivos compilados a partir de los archivos fuente o la construcción de documentos formateados.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-arch</literal> target: to build the source into arch-dependent compiled programs in the build-tree.  (Required)
es: objetivo <literal>build-arch</literal> (obligatorio): para la compilación de las fuentes en programas compilados (dependientes de la arquitectura) en el árbol de directorios de compilación.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-indep</literal> target: to build the source into arch-independent formatted documents in the build-tree.  (Required)
es: objetivo <literal>build-indep</literal> (obligatorio): para la compilación de las fuentes en documentos formateados (independientes de la arquitectura) en el árbol de directorios de compilación.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>install</literal> target: to install files into a file tree for each binary package under the <filename>debian</filename> directory.  If defined, <literal>binary*</literal> targets effectively depend on this target.  (Optional)
es: <literal>install</literal> (opcional): para la instalación en la estructura de directorios temporal bajo el directorio <filename>debian</filename> de los archivos para cada uno de los paquetes binarios.  Si existe el objetivo <literal>binary*</literal>, dependerá de este.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage</literal> as in <xref linkend="completebuild"/>.
es: Este objetivo es utilizado por <literal>dpkg-buildpackage</literal> como en <xref linkend="completebuild"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary</literal> target: to create all binary packages (effectively a combination of <literal>binary-arch</literal> and <literal>binary-indep</literal> targets).  (Required)<placeholder type="footnote" id="0"/>
es: <literal>binary</literal> (obligatorio): para la construcción de cada uno de los paquetes binarios (combinado con los objetivos <literal>binary-arch</literal> y <literal>binary-indep</literal>)  <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -B</literal> as in <xref linkend="autobuilder"/>.
es: Este objetivo es utilizado por <literal>dpkg-buildpackage -B</literal> como en <xref linkend="autobuilder"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-arch</literal> target: to create arch-dependent (<literal>Architecture: any</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
es: <literal>binary-arch</literal> (obligatorio): para la construcción de paquetes dependientes de la arquitectura (<literal>Architecture: any</literal>)  <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -A</literal>.
es: Este objetivo es utilizado por <literal>dpkg-buildpackage -A</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-indep</literal> target: to create arch-independent (<literal>Architecture: all</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
es: <literal>binary-indep</literal> (obligatorio): para la construcción de paquetes independientes de la arquitectura (<literal>Architecture: all</literal>) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>get-orig-source</literal> target: to obtain the most recent version of the original source package from an upstream archive.  (Optional)
es: <literal>get-orig-source</literal> (opcional): para obtener la versión más reciente de las fuentes originales desde el lugar de almacenaje del autor.

note: type: Content of: <book><chapter><section><section><para>
en: You are probably overwhelmed by now, but things are much simpler upon examination of the <filename>rules</filename> file that <command>dh_make</command> gives us as a default.
es: Probablemente ya te hayas perdido, pero todo quedará más claro después de ver el fichero <filename>rules</filename> que <command>dh_make</command> pone por omisión.

note: type: Content of: <book><chapter><section><section><title>
en: Default <filename>rules</filename> file
es: Archivo <filename>rules</filename> predeterminado

note: type: Content of: <book><chapter><section><section><para>
en: Newer <command>dh_make</command> generates a very simple but powerful default <filename>rules</filename> file using the <command>dh</command> command:
es: La nueva versión de <command>dh_make</command> genera un archivo <filename>rules</filename> muy simple pero poderoso utilizando la orden <command>dh</command>:

note: type: Content of: <book><chapter><section><section><para>
en: (I've added the line numbers and trimmed some comments.  In the actual <filename>rules</filename> file, the leading spaces are a TAB code.)
es: (He añadido los números de línea y añadido algunos comentarios.  En el fichero <filename>debian/rules</filename> los espacios iniciales de las líneas son tabulaciones)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably familiar with lines like line 1 from shell and Perl scripts.  It tells the operating system that this file is to be processed with <filename>/usr/bin/make</filename>.
es: Probablemente estés familiarizado con líneas como la primera de guiones escritos en shell o Perl.  Esta línea indica que el fichero debe ejecutarse con<filename>/usr/bin/make</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: Line 4 can be uncommented to set the <literal>DH_VERBOSE</literal> variable to 1, so that the <command>dh</command> command outputs which <command>dh_*</command> commands it is executing.  You can also add a line <literal>export DH_OPTIONS=-v</literal> here, so that each <command>dh_*</command> command outputs which commands it is executing.  This helps you to understand exactly what is going on behind this simple <filename>rules</filename> file and to debug its problems.  This new <command>dh</command> is designed to form a core part of the <systemitem role="package">debhelper</systemitem> tools, and not to hide anything from you.
es: La linea 4 debe descomentarse para asignar el valor 1 a la variable <literal>DH_VERBOSE</literal>. Entonces, la orden <command>dh</command> mostrará (en el terminal) las órdenes <command>dh_*</command> ejecutadas por <command>dh</command>. Puedes añadir la linea <literal>export DH_OPTIONS=-v</literal> aquí. Así podrás ver la salida de la ejecución de cada orden <command>dh_*</command> y solucionar los problemas que se produzcan. Esto te ayudará a entender como funciona el archivo <filename>rules</filename> y a solucionar problemas. Esta nueva orden <command>dh</command> es parte fundamental de las herramientas <systemitem role="package">debhelper</systemitem> y no te esconde nada.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules clean</literal> runs <literal>dh clean</literal>, which in turn runs the following:
es: <literal>debian/rules clean</literal> ejecuta <literal>dh clean</literal>, que a su vez ejecuta lo siguiente:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: The following example assumes your <filename>debian/compat</filename> has a value equal or more than 9 to avoid invoking any python support commands automatically.
es: El siguiente ejemplo presupone que su fichero <filename>debian/compat</filename> tiene un valor igual o superior a 9 para evitar invocar cualquier orden «python» automáticamente.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: For complete information on what all these <command>dh_*</command> scripts do exactly, and what their other options are, please read their respective manual pages and the <systemitem role="package">debhelper</systemitem> documentation.
es: Para una descripción completa de la función de cada guión <command>dh_*</command> y de sus opciones, lee los manuales respectivos así como la documentación de <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><section><para>
en: The functions of <command>dh_*</command> commands are largely self-evident from their names.  <placeholder type="footnote" id="0"/> There are a few notable ones that are worth giving (over)simplified explanations here assuming a typical build environment based on a <filename>Makefile</filename>: <placeholder type="footnote" id="1"/>
es: La función de las órdenes <command>dh_*</command> puede deducirse de su nombre <placeholder type="footnote" id="0"/>.  A continuación se resume las funciones de las órdenes más importantes asumiendo que se utiliza un sistema de compilación basado en un archivo <filename>Makefile</filename> <placeholder type="footnote" id="1"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>distclean</literal>, <literal>realclean</literal>, or <literal>clean</literal>, and executes that.
es: En realidad busca el primer objetivo <literal>distclean</literal>, <literal>realclean</literal> o <literal>clean</literal> disponible en el <filename>Makefile</filename> y lo ejecuta.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_clean</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>distclean</literal> target.  <placeholder type="footnote" id="0"/>
es: <command>dh_auto_clean</command> normalmente ejecuta lo siguiente, siempre que exista un fichero <filename>Makefile</filename> con el objetivo <literal>distclean</literal><placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_configure</command> usually executes the following if <filename>./configure</filename> exists (arguments abbreviated for readability).
es: <command>dh_auto_configure</command> ejecuta lo siguiente si existe el archivo <filename>./configure</filename> (se han abreviado los argumentos para facilitar la lectura).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_build</command> usually executes the following to execute the first target of <filename>Makefile</filename> if it exists.
es: <command>dh_auto_build</command> ejecuta lo siguiente para ejecutar el primer objetivo del archivo <filename>Makefile</filename> (supuesto que este existe).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>test</literal> or <literal>check</literal>, and executes that.
es: En realidad busca el primero de los objetivos <literal>test</literal> o <literal>check</literal> en el archivo <filename>Makefile</filename> y lo ejecuta.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_test</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>test</literal> target.  <placeholder type="footnote" id="0"/>
es: <command>dh_auto_test</command> ejecuta lo siguiente si existe el objetivo <literal>test</literal> en el archivo <filename>Makefile</filename> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_install</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>install</literal> target (line folded for readability).
es: <command>dh_auto_install</command> ejecuta lo siguiente si en el archivo <filename>Makefile</filename> existe el objetivo <literal>install</literal> (se ha truncado la linea para permitir su lectura).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><screen>
en: make install \
      DESTDIR=<replaceable>/path/to</replaceable>/<replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>/debian/<replaceable>package</replaceable>
es: make install \
      DESTDIR=<replaceable>/ruta/a</replaceable>/<replaceable>paquete</replaceable>_<replaceable>versión</replaceable>-<replaceable>revisión</replaceable>/debian/<replaceable>paquete</replaceable>

note: type: Content of: <book><chapter><section><section><para>
en: All targets which require the <command>fakeroot</command> command will contain <command>dh_testroot</command>, which exits with an error if you are not using this command to pretend to be root.
es: Los objetivos que deben ejecutarse con la orden <command>fakeroot</command> contienen <command>dh_testroot</command>.  Si no utilizas la orden para simular la ejecución por el usuario «root», se producirá un error que detendrá la ejecución.

note: type: Content of: <book><chapter><section><section><para>
en: The important part to know about the <filename>rules</filename> file created by <command>dh_make</command> is that it is just a suggestion.  It will work for most packages but for more complicated ones, don't be afraid to customize it to fit your needs.
es: Es importante tener presente que el archivo <filename>rules</filename> que genera <command>dh_make</command> es sólo una sugerencia.  Será suficiente para la mayoría de los paquetes simples, pero no dejes de adaptarlo a tus necesidades en paquetes más complejos.

note: type: Content of: <book><chapter><section><section><para>
en: Although <literal>install</literal> is not a required target, it is supported.  <literal>fakeroot dh install</literal> behaves like <literal>fakeroot dh binary</literal> but stops after <command>dh_fixperms</command>.
es: A pesar de que <literal>install</literal> no es un objetivo obligatorio, se admite su uso.  <literal>fakeroot dh install</literal> se comporta como <literal>fakeroot dh binary</literal> pero se detiene después de <command>dh_fixperms</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Customization of <filename>rules</filename> file
es: Personalización del archivo <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para>
en: There are many ways to customize the <filename>rules</filename> file created with the new <command>dh</command> command.
es: Puedes realizar muchos cambios para adaptar el archivo <filename>rules</filename> construido por la orden <command>dh</command>.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: If a package installs the <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>custom_name</replaceable>.pm</filename> file, you should activate its customization function by <literal>dh $@ --with <replaceable>custom-name</replaceable></literal>.
es: Si un paquete instala el archivo <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>nombre_personalizado</replaceable>.pm</filename> puedes activar la función adaptada con <literal>dh $@ --with <replaceable>nombre_personalizado</replaceable></literal>.

note: type: Content of: <book><chapter><section><section><para>
en: The <literal>dh $@</literal> command can be customized as follows: <placeholder type="footnote" id="0"/>
es: La orden <literal>dh $@</literal> permite las siguientes adaptaciones <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: Use of the <command>dh_python2</command> command is preferred over use of <command>dh_pysupport</command> or <command>dh_pycentral</command> commands.  Do not use the <command>dh_python</command> command.
es: Es preferible el uso de la orden <command>dh_python2</command> respecto a la orden <command>dh_pysupport</command> u <command>dh_pycentral</command>.  No uses la orden <command>dh_python</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_python2</command> command.  (The best choice for Python.) <placeholder type="footnote" id="0"/>
es: Añadir la orden <command>dh_python2</command> (la mejor opción para Python) <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">python</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python2</literal>.
es: Utiliza <literal>dh $@ --with python2</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python</systemitem> framework.
es: Esto gestiona el módulo Python utilizando las funcionalidades de <systemitem role="package">python</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pysupport</command> command. (deprecated)
es: Añadir la orden <command>pysupport</command>. (obsoleto)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-support</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">python-support</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with pysupport</literal>.
es: Utiliza <literal>dh $@ --with pysupport</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-support</systemitem> framework.
es: Esto gestiona el módulo Python utilizando las funcionalidades de <systemitem role="package">python-support</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pycentral</command> command. (deprecated)
es: Añadir la orden <command>dh_pycentral</command>. (obsoleto)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-central</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">python-central</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python-central</literal> instead.
es: Utiliza <literal>dh $@ --with python-central</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This also deactivates the <command>dh_pysupport</command> command.
es: Esto desactiva la orden <command>dh_pysupport</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-central</systemitem> framework.
es: Esto gestiona el módulo Python utilizando las funcionalidades de <systemitem role="package">python-central</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_installtex</command> command.
es: Añadir la orden <command>dh_installtex</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">tex-common</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">tex-common</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with tex</literal> instead.
es: Utiliza <literal>dh $@ --with tex</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This registers Type 1 fonts, hyphenation patterns, and formats with TeX.
es: Esto registra el tipo de letra «Type 1», los patrones de separación de palabras («hyphenation patterns») o los formatos TeX.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands.
es: Añadir las órdenes <command>dh_quilt_patch</command> y <command>dh_quilt_unpatch</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">quilt</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">quilt</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with quilt</literal> instead.
es: Utiliza <literal>dh $@ --with quilt</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This applies and un-applies patches to the upstream source from files in the <filename>debian/patches</filename> directory for a source package in the <literal>1.0</literal> format.
es: Esto aplica o revierte los parches en los archivos de las fuentes originales, basándose en los ficheros del directorio <filename>debian/patches</filename> en los paquetes con el formato <literal>1.0</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This is not needed if you use the new <literal>3.0 (quilt)</literal> source package format.
es: Esta adaptación no es necesaria para los paquetes con el nuevo formato <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_dkms</command> command.
es: Añadir la orden <command>dh_dkms</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dkms</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">dkms</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with dkms</literal> instead.
es: Utiliza <literal>dh $@ --with dkms</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This correctly handles DKMS usage by kernel module packages.
es: Esto controla correctamente el uso de DKMS en la construcción de paquetes del núcleo.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autotools-dev_updateconfig</command> and <command>dh_autotools-dev_restoreconfig</command> commands.
es: Añadir las ordenes <command>dh_autotools-dev_updateconfig</command> y <command>dh_autotools-dev_restoreconfig</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">autotools-dev</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">autotools-dev</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autotools-dev</literal> instead.
es: Utiliza <literal>dh $@ --with autotools-dev</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates and restores <filename>config.sub</filename> and <filename>config.guess</filename>.
es: Esto actualiza y restaura <filename>config.sub</filename> y <filename>config.guess</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autoreconf</command> and <command>dh_autoreconf_clean</command> commands.
es: Añadir la orden <command>dh_autoreconf</command> y <command>dh_autoreconf_clean</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dh-autoreconf</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">dh-autoreconf</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autoreconf</literal> instead.
es: Utiliza <literal>dh $@ --with autoreconf</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates the GNU Build System files and restores them after the build.
es: Así se actualiza los archivos del sistema de compilación GNU y los restaura después de la compilación.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_girepository</command> command.
es: Añadir la orden <command>dh_girepository</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">gobject-introspection</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">gobject-introspection</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with gir</literal> instead.
es: Utiliza <literal>dh $@ --with gir</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This computes dependencies for packages shipping GObject introspection data and generates the <literal>${gir:Depends}</literal> substitution variable for the package dependency.
es: Esto calcula las dependencias de paquetes de envío de datos de introspección de «GObject» y genera la substitución de la variable <literal>${gir:Depends}</literal> por las dependencias del paquete.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>bash</command> completion feature.
es: Añadir la funcionalidad de autocompletar a <command>bash</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">bash-completion</systemitem> package in <literal>Build-Depends</literal>.
es: Añade el paquete <systemitem role="package">bash-completion</systemitem> en el campo <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with bash-completion</literal> instead.
es: Utiliza <literal>dh $@ --with bash-completion</literal> en su lugar.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This installs <command>bash</command> completions using a configuration file at <filename>debian/<replaceable>package</replaceable>.bash-completion</filename>.
es: Esto instala la función autocompletar de <command>bash</command> utilizando el archivo de configuración de <filename>debian/<replaceable>nombre_del_paquete</replaceable>.bash-completion</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: Many <command>dh_*</command> commands invoked by the new <command>dh</command> command can be customized by the corresponding configuration files in the <filename>debian</filename> directory.  See <xref linkend="dother"/> and the manpage of each command for the customization of such features.
es: Muchas de las órdenes <command>dh_*</command> invocadas por la nueva orden <command>dh</command> son personalizables mediante sus archivos de configuración en el directorio <filename>debian</filename>.  Véase <xref linkend="dother"/> y los manuales (las «manpage») para cada orden.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Under <literal>lenny</literal>, if you wanted to change the behavior of a <command>dh_*</command> script you found the relevant line in the <filename>rules</filename> file and adjusted it.
es: En <literal>lenny</literal>, cuando querías cambiar el comportamiento de un programa <command>dh_*</command> tenías que encontrar la línea adecuada en el archivo <filename>rules</filename> y cambiarla.

note: type: Content of: <book><chapter><section><section><para>
en: You may need to run <command>dh_*</command> commands invoked via the new <command>dh</command> with added arguments, or to run additional commands with them, or to skip them.  For such cases, you create an <literal>override_dh_<replaceable>foo</replaceable></literal> target with its rule in the <filename>rules</filename> file defining an <literal>override_dh_<replaceable>foo</replaceable></literal> target for the <command>dh_<replaceable>foo</replaceable></command> command you want to change.  It basically says <emphasis>run me instead</emphasis>.  <placeholder type="footnote" id="0"/>
es: Algunas órdenes <command>dh_*</command> invocadas por la nueva orden <command>dh</command> pueden precisar la adición de argumentos (opciones), la ejecución de órdenes adicionales u omitirlas del todo.  Para estos casos, deberás añadir el objetivo <literal>override_dh_<replaceable>nombre_de_la_orden</replaceable></literal> con las reglas a ejecutar en el archivo <filename>rules</filename> sólo para la orden <command>dh_<replaceable>nombre_de_la_orden</replaceable></command> que vas a cambiar.  Se trata de decir <emphasis>ejecútame a mí en su lugar</emphasis> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><para>
en: Please note that the <command>dh_auto_*</command> commands tend to do more than what has been discussed in this (over)simplified explanation to take care of all the corner cases.  It is a bad idea to use <literal>override_dh_*</literal> targets to substitute simplified equivalent commands (except for the <literal>override_dh_auto_clean</literal> target) since it may bypass such smart <systemitem role="package">debhelper</systemitem> features.
es: Las ordenes <command>dh_auto_*</command> hacen más cosas que las expuestas aquí.  El uso de ordenes equivalentes más sencillas en lugar de éstas en los objetivos <literal>override_dh_*</literal> (excepto el objetivo <literal>override_dh_auto_clean</literal>) es una mala idea ya que puede eliminar funciones inteligentes de <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><section><para>
en: So, for instance, if you want to store system configuration data in the <filename>/etc/gentoo</filename> directory instead of the usual <filename>/etc</filename> directory for the recent <systemitem role="package">gentoo</systemitem> package using Autotools, you can override the default <literal>--sysconfig=/etc</literal> argument given by the <command>dh_auto_configure</command> command to the <command>./configure</command> command by the following:
es: Si vas a guardar los datos de configuración del paquete <systemitem role="package">gentoo</systemitem> en el directorio <filename>/etc/gentoo</filename> en lugar del directorio habitual <filename>/etc</filename>, debes anular la ejecución del argumento predeterminado <literal>--sysconfig=/etc</literal> de la orden <command>dh_auto_configure</command> por <command>./configure</command> con lo siguiente:

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <command>dh_auto_build</command> without any arguments will execute the first target in the <filename>Makefile</filename>.
es: <command>dh_auto_build</command> sin argumentos ejecutará el primer objetivo del archivo <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify <literal>build</literal> as its target to build it <placeholder type="footnote" id="0"/>, you create an <literal>override_dh_auto_build</literal> target to enable this.
es: Si el <filename>Makefile</filename> de las fuentes de <systemitem role="package">gentoo</systemitem> requiere la especificación del objetivo <literal>build</literal> para compilarlo <placeholder type="footnote" id="0"/>, puedes añadir un objetivo <literal>override_dh_auto_build</literal> para anularlo.

note: type: Content of: <book><chapter><section><section><para>
en: This ensures <literal>$(MAKE)</literal> is run with all the default arguments given by the <command>dh_auto_build</command> command plus the <literal>build</literal> argument.
es: De esta forma se garantiza la ejecución de <literal>$(MAKE)</literal> con todos los argumentos predeterminados dados por la orden <command>dh_auto_build</command> y del argumento <literal>build</literal>.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify the <literal>packageclean</literal> target to clean it for the Debian package instead of using <literal>distclean</literal> or <literal>clean</literal> targets, you can create an <literal>override_dh_auto_clean</literal> target to enable it.
es: Si el <filename>Makefile</filename> de las fuentes de <systemitem role="package">gentoo</systemitem> requiere la especificación del objetivo <literal>packageclean</literal> para limpiarlo, en lugar de los objetivos <literal>distclean</literal> o <literal>clean</literal> en el archivo <filename>Makefile</filename>, puedes añadir un objetivo <literal>override_dh_auto_clean</literal> para habilitarlo.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> contains a <literal>test</literal> target which you do not want to run for the Debian package building process, you can use an empty <literal>override_dh_auto_test</literal> target to skip it.
es: Si el <filename>Makefile</filename> de las fuentes de <systemitem role="package">gentoo</systemitem> contiene un objetivo <literal>test</literal> que no deseas que se ejecute en la construcción del paquete Debian, puedes usar un objetivo <literal>override_dh_auto_test</literal> sin órdenes para ignorarlo.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: The <filename>debian/changelog</filename> and <filename>debian/NEWS</filename> files are always automatically installed.  The upstream changelog is found by converting filenames to lower case and matching them against <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, and <filename>changes.txt</filename>.
es: Los archivos <filename>debian/changelog</filename> y <filename>debian/NEWS</filename> siempre se instalan automáticamente.  También se busca el archivo de cambios del autor para cambiar el nombre a minúsculas y por su coincidencia con <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, y <filename>changes.txt</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: If <systemitem role="package">gentoo</systemitem> has an unusual upstream changelog file called <filename>FIXES</filename>, <command>dh_installchangelogs</command> will not install that file by default.  The <command>dh_installchangelogs</command> command requires <filename>FIXES</filename> as its argument to install it.  <placeholder type="footnote" id="0"/>
es: Si <systemitem role="package">gentoo</systemitem> contiene el poco frecuente archivo de cambios del autor con el nombre <filename>FIXES</filename>, <command>dh_installchangelogs</command> no lo instalará por omisión.  La orden <command>dh_installchangelogs</command> requiere como argumento <filename>FIXES</filename> para instalarlo <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><para>
en: When you use the new <command>dh</command> command, use of explicit targets such as the ones listed in <xref linkend="targets"/>, other than the <literal>get-orig-source</literal> target, may make it difficult to understand their exact effects.  Please limit explicit targets to <literal>override_dh_*</literal> targets and completely independent ones, if possible.
es: Cuando utilizas el nuevo programa <command>dh</command>, la utilización explícita de objetivos como los listados en <xref linkend="targets"/> (excepto <literal>get-orig-source</literal>) puede dificultar la correcta comprensión de sus efectos exactos.  Por favor, limita el uso de objetivos explícitos a objetivos del tipo <literal>override_dh_*</literal> y de forma que sean completamente independientes entre sí (siempre que sea posible).

note: type: Content of: <book><chapter><title>
en: Other files under the <filename>debian</filename> directory
es: Otros ficheros en el directorio <filename>debian</filename>.

note: type: Content of: <book><chapter><para>
en: To control most of what <systemitem role="package">debhelper</systemitem> does while building the package, you put optional configuration files under the <filename>debian</filename> directory.  This chapter will provide an overview of what each of these does and its format.  Please read the <ulink url="&debian-policy;">Debian Policy Manual</ulink> and <ulink url="&developers-reference;">Debian Developer's Reference</ulink> for guidelines for packaging.
es: Para controlar el trabajo de <systemitem role="package">debhelper</systemitem> en la compilación del paquete, puedes añadir archivos de configuración en el directorio <filename>debian</filename>.  En este capítulo se resumirá lo que puede hacerse con cada uno de ellos y su formato.  Por favor, lee <ulink url="&debian-policy;">«Debian Policy Manual»</ulink> y <ulink url="&developers-reference;">«Debian Developer's Reference»</ulink> para más información.

note: type: Content of: <book><chapter><para>
en: Some template configuration files for <systemitem role="package">debhelper</systemitem> may not be created by the <command>dh_make</command> command.  In such cases, you need to create them with an editor.
es: En otros casos, <command>dh_make</command> no puede construir plantillas de configuración para <systemitem role="package">debhelper</systemitem>.  En estos casos, deberás construir tu mismo los archivos con un editor.

note: type: Content of: <book><chapter><para>
en: If you wish or need to activate any of these, please do the following:
es: Si quieres utilizar estos archivos en la construcción de tu paquete, haz lo siguiente.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: rename the configuration files to use the actual binary package name in place of <literal><replaceable>package</replaceable></literal>;
es: renombra los archivos de configuración utilizando el nombre del archivo del paquete binario en lugar de <literal><replaceable>nombre_del_paquete</replaceable></literal>.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify template file contents to suit your needs;
es: modifica el contenido de los archivos de plantilla para adaptarlos a tus necesidades.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: remove template files which you do not need;
es: elimina aquellos archivos que no necesites.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>control</filename> file (see <xref linkend="control"/>), if necessary;
es: realiza las modificaciones necesarias en el archivo <filename>control</filename> (véase <xref linkend="control"/>), si es necesario.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>rules</filename> file (see <xref linkend="rules"/>), if necessary.
es: modifica el archivo <filename>rules</filename> (véase <xref linkend="rules"/> ), si es necesario.

note: type: Content of: <book><chapter><para>
en: Any <systemitem role="package">debhelper</systemitem> configuration files without a <filename><replaceable>package</replaceable></filename> prefix, such as <filename>install</filename>, apply to the first binary package.  When there are many binary packages, their configurations can be specified by prefixing their name to their configuration filenames such as <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
es: Los archivos de configuración construidos por <systemitem role="package">debhelper</systemitem> que no tienen el prefijo <filename><replaceable>nombre_del_paquete</replaceable></filename> tales como <filename>install</filename> se aplicaran al primer paquete binario.  Si hay varios paquetes binarios,  sus configuraciones se especificaran con el prefijo de paquete binario correspondiente en su nombre: así tendrás los archivos <filename><replaceable>paquete-1</replaceable>.install</filename>, <filename><replaceable>paquete-2</replaceable>.install</filename>, etc.

note: type: Content of: <book><chapter><section><title>
en: <filename>README.Debian</filename>
es: Archivo <filename>README.Debian</filename> (LÉEME.debian)

note: type: Content of: <book><chapter><section><para>
en: Any extra details or discrepancies between the original package and your Debian version should be documented here.
es: Cualquier detalle extra o discrepancias entre el programa original y su versión debianizada debería documentarse aquí.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one; this is what it looks like:
es: <command>dh_make</command> construye uno predeterminado, y éste es su aspecto:

note: type: Content of: <book><chapter><section><para>
en: If you have nothing to be documented, remove this file.  See <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
es: Dado que no tenemos que poner nada aquí, elimínalo.Véase <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>compat</filename>
es: Archivo <filename>compat</filename>

note: type: Content of: <book><chapter><section><title>
en: <filename>conffiles</filename>
es: Archivo <filename>conffiles</filename>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <ulink url="&policy-conffiles;">Debian Policy Manual, "D.2.5 Conffiles"</ulink>.
es: Véase <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <ulink url="&policy-conffiles;">Debian Policy Manual, "D.2.5 Conffiles"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: One of the most annoying things about software is when you spend a great deal of time and effort customizing a program, only to have an upgrade stomp all over your changes.  Debian solves this problem by marking such configuration files as conffiles.  <placeholder type="footnote" id="0"/> When you upgrade a package, you'll be asked whether you want to keep your old configuration files or not.
es: Una de las cosas más molestas de los programas es cuando pasas mucho tiempo y esfuerzo adaptando un programa (como usuario) y una actualización destroza todos tus cambios. Debian resuelve este problema marcando los ficheros de configuración.  <placeholder type="footnote" id="0"/> Así, cuando actualizas un paquete se te pregunta si deseas mantener la nueva configuración o no.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry><refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> <emphasis>automatically</emphasis> flags any files under the <filename>/etc</filename> directory as conffiles, so if your program only has conffiles there you do not need to specify them in this file.  For most package types, the only place conffiles should ever be is under <filename>/etc</filename>, and so this file doesn't need to exist.
es: Desde la versión 3 de <systemitem role="package">debhelper</systemitem>, <citerefentry> <refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> considera <emphasis>automáticamente</emphasis> a todos los archivos ubicados en el directorio <filename>/etc</filename> como «conffiles» (archivos de configuración gestionados por el sistema de paquetes).  Así, si todos los «conffiles» están en este directorio no es necesario que los incluyas en este archivo.  Para la mayoría de paquetes, la única ubicación de los «conffiles» es <filename>/etc</filename> por lo que no es necesario generar este archivo.

note: type: Content of: <book><chapter><section><para>
en: If your program uses configuration files but also rewrites them on its own, it's best not to make them conffiles because <command>dpkg</command> will then prompt users to verify the changes all the time.
es: En el caso de que tu programa utilice ficheros de configuración pero también los reescriba él mismo es mejor no marcarlos como «conffiles».  Si lo haces, <command>dpkg</command> informará a los usuarios que verifiquen los cambios de estos ficheros cada vez que lo actualicen.

note: type: Content of: <book><chapter><section><para>
en: If the program you're packaging requires every user to modify the configuration files in the <filename>/etc</filename> directory, there are two popular ways to arrange for them to not be conffiles, keeping <command>dpkg</command> quiet:
es: Si el programa que estás empaquetando requiere que cada usuario modifique los archivos de configuración del directorio <filename>/etc</filename>, hay dos formas para no marcarlos como archivos «conffiles» y que no sean manipulados por <command>dpkg</command>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a symlink under the <filename>/etc</filename> directory pointing to a file under the <filename>/var</filename> directory generated by the maintainer scripts.
es: Construir un enlace simbólico de los archivos ubicados en <filename>/etc</filename> que apunten a archivos ubicados en el directorio <filename>/var</filename> generados por <emphasis>guiones del desarrollador</emphasis> («maintainer scripts»).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a file generated by the maintainer scripts under the <filename>/etc</filename> directory.
es: Poner los archivos generados por los <emphasis>guiones del desarrollador</emphasis> en el directorio <filename>/etc</filename>.

note: type: Content of: <book><chapter><section><para>
en: For information on maintainer scripts, see <xref linkend="maintscripts"/>.
es: Para más información sobre los <emphasis>guiones del desarrollador</emphasis> véase <xref linkend="maintscripts"/> .

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.cron.*</filename>
es: Archivos <filename><replaceable>nombre_del_paquete</replaceable>.cron.*</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package requires regularly scheduled tasks to operate properly, you can use these files to set that up.  You can set up regular tasks that either happen hourly, daily, weekly, or monthly, or alternatively happen at any other time that you wish.  The filenames are:
es: Si tu paquete requiere tareas periódicas para funcionar adecuadamente, puedes usar este fichero como patrón.  Puedes establecer la realización de tareas que se ejecuten cada hora, día, semana, mes, o en cualquier otro período de tiempo.  Los nombres de los archivos son:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.hourly</filename> - Installed as <filename>/etc/cron.hourly/<replaceable>package</replaceable></filename>; run once an hour.
es: <filename><replaceable>nombre_del_paquete</replaceable>.cron.hourly</filename> - instalados como <filename>/etc/cron.hourly/<replaceable>nombre_del_paquete</replaceable></filename>: se ejecutan cada hora.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.daily</filename> - Installed as <filename>/etc/cron.daily/<replaceable>package</replaceable></filename>; run once a day.
es: <filename><replaceable>nombre_del_paquete</replaceable>.cron.daily</filename> - instalados como <filename>/etc/cron.daily/<replaceable>nombre_del_paquete</replaceable></filename>: se ejecutan cada día, habitualmente por la mañana temprano.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.weekly</filename> - Installed as <filename>/etc/cron.weekly/<replaceable>package</replaceable></filename>; run once a week.
es: <filename><replaceable>nombre_del_paquete</replaceable>.cron.weekly</filename> - instalados como <filename>/etc/cron.weekly/<replaceable>nombre_del_paquete</replaceable></filename>: se ejecutan cada semana, habitualmente en la mañana del domingo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.monthly</filename> - Installed as <filename>/etc/cron.monthly/<replaceable>package</replaceable></filename>: run once a month.
es: <filename><replaceable>nombre_del_paquete</replaceable>.cron.hourly</filename> - instalados como <filename>/etc/cron.hourly/<replaceable>nombre_del_paquete</replaceable></filename>: se ejecutan cada hora.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.d</filename> - Installed as <filename>/etc/cron.d/<replaceable>package</replaceable></filename>: for any other time.
es: <filename><replaceable>nombre_del_paquete</replaceable>.cron.d</filename> - instalados como <filename>/etc/cron.d/<replaceable>package</replaceable></filename>: para cualquier otro período de tiempo.

note: type: Content of: <book><chapter><section><para>
en: Most of these files are shell scripts, with the exception of <filename><replaceable>package</replaceable>.cron.d</filename> which follows the format of <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.
es: Para los archivos mencionados, su formato es el de guiones «shell».  La única excepción son los archivos <filename><replaceable>nombre_del_paquete</replaceable>.cron.d</filename> que deben ajustarse al formato descrito en <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: No explicit <filename>cron.*</filename> file is needed to set up log rotation; for that, see <citerefentry><refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum></citerefentry> and <citerefentry><refentrytitle>logrotate</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
es: No es necesario determinar un archivo <filename>cron.*</filename> para configurar la rotación de registros, para hacer eso consulta <citerefentry> <refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> y <citerefentry> <refentrytitle>logrotate</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>dirs</filename>
es: Archivo <filename>dirs</filename>

note: type: Content of: <book><chapter><section><para>
en: This file specifies any directories which we need but which are not created by the normal installation procedure (<literal>make install DESTDIR=...</literal> invoked by <literal>dh_auto_install</literal>).  This generally means there is a problem with the <filename>Makefile</filename>.
es: Este fichero especifica los directorios que se necesitan pero que por alguna razón no se crean en un proceso de instalación normal (<literal>make install DESTDIR=...</literal> invocado por <literal>dh_auto_install</literal>).  Generalmente es debido a un problema con el archivo <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Files listed in an <filename>install</filename> file don't need their directories created first.  See <xref linkend="install"/>.
es: Los archivos listados en el archivo <filename>install</filename> no requieren la construcción previa de los directorios.  Véase <xref linkend="install"/> .

note: type: Content of: <book><chapter><section><para>
en: It is best to try to run the installation first and only use this if you run into trouble.  There is no preceding slash on the directory names listed in the <filename>dirs</filename> file.
es: Es recomendable ejecutar en primer lugar la instalación y solo hacer uso de este archivo si se produce algún problema. No debe ponerse la barra inicial en los nombres de los directorios listados en el archivo <filename>dirs</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.doc-base</filename>
es: Archivo <filename><replaceable>nombre_del_paquete</replaceable>.doc-base</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has documentation other than manual and info pages, you should use the <systemitem role="package">doc-base</systemitem> file to register it, so the user can find it with e.g.  <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, or <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
es: Si tu paquete tiene documentación además de las páginas de manual y de información, puedes utilizar el archivo <systemitem role="package">doc-base</systemitem> para registrarla de modo que el usuario pueda encontrar esta documentación suplementaria con <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: This usually includes HTML, PS and PDF files, shipped in <filename>/usr/share/doc/<replaceable>packagename</replaceable>/</filename>.
es: La documentación incluirá archivos HTML, PS y PDF ubicados en <filename>/usr/share/doc/<replaceable>nombre_del_paquete</replaceable>/</filename>.

note: type: Content of: <book><chapter><section><para>
en: This is what <systemitem role="package">gentoo</systemitem>'s doc-base file <filename>gentoo.doc-base</filename> looks like:
es: A continuación se muestra cómo es el fichero doc-base de <systemitem role="package">gentoo</systemitem>, <filename>gentoo.doc-base</filename>:

note: type: Content of: <book><chapter><section><para>
en: For information on the file format, see <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and the Debian <systemitem role="package">doc-base</systemitem> manual at the local copy <filename>&doc-base;</filename> provided by the <systemitem role="package">doc-base</systemitem> package.
es: Para más información sobre el formato del archivo véase <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> y el manual Debian <systemitem role="package">doc-base</systemitem> en la copia local <filename>&doc-base;</filename> proporcionada por el paquete  <systemitem role="package">doc-base</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: For more details on installing additional documentation, look in <xref linkend="destdir"/>.
es: Para más detalles sobre la instalación de documentación adicional, lee <xref linkend="destdir"/> .

note: type: Content of: <book><chapter><section><title>
en: <filename>docs</filename>
es: Archivo <filename>docs</filename>

note: type: Content of: <book><chapter><section><para>
en: This file specifies the file names of documentation files we can have <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> install into the temporary directory for us.
es: Este fichero especifica los nombres de los ficheros de documentación que <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instalará en el directorio temporal.

note: type: Content of: <book><chapter><section><para>
en: By default, it will include all existing files in the top-level source directory that are called <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> etc.
es: Por omisión, se incluirán todos los archivos existentes en los directorios de más alto nivel del código con los nombres <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> etc.

note: type: Content of: <book><chapter><section><para>
en: For <systemitem role="package">gentoo</systemitem>, some other files are also included:
es: También incluiré algunos otros para <systemitem role="package">gentoo</systemitem>:

note: type: Content of: <book><chapter><section><screen>
en: BUGS
    CONFIG-CHANGES
    CREDITS
    NEWS
    README
    README.gtkrc
    TODO
es:   BUGS
      CONFIG-CHANGES
      CREDITS
      ONEWS
      README
      README.gtkrc
      TODO

note: type: Content of: <book><chapter><section><title>
en: <filename>emacsen-*</filename>
es: Archivo <filename>emacsen-*</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package supplies Emacs files that can be bytecompiled at package installation time, you can use these files to set it up.
es: Si tu paquete proporciona ficheros Emacs que pueden ser compilados a bytes («bytescompile») en el momento de la instalación, puedes usar estos ficheros.

note: type: Content of: <book><chapter><section><para>
en: They are installed into the temporary directory by <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
es: El programa <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instalará estos archivos en el directorio temporal .

note: type: Content of: <book><chapter><section><para>
en: If you don't need these, remove them.
es: Elimínalos si no los necesitas.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.examples</filename>
es: Archivo <filename><replaceable>nombre_del_paquete</replaceable>.examples</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs files and directories listed in this file as example files.
es: La orden <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instala los archivos y directorios listados en este archivo como archivos de ejemplos.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.init</filename> and <filename><replaceable>package</replaceable>.default</filename>
es: Archivos <filename><replaceable>nombre_del_paquete</replaceable>.init</filename> y <filename><replaceable>nombre_del_paquete</replaceable>.default</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package is a daemon that needs to be run at system start-up, you've obviously disregarded my initial recommendation, haven't you? :-)
es: Si tu paquete es un demonio que necesita ejecutarse en el arranque del sistema, obviamente has desatendido mi recomendación inicial, ¿o no? :-)

note: type: Content of: <book><chapter><section><para>
en: If your upstream program provides a file for the init script, you can either use it or not.  If you don't use their init script then create a new one in <filename><replaceable>package</replaceable>.init</filename>.  However if the upstream init script looks fine and installs in the right place you still need to set up the <filename>rc*</filename> symlinks.  To do this you will need to override <command>dh_installinit</command> in the <filename>rules</filename> file with the following lines:
es: Si el programa original incluye un archivo <emphasis>guión init</emphasis>, tu puedes hacer uso de él o bien descartarlo. Si optas por no hacer uso del guión <emphasis>guión init </emphasis> original, deberás construir uno nuevo en <filename>debian/<replaceable>nombre_del_paquete</replaceable>.init</filename>. En cualquier caso deberás construir los enlaces simbólicos <filename>rc*</filename> aunque el <emphasis>guión init</emphasis> original parezca correcto y se instale en el lugar adecuado. Para ello, deberás reescribir el objetivo <command>dh_installinit</command> en el archivo <filename>rules</filename> con las siguientes líneas:

note: type: Content of: <book><chapter><section><para>
en: If you don't need this, remove the files.
es: Elimina el fichero si no lo necesitas.

note: type: Content of: <book><chapter><section><title>
en: <filename>install</filename>
es: Archivo <filename>install</filename>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This replaces the deprecated <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command which is configured by the <filename>files</filename> file.
es: Esto reemplaza la orden obsoleta <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> que se configuraba con el archivo <filename>files</filename>.

note: type: Content of: <book><chapter><section><para>
en: This <filename>install</filename> file has one line per file installed, with the name of the file (relative to the top build directory) then a space then the installation directory (relative to the install directory).  One example of where this is used is if a binary <filename>src/<replaceable>bar</replaceable></filename> is left uninstalled; the <filename>install</filename> file might look like:
es: El archivo <filename>install</filename> tendrá una línea para cada uno de los archivos a instalar, con el nombre del archivo (relativo al directorio superior de la compilación) seguido de un espacio y a continuación el directorio de instalación (relativo al directorio superior de instalación).  Suponiendo que el archivo binario <filename>src/<replaceable>archivo_binario</replaceable></filename> no se instalase, deberías utilizar el archivo <filename>install</filename> como sigue:

note: type: Content of: <book><chapter><section><screen>
en: src/<replaceable>bar</replaceable> usr/bin
es: src/<replaceable>archivo_binario</replaceable> usr/bin

note: type: Content of: <book><chapter><section><para>
en: This means when this package is installed, there will be an executable command <filename>/usr/bin/<replaceable>bar</replaceable></filename>.
es: Al instalarse el paquete, se instalará el archivo binario <filename>/usr/bin/nombre_archivo_binario</filename>.

note: type: Content of: <book><chapter><section><para>
en: Alternatively, this <filename>install</filename> can have the name of the file only without the installation directory when the relative directory path does not change.  This format is usually used for a large package that splits the output of its build into multiple binary packages using <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
es: En el archivo <filename>install</filename> puedes escribir el nombre del archivo sin el directorio de instalación siempre que no cambie la ruta relativa de directorio.  Este formato se usa en paquetes grandes que separan el resultado de la compilación en múltiples paquetes binarios haciendo uso de <filename><replaceable>nombre_del_paquete-1</replaceable>.install</filename>, <filename><replaceable>nombre_del_paquete-2</replaceable>.install</filename>, etc.

note: type: Content of: <book><chapter><section><para>
en: The <command>dh_install</command> command will fall back to looking in <filename>debian/tmp</filename> for files, if it doesn't find them in the current directory (or wherever you've told it to look using <literal>--sourcedir</literal>).
es: La orden <command>dh_install</command> retrocederá al directorio <filename>debian/tmp</filename> para buscar los archivos si no los encuentra en el directorio actual (o en la ubicación que hayas establecido para la búsqueda con <literal>--sourcedir</literal>).

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.info</filename>
es: Archivo <filename><replaceable>nombre_del_paquete</replaceable>.info</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has info pages, you should install them using <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.info</filename> file.
es: Si tu paquete utiliza páginas de información («info pages»), podrás instalarlas utilizando <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> que utilizará el listado del archivo <filename><replaceable>nombre_del_paquete</replaceable>.info</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.links</filename>
es: Archivo <filename><replaceable>nombre_del_paquete</replaceable>.links</filename>

note: type: Content of: <book><chapter><section><para>
en: If you need to create additional symlinks in package build directories as package maintainer, you should install them using <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing their full paths of source and destination files in a <filename><replaceable>package</replaceable>.links</filename> file.
es: Si es necesario generar enlaces simbólicos adicionales, como responsable del paquete, en los directorios de compilación del paquete, puedes instalarlos utilizando <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> haciendo una lista de las rutas completas de los ficheros de origen y de destino en un fichero <filename><replaceable>nombre_del_paquete</replaceable>.links</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>{<replaceable>package</replaceable>.,source/}lintian-overrides</filename>
es: Archivos <filename>{<replaceable>nombre_del_paquete</replaceable>.source/} lintian-overrides</filename>

note: type: Content of: <book><chapter><section><para>
en: <filename><replaceable>package</replaceable>.lintian-overrides</filename> is for the binary package named <systemitem role="package"><replaceable>package</replaceable></systemitem> and is installed into <filename>usr/share/lintian/overrides/<replaceable>package</replaceable></filename> by the <command>dh_lintian</command> command.
es: <filename><replaceable>nombre_del_paquete</replaceable>.lintian-overrides</filename> es para un paquete binario con el nombre <systemitem role="package"><replaceable>nombre_del_paquete</replaceable></systemitem> y es instalado en <filename>usr/share/lintian/overrides/<replaceable>nombre_del_paquete</replaceable></filename> por la orden <command>dh_lintian</command>.

note: type: Content of: <book><chapter><section><para>
en: <filename>source/lintian-overrides</filename> is for the source package.  This is not installed.
es: El archivo <filename>source/lintian-overrides</filename> es para los paquetes de fuentes y no se instala.

note: type: Content of: <book><chapter><section><title>
en: <filename>manpage.*</filename>
es: Archivos <filename>manpage.*</filename>

note: type: Content of: <book><chapter><section><para>
en: Your program(s) should have a manual page.  If they don't, you should create them.  The <command>dh_make</command> command creates some template files for manual pages.  These need to be copied and edited for each command missing its manual page.  Please make sure to remove unused templates.
es: El/los programa/s debería/n tener una página de manual.  Tendrás que escribirla si no existe.  La orden <command>dh_make</command> construye varios archivos de plantilla para las páginas de manual.  Deberás copiarlos y editarlos para cada programa que no tenga página de manual.  Asegúrate de eliminar los que no utilices.

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.1.ex</filename>
es: Archivo <filename>manpage.1.ex</filename>

note: type: Content of: <book><chapter><section><section><para>
en: Manual pages are normally written in <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  The <filename>manpage.1.ex</filename> template is written in <command>nroff</command>, too.  See the <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> manual page for a brief description of how to edit such a file.
es: Las páginas de manual se escriben normalmente con <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  La plantilla <filename>manpage.1.ex</filename> está escrita con <command>nroff</command>.  Consulta la página de manual <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> para una breve descripción sobre como editar el archivo.

note: type: Content of: <book><chapter><section><section><para>
en: The final manual page file name should give the name of the program it is documenting, so we will rename it from <literal>manpage</literal> to <literal>gentoo</literal>.  The file name also includes <literal>.1</literal> as the first suffix, which means it's a manual page for a user command.  Be sure to verify that this section is indeed the correct one.  Here's a short list of manual page sections:
es: El nombre del archivo de manual debería incluir el nombre del programa que está documentando, así que lo renombraremos de <literal>manpage</literal> a <literal>gentoo</literal>.  El nombre del fichero incluye también <literal>.1</literal> como primer sufijo, lo que significa que es una página de manual para una programa de usuario.  Asegúrate de verificar que esa sección es la correcta.  Aquí tienes una pequeña lista de las secciones de las páginas de manual.

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Section
es: Sección

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Description
es: Descripción

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Notes
es: Notas

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: User commands
es: Órdenes de usuario

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Executable commands or scripts
es: Órdenes ejecutables o guiones

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System calls
es: Llamadas del sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions provided by the kernel
es: Funciones proporcionadas por el núcleo

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Library calls
es: Llamadas a bibliotecas

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions within system libraries
es: Funciones de las bibliotecas del sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Special files
es: Archivos especiales

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Usually found in <filename>/dev</filename>
es: Por lo general se encuentran en <filename>/dev</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: File formats
es: Formatos de archivo

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: E.g. <filename>/etc/passwd</filename>'s format
es: p. ej. el formato de <filename>/etc/passwd</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games
es: Juegos

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games or other frivolous programs
es: Juegos y otros programas de entretenimiento

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Macro packages
es: Paquetes macro

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Such as <command>man</command> macros
es: Tales como macros <command>man</command>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System administration
es: Administración del sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Programs typically only run by root
es: Programas que sólo suele ejecutar el superusuario

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Kernel routines
es: Rutinas del núcleo

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Non-standard calls and internals
es: Llamadas al sistema no estándar e internas

note: type: Content of: <book><chapter><section><section><para>
en: So <systemitem role="package">gentoo</systemitem>'s man page should be called <filename>gentoo.1</filename>.  If there was no <filename>gentoo.1</filename> man page in the original source, you should create it by renaming the <filename>manpage.1.ex</filename> template to <filename>gentoo.1</filename> and editing it using information from the example and from the upstream docs.
es: Así que la página de manual de <systemitem role="package">gentoo</systemitem> debería nombrarse como <filename>gentoo.1</filename>.  No había una página de manual <filename>gentoo.1</filename> en el paquete fuente así que la escribí renombrando la plantilla <filename>manpage.1.ex</filename> como <filename>gentoo.1</filename> y modificándola usando la información del ejemplo y de los documentos del programador original.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Note that <command>help2man</command>'s placeholder man page will claim that more detailed documentation is available in the info system. If the command is missing an <command>info</command> page, you should manually edit the man page created by the <command>help2man</command> command.
es: Ten presente que el marcador de posición de páginas de manual <command>help2man</command> reclamará que la documentación más detallada se encuentra disponible en el sistema de información. Si el comando no encuentra una página <command>info</command>, deberás editar manualmente la página de manual construida por <command>help2man</command>.

note: type: Content of: <book><chapter><section><section><para>
en: You can use the <command>help2man</command> command to generate a man page out of the <literal>--help</literal> and <literal>--version</literal> output of each program, too.  <placeholder type="footnote" id="0"/>
es: Utiliza la orden <command>help2man</command> para generar la página de manual a partir de la información dada por «<literal>--help</literal>» y <literal>--version</literal>» para cada programa <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.sgml.ex</filename>
es: Archivo <filename>manpage.sgml.ex</filename>

note: type: Content of: <book><chapter><section><section><para>
en: If on the other hand you prefer writing SGML instead of <command>nroff</command>, you can use the <filename>manpage.sgml.ex</filename> template.  If you do this, you have to:
es: Por otro lado, puede que prefieras escribir usando SGML en lugar de <command>nroff</command>.  En este caso, puedes usar la plantilla <filename>manpage.sgml.ex</filename>.  Si haces esto, tendrás que:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the file to something like <filename>gentoo.sgml</filename>.
es: renombrar el fichero a algo como <filename>gentoo.sgml</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-to-man</systemitem> package
es: instalar el paquete <systemitem role="package">docbook-to-man</systemitem>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add <literal>docbook-to-man</literal> to the <literal>Build-Depends</literal> line in the <filename>control</filename> file
es: añadir <literal>docbook-to-man</literal> en el campo <literal>Build-Depends</literal> en el archivo <filename>control</filename>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add an <literal>override_dh_auto_build</literal> target to your <filename>rules</filename> file:
es: añadir el objetivo <literal>override_dh_auto_build</literal> en el fichero <filename>rules</filename>:

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.xml.ex</filename>
es: Archivo <filename>manpage.xml.ex</filename>

note: type: Content of: <book><chapter><section><section><para>
en: If you prefer XML over SGML, you can use the <literal>manpage.xml.ex</literal> template.  If you do this, you have to:
es: Si prefieres el formato XML en lugar de SGML, puedes utilizar la plantilla <literal>manpage.xml.ex</literal>.  En este caso debes:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the source file to something like <literal>gentoo.1.xml</literal>
es: renombrar el archivo a <literal>gentoo.1.xml</literal>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-xsl</systemitem> package and an XSLT processor like <systemitem role="package">xsltproc</systemitem> (recommended)
es: instalar el paquete <systemitem role="package">docbook-xsl</systemitem> y un procesador XSLT como <systemitem role="package">xsltproc</systemitem> (recomendado)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add the <literal>docbook-xsl</literal>, <literal>docbook-xml</literal>, and <literal>xsltproc</literal> packages to the <literal>Build-Depends</literal> line in the <literal>control</literal> file
es: añadir los paquetes <literal>docbook-xsl</literal>, <literal>docbook-xml</literal> y <literal>xsltproc</literal> en la línea de <literal>Build-Depends</literal> en el fichero de <literal>control</literal>

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.manpages</filename>
es: Archivo <filename><replaceable>nombre_del_paquete</replaceable>.manpages</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has manual pages, you should install them using <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.manpages</filename> file.
es: Si tu paquete tiene páginas de manual, deberías instalarlas con <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> listando los archivos correspondientes en el archivo <filename><replaceable>nombre_del_paquete</replaceable>.manpages</filename>.

note: type: Content of: <book><chapter><section><para>
en: To install <filename>docs/gentoo.1</filename> as a manpage for the <systemitem role="package">gentoo</systemitem> package, create a <filename>gentoo.manpages</filename> file as follows:
es: Para instalar el archivo <filename>docs/gentoo.1</filename> del paquete <systemitem role="package">gentoo</systemitem> como su manual, construirás el archivo <filename>gentoo.manpages</filename> con el contenido:

note: type: Content of: <book><chapter><section><title>
en: <filename>NEWS</filename>
es: Archivo <filename>NEWS</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
es: La orden <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instala este archivo.

note: type: Content of: <book><chapter><section><title>
en: <filename>{pre,post}{inst,rm}</filename>
es: Archivos <filename>{pre,post}{inst,rm}</filename>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Despite this use of the <command>bash</command> shorthand expression <filename>{pre,post}{inst,rm}</filename> to indicate these filenames, you should use pure POSIX syntax for these maintainer scripts for compatibility with <command>dash</command> as the system shell.
es: Aunque el texto utilice la expresión abreviada <command>bash</command> para el nombre de los archivos <filename>{pre,post}{inst,rm}</filename>, debes utilizar la sintaxis POSIX pura para estos guiones del desarrollador para mantener la compatibilidad con el «shell» del sistema <command>dash</command>.

note: type: Content of: <book><chapter><section><para>
en: These <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, and <filename>prerm</filename> files <placeholder type="footnote" id="0"/> are called <emphasis>maintainer scripts</emphasis>.  They are scripts which are put in the control area of the package and run by <command>dpkg</command> when your package is installed, upgraded, or removed.
es: Los archivos <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename> y <filename>prerm</filename> <placeholder type="footnote" id="0"/> se denominan <emphasis>guiones del desarrollador</emphasis>. Son guiones que se colocan en el área de control del paquete y que <command>dpkg</command> ejecuta cuando tu paquete se instala, se actualiza o se elimina.

note: type: Content of: <book><chapter><section><para>
en: As a novice maintainer, you should avoid any manual editing of maintainer scripts because they are problematic.  For more information refer to the <ulink url="&policy-mantainerscripts;">Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"</ulink>, and take a look at the example files provided by <command>dh_make</command>.
es: Por ahora, deberías intentar evitar editar manualmente estos <emphasis>guiones del desarrollador</emphasis> si puedes porque suelen hacerse muy complejos.  Para más información lee <ulink url="&policy-mantainerscripts;">«Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"»</ulink>, y echa un vistazo a los ejemplos proporcionados por <command>dh_make</command>.

note: type: Content of: <book><chapter><section><para>
en: If you did not listen to me and have created custom maintainer scripts for a package, you should make sure to test them not only for <emphasis role="strong">install</emphasis> and <emphasis role="strong">upgrade</emphasis> but also for <emphasis role="strong">remove</emphasis> and <emphasis role="strong">purge</emphasis>.
es: Si a pesar de mis advertencias, adaptas los <emphasis>guiones del desarrollador</emphasis> para el paquete, asegúrate de comprobar su funcionamiento no sólo para la <emphasis role="strong">instalación</emphasis> y <emphasis role="strong">actualización</emphasis> del paquete, sino también para su <emphasis role="strong">desinstalación</emphasis> y <emphasis role="strong">eliminación completa</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Upgrades to the new version should be silent and non-intrusive (existing users should not notice the upgrade except by discovering that old bugs have been fixed and perhaps that there are new features).
es: Las actualizaciones a una nueva versión deben ser «silenciosas» y no intrusivas.  Los usuarios no deberían darse cuenta de la actualización, salvo quizás para descubrir que se han arreglado errores antiguos y porque hay alguna nueva funcionalidad.

note: type: Content of: <book><chapter><section><para>
en: When the upgrade is necessarily intrusive (eg., config files scattered through various home directories with totally different structure), you may consider as the last resort switching the package to a safe fallback state (e.g., disabling a service) and providing the proper documentation required by policy (<filename>README.Debian</filename> and <filename>NEWS.Debian</filename>).  Don't bother the user with <command>debconf</command> notes invoked from these maintainer scripts for upgrades.
es: Cuando la actualización es necesariamente intrusiva (p.e.  archivos de configuración dispersos en varios directorios con una estructura totalmente modificada), se deberían establecer los valores predeterminados seguros (p.e.  desactivar los servicios) y facilitar la documentación apropiada establecida por las normas (archivos <filename>README.Debian</filename> y <filename>NEWS.Debian</filename>) como último recurso.  Hay que evitar molestar al usuario con notas <command>debconf</command> invocadas por los <emphasis>guiones del desarrollador</emphasis> en las actualizaciones.

note: type: Content of: <book><chapter><section><para>
en: The <systemitem role="package">ucf</systemitem> package provides a <emphasis>conffile-like</emphasis> handling infrastructure to preserve user changes for files that may not be labeled as <emphasis>conffiles</emphasis> such as those managed by the maintainer scripts.  This should minimize issues associated with them.
es: El paquete <systemitem role="package">ucf</systemitem> facilita el sistema <emphasis>conffile-like</emphasis> para preservar los cambios de configuración realizados por el usuario y por ello no deben nombrarse como <emphasis>conffiles</emphasis> los archivos manejados por los <emphasis>guiones del desarrollador</emphasis>.  Así se minimizan las incidencias asociadas con ellos.

note: type: Content of: <book><chapter><section><para>
en: These maintainer scripts are among the Debian enhancements that explain <emphasis role="strong">why people choose Debian</emphasis>.  You must be very careful not to turn them into a source of annoyance.
es: Estos <emphasis>guiones del desarrollador</emphasis> son un ejemplo de las características de Debian que explican <emphasis role="strong">por qué la gente elige Debian</emphasis>.  Debes ser cuidadoso con no molestarles con ellos.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.symbols</filename>
es: Archivo <filename><replaceable>nombre_del_paquete</replaceable>.symbols</filename>

note: type: Content of: <book><chapter><section><title>
en: <filename>TODO</filename>
es: Archivo <filename>TODO</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
es: La orden <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instala este archivo.

note: type: Content of: <book><chapter><section><title>
en: <filename>watch</filename>
es: Archivo <filename>watch</filename>

note: type: Content of: <book><chapter><section><para>
en: Here are its contents:
es: Este es su contenido:

note: type: Content of: <book><chapter><section><para>
en: Normally with a <filename>watch</filename> file, the URL at <literal>&sf-net;/gentoo</literal> is downloaded and searched for links of the form <literal>&lt;a href=...&gt;</literal>.  The basename (just the part after the final <literal>/</literal>) of each linked URL is compared against the Perl regular expression pattern (see <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  <literal>gentoo-(.+)\.tar\.gz</literal>.  Out of the files that match, the one with the greatest version number is downloaded and the <command>uupdate</command> program is run to create an updated source tree.
es: Con el archivo <filename>watch</filename>, la URL <literal>&sf-net;/gentoo</literal> se descarga y se buscan los enlaces del tipo <literal>&lt;a href=...&gt;</literal>.  El nombre base (justo la parte después del <literal>/</literal> final) de las direcciones URL enlazadas se comparan con la expresión regular de Perl (véase <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  con el patrón <literal>gentoo-(.+)\.tar\.gz</literal>. Se descarga el archivo de versión más reciente de entre todos los archivos encontrados cuyo nombre se ajuste al patrón, y se ejecutará el programa <command>uupdate</command> para construir el árbol de código fuente actualizado en base a este fichero.

note: type: Content of: <book><chapter><section><para>
en: If the upstream offers the cryptographic signature of the tarball, it is recommended to verify its authenticity using the <literal>pgpsigurlmangle</literal> option as described in <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.
es: Si el autor publica la firma criptográfica del  fichero tarball, se recomienda comprobar su autenticidad utilizando la opción <literal>pgpsigurlmangle</literal> descrita en <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>source/format</filename>
es: Archivo <filename>source/format</filename>

note: type: Content of: <book><chapter><section><para>
en: In the <filename>debian/source/format</filename> file, there should be a single line indicating the desired format for the source package (check <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> for an exhaustive list).  After <literal>squeeze</literal>, it should say either:
es: El archivo <filename>debian/source/format</filename>, solo contendrá una línea indicando el formato deseado para el paquete (véase <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> para consultar la lista completa).  Después de <literal>squeeze</literal> debería ser:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (native)</literal> for native Debian packages or
es: <literal>3.0 (native)</literal> para paquetes nativos de Debian o

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (quilt)</literal> for everything else.
es: <literal>3.0 (quilt)</literal> para el resto de paquetes.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debsrc3;">DebSrc3.0</ulink> for a summary on the switch to the new <literal>3.0 (quilt)</literal> and <literal>3.0 (native)</literal> source formats.
es: Véase <ulink url="&debsrc3;">DebSrc3.0</ulink> para un resumen informativo sobre los formatos <literal>3.0 (quilt)</literal> y <literal>3.0 (native)</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Actually, this new format also supports multiple upstream tarballs and more compression methods.  These are beyond the scope of this document.
es: Actualmente, este nuevo formato también permite trabajar con múltiples archivos «tar» fuente y otros sistemas de compresión.  Estas funciones están fuera del objetivo de este documento.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format records modifications in a <command>quilt</command> patch series within <filename>debian/patches</filename>.  Those changes are then automatically applied during extraction of the source package.  <placeholder type="footnote" id="0"/> The Debian modifications are simply stored in a <filename>debian.tar.gz</filename> archive containing all files under the <filename>debian</filename> directory.  This new format supports inclusion of binary files such as PNG icons by the package maintainer without requiring tricks.  <placeholder type="footnote" id="1"/>
es: El nuevo formato <literal>3.0 (quilt)</literal> registra los cambios en series de archivos de parches <command>quilt</command> en el directorio <filename>debian/patches</filename>.  Estos cambios se aplican automáticamente en la extracción de las fuentes del paquete <placeholder type="footnote" id="0"/>.  Las modificaciones se guardan en el archivo <filename>debian.tar.gz</filename> que contiene todos los archivos del directorio <filename>debian</filename> utilizado en la construcción del paquete.  El nuevo formato permite la inclusión de archivos como los iconos PNG sin necesidad de trucos <placeholder type="footnote" id="1"/>.

note: type: Content of: <book><chapter><section><para>
en: When <command>dpkg-source</command> extracts a source package in <literal>3.0 (quilt)</literal> source format, it automatically applies all patches listed in <filename>debian/patches/series</filename>.  You can avoid applying patches at the end of the extraction with the <literal>--skip-patches</literal> option.
es: Cuando <command>dpkg-source</command> extrae un paquete fuente con el formato <literal>3.0 (quilt)</literal>, automáticamente aplica todos los parches listados en el archivo <filename>debian/patches/series</filename>.  Puedes evitar la ejecución de los parches al final de la extracción con la opción <literal>--skip-patches</literal>.

note: type: Content of: <book><chapter><section><title>
en: <filename>source/local-options</filename>
es: Archivo <filename>source/local-options</filename>

note: type: Content of: <book><chapter><section><para>
en: After you build a package, the source is normally left patched.  You need to unpatch it manually by running <literal>dquilt pop -a</literal> before committing to the <literal>master</literal> branch.  You can automate this by adding the optional <filename>debian/source/local-options</filename> file containing <literal>unapply-patches</literal>.  This file is not included in the generated source package and changes the local build behavior only.  This file may contain <literal>abort-on-upstream-changes</literal>, too (see <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).
es: Una vez compilado el paquete, las fuentes estarán parcheadas.  Deberás deshacer los parches manualmente ejecutando <literal>dquilt pop -a</literal> antes de sincronizar con la rama <literal>master</literal>.  Puedes automatizar esto añadiendo el archivo opcional <filename>debian/source/local-options</filename> cuyo contenido será «<literal>unapply-patches</literal>».  Este archivo no se incluye en el paquete fuente generado y sólo cambia el entorno local de compilación.  Este archivo también puede contener la línea «<literal>abort-on-upstream-changes</literal>» (véase <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><title>
en: <filename>source/options</filename>
es: Archivo <filename>source/options</filename>

note: type: Content of: <book><chapter><section><para>
en: The autogenerated files in the source tree can be quite annoying for packaging since they generate meaningless large patch files.  There are custom modules such as <command>dh_autoreconf</command> to ease this problem as described in <xref linkend="customrules"/>.
es: Los archivos generados automáticamente en el árbol del código fuente pueden ser bastante molestos en la construcción del paquete debido a que generan archivos de parche grandes. Hay módulos personalizados, tales como <command>dh_autoreconf</command> para aliviar este problema como se describe en <xref linkend="customrules"/>.

note: type: Content of: <book><chapter><section><para>
en: You can provide a Perl regular expression to the <literal>--extend-diff-ignore</literal> option argument of <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> to ignore changes made to the autogenerated files while creating the source package.
es: Puedes proporcionar una expresión regular en Perl para la opción <literal>--extend-diff-ignore</literal> del argumento de <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> para hacer caso omiso de los cambios realizados en los archivos generados automáticamente al crear el paquete fuente.

note: type: Content of: <book><chapter><section><para>
en: As a general solution to address this problem of the autogenerated files, you can store such a <command>dpkg-source</command> option argument in the <filename>source/options</filename> file of the source package.  The following will skip creating patch files for <filename>config.sub</filename>, <filename>config.guess</filename>, and <filename>Makefile</filename>.
es: Puedes conservar las opciones de la orden <command>dpkg-source</command> en el archivo <filename>source/options</filename> de las fuentes del paquete como solución genérica al problema de los archivos autogenerados. En el ejemplo siguiente, se evita la generación de archivos de parche para <filename>config.sub</filename> <filename>config.guess</filename> y <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>patches/*</filename>
es: Archivos <filename>patches/*</filename>

note: type: Content of: <book><chapter><section><para>
en: The old <literal>1.0</literal> source format created a single large <filename>diff.gz</filename> file containing package maintenance files in <filename>debian</filename> and patch files for the source.  Such a package is a bit cumbersome to inspect and understand for each source tree modification later.  This is not so nice.
es: El antiguo formato <literal>1.0</literal> construía un archivo <filename>diff.gz</filename> cuyo contenido era el de los archivos de construcción del paquete del directorio <filename>debian</filename> así como los cambios a realizar en las fuentes.  Este formato para conservar los cambios resultaba engorroso cuando se trataba de inspeccionar y entender cada modificación de las fuentes.  Ya no resulta eficaz.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Several methods of patch set maintenance have been proposed and are in use for Debian packages.  The <command>quilt</command> system is the preferred maintenance system in use.  Others include <command>dpatch</command>, <command>dbs</command>, and <command>cdbs</command>.  Many of these keep such patches as <filename>debian/patches/*</filename> files.
es: Se han propuesto y se están utilizando otros métodos de aplicación de los parches en Debian. El sistema <command>quilt</command> es el preferido. Otros sistemas son <command>dpatch</command>, <command>dbs</command>, <command>cdbs</command>, etc. La mayoría de ellos conservan los parches en archivos en el directorio <filename>debian/patches/*</filename>.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format stores patches in <filename>debian/patches/*</filename> files using the <command>quilt</command> command.  These patches and other package data which are all contained under the <filename>debian</filename> directory are packaged as the <filename>debian.tar.gz</filename> file.  Since the <command>dpkg-source</command> command can handle <command>quilt</command> formatted patch data in the <literal>3.0 (quilt)</literal> source without the <systemitem role="package">quilt</systemitem> package, it does not need a <literal>Build-Depends</literal> on <systemitem role="package">quilt</systemitem>.  <placeholder type="footnote" id="0"/>
es: El nuevo formato <literal>3.0 (quilt)</literal> de las fuentes, guarda las modificaciones (los parches) en archivos en el directorio <filename>debian/patches/*</filename> utilizando la orden <command>quilt</command>. Estos parches y otros datos del paquete que están en el directorio <filename>debian</filename> se conservan en el archivo <filename>debian.tar.gz</filename>. Desde que la orden <command>dpkg-source</command> puede aplicar los parches en las fuentes con el nuevo formato tipo <command>quilt</command> sin el paquete <systemitem role="package">quilt</systemitem>, no es necesario añadir el paquete <systemitem role="package">quilt</systemitem> en el campo <literal>Build-Depends</literal> del fichero <filename>control</filename> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you are asking a sponsor to upload your package, this kind of clear separation and documentation of your changes is very important to expedite the package review by your sponsor.
es: Si has solicitado a un patrocinador que transfiera el paquete al repositorio, este sistema de separación y documentación de los cambios es muy importante para facilitar la revisión del paquete por el patrocinador.

note: type: Content of: <book><chapter><section><para>
en: The <command>quilt</command> command is explained in <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  It records modifications to the source as a stack of <literal>-p1</literal> patch files in the <filename>debian/patches</filename> directory and the source tree is untouched outside of the <filename>debian</filename> directory.  The order of these patches is recorded in the <filename>debian/patches/series</filename> file.  You can apply (=push), un-apply (=pop), and refresh patches easily.  <placeholder type="footnote" id="0"/>
es: El funcionamiento de la orden <command>quilt</command> se explica en <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Conserva las modificaciones de las fuentes en una colección de archivos de parches <literal>-p1</literal> en el directorio <filename>debian/patches</filename> y las fuentes originales permanecen sin modificar fuera del directorio <filename>debian</filename>.  El orden de aplicación de las modificaciones se conserva en el archivo <filename>debian/patches/series</filename>.  Puedes aplicar («push»), deshacer («pop») y actualizar las modificaciones fácilmente <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: For <xref linkend="modify"/>, we created three patches in <filename>debian/patches</filename>.
es: En <xref linkend="modify"/>, se han construido tres archivos de parches en <filename>debian/patches</filename>.

note: type: Content of: <book><chapter><section><para>
en: Since Debian patches are located in <filename>debian/patches</filename>, please make sure to set up the <command>dquilt</command> command properly as described in <xref linkend="quiltrc"/>.
es: Puesto que los parches se ubican en <filename>debian/patches</filename>, asegúrate que has configurado adecuadamente la orden <command>dquilt</command> como se describe en <xref linkend="quiltrc"/> .

note: type: Content of: <book><chapter><section><para>
en: When anyone (including yourself) provides a patch <filename><replaceable>foo</replaceable>.patch</filename> to the source later, modifying a <literal>3.0 (quilt)</literal> source package is quite simple:
es: Cuando alguien (incluido tú mismo), facilita un parche <filename><replaceable>nombre_parche</replaceable>.patch</filename> para las fuentes, cuando ya está construido el paquete, la modificación de un paquete con formato <literal>3.0 (quilt)</literal> es así de simple:

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>foo</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
es: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>nombre_parche</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    .. descripción de la modificación

note: type: Content of: <book><chapter><section><para>
en: The patches stored in the newer <literal>3.0 (quilt)</literal> source format must be <emphasis>fuzz</emphasis> free.  You can ensure this with <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.
es: Los parches conservados con el nuevo formato de fuentes <literal>3.0 (quilt)</literal> deben estar exentos de <emphasis>cosas innecesarias</emphasis>. Debes asegurarte ejecutando <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><title>
en: Building the package
es: Construcción del paquete

note: type: Content of: <book><chapter><para>
en: We should now be ready to build the package.
es: Ahora deberíamos estar preparados para construir el paquete.

note: type: Content of: <book><chapter><section><title>
en: Complete (re)build
es: (Re)construcción completa

note: type: Content of: <book><chapter><section><para>
en: In order to perform a complete (re)build of a package properly, you need to make sure you have installed
es: Para realizar correctamente la (re)compilación completa de un paquete, debes asegurarte que tienes instalados:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package,
es: el paquete <systemitem role="package">build-essential</systemitem>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>), and
es: los paquetes listados en el campo <literal>Build-Depends</literal> del archivo «control» (<xref linkend="control"/> ), y

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends-indep</literal> field (see <xref linkend="control"/>).
es: los paquetes listados en el campo <literal>Build-Depends-indep</literal> (también del archivo «control», <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then you issue the following command in the source directory:
es: Después ejecuta la siguiente orden en el directorio raíz del código fuente del programa:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make full binary and source packages for you.  It will:
es: Esto hará todo lo necesario para construir los paquetes binarios y de fuentes para ti.  Para ello:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: clean the source tree (<literal>debian/rules clean</literal>)
es: limpia el árbol del código fuente («<literal>debian/rules clean</literal>»)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the source package (<literal>dpkg-source -b</literal>)
es: construye el paquete de código («<literal>dpkg-source -b</literal>»)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the program (<literal>debian/rules build</literal>)
es: construye el programa («<literal>debian/rules build</literal>»)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build binary packages (<literal>fakeroot debian/rules binary</literal>)
es: construye el paquete binario (<literal>fakeroot debian/rules binary</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.dsc</filename> file
es: genera el fichero <filename>.dsc</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.changes</filename> file, using <command>dpkg-genchanges</command>
es: genera el fichero <filename>.changes</filename>, utilizando <command>dpkg-genchanges</command>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This GPG key must be signed by a Debian developer to get connected to the web of trust and must be registered to <ulink url="&keyring;">the Debian keyring</ulink>.  This enables your uploaded packages to be accepted to the Debian archives.  See <ulink url="&keycreate;">Creating a new GPG key</ulink> and <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink>.
es: Esta clave GPG debe ser firmado por un desarrollador de Debian para conectarse a la red de confianza y debe registrarse en <ulink url="&keyring;">el anillo de claves de Debian</ulink>. Esto permite que los paquetes sean aceptados en los repositorios de Debian. Consulta <ulink url="&keycreate;">Cómo crear un clave GPG nueva</ulink> y <ulink url="&keysigning; ">Wiki de Debian sobre la firma de claves</ulink>.

note: type: Content of: <book><chapter><section><para>
en: For a non-native Debian package, e.g., <systemitem role="package">gentoo</systemitem>, you will see the following files in the parent directory (<filename>~/gentoo</filename>) after building packages:
es: Para los paquetes no nativos Debian, p.ej, <systemitem role="package">gentoo</systemitem>, podrás ver los siguientes archivos en el directorio padre (<filename>~/gentoo</filename>) después de construir el paquete:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code.  The file is generated from your <filename>control</filename> file, and is used when unpacking the source with <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
es: Este es un sumario de los contenidos del código fuente.  Este fichero se genera a partir del fichero de <filename>control</filename> y se usa cuando se descomprimen las fuentes con <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This compressed tarball contains your <filename>debian</filename> directory contents.  Each and every addition you made to the original source code is stored as a <command>quilt</command> patch in <filename>debian/patches</filename>.
es: Este fichero comprimido contiene el directorio <filename>debian</filename> completo.  Todas las modificaciones de las fuentes originales se conservan en los archivos de parches <command>quilt</command> en el directorio <filename>debian/patches</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can avoid applying <command>quilt</command> patches in the <literal>3.0 (quilt)</literal> source format at the end of the extraction with the <literal>--skip-patches</literal> option.  Alternatively, you can run <literal>dquilt pop -a</literal> after normal operation.
es: Puedes evitar la aplicación automática de las modificaciones por <command>dquilt</command> en los paquetes con formato <literal>3.0 (quilt)</literal> al final de la extracción con la opción <literal>--skip-patches</literal>. También puedes deshacer las modificaciones al finalizar la extracción con la ejecución de <literal>dquilt pop -a</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If someone else wants to re-create your package from scratch, they can easily do so using the above three files.  The extraction procedure is trivial: just copy the three files somewhere else and run <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>.  <placeholder type="footnote" id="0"/>
es: Si alguien quiere volver a construir tu paquete desde cero, puede hacerlo fácilmente usando los tres ficheros de arriba.  El proceso de extracción es trivial: sólo se debe copiar los tres ficheros en algún lado y ejecutar <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is your completed binary package.  You can use <command>dpkg</command> to install and remove this just like any other package.
es: Este es el paquete binario completo.  Puedes usar <command>dpkg</command> para instalar o eliminar tanto este paquete como cualquier otro.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package revision; it is used by the Debian FTP archive maintenance programs to install the binary and source packages.  It is partly generated from the <filename>changelog</filename> file and the <filename>.dsc</filename> file.
es: Este fichero describe todos los cambios hechos en la revisión actual del paquete, y lo utilizan los programas de mantenimiento del archivo FTP de Debian para instalar los paquetes binarios y fuentes.  Se genera parcialmente a partir del fichero <filename>changelog</filename> y el fichero <filename>.dsc</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: As you keep working on the package, its behavior will change and new features will be added.  People downloading your package can look at this file and quickly see what has changed.  Debian archive maintenance programs will also post the contents of this file to the <ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink> mailing list.
es: Mientras sigues trabajando en el paquete, éste cambiará su comportamiento y se le añadirán nuevas funciones.  Las personas que descarguen tu paquete pueden leer este fichero y ver qué ha cambiado.  Los programas de mantenimiento del archivo de Debian, también enviarán el contenido de este fichero a la lista de correo <ulink url="&debian-devel-changes-ldo;">debian-changes-announce@lists.debian.org</ulink>.

note: type: Content of: <book><chapter><section><screen>
en: DEBSIGN_KEYID=Your_GPG_keyID
es: DEBSIGN_KEYID=Tu_GPG_keyID

note: type: Content of: <book><chapter><section><para>
en: The long strings of numbers in the <filename>.dsc</filename> and <filename>.changes</filename> files are SHA1/SHA256 checksums for the files mentioned.  Anyone downloading your files can test them with <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and if the numbers don't match, they'll know the file is corrupt or has been tampered with.
es: Las largas listas de números en los ficheros <filename>.dsc</filename> y <filename>.changes</filename> son las sumas MD5/SHA1/SHA256 de los ficheros incluidos en el paquete.  Las personas que descarguen estos ficheros pueden comprobarlos con <citerefentry> <refentrytitle>md5sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> y si los números no coinciden, sabrán que el fichero está corrupto o ha sido modificado.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The actual autobuilder system involves much more complicated schemes than the one documented here.  Such details are beyond the scope of this document.
es: El funcionamiento del sistema actual de compilación automática es más complicado que lo expuesto en este documento.  Muchos detalles quedan fuera de los objetivos de este documento.

note: type: Content of: <book><chapter><section><para>
en: Debian supports many <ulink url="&ports;">ports</ulink> with the <ulink url="&buildd;">autobuilder network</ulink> running <command>buildd</command> daemons on computers of many different architectures.  Although you do not need to do this yourself, you should be aware of what will happen to your packages.  Let's look into roughly how they rebuild your packages for multiple architectures.  <placeholder type="footnote" id="0"/>
es: Debian mantiene diversas <ulink url="&ports;">adaptaciones «ports»</ulink> con la <ulink url="&buildd;">red de servidores de compilación automática</ulink> que ejecuta demonios <command>buildd</command> en ordenadores con diferentes arquitecturas.  Aunque no deberás hacer todo esto tú mismo, debes conocer el proceso al que se verá sometido tu paquete.  Veamos cómo se procesa el paquete para compilarlo en diversas arquitecturas <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: For <literal>Architecture: any</literal> packages, the autobuilder system performs a rebuild.  It ensures the installation of
es: Los paquetes del tipo <literal>Architecture: any</literal>, son construidos por el sistema de compilación automática.  El sistema garantiza la instalación de:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package, and
es: el paquete <systemitem role="package">build-essential</systemitem>, y

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>).
es: los paquetes listados en el campo <literal>Build-Depends</literal> (véase <xref linkend="control"/> ).

note: type: Content of: <book><chapter><section><para>
en: Then it issues the following command in the source directory:
es: A continuación se ejecuta la siguiente orden en el directorio de las fuentes:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make architecture dependent binary packages on another architecture.  It will:
es: De esta manera, se ejecuta todo lo necesario para construir el paquete binario dependiente de la arquitectura en cada arquitectura.  Hace lo siguiente:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build architecture dependent binary packages (<literal>fakeroot debian/rules binary-arch</literal>)
es: construye el paquete binario para la arquitectura (<literal>fakeroot debian/rules binary-arch</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: sign the source <filename>.dsc</filename> file, using <command>gpg</command>
es: firma el fichero fuente <filename>.dsc</filename>, usando <command>gpg</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: create and sign the upload <filename>.changes</filename> file, using <command>dpkg-genchanges</command> and <command>gpg</command>
es: genera y firma el fichero de envío <filename>.changes</filename>, usando <command>dpkg-genchanges</command> y <command>gpg</command>

note: type: Content of: <book><chapter><section><para>
en: This is why you see your package for other architectures.
es: Esta es la razón por la que el paquete estará disponible para otras arquitecturas.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Unlike under the <systemitem role="package">pbuilder</systemitem> package, the <command>chroot</command> environment under the <systemitem role="package">sbuild</systemitem> package used by the autobuilder system does not enforce the use of a minimal system and may have many leftover packages installed.
es: Contrariamente al modo de funcionamiento del paquete <systemitem role="package">pbuilder</systemitem> (que se tratará más adelante), el entorno <command>chroot</command> del paquete <systemitem role="package">sbuild</systemitem> utilizado por el sistema automático no tiene una instalación mínima de paquetes del sistema y puede dejar muchos paquetes instalados.

note: type: Content of: <book><chapter><section><para>
en: Although packages listed in the <literal>Build-Depends-Indep</literal> field are required to be installed for our normal packaging work (see <xref linkend="completebuild"/>), they are not required to be installed for the autobuilder system since it builds only architecture dependent binary packages.  <placeholder type="footnote" id="0"/> This distinction between normal packaging and autobuilding procedures is what dictates whether you should record such required packages in the <literal>Build-Depends</literal> or <literal>Build-Depends-Indep</literal> fields of the <filename>debian/control</filename> file (see <xref linkend="control"/>).
es: Aunque es necesario instalar los paquetes listados en el campo <literal>Build-Depends-indep</literal> para el empaquetamiento normal (véase <xref linkend="completebuild"/> ), el sistema automático de construcción no lo requiere puesto que solo construye paquetes binarios dependientes de la arquitectura <placeholder type="footnote" id="0"/>. Estas diferencias entre el empaquetamiento normal y el automático determinan si los paquetes requeridos para la compilación se deben listar en el campo <literal>Build-Depends</literal> o bien en el campo <literal>Build-Depends-indep</literal> del archivo <filename>debian/control</filename> (véase <xref linkend="control"/> ).

note: type: Content of: <book><chapter><section><title>
en: <command>debuild</command> command
es: La orden <command>debuild</command>

note: type: Content of: <book><chapter><section><para>
en: You can automate the build activity around executing the <command>dpkg-buildpackage</command> command package further with the <command>debuild</command> command.  See <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
es: Puedes automatizar aún más el proceso de construcción de paquetes de la orden <command>dpkg-buildpackage</command> con la orden <command>debuild</command>.  Véase <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: Cleaning the source and rebuilding the package from your user account is as simple as:
es: Por ejemplo, limpiar el código y reconstruir el paquete desde una cuenta de usuario es tan simple como:

note: type: Content of: <book><chapter><section><para>
en: You can clean the source tree as simply as:
es: Puedes eliminar los archivos generados en la compilación ejecutando:

note: type: Content of: <book><chapter><section><title>
en: <systemitem role="package">pbuilder</systemitem> package
es: El paquete <systemitem role="package">pbuilder</systemitem>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Since the <systemitem role="package">pbuilder</systemitem> package is still evolving, you should check the actual configuration situation by consulting the latest official documentation.
es: Dado que el paquete <systemitem role="package">pbuilder</systemitem> está evolucionando, deberías comprobar la situación de la configuración consultando la última documentación oficial disponible.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&buildd-do;"/> for more on Debian package auto-building.
es: Consulta <ulink url="&buildd-do;"/> para saber más sobre la construcción automática de paquetes Debian.

note: type: Content of: <book><chapter><section><para>
en: For a clean room (<command>chroot</command>) build environment to verify the build dependencies, the <systemitem role="package">pbuilder</systemitem> package is very useful.  <placeholder type="footnote" id="0"/> This ensures a clean build from the source under the <literal>sid</literal> auto-builder for different architectures and avoids a severity serious FTBFS (Fails To Build From Source) bug which is always in the RC (release critical) category.  <placeholder type="footnote" id="1"/>
es: El paquete <systemitem role="package">pbuilder</systemitem> es muy útil para conseguir un entorno de compilación limpio (<command>chroot</command>) donde verificar las dependencias de compilación <placeholder type="footnote" id="0"/>.  Esto asegura una construcción limpia desde el código en los auto-compiladores de <literal>sid</literal> para las distintas arquitecturas y evita fallos de nivel de severidad serios del tipo FTBFS («Fail to Build From Source», o «fallo al construir desde la fuente »), que son siempre de categoría RC (fallos críticos o «release critical»).  <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: Let's customize the <systemitem role="package">pbuilder</systemitem> package as follows:
es: Para personalizar el funcionamiento del paquete <systemitem role="package">pbuilder</systemitem> haz lo siguiente:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: setting the <filename>/var/cache/pbuilder/result</filename> directory writable by your user account.
es: permite que tu usuario del sistema tenga permiso de escritura en el directorio <filename>/var/cache/pbuilder/result</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: creating a directory, e.g.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, writable by the user, to place hook scripts in.
es: crea un directorio, p.e.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, con permiso de escritura para tu usuario.  En este directorio pondrás los guiones «hook»

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: configuring <filename>~/.pbuilderrc</filename> or <filename>/etc/pbuilderrc</filename> to include the following.
es: establece los archivos <filename>~/.pbuilderrc</filename> o <filename>/etc/pbuilderrc</filename> con el siguiente contenido:

note: type: Content of: <book><chapter><section><para>
en: First let's initialize the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system as follows:
es: Ahora puedes inicializar el sistema local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> por primera vez ejecutando:

note: type: Content of: <book><chapter><section><para>
en: If you already have a completed source package, issue the following commands in the directory where the <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename>, and <filename><replaceable>foo</replaceable>.dsc</filename> files exist to update the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system and to build binary packages in it:
es: Si ya dispones de un paquete fuente completo, ejecuta las siguientes órdenes en el directorio donde tengas los archivos <filename><replaceable>nombre_del_paquete</replaceable>.orig.tar.gz</filename>, <filename><replaceable>nombre_del_paquete</replaceable>.debian.tar.gz</filename> y <filename><replaceable>nombre_del_paquete</replaceable>.dsc</filename> para actualizar el sistema local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> y, a continuación, compilar el paquete binario en él:

note: type: Content of: <book><chapter><section><screen>
en: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>foo_version</replaceable>.dsc
es: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>nombre_del_paquete</replaceable>.dsc

note: type: Content of: <book><chapter><section><para>
en: The newly built packages without the GPG signatures will be located in <filename>/var/cache/pbuilder/result/</filename> with non-root ownership.
es: Una vez finalizada la compilación, el paquete compilado estará en el directorio <filename>/var/cache/pbuilder/result/</filename> cuyo propietario será tu usuario en lugar del usuario administrador.

note: type: Content of: <book><chapter><section><para>
en: The GPG signatures on the <filename>.dsc</filename> file and the <filename>.changes</filename> file can be generated as:
es: Las firmas GPG en los archivos <filename>.dsc</filename> y <filename>.changes</filename> se puede generar como sigue

note: type: Content of: <book><chapter><section><screen>
en: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>foo_version_arch</replaceable>.changes
es: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>nombre_del_paquete_versión_arquitectura</replaceable>.changes

note: type: Content of: <book><chapter><section><para>
en: If you have an updated source tree but have not generated the matching source package, issue the following commands in the source directory where the <filename>debian</filename> directory exists, instead:
es: Si en lugar de iniciar la construcción del paquete a partir de un paquete ya construido, dispones de un directorio con las fuentes originales actualizadas, deberás ejecutar las siguientes órdenes desde el directorio de las fuentes originales (y en el que deberá estar presente el directorio <filename>debian</filename> con todo su contenido):

note: type: Content of: <book><chapter><section><para>
en: You can log into its <command>chroot</command> environment with the <literal>pbuilder --login --save-after-login</literal> command and configure it as you wish.  This environment can be saved by leaving its shell prompt with <literal>^D</literal> (Control-D).
es: Puedes «conectarte» al entorno <command>chroot</command> ejecutando la orden <literal>pbuilder --login --save-after-login</literal> y configurarlo para adaptarlo a tus necesidades.  Este entorno puede guardarse saliendo del «shell» con <literal>^D</literal> (Control-D).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This assumes <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>.  You can find many examples of hook scripts in the <filename>/usr/share/doc/pbuilder/examples</filename> directory.
es: Se supone que la variable de entorno <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal> ya está configurada.  Puedes consultar otros ejemplos en <filename>/usr/share/doc/pbuilder/examples</filename>.

note: type: Content of: <book><chapter><section><para>
en: The latest version of the <command>lintian</command> command can be executed in the <literal>chroot</literal> environment using the hook script <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> configured as follows: <placeholder type="footnote" id="0"/>
es: La última versión de la orden <command>lintian</command> puede ejecutarse automáticamente en el entorno <literal>chroot</literal> utilizando el guión «hook» disponible en <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> y configurado como sigue <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: You need to have access to the latest <literal>sid</literal> environment to build packages properly for <literal>sid</literal>.  In practice, <literal>sid</literal> may be experiencing issues which makes it undesirable for you to migrate your whole system.  The <systemitem role="package">pbuilder</systemitem> package can help you to cope with this kind of situation.
es: Debes tener un entorno <literal>sid</literal> actualizado para construir correctamente paquetes para <literal>sid</literal>.  En realidad, al versión <literal>sid</literal> puede contener errores que no hacen recomendable la migración de tu sistema a esta versión.  El paquete <systemitem role="package">pbuilder</systemitem> te ayuda a hacer frente a esta situación.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are some restrictions for such updates of your <literal>stable</literal> package.
es: Hay algunas restricciones para estas actualizaciones de tu paquete <literal>stable</literal>.

note: type: Content of: <book><chapter><section><para>
en: See <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, and <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.
es: Consulta <ulink url="&pbuilder;">&pbuilder;</ulink>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, y <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debref-vcs;">Version control systems</ulink> for more.
es: Consulta <ulink url="&debref-vcs;">Version control systems</ulink> para saber más.

note: type: Content of: <book><chapter><section><para>
en: If your upstream uses a source code management system (VCS)  <placeholder type="footnote" id="0"/> to maintain their code, you should consider using it as well.  This makes merging and cherry-picking upstream patches much easier.  There are several specialized wrapper script packages for Debian package building for each VCS.
es: Si el autor original utiliza un sistema de gestión de versiones para el código <placeholder type="footnote" id="0"/> puedes considerar utilizarlo. Así se facilita la coordinación y la selección de los parches en las fuentes. Debian dispone de varios paquetes de guiones especializados en cada tipos de VCS:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git-buildpackage</systemitem>: a suite to help with Debian packages in Git repositories.
es: <systemitem role="package">git-buildpackage</systemitem>: conjunto para la compilación de paquetes en repositorios «Git».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">svn-buildpackage</systemitem>: helper programs to maintain Debian packages with Subversion.
es: <systemitem role="package">svn-buildpackage</systemitem>: programas de ayuda para el mantenimiento de paquetes Debian con «Subversion».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">cvs-buildpackage</systemitem>: a set of Debian package scripts for CVS source trees.
es: <systemitem role="package">cvs-buildpackage</systemitem>: conjunto de paquete de guiones Debian para estructuras de directorios CVS.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> documents how to use the <ulink url="&debian-alioth;">alioth.debian.org</ulink> service.
es: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> documenta cómo utilizar el servicio <ulink url="&debian-alioth;">alioth.debian.org</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Use of <systemitem role="package">git-buildpackage</systemitem> is becoming quite popular for Debian Developers to manage Debian packages with the Git server on <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> This package offers many commands to <emphasis>automate</emphasis> packaging activities:
es: El uso de <systemitem role="package">git-buildpackage</systemitem> se está convirtiendo en muy popular para los desarrolladores de Debian para el mantenimiento de los paquetes Debian con el servidor Git en <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> Este paquete ofrece muchas órdenes para <emphasis>automatizar</emphasis> el mantenimiento de paquetes:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository.
es: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: compila los paquetes Debian del repositorio «Git».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository using <command>pbuilder</command>/<command>cowbuilder</command>.
es: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: compila los paquetes Debian del repositorio «Git» utilizando <command>pbuilder</command>/<command>cowbuilder</command>.

note: type: Content of: <book><chapter><section><para>
en: These commands use 3 branches to track packaging activity:
es: Estas órdenes utilizan 3 ramas en la gestión del proceso de empaquetado:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>main</literal> for Debian package source tree.
es: <literal>main</literal> (principal) del árbol de directorios del paquete Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>upstream</literal> for upstream source tree.
es: <literal>upstream</literal> (autor) para el árbol de las fuentes del autor.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>pristine-tar</literal> for upstream tarball generated by the <literal>--pristine-tar</literal> option.<placeholder type="footnote" id="0"/>
es: <literal>pristine-tar</literal> por el fichero comprimido «.tar» del autor generado por la opción <literal>--pristine-tar</literal>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Here are some web resources available for advanced audiences.
es: Aquí tienes algunos recursos disponibles en la red, dirigidos a usuarios expertos.

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: Building Debian Packages with git-buildpackage (<filename>&git-buildpackage-doc;</filename>)
es: Construcción paquetes Debian con «git-buildpackage» (<filename>&git-buildpackage-doc;</filename>)

note: type: Content of: <book><chapter><section><para>
en: You can configure <systemitem role="package">git-buildpackage</systemitem> with <filename>~/.gbp.conf</filename>. See <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>
es: Puedes configurar <systemitem role="package">git-buildpackage</systemitem> con <filename>~/.gbp.conf</filename>. Lee <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Quick rebuild
es: Reconstrucción rápida

note: type: Content of: <book><chapter><section><para>
en: With a large package, you may not want to rebuild from scratch every time while you're tuning details in <filename>debian/rules</filename>.  For testing purposes, you can make a <filename>.deb</filename> file without rebuilding the upstream sources like this<placeholder type="footnote" id="0"/>:
es: Con un paquete grande, puede que no quieras recompilar desde cero cada vez que tocas un detalle en el fichero <filename>debian/rules</filename>.  Para propósitos de prueba, puedes hacer un fichero <filename>.deb</filename> sin necesidad de recompilar las fuentes originales de esta forma<placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><screen>
en: $ fakeroot debian/rules binary
es:   fakeroot debian/rules binary

note: type: Content of: <book><chapter><section><para>
en: Or simply do the following to see if it builds or not:
es: O simplemente puedes comprobar si el paquete se compila con:

note: type: Content of: <book><chapter><section><para>
en: Once you are finished with your tuning, remember to rebuild following the proper procedure.  You may not be able to upload correctly if you try to upload <filename>.deb</filename> files built this way.
es: Una vez terminada la puesta a punto, recuerda reconstruir el paquete siguiendo el procedimiento adecuado explicado anteriormente.  Puede que no seas capaz de enviar correctamente el paquete si intentas enviar los archivos <filename>.deb</filename> construidos de esta forma.

note: type: Content of: <book><chapter><section><title>
en: Command hierarchy
es: Jerarquía de órdenes

note: type: Content of: <book><chapter><section><para>
en: Here is a quick summary of how many commands to build packages fit together in the command hierarchy. There are many ways to do the same thing.
es: A continuación hay un breve resumen de cómo las órdenes de construcción de paquetes encajan jerárquicamente.  Hay muchas maneras de hacer lo mismo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename>debian/rules</filename> = maintainer script for the package building
es: <filename>debian/rules</filename> = guión del desarrollador para la construcción del paquete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>dpkg-buildpackage</command> = core of the package building tool
es: <command>dpkg-buildpackage</command> = orden principal de las herramientas de compilación

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (build under the sanitized environment variables)
es: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (construcción con la configuración estándar de  las variables de entorno)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pbuilder</command> = core of the Debian chroot environment tool
es: <command>pbuilder</command> = núcleo de la herramienta de entorno «chroot» de Debian

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (build in the chroot)
es: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (construcción en el entorno «chroot»"

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>cowbuilder</command> = speed up the <command>pbuilder</command> execution
es: <command>cowbuilder</command> = ejecución acelerada de <command>pbuilder</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>git-pbuilder</command> = the easy-to-use commandline syntax for <command>pdebuild</command> (used by <command>gbp buildpackage</command>)
es: <command>git-pbuilder</command> = la versión de sintaxis fácil para <command>pdebuild</command> (utilizado por <command>gbp buildpackge</command>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp</command> = manage the Debian source under the git repo
es: <command>gbp</command> = gestor de los ficheros Debian del paquete en un repositorio «git»

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp buildpackage</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>
es: <command>gbp buildpackge</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>

note: type: Content of: <book><chapter><section><para>
en: Although use of higher level commands such as <command>gbp buildpackage</command> and <command>pbuilder</command> ensures the perfect package building environment, it is essential to understand how lower level commands such as <filename>debian/rules</filename> and <command>dpkg-buildpackage</command> are executed under them.
es: Aunque el uso de las órdenes de nivel superior como <command>gbp buildpackge</command> y <command>pbuilder</command> asegura el entorno perfecto de construcción de paquetes, es esencial para comprender cómo órdenes de menor nivel, tales como <filename>debian/rules</filename> y <command>dpkg-buildpackage</command> se ejecutan subordinadas.

note: type: Content of: <book><chapter><title>
en: Checking the package for errors
es: Comprobación del paquete en busca de fallos

note: type: Content of: <book><chapter><para>
en: There are some techniques you should know for checking a package for errors before uploading it to the public archives.
es: Debes conocer varios métodos para comprobar el paquete y localizar errores antes de transferirlo a repositorios públicos.

note: type: Content of: <book><chapter><para>
en: It's also a good idea to carry out testing on a machine other than your own.  You must watch closely for any warnings or errors for all the tests described here.
es: Probar el paquete en una máquina distinta a la usada en su construcción es una magnífica idea.  Debes poner atención en todos los avisos y errores que se produzcan en las pruebas explicadas a continuación.

note: type: Content of: <book><chapter><section><title>
en: Suspicious changes
es: Cambios sospechosos

note: type: Content of: <book><chapter><section><para>
en: If you find a new autogenerated patch file such as <filename>debian-changes-*</filename> in the <filename>debian/patches</filename> directory after building your non-native Debian package in <literal>3.0 (quilt)</literal> format, chances are you changed some files by accident or the build script modified the upstream source.  If it is your mistake, fix it.  If it is caused by the build script, fix the root cause with <command>dh-autoreconf</command> as in <xref linkend="customrules"/> or work around it with <filename>source/options</filename> as in <xref linkend="sourceopt"/>.
es: Si encuentras un nuevo archivo de parche autogenerado con el nombre  <filename>debian-changes-*</filename>  en el directorio <filename>debian/patches</filename> después de la construcción de tu paquete de Debian no nativo en formato <literal>3.0 (quilt)</literal>, es probable que hayas cambiado algún archivo accidentalmente o bien que el guión de compilación haya modificado las fuentes originales. Si el error es tuyo, corrígelo. Si es causado por el guión de compilación, corrige el origen del error con <command>dh-autoreconf</command> como en <xref linkend="customrules"/> o bien inténtalo con los archivos <filename>source/options</filename> como en <xref linkend="sourceopt"/>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's installation
es: Comprobación de la instalación del paquete

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's maintainer scripts
es: Comprobación de los <emphasis>guiones del desarrollador</emphasis> («maintainer scripts»)

note: type: Content of: <book><chapter><section><para>
en: All maintainer scripts (that is, <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename>, and <filename>postrm</filename> files) are hard to write correctly unless they are auto-generated by the <systemitem role="package">debhelper</systemitem> programs.  So do not use them if you are a novice maintainer (see <xref linkend="maintscripts"/>).
es: Ya se ha comentado que los <emphasis>guiones del desarrollador</emphasis> (los archivos <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename> y <filename>postrm</filename>) son complicados, excepto si se utilizan los generados por el paquete <systemitem role="package">debhelper</systemitem>.  No se recomienda su utilización a los desarrolladores principiantes (véase <xref linkend="maintscripts"/> ).

note: type: Content of: <book><chapter><section><para>
en: If the package makes use of these non-trivial maintainer scripts, be sure to test not only for install but also for remove, purge, and upgrade processes.  Many maintainer script bugs show up when packages are removed or purged.  Use the <command>dpkg</command> command as follows to test them:
es: Si el paquete utiliza estos <emphasis>guiones del desarrollador</emphasis> modificados o no triviales, debes comprobar su funcionamiento en la instalación, desinstalación, eliminación y actualización.  Algunos errores en estos <emphasis>guiones del desarrollador</emphasis> sólo se producen cuando los paquetes se eliminan o purgan.  Utiliza la orden <command>dpkg</command> como se indica a continuación para probarlos:

note: type: Content of: <book><chapter><section><screen>
en: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>i386</replaceable>.deb
es: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>versión</replaceable>-<replaceable>revisión</replaceable>_<replaceable>i386</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: This should be done with sequences such as the following:
es: Sigue esta secuencia para la comprobación:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the previous version (if needed).
es: Instala la versión anterior del paquete (requerido).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: upgrade it from the previous version.
es: Actualiza ahora a la versión actual.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: downgrade it back to the previous version (optional).
es: Vuelve a la versión anterior (opcional).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: purge it.
es: Elimínalo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the new package.
es: Instala la nueva versión del paquete.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: remove it.
es: Elimínalo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install it again.
es: Instálalo de nuevo.

note: type: Content of: <book><chapter><section><para>
en: If this is your first package, you should create dummy packages with different versions to test your package in advance to prevent future problems.
es: Si estás trabajando en la construcción de la primera versión del paquete, construye versiones «fantasma» anteriores (será suficiente cambiar el número de la versión) para realizar las pruebas y así prevenir problemas.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that if your package has previously been released in Debian, people will often be upgrading to your package from the version that was in the last Debian release.  Remember to test upgrades from that version too.
es: Recuerda que si ya hay versiones anteriores del paquete en el repositorio Debian, los usuarios actualizarán el paquete desde la versión anterior disponible (y esta versión puede ser distinta en la versión estable y de pruebas).  Realiza las comprobaciones también con estas versiones.

note: type: Content of: <book><chapter><section><para>
en: Although downgrading is not officially supported, supporting it is a friendly gesture.
es: Aunque no se garantiza la reinstalación de una versión anterior, es preferible asegurarse que es posible sin generar problemas.

note: type: Content of: <book><chapter><section><title>
en: Using <systemitem role="package">lintian</systemitem>
es: El paquete <systemitem role="package">lintian</systemitem>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You do not need to provide the <command>lintian</command> option <literal>-i -I --show-overrides</literal> if you customized <filename>/etc/devscripts.conf</filename> or <filename>~/.devscripts</filename> as described in <xref linkend="debuild"/>.
es: No es necesario añadir la opción <literal>-i -I --show-overrides</literal> a la orden <command>lintian</command> si la has incluido en la configuración en <filename>/etc/devscripts.conf</filename> o <filename>~/.devscripts</filename> según se explicó en <xref linkend="debuild"/> .

note: type: Content of: <book><chapter><section><para>
en: Run <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> on your <filename>.changes</filename> file.  The <command>lintian</command> command runs many test scripts to check for many common packaging errors.  <placeholder type="footnote" id="0"/>
es: Ejecuta <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> en tu archivo <filename>.changes</filename>. La orden <command>lintian</command> ejecutará varios guiones para revisar los errores más frecuentes de los paquetes <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of the <filename>.changes</filename> file generated for your package.  The output of the <command>lintian</command> command uses the following flags:
es: Por supuesto, cambia el nombre del fichero por el nombre del fichero <filename>.changes</filename> generado por tu paquete.  Los mensajes de error de <command>lintian</command> se codifican con una letra al inicio de la línea del mensaje:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>E:</literal> for error; a sure policy violation or packaging error.
es: <literal>E:</literal> para los errores; indica violaciones de las normas o un error en el paquete.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>W:</literal> for warning; a possible policy violation or packaging error.
es: <literal>W:</literal> para las advertencias; indica una posible violación de las normas o error en el paquete (pero pudiendo ser una falsa alarma).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>I:</literal> for info; information on certain aspects of packaging.
es: <literal>I:</literal> para información; proporciona algo de información sobre algún aspecto del paquete (que tal vez sea mejorable).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>N:</literal> for note; a detailed message to help your debugging.
es: <literal>N:</literal> para las notas o anotaciones; proporciona mensajes detallados que pueden ayudarte en la depuración del paquete.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>O:</literal> for overridden; a message overridden by the <filename>lintian-overrides</filename> files but displayed by the <literal>--show-overrides</literal> option.
es: <literal>O:</literal> para mensajes ignorados; un mensaje ignorado (según lo configurado en los archivos <filename>lintian-overrides</filename> pero que se emite debido a la opción <literal>--show-overrides</literal>.

note: type: Content of: <book><chapter><section><para>
en: When you see warnings, tune the package to avoid them or verify that the warnings are spurious.  If spurious, set up <filename>lintian-overrides</filename> files as described in <xref linkend="lintian"/>.
es: En el caso de los errores (líneas que comienzan por E:), lee la explicación (líneas N:), cambia el paquete para eliminarlos o verifica que los avisos son falsos. En este caso, genera los archivos <filename>lintian-overrides</filename> como se ha descrito en <xref linkend="lintian"/>.

note: type: Content of: <book><chapter><section><para>
en: Note that you can build the package with <command>dpkg-buildpackage</command> and run <command>lintian</command> on it in one command, if you use <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
es: Observa que puedes construir el paquete con <command>dpkg-buildpackage</command> y ejecutar <command>lintian</command> todo con sólo una orden si utilizas <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: The <command>debc</command> command
es: La orden <command>debc</command>

note: type: Content of: <book><chapter><section><para>
en: You can list files in the binary Debian package with the <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
es: Puedes ver la lista de archivos del paquete binario Debian ejecutando la orden <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> como sigue:

note: type: Content of: <book><chapter><section><screen>
en: $ debc <replaceable>package</replaceable>.changes
es: $ debc <replaceable>nombre_del_paquete</replaceable>.changes

note: type: Content of: <book><chapter><section><title>
en: The <command>debdiff</command> command
es: La orden <command>debdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare file contents in two source Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
es: Puedes comparar el contenido de dos paquetes de fuentes Debian ejecutando la orden <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> como sigue:

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.dsc <replaceable>new-package</replaceable>.dsc
es: $ debdiff <replaceable>versión_anterior</replaceable>.dsc <replaceable>nueva_versión</replaceable>.dsc

note: type: Content of: <book><chapter><section><para>
en: You can also compare file lists in two sets of binary Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
es: Puedes comparar la lista de ficheros de dos paquetes binarios de Debian con la orden <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ejecutando la orden como sigue:

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.changes <replaceable>new-package</replaceable>.changes
es: $ debdiff <replaceable>versión_anterior</replaceable>.changes <replaceable>nueva_versión</replaceable>.changes

note: type: Content of: <book><chapter><section><para>
en: These are useful to identify what has been changed in the source packages and to check for inadvertent changes made when updating binary packages, such as unintentionally misplacing or removing files.
es: Este programa es útil para verificar que no hay ficheros que se hayan cambiado de sitio o eliminado por error, y que no se ha realizado ningún otro cambio no deseado al actualizar el paquete.

note: type: Content of: <book><chapter><section><title>
en: The <command>interdiff</command> command
es: La orden <command>interdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare two <filename>diff.gz</filename> files with the <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.  This is useful for verifying that no inadvertent changes were made to the source by the maintainer when updating packages in the old <literal>1.0</literal> source format.
es: Puedes comparar dos ficheros <filename>diff.gz</filename> con la orden <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Esto es muy útil para verificar que no se han realizado cambios inadvertidos por el responsable del paquete al actualizar el paquetes que se han construido con el formato <literal>1.0</literal>.  Ejecuta lo siguiente:

note: type: Content of: <book><chapter><section><screen>
en: $ interdiff -z <replaceable>old-package</replaceable>.diff.gz <replaceable>new-package</replaceable>.diff.gz
es: $ interdiff -z <replaceable>versión_anterior</replaceable>.diff.gz <replaceable>nueva_versión</replaceable>.diff.gz

note: type: Content of: <book><chapter><section><para>
en: The new <literal>3.0</literal> source format stores changes in multiple patch files as described in <xref linkend="patches"/>.  You can trace changes of each <filename>debian/patches/*</filename> file using <command>interdiff</command>, too.
es: El nuevo formato de fuentes <literal>3.0</literal> conserva los cambios en varios archivos de parches («.patch») como se describe en <xref linkend="patches"/>. Puedes seguir los cambios realizados por cada archivo <filename>debian/patches/*</filename> utilizando la orden <command>interdiff</command>.

note: type: Content of: <book><chapter><section><title>
en: The <command>mc</command> command
es: La orden <command>mc</command>

note: type: Content of: <book><chapter><section><para>
en: Many of these file inspection operations can be made into an intuitive process by using a file manager like <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> which will let you browse not only the contents of <filename>*.deb</filename> package files but also <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, and <filename>*.orig.tar.gz</filename> files.
es: Algunas de las operaciones de comprobación del paquete descritas puede realizarse de forma muy intuitiva si empleamos un gestor de ficheros como <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, que permite visionar tanto el contenido del paquete <filename>*.deb</filename>, como el de los ficheros <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, <filename>*.orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><para>
en: Be on the lookout for extra unneeded files or zero length files, both in the binary and source package.  Often cruft doesn't get cleaned up properly; adjust your <filename>rules</filename> file to compensate for this.
es: Vigila que no haya ficheros innecesarios extra o de tamaño cero, tanto en el binario como en el paquete fuente.  A veces, hay cosas que no se limpiaron adecuadamente, debes ajustar tu fichero <filename>rules</filename> para arreglar esto.

note: type: Content of: <book><chapter><title>
en: Updating the package
es: Actualizar el paquete

note: type: Content of: <book><chapter><para>
en: After you release a package, you will soon need to update it.
es: Después del lanzamiento del paquete, es posible que debas actualizarlo pronto.

note: type: Content of: <book><chapter><section><title>
en: New Debian revision
es: Nueva revisión Debian del paquete

note: type: Content of: <book><chapter><section><para>
en: Let's say that a bug report was filed against your package as <literal>#654321</literal>, and it describes a problem that you can solve.  Here's what you need to do to create a new Debian revision of the package:
es: Supongamos que se ha creado un informe de fallo en tu paquete con el número <literal>#654321</literal>, y que describe un problema que puedes solucionar.  Para construir una nueva revisión del paquete, necesitas:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to be recorded as a new patch, do the following:
es: Si debes aplicar una modificación nueva, ejecuta:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt new <replaceable>bugname.patch</replaceable></literal> to set the patch name;
es: <literal>dquilt new <replaceable>nombre_modificación.patch</replaceable></literal> para establecer el nombre de la modificación;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt add <replaceable>buggy-file</replaceable></literal> to declare the file to be modified;
es: <literal>dquilt add <replaceable>archivo_a_modificar</replaceable></literal> para establecer el fichero al cual se aplicará la modificación.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the package source for the upstream bug;
es: Corregir el problema en el archivo original.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to record it to <filename><replaceable>bugname.patch</replaceable></filename>;
es: <literal>dquilt refresh</literal> para guardar los cambios realizados en el archivo del parche <filename><replaceable>nombre_modificación.patch</replaceable></filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to add its description;
es: <literal>dquilt header -e</literal> para añadir la descripción (breve) del cambio realizado;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to update an existing patch, do the following:
es: Si debes actualizar una modificación ya existente, ejecuta:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> to recall the existing <filename><replaceable>foo.patch</replaceable></filename>;
es: <literal>dquilt pop <replaceable>nombre_modificación.patch</replaceable></literal> para deshacer el parche <filename><replaceable>nombre_modificación.patch</replaceable></filename> que debes actualizar (puesto que se habrá ejecutado y se supone que es necesario modificarlo).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the old <filename><replaceable>foo.patch</replaceable></filename>;
es: Corregir el problema existente en la versión incorrecta del archivo de parche <filename><replaceable>nombre_modificación.patch</replaceable></filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update <filename><replaceable>foo.patch</replaceable></filename>;
es: <literal>dquilt refresh</literal> para actualizar <filename><replaceable>nombre_modificación.patch</replaceable></filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to update its description;
es: <literal>dquilt header -e</literal> para actualizar la descripción en la cabecera del archivo del parche.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>;
es: <literal>while dquilt push; do dquilt refresh; done</literal> para aplicar todos los parches eliminando <emphasis>cosas innecesarias</emphasis>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: To get the date in the required format, use <literal>LANG=C date -R</literal>.
es: Para escribir la fecha y hora en el formato requerido, debes utilizar <literal>LANG=C date -R</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add a new revision at the top of the Debian <filename>changelog</filename> file, for example with <literal>dch -i</literal>, or explicitly with <literal>dch -v <replaceable>version</replaceable>-<replaceable>revision</replaceable></literal> and then insert the comments using your preferred editor.  <placeholder type="footnote" id="0"/>
es: Añadir la información de la revisión en el inicio del archivo <filename>changelog</filename> (del directorio «Debian»), por ejemplo ejecutando <literal>dch -i</literal> o explícitamente indicando el número de versión y revisión ejecutando <literal>dch -v <replaceable>versión</replaceable>-<replaceable>revisión</replaceable></literal>, y a continuación detallar los cambios realizados utilizando un editor <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Include a short description of the bug and the solution in the changelog entry, followed by <literal>Closes: #654321</literal>.  That way, the bug report will be <emphasis>automagically</emphasis> closed by the archive maintenance software the moment your package gets accepted into the Debian archive.
es: Incluye la descripción (breve) del error y la solución, seguida de la referencia de la notificación del error con <literal>(Closes: #654321)</literal>.  De esta manera, el informe de error sera «cerrado» <emphasis>automáticamente</emphasis> por el sistema de mantenimiento del repositorio Debian cuando el paquete sea aceptado en el repositorio.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in the above to fix more bugs while updating the Debian <filename>changelog</filename> file with <literal>dch</literal> as needed.
es: Deberás repetir los pasos anteriores para cada una de las modificaciones realizadas en la actualización del paquete, a la par que actualizas el fichero <filename>changelog</filename> de Debian mediante <literal>dch</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in <xref linkend="completebuild"/> and <xref linkend="checkit"/>.
es: Repite lo que hiciste en <xref linkend="completebuild"/> y <xref linkend="checkit"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Once you are satisfied, you should change the distribution value in <filename>changelog</filename> from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).<placeholder type="footnote" id="0"/>
es: Una vez que estes satisfecho, cambia el nombre de la distribución en el archivo <filename>changelog</filename> de <literal>UNRELEASED</literal> a <literal>unstable</literal> (o bien <literal>experimental</literal>).<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Inspection of the new upstream release
es: Inspección de una nueva versión del autor

note: type: Content of: <book><chapter><section><para>
en: Start by reading the upstream <filename>changelog</filename>, <filename>NEWS</filename>, and whatever other documentation they may have released with the new version.
es: Empieza por leer los archivos <filename>changelog</filename>, <filename>NEWS</filename> y cualquier otra documentación donde el autor original describa los cambios de la nueva versión.

note: type: Content of: <book><chapter><section><para>
en: You can then inspect changes between the old and new upstream sources as follows, watching out for anything suspicious:
es: Puedes comprobar los cambios entre las fuentes originales de la nueva versión y de la anterior para detectar cualquier cambio sospechoso de producir errores ejecutando:

note: type: Content of: <book><chapter><section><screen>
en: $ diff -urN <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable> <replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
es: $ diff -urN <replaceable>nombre_archivo</replaceable>-<replaceable>versión_anterior</replaceable> <replaceable>nombre_archivo</replaceable>-<replaceable>nueva_versión</replaceable>

note: type: Content of: <book><chapter><section><para>
en: Changes to some auto-generated files by Autotools such as <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename>, and <filename>Makefile.in</filename> may be ignored.  You may delete them before running <command>diff</command> on the source for inspection.
es: Las modificaciones realizadas en los archivos generados por «Autotools» (<filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename> y <filename>Makefile.in</filename>) puedes ignorarlas.  Puedes eliminarlos antes de ejecutar <command>diff</command> en las fuentes para inspeccionarlas.

note: type: Content of: <book><chapter><section><title>
en: New upstream release
es: Nueva versión del programa fuente

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is packaged in the old <literal>1.0</literal> format, this can be done by running <literal>zcat /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.diff.gz|patch -p1</literal> in the new extracted source, instead.
es: Si el paquete <systemitem role="package"><replaceable>nombre_del_paquete</replaceable></systemitem> está construido con el anterior formato <literal>1.0</literal>, esto se puede hacer ejecutando <literal>zcat /<replaceable>ruta</replaceable>/<replaceable>a</replaceable>/<replaceable>nombre_del_paquete</replaceable>_<replaceable>numero_de_versión_anterior</replaceable>.diff.gz|patch -p1</literal> en la nueva versión de las fuentes.

note: type: Content of: <book><chapter><section><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is properly packaged in the newer <literal>3.0 (native)</literal> or <literal>3.0 (quilt)</literal> formats, packaging a new upstream version is essentially moving the old <filename>debian</filename> directory to the new source.  This can be done by running <literal>tar xvzf /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.debian.tar.gz</literal> in the new extracted source.  <placeholder type="footnote" id="0"/> Of course, you need to do some obvious chores:
es: Si el paquete <systemitem role="package"><replaceable>nombre_del_paquete</replaceable></systemitem> que examinas está correctamente empaquetado utilizando los nuevos formatos <literal>3.0 (native)</literal> o <literal>3.0 (quilt)</literal> para empaquetar una nueva versión del autor es esencial copiar el directorio <filename>debian</filename> de la versión anterior a la nueva, para a continuación, realizar las adaptaciones necesarias. Puedes copiar el directorio <filename>debian</filename> de la versión anterior a la nueva versión ejecutando <literal>tar xvzf /<replaceable>ruta</replaceable>/<replaceable>a</replaceable>/<replaceable>nombre_del_paquete</replaceable>_<replaceable>versión_anterior</replaceable>.debian.tar.gz</literal> desde el directorio de las fuentes de la nueva versión <placeholder type="footnote" id="0"/>. A continuación deberás realizar algunos tareas obvias:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a copy of the upstream source as the <filename>foo_<replaceable>newversion</replaceable>.orig.tar.gz</filename> file.
es: Comprimir las fuentes originales en el archivo <filename>nombre_del_paquete_<replaceable>nueva_versión</replaceable>.orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Update the Debian <filename>changelog</filename> file with <literal>dch -v <replaceable>newversion</replaceable>-<replaceable>1</replaceable></literal>.
es: Actualizar el archivo <filename>changelog</filename> Debian ejecutando <literal>dch -v <replaceable>nueva_versión</replaceable>-<replaceable>1</replaceable></literal> .

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add an entry with <literal>New upstream release</literal>.
es: Añade una nueva linea con el texto «New upstream release» para indicar que se trata de una nueva versión de las fuentes originales.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>in the new upstream release</emphasis> that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
es: Describe sucintamente los cambios realizados <emphasis>en las fuentes originales por el autor</emphasis> que solucionan errores informados y cerrar los informes añadiendo <literal>Closes: #<replaceable>numero_del_error</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>to the new upstream release</emphasis> by the maintainer that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
es: Describe sucintamente los cambios de la <emphasis>nueva versión</emphasis> del desarrollador que solucionan errores previamente reportados y cierra dichos errores añadiendo <literal>Closes: #<replaceable>número_del_error</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>.
es: <literal>while dquilt push; do dquilt refresh; done</literal> para aplicar todos los parches eliminando <emphasis>cosas innecesarias</emphasis>;

note: type: Content of: <book><chapter><section><para>
en: If the patch/merge did not apply cleanly, inspect the situation (clues are left in <filename>.rej</filename> files).
es: Si las modificaciones no se ejecutan correctamente, inspecciona la situación (mira la información de los archivos <filename>.rej</filename>) como se muestra a continuación.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source was integrated into the upstream source,
es: Si uno de los parches aplicados está integrado en las fuentes originales,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt delete</literal> to remove it.
es: ejecuta <literal>dquilt delete</literal> para eliminarlo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source conflicted with new changes in the upstream source,
es: Si uno de los parches entra en conflicto con los cambios realizados por el autor en las fuentes originales,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt push -f</literal> to apply old patches while forcing rejects as <filename><replaceable>baz</replaceable>.rej</filename>.
es: ejecuta <literal>dquilt push -f</literal> para aplicar los parches de la versión anterior para forzar los rechazos (tendrás la información de los rechazos en los archivos <filename><replaceable>rechazo</replaceable>.rej</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Edit the <filename><replaceable>baz</replaceable></filename> file manually to bring about the intended effect of <filename><replaceable>baz</replaceable>.rej</filename>.
es: Edita los archivos <filename><replaceable>rechazo</replaceable>.rej</filename> manualmente para saber el efecto que se pretende con <filename><replaceable>rechazo</replaceable>.rej</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update the patch.
es: Ejecuta <literal>dquilt refresh</literal> para actualizar el parche.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Continue as usual with <literal>while dquilt push; do dquilt refresh; done</literal>.
es: Continua hasta la ejecución de <literal>while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><section><para>
en: This process can be automated using the <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command as follows:
es: Puedes automatizar este proceso utilizando la orden <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> como sigue:

note: type: Content of: <book><chapter><section><screen>
en: $ apt-get source <replaceable>foo</replaceable>
    ...
    dpkg-source: info: extracting <replaceable>foo</replaceable> in <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    dpkg-source: info: unpacking <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    dpkg-source: info: applying <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>/
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.dsc
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>foo</replaceable>/<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    $ uupdate -v <replaceable>newversion</replaceable> ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... document changes made
es: $ apt-get source <replaceable>nombre_del_paquete</replaceable>
    ...
    dpkg-source: info: extracting <replaceable>nombre_del_paquete</replaceable> in <replaceable>nombre_del_paquete</replaceable>-<replaceable>versión_anterior</replaceable>
    dpkg-source: info: unpacking <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión_anterior</replaceable>.orig.tar.gz
    dpkg-source: info: applying <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión_anterior</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>nombre_del_paquete</replaceable>-<replaceable>versión_anterior</replaceable>/
    <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión_anterior</replaceable>-1.debian.tar.gz
    <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión_anterior</replaceable>-1.dsc
    <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión_anterior</replaceable>.orig.tar.gz
    $ wget http://ejemplo.org/<replaceable>nombre_del_paquete</replaceable>/<replaceable>nombre_del_paquete</replaceable>-<replaceable>nueva_versión</replaceable>.tar.gz
    $ cd <replaceable>nombre_del_paquete</replaceable>-<replaceable>versión_anterior</replaceable>
    $ uupdate -v <replaceable>nueva_versión</replaceable> ../<replaceable>nombre_del_paquete</replaceable>-<replaceable>nueva_versión</replaceable>.tar.gz
    $ cd ../<replaceable>nombre_del_paquete</replaceable>-<replaceable>nueva_versión</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... documenta las modificaciones realizadas

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the <command>uscan</command> command downloads the updated source but it does not run the <command>uupdate</command> command, you should correct the <filename>debian/watch</filename> file to have <literal>debian uupdate</literal> at the end of the URL.
es: Si la orden <command>uscan</command> descargar las fuentes pero no ejecuta la orden <command>uupdate</command>, debes corregir el archivo <filename>debian/watch</filename> añadiendo <literal>debian uupdate</literal> al final de la URL del archivo.

note: type: Content of: <book><chapter><section><para>
en: If you set up a <filename>debian/watch</filename> file as described in <xref linkend="watch"/>, you can skip the <command>wget</command> command.  You simply run <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> in the <filename><replaceable>foo</replaceable>-<replaceable>oldversion</replaceable></filename> directory instead of the <command>uupdate</command> command.  This will <emphasis>automagically</emphasis> look for the updated source, download it, and run the <command>uupdate</command> command.  <placeholder type="footnote" id="0"/>
es: Si has configurado el archivo «<filename>debian/watch</filename>» como se ha descrito en <xref linkend="watch"/> ,puedes saltarte la orden <command>wget</command>.  Simplemente, ejecuta <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> en el directorio <filename><replaceable>nombre_del_paquete</replaceable>-<replaceable>antigua_versión</replaceable></filename> en lugar de la orden <command>uupdate</command>. Así, se buscará <emphasis>automáticamente</emphasis> el archivo de las fuentes, se descargará en tu ordenador y se ejecutará la orden <command>uupdate</command> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: You can release this updated source by repeating what you did in <xref linkend="completebuild"/>, <xref linkend="checkit"/>, and <xref linkend="upload"/>.
es: Puedes liberar la nueva versión del paquete repitiendo lo expuesto en <xref linkend="completebuild"/> , <xref linkend="checkit"/> y <xref linkend="upload"/> .

note: type: Content of: <book><chapter><section><title>
en: Updating the packaging style
es: Actualizar el formato del paquete

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If your sponsor or other maintainers object to updating the existing packaging style, don't bother arguing.  There are more important things to do.
es: Si quien patrocina tu paquete u otros desarrolladores hacen objeciones a la actualización del formato del paquete, no vale la pena empeñarse en argumentar a favor.  Hay otras cosas más importantes que atender.

note: type: Content of: <book><chapter><section><para>
en: Updating the package style is not a required activity for the update of a package.  However, doing so lets you use the full capabilities of the modern <systemitem role="package">debhelper</systemitem> system and the <literal>3.0</literal> source format.  <placeholder type="footnote" id="0"/>
es: Para actualizar un paquete no es necesario actualizar el formato del paquete.  Aún así, puedes aprovechar completamente la funcionalidad de <systemitem role="package">debhelper</systemitem> y del formato <literal>3.0</literal> haciendo lo siguiente <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you need to recreate deleted template files for any reason, you can run <command>dh_make</command> again in the same Debian package source tree with the <literal>--addmissing</literal> option.  Then edit them appropriately.
es: Si necesitas de nuevo algunos de los archivos de plantilla eliminados, puedes regenerarlos ejecutando otra vez <command>dh_make</command> con la opción <literal>--addmissing</literal> en el directorio de las fuentes.  A continuación modifícalos correctamente.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If the package has not been updated to use the <systemitem role="package">debhelper</systemitem> v7+ <command>dh</command> syntax for the <filename>debian/rules</filename> file, update it to use <command>dh</command>.  Update the <filename>debian/control</filename> file accordingly.
es: Si el paquete no está actualizado para utilizar la nueva sintaxis de la versión 7+ de la orden <command>dh</command> de <systemitem role="package">debhelper</systemitem>   en el archivo <filename>debian/rules</filename>, actualízalo para usar <command>dh</command>. También deberás actualizar <filename>debian/control</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you want to update the <filename>rules</filename> file created with the <filename>Makefile</filename> inclusion mechanism of the Common Debian Build System (<systemitem role="package">cdbs</systemitem>) to the <command>dh</command> syntax, see the following to understand its <literal>DEB_*</literal> configuration variables.
es: Si deseas actualizar el archivo <filename>rules</filename> construido por el mecanismo de inclusión <filename>Makefile</filename> del sistema de compilación Debian (<systemitem role="package">cdbs</systemitem>) a la nueva sintaxis <command>dh</command>, lee el siguiente documento para comprender las variables de configuración <literal>DEB_*</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: local copy of <filename>&cdbs-doc;</filename>
es: copia local de <filename>&cdbs-doc;</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package without the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (native)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (native)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.
es: Si estás trabajando con un paquete construido con el formato <literal>1.0</literal> sin el archivo <filename><replaceable>nombre_del_paquete</replaceable>.diff.gz</filename>, puedes actualizarlo a la nueva versión <literal>3.0 (native)</literal> añadiendo el archivo <filename>debian/source/format</filename> con la linea <literal>3.0 (native)</literal>.  Copia los otros archivos del directorio <filename>debian/*</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can split <filename>big.diff</filename> into many small incremental patches using the <command>splitdiff</command> command.
es: Puedes fragmentar el archivo <filename>nombre_del_paquete.diff</filename> en varios archivos de parches utilizando la orden <command>splitdiff</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package with the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (quilt)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (quilt)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.  Import the <filename>big.diff</filename> file generated by the command <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal> to your <command>quilt</command> system, if needed.  <placeholder type="footnote" id="0"/>
es: Si estás trabajando con un paquete construido con el formato <literal>1.0</literal> con el archivo <filename><replaceable>nombre_del_paquete</replaceable>.diff.gz</filename>, puedes actualizarlo a la nueva versión <literal>3.0 (native)</literal> añadiendo el archivo <filename>debian/source/format</filename> con la linea <literal>3.0 (native)</literal>.  Copia los otros archivos del directorio <filename>debian/*</filename>.  Importa el archivo <filename>nombre_del_paquete.diff</filename> generado por la orden <literal>filterdiff -z -x '*/debian/*' <replaceable>nombre_del_paquete</replaceable>.diff.gz &gt; nombre_del_paquete.diff</literal> al sistema <command>quilt</command> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged using another patch system such as <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem>, or <systemitem role="package">cdbs</systemitem> with <literal>-p0</literal>, <literal>-p1</literal>, or <literal>-p2</literal>, convert it to <systemitem role="package">quilt</systemitem> using <filename>deb3</filename> at <ulink url="&deb3;"/>.
es: Si el paquete se ha construido utilizando un sistema de parches distinto como <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem> o <systemitem role="package">cdbs</systemitem> utilizando las opciones <literal>-p0</literal>, <literal>-p1</literal> o <literal>-p2</literal>, puedes convertirlo al formato <systemitem role="package">quilt</systemitem> utilizando el guión <filename>deb3</filename> explicado en <ulink url="&deb3;"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged with the <command>dh</command> command with the <literal>--with quilt</literal> option or with the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands, remove these and make it use the newer <literal>3.0 (quilt)</literal> source format.
es: Si el paquete se ha construido ejecutando la orden <command>dh</command> con la opción <literal>--with quilt</literal> o bien con <command>dh_quilt_patch</command> y <command>dh_quilt_unpatch</command>, elimina todo esto y utiliza el nuevo formato fuente <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><para>
en: You should check <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> and adopt ACCEPTED proposals.
es: Consulte <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> y adoptar las propuestas ACEPTADAS.

note: type: Content of: <book><chapter><section><para>
en: You need to do the other tasks described in <xref linkend="newupstream"/>, too.
es: Repasa la sección <xref linkend="newupstream"/> por si debes repetir algunos de los pasos indicados en ella.

note: type: Content of: <book><chapter><section><title>
en: UTF-8 conversion
es: Conversión a UTF-8

note: type: Content of: <book><chapter><section><para>
en: If upstream documents are encoded in old encoding schemes, converting them to <ulink url="&utf8;">UTF-8</ulink> is a good idea.
es: Si los documentos originales utilizan una codificación antigua, es una buen práctica actualizarlos a <ulink url="&utf8;">UTF-8</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert encodings of plain text files.
es: Utiliza <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> para hacer conversiones de codificación en ficheros de texto sin formato.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert from HTML files to UTF-8 plain text files.  When you do this, make sure to execute it under UTF-8 locale.
es: Utiliza <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> para conversiones desde ficheros HTML a ficheros de texto sin formato con codificación UTF-8. Al hacerlo, el sistema debe estar configurado para usar la codificación UTF-8.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><screen>
en: LC_ALL=en_US.UTF-8 w3m -o display_charset=UTF-8 \
            -cols 70 -dump -no-graph -T text/html \
            &lt; <replaceable>foo_in.html</replaceable> &gt; <replaceable>foo_out.txt</replaceable>
es: LC_ALL=C.UTF-8 w3m -o display_charset=UTF-8 \
            -cols 70 -dump -no-graph -T text/html \
            &lt; <replaceable>nombre_del_archivo_a_modificar.html</replaceable> &gt; <replaceable>nombre_del_archivo_modificado.txt</replaceable>

note: type: Content of: <book><chapter><section><title>
en: Reminders for updating packages
es: Recordatorio para actualizar paquetes

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Preserve old <filename>changelog</filename> entries (sounds obvious, but there have been cases of people typing <literal>dch</literal> when they should have typed <literal>dch -i</literal>.)
es: Conserva las entradas anteriores del archivo <filename>changelog</filename> (suena a obviedad, pero se han dado casos de ejecutar <literal>dch</literal> en lugar de <literal>dch -i</literal>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Existing Debian changes need to be reevaluated; throw away stuff that upstream has incorporated (in one form or another) and remember to keep stuff that hasn't been incorporated by upstream, unless there is a compelling reason not to.
es: Los cambios en la construcción del paquete Debian deben ser reconsiderados; elimina las modificaciones anteriores (sea lo que sea) y recuerda de añadir todo lo necesario, a no ser que haya una buena razón para no hacerlo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If any changes were made to the build system (hopefully you'd know from inspecting upstream changes) then update the <filename>debian/rules</filename> and <filename>debian/control</filename> build dependencies if necessary.
es: Si se ha realizado alguna modificación en la compilación (te enterarás al inspeccionar los cambios en las fuentes originales) puede que sea necesario actualizar el archivo <filename>debian/rules</filename> y las dependencias de compilación en el archivo <filename>debian/control</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink> to see if someone has provided patches to bugs that are currently open.
es: Debes comprobar si hay alguna comunicación de parches del paquete en el sistema de gestión de errores (puede darse el caso que algún usuario envíe un parche ya construido y que te sea de utilidad) en <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the contents of the <filename>.changes</filename> file to make sure you are uploading to the correct distribution, the proper bug closures are listed in the <literal>Closes</literal> field, the <literal>Maintainer</literal> and <literal>Changed-By</literal> fields match, the file is GPG-signed, etc.
es: Comprueba el contenido del archivo <filename>.changes</filename> para asegurarte que envías el paquete a la distribución correcta, que los informes de errores que se cierran con la nueva versión del paquete están listados en el campo <literal>Closes</literal> del archivo, que el contenido de los campos <literal>Maintainer</literal> y <literal>Changed-By</literal> son correctos, que has firmado el archivo con tu clave GPG, etc.

note: type: Content of: <book><chapter><title>
en: Uploading the package
es: Enviar el paquete

note: type: Content of: <book><chapter><para>
en: Now that you have tested your new package thoroughly, you want to release it to a public archive to share it.
es: Ahora que has probado tu nuevo paquete en profundidad, podrás transferirlo a un archivo público para compartirlo.

note: type: Content of: <book><chapter><section><title>
en: Uploading to the Debian archive
es: Enviar al repositorio de Debian

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <xref linkend="socialdynamics"/>.
es: Consulta <xref linkend="socialdynamics"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are publicly accessible archives such as <ulink url="&mentors-dn;"/> which work almost the same way as the Debian archive and provide an upload area for non-DDs.  You can set up an equivalent archive by yourself using the tools listed at <ulink url="&deb-archive;"/>.  So this section is useful for non-DDs, too.
es: Hay archivos públicamente accesibles, como <ulink url="&mentors-dn;"/> que funcionan de forma similar al archivo Debian y facilitan un sistema de transferencia de paquetes para personas que no son desarrolladores oficiales («DD»). Tu puedes construirte un archivo personal utilizando las herramientas listadas en <ulink url="&deb-archive;"/>. Así, esta sección también es útil si no eres «DD».

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <systemitem role="package">dput</systemitem> package seems to come with more features and to be becoming more popular than the <systemitem role="package">dupload</systemitem> package.  It uses the file <filename>/etc/dput</filename> for its global configuration and the file <filename>~/.dput.cf</filename> for per-user configuration.  It supports Ubuntu-related services out-of-the-box, too.
es: Tal vez el paquete <systemitem role="package">dput</systemitem> tenga más funcionalidades y sea más popular que <systemitem role="package">dupload</systemitem>. Utiliza el archivo <filename>/etc/dput</filename> para la configuración global y el archivo <filename>~/.dput.cf</filename> para la configuración del usuario.  También incorpora la asistencia para Ubuntu.

note: type: Content of: <book><chapter><section><para>
en: Once you become an official developer, <placeholder type="footnote" id="0"/> you can upload the package to the Debian archive.  <placeholder type="footnote" id="1"/> You can do this manually, but it's easier to use the existing automated tools, like <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  We'll describe how it's done with <command>dupload</command>.  <placeholder type="footnote" id="2"/>
es: Cuando seas desarrollador oficial Debian <placeholder type="footnote" id="0"/>, podrás transferir el paquete al repositorio de Debian <placeholder type="footnote" id="1"/>.  Puedes hacer esto manualmente, pero es más fácil hacerlo con las herramientas automáticas ya disponibles como <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. A continuación describiremos cómo hacerlo con <command>dupload</command> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: First you have to set up <command>dupload</command>'s config file.  You can either edit the system-wide <filename>/etc/dupload.conf</filename> file, or have your own <filename>~/.dupload.conf</filename> file override the few things you want to change.
es: En primer lugar, debes generar un fichero de configuración de <command>dupload</command>. Puedes hacerlo editando el fichero general del sistema <filename>/etc/dupload.conf</filename>, o generando tu propio fichero <filename>~/.dupload.conf</filename> con lo que tu quieras cambiar.

note: type: Content of: <book><chapter><section><para>
en: You can read the <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> manual page to understand what each of these options means.
es: Consulta el manual de <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> para saber el significado de cada opción.

note: type: Content of: <book><chapter><section><para>
en: The <literal>$default_host</literal> option determines which of the upload queues will be used by default.  <literal>anonymous-ftp-master</literal> is the primary one, but it's possible that you will want to use another one.  <placeholder type="footnote" id="0"/>
es: La opción <literal>$default_host</literal> es la más problemática; determina cuál de las colas de envíos se usará por omisión. «<literal>anonymous-ftp-master</literal>» es la primaria, pero es posible que quieras usar otra más rápida <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: While connected to the Internet, you can upload your package as follows:
es: Si tienes conexión a Internet, puedes subir el paquete de la siguiente manera:

note: type: Content of: <book><chapter><section><screen>
en: $ dupload gentoo_0.9.12-1_i386.changes
es:   dupload gentoo_0.9.12-1_i386.changes

note: type: Content of: <book><chapter><section><para>
en: <command>dupload</command> checks that the SHA1/SHA256 file checksums match those listed in the <filename>.changes</filename> file.  If they do not match, it will warn you to rebuild it as described in <xref linkend="completebuild"/> so it can be properly uploaded.
es: <command>dupload</command> comprueba que las sumas MD5/SHA1/SHA256 de los archivos transferidos coinciden con las listadas en el fichero <filename>.changes</filename>, si no coinciden te avisará para que reconstruyas el paquete como se describe en <xref linkend="completebuild"/> para poder enviarlo correctamente.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&uploadqueue-readme;"/>.  Alternatively, you can use the <command>dcut</command> command from the <systemitem role="package">dput</systemitem> package.
es: Consulta <ulink url="&uploadqueue-readme;"/>. Como alternativa, puedes usar la orden <command>dcut</command> del paquete <systemitem role="package">dput</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: If you encounter an upload problem at <ulink url="&uploadqueue;"/>, you can fix this by manually uploading a GPG-signed <filename>*.commands</filename> file to there with <command>ftp</command>.  <placeholder type="footnote" id="0"/> For example, using <filename>hello.commands</filename>:
es: Si encuentras algún problema con la subida del paquete a <ulink url="&uploadqueue;"/>, puedes arreglarlo subiendo manualmente un fichero <filename>*.commands</filename> firmado con GPG con la orden <command>ftp</command>  <placeholder type="footnote" id="0"/>. Por ejemplo, utiliza <filename>hello.commands</filename>:

note: type: Content of: <book><chapter><section><title>
en: Including <filename>orig.tar.gz</filename> for upload
es: Incluir <filename>orig.tar.gz</filename> para la transferencia del paquete al repositorio.

note: type: Content of: <book><chapter><section><para>
en: When you first upload the package to the archive, you need to include the original <filename>orig.tar.gz</filename> source, too.  If the Debian revision number of this package is neither <literal>1</literal> nor <literal>0</literal>, you must provide the <command>dpkg-buildpackage</command> option <literal>-sa</literal>.
es: Cuando se envía por primera vez al archivo, se debe incluir el archivo <filename>orig.tar.gz</filename> con las fuentes originales. Si el número de revisión Debian del paquete no es ni  <literal>1</literal> ni <literal>0</literal>, debes ejecutar la orden <command>dpkg-buildpackage</command> con la opción <literal>-sa</literal>. Por otra parte, es posible excluir la inclusión del archivo fuente original <filename>orig.tar.gz</filename> con la opción <literal>-sd</literal>.

note: type: Content of: <book><chapter><section><para>
en: For the <command>dpkg-buildpackage</command> command:
es: Para la orden <command>dpkg-buildpackage</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>debuild</command> command:
es: Para la orden <command>debuild</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>pdebuild</command> command:
es: Para la orden <command>pdebuild</command>:

note: type: Content of: <book><chapter><section><para>
en: On the other hand, the <literal>-sd</literal> option will force the exclusion of the original <filename>orig.tar.gz</filename> source.
es: Por otra parte, con la opción <literal>-sd</literal> se evita la inclusión del archivo <filename>orig.tar.gz</filename> con las fuentes originales.

note: type: Content of: <book><chapter><section><title>
en: Skipped uploads
es: Envíos discontinuados

note: type: Content of: <book><appendix><title>
en: Advanced packaging
es: Técnicas avanzadas

note: type: Content of: <book><appendix><para>
en: You may need to manually edit the packaging template files generated by the <command>dh_make</command> command to address topics covered in this chapter.  The newer <command>debmake</command> command should address these topics better.
es: Puede ser necesario editar manualmente los ficheros de las plantillas generadas con la orden <command>dh_make</command>  para abordar los temas tratados en este capítulo. La nueva orden <command>debmake</command> maneja mejor estos aspectos de la construcción de paquetes.

note: type: Content of: <book><appendix><section><title>
en: Shared libraries
es: Bibliotecas compartidas

note: type: Content of: <book><appendix><section><para>
en: Before packaging shared <ulink url="&library;">libraries</ulink>, you should read the following primary references in detail:
es: Antes de empaquetar <ulink url="&library;">bibliotecas</ulink> compartidas, debes leer atentamente la siguientes referencias básicas:

note: type: Content of: <book><appendix><section><para>
en: Here are some oversimplified hints for you to get started:
es: Éstos son algunos consejos básicos para empezar:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are <ulink url="&elf;">ELF</ulink> object files containing compiled code.
es: Las bibliotecas compartidas son archivos objeto en formato <ulink url="&elf;">ELF</ulink> que contienen código compilado.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are distributed as <filename>*.so</filename> files. (Neither <filename>*.a</filename> files nor <filename>*.la</filename> files)
es: Las bibliotecas compartidas se distribuyen como ficheros <filename>*.so</filename> (no como ficheros <filename>*.a</filename> o <filename>*.la</filename>).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are mainly used to share common codes among multiple executables with the <command>ld</command> mechanism.
es: Las bibliotecas compartidas se utilizan principalmente para compartir código común entre varios ejecutables con la orden <command>ld</command>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are sometimes used to provide multiple plugins to an executable with the <command>dlopen</command> mechanism.
es: Las bibliotecas compartidas se utilizan, a veces, para proveer varios complementos («plugins») a un ejecutable mediante el procedimiento <command>dlopen</command>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>
es: Como alternativa: <literal>readelf -d lib<replaceable>nombre_biblioteca</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The <ulink url="&soname;">SONAME</ulink> of a shared library <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>
es: El <ulink url="&soname;">SONAME</ulink> (el nombre lógico) de la biblioteca compartida <filename>lib<replaceable>nombre_biblioteca</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>nombre_biblioteca</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of a shared library usually matches the library file name (but not always).
es: El «SONAME» (el nombre lógico) de una biblioteca compartida generalmente coincide con el nombre del archivo de biblioteca (pero no siempre).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>
es: Como alternativa: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of shared libraries linked to <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>
es: El «SONAME» (el nombre lógico) de las bibliotecas compartidas enlazadas a <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.
es: Véase <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: the library package for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> with the SONAME ABI version <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>
es: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: el paquete de biblioteca de la biblioteca compartida <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> con la versión ABI del nombre lógico («SONAME») <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-ldconfig;">Debian Policy Manual, 8.1.1 "ldconfig"</ulink>.
es: Véase <ulink url="&policy-ldconfig;">Debian Policy Manual, 8.1.1 "ldconfig"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The package maintainer scripts of the library package must call <command>ldconfig</command> under the specific circumstances to create the necessary symbolic links for the SONAME.<placeholder type="footnote" id="0"/>
es: Los guiones de desarrollador de un paquete de biblioteca deben ejecutar <command>ldconfig</command> cuando sea necesario para generar los enlaces simbólicos para el «SONAME» (el nombre lógico).<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> and <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink>.
es: Consulta <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> y <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.
es: Consulta <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.
es: Consulta <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Although it is somewhat outdated and is only a secondary reference, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> may still be useful.
es: Aunque está un poco anticuado y es sólo una referencia secundaria, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> aún puede ser útil.

note: type: Content of: <book><appendix><section><title>
en: Managing <filename>debian/<replaceable>package</replaceable>.symbols</filename>
es: Gestionando <filename>debian/<replaceable>package</replaceable>.symbols</filename>

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Backward-incompatible ABI changes normally require you to update the SONAME of the library and the shared library package name to new ones.
es: Los cambios ABI incompatibles con versiones anteriores, normalmente requieren actualizar el «SONAME» (el nombre lógico) de la biblioteca y el de la biblioteca compartida a otros nuevos.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: For C++ libraries and other cases where tracking individual symbols is too difficult, follow <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink>, instead.
es: Para bibliotecas C++ y otros casos en los que el seguimiento individual de símbolos es difícil, es mejor consultar <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Prepare the skeleton debianized source tree using the upstream <filename>libfoo-1.3.tar.gz</filename> file.
es: Preparar el esqueleto de directorios fuente Debian utilizando el fichero con las fuentes <filename>libfoo-1.3.tar.gz</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If this is the first packaging of the <systemitem role="package">libfoo1</systemitem> package, create the <filename>debian/libfoo1.symbols</filename> file with empty content.
es: Si es la primera versión del paquete <systemitem role="package">libfoo1</systemitem>, genera un fichero <filename>debian/libfoo1.symbols</filename> en blanco.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was packaged as the <systemitem role="package">libfoo1</systemitem> package with the proper <filename>debian/libfoo1.symbols</filename> in its source package, use it again.
es: Si la versión anterior del autor (la <literal>1.2</literal>) fue empaquetada en el paquete <systemitem role="package">libfoo1</systemitem> con el fichero <filename>debian/libfoo1.symbols</filename> adecuado en el paquete fuente, utilízalo otra vez.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: All previous versions of Debian packages are available at <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>.  The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> and <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>
es: Las versiones previas de los paquetes Debian están disponibles en <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>. La revisión Debian del paquete sigue a la versión para facilitar mantenimiento de versiones anteriores («backport») del paquete: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> y <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><screen>
en: $ cd libfoo-1.3
    $ debuild
    ...
    dpkg-gensymbols: warning: some new symbols appeared in the symbols file: ...
     see diff output below
    --- debian/libfoo1.symbols (libfoo1_1.3-1_amd64)
    +++ dpkg-gensymbolsFE5gzx        2012-11-11 02:24:53.609667389 +0900
    @@ -127,6 +127,7 @@
      foo_get_name@Base 1.1
      foo_get_longname@Base 1.2
      foo_get_type@Base 1.1
    + foo_get_longtype@Base 1.3-1
      foo_get_symbol@Base 1.1
      foo_get_rank@Base 1.1
      foo_new@Base 1.1
    ...
es: $ cd libfoo-1.3
    $ debuild
    ...
    dpkg-gensymbols: advertencia: hay símbolos nuevos en el fichero de símbolos: ...
     mire las diferencias a continuación
    --- debian/libfoo1.symbols (libfoo1_1.3-1_amd64)
    +++ dpkg-gensymbolsFE5gzx        2012-11-11 02:24:53.609667389 +0900
    @@ -127,6 +127,7 @@
      foo_get_name@Base 1.1
      foo_get_longname@Base 1.2
      foo_get_type@Base 1.1
    + foo_get_longtype@Base 1.3-1
      foo_get_symbol@Base 1.1
      foo_get_rank@Base 1.1
      foo_new@Base 1.1
    ...

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>
es: La revisión de Debian se deriva de la versión para hacer más fácil el mantenimiento de versiones anteriores («backport») del paquete: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build release packages with tools such as <command>debuild</command> and <command>pdebuild</command>.
es: Compilar paquetes para publicarlos con herramientas como <command>debuild</command> y <command>pdebuild</command>.

note: type: Content of: <book><appendix><section><para><footnote><para>
en: See <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.
es: Véase <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.

note: type: Content of: <book><appendix><section><para>
en: In addition to the above examples, we need to check the ABI compatibility further and bump versions for some symbols manually as needed.  <placeholder type="footnote" id="0"/>
es: Además de los ejemplos anteriores, también debes comprobar la compatibilidad ABI con más atención y actualizar manualmente las versiones de los símbolos (si es necesario). <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><para>
en: Although it is only a secondary reference, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> and its linked web pages may be useful.
es: Aunque es sólo una referencia secundaria, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> y sus enlaces a otras páginas web puede ser útil.

note: type: Content of: <book><appendix><section><title>
en: Multiarch
es: Varias arquitecturas

note: type: Content of: <book><appendix><section><para>
en: The multiarch feature introduced to Debian wheezy integrates support for cross-architecture installation of binary packages (particularly <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, but also other combinations) in <systemitem role="package">dpkg</systemitem> and <systemitem role="package">apt</systemitem>. You should read the following references in detail:
es: La función de varias arquitecturas introducida en Debian «wheezy» integra la instalación en más de una arquitectura de los paquetes binarios (en particular <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, pero también con otras combinaciones) en <systemitem role="package">dpkg</systemitem> y <systemitem role="package">apt</systemitem>. Se recomienda leer atentamente las siguientes referencias:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (upstream)
es: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (desarrollador original)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian situation)
es: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian)

note: type: Content of: <book><appendix><section><para>
en: It uses the triplet such as <literal>i386-linux-gnu</literal> and <literal>x86_64-linux-gnu</literal> for the install path of shared libraries. The actual triplet path is dynamically set into the <literal>$(DEB_HOST_MULTIARCH)</literal> variable using the <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle><manvolnum>1</manvolnum></citerefentry> command for each binary package build. For example, the path to install multiarch libraries are changed as follows:<placeholder type="footnote" id="0"/>
es: Se utilizan tripletes del tipo <literal>i386-linux-gnu</literal> y <literal>x86_64-linux-gnu</literal> para el directorio de instalación de bibliotecas compartidas.  El triplete de trabajo se establece dinámicamente al valor <literal>$(DEB_HOST_MULTIARCH)</literal> por <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> para cada compilación.  Por ejemplo, el directorio de instalación de bibliotecas para varias arquitecturas se cambia como sigue:<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Old path
es: Directorio antiguo

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: i386 multiarch path
es: directorio multi-arquitectura i386

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: amd64 multiarch path
es: directorio multi-arquitectura amd64

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a library source <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>
es: el código fuente de la biblioteca <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>bar</replaceable>-1.tar.gz</filename> written in a compiled language
es: el código fuente de una orden <filename><replaceable>bar</replaceable>-1.tar.gz</filename> escrito en un lenguaje compilado

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>baz</replaceable>-1.tar.gz</filename> written in an interpreted language
es: el código fuente de una orden <filename><replaceable>baz</replaceable>-1.tar.gz</filename> escrito en un lenguaje interpretado

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package
es: Paquete

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Architecture:
es: Arquitectura:

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Multi-Arch:
es: Multi-arquitectura:

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package content
es: Contenido del paquete

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library, co-installable
es: la biblioteca compartida, coinstalable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library debug symbols, co-installable
es: los símbolos de depuración de la biblioteca compartida, coinstalable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library header files etc., co-installable
es: los ficheros de cabeceras y otros de una biblioteca compartida, coinstalable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the run-time support programs, not co-installable
es: los programas de soporte en tiempo de ejecución no son co-instalables.

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library documentation files
es: los ficheros de documentación de la biblioteca compartida

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the compiled program files, not co-installable
es: los ficheros compilados del programa, no son coinstalables

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the documentation files for the program
es: los ficheros de documentación del programa

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the interpreted program files
es: los ficheros de programa interpretados

note: type: Content of: <book><appendix><section><para>
en: Please note that the development package should contain a symlink for the associated shared library <emphasis role="strong">without a version number</emphasis>.  E.g.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>
es: Hay que tener en cuenta que el paquete de desarrollo debe contener un enlace simbólico a la biblioteca compartida asociada <emphasis role="strong">sin el número de versión</emphasis>. P. ej.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>

note: type: Content of: <book><appendix><section><title>
en: Building a shared library package
es: Construcción de un paquete de biblioteca compartida

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Update <filename>debian/control</filename>.
es: Actualizar <filename>debian/control</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Pre-Depends: ${misc:Pre-Depends}</literal> for each shared library binary package.
es: Añadir <literal>Pre-Depends: ${misc:Pre-Depends}</literal> por cada paquete binario de biblioteca compartida.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Multi-Arch:</literal> stanza for each binary package section.
es: Añadir el campo <literal>Multi-Arch:</literal> en cada sección de paquete binario.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Adjust the path from the normal <literal>/usr/lib/</literal> to the multiarch <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> for all packaging scripts.
es: Cambiar el directorio habitual <literal>/usr/lib/</literal> por el directorio multi-arquitectura <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> para todos los guiones de empaquetado.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace <literal>/usr/lib/</literal> with <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> in <filename>debian/rules</filename>.
es: Reemplazar <literal>/usr/lib/</literal> por <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> en <filename>debian/rules</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: Alternatively, you can add <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> and <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> arguments to <literal>./configure</literal>.  Please note that <literal>--libexecdir</literal> specifies the default path to install executable programs run by other programs rather than by users.  Its Autotools default is <filename>/usr/libexec/</filename> but its Debian default is <filename>/usr/lib/</filename>.
es: Como alternativa, puedes añadir los argumentos <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> y <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> en <literal>./configure</literal>. Fíjate que <literal>--libexecdir</literal> especifica el directorio predeterminado para la instalación de programas ejecutables que son ejecutados por otros programas en lugar de por los usuarios. El valor predeterminado por «Autotools» es <filename>/usr/libexec/</filename> pero en Debian es <filename>/usr/lib/</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace all occurrences of <literal>/usr/lib/</literal> with <literal>/usr/lib/*/</literal> in <filename>debian/<replaceable>foo</replaceable>.install</filename> files.
es: Cambiar todas referencias a <literal>/usr/lib/</literal> por <literal>/usr/lib/*/</literal> en los ficheros <filename>debian/<replaceable>nombre_del_paquete</replaceable>.install</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><screen>
en: override_dh_auto_configure:
            dh_auto_configure
            sed 's/@DEB_HOST_MULTIARCH@/$(DEB_HOST_MULTIARCH)/g' \
                    debian/<replaceable>foo</replaceable>.links.in > debian/<replaceable>foo</replaceable>.links
es: override_dh_auto_configure:
            dh_auto_configure
            sed 's/@DEB_HOST_MULTIARCH@/$(DEB_HOST_MULTIARCH)/g' \
                    debian/<replaceable>nombre_del_paquete</replaceable>.links.in > debian/<replaceable>nombre_del_paquete</replaceable>.links

note: type: Content of: <book><appendix><section><para>
en: Please make sure to verify that the shared library package contains only the expected files, and that your -dev package still works.
es: Debes comprobar que el paquete de biblioteca compartida solo contiene los ficheros esperados y que el paquete «-dev» sigue funcionando correctamente.

note: type: Content of: <book><appendix><section><title>
en: Native Debian package
es: Paquete nativo Debian

note: type: Content of: <book><appendix><section><para>
en: If a package is maintained only for Debian or possibly only for local use, its source may contain all the <filename>debian/*</filename> files in it.  There are 2 ways to package it.
es: Si un paquete se mantiene exclusivamente para Debian o para uso local, su paquete fuente puede contener todos los ficheros <filename>debian/*</filename>.  Hay dos maneras para empaquetarlos.

note: type: Content of: <book><appendix><section><para>
en: The alternative is the workflow of the native Debian package.
es: La alternativa es el esquema de trabajo para paquetes nativos Debian.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Create a native Debian source package in the <literal>3.0 (native)</literal> format using a single compressed tar file in which all files are included.
es: Generaremos un paquete fuente Debian en el formato <literal>3.0 (native)</literal>, utilizando un archivo comprimido en formato «tar» que incluirá todos los archivos.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.tar.gz
es: <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>.tar.gz

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.dsc
es: <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>.dsc

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build Debian binary packages from the native Debian source package.
es: Construiremos un paquete binario Debian del paquete de fuentes nativo Debian.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>_<replaceable>arch</replaceable>.deb
es: <replaceable>nombre_del_paquete</replaceable>_<replaceable>versión</replaceable>_<replaceable>arquitectura</replaceable>.deb

note: type: Content of: <book><appendix><section><screen>
en: $ cd ~/mypackage-1.0
    $ dh_make --native
es: $ cd ~/mi_paquete-1.0
    $ dh_make --native

note: type: Content of: <book><appendix><section><para>
en: After execution of the <command>dpkg-buildpackage</command> command, you will see the following files in the parent directory:
es: Después de la ejecución de la orden <command>dpkg-buildpackage</command>, encontrarás los siguientes ficheros en el directorio superior:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.tar.gz</filename>
es: <filename>mi_paquete_1.0.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is the source code tarball created from the <filename>mypackage-1.0</filename> directory by the <command>dpkg-source</command> command.  (Its suffix is not <filename>orig.tar.gz</filename>.)
es: Este es el archivo del código fuente generado a partir del directorio <filename>mi_paquete-1.0</filename> por la orden <command>dpkg-source</command> (su sufijo no es  <filename>orig.tar.gz</filename>.).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.dsc</filename>
es: <filename>mi_paquete_1.0.dsc</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0_i386.deb</filename>
es: <filename>mi_paquete_1.0_i386.deb</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0_i386.changes</filename>
es: <filename>mi_paquete_1.0_i386.changes</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package version as in the non-native Debian package. (There is no Debian revision.)
es: Este archivo describe todos los cambios realizados en el versión actual del paquete en el caso de los paquetes Debian no nativos (no tiene código de revisión Debian).
