Provided by:
dpkg-dev_1.16.1.2ubuntu7_all 
NOMBRE
deb-substvars - Sustitucion de variables de fuentes de Debian
SINOPSIS
substvars
DESCRIPCI'ON
Antes de que dpkg-source, dpkg-gencontrol y dpkg-genchanges escriban su
informacion de control (al fichero .dsc de control en el caso de
dpkg-source, y a la salida estandar en el de dpkg-gencontrol y
dpkg-genchanges), realizan algunas sustituciones de variables en el
fichero de salida.
Una sustitucion de variable tiene la forma ${nombre-de-variable}. Los
nombres de variable consisten de caracteres alfanumericos, guiones y
dos puntos (:), y comienzan siempre con un caracter alfanumerico. La
sustitucion de variables se lleva a cabo repetidamente hasta que no
queda ninguna; el texto completo del campo tras la sustitucion se
revisa de nuevo en busca de mas sustituciones.
Despues de que todas las sustituciones hayan tenido lugar, cada
aparicion de la cadena ${} (que no es una sustitucion legal) se
reemplaza por un signo $.
A pesar de que la sustitucion de variables se realiza sobre todos los
campos, algunos de estos campos se usan obligatoriamente durante la
construccion, cuando la sustitucion aun no se ha ejecutado. Por ello,
no puede usar variables en los campos Package, Source y Architecture.
La sustitucion de variables se ejecuta sobre el contenido de los campos
despues de su analisis, y por ello no necesita incluir un espacio
despues de la nueva linea para expandir una variable sobre varias
lineas. Esto se hace implicitamente cuando el campo se muestra por la
salida. Por ejemplo, si la variable ${Description} esta definida como
<<foo es bar.${Newline}foo es increible.>> y tiene el siguiente campo:
Description: aplicacion foo
${Description}
.
Mas texto.
El resultado seria:
Description: aplicacion foo
foo es bar.
foo es increible.
.
Mas texto.
Las variables se pueden definir usando la opcion comun -V. Tambien se
pueden especificar en el fichero debian/substvars (u otro fichero
especificado mediante la opcion -T). Este fichero consiste de lineas
con la forma nombre=valor. Los caracteres en blanco al final de cada
linea, las lineas vacias y las lineas que comiencen con el simbolo #
(comentarios) son ignorados.
De manera adicional, las siguientes variables estandar estan
disponibles:
Arch La arquitectura de construccion actual (de dpkg
--print-architecture).
source:Version
La version del paquete fuente.
source:Upstream-Version
La version del paquete del autor original, incluyendo la version
<<epoch>> de Debian, de existir.
binary:Version
La version del paquete binario (puede ser distinto de
<<source:Version>>, por ejemplo, con un NMU binario).
Source-Version
La version del paquete fuente (del fichero de registro de
cambios). Esta variable esta obsoleta, ya que su significado
difiere de su funcion. Use source:Version o binary:Version segun
requiera la ocasion.
Installed-Size
El tamano total de los ficheros del paquete ya instalado. Este
valor se copia al campo del fichero de control correspondiente;
definirlo modifica el valor de dicho campo. Si la variable no
esta definida, dpkg-gencontrol usara du -k debian/tmp para
hallar el valor predefinido.
Extra-Size
El espacio en disco adicional usado cuando se instala el
paquete. Si se define esta variable, su valor se anade al de la
variable Installed-Size (tanto si se establece manualmente como
si se usa el valor predefinido) antes de copiarse al campo
Installed-Size del fichero de control.
F:nombre-campo
El valor de la salida del campo nombre-campo (que se debe
proporcionar siguiendo la convencion de mayusculas y
minusculas). Definir estas variables no tiene ningun efecto
excepto en aquellos lugares donde se expandan explicitamente.
Format El formato del fichero .changes generado por esta version de los
scripts de empaquetado de fuentes. Si define esta variable, el
contenido del campo Format en el fichero .changes cambiara
igualmente.
Newline, Space, Tab
Estas variables contienen cada una el caracter cuyo nombre
especifican en ingles. Nota del traductor: Newline = Retorno de
linea, Space = Espacio, Tab = Tabulador.
shlibs:campo-de-dependencia
Las variables con nombres de esta forma se generan mediante
dpkg-shlibdeps.
dpkg:Upstream-Version
La version de la fuente original de dpkg.
dpkg:Version
La version completa de dpkg.
Si se hace referencia a una variable pero no se define se genera un
aviso y se asume un valor vacio.
FICHEROS
debian/substvars
Lista de variables a sustituir y valores.
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(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1),
dpkg-source(1).
AUTOR
Copyright (C) 1995-1996 Ian Jackson
Copyright (C) 2000 Wichert Akkerman
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.