Guía del Nuevo Desarrollador de Debian
Capítulo 1 Empezando "de la Forma Correcta".

Este documento tratará de describir cómo se construye un paquete Debian GNU/Linux para el usuario normal de Debian (y futuros desarrolladores) en un lenguaje informal, y con multitud de ejemplos. Hay un antiguo dicho romano que dice, ¡Longum iter est per preaecepta, breve et efficax per exempla! (¡Es un largo camino con las reglas, pero corto y eficiente con ejemplos!)

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 formato de paquetes de Debian, algunas veces necesitarás instalar programas que no estén así. Puedes preguntarte cómo harás tus propios paquetes y que quizás ésta sea una tarea demasiada difícil. Bueno, si eres un novato en Linux, sí es duro, pero si eres todo un experto, 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.

Se pueden obtener versiones nuevas de este documento en línea en http://www.debian.org/doc/maint-guide y en el paquete 'maint-guide-es'.

1.1 Programas que necesitas para el desarrollo.

Antes de empezar nada, deberías asegurarte que tienes instalados algunos paquetes adicionales necesarios para el desarrollo. Observa que en la lista no están incluidos paquetes `esenciales' o `necesarios' que se suponen ya instalados.

Este documento fue escrito cuando la distribución `slink' 2.1 era la distribución estable oficial de Debian, y `potato' 2.2 estaba en fase de desarrollo. Por ello, los paquetes que se indicarán aquí son principalmente aquellos de `potato'.

Los siguientes paquetes vienen en una instalación estándar de Debian 2.1, así que probablemente ya los tengas (junto con los paquetes de los que dependen). Aún así, deberías comprobarlo con `dpkg -s <paquete>`.

• binutils - estos programas se usan para ensamblar y enlazar ficheros objeto - aquellos que componen los programas (ve a `info binutils`)
• cpp - el preprocesador de C. (ve a cpp(1))
• cpio - este es un programa archivador como tar o zip. (ve a cpio(1))
• dpkg-dev - este paquete contiene las herramientas necesarias para desempaquetar, construir y enviar paquetes fuente de Debian. (ve a dpkg-source(1))
• file - este útil programa puede determinar de qué tipo es un fichero. (ve a file(1))
• gcc - el compilador de C de GNU. La mayor parte de los programas de Linux están escritos en C. Si tu programa está escrito en algún otro lenguaje de programación como C++, Fortran o Pascal, deberías instalar g++, g77, o gpc, respectivamente. (lee gcc(1), g++(1), g77(1), gpc(1))
• libc6-dev - las librerías y cabeceras de fichero de C que gcc necesita para enlazar y crear ficheros objeto. Aunque algunos programas recomiendan y/o usan libc5, te sugiero que utilices la nueva versión (libc6). (revisa `info libc`)
• make - habitualmente la creación de un programa tiene varios pasos. En lugar de ejecutar los mismos comandos una y otra vez, puedes utilizar este programa para automatizar el proceso, creando `Makefile's. Algunos programas también usan imake y xmkmf, programas para generar Makefiles de un conjunto de funciones macro. Algunos programas más nuevos usan guiones de configuración y Makefiles con la ayuda de programas como autoconf y automake, así que puedes necesitarlos también. (ve a `info make`, imake(1), xmkmf(1), autoconf(1), automake(1))
• patch - esta utilidad es muy práctica, ya que permite tomar un fichero que contiene un listado de diferencias (producido por el programa diff) y aplicárselas al fichero original, produciendo una versión "parcheada". (ve a patch(1))
• perl5 - Perl es uno de los lenguajes interpretados para hacer guiones más usados en los sistemas Un*x de hoy, comúnmente referido como la "Sierra Mecánica Suiza de Unix". (ve perl(1))

De la sección `devel' de la distribución posiblemente necesites instalar esto tú mismo:

