Provided by: dpkg-dev_1.16.1.2ubuntu7_all bug

NOMBRE

       deb-substvars - Sustitución de variables de fuentes de Debian

SINOPSIS

       substvars

DESCRIPCIÓN

       Antes de que dpkg-source, dpkg-gencontrol y dpkg-genchanges escriban su
       información de control (al fichero  .dsc  de  control  en  el  caso  de
       dpkg-source,  y  a  la  salida  estándar  en  el  de  dpkg-gencontrol y
       dpkg-genchanges), realizan algunas sustituciones  de  variables  en  el
       fichero de salida.

       Una  sustitución  de variable tiene la forma ${nombre-de-variable}. Los
       nombres de variable consisten de caracteres  alfanuméricos,  guiones  y
       dos  puntos  (:),  y comienzan siempre con un carácter alfanumérico. La
       sustitución de variables se lleva a cabo  repetidamente  hasta  que  no
       queda  ninguna;  el  texto  completo  del  campo tras la sustitución se
       revisa de nuevo en busca de más sustituciones.

       Después de  que  todas  las  sustituciones  hayan  tenido  lugar,  cada
       aparición  de  la  cadena  ${}  (que  no  es  una sustitución legal) se
       reemplaza por un signo $.

       A pesar de que la sustitución de variables se realiza sobre  todos  los
       campos,  algunos  de  estos  campos se usan obligatoriamente durante la
       construcción, cuando la sustitución aún no se ha ejecutado.  Por  ello,
       no puede usar variables en los campos Package, Source y Architecture.

       La sustitución de variables se ejecuta sobre el contenido de los campos
       después de su análisis, y por  ello  no  necesita  incluir  un  espacio
       después  de  la  nueva  línea  para  expandir una variable sobre varias
       líneas. Esto se hace implícitamente cuando el campo se muestra  por  la
       salida.  Por  ejemplo, si la variable ${Description} está definida como
       «foo es bar.${Newline}foo es increíble.» y tiene el siguiente campo:

        Description: aplicación foo
         ${Description}
         .
         Más texto.

       El resultado sería:

        Description: aplicación foo
         foo es bar.
         foo es increíble.
         .
         Más texto.

       Las variables se pueden definir usando la opción común -V.  También  se
       pueden  especificar  en  el  fichero  debian/substvars  (u otro fichero
       especificado mediante la opción -T). Este fichero  consiste  de  líneas
       con  la  forma  nombre=valor. Los caracteres en blanco al final de cada
       línea, las líneas vacías y las líneas que comiencen con  el  símbolo  #
       (comentarios) son ignorados.

       De   manera   adicional,   las   siguientes  variables  estándar  están
       disponibles:

       Arch   La   arquitectura    de    construcción    actual    (de    dpkg
              --print-architecture).

       source:Version
              La versión del paquete fuente.

       source:Upstream-Version
              La versión del paquete del autor original, incluyendo la versión
              «epoch» de Debian, de existir.

       binary:Version
              La  versión  del  paquete  binario  (puede   ser   distinto   de
              «source:Version», por ejemplo, con un NMU binario).

       Source-Version
              La  versión  del  paquete  fuente  (del  fichero  de registro de
              cambios). Esta variable está obsoleta,  ya  que  su  significado
              difiere de su función. Use source:Version o binary:Version según
              requiera la ocasión.

       Installed-Size
              El tamaño 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
              está  definida,  dpkg-gencontrol  usará  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 añade 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   convención   de   mayúsculas   y
              minúsculas). Definir estas  variables  no  tiene  ningún  efecto
              excepto en aquellos lugares donde se expandan explícitamente.

       Format El formato del fichero .changes generado por esta versión de los
              scripts de empaquetado de fuentes. Si define esta  variable,  el
              contenido  del  campo  Format  en  el  fichero .changes cambiará
              igualmente.

       Newline, Space, Tab
              Estas variables contienen  cada  una  el  carácter  cuyo  nombre
              especifican  en inglés. Nota del traductor: Newline = Retorno de
              línea, Space = Espacio, Tab = Tabulador.

       shlibs:campo-de-dependencia
              Las variables con nombres de  esta  forma  se  generan  mediante
              dpkg-shlibdeps.

       dpkg:Upstream-Version
              La versión de la fuente original de dpkg.

       dpkg:Version
              La versión completa de dpkg.

       Si  se  hace  referencia  a una variable pero no se define se genera un
       aviso y se asume un valor vacío.

FICHEROS

       debian/substvars
              Lista de variables a sustituir y valores.

FALLOS

       No está claro el punto en el cual se produce la sustitución de  campos,
       comparado con ciertas opciones de los campos de salida estándar.

VÉASE TAMBIÉN

       dpkg(1),   dpkg-genchanges(1),  dpkg-gencontrol(1),  dpkg-shlibdeps(1),
       dpkg-source(1).

AUTOR

       Copyright © 1995-1996 Ian Jackson
       Copyright © 2000 Wichert Akkerman

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

TRADUCTOR

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