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

Guía del nuevo desarrollador de Debian

ii

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

This document may be used under the terms of the GNU General Public License version 2 or higher.
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

24 de diciembre

de 2020

24 de diciembre

de 2020

24 de diciembre

de 2020

24 de diciembre

de 2020

24 de diciembre

de 2020

24 de diciembre

de 2020

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

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

.
. . . . . .
. . .

. . . . . .
.
. . .

. . .
. . . . .

. . . . . . .

. . . . .

. . . . .

. . . . .

. . .

. . .

. . .

. . .

. . .

.
.
.

.
.
.

.
.
.

.

.

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

. . .

. . . . .
. . . . .

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

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

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

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

iv

1
1
3
4
4

.
.
.
.

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

13
. 13
. 13
. 14
. 16

18
. 18
. 22
. 23
. 24
. 24
. 25
. 28

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

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.15.1. Archivo manpage.1.ex .
5.15.2. Archivo manpage.sgml.ex . . . . . .
5.15.3. Archivo manpage.xml.ex . . . . . .

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

.
. .

.

.

.

.

.

.

.

.

.

.

.

. . .

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

. . .
. . .
. . . .

. . . .
. . .

. . . . .

. . . . .

. . . . .

.
.
.

.
.
.

.
.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.

.

6. Construcción del paquete

.

.
.

.
.

.
.
.
.

.
.
.
.

. . .

. . . . .

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

(Re)construcción completa . .
.
.
.

6.1.
.
.
6.2. Autobuilder . .
.
6.3. La orden debuild .
. .
6.4. El paquete pbuilder . .
6.5. git-buildpackage command and similar . . . . . .
6.6. Reconstrucción rápida
6.7.

. . .
. .
. . .
. . .

Jerarquía de órdenes

. . .
. . .

. .
.

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

. . . . .

. . . . .

. . .
. . . . .

. . . . .
. . .

.
.
.
.

.
.
.
.

. .

.
.
.

.
.

.
.

.
.

.
.

.
.

.
.

v

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

40
. 40
. 41
. 42
. 42
. 44
. 45
. 45

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

.
.
.
.
.
.
.

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

.
.
.
.
.
.
.

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

.
.
.
.
.
.
.

Guía del nuevo desarrollador de Debian

7. Comprobación del paquete en busca de fallos

.

.

.

.

.

.

.

. . .

. . .

. . . . .

7.1. Cambios sospechosos . .
7.2. Comprobación de la instalación del paquete . . . . . .
7.3. Comprobación de 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

. .

. . . . . . .
Inspección