Provided by: dpkg-dev_1.16.0.3ubuntu5_all bug

NOMBRE

       dpkg-source  - Herramienta de manipulacion de paquetes fuente de Debian
       <<.dsc>>

SINOPSIS

       dpkg-source [opciones] orden

DESCRIPCI'ON

       dpkg-source empaqueta y desempaqueta archivos de fuentes de Debian.

       Ninguna de estas ordenes permite combinar  multiples  opciones  en  una
       sola.  Tampoco permiten que el valor de una opcion se especifique en un
       argumento separado.

'ORDENES

       -x fichero.dsc [directorio-salida]
              Extrae un paquete fuente. Se debe suministrar un  argumento  que
              no sea una opcion, el nombre del fichero de control de fuente de
              Debian (.dsc). Puede introducir un segundo argumento que no  sea
              una  opcion  para  definir  el  directorio  en el que extraer el
              paquete fuente, el cual no debe existir. En caso de  no  definir
              ningun   directorio,   el  paquete  fuente  se  extraera  en  un
              directorio llamado fuente-versi'on dentro del directorio actual.

              dpkg-source lee los nombres de los demas ficheros  que  componen
              el  paquete  fuente  desde  el  fichero de control; se asume que
              estan en el mismo directorio que el fichero .dsc.

              Los permisos y propietarios de los ficheros del paquete extraido
              seran  los  mismos que se esperarian si los ficheros se hubiesen
              simplemente creado - 0777 para directorios y ejecutables y  0666
              para  el resto de ficheros, ambos modificados segun el umask del
              extractor. Si el  directorio  superior  tiene  activado  el  bit
              setgid,  los  directorios  extraidos lo tendran tambien, y todos
              los ficheros y directorios heredaran el grupo al que pertenece.

              Si el paquete fuente usa un formato no estandar (a dia  de  hoy,
              todos  los  formatos  menos  <<1.0>>),  su nombre se guardara en
              debian/source/format para que las siguientes construcciones  del
              paquete fuente usen el mismo formato por omision.

       -b directorio [par'ametros-espec'ificos-formato]
              Construye un paquete fuente. El primer argumento, que no opcion,
              se toma como el nombre del directorio que contiene el  arbol  de
              fuentes  <<debianizado>>  (por  ejemplo,  con  un  subdirectorio
              <<debian/>>, y puede que cambios en  los  ficheros  originales).
              Puede   especificar   parametros  adicionales,  dependiendo  del
              formato de paquete fuente usado en la construccion del paquete.

              dpkg-source construira el paquete fuente con el  primer  formato
              posible de esta lista, y en este orden: el formato indicados con
              la opcion de linea de ordenes --format, el formato  indicado  en
              debian/source/format,  <<1.0>>. El uso predefinido de <<1.0>> en
              ausencia de otro valor  esta  obsoleto  y  se  eliminara  en  el
              futuro.  Siempre deberia documentar el formato fuente deseado en
              debian/source/format. Consulte la seccion  FORMATOS  DE  PAQUETE
              FUENTE  para  una extensa descripcion de los diferentes formatos
              de paquete fuente.

       --print-format directorio
              Muestra el formato de fuentes a  usar  en  la  construccion  del
              paquete  fuente  si se invoco dpkg-source -b directorio (con las
              mismas condiciones y los mismos parametros).

       --before-build directorio
              Se deberia invocar esta orden  antes  de  construir  un  paquete
              (dpkg-buildpackage lo invoca muy temprano en el proceso, incluso
              antes  que  debian/rules  clean).   Esta   orden   deberia   ser
              idempotente,  y  se  puede  invocar  varias  veces. No todos los
              formatos  de  fuentes  implementan  algo  en  este  <<hook>>,  y
              aquellos  que  lo  hacen  habitualmente preparan el arbol de las
              fuentes para la construccion, por ejemplo,  comprobando  que  se
              aplican los parches de Debian.

       --after-build directorio
              Se  deberia  invocar  esta orden despues de construir un paquete
              (dpkg-buildpackage  lo  invoca  en  ultimo  lugar).  Esta  orden
              deberia  ser  idempotente,  y  se puede invocar varias veces. No
              todos los formatos de fuentes implementan algo en este <<hook>>,
              y  aquellos  que lo hacen lo usan habitualmente para deshacer lo
              que --before-build ha hecho.

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

       --version
              Muestra la version y termina.

