Provided by: dpkg-dev_1.15.8.4ubuntu3_all bug

NOMBRE

       dpkg-source - Herramienta de manipulacin de paquetes fuente de Debian

SINOPSIS

       dpkg-source [opciones] orden

DESCRIPCIN

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

       Ninguna de estas rdenes permite combinar mltiples opciones en una sola.
       Tampoco permiten que el  valor  de  una  opcin  se  especifique  en  un
       argumento separado.

RDENES

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

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

              Los  permisos y propietarios de los ficheros del paquete extrado
              sern los mismos que se esperaran si  los  ficheros  se  hubiesen
              simplemente  creado - 0777 para directorios y ejecutables y 0666
              para el resto de ficheros, ambos modificados segn el  umask  del
              extractor.  Si  el  directorio  superior  tiene  activado el bit
              setgid, los directorios extrados lo tendrn tambin, y  todos  los
              ficheros y directorios heredarn el grupo al que pertenece.

              Si  el  paquete  fuente  usa un formato no estndar (a da de hoy,
              todos  los  formatos  menos  1.0),  su  nombre  se  guardar   en
              debian/source/format  para que las siguientes construcciones del
              paquete fuente usen el mismo formato por omisin.

       -b directorio [parmetros-especficos-formato]
              Construye un paquete fuente. El primer argumento, que no  opcin,
              se  toma  como  el nombre del directorio que contiene el rbol de
              fuentes debianizado (por ejemplo, con un subdirectorio  debian/,
              y   puede   que  cambios  en  los  ficheros  originales).  Puede
              especificar parmetros adicionales, dependiendo  del  formato  de
              paquete fuente usado en la construccin del paquete.

              dpkg-source  construir  el  paquete fuente con el primer formato
              posible de esta lista, y en este orden: el formato indicados con
              la  opcin  de  lnea  de  rdenes --format, el formato indicado en
              debian/source/format, 1.0. El uso predefinido de 1.0 en ausencia
              de  otro  valor est obsoleto y se eliminar en el futuro. Siempre
              debera    documentar    el    formato    fuente    deseado    en
              debian/source/format.  Consulte  la  seccin  FORMATOS DE PAQUETE
              FUENTE para una extensa descripcin de los diferentes formatos de
              paquete fuente.

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

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

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

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

       --version
              Muestra la versin y termina.

