Provided by: dpkg-dev_1.16.1.2ubuntu7_all bug

NOMBRE

       dpkg-source  - Herramienta de manipulación de paquetes fuente de Debian
       «.dsc»

SINOPSIS

       dpkg-source [option...] command

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-versin 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 [parmetros-especficos-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 will build the source package with the first  format
              found  in  this  ordered  list:  the  format  indicated with the
              --format  command  line  option,   the   format   indicated   in
              debian/source/format, "1.0". The fallback to "1.0" is deprecated
              and will be removed at some point  in  the  future,  you  should
              always     document     the    desired    source    format    in
              debian/source/format. See section SOURCE PACKAGE FORMATS for  an
              extensive description of the various source package formats.

       --print-format directorio
              Muestra  el  formato  de  fuentes  a usar en la construcción del
              paquete fuente si se invocó dpkg-source -b directorio  (con  las
              mismas condiciones y los mismos parámetros).

       --before-build directorio
              Run  the  corresponding  hook of the source package format. This
              hook   is   called   before   any   build   of    the    package
              (dpkg-buildpackage  calls it very early even before debian/rules
              clean). This command is idempotent and can  be  called  multiple
              times.  Not all source formats implement something in this hook,
              and those that do usually prepare the source tree for the  build
              for example by ensuring that the Debian patches are applied.

       --after-build directorio
              Run  the  corresponding  hook of the source package format. This
              hook is called after any build of the package (dpkg-buildpackage
              calls  it  last).  This  command is idempotent and can be called
              multiple times. Not all source formats  implement  something  in
              this  hook,  and  those  that  do  usually  use  it to undo what
              --before-build has done.

       --commit [directory] ...
              Record changes in the source tree unpacked  in  directory.  This
              command  can  take  supplementary  parameters  depending  on the
              source format.   It  will  error  out  for  formats  where  this
              operation doesn't mean anything.

       -h, --help
              Muestra el modo de uso y termina.

       --version
              Muestra la versión y termina.

OPCIONES GENÉRICAS DE CONSTRUCCIÓN

       -cfichero-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-cambios
              Define el fichero  de  registro  de  cambios  del  que  leer  la
              información,  debian/changelog  por  omisión.  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 omisión, el
              formato se lee  de  una  línea  especial  cerca  del  final  del
              registro de cambios o, en caso de fallo, usa el formato estándar
              debian.

       --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-sust
              Lee las variables de sustitución  desde  fichero-variables-sust;
              el  valor por omisión es no leer ninguno. Puede usar 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=compresin
              Define qué compresión usar con los  ficheros  creados  (archivos
              tar  y  ficheros  «diff»).  Tenga  en  cuenta que esta opción no
              provoca que los archivos tar existentes se compriman nuevamente,
              sólo  afecta  a los ficheros nuevos. Los valores permitidos son:
              gzip,  bzip2,  lzma  y  xz.  gzip  se  usa   por   omisión.   La
              compatibilidad con xz es posible desde dpkg-dev 1.15.5.

       -zlevel, --compression-level=nivel
              Compression  level  to  use.  As  with  -Z it only affects newly
              created files. Supported values are: 1 to  9,  best,  and  fast.
              The default is 9 for gzip and bzip2, 6 for xz and lzma.

       -i[expresin-regular], --diff-ignore[=expresin-regular]
              Puede  especificar  una  expresión  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
              específicos,  en  caso  de  construir  un paquete fuente como un
              paquete fuente versión 3 usando VCS. Por sí mismo, -i activa  la
              opción  con  una  expresión  regular predefinida que elimina los
              ficheros y directorios de control de los sistemas de control  de
              versiones más comunes, los ficheros de respaldo, los ficheros de
              intercambio y los directorios que se generan como  resultado  de
              las  operaciones  de  Libtool.  Sólo  puede  haber una expresión
              regular activa, y en caso de existir varias opciones -i sólo  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 expresión regular  predefinida
              es  bastante  completa,  pero si necesita reemplazarla, tenga en
              cuenta que por omisión, puede coincidir con cualquier  parte  de
              la  ruta. Por ello, si desea emparejar el principio de un nombre
              de fichero, o sólo nombres  de  fichero  completos,  tendrá  que
              introducir  directamente  el  anclaje  necesario  (por  ejemplo,
              '(^|/)', '($|/)').

       --extend-diff-ignore=expresin-regular
              The perl regular expression specified will  extend  the  default
              value  of  --diff-ignore and its current value (if set). It does
              this by concatenating "|regexp" 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[patrn-fichero], --tar-ignore[=patrn-fichero]
              Si se especifica esta opción, el nombre  de  fichero  se  pasará
              como  parámetro  a la opción «--exclude» de tar(1) al generar el
              fichero «.orig.tar» o «.tar». Por ejemplo, «-ICVS» hará que  tar
              omita los directorios CVS cuando genere el fichero «.tar.gz». La
              opción se puede repetir varias veces para listar varios patrones
              a excluir.

              Por  si  mismo,  -I añade las opciones predefinidas «--exclude»,
              que filtrarán los ficheros de control y los directorios  de  los
              sistemas  de  control  de  versiones  más  comunes,  ficheros de
              respaldo  e  intercambio,  y  los  directorios  de   salida   de
              construcción de Libtool.

       Nota: A pesar de tener objetivos similares, i y I tienen una sintaxis y
       semántica muy diferentes. Sólo puede especificar i una  vez,  que  toma
       una  expresión  regular  compatible con Perl, la cual se compara con la
       ruta relativa de cada fichero. Puede especificar I varias veces, y toma
       un  patrón de nombre de fichero con comodines de intérprete de órdenes.
       El patrón se compara con la ruta relativa, y también con cada parte  de
       la  ruta,  de  manera  individual.  La  semántica  exacta  de la opción
       «--exclude»     de     tar     es     algo     complicada,     consulte
       http://www.gnu.org/software/tar/manual/tar.html#wildcards    para   una
       completa documentación.

       Puede consultar los patrones y expresiones  regulares  predefinidas  de
       ambas opciones en la salida de la orden --help.

OPCIONES DE EXTRACCIÓN GENÉRICAS

       --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
       «http://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_versin-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_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
              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-versin-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    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 opción con precaución, ya que si el directorio  y
              el  archivo  tar  no  coinciden  se  generará  un archivo fuente
              inválido.

       -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  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, 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 usar en debian/source/options pero  se  puede
              usar 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)
       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).   También  contiene  archivos  tar
       originales  adicionales  (.orig-componente.tar.ext).  componente   sólo
       puede contener caracteres alfanuméricos y guiones («-»).

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

       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 simbólico), éste
       se reemplazará con un enlace simbólico 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 explícitas para la
       aplicación del parche (guardados en cada línea después  del  nombre  de
       fichero  del parche y uno o más espacios), ignora aquellas opciones que
       siempre esperan parches que se puedan aplicar  con  la  opción  -p1  de
       patch.  De  no  ser  así,  mostrará un aviso en caso de encontrar tales
       opciones, y cabe que la construcción falle.

       De forma similar al comportamiento predefinido de  quilt,  los  parches
       también pueden eliminar ficheros.

       El  fichero  .pc/applied-patches  se  crea  en  caso de aplicar 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.

       El «diff» generado  automáticamente  no  incluye  cambios  en  ficheros
       específicos  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 creación del parche automático.

       Note: dpkg-source --before-build (and -b) 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.

       Recording changes

       --commit [directory] [patch-name] [patch-file]
              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.  This  is  mainly  useful  after a build failure that
              pre-generated this file. Once integrated, an editor is  launched
              so that you can edit the meta-information in the patch header.

       Opciones de construcción

       --allow-version-of-quilt-db=versin
              Permite  que  dpkg-source  construya  el  paquete  fuente  si la
              versión de los metadatos de quilt es el especificado, incluso si
              dpkg-source  no  lo  conoce.  De hecho, esto dice que la versión
              dada de los metadatos de quilt es compatible con la  versión  2,
              con  la  que  dpkg-source tiene compatibilidad actualmente. Esta
              versión de los metadatos de quilt se guardan en .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
              Use        debian/patches/debian-changes        instead       of
              debian/patches/debian-changes-version  for  the  name   of   the
              automatic   patch   generated   during  build.  This  option  is
              particularly useful when the package is maintained in a VCS  and
              a  patch  set  can't  reliably be generated. Instead the current
              diff with upstream should be  stored  in  a  single  patch.  The
              option  would be put in debian/source/local-options and would be
              accompanied   by   a    debian/source/local-patch-header    file
              explaining  how  the  Debian  changes  can be best reviewed, for
              example in the VCS that is used.

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

       --unapply-patches
              Unapply the patches in the --after-build hook. You usually don't
              need  this  option as dpkg-source will automatically unapply the
              patches if it did apply them during --before-build. This  option
              is  only  allowed  in  debian/source/local-options  so  that all
              generated source packages have the same behavior by default.

       --abort-on-upstream-changes
              El proceso falla si se genera un parche automático. Esta  opción
              se  puede  usar para asegurar que todos los cambios se registren
              apropiadamente  en  parches  de  quilt  separados  antes  de  la
              construcción  del  paquete  fuente. Esta opción no se permite en
              debian/source/options     pero     se     puede     usar      en
              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)
       This format is special. It doesn't  represent  a  real  source  package
       format but can be used to create source packages with arbitrary files.

       Opciones de construcción

       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)
       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
              Permite  especificar  una referencia («ref») de git a incluir en
              el  archivo  de  git.  Su  uso   desactiva   el   comportamiento
              predefinido  de  incluir todas las ramas y etiquetas, y se puede
              definir varias veces. ref puede ser el  nombre  de  una  rama  o
              etiqueta  a  incluir.  Por  ejemplo,  para  incluir sólo la rama
              «master»,  use  «--git-ref=master».  Para  incluir   todas   las
              etiquetas  y ramas a excepción de la rama local («private»), 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.