OPCIONES GEN'ERICAS DE CONSTRUCCI'ON

       -cfichero-control
              Define el fichero de control principal de las  fuentes  del  que
              leer   la   informacion,   debian/control  por  omision.  Si  se
              introducen rutas relativas, estas se interpretan empezando en el
              directorio superior del arbol de fuentes.

       -lfichero-cambios
              Define  el  fichero  de  registro  de  cambios  del  que leer la
              informacion, debian/changelog  por  omision.  Si  se  introducen
              rutas relativas, estas se interpretan empezando en el directorio
              superior del arbol de fuentes.

       -Fformato-registro-cambios
              Define el formato del  registro  de  cambios.  Por  omision,  el
              formato  se  lee  de  una  linea  especial  cerca  del final del
              registro de cambios o, en caso de fallo, usa el formato estandar
              debian.

       --format=valor
              Usa  el  formato  dado  para la construccion del paquete fuente.
              Esto      sobreescribe      cualquier      formato      presente
              endebian/source/format.

       -Vnombre=valor
              Define  una  variable  de  sustitucion  de  la  salida. Consulte
              deb-substvars(5) para mas informacion acerca de  la  sustitucion
              de la salida.

       -Tfichero-variables-sust
              Lee  las  variables de sustitucion desde fichero-variables-sust;
              el valor por omision es no leer ninguno. Puede usar esta  opcion
              varias  veces  para  leer  variables  de  sustitucion  de varios
              ficheros.

       -Dcampo=valor
              Sobreescribe o anade un  campo  en  el  fichero  de  control  de
              salida.

       -Ucampo
              Elimina un campo del fichero de control de salida.

       -Zcompression, --compression=compresi'on
              Define  que  compresion  usar con los ficheros creados (archivos
              tar y ficheros <<diff>>). Tenga en cuenta  que  esta  opcion  no
              provoca que los archivos tar existentes se compriman nuevamente,
              solo afecta a los ficheros nuevos. Los valores  permitidos  son:
              gzip,   bzip2,   lzma   y  xz.  gzip  se  usa  por  omision.  La
              compatibilidad con xz es posible desde dpkg-dev 1.15.5.

       -zlevel, --compression-level=nivel
              El nivel de compresion a usar. Al igual que -Z,  solo  afecta  a
              los  ficheros nuevos. Los valores permitidos son de 1 a 9, best,
              y fast. 9 se usa por omision.

       -i[expresi'on-regular], --diff-ignore[=expresi'on-regular]
              Puede especificar una expresion 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
              especificos, en caso de construir  un  paquete  fuente  como  un
              paquete  fuente version 3 usando VCS. Por si mismo, -i activa la
              opcion con una expresion regular  predefinida  que  elimina  los
              ficheros  y directorios de control de los sistemas de control de
              versiones mas comunes, los ficheros de respaldo, los ficheros de
              intercambio  y  los directorios que se generan como resultado de
              las operaciones de  Libtool.  Solo  puede  haber  una  expresion
              regular  activa, y en caso de existir varias opciones -i solo se
              tendra en cuenta la ultima.

              Esto es util 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  expresion  regular
              predefinida es bastante completa, pero si necesita reemplazarla,
              tenga  en  cuenta que por omision, puede coincidir con cualquier
              parte de la ruta. Por ello, si desea emparejar el  principio  de
              un  nombre  de  fichero,  o  solo  nombres de fichero completos,
              tendra que introducir directamente  el  anclaje  necesario  (por
              ejemplo, '(^|/)', '($|/)').

       --extend-diff-ignore=expresi'on-regular
              La  expresion  regular  de  perl definida extendera la expresion
              regular predefinida asociada a -i, concatenando <<|regexp>> a la
              expresion  regular  predefinida. Es conveniente usar esta opcion
              en debian/source/options para excluir algunos ficheros generados
              automaticamente a partir de la generacion automatica de parches.

       -I[patr'on-fichero], --tar-ignore[=patr'on-fichero]
              Si  se  especifica  esta  opcion, el nombre de fichero se pasara
              como parametro a la opcion <<--exclude>> de tar(1) al generar el
              fichero  <<.orig.tar>>  o  <<.tar>>. Por ejemplo, <<-ICVS>> hara
              que tar omita los  directorios  CVS  cuando  genere  el  fichero
              <<.tar.gz>>. La opcion se puede repetir varias veces para listar
              varios patrones a excluir.

              Por si mismo, -I anade las opciones predefinidas  <<--exclude>>,
              que  filtraran  los ficheros de control y los directorios de los
              sistemas de  control  de  versiones  mas  comunes,  ficheros  de
              respaldo   e   intercambio,  y  los  directorios  de  salida  de
              construccion de Libtool.

       Nota: A pesar de tener objetivos similares, i y I tienen una sintaxis y
       semantica  muy  diferentes.  Solo puede especificar i una vez, que toma
       una expresion regular compatible con Perl, la cual se  compara  con  la
       ruta relativa de cada fichero. Puede especificar I varias veces, y toma
       un patron de nombre de fichero con comodines de interprete de  ordenes.
       El  patron se compara con la ruta relativa, y tambien con cada parte de
       la ruta, de  manera  individual.  La  semantica  exacta  de  la  opcion
       <<--exclude>>     de     tar     es     algo    complicada,    consulte
       http://www.gnu.org/software/tar/manual/tar.html#wildcards   para    una
       completa documentacion.

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