OPCIONES GENRICAS DE CONSTRUCCIN

       -cfichero-control
              Define  el  fichero  de control principal de las fuentes del que
              leer la informacin, debian/control por omisin. Si se  introducen
              rutas  relativas, stas se interpretan empezando en el directorio
              superior del rbol de fuentes.

       -lfichero-cambios
              Define el fichero  de  registro  de  cambios  del  que  leer  la
              informacin,  debian/changelog por omisin. Si se introducen rutas
              relativas,  stas  se  interpretan  empezando  en  el  directorio
              superior del rbol de fuentes.

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

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

       -Vnombre=valor
              Define  una  variable  de  sustitucin  de  la  salida.  Consulte
              deb-substvars(5) para ms informacin acerca de la  sustitucin  de
              la salida.

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

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

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

       -Zcompression, --compression=compresin
              Define  qu compresin usar con los ficheros creados (archivos tar
              y ficheros diff). Tenga en cuenta que esta opcin no provoca  que
              los  archivos tar existentes se compriman nuevamente, slo afecta
              a los ficheros nuevos. Los valores permitidos son: gzip,  bzip2,
              lzma  y  xz. gzip se usa por omisin. La compatibilidad con xz es
              posible desde dpkg-dev 1.15.5.

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

       -i[expresin-regular], --diff-ignore[=expresin-regular]
              Puede especificar una expresin  regular  de  Perl  para  indicar
              aquellos ficheros que desee excluir de la lista de ficheros para
              el diff (esta lista se genera con una orden  find).  Puede  usar
              esto   para   ignorar   cambios   no  introducidos  en  ficheros
              especficos, en caso de  construir  un  paquete  fuente  como  un
              paquete  fuente  versin  3 usando VCS. Por s mismo, -i activa la
              opcin con una  expresin  regular  predefinida  que  elimina  los
              ficheros  y directorios de control de los sistemas de control de
              versiones ms comunes, los ficheros de respaldo, los ficheros  de
              intercambio  y  los directorios que se generan como resultado de
              las operaciones de Libtool. Slo puede haber una expresin regular
              activa,  y en caso de existir varias opciones -i slo se tendr en
              cuenta la ltima.

              Esto es til para eliminar ficheros externos que se  incluyen  en
              el  diff.  Por  ejemplo, si desarrolla su software en sistema de
              control de versiones y desea realizar un checkout para construir
              un  paquete  fuente,  sin  incluir  los  ficheros  y directorios
              adicionales  que  habitualmente  contiene  (por  ejemplo,  CVS/,
              .cvsignore,  .svn).  La expresin regular predefinida es bastante
              completa, pero si necesita reemplazarla, tenga en cuenta que por
              omisin,  puede  coincidir  con  cualquier  parte de la ruta. Por
              ello, si desea emparejar el principio de un nombre de fichero, o
              slo   nombres   de   fichero  completos,  tendr  que  introducir
              directamente  el  anclaje  necesario  (por   ejemplo,   '(^|/)',
              '($|/)').

       --extend-diff-ignore=expresin-regular
              La  expresin  regular  de  perl  definida  extender  la expresin
              regular predefinida asociada a -i,  concatenando  |regexp  a  la
              expresin  regular predefinida. Es conveniente usar esta opcin en
              debian/source/options para excluir  algunos  ficheros  generados
              automticamente a partir de la generacin automtica de parches.

       -I[patrn-fichero], --tar-ignore[=patrn-fichero]
              Si  se especifica esta opcin, el nombre de fichero se pasar como
              parmetro a la opcin --exclude de tar(1) al  generar  el  fichero
              .orig.tar o genere el fichero .tar.gz. La opcin se puede repetir
              varias veces para listar varios patrones a excluir.

              Por si mismo, -I aade las opciones predefinidas  --exclude,  que
              filtrarn  los  ficheros  de  control  y  los  directorios de los
              sistemas  de  control  de  versiones  ms  comunes,  ficheros  de
              respaldo   e   intercambio,  y  los  directorios  de  salida  de
              construccin de Libtool.

       Nota: A pesar de tener objetivos similares, i y I tienen una sintaxis y
       semntica  muy diferentes. Slo puede especificar i una vez, que toma una
       expresin regular compatible con Perl, la cual se compara  con  la  ruta
       relativa  de  cada fichero. Puede especificar I varias veces, y toma un
       patrn de nombre de fichero con comodines de  intrprete  de  rdenes.  El
       patrn  se  compara  con la ruta relativa, y tambin con cada parte de la
       ruta, de manera individual. La semntica exacta de la opcin --exclude de
       tar           es           algo           complicada,          consulte
       http://www.gnu.org/software/tar/manual/tar.html#wildcards   para    una
       completa documentacin.

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

OPCIONES DE EXTRACCIN GENRICAS

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

       --no-check
              No  revisa las firmas y sumas de control antes de desempaquetar.

       --require-valid-signature
              Rechaza desempaquetar el paquete fuente si no contiene una firma
              OpenPGP,  que  se  verifica  o  bien  con el anillo de claves de
              usuario trustedkeys.gpg, uno de los anillos de claves especficos
              del  proveedor,  o  uno  de  los  anillos de claves oficiales de
              Debian,         /usr/share/keyrings/debian-keyring.gpg         y
              /usr/share/keyrings/debian-maintainers.gpg.