• dh-make y debhelper - dh-make es necesario para crear el esqueleto de nuestro paquete ejemplo, y se usarán algunas de las herramientas de debhelper para crear paquetes. No son imprescindibles para la creación de paquetes, pero se recomienda encarecidamente para nuevos desarrolladores. Hace el proceso mucho más fácil al principio, y más fácil de controlar también más adelante. (ve a dh_make(1), debhelper(1), /usr/share/doc/debhelper/README)
• devscripts - este paquete contiene algunos guiones útiles para los desarrolladores, pero no son necesarios para crear paquetes. (ve a /usr/share/doc/devscripts/README.gz)
• fakeroot - esta utilidad te permite emular ser root (superusuario, n. del t.) lo cual es necesario para ciertas partes del proceso de construcción. (ve a fakeroot(1))
• lintian - este es el gestor de paquetes de Debian, que te indica muchos de los errores comunes después de construir un paquete, y explica los errores. Hace falta tener instalado diffstat también, una pequeña utilidad que crea histogramas a partir de la salida de diff. (ve a lintian(1), diffstat(1), /usr/share/doc/lintian/lintian.html/index.html)

Por último, estos paquetes de gran importancia están en la sección 'doc' de la distribución:

• debian-policy - incluye la estructura y contenidos del archivo, ciertas notas sobre diseño del SO, el Estándar de la Jerarquía del Sistema de Ficheros (Filesystem Hierarchy Standard, n. del t.), y, lo más importante (para ti) es que describe los requisitos que debe satisfacer cada paquete para ser incluido en la distribución. (mira /usr/share/doc/debian-policy/policy.html/index.html)
• developers-reference - para todos los temas no específicamente relacionados con los detalles técnicos de cómo empaquetar, como la estructura del archivo, cómo renombrar, abandonar, coger paquetes, cómo hacer NMUs (Non-Maintainer Uploads, o envíos por personas distintas del desarrollador, n. del t.), como gestionar los errores que los usuarios envíen, y cómo y cuando enviar los paquetes, etc. (lee /usr/share/doc/developers-reference/developers-reference.html/index.html)
• packaging-manual - describe los aspectos técnicos de cómo crear paquetes binarios y fuentes en Debian. (lee /usr/share/doc/packaging-manual/packaging.html/index.html)

También necesitarás un paquete criptográfico, o bien PGP (los paquetes pgp-*) o GPG (el paquete gnupg), para firmar digitalmente tu paquete. Esto es especialmente importante si quieres distribuir tu paquete a otras personas (y harás precisamente esto si tu paquete se incluye en la distribución de Debian). Sin embargo, debido a una estúpida ley de exportación de los EEUU, no puedes simplemente obtenerlo de tu servidor FTP de Debian más cercano. Pero Debian ofrece estos paquetes a través de un servidor que no está físicamente en EEUU, llamado non-US.debian.org (ftp://non-us.debian.org/debian-non-US/). Tu servidor FTP tendrá un fichero llamado README.non-us, que te indicará dónde está la réplica más cercana de este servidor.

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 muy contento de haberla leído. Nota: debmake es una paquete que incluye otros programas con funciones similares a dh-make, pero su uso específico no está cubierto en este documento. Lee el manual de Debmake para más información.

1.2 Más información.

Puedes construir dos tipos de paquetes, fuentes y binarios. Un paquete fuente contiene el código que puede compilar en un programa. Un paquete binario contiene sólo el programa terminado. ¡No mezcles los términos como 'fuentes de un programa' y el 'paquete fuente de un programa'! Por favor, lee los otros manuales si necesitas más detalles sobre terminología.

Debian usa el término `desarrollador' para la persona que hace paquetes, `autor fuente' (`upstream author, n. del t.) para la persona que hizo el programa, y `desarrollador fuente' (`upstream maintainer', n. del t.) para la persona que actualmente mantiene el programa fuera de Debian. Generalmente el autor y el desarrollador fuente son la misma persona - y algunas veces incluso el desarrollador es el mismo. Si tú haces un programa, y quieres incluirlo en Debian, tienes total libertad para solicitar convertirte en desarrollador.

Después de construir tu paquete (o mientras lo haces), deberás convertirte en un desarrollador oficial de Debian si deseas que tu programa entre en la próxima distribución (si el programa es útil, ¿por qué no?). Este proceso se explica en la Referencia del Desarrollador, por favor, léela.