dpkg-source(1)

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, --extract filename.dsc [output-directory]
    Extract a source package. The --extract alias was added in dpkg 1.17.14. One non-option argument must be supplied, the name of the Debian source control file (.dsc). An optional second non-option argument may be supplied to specify the directory to extract the source package to, this must not exist. If no output directory is specified, the source package is extracted into a directory named source-version under the current working directory. 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, --build directory [format-specific-parameters]
    Build a source package. The --build alias was added in dpkg 1.17.14. The first non-option argument is taken as the name of the directory containing the debianized source tree (i.e. with a debian sub-directory and maybe changes to the original files). Depending on the source package format used to build the package, additional parameters might be accepted. 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
    Print the source format that would be used to build the source package if dpkg-source --build directory was called (in the same conditions and with the same parameters).

--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. The default is xz for formats 2.0 and newer, and gzip for format 1.0. 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.

--ignore-bad-version
    Turns the bad source package version check into a non-fatal warning. This option should only be necessary when extracting ancient source packages with broken versions, just for backwards compatibility.

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». Build options (with --build): 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.

Extract options (with --extract): 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. Note: dpkg-source --before-build (and --build) will ensure that all patches listed in the series file are applied so that a package build always has all patches applied. It does this by finding unapplied patches (they are listed in the series file but not in .pc/applied-patches), and if the first patch in that set can be applied without errors, it will apply them all. The option --no-preparation can be used to disable this behavior.

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. If the patch generation detects modified binary files, they will be automatically added to debian/source/include-binaries so that they end up in the debian tarball (exactly like dpkg-source --include-binaries --build would do).

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
This file contains a list of long options that should be automatically prepended to the set of command line options of a dpkg-source --build or dpkg-source --print-format call. Options like --compression and --compression-level are well suited for this file.

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.