FORMATOS DE PAQUETE FUENTE

       Si  no  sabe  qu formato de fuentes usar, debera seleccionar o bien 3.0
       (quilt)          o           3.0           (native).           Consulte
       http://wiki.debian.org/Projects/DebSrc3.0 para ms informacin acerca del
       desarrollo de estos formatos dentro del proyecto Debian.

   Formato: 1.0
       Un paquete fuente en este formato  consiste  bien  de  un  .orig.tar.gz
       asociado  a  un  .diff.gz,  o  bien de un nico .tar.gz (en tal caso, el
       paquete se considera native).

       Extraccin

       Extraer un paquete nativo es  simplemente  una  extraccin  de  un  nico
       archivo  tar  en el directorio destino. Extraer un paquete no nativo se
       realiza, primero, desempaquetando el .orig.tar.gz para  despus  aplicar
       el  parche contenido en el fichero .diff.gz. La marca temporal de todos
       los ficheros parcheados se modifica en el momento de extraer el paquete
       fuente (esto evita bifurcaciones de las marcas temporales, que conducen
       a problemas cuando se parchean los ficheros generados  automticamente).
       El diff puede crear nuevos ficheros (todo el directorio debian/ se crea
       de esta manera) pero no puede eliminar  ficheros  (los  ficheros  vacos
       permanecern en el sistema).

       Construccin

       Construir  un  paquete nativo consiste de la creacin de un nico archivo
       tar con el directorio fuente. Construir un paquete  no  nativo  incluye
       extraer  el  archivo tar original en otro directorio .orig, regenerando
       el .diff.gz por comparacin del directorio del  paquete  fuente  con  el
       directorio

       Opciones de construccin (con -b):

       Si  hay  un  segundo  argumento, debera ser el nombre del directorio de
       fuentes, del fichero tar original o la cadena vaca, si  el  paquete  es
       especfico de Debian y por tanto carece de diffs debianizantes. Si no se
       proporciona un segundo argumento, dpkg-source  buscar  el  archivo  tar
       original  paquete_versin-autor-original.orig.tar.gz  o el directorio de
       fuentes original directorio.orig en funcin de los argumentos -sX.

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

       -sk    Define que se espera la fuente original como un archivo tar, por
              omisin   paquete_versin-autor-original.orig.tar.gz.   La  fuente
              original se dejar en el sitio como un fichero tar, o  se  copiar
              al  directorio  actual  en  caso  de no estar ya ah presente. El
              archivo  tar  se  desempaquetar  en  directorio.orig   para   la
              generacin del diff.

       -sp    Idntica  a  -sk,  a  diferencia de que eliminar el directorio al
              finalizar.

       -su    Define que se espera que la fuente original sea  un  directorio,
              por omisin paquete-versin-autor-original.orig, y que dpkg-source
              crear un fichero de fuentes nuevo a partir de l.

       -sr    Idntica a -su, a diferencia de que eliminar el directorio despus
              de su uso.

       -ss    Define   que  la  fuente  original  est  disponible  tanto  como
              directorio como un fichero tar. dpkg-source usar  el  directorio
              para  crear  el  diff  , pero el fichero tar para crear el .dsc.
              Debe usar esta opcin con precaucin, ya que si el directorio y el
              archivo tar no coinciden se generar un archivo fuente invlido.

       -sn    Omite  la bsqueda de la fuente original y no generar un diff. El
              segundo argumento, en caso de existir, debe ser la cadena  vaca.
              Esta opcin se usa en paquetes especficos de Debian que no tienen
              fuentes del autor original por separado, y por tanto carecen  de
              ficheros diff debianizantes.

       -sa or -sA
              Defina  una bsqueda de la fuente original como directorio o como
              archivo tar -  el  segundo  argumento,  de  existir,  puede  ser
              cualquiera  de  las  dos cosas o la cadena vaca (equivale a usar
              -sn). Si se encuentra un  fichero  tar,  se  desempaquetar  para
              crear  el diff y eliminar posteriormente (equivale a -sp); si se
              encuentra un directorio, se  empaquetar  para  crear  la  fuente
              original y se eliminar posteriormente (equivale a -sr); si no se
              encuentra ninguno de los dos, se asume que el paquete  no  tiene
              ficheros  diff  debianizantes,  nicamente  un fichero de fuentes
              (equivale a -sn). Si se encuentran ambos, dpkg-source ignorar el
              directorio,  sobreescribindolo,  si se especific -sA (equivale a
              -sP), o generar un error si se  defini  -sa.  -sA  es  la  opcin
              predefinida.

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

       Opciones de extraccin (con -x):

       En todos los casos cualquier rbol de fuentes original ser eliminado.

       -sp    Si se usa en la extraccin, la fuente original  (de  existir)  se
              dejar  como  un fichero tar. Si no se encuentra en el directorio
              actual o si existe un fichero pero es diferente, se  copiar  ah.
              (sta es la accin por omisin).

       -su    Desempaqueta el rbol de fuentes original.

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

       Todas las opciones -sX son mutuamente excluyentes. Si define ms de una,
       slo se usar la ltima.

       --skip-debianization
              Omite la aplicacin del diff de debian con las fuentes del  autor
              original.

   Formato: 2.0
       Tambin conocido como wig&pen. No se recomienda este formato para un uso
       masivo, ya que el formato 3.0 (quilt)  lo  reemplaza.  Wig&pen  fue  la
       primera  especificacin  de  un  formato  de  paquete  fuente  de  nueva
       generacin.

       El comportamiento de  este  formato  es  idntico  al  del  formato  3.0
       (quilt),  a excepcin de que no usa una lista explcita de parches. Todos
       los ficheros en debian/patches/ que coinciden con la  expresin  regular
       de  perl [\w-]+ deben ser parches vlidos: se aplican durante el proceso
       de extraccin.

       Al construir un nuevo  paquete  fuente,  todo  cambio  en  las  fuentes
       original se guardan en un parche llamado zz_debian-diff-auto.

   Formato: 3.0 (nativo)
       Este  formato  es  una  extensin  del formato de paquete nativo como se
       define en el formato  1.0.  Es  compatible  con  todos  los  mtodos  de
       compresin,  e  ignorar  cualquier  fichero  o  directorio  especfico  a
       sistemas de control de versiones, as como  muchos  ficheros  temporales
       (consulte  el  valor predefinido asociado a la opcin -I en la salida de
       --help).

   Format: 3.0 (quilt)
       Un paquete fuente con este formato contiene al  menos  un  archivo  tar
       original  (.orig.tar.ext,  siendo  ext gz, bz2, lzma o xz) y un archivo
       tar  de  Debian  (.debian.tar.ext).   Tambin  contiene   archivos   tar
       originales adicionales (.orig-componente.tar.ext). componente slo puede
       contener caracteres alfanumricos y guiones (-).

       Extraccin

       Primero se extrae el archivo tar original, y despus  se  extraen  todos
       los  archivos tar originales en subdirectorios nombrados a partir de la
       parte  de  componente  de  su  nombre  de  fichero   (todo   directorio
       preexistente  se  reemplazar). El archivo tar de Debian se extrae en el
       directorio raz del rbol despus de la eliminacin de cualquier directorio
       debian  preexistente. Tenga en cuenta que el archivo tar de Debian debe
       contener un subdirectorio debian, pero tambin puede  contener  ficheros
       binarios    externos    a    ese    directorio   (consulte   la   opcin
       --include-binaries).

       En  este  momento  se   aplican   todos   los   parches   listados   en
       debian/patches/debian.series  o  debian/patches/series.  Si  el  primer
       fichero se usa, y el segundo no existe (o es un enlace  simblico),  ste
       se reemplazar con un enlace simblico al primero. El objetivo de esto es
       simplificar el uso de quilt al gestionar el  conjunto  de  parches.  No
       obstante,   tenga  en  cuenta  que  mientras  que  dpkg-source  analiza
       correctamente los ficheros en series con  opciones  explcitas  para  la
       aplicacin  del  parche  (guardados  en  cada  lnea despus del nombre de
       fichero del parche y uno o ms espacios), ignora aquellas  opciones  que
       siempre  esperan  parches  que  se  puedan  aplicar con la opcin -p1 de
       patch. De no ser as, mostrar  un  aviso  en  caso  de  encontrar  tales
       opciones, y cabe que la construccin falle.

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

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

       Construccin

       Todos  los archivos tar original encontrados en el directorio actual se
       extraen  a  un  directorio  temporal  siguiendo  la  misma  lgica  para
       desempaquetar,  copiando  el directorio debian al directorio temporal y
       por ltimo aplicando todos los parches, a excepcin del parche  automtico
       (debian-changes-version     o     debian-changes,     dependiendo    de
       --single-debian-patch).  El  directorio  temporal  se  compara  con  el
       directorio  de  fuentes del paquete, guardando el diff (si no est vaco)
       en el parche automtico. En caso de crear o aadir el  parche  automtica,
       este  se aade o elimina del fichero series y de los metadatos de quilt.

       Cualquier cambio en un fichero binario no se puede  representar  en  un
       diff,  conduciendo  as  a  un fallo a menos que el desarrollador decida
       explcitamente incluir el fichero binario modificado en el  archivo  tar
       debian  (mediante  su  listado  en  debian/source/include-binaries). La
       construccin  tambin  fallar  si  encuentra  ficheros  binarios  en   el
       subdirectorio   debian,   a   menos   que   estn  en  el  whitelist  de
       debian/source/include-binaries.

       Llegado a este punto se  genera  el  archivo  tar  debian  en  base  al
       directorio debian modificado y la lista de binarios modificados.

       El   diff  generado  automticamente  no  incluye  cambios  en  ficheros
       especficos al sistema de control de versiones,  as  como  muchos  otros
       ficheros  temporales (consulte el valor predefinido asociado a -i en la
       salida de --help). En particular, se ignora el directorio .pc  empleado
       por quilt durante la creacin del parche automtico.

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

       Opciones de construccin

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

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

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

       --include-binaries
              Aade  todos  los  ficheros  binarios  modificados al archivo tar
              debian. Tambin los  aade  a  debian/source/include-binaries:  se
              aadirn  por  omisin  en  futuras construcciones, con lo que esta
              opcin ya no ser necesaria.

       --no-preparation
              No intenta preparar el rbol de construccin aplicando parches que
              estn supuestamente sin aplicar.

       --single-debian-patch
              Usa      debian/patches/debian-changes      en      lugar     de
              debian/patches/debian-changes-version para el nombre del  parche
              generado  automticamente  durante  la construccin. Esta opcin es
              particularmente til si el paquete se guarda  en  un  sistema  de
              control  de  versiones  y  si no se puede generar un conjunto de
              parches adecuados. Al usar esta opcin, se  recomienda  crear  un
              fichero debian/source/patch-header, detallando la mejor forma de
              revisar los cambios  de  Debian,  por  ejemplo,  el  sistema  de
              control de versiones en uso.

       --create-empty-orig
              Crea  automticamente  el  archivo  tar principal y original como
              vaco en  caso  de  no  existir  y  si  hay  otros  archivos  tar
              originales  adicionales.  Esta  opcin  est  diseada  para su uso
              cuando el paquete fuente es un conjunto de varios  programas  de
              la fuente principal y cuando no hay programas principales.

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

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

       Opciones de extraccin

       --skip-debianization
              Omite la extraccin del archivo tar debian sobre las  fuente  del
              autor original.

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

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

       Opciones de construccin

       Todos  los  argumentos  que  no  son  opciones se toman como ficheros a
       integrar en el paquete fuente generado. Deben existir, a ser posible en
       el directorio actual. Debe introducir al menos un fichero.

       --target-format=valor
              Obligatorio. Define el formato real del paquete fuente generado.
              El fichero .dsc generado contendr este valor en su campo  Format
              y no 3.0 (custom).

   Format: 3.0 (git)
       This  format  is  experimental. It uses a bundle of a git repository to
       hold the source of a package.

       Extraccin

       The bundle is cloned to a new git repository.

       Note that by default the new  repository  will  have  the  same  branch
       checked  out  that  was  checked out in the original source. (Typically
       "master", but it  could  be  anything.)  Any  other  branches  will  be
       available, under as `remotes/origin/`

       Construccin

       Antes de continuar, se realizan algunas revisiones para asegurar que no
       queden cambios no ignorados a remitir al repositorio mediante commit.

       git-bundle(1) is used to generate a bundle of the git  repository.   By
       default,  all  branches  and tags in the repository are included in the
       bundle.

       Opciones de construccin

       --git-ref=ref
              Allows specifying a git ref to include in the  git  bundle.  Use
              disables  the  default  behavior  of  including all branches and
              tags. May be specified multiple times. The ref can be  the  name
              of a branch or tag to include. It may also be any parameter that
              can be passed to git-rev-list(1). For example, to  include  only
              the master branch, use --git-ref=master. To include all tags and
              branches, except for the  private  branch,  use  --git-ref=--all
              --git-ref=^private

       --git-depth=number
              Creates  a  shallow  clone  with  a  history  truncated  to  the
              specified number of revisions.

   Format: 3.0 (bzr)
       This format is experimental. It generates a single  tarball  containing
       the bzr repository.

       Extraccin

       The  tarball  is  unpacked and then bzr is used to checkout the current
       branch.

       Construccin

       Antes de continuar, se realizan algunas revisiones para asegurar que no
       queden cambios no ignorados a remitir al repositorio mediante commit.

       Entones,  la  parte  del  directorio de fuentes especfico al sistema de
       control de versiones se  copia  a  un  directorio  temporal.  Antes  de
       empaquetar  este  directorio  temporal  en  una archivo tar se realizan
       varios procesos de limpieza, para as ahorrar espacio.

