PDF de programación - Guía del nuevo desarrollador de Debian

Guía del nuevo desarrollador de Debian

i

Guía del nuevo desarrollador de Debian

Guía del nuevo desarrollador de Debian

ii

Copyright © 1998-2002 Josip Rodin
Copyright © 2005-2013 Osamu Aoki
Copyright © 2010 Craig Small
Copyright © 2010 Raphaël Hertzog

Este documento puede utilizarse en los términos descritos en la Licencia Pública GNU versión 2 o posterior.
Este documento se ha escrito usando estos dos documentos como ejemplo:

«Making a Debian Package (AKA the Debmake Manual)», copyright © 1997 Jaldhar Vyas.
«The New-Maintainer’s Debian Packaging Howto», copyright © 1997 Will Lowe.

Guía del nuevo desarrollador de Debian

iii

COLABORADORES

T￿TULO :

Guía del nuevo desarrollador de Debian

ACCIÓN

NOMBRE

FECHA

FIRMA

ESCRITO POR

Josip Rodin,
Osamu Aoki,

Javier Fernández-
Sanguino Peña,
David Martínez,

Ana Beatriz

Guerrero López,
Francisco Javier

Cuadrado, y
Innocent De

Marchi

6 de enero de 2014

6 de enero de 2014

6 de enero de 2014

6 de enero de 2014

6 de enero de 2014

6 de enero de 2014

NÚMERO

FECHA

MODIFICACIONES

NOMBRE

HISTORIAL DE REVISIONES

Guía del nuevo desarrollador de Debian

Índice general

1. Empezando «de la forma correcta».
1.1. Dinamismo social en Debian .
.
.
1.2. Programas necesarios para el desarrollo .
.
1.3. Documentos necesarios para el desarrollo . .
1.4. Dónde pedir ayuda .
.

.
.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

2. Primeros pasos

.

.

.

.

.

.

.
.
.

.
.
.

.
.
.

. .
.
.
.
.

.
.
.
.
. .

2.1. Plan de trabajo para la construcción de paquetes Debian . .
.
.
2.2. Elige el programa .
.
.
.
2.3. Obtén el programa y pruébalo .
.
2.4. Métodos de compilación simple
.
2.5. Métodos de compilación portables populares . .
.
.
.
2.6. Nombre del paquete y versión .
2.7. Configurar dh_make . .
.
.
.
.
.
.
2.8. Paquete no nativo Debian inicial
2.9. Paquete nativo Debian inicial .
.
.
.

.
.
.
.
. .
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.

.

3. Modificar las fuentes

.

.

.

.

.

.

.

.

3.1. Configurar quilt . .
.
3.2. Corregir un error en el código fuente . .
3.3.
3.4. Diferencias en las bibliotecas .

.
.
Instalación de los archivos en su destino .
.

.

.

.

.

.

.

.

.
.
.
.

.
.
.
.

.
.
.
.

.

4.1. El archivo control . .
.
4.2. El archivo copyright . .
4.3. El archivo changelog . .
.
4.4. El archivo rules .

4. Archivos necesarios en el directorio debian
.
.
.
.
.
.
.
.
.
.
. .
.
.
4.4.1. Objetivos del archivo rules .
4.4.2. Archivo rules predeterminado .
.
4.4.3. Personalización del archivo rules . .

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.

.

.

.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

iv

1
1
3
4
5

. .
. .
.
.
.
.

. . . . . . .
.
. . . . . .
. . . . . .
.
.
. . . . . .

6
6
. . . . . .
7
. . . . . .
. . . . . .
9
. . . . . . 10
. . . . . . 10
. . . . . .
11
. . . . . . 12
. . . . . . 12
. . . . . . . 13

.
.
.
.
. .
. .
.
.
. .
. .
. .

.
.
.
.
.
.
.
.
. .

14
.
. . . . . . 14
. . . . . . . 14
.
. . . . . . 15
. . . . . . . 17

.
.
.
.
. .
. .

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

. .
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. .

.
.
.
.
.
.
. .

19
. . . . . . 19
. . . . . . 23
. . . . . . 24
. . . . . . 25
. . . . . . 25
. . . . . . 26
. . . . . . 29

.
.
. .
. .
.
.
.
.
.
.
.
.

. .
.
.
. .
. .
. .
. .
.
.
.
.
.
.
.
.
.
. .
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
. .
.
.
.
.
.
.
. .
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. .

.
.
.
.
.
.
. .

.
.
.
.
.
.
.
.
. .
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

Guía del nuevo desarrollador de Debian

5. Otros ficheros en el directorio debian.

.
.

.
.

.
.

.

.

.

.

.

.

.

.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.
.
.

.

.

.

.

.

.

.

.

.

.

.

.

.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

.
.

.

.
.

. .
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

. .
.
.
.
.