OPCIONES DE EXTRACCI'ON GEN'ERICAS

       --no-copy
              No copia los ficheros tar originales cerca  del  paquete  fuente
              extraido.

       --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
              especificos 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 que formato de fuentes  usar,  deberia  seleccionar  o  bien
       <<3.0       (quilt)>>       o      <<3.0      (native)>>.      Consulte
       <<http://wiki.debian.org/Projects/DebSrc3.0>>  para   mas   informacion
       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 unico .tar.gz  (en  tal  caso,  el
       paquete se considera native).

       Extracci'on

       Extraer  un  paquete  nativo  es simplemente una extraccion de un unico
       archivo tar en el directorio destino. Extraer un paquete no  nativo  se
       realiza,  primero, desempaquetando el .orig.tar.gz para despues 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 automaticamente).
       El <<diff>> puede crear nuevos ficheros (todo el directorio <<debian/>>
       se  crea  de esta manera) pero no puede eliminar ficheros (los ficheros
       vacios permaneceran en el sistema).

       Construcci'on

       Construir un paquete nativo consiste de la creacion de un unico 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  comparacion  del directorio del paquete
       fuente con el directorio <<.orig>>.

       Opciones de construcci'on (con -b):

       Si hay un segundo argumento, deberia ser el nombre  del  directorio  de
       fuentes,  del  fichero tar original o la cadena vacia, si el paquete es
       especifico de Debian y por tanto carece de diffs <<debianizantes>>.  Si
       no  se proporciona un segundo argumento, dpkg-source buscara el archivo
       tar original paquete_versi'on-autor-original.orig.tar.gz o el directorio
       de fuentes original directorio.orig en funcion de los argumentos -sX.

       -sa,  -sp, -sk, -su y -sr no sobreescribiran directorios o ficheros tar
       existentes. Si esto es lo que desea, deberia utilizar  -sA,  -sP,  -sK,
       -sU y -sR en su lugar.

       -sk    Define que se espera la fuente original como un archivo tar, por
              omision  paquete_versi'on-autor-original.orig.tar.gz.  La  fuente
              original se dejara en el sitio como un fichero tar, o se copiara
              al directorio actual en caso de no estar  ya  ahi  presente.  El
              archivo   tar  se  desempaquetara  en  directorio.orig  para  la
              generacion del <<diff>>.

       -sp    Identica a -sk, a diferencia de que eliminara el  directorio  al
              finalizar.

       -su    Define  que  se espera que la fuente original sea un directorio,
              por   omision   paquete-versi'on-autor-original.orig,    y    que
              dpkg-source creara un fichero de fuentes nuevo a partir de el.

       -sr    Identica  a  -su,  a  diferencia  de que eliminara el directorio
              despues de su uso.

       -ss    Define  que  la  fuente  original  esta  disponible  tanto  como
              directorio  como un fichero tar. dpkg-source usara el directorio
              para crear el diff , pero el fichero tar  para  crear  el  .dsc.
              Debe  usar esta opcion con precaucion, ya que si el directorio y
              el archivo tar  no  coinciden  se  generara  un  archivo  fuente
              invalido.

       -sn    Omite  la  busqueda  de  la  fuente  original  y  no generara un
              <<diff>>. El segundo argumento, en caso de existir, debe ser  la
              cadena  vacia.  Esta  opcion  se  usa en paquetes especificos de
              Debian que no tienen fuentes del autor original por separado,  y
              por tanto carecen de ficheros <<diff>> <<debianizantes>>.

       -sa or -sA
              Defina una busqueda 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 vacia (equivale a usar
              -sn). Si se encuentra un fichero  tar,  se  desempaquetara  para
              crear  el  <<diff>> y eliminara posteriormente (equivale a -sp);
              si se encuentra un directorio,  se  empaquetara  para  crear  la
              fuente  original y se eliminara posteriormente (equivale a -sr);
              si no se encuentra ninguno de los dos, se asume que  el  paquete
              no  tiene  ficheros  <<diff>>  <<debianizantes>>,  unicamente un
              fichero de fuentes (equivale a -sn).  Si  se  encuentran  ambos,
              dpkg-source  ignorara  el  directorio, sobreescribiendolo, si se
              especifico -sA (equivale a -sP),  o  generara  un  error  si  se
              definio -sa. -sA es la opcion predefinida.

       --abort-on-upstream-changes
              El  procesa  dara fallo si el <<diff>> generado contiene cambios
              realizados a ficheros fuera del subdirectorio  <<debian>>.  Esta
              opcion  no  se puede usar en debian/source/options pero se puede
              usar en debian/source/local-options.

       Opciones de extracci'on (con -x):

       En todos los casos cualquier arbol de fuentes original sera eliminado.

       -sp    Si se usa en la extraccion, la fuente original (de  existir)  se
              dejara  como un fichero tar. Si no se encuentra en el directorio
              actual o si existe un fichero pero es diferente, se copiara ahi.
              ('Esta es la acci'on por omisi'on).

       -su    Desempaqueta el arbol de fuentes original.

       -sn    Asegura  que la fuente original ni se copia al directorio actual
              ni  se  desempaqueta.  Cualquier  arbol  de   fuentes   original
              existente en el directorio actual es eliminado.

       Todas  las  opciones  -sX  son mutuamente excluyentes. Si define mas de
       una, solo se usara la ultima.

       --skip-debianization
              Omite la aplicacion del <<diff>> de debian con las  fuentes  del
              autor original.

   Formato: 2.0
       Tambien  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  especificacion  de  un  formato de paquete fuente de nueva
       generacion.

       El comportamiento de este formato es  identico  al  del  formato  <<3.0
       (quilt)>>,  a  excepcion  de que no usa una lista explicita de parches.
       Todos los ficheros en debian/patches/ que coinciden  con  la  expresion
       regular de perl [\w-]+ deben ser parches validos: se aplican durante el
       proceso de extraccion.

       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  extension del formato de paquete nativo como se
       define en el formato 1.0.  Es  compatible  con  todos  los  metodos  de
       compresion,  e  ignorara  cualquier  fichero  o directorio especifico a
       sistemas de control de versiones, asi como muchos  ficheros  temporales
       (consulte  el valor predefinido asociado a la opcion -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).   Tambien  contiene  archivos   tar
       originales   adicionales  (.orig-componente.tar.ext).  componente  solo
       puede contener caracteres alfanumericos y guiones (<<->>).

       Extracci'on

       Primero se extrae el archivo tar original, y despues 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 reemplazara). El archivo tar de Debian se extrae en el
       directorio raiz del  arbol  despues  de  la  eliminacion  de  cualquier
       directorio  debian  preexistente. Tenga en cuenta que el archivo tar de
       Debian debe  contener  un  subdirectorio  debian,  pero  tambien  puede
       contener  ficheros  binarios  externos  a  ese  directorio (consulte la
       opcion --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 simbolico), este
       se  reemplazara con un enlace simbolico 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  explicitas  para
       la aplicacion del parche (guardados en cada linea despues del nombre de
       fichero del parche y uno o mas espacios), ignora aquellas opciones  que
       siempre  esperan  parches  que  se  puedan aplicar con la opcion -p1 de
       patch. De no ser asi, mostrara un aviso  en  caso  de  encontrar  tales
       opciones, y cabe que la construccion falle.

       De  forma  similar  al comportamiento predefinido de quilt, los parches
       tambien pueden eliminar ficheros.

       El fichero .pc/applied-patches se  crea  en  caso  de  aplicar  parches
       durante la extraccion.

       Construcci'on

       Todos  los archivos tar original encontrados en el directorio actual se
       extraen a  un  directorio  temporal  siguiendo  la  misma  logica  para
       desempaquetar, copiando el directorio <<debian>> al directorio temporal
       y por ultimo aplicando  todos  los  parches,  a  excepcion  del  parche
       automatico  (debian-changes-version  o  debian-changes,  dependiendo de
       --single-debian-patch).  El  directorio  temporal  se  compara  con  el
       directorio  de  fuentes  del paquete, guardando el <<diff>> (si no esta
       vacio) en el parche automatico. En caso de crear  o  anadir  el  parche
       automatica,  este  se  anade  o elimina del fichero <<series>> y de los
       metadatos de quilt.

       Cualquier cambio en un fichero binario no se puede  representar  en  un
       <<diff>>,  conduciendo  asi  a  un  fallo  a menos que el desarrollador
       decida explicitamente incluir  el  fichero  binario  modificado  en  el
       archivo      tar     <<debian>>     (mediante     su     listado     en
       debian/source/include-binaries). La  construccion  tambien  fallara  si
       encuentra ficheros binarios en el subdirectorio <<debian>>, a menos que
       esten 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  automaticamente  no incluye cambios en ficheros
       especificos al sistema de control de versiones, asi 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 creacion del parche automatico.

       Nota:  dpkg-source  espera  que  el arbol de fuentes contenga todos los
       parches listados en  el  fichero  <<series>>  aplicado  al  generar  el
       paquete fuente. Este no es el caso cuando el arbol de fuentes se obtuvo
       al desempaquetar un  paquete  fuente  usando,  por  ejemplo,  <<Format:
       1.0>>.  Para  mitigar  el  problema,  dpkg-source  aplicara los parches
       directamente si cree que estos aun no se han  aplicado.  Para  detectar
       tal  situacion,  usa  la siguiente heuristica: si encuentra la lista de
       parches supuestamente no aplicados (listados en el fichero series  pero
       no  en  .pc/applied-patches) y aplica el primer parche del conjunto sin
       problemas,  procedera  a  aplicar  el  resto.  Puede  usar  la   opcion
       --no-preparation  para  desactivar  este comportamiento. Habitualmente,
       esta operacion se realiza con la orden --prepare-build.

       Opciones de construcci'on

       --allow-version-of-quilt-db=versi'on
              Permite que  dpkg-source  construya  el  paquete  fuente  si  la
              version de los metadatos de quilt es el especificado, incluso si
              dpkg-source no lo conoce. De hecho, esto  dice  que  la  version
              dada  de  los metadatos de quilt es compatible con la version 2,
              con la que dpkg-source tiene  compatibilidad  actualmente.  Esta
              version de los metadatos de quilt se guardan en .pc/.version.

       --include-removal
              No  ignora  los  ficheros  eliminados y los incluye en el parche
              generado automaticamente.

       --include-timestamp
              Incluye la marca temporal en el parche generado automaticamente.

       --include-binaries
              Anade todos los ficheros binarios  modificados  al  archivo  tar
              <<debian>>.  Tambien los anade a debian/source/include-binaries:
              se anadiran por omision en futuras construcciones,  con  lo  que
              esta opcion ya no sera necesaria.

       --no-preparation
              No  intenta  preparar el arbol de construccion aplicando parches
              que estan 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 automaticamente durante la construccion. Esta opcion es
              particularmente  util  si  el paquete se guarda en un sistema de
              control de versiones y si no se puede  generar  un  conjunto  de
              parches  adecuados.  Al usar esta opcion, se recomienda crear un
              fichero  <<debian/source/patch-header>>,  detallando  la   mejor
              forma  de revisar los cambios de Debian, por ejemplo, el sistema
              de control de versiones en uso.

       --create-empty-orig
              Crea automaticamente el archivo tar principal  y  original  como
              vacio  en  caso  de  no  existir  y  si  hay  otros archivos tar
              originales adicionales. Esta opcion esta disenada  para  su  uso
              cuando  el  paquete fuente es un conjunto de varios programas de
              la fuente principal y cuando no hay programas <<principales>>.

       --unapply-patches
              No aplica o elimina los cambios de los parches  en  el  <<hook>>
              --after-build.  Esto  es util principalmente cuando construye su
              paquete directamente en un sistema de control de  versiones  que
              contiene  la  fuente  original  sin  parchear,  y  cuando quiere
              mantener  el  arbol  sin  parchear   incluso   despues   de   la
              construccion   del   paquete.   Habitualmente,  esta  opcion  se
              introduce  en  debian/source/local-options  (no  se  permite  en
              debian/source/options  para  que  todos  los  paquetes de fuente
              generados tengan el mismo comportamiento por omision).

       --abort-on-upstream-changes
              El proceso falla si se genera un parche automatico. Esta  opcion
              se  puede  usar para asegurar que todos los cambios se registren
              apropiadamente  en  parches  de  quilt  separados  antes  de  la
              construccion  del  paquete  fuente. Esta opcion no se permite en
              debian/source/options     pero     se     puede     usar      en
              debian/source/local-options.

       Opciones de extracci'on

       --skip-debianization
              Omite  la extraccion del archivo tar <<debian>> sobre las fuente
              del autor original.

       --skip-patches
              No aplica los parches al finalizar la extraccion.

   Formato: 3.0 (custom)
       Este formato es especial.  No  representa  ningun  formato  de  paquete
       fuente real, pero se puede usar para crear paquetes fuente con ficheros
       arbitrarios.

       Opciones de construcci'on

       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 contendra 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 solo  archivo  con
       un  repositorio  .git,  que guarda la fuente del paquete. Puede tambien
       existir  un  fichero  .gitshallow  que  lista  las  revisiones  de  una
       clonacion de git superficial (<<shallow>>).

       Extracci'on

       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  omision,  el  nuevo repositorio tendra un
       <<checkout>> de la misma rama de la que se realizo el  <<checkout>>  de
       la   fuente  original.  (Habitualmente,  <<master>>,  pero  podria  ser
       cualquier otra cosa.)  Todas las demas ramas estaran  disponibles  bajo
       <<remotes/origin/>>.

       Construcci'on

       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 omision, se incluyen en el archivo todas las ramas y etiquetas
       en el repositorio.

       Opciones de construcci'on

       --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 solo la rama
              <<master>>, use <<--git-ref=master>>.  Para  incluir  todas  las
              etiquetas  y  ramas  a excepcion 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 numero definido de revisiones.

   Format: 3.0 (bzr)
       Este  formato es experimental. Genera un unico archivo tar que contiene
       el repositorio bzr.

       Extracci'on

       El archivo tar se desempaqueta, usando despues  bzr  para  realizar  un
       <<checkout>> de la rama actual.

       Construcci'on

       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 especifico 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 asi ahorrar espacio.