AVISOS Y ERRORES

   no se defini ningn formato de fuentes en debian/source/format
       El fichero debian/source/format siempre debera  existir  e  indicar  el
       formato  de  fuentes deseado. Por razones de compatibilidad hacia atrs,
       se supone el formato 1.0 cuando el fichero no existe,  pero  no  debera
       depender  de  esto.  En algn punto en el futuro, se modificar dpkg para
       que falle cuando no encuentre ese fichero.

       El fundamente es que el formato 1.0 ya no es  el  formato  recomendado,
       sino  que debera escoger uno de los formatos ms recientes (3.0 (quilt),
       3.0  (native)).  dpkg-source  no  har  esto  automticamente.  Si  desea
       continuar  usando el formato antiguo, tendr que ser explcito e insertar
       1.0 en debian/source/format.

   el diff modifica los siguientes ficheros de la fuente original
       Generalmente, es una mala idea modificar ficheros de la fuente original
       si  est  usando  el formato de fuentes 1.0 ya que los cambios terminarn
       ocultos y generalmente  sin  documentar  dentro  del  fichero  diff.gz.
       Debera  guardar  los  cambios  como  parches  en el directorio debian y
       aplicarlos en tiempo  de  construccin.  Para  evitar  esta  complejidad
       tambin  puede  usar  el  formato  3.0 (quilt), que ofrece esto de forma
       nativa.

   no se pueden representar los cambios al fichero
       Los cambios a las fuentes originales se suelen guardar el  ficheros  de
       parche,  pero  no  todos los cambios se pueden representar con parches:
       slo pueden alterar el contenido de ficheros de texto simple. Si intenta
       reemplazar  un  fichero  con algo de otro tipo (por ejemplo, un fichero
       simple con un enlace  simblico  o  directorio),  obtendr  el  siguiente
       mensaje de error.

   el  fichero  vaco  fichero recientemente creado no estar representado en el
       diff
       No se pueden crear ficheros vacos con ficheros  de  parche.  Por  ello,
       este cambio no se registra en el paquete fuente, est usted avisado.

   los permisos de modo de ejecucin del fichero no se representarn en el diff
   los permisos de modo especial del fichero no se representarn en el diff
       Los  ficheros  de  parche  no registran permisos de los ficheros, y por
       ello los permisos modificados no se guardan en el paquete fuente.  Este
       aviso le sirve de recordatorio.

