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

Guía del nuevo desarrollador de Debian

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

7 de junio de 2011

Guía del nuevo desarrollador de Debian
by 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

Published 2011-06-07 13:40:08 UTC
Copyright © 1998-2002 Josip Rodin
Copyright © 2005-2011 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.

ii

Í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. Archivos necesarios en el directorio debian
.
.
.
.

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

.
. .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4.4.1. Objetivos del archivo rules . .
.
.
4.4.2. Archivo rules predeterminado .
. .
.
.
4.4.3. Personalización del archivo rules .

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.

.

.

.

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. Archivos {nombre_del_paquete.source/} lintian-overrides . .
.
.
.
.
.
.
.
. .
.
. . .
. .
.
.
.
.
. .
5.14. Archivos manpage.* .
.
. .
.
.
.
.
.
.
.
.
.
.
. .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. .
.
.
.
.
.
.
. .
.
.
.
.
. . .
. .
. .
. .
. .
.
. . .
. .
. .
. .
. .
.
.
.
.
.
.
.
.
.
.
.
. .

.
.
.
.
5.15. Archivo nombre_del_paquete.manpages . .
.
.
5.16. Archivo menu .
.
5.17. Archivo NEWS .
.
5.18. Archivos {pre,post}{inst,rm} . .
.

.
.
5.14.1. Archivo manpage.1.ex .
.
5.14.2. Archivo manpage.sgml.ex . .
5.14.3. Archivo manpage.xml.ex . .

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
. .

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.

.
.
.

.
.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.

.

.

.

.

.

.

.

.

.

.

.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.

.

.
.

.
.

iii

1
1
3
4
5

7
7
8
10
11
11
12
13
13
14

15
15
15
16
18

19
19
23
24
25
25
26
28

31
31
32
32
32
33
33
33
33
33
34
34
34
34
35
35
35
36
36
36
37
37

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.

.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.

.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

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

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

.
.
.

.
.
.
.
.

.
.
.

.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

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

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

.
.
.

.
.
.
.
.

.
.
.

.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

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

.
.
.
.
.
.

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

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

.
.
.

.
.
.
.
.

.
.
.

.
.
.
.
.

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

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

.
.
.

.
.
.
.
.

.
.
.

.
.
.
.
.

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

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

.
.
.

.
.
.
.
.

.
.
.

.
.
.
.
.

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

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

.
.
.

.
.
.
.
.

.
.
.

.
.
.
.
.

37
37
38
38
38
39

41
41
42
43
44
45
45

47
47
47
47
48
48
49
49
49

51
51
52
52

53
53
54
54
55
56

ÍNDICE GENERAL

.
.

.
.

.
.

.
.

.
.

.
.
.
5.19. Archivo TODO . .
.
5.20. Archivo watch . .
.
5.21. Archivo source/format .
.
5.22. Archivo source/local-options .
5.23. Archivo source/options .
.
.
.
5.24. Archivos patches/* . .

.
.
.

.
.
.

.
.
.

.
.
.

.
.

.
.

.
.

.
.

.

.
.
.
.
.
.

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
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

. .

.
.

.
.

.
.

.

.

.

.

.

.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

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

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

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. Enviar el paquete

8.1. Enviar al repositorio de Debian .
8.2.
8.3. Envíos discontinuados

.
Incluir orig.tar.gz para la transferencia del paquete al repositorio. .
.

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

9. Actualizar el paquete

9.1. Nueva revisión Debian del paquete . .
9.2.
9.3. Nueva versión del programa fuente . .
9.4. Actualizar el formato del paquete . .
.
9.5. Recordatorio para actualizar paquetes

.
.
Inspección de una nueva versión del autor
.
.
.
.
.
.

.
.
. .
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.
.
. .

.
.
.
.
.

iv

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 común
de Debian y para 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 exempl