AVISOS Y ERRORES

   no se defini'o ning'un formato de fuentes en <<debian/source/format>>
       El fichero debian/source/format siempre deberia existir  e  indicar  el
       formato  de fuentes deseado. Por razones de compatibilidad hacia atras,
       se supone el formato <<1.0>> cuando  el  fichero  no  existe,  pero  no
       deberia  depender  de  esto. En algun punto en el futuro, se modificara
       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 deberia escoger uno de los formatos mas recientes
       (<<3.0  (quilt)>>,  <<3.0  (native)>>).  dpkg-source   no   hara   esto
       automaticamente.  Si  desea continuar usando el formato antiguo, tendra
       que ser explicito 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  esta  usando  el  formato  de  fuentes  <<1.0>>  ya que los cambios
       terminaran ocultos y generalmente sin  documentar  dentro  del  fichero
       <<diff.gz>>.  Deberia guardar los cambios como parches en el directorio
       <<debian>> y aplicarlos en tiempo de  construccion.  Para  evitar  esta
       complejidad  tambien  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:
       solo 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  simbolico  o  directorio),  obtendra  el
       siguiente mensaje de error.

   el  fichero vac'io fichero recientemente creado no estar'a representado en el
       <<diff>>
       No se pueden crear ficheros vacios con ficheros de  parche.  Por  ello,
       este cambio no se registra en el paquete fuente, esta usted avisado.

   los  permisos  de  modo  de ejecuci'on del fichero no se representar'an en el
       <<diff>>
   los permisos de modo  especial  del  fichero  no  se  representar'an  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 unica linea el formato que se deberia usar
       para construir el paquete fuente (los formatos posibles se describen en
       un punto anterior). No se permiten espacios vacios al principio o final
       de la linea.

   debian/source/include-binaries
       Este fichero contiene una lista de ficheros binarios  (uno  por  linea)
       que  se  deberian incluir en el archivo tar <<debian>>. Se eliminan los
       espacios vacios al principio y  final  de  la  linea.  Las  lineas  que
       comienzan  con  <<#>>  son  comentarios,  y  por  tanto,  se omiten. Se
       ignoraran lineas vacias.

   debian/source/options
       Este fichero contiene una lista de  opciones  largas  que  se  deberian
       anexar  al  conjunto  de  las  opciones  de  linea  de  ordenes  de una
       invocacion a dpkg-source -b o dpkg-source --print-format. Las  opciones
       como   --compression  y  --compression-level  son  adecuadas  con  este
       fichero.

       Cada opcion deberia aparecer en una linea separada.  Se  ignoraran  las
       lineas  vacias,  y aquellas que comienzan con <<#>>. Los guiones <<-->>
       al principio de la opcion  se  deberian  eliminar,  y  no  se  permiten
       opciones  cortas.  Se permiten espacios adicionales en torno al simbolo
       <<=>>, asi como comillas dobles  en  torno  al  valor.  Aqui  tiene  un
       ejemplo de este fichero:

         #  permite  a  dpkg-source  crear  un  debian.tar.bz2  con  la maxima
       compresion
         compression = "bzip2"
         compression-level = 9
         # usa debian/patches/debian-changes como parche automatico
         single-debian-patch

       Nota: no se permiten en este fichero las opciones de formato, y deberia
       usar debian/source/format en su lugar.

   debian/source/local-options
       Identico  a  debian/source/options, a excepcion de que el fichero no se
       incluye en el paquete fuente generado. Puede ser util para guardar  una
       preferencia  ligada  al  mantenedor  a  al  repositorio  del sistema de
       control de versiones donde el paquete es mantenido.

   debian/source/patch-header
       Texto con formato libre que se inserta al inicio del parche  automatico
       con los formatos <<2.0>> o <<3.0 quilt)>>.

   debian/patches/series
       Este  fichero lista todos los parches que se deben aplicar (en el orden
       dado) al paquete fuente del autor original. Se eliminaran los  espacios
       vacios  al  principio y final de la linea. Las lineas que comienzan con
       <<#>> son comentarios, y se omiten. Las lineas restantes  empiezan  con
       un   nombre   de   fichero   de   un  parche  (relativo  al  directorio
       debian/patches/) hasta el primer caracter de espacio, o el final de  la
       linea.  Opcionalmente,  puede  insetar a continuacion opciones de quilt
       hasta el final de linea, o el primer  <<#>>  precedido  de  uno  o  mas
       espacios  (que  indican el inicio de un comentario hasta el final de la
       linea).

FALLOS

       No esta claro el punto en el cual se produce la sustitucion de  campos,
       comparado con ciertas opciones de los campos de salida estandar.

V'EASE TAMBI'EN

       dpkg-deb(1), dpkg(1), dselect(1).

AUTORES

       Copyright (C) 1995-1996 Ian Jackson
       Copyright (C) 2000 Wichert Akkerman
       Copyright (C) 2008-2010 Raphael Hertzog

       Esto  es  software  libre;  vea la version 2 o posterior de la Licencia
       Publica General GNU para condiciones de copia. NO hay ninguna garantia.

TRADUCTOR

       Rudy Godoy  <rudy@kernel-panik.org>,  Ruben  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
       Fernandez-Sanguino, Ruben Porras, Luis Uribe y Omar Campagne.