Provided by:
dpkg-dev_1.15.8.4ubuntu3_all 
NOMBRE
dpkg-source - Herramienta de manipulacin de paquetes fuente de Debian
SINOPSIS
dpkg-source [opciones] orden
DESCRIPCIN
dpkg-source empaqueta y desempaqueta archivos de fuentes de Debian.
Ninguna de estas rdenes permite combinar mltiples opciones en una sola.
Tampoco permiten que el valor de una opcin se especifique en un
argumento separado.
RDENES
-x fichero.dsc [directorio-salida]
Extrae un paquete fuente. Se debe suministrar un argumento que
no sea una opcin, el nombre del fichero de control de fuente de
Debian (.dsc). Puede introducir un segundo argumento que no sea
una opcin para definir el directorio en el que extraer el
paquete fuente, el cual no debe existir. En caso de no definir
ningn directorio, el paquete fuente se extraer en un directorio
llamado fuente-versin dentro del directorio actual.
dpkg-source lee los nombres de los dems ficheros que componen el
paquete fuente desde el fichero de control; se asume que estn en
el mismo directorio que el fichero .dsc.
Los permisos y propietarios de los ficheros del paquete extrado
sern los mismos que se esperaran si los ficheros se hubiesen
simplemente creado - 0777 para directorios y ejecutables y 0666
para el resto de ficheros, ambos modificados segn el umask del
extractor. Si el directorio superior tiene activado el bit
setgid, los directorios extrados lo tendrn tambin, y todos los
ficheros y directorios heredarn el grupo al que pertenece.
Si el paquete fuente usa un formato no estndar (a da de hoy,
todos los formatos menos 1.0), su nombre se guardar en
debian/source/format para que las siguientes construcciones del
paquete fuente usen el mismo formato por omisin.
-b directorio [parmetros-especficos-formato]
Construye un paquete fuente. El primer argumento, que no opcin,
se toma como el nombre del directorio que contiene el rbol de
fuentes debianizado (por ejemplo, con un subdirectorio debian/,
y puede que cambios en los ficheros originales). Puede
especificar parmetros adicionales, dependiendo del formato de
paquete fuente usado en la construccin del paquete.
dpkg-source construir el paquete fuente con el primer formato
posible de esta lista, y en este orden: el formato indicados con
la opcin de lnea de rdenes --format, el formato indicado en
debian/source/format, 1.0. El uso predefinido de 1.0 en ausencia
de otro valor est obsoleto y se eliminar en el futuro. Siempre
debera documentar el formato fuente deseado en
debian/source/format. Consulte la seccin FORMATOS DE PAQUETE
FUENTE para una extensa descripcin de los diferentes formatos de
paquete fuente.
--print-format directorio
Muestra el formato de fuentes a usar en la construccin del
paquete fuente si se invoc dpkg-source -b directorio (con las
mismas condiciones y los mismos parmetros).
--before-build directorio
Se debera invocar esta orden antes de construir un paquete
(dpkg-buildpackage lo invoca muy temprano en el proceso, incluso
antes que debian/rules clean). Esta orden debera ser
idempotente, y se puede invocar varias veces. No todos los
formatos de fuentes implementan algo en este hook, y aquellos
que lo hacen habitualmente preparan el rbol de las fuentes para
la construccin, por ejemplo, comprobando que se aplican los
parches de Debian.
--after-build directorio
Se debera invocar esta orden despus de construir un paquete
(dpkg-buildpackage lo invoca en ltimo lugar). Esta orden debera
ser idempotente, y se puede invocar varias veces. No todos los
formatos de fuentes implementan algo en este hook, y aquellos
que lo hacen lo usan habitualmente para deshacer lo que
--before-build ha hecho.
-h, --help
Muestra el modo de uso y termina.
--version
Muestra la versin y termina.
OPCIONES GENRICAS DE CONSTRUCCIN
-cfichero-control
Define el fichero de control principal de las fuentes del que
leer la informacin, debian/control por omisin. Si se introducen
rutas relativas, stas se interpretan empezando en el directorio
superior del rbol de fuentes.
-lfichero-cambios
Define el fichero de registro de cambios del que leer la
informacin, debian/changelog por omisin. Si se introducen rutas
relativas, stas se interpretan empezando en el directorio
superior del rbol de fuentes.
-Fformato-registro-cambios
Define el formato del registro de cambios. Por omisin, el
formato se lee de una lnea especial cerca del final del registro
de cambios o, en caso de fallo, usa el formato estndar debian.
--format=valor
Usa el formato dado para la construccin del paquete fuente. Esto
sobreescribe cualquier formato presente endebian/source/format.
-Vnombre=valor
Define una variable de sustitucin de la salida. Consulte
deb-substvars(5) para ms informacin acerca de la sustitucin de
la salida.
-Tfichero-variables-sust
Lee las variables de sustitucin desde fichero-variables-sust; el
valor por omisin es no leer ninguno. Puede usar esta opcin
varias veces para leer variables de sustitucin de varios
ficheros.
-Dcampo=valor
Sobreescribe o aade un campo en el fichero de control de salida.
-Ucampo
Elimina un campo del fichero de control de salida.
-Zcompression, --compression=compresin
Define qu compresin usar con los ficheros creados (archivos tar
y ficheros diff). Tenga en cuenta que esta opcin no provoca que
los archivos tar existentes se compriman nuevamente, slo afecta
a los ficheros nuevos. Los valores permitidos son: gzip, bzip2,
lzma y xz. gzip se usa por omisin. La compatibilidad con xz es
posible desde dpkg-dev 1.15.5.
-zlevel, --compression-level=nivel
El nivel de compresin a usar. Al igual que -Z, slo afecta a los
ficheros nuevos. Los valores permitidos son de 1 a 9, best, y
fast. 9 se usa por omisin.
-i[expresin-regular], --diff-ignore[=expresin-regular]
Puede especificar una expresin regular de Perl para indicar
aquellos ficheros que desee excluir de la lista de ficheros para
el diff (esta lista se genera con una orden find). Puede usar
esto para ignorar cambios no introducidos en ficheros
especficos, en caso de construir un paquete fuente como un
paquete fuente versin 3 usando VCS. Por s mismo, -i activa la
opcin con una expresin regular predefinida que elimina los
ficheros y directorios de control de los sistemas de control de
versiones ms comunes, los ficheros de respaldo, los ficheros de
intercambio y los directorios que se generan como resultado de
las operaciones de Libtool. Slo puede haber una expresin regular
activa, y en caso de existir varias opciones -i slo se tendr en
cuenta la ltima.
Esto es til para eliminar ficheros externos que se incluyen en
el diff. Por ejemplo, si desarrolla su software en sistema de
control de versiones y desea realizar un checkout para construir
un paquete fuente, sin incluir los ficheros y directorios
adicionales que habitualmente contiene (por ejemplo, CVS/,
.cvsignore, .svn). La expresin regular predefinida es bastante
completa, pero si necesita reemplazarla, tenga en cuenta que por
omisin, puede coincidir con cualquier parte de la ruta. Por
ello, si desea emparejar el principio de un nombre de fichero, o
slo nombres de fichero completos, tendr que introducir
directamente el anclaje necesario (por ejemplo, '(^|/)',
'($|/)').
--extend-diff-ignore=expresin-regular
La expresin regular de perl definida extender la expresin
regular predefinida asociada a -i, concatenando |regexp a la
expresin regular predefinida. Es conveniente usar esta opcin en
debian/source/options para excluir algunos ficheros generados
automticamente a partir de la generacin automtica de parches.
-I[patrn-fichero], --tar-ignore[=patrn-fichero]
Si se especifica esta opcin, el nombre de fichero se pasar como
parmetro a la opcin --exclude de tar(1) al generar el fichero
.orig.tar o genere el fichero .tar.gz. La opcin se puede repetir
varias veces para listar varios patrones a excluir.
Por si mismo, -I aade las opciones predefinidas --exclude, que
filtrarn los ficheros de control y los directorios de los
sistemas de control de versiones ms comunes, ficheros de
respaldo e intercambio, y los directorios de salida de
construccin de Libtool.
Nota: A pesar de tener objetivos similares, i y I tienen una sintaxis y
semntica muy diferentes. Slo puede especificar i una vez, que toma una
expresin regular compatible con Perl, la cual se compara con la ruta
relativa de cada fichero. Puede especificar I varias veces, y toma un
patrn de nombre de fichero con comodines de intrprete de rdenes. El
patrn se compara con la ruta relativa, y tambin con cada parte de la
ruta, de manera individual. La semntica exacta de la opcin --exclude de
tar es algo complicada, consulte
http://www.gnu.org/software/tar/manual/tar.html#wildcards para una
completa documentacin.
Puede consultar los patrones y expresiones regulares predefinidas de
ambas opciones en la salida de la orden --help.
OPCIONES DE EXTRACCIN GENRICAS
--no-copy
No copia los ficheros tar originales cerca del paquete fuente
extrado.
--no-check
No revisa las firmas y sumas de control antes de desempaquetar.
--require-valid-signature
Rechaza desempaquetar el paquete fuente si no contiene una firma
OpenPGP, que se verifica o bien con el anillo de claves de
usuario trustedkeys.gpg, uno de los anillos de claves especficos
del proveedor, o uno de los anillos de claves oficiales de
Debian, /usr/share/keyrings/debian-keyring.gpg y
/usr/share/keyrings/debian-maintainers.gpg.
FORMATOS DE PAQUETE FUENTE
Si no sabe qu formato de fuentes usar, debera seleccionar o bien 3.0
(quilt) o 3.0 (native). Consulte
http://wiki.debian.org/Projects/DebSrc3.0 para ms informacin acerca del
desarrollo de estos formatos dentro del proyecto Debian.
Formato: 1.0
Un paquete fuente en este formato consiste bien de un .orig.tar.gz
asociado a un .diff.gz, o bien de un nico .tar.gz (en tal caso, el
paquete se considera native).
Extraccin
Extraer un paquete nativo es simplemente una extraccin de un nico
archivo tar en el directorio destino. Extraer un paquete no nativo se
realiza, primero, desempaquetando el .orig.tar.gz para despus aplicar
el parche contenido en el fichero .diff.gz. La marca temporal de todos
los ficheros parcheados se modifica en el momento de extraer el paquete
fuente (esto evita bifurcaciones de las marcas temporales, que conducen
a problemas cuando se parchean los ficheros generados automticamente).
El diff puede crear nuevos ficheros (todo el directorio debian/ se crea
de esta manera) pero no puede eliminar ficheros (los ficheros vacos
permanecern en el sistema).
Construccin
Construir un paquete nativo consiste de la creacin de un nico archivo
tar con el directorio fuente. Construir un paquete no nativo incluye
extraer el archivo tar original en otro directorio .orig, regenerando
el .diff.gz por comparacin del directorio del paquete fuente con el
directorio
Opciones de construccin (con -b):
Si hay un segundo argumento, debera ser el nombre del directorio de
fuentes, del fichero tar original o la cadena vaca, si el paquete es
especfico de Debian y por tanto carece de diffs debianizantes. Si no se
proporciona un segundo argumento, dpkg-source buscar el archivo tar
original paquete_versin-autor-original.orig.tar.gz o el directorio de
fuentes original directorio.orig en funcin de los argumentos -sX.
-sa, -sp, -sk, -su y -sr no sobreescribirn directorios o ficheros tar
existentes. Si esto es lo que desea, debera utilizar -sA, -sP, -sK, -sU
y -sR en su lugar.
-sk Define que se espera la fuente original como un archivo tar, por
omisin paquete_versin-autor-original.orig.tar.gz. La fuente
original se dejar en el sitio como un fichero tar, o se copiar
al directorio actual en caso de no estar ya ah presente. El
archivo tar se desempaquetar en directorio.orig para la
generacin del diff.
-sp Idntica a -sk, a diferencia de que eliminar el directorio al
finalizar.
-su Define que se espera que la fuente original sea un directorio,
por omisin paquete-versin-autor-original.orig, y que dpkg-source
crear un fichero de fuentes nuevo a partir de l.
-sr Idntica a -su, a diferencia de que eliminar el directorio despus
de su uso.
-ss Define que la fuente original est disponible tanto como
directorio como un fichero tar. dpkg-source usar el directorio
para crear el diff , pero el fichero tar para crear el .dsc.
Debe usar esta opcin con precaucin, ya que si el directorio y el
archivo tar no coinciden se generar un archivo fuente invlido.
-sn Omite la bsqueda de la fuente original y no generar un diff. El
segundo argumento, en caso de existir, debe ser la cadena vaca.
Esta opcin se usa en paquetes especficos de Debian que no tienen
fuentes del autor original por separado, y por tanto carecen de
ficheros diff debianizantes.
-sa or -sA
Defina una bsqueda de la fuente original como directorio o como
archivo tar - el segundo argumento, de existir, puede ser
cualquiera de las dos cosas o la cadena vaca (equivale a usar
-sn). Si se encuentra un fichero tar, se desempaquetar para
crear el diff y eliminar posteriormente (equivale a -sp); si se
encuentra un directorio, se empaquetar para crear la fuente
original y se eliminar posteriormente (equivale a -sr); si no se
encuentra ninguno de los dos, se asume que el paquete no tiene
ficheros diff debianizantes, nicamente un fichero de fuentes
(equivale a -sn). Si se encuentran ambos, dpkg-source ignorar el
directorio, sobreescribindolo, si se especific -sA (equivale a
-sP), o generar un error si se defini -sa. -sA es la opcin
predefinida.
--abort-on-upstream-changes
El procesa dar fallo si el diff generado contiene cambios
realizados a ficheros fuera del subdirectorio debian. Esta opcin
no se puede usar en debian/source/options pero se puede usar en
debian/source/local-options.
Opciones de extraccin (con -x):
En todos los casos cualquier rbol de fuentes original ser eliminado.
-sp Si se usa en la extraccin, la fuente original (de existir) se
dejar como un fichero tar. Si no se encuentra en el directorio
actual o si existe un fichero pero es diferente, se copiar ah.
(sta es la accin por omisin).
-su Desempaqueta el rbol de fuentes original.
-sn Asegura que la fuente original ni se copia al directorio actual
ni se desempaqueta. Cualquier rbol de fuentes original existente
en el directorio actual es eliminado.
Todas las opciones -sX son mutuamente excluyentes. Si define ms de una,
slo se usar la ltima.
--skip-debianization
Omite la aplicacin del diff de debian con las fuentes del autor
original.
Formato: 2.0
Tambin conocido como wig&pen. No se recomienda este formato para un uso
masivo, ya que el formato 3.0 (quilt) lo reemplaza. Wig&pen fue la
primera especificacin de un formato de paquete fuente de nueva
generacin.
El comportamiento de este formato es idntico al del formato 3.0
(quilt), a excepcin de que no usa una lista explcita de parches. Todos
los ficheros en debian/patches/ que coinciden con la expresin regular
de perl [\w-]+ deben ser parches vlidos: se aplican durante el proceso
de extraccin.
Al construir un nuevo paquete fuente, todo cambio en las fuentes
original se guardan en un parche llamado zz_debian-diff-auto.
Formato: 3.0 (nativo)
Este formato es una extensin del formato de paquete nativo como se
define en el formato 1.0. Es compatible con todos los mtodos de
compresin, e ignorar cualquier fichero o directorio especfico a
sistemas de control de versiones, as como muchos ficheros temporales
(consulte el valor predefinido asociado a la opcin -I en la salida de
--help).
Format: 3.0 (quilt)
Un paquete fuente con este formato contiene al menos un archivo tar
original (.orig.tar.ext, siendo ext gz, bz2, lzma o xz) y un archivo
tar de Debian (.debian.tar.ext). Tambin contiene archivos tar
originales adicionales (.orig-componente.tar.ext). componente slo puede
contener caracteres alfanumricos y guiones (-).
Extraccin
Primero se extrae el archivo tar original, y despus se extraen todos
los archivos tar originales en subdirectorios nombrados a partir de la
parte de componente de su nombre de fichero (todo directorio
preexistente se reemplazar). El archivo tar de Debian se extrae en el
directorio raz del rbol despus de la eliminacin de cualquier directorio
debian preexistente. Tenga en cuenta que el archivo tar de Debian debe
contener un subdirectorio debian, pero tambin puede contener ficheros
binarios externos a ese directorio (consulte la opcin
--include-binaries).
En este momento se aplican todos los parches listados en
debian/patches/debian.series o debian/patches/series. Si el primer
fichero se usa, y el segundo no existe (o es un enlace simblico), ste
se reemplazar con un enlace simblico al primero. El objetivo de esto es
simplificar el uso de quilt al gestionar el conjunto de parches. No
obstante, tenga en cuenta que mientras que dpkg-source analiza
correctamente los ficheros en series con opciones explcitas para la
aplicacin del parche (guardados en cada lnea despus del nombre de
fichero del parche y uno o ms espacios), ignora aquellas opciones que
siempre esperan parches que se puedan aplicar con la opcin -p1 de
patch. De no ser as, mostrar un aviso en caso de encontrar tales
opciones, y cabe que la construccin falle.
De forma similar al comportamiento predefinido de quilt, los parches
tambin pueden eliminar ficheros.
El fichero .pc/applied-patches se crea en caso de aplicar parches
durante la extraccin.
Construccin
Todos los archivos tar original encontrados en el directorio actual se
extraen a un directorio temporal siguiendo la misma lgica para
desempaquetar, copiando el directorio debian al directorio temporal y
por ltimo aplicando todos los parches, a excepcin del parche automtico
(debian-changes-version o debian-changes, dependiendo de
--single-debian-patch). El directorio temporal se compara con el
directorio de fuentes del paquete, guardando el diff (si no est vaco)
en el parche automtico. En caso de crear o aadir el parche automtica,
este se aade o elimina del fichero series y de los metadatos de quilt.
Cualquier cambio en un fichero binario no se puede representar en un
diff, conduciendo as a un fallo a menos que el desarrollador decida
explcitamente incluir el fichero binario modificado en el archivo tar
debian (mediante su listado en debian/source/include-binaries). La
construccin tambin fallar si encuentra ficheros binarios en el
subdirectorio debian, a menos que estn en el whitelist de
debian/source/include-binaries.
Llegado a este punto se genera el archivo tar debian en base al
directorio debian modificado y la lista de binarios modificados.
El diff generado automticamente no incluye cambios en ficheros
especficos al sistema de control de versiones, as como muchos otros
ficheros temporales (consulte el valor predefinido asociado a -i en la
salida de --help). En particular, se ignora el directorio .pc empleado
por quilt durante la creacin del parche automtico.
Nota: dpkg-source espera que el rbol de fuentes contenga todos los
parches listados en el fichero series aplicado al generar el paquete
fuente. Este no es el caso cuando el rbol de fuentes se obtuvo al
desempaquetar un paquete fuente usando, por ejemplo, Format: 1.0. Para
mitigar el problema, dpkg-source aplicar los parches directamente si
cree que estos an no se han aplicado. Para detectar tal situacin, usa
la siguiente heurstica: si encuentra la lista de parches supuestamente
no aplicados (listados en el fichero series pero no en
.pc/applied-patches) y aplica el primer parche del conjunto sin
problemas, proceder a aplicar el resto. Puede usar la opcin
--no-preparation para desactivar este comportamiento. Habitualmente,
esta operacin se realiza con la orden --prepare-build.
Opciones de construccin
--allow-version-of-quilt-db=versin
Permite que dpkg-source construya el paquete fuente si la versin
de los metadatos de quilt es el especificado, incluso si
dpkg-source no lo conoce. De hecho, esto dice que la versin dada
de los metadatos de quilt es compatible con la versin 2, con la
que dpkg-source tiene compatibilidad actualmente. Esta versin de
los metadatos de quilt se guardan en .pc/.version.
--include-removal
No ignora los ficheros eliminados y los incluye en el parche
generado automticamente.
--include-timestamp
Incluye la marca temporal en el parche generado automticamente.
--include-binaries
Aade todos los ficheros binarios modificados al archivo tar
debian. Tambin los aade a debian/source/include-binaries: se
aadirn por omisin en futuras construcciones, con lo que esta
opcin ya no ser necesaria.
--no-preparation
No intenta preparar el rbol de construccin aplicando parches que
estn supuestamente sin aplicar.
--single-debian-patch
Usa debian/patches/debian-changes en lugar de
debian/patches/debian-changes-version para el nombre del parche
generado automticamente durante la construccin. Esta opcin es
particularmente til si el paquete se guarda en un sistema de
control de versiones y si no se puede generar un conjunto de
parches adecuados. Al usar esta opcin, se recomienda crear un
fichero debian/source/patch-header, detallando la mejor forma de
revisar los cambios de Debian, por ejemplo, el sistema de
control de versiones en uso.
--create-empty-orig
Crea automticamente el archivo tar principal y original como
vaco en caso de no existir y si hay otros archivos tar
originales adicionales. Esta opcin est diseada para su uso
cuando el paquete fuente es un conjunto de varios programas de
la fuente principal y cuando no hay programas principales.
--unapply-patches
No aplica o elimina los cambios de los parches en el hook
--after-build. Esto es til principalmente cuando construye su
paquete directamente en un sistema de control de versiones que
contiene la fuente original sin parchear, y cuando quiere
mantener el rbol sin parchear incluso despus de la construccin
del paquete. Habitualmente, esta opcin se introduce en
debian/source/local-options (no se permite en
debian/source/options para que todos los paquetes de fuente
generados tengan el mismo comportamiento por omisin).
--abort-on-upstream-changes
El proceso falla si se genera un parche automtico. Esta opcin se
puede usar para asegurar que todos los cambios se registren
apropiadamente en parches de quilt separados antes de la
construccin del paquete fuente. Esta opcin no se permite en
debian/source/options pero se puede usar en
debian/source/local-options.
Opciones de extraccin
--skip-debianization
Omite la extraccin del archivo tar debian sobre las fuente del
autor original.
--skip-patches
No aplica los parches al finalizar la extraccin.
Formato: 3.0 (custom)
Este formato es especial. No representa ningn formato de paquete fuente
real, pero se puede usar para crear paquetes fuente con ficheros
arbitrarios.
Opciones de construccin
Todos los argumentos que no son opciones se toman como ficheros a
integrar en el paquete fuente generado. Deben existir, a ser posible en
el directorio actual. Debe introducir al menos un fichero.
--target-format=valor
Obligatorio. Define el formato real del paquete fuente generado.
El fichero .dsc generado contendr este valor en su campo Format
y no 3.0 (custom).
Format: 3.0 (git)
This format is experimental. It uses a bundle of a git repository to
hold the source of a package.
Extraccin
The bundle is cloned to a new git repository.
Note that by default the new repository will have the same branch
checked out that was checked out in the original source. (Typically
"master", but it could be anything.) Any other branches will be
available, under as `remotes/origin/`
Construccin
Antes de continuar, se realizan algunas revisiones para asegurar que no
queden cambios no ignorados a remitir al repositorio mediante commit.
git-bundle(1) is used to generate a bundle of the git repository. By
default, all branches and tags in the repository are included in the
bundle.
Opciones de construccin
--git-ref=ref
Allows specifying a git ref to include in the git bundle. Use
disables the default behavior of including all branches and
tags. May be specified multiple times. The ref can be the name
of a branch or tag to include. It may also be any parameter that
can be passed to git-rev-list(1). For example, to include only
the master branch, use --git-ref=master. To include all tags and
branches, except for the private branch, use --git-ref=--all
--git-ref=^private
--git-depth=number
Creates a shallow clone with a history truncated to the
specified number of revisions.
Format: 3.0 (bzr)
This format is experimental. It generates a single tarball containing
the bzr repository.
Extraccin
The tarball is unpacked and then bzr is used to checkout the current
branch.
Construccin
Antes de continuar, se realizan algunas revisiones para asegurar que no
queden cambios no ignorados a remitir al repositorio mediante commit.
Entones, la parte del directorio de fuentes especfico al sistema de
control de versiones se copia a un directorio temporal. Antes de
empaquetar este directorio temporal en una archivo tar se realizan
varios procesos de limpieza, para as ahorrar espacio.
AVISOS Y ERRORES
no se defini ningn formato de fuentes en debian/source/format
El fichero debian/source/format siempre debera existir e indicar el
formato de fuentes deseado. Por razones de compatibilidad hacia atrs,
se supone el formato 1.0 cuando el fichero no existe, pero no debera
depender de esto. En algn punto en el futuro, se modificar dpkg para
que falle cuando no encuentre ese fichero.
El fundamente es que el formato 1.0 ya no es el formato recomendado,
sino que debera escoger uno de los formatos ms recientes (3.0 (quilt),
3.0 (native)). dpkg-source no har esto automticamente. Si desea
continuar usando el formato antiguo, tendr que ser explcito e insertar
1.0 en debian/source/format.
el diff modifica los siguientes ficheros de la fuente original
Generalmente, es una mala idea modificar ficheros de la fuente original
si est usando el formato de fuentes 1.0 ya que los cambios terminarn
ocultos y generalmente sin documentar dentro del fichero diff.gz.
Debera guardar los cambios como parches en el directorio debian y
aplicarlos en tiempo de construccin. Para evitar esta complejidad
tambin puede usar el formato 3.0 (quilt), que ofrece esto de forma
nativa.
no se pueden representar los cambios al fichero
Los cambios a las fuentes originales se suelen guardar el ficheros de
parche, pero no todos los cambios se pueden representar con parches:
slo pueden alterar el contenido de ficheros de texto simple. Si intenta
reemplazar un fichero con algo de otro tipo (por ejemplo, un fichero
simple con un enlace simblico o directorio), obtendr el siguiente
mensaje de error.
el fichero vaco fichero recientemente creado no estar representado en el
diff
No se pueden crear ficheros vacos con ficheros de parche. Por ello,
este cambio no se registra en el paquete fuente, est usted avisado.
los permisos de modo de ejecucin del fichero no se representarn en el diff
los permisos de modo especial del fichero no se representarn en el diff
Los ficheros de parche no registran permisos de los ficheros, y por
ello los permisos modificados no se guardan en el paquete fuente. Este
aviso le sirve de recordatorio.
FORMATOS DE FICHERO
debian/source/format
Este fichero contiene en una nica lnea el formato que se debera usar
para construir el paquete fuente (los formatos posibles se describen en
un punto anterior). No se permiten espacios vacos al principio o final
de la lnea.
debian/source/include-binaries
Este fichero contiene una lista de ficheros binarios (uno por lnea) que
se deberan incluir en el archivo tar debian. Se eliminan los espacios
vacos al principio y final de la lnea. Las lneas que comienzan con #
son comentarios, y por tanto, se omiten. Se ignorarn lneas vacas.
debian/source/options
Este fichero contiene una lista de opciones largas que se deberan
anexar al conjunto de las opciones de lnea de rdenes de una invocacin a
dpkg-source -b o dpkg-source --print-format. Las opciones como
--compression y --compression-level son adecuadas con este fichero.
Cada opcin debera aparecer en una lnea separada. Se ignorarn las lneas
vacas, y aquellas que comienzan con #. Los guiones -- al principio de
la opcin se deberan eliminar, y no se permiten opciones cortas. Se
permiten espacios adicionales en torno al smbolo =, as como comillas
dobles en torno al valor. Aqu tiene un ejemplo de este fichero:
# permite a dpkg-source crear un debian.tar.bz2 con la mxima
compresin
compression = "bzip2"
compression-level = 9
# usa debian/patches/debian-changes como parche automtico
single-debian-patch
Nota: no se permiten en este fichero las opciones de formato, y debera
usar debian/source/format en su lugar.
debian/source/local-options
Idntico a debian/source/options, a excepcin de que el fichero no se
incluye en el paquete fuente generado. Puede ser til para guardar una
preferencia ligada al mantenedor a al repositorio del sistema de
control de versiones dnde el paquete es mantenido.
debian/source/patch-header
Texto con formato libre que se inserta al inicio del parche automtico
con los formatos 2.0 o 3.0 quilt).
debian/patches/series
Este fichero lista todos los parches que se deben aplicar (en el orden
dado) al paquete fuente del autor original. Se eliminarn los espacios
vacos al principio y final de la lnea. Las lneas que comienzan con #
son comentarios, y se omiten. Las lneas restantes empiezan con un
nombre de fichero de un parche (relativo al directorio debian/patches/)
hasta el primer carcter de espacio, o el final de la lnea.
Opcionalmente, puede insetar a continuacin opciones de quilt hasta el
final de lnea, o el primer # precedido de uno o ms espacios (que
indican el inicio de un comentario hasta el final de la lnea).
FALLOS
No est claro el punto en el cual se produce la sustitucin de campos,
comparado con ciertas opciones de los campos de salida estndar.
VASE TAMBIN
dpkg-deb(1), dpkg(1), dselect(1).
AUTORES
Copyright (C) 1995-1996 Ian Jackson
Copyright (C) 2000 Wichert Akkerman
Copyright (C) 2008-2010 Raphael Hertzog
Esto es software libre; vea la versin 2 o posterior de la Licencia
Pblica General GNU para condiciones de copia. NO hay ninguna garanta.
TRADUCTOR
Rudy Godoy <rudy@kernel-panik.org>, Rubn Porras <nahoo@inicia.es>,
Bruno Barrera C. <bruno.barrera@igloo.cl>, Carlos Izquierdo
<gheesh@ertis.net>, Esteban Manchado y NOK. Debian L10n Spanish
<debian-l10n-spanish@lists.debian.org>.
Revisiones por Santiago Vila <sanvila@unex.es>, Javier
Fernndez-Sanguino, Rubn Porras, Luis Uribe y Omar Campagne.