.
5.1. Archivo README.Debian (LÉEME.debian) . .
.
.
.
5.2. Archivo compat .
.
.
.
5.3. Archivo conffiles . .
.
.
.
5.4. Archivos nombre_del_paquete.cron.* . .
.
5.5. Archivo dirs . .
.
.
.
5.6. Archivo nombre_del_paquete.doc-base . .
.
5.7. Archivo docs . .
.
.
.
5.8. Archivo emacsen-* . .
.
5.9. Archivo nombre_del_paquete.examples . .
.
5.10. Archivos nombre_del_paquete.init y nombre_del_paquete.default .
.
.
5.11. Archivo install .
.
.
.
.
5.12. Archivo nombre_del_paquete.info .
.
.
5.13. Archivo nombre_del_paquete.links . .
.
.
5.14. Archivos {nombre_del_paquete.source/} lintian-overrides . .
.
.
5.15. Archivos manpage.* . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
5.16. Archivo nombre_del_paquete.manpages . .
.
.
5.17. Archivo menu . .
5.18. Archivo NEWS . .
.
.
5.19. Archivos {pre,post}{inst,rm} .
.
5.20. Archivo nombre_del_paquete.symbols . .
.
.
5.21. Archivo TODO . .
.
.
.
5.22. Archivo watch . .
.
.
.
5.23. Archivo source/format .
.
5.24. Archivo source/local-options .
.
.
.
5.25. Archivo source/options .
5.26. Archivos patches/* . .
.
.
.

.
.
.
5.15.1. Archivo manpage.1.ex . .
5.15.2. Archivo manpage.sgml.ex .
5.15.3. Archivo manpage.xml.ex .
.

.
.
.
.
.
.
. .
.
.
.
.
.
.
. .
.
.
.
.
.
.
. .
. .
. .
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.

.
.
.

.
.

.
.
.

.
.
.
.
.
.

.
.
.

.
.
.
.
.
.

.
.
.

.
.
.
.
.
.

.
.
.

.
.
.
.

.
.
.

.
.

.
.
.

.
.

.
.
.

.
.

.
.
.
.

.
.
.
.

.

.

.

.

.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.

.
.

.
.

.
.

.
.

.
.

.
.
.

.
.
.

.
.
.

v

32
.
.
.
. . . . . . 32
.
.
.
. . . . . . 33
.
. .
. . . . . . 33
.
.
.
. . . . . . 33
.
.
.
. . . . . . 34
.
.
.
. . . . . . 34
.
.
.
. . . . . . 34
.
. .
. . . . . . 34
.
.
.
. . . . . . 35
.
.
.
. . . . . . 35
.
.
.
. . . . . . 35
.
. .
. . . . . . 35
.
.
.
. . . . . . 36
.
.
.
. . . . . . 36
.
.
.
. . . . . . 36
.
.
.
. . . . . . 36
.
. .
. . . . . . 37
.
.
.
. . . . . . 37
.
.
.
. . . . . . 37
.
.
.
. . . . . . 38
.
.
.
. . . . . . 38
.
.
.
. . . . . . 38
.
.
.
. . . . . . 39
.
.
.
. . . . . . 39
.
.
.
. . . . . . 39
. . . . . . . 39
. .
.
.
.
. . . . . . 40
. . . . . . . 40
. .
.
.
.
. . . . . . 40

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. .
.
.
. .
.
.

6. Construyendo el paquete

.

.
.

(Re)construcción completa .
.
.
.

.
. .
6.1.
.
.
.
.
.
6.2. Autobuilder . .
6.3. La orden debuild .
. .
.
.
.
6.4. El paquete pbuilder . .
.
.
6.5. La orden git-buildpackage y similares .
.
.
.
6.6. Reconstrucción rápida

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

. .

.
.

.
.

.

.

.

.

.

.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.
.
.
. .
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
. .
.
.
.
.
.
.
.
.

.
.
. .
.
.
.
.
.
.
.
.

.
.
. .
.
.
.
.
.
.
.
.

.
.
. .
.
.
.
.
.
.
.
.

.
.
. .
.
.
.
.
.
.
.
.

.
.
. .
.
.
.
.
.
.
.
.

.

42
.
. . . . . . 42
. . . . . . . . 44
. . . . . . 44
.
. . . . . . 45
.
.
. . . . . . 46
. . . . . . 47
.

.
.
.
.

Guía del nuevo desarrollador de Debian

vi

7. Comprobando el paquete en busca de fallos
.

.

.

.

.

.

.

.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
7.1. Cambios sospechosos . .
.
.
7.2. Comprobando la instalación del paquete .
7.3. Comprobando los guiones del desarrollador («maintainer scripts») . .
.
7.4. El paquete lintian . .
7.5. La orden debc . .
.
.
.
7.6. La orden debdiff
.
.
.
7.7. La orden interdiff .
.
.
7.8. La orden mc . .
.
.
.

.
.
.
.
. .
. .
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.

.
.
.
.

.

8. Actualizar el paquete

.

.

.

8.1. Nueva revisión Debian del paquete . .
8.2.
8.3. Nueva versión del programa fuente . .
8.4. Actualizar el formato del paquete . .
.
8.5. Conversión a UTF-8 . .
.
.
8.6. Recordatorio para a