Provided by:
dpkg-dev_1.16.0.3ubuntu5_all 
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.