Provided by: dpkg-dev_1.16.1.2ubuntu7_all bug

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.