FORMATOS DE FICHERO

   debian/source/format
       Este  fichero  contiene  en una nica lnea el formato que se debera usar
       para construir el paquete fuente (los formatos posibles se describen en
       un  punto anterior). No se permiten espacios vacos al principio o final
       de la lnea.

   debian/source/include-binaries
       Este fichero contiene una lista de ficheros binarios (uno por lnea) que
       se  deberan  incluir en el archivo tar debian. Se eliminan los espacios
       vacos al principio y final de la lnea. Las lneas que  comienzan  con  #
       son comentarios, y por tanto, se omiten. Se ignorarn lneas vacas.

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

       Cada opcin debera aparecer en una lnea separada. Se ignorarn las  lneas
       vacas,  y  aquellas que comienzan con #. Los guiones -- al principio de
       la opcin se deberan eliminar, y no  se  permiten  opciones  cortas.  Se
       permiten  espacios  adicionales  en torno al smbolo =, as como comillas
       dobles en torno al valor. Aqu tiene un ejemplo de este fichero:

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

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

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

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

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

FALLOS

       No est claro el punto en el cual se produce la  sustitucin  de  campos,
       comparado con ciertas opciones de los campos de salida estndar.

VASE TAMBIN

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

AUTORES

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

       Esto  es  software  libre;  vea  la versin 2 o posterior de la Licencia
       Pblica General GNU para condiciones de copia. NO hay ninguna garanta.

TRADUCTOR

       Rudy  Godoy  <rudy@kernel-panik.org>,  Rubn  Porras  <nahoo@inicia.es>,
       Bruno    Barrera    C.   <bruno.barrera@igloo.cl>,   Carlos   Izquierdo
       <gheesh@ertis.net>,  Esteban  Manchado  y  NOK.   Debian  L10n  Spanish
       <debian-l10n-spanish@lists.debian.org>.
       Revisiones     por     Santiago    Vila    <sanvila@unex.es>,    Javier
       Fernndez-Sanguino, Rubn Porras, Luis Uribe y Omar Campagne.