AVISOS Y ERRORES

   no se definió ningún formato de fuentes en «debian/source/format»
       El  fichero  debian/source/format  siempre debería existir e indicar el
       formato de fuentes deseado. Por razones de compatibilidad hacia  atrás,
       se supone el formato «1.0» cuando el fichero no existe, pero no debería
       depender de esto. En algún 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 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 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:
       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»
   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 usar
       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
       invocació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:

         # let dpkg-source create a debian.tar.bz2 with maximal compression
         compression = "bzip2"
         compression-level = 9
         # use debian/patches/debian-changes as automatic patch
         single-debian-patch
         # ignore changes on config.{sub,guess}
         extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

       Nota: no se permiten en este fichero las opciones de formato, y debería
       usar 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
   debian/source/patch-header
       Free  form  text that is put on top of the automatic patch generated in
       formats "2.0" or "3.0 (quilt)". local-patch-header is not  included  in
       the generated source package while patch-header is.

   debian/patches/series
       Este  fichero lista todos los parches que se deben aplicar (en el orden
       dado) al paquete fuente del autor original. Se eliminarán los  espacios
       vacíos  al  principio y final de la línea. Las líneas que comienzan con
       «#» son comentarios, y se omiten. Las líneas restantes empiezan con  un
       nombre de fichero de un parche (relativo al directorio debian/patches/)
       hasta  el  primer  carácter  de  espacio,  o  el  final  de  la  línea.
       Opcionalmente,  puede insetar a continuación opciones de quilt hasta el
       final de línea, o el primer «#» precedido de uno o  más  espacios  (que
       indican el inicio de un comentario hasta el final de la línea).

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

AUTORES

       Copyright © 1995-1996 Ian Jackson
       Copyright © 2000 Wichert Akkerman
       Copyright © 2008-2011 Raphaël Hertzog

       Esto es software libre; vea la versión 2 o  posterior  de  la  Licencia
       Pública General GNU para condiciones de copia. NO hay ninguna garantía.

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.