Provided by: dpkg-dev_1.17.5ubuntu5.8_all 
NOMBRE
dpkg-source - Herramienta de manipulación de paquetes fuente de Debian «.dsc»
SINOPSIS
dpkg-source [opción...] orden
DESCRIPCIÓN
dpkg-source empaqueta y desempaqueta archivos de fuentes de Debian.
Ninguna de estas órdenes permite combinar múltiples opciones en una sola. Tampoco permiten
que el valor de una opción 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 opción,
el nombre del fichero de control de fuente de Debian (.dsc). Puede introducir un
segundo argumento que no sea una opción para definir el directorio en el que
extraer el paquete fuente, el cual no debe existir. En caso de no definir ningún
directorio, el paquete fuente se extraerá en un directorio llamado fuente-versión
dentro del directorio actual.
dpkg-source lee los nombres de los demás ficheros que componen el paquete fuente
desde el fichero de control; se asume que están en el mismo directorio que el
fichero .dsc.
Los permisos y propietarios de los ficheros del paquete extraído serán los mismos
que se esperarían si los ficheros se hubiesen simplemente creado - 0777 para
directorios y ejecutables y 0666 para el resto de ficheros, ambos modificados según
el umask del extractor. Si el directorio superior tiene activado el bit setgid, los
directorios extraídos lo tendrán también, y todos los ficheros y directorios
heredarán el grupo al que pertenece.
Si el paquete fuente usa un formato no estándar (a día 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 omisión.
-b directorio [parámetros-específicos-formato]
Construye un paquete fuente. El primer argumento, que no opción, 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 parámetros adicionales, dependiendo del formato de paquete fuente
usado en la construcción del paquete.
dpkg-source construirá el paquete fuente con el primer formato posible de esta
lista, y en este orden: el formato indicado con la opción de línea 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
debería documentar el formato fuente deseado en debian/source/format. Consulte la
sección FORMATOS DE PAQUETE FUENTE para una extensa descripción de los diferentes
formatos de paquete fuente.
--print-format directorio
Muestra el formato de fuentes a utilizar en la construcción del paquete fuente si
se ejecutó dpkg-source -b directorio (con las mismas condiciones y los mismos
parámetros).
--before-build directorio
Ejecuta la orden (o «hook») que se corresponde con el formato de paquete fuente.
Esta orden se ejecuta antes de construir un paquete (dpkg-buildpackage lo ejecuta
muy temprano en el proceso, incluso antes que debian/rules clean). Esta orden es
idempotente, y se puede ejecutar varias veces. No todos los formatos de fuente
implementan algo en este «hook», y aquellos que lo hacen habitualmente preparan el
árbol de las fuentes para la construcción, por ejemplo, comprobando que se aplican
los parches de Debian.
--after-build directorio
Ejecuta la orden (o «»hook) que se corresponde al formato de paquete fuente. Esta
orden se ejecuta después de construir un paquete (dpkg-buildpackage lo ejecuta en
último lugar). Esta orden es idempotente, y se puede ejecutar 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.
--commit [directorio] ...
Registra las modificaciones del árbol de fuentes desempaquetado en el directorio.
Esta orden acepta parámetros adicionales dependiendo del formato de fuente. Este
función devuelve error con los formatos no aceptados.
-?, --help
Muestra el modo de uso y termina.
--version
Muestra la versión y termina.
OPCIONES
Generic build options
-cfichero-de-control
Define el fichero de control principal de las fuentes del que leer la información,
debian/control por omisión. Si se introducen rutas relativas, éstas se interpretan
empezando en el directorio superior del árbol de fuentes.
-lfichero-de-cambios
Define el fichero de registro de cambios del que leer la información. Por omisión,
debian/changelog. Si se introduce una ruta relativa, ésta se interpreta empezando
en el directorio superior del árbol de fuentes.
-Fformato-fichero-de-cambios
Define el formato del fichero de cambios. Para información sobre formatos
alternativos consulte dpkg-parsechangelog(1).
--format=valor
Usa el formato dado para la construcción del paquete fuente. Esto sobreescribe
cualquier formato presente endebian/source/format.
-Vnombre=valor
Define una variable de sustitución de la salida. Consulte deb-substvars(5) para más
información acerca de la sustitución de la salida.
-Tfichero-variables-sustitución
Lee las variables de sustitución desde fichero-variables-sust; el valor por omisión
es no leer ninguno. Puede utilizar esta opción varias veces para leer variables de
sustitución de varios ficheros.
-Dcampo=valor
Sobreescribe o añade un campo en el fichero de control de salida.
-Ucampo
Elimina un campo del fichero de control de salida.
-Zcompression, --compression=compresión
Specify the compression to use for created files (tarballs and diffs). Note that
this option will not cause existing tarballs to be recompressed, it only affects
new files. Supported values are: gzip, bzip2, lzma and xz. gzip is the default. xz
is only supported since dpkg 1.15.5.
-zlevel, --compression-level=nivel
El nivel de compresión a utilizar. Al igual que -Z, sólo afecta a los ficheros
nuevos. Los valores permitidos son de 1 a 9, best, y fast. Por omisión, 9 se
utiliza para gzip y bzip2, y 6 para xz y lzma.
-i[regex], --diff-ignore[=regex]
You may specify a perl regular expression to match files you want filtered out of
the list of files for the diff. (This list is generated by a find command.) (If the
source package is being built as a version 3 source package using a VCS, this can
be used to ignore uncommited changes on specific files. Using -i.* will ignore all
of them.)
The -i option by itself enables this setting with a default regex (preserving any
modification to the default regex done by a previous use of --extend-diff-ignore)
that will filter out control files and directories of the most common revision
control systems, backup and swap files and Libtool build output directories. There
can only be one active regex, of multiple -i options only the last one will take
effect.
This is very helpful in cutting out extraneous files that get included in the diff,
e.g. if you maintain your source in a revision control system and want to use a
checkout to build a source package without including the additional files and
directories that it will usually contain (e.g. CVS/, .cvsignore, .svn/). The
default regex is already very exhaustive, but if you need to replace it, please
note that by default it can match any part of a path, so if you want to match the
begin of a filename or only full filenames, you will need to provide the necessary
anchors (e.g. '(^|/)', '($|/)') yourself.
--extend-diff-ignore=regex
The perl regular expression specified will extend the default value used by
--diff-ignore and its current value (if set). It does this by concatenating
"|regex" to the existing value. This option is convenient to use in
debian/source/options to exclude some auto-generated files from the automatic patch
generation.
-I[patrón-fichero], --tar-ignore[=patrón-fichero]
If this option is specified, the pattern will be passed to tar(1)'s --exclude
option when it is called to generate a .orig.tar or .tar file. For example, -ICVS
will make tar skip over CVS directories when generating a .tar.gz file. The option
may be repeated multiple times to list multiple patterns to exclude.
-I by itself adds default --exclude options that will filter out control files and
directories of the most common revision control systems, backup and swap files and
Libtool build output directories.
Note: While they have similar purposes, -i and -I have very different syntax and
semantics. -i can only be specified once and takes a perl compatible regular expression
which is matched against the full relative path of each file. -I can specified multiple
times and takes a filename pattern with shell wildcards. The pattern is applied to the
full relative path but also to each part of the path individually. The exact semantic of
tar's --exclude option is somewhat complicated, see
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.
The default regex and patterns for both options can be seen in the output of the --help
command.
Generic extract options
--no-copy
No copia los ficheros tar originales cerca del paquete fuente extraído.
--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 específicos 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, debería seleccionar o bien «3.0 (quilt)» o «3.0
(native)». Consulte «https://wiki.debian.org/Projects/DebSrc3.0» para más información
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).
Extracción
Extraer un paquete nativo es simplemente una extracción de un único archivo tar en el
directorio destino. Extraer un paquete no nativo se realiza, primero, desempaquetando el
.orig.tar.gz para después 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 automáticamente). El «diff» puede crear nuevos ficheros
(todo el directorio «debian/» se crea de esta manera) pero no puede eliminar ficheros (los
ficheros vacíos permanecerán en el sistema).
Construcción
Construir un paquete nativo consiste de la creación 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 comparación del directorio del
paquete fuente con el directorio «.orig».
Opciones de construcción (con -b):
Si hay un segundo argumento, debería ser el nombre del directorio de fuentes, del fichero
tar original o la cadena vacía, si el paquete es específico de Debian y por tanto carece
de diffs «debianizantes». Si no se proporciona un segundo argumento, dpkg-source buscará
el archivo tar original paquete_versión-autor-original.orig.tar.gz o el directorio de
fuentes original directorio.orig en función de los argumentos -sX.
-sa, -sp, -sk, -su y -sr no sobreescribirán directorios o ficheros tar existentes. Si esto
es lo que desea, debería utilizar -sA, -sP, -sK, -sU y -sR en su lugar.
-sk Define que se espera la fuente original como un archivo tar, por omisión
paquete_versión-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
generación del «diff».
-sp Idéntica a -sk, a diferencia de que eliminará el directorio al finalizar.
-su Define que se espera que la fuente original sea un directorio, por omisión
paquete-versión-autor-original.orig, y que dpkg-source creará un fichero de fuentes
nuevo a partir de él.
-sr Idéntica a -su, a diferencia de que eliminará el directorio después de su uso.
-ss Specifies that the original source is available both as a directory and as a
tarfile. dpkg-source will use the directory to create the diff, but the tarfile to
create the .dsc. This option must be used with care - if the directory and tarfile
do not match a bad source archive will be generated.
-sn Omite la búsqueda de la fuente original y no generará un «diff». El segundo
argumento, en caso de existir, debe ser la cadena vacía. Esta opción se usa en
paquetes específicos de Debian que no tienen fuentes del autor original por
separado, y por tanto carecen de ficheros «diff» «debianizantes».
-sa or -sA
Defina una búsqueda 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
vacía (equivale a utilizar -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, sobreescribiéndolo, si se especificó -sA (equivale a -sP), o generará
un error si se definió -sa. -sA es la opción predefinida.
--abort-on-upstream-changes
El procesa dará fallo si el «diff» generado contiene cambios realizados a ficheros
fuera del subdirectorio «debian». Esta opción no se puede utilizar en
debian/source/options pero se puede utilizar en debian/source/local-options.
Opciones de extracción (con -x):
En todos los casos cualquier árbol de fuentes original será eliminado.
-sp Si se usa en la extracción, 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 acción por omisión).
-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 más de una, sólo se usará la
última.
--skip-debianization
Omite la aplicación del «diff» de debian con las fuentes del autor original.
Formato: 2.0
También 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 especificación de un formato de
paquete fuente de nueva generación.
El comportamiento de este formato es idéntico al del formato «3.0 (quilt)», a excepción de
que no usa una lista explícita de parches. Todos los ficheros en debian/patches/ que
coinciden con la expresión regular de perl [\w-]+ deben ser parches válidos: se aplican
durante el proceso de extracción.
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 extensión del formato de paquete nativo como se define en el formato
1.0. Es compatible con todos los métodos de compresión, e ignorará cualquier fichero o
directorio específico a sistemas de control de versiones, así como muchos ficheros
temporales (consulte el valor predefinido asociado a la opción -I en la salida de --help).
Format: 3.0 (quilt)
A source package in this format contains at least an original tarball (.orig.tar.ext where
ext can be gz, bz2, lzma and xz) and a debian tarball (.debian.tar.ext). It can also
contain additional original tarballs (.orig-component.tar.ext). component can only
contain alphanumeric characters and hyphens ("-").
Extracción
Primero se extrae el archivo tar original, y después 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 raíz del árbol después de la eliminación de cualquier directorio debian
preexistente. Tenga en cuenta que el archivo tar de Debian debe contener un subdirectorio
debian, pero también puede contener ficheros binarios externos a ese directorio (consulte
la opción --include-binaries).
All patches listed in debian/patches/debian.series or debian/patches/series are then
applied. If the former file is used and the latter one doesn't exist (or is a symlink),
then the latter is replaced with a symlink to the former. This is meant to simplify usage
of quilt to manage the set of patches. Note however that while dpkg-source parses
correctly series files with explicit options used for patch application (stored on each
line after the patch filename and one or more spaces), it does ignore those options and
always expect patches that can be applied with the -p1 option of patch. It will thus emit
a warning when it encounters such options, and the build is likely to fail.
Contrary to quilt's default behaviour, patches are expected to apply without any fuzz.
When that is not the case, you should refresh such patches with quilt, or dpkg-source will
error out while trying to apply them.
Similarly to quilt's default behaviour, the patches can remove files too.
El fichero .pc/applied-patches se crea si se aplican parches durante la extracción.
Construcción
All original tarballs found in the current directory are extracted in a temporary
directory by following the same logic as for the unpack, the debian directory is copied
over in the temporary directory, and all patches except the automatic patch
(debian-changes-version or debian-changes, depending on --single-debian-patch) are
applied. The temporary directory is compared to the source package directory. When the
diff is non-empty, the build fails unless --single-debian-patch or --auto-commit has been
used, in which case the diff is stored in the automatic patch. If the automatic patch is
created/deleted, it's added/removed from the series file and from the quilt metadata.
Cualquier cambio en un fichero binario no se puede representar en un «diff», conduciendo
así a un fallo a menos que el desarrollador decida explícitamente incluir el fichero
binario modificado en el archivo tar «debian» (mediante su listado en
debian/source/include-binaries). La construcción también fallará si encuentra ficheros
binarios en el subdirectorio «debian», a menos que estén 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.
The automatically generated diff doesn't include changes on VCS specific files as well as
many temporary files (see default value associated to -i option in the --help output). In
particular, the .pc directory used by quilt is ignored during generation of the automatic
patch.
Nota: dpkg-source --before-build (y -b) comprueban que los parches enumerados en el
fichero «series» se han aplicado, para así garantizar que la construcción del paquete
siempre tenga todos los parches aplicados. Para ello, encuentra la lista de parches no
aplicados (listados en el fichero series pero no en .pc/applied-patches) y si aplica el
primer parche del conjunto sin problemas, procederá a aplicar el resto. Puede utilizar la
opción --no-preparation para desactivar este comportamiento.
Registrar cambios
--commit [directorio] [nombre-parche] [fichero-parche]
Generates a patch corresponding to the local changes that are not managed by the
quilt patch system and integrates it in the patch system under the name patch-name.
If the name is missing, it will be asked interactively. If patch-file is given, it
is used as the patch corresponding to the local changes to integrate. Once
integrated, an editor is launched so that you can edit the meta-information in the
patch header.
Introducir fichero-parche es generalmente útil después de un fallo de construcción
que ha generado este fichero previamente, y en base a ello, el fichero dado se
elimina después de la integración. Tenga en cuenta que los cambios contenidos en el
fichero de parche debe estar aplicado en el árbol, y que los ficheros modificados
por el parche no deben contener cambios adicionales sin registrar.
Si la generación del parche detecta ficheros binarios modificados, se añaden de
forma automática a debian/source/include-binaries para que se incluyan en el
fichero tar de debian (al igual que realiza dpkg-source --include-binaries -b).
Opciones de construcción
--allow-version-of-quilt-db=versión
Allow dpkg-source to build the source package if the version of the quilt metadata
is the one specified, even if dpkg-source doesn't know about it. Effectively this
says that the given version of the quilt metadata is compatible with the version 2
that dpkg-source currently supports. The version of the quilt metadata is stored in
.pc/.version.
--include-removal
No ignora los ficheros eliminados y los incluye en el parche generado
automáticamente.
--include-timestamp
Incluye la marca temporal en el parche generado automáticamente.
--include-binaries
Añade todos los ficheros binarios modificados al archivo tar «debian». También los
añade a debian/source/include-binaries: se añadirán por omisión en futuras
construcciones, con lo que esta opción ya no será necesaria.
--no-preparation
No intenta preparar el árbol de construcción aplicando parches que están
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 automáticamente durante la construcción. Esta
opción 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. La opción se
debería poner en debian/source/local-options, acompañado de un fichero
debian/source/local-patch-header que detalle la mejor forma de revisar los cambios
de Debian, por ejemplo, el sistema de control de versiones en uso.
--create-empty-orig
Crea automáticamente el archivo tar principal y original como vacío en caso de no
existir y si hay otros archivos tar originales adicionales. Esta opción está
diseñada para su uso cuando el paquete fuente es un conjunto de varios programas de
la fuente principal y cuando no hay programas «principales».
--no-unapply-patches, --unapply-patches
By default, dpkg-source will automatically unapply the patches in the --after-build
hook if it did apply them during --before-build. Those options allow you to
forcefully disable or enable the patch unapplication process. Those options are
only allowed in debian/source/local-options so that all generated source packages
have the same behavior by default.
--abort-on-upstream-changes
The process fails if an automatic patch has been generated. This option can be used
to ensure that all changes were properly recorded in separate quilt patches prior
to the source package build. This option is not allowed in debian/source/options
but can be used in debian/source/local-options.
--auto-commit
The process doesn't fail if an automatic patch has been generated, instead it's
immediately recorded in the quilt series.
Opciones de extracción
--skip-debianization
Omite la extracción del archivo tar «debian» sobre las fuente del autor original.
--skip-patches
No aplica los parches al finalizar la extracción.
Formato: 3.0 (custom)
Este formato es especial. No representa ningún formato de paquete fuente real, pero se
puede utilizar para crear paquetes fuente con ficheros arbitrarios.
Opciones de construcción
Todas las opciones que no son argumento se toman como ficheros a integrar en el paquete
fuente generado. Deben existir y, preferiblemente, encontrarse en el directorio actual. Se
debe introducir al menos un fichero.
--target-format=valor
Required. Defines the real format of the generated source package. The generated
.dsc file will contain this value in its Format field and not "3.0 (custom)".
Format: 3.0 (git)
Este formato es experimental.
Un paquete de fuente con este formato consiste de un sólo archivo con un repositorio .git,
que guarda la fuente del paquete. Puede también existir un fichero .gitshallow que lista
las revisiones de una clonación de git superficial («shallow»).
Extracción
El archivo se clona como un repositorio git en el directorio destino. Si hay un fichero
«gitshallow», se instala como «.git/shallow» dentro del repositorio git clonado.
Tenga en cuenta que, por omisión, el nuevo repositorio tendrá un «checkout» de la misma
rama de la que se realizó el «checkout» de la fuente original. (Habitualmente, «master»,
pero podría ser cualquier otra cosa.) Todas las demás ramas estarán disponibles bajo
«remotes/origin/».
Construcción
Antes de continuar, se realizan algunas revisiones para asegurar que no queden cambios no
ignorados a remitir al repositorio mediante «commit».
git-bundle(1) se usa para generar un archivo a partir de un repositorio git. Por omisión,
se incluyen en el archivo todas las ramas y etiquetas en el repositorio.
Opciones de construcción
--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
Crea un clon superficial («shalow») con la historia truncada en el número definido
de revisiones.
Format: 3.0 (bzr)
Este formato es experimental. Genera un único archivo tar que contiene el repositorio bzr.
Extracción
El archivo tar se desempaqueta, usando después bzr para realizar un «checkout» de la rama
actual.
Construcción
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 específico 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.
DIAGNÓSTICOS
no se definió ningún formato de fuentes en «debian/source/format»
The file debian/source/format should always exist and indicate the desired source format.
For backwards compatibility, format "1.0" is assumed when the file doesn't exist but you
should not rely on this: at some point in the future dpkg-source will be modified to fail
when that file doesn't exist.
El fundamente es que el formato «1.0» ya no es el formato recomendado, sino que debería
escoger uno de los formatos más recientes («3.0 (quilt)», «3.0 (native)»). dpkg-source no
hará esto automáticamente. Si desea continuar usando el formato antiguo, tendrá que ser
explícito 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 terminarán ocultos y generalmente sin
documentar dentro del fichero «diff.gz». Debería guardar los cambios como parches en el
directorio «debian» y aplicarlos en tiempo de construcción. Para evitar esta complejidad
también puede utilizar 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: sólo 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 simbólico o directorio), obtendrá el siguiente
mensaje de error.
el fichero vacío fichero recientemente creado no estará representado en el «diff»
No se pueden crear ficheros vacíos con ficheros de parche. Por ello, este cambio no se
registra en el paquete fuente, está usted avisado.
los permisos de modo de ejecución del fichero no se representarán en el «diff»
Patch files do not record permissions of files and thus executable permissions are not
stored in the source package. This warning reminds you of that fact.
los permisos de modo especial del fichero no se representarán 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 línea el formato que se debería utilizar para construir
el paquete fuente (los formatos posibles se describen en un punto anterior). No se
permiten espacios vacíos al principio o final de la línea.
debian/source/include-binaries
Este fichero contiene una lista de ficheros binarios (uno por línea) que se deberían
incluir en el archivo tar «debian». Se eliminan los espacios vacíos al principio y final
de la línea. Las líneas que comienzan con «#» son comentarios, y por tanto, se omiten. Se
ignorarán líneas vacías.
debian/source/options
Este fichero contiene una lista de opciones largas que se deberían anexar al conjunto de
las opciones de línea de órdenes de una ejecución a dpkg-source -b o dpkg-source
--print-format. Las opciones como --compression y --compression-level son adecuadas con
este fichero.
Cada opción debería aparecer en una línea separada. Se ignorarán las líneas vacías, y
aquellas que comienzan con «#». Los guiones «--» al principio de la opción se deberían
eliminar, y no se permiten opciones cortas. Se permiten espacios adicionales en torno al
símbolo «=», 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 máxima compresión
compression = "bzip2"
compression-level = 9
# usa debian/patches/debian-changes como parche automático
single-debian-patch
# ignora cambios en config.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"
Nota: no se permiten en este fichero las opciones de formato, y debería utilizar
debian/source/format en su lugar.
debian/source/local-options
Idéntico a debian/source/options, a excepción 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 dónde el paquete es mantenido.
debian/source/local-patch-header and debian/source/patch-header
Texto con formato libre que se inserta al inicio del parche generado de forma automática
con los formatos «2.0» o «3.0 quilt)». local-patch-header no se incluye en las fuentes
generadas, mientras que patch-header sí.
debian/patches/series
This file lists all patches that have to be applied (in the given order) on top of the
upstream source package. Leading and trailing spaces are stripped. Lines starting with "#"
are comments and are skipped. Empty lines are ignored. Remaining lines start with a patch
filename (relative to the debian/patches/ directory) up to the first space character or
the end of line. Optional quilt options can follow up to the end of line or the first "#"
preceded by one or more spaces (which marks the start of a comment up to the end of line).
FALLOS
No está claro el punto en el cual se produce la sustitución de campos, comparado con
ciertas opciones de los campos de salida estándar.
VÉASE TAMBIÉN
dpkg-deb(1), dpkg(1), dselect(1).
TRADUCTOR
Rudy Godoy <rudy@kernel-panik.org>, Rubén 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 Fernández-Sanguino, Rubén Porras,
Luis Uribe y Omar Campagne.