Provided by: dpkg_1.15.8.4ubuntu3_i386 bug

NOMBRE

       dpkg-maintscript-helper  -  Solucin  alternativa  a las limitaciones de
       dpkg en scripts de mantenedor

SINOPSIS

       dpkg-maintscript-helper         orden         [parmetros...]         --
       parmetros-script-mantenedor

RDENES Y PARMETROS

       rm_ conffile [ltima-versin [paquete]]

       mv_conffile conffile-antiguo conffile-nuevo [ltima-versin [paquete]]

DESCRIPCIN

       Este  programa  est diseado para su uso dentro de scripts de mantenedor
       para realizar tareas que dpkg no puede (por ahora) gestionar  de  forma
       nativa, bien por decisiones de diseo o limitaciones actuales.

       Muchas  de  estas  tareas  requieren  la  ejecucin coordinada de varios
       scripts de mantenedor (preinst, postinst, prerm, postrm).  Para  evitar
       errores slo tiene que insertar la misma invocacin en todos los scripts,
       y el programa adaptar automticamente su comportamiento  en  base  a  la
       variable  de  entorno  DPKG_MAINTSCRIPT_NAME  y a los argumentos de los
       scripts del mantenedor, que debe introducir despus de un guin doble.

TAREAS CON FICHEROS DE CONFIGURACIN CONFFILES

       Al actualizar un paquete, dpkg no eliminar automticamente un fichero de
       configuracin  (un  fichero  de configuracin con cambios del usuario que
       dpkg debera preservar) si no est presente en  la  versin  ms  reciente.
       Existen  dos razones principales para esto: la primera es que puede que
       el fichero de configuracin conffile haya desaparecido  accidentalmente,
       con  lo  que la siguiente versin la restaurara. Los usuarios no querran
       ver desparecer los  cambios  hechos.  La  segunda  es  permitir  a  los
       paquetes una transicin de un fichero de configuracin conffile mantenido
       por dpkg a un fichero mantenido  por  los  scripts  de  mantenedor  del
       paquete, habitualmente con una herramienta como debconf o ucf.

       Esto  significa  que  si  un  paquete  pretende renombrar o eliminar un
       fichero   de   configuracin,   debe   hacerlo   de   forma    explcita.
       dpkg-maintscript-helper  se  puede  usar para implementar con sencillez
       dentro de los scripts del mantenedor la eliminacin y el  desplazamiento
       de ficheros de configuracin conffile.

   ELIMINAR UN FICHERO DE CONFIGURACIN CONFFILE
       Si  se  elimina  un  fichero  de configuracin conffile por completo, se
       debera eliminar del disco a menos que un usuario lo haya modificado. Se
       deberan  preservar  modificaciones  locales  en  caso de existir. Si se
       cancela  la  actualizacin  del  paquete,  el  fichero  de  configuracin
       conffile declarado como obsoleto no debera desaparecer.

       Esto  se  puede integrar introduciendo el siguiente texto de consola en
       los scripts de mantenedor preinst, postinst y postrm:

           dpkg-maintscript-helper rm_conffile \
               conffile ltima-versin paquete -- "$@"

       conffile es el nombre del fichero de configuracin conffile a  eliminar.
       ltima-versin  es  la ltima versin del paquete que contena el fichero de
       configuracin conffile (o la ltima versin del paquete que no se ocup  de
       eliminar el fichero de configuracin conffile obsoleto en el caso de que
       este mtodo no se implement inmediatamente). Si ltima-versin est vaco  o
       se  omite,  se intentar la operacin en cada actualizacin. paquete es el
       nombre del paquete, su aparicin es opcional ya que el valor por  omisin
       es  $DPKG_MAINTSCRIPT_PACKAGE  (dpkg define esta variable con el nombre
       del paquete sobre el que acta). Todos los parmetros de los  scripts  de
       mantenedor se deben introducir al programa despus de --.

       Implementacin  actual:  en  el  script  preinst,  comprueba  si  se  ha
       modificado  el  fichero  de  configuracin  y  lo  renombra  bien   como
       conffile.dpkg-remove    (si    no    se    ha   modificado),   o   como
       conffile.dpkg-backup (si se ha modificado). En el script  postinst,  el
       segundo  fichero  se  renombra  a  conffile.dpkg-bak  y  se guarda como
       referencia ya que contiene modificaciones del usuario, mientras que  el
       primer script se elimina. Si se interrumpe la actualizacin del paquete,
       el  script  postrm  reinstalar  el  fichero  de  configuracin  conffile
       original. Durante el purgado, el script postrm borrar tambin el fichero
       .dpkg-bak mantenido hasta ahora.

   RENOMBRAR UN FICHERO DE CONFIGURACIN CONFFILE
       Si se ha cambiado la ubicacin de un fichero  de  configuracin  conffile
       debe  asegurarse de que tambin migra los cambios hechos por el usuario.
       Esto puede parecer en principio como un sencillo cambio  en  el  script
       preinst,  aunque resultar en un dilogo de dpkg para confirmar la edicin
       del fichero conffile incluso si no son responsables de ellos.

       Puede integrar renombrar con sencillez insertando el siguiente texto de
       consola en los scripts de mantenedor preinst, postinst y postrm.

           dpkg-maintscript-helper mv_conffile \
               conffile-antiguo conffile-nuevo ltima-versin
               paquete -- "$@"

       conffile-antiguo  y  conffile-nuevo  son  el nombre antiguo y nuevo del
       fichero de configuracin conffile a renombrar. ltima-versin es la  ltima
       versin  del paquete que contena el fichero de configuracin conffile con
       el nombre antiguo. Si ultima-versin est vaco o se omite, se ejecutar la
       operacin  en  cada  actualizacin  (nota:  es  ms seguro dar la versin y
       ejecutar la operacin una sola vez). paquete es el nombre  del  paquete,
       opcional  ya que su valor por omisin es $DPKG_MAINTSCRIPT_PACKAGE (dpkg
       define esta variable con el nombre del  paquete  sobre  el  que  acta).
       Todos los parmetros de scripts de mantenedor se deben introducir despus
       de --.

       Implementacin actual: el script preinst comprueba si se  ha  modificado
       el fichero de configuracin conffile, preservndolo en su lugar si es as,
       o renombrndolo como  conffile-antiguo.dpkg-remove  en  caso  contrario.
       Durante     la     configuracin,    el    script    postinst    elimina
       conffile-antiguo.dpkg-remove   y   renombra    conffile-antiguo    como
       conffile-nuevo  si  el primero an est disponible. Durante la cancelacin
       de  una  instalacin  o   actualizacin   el   script   postrm   renombra
       conffile-antiguo.dpkg-remove  nuevamente  como  conffile-antiguo de ser
       necesario.

INTEGRACIN EN PAQUETES

       Debido a que dpkg-maintscript-helper  se  usa  en  el  script  preinst,
       usarlo incondicionalmente precisa una pre-dependencia para asegurar que
       la versin requerida de dpkg se ha configurado en el pasado.  La  versin
       requerida  depende  de  la  orden  usada,  1.15.7.2  para rm_conffile y
       mv_conffile.

           Pre-Depends: dpkg (>= 1.15.7.2)

       An as, en muchos casos la operacin efectuada  por  el  programa  no  es
       crtica  para  el  paquete,  y en lugar de usar un pre-dependencia puede
       invocar el programa slo si sabemos que la orden requerida es compatible
       con la versin de dpkg actualmente instalada:

           if dpkg-maintscript-helper supports <command>; then
               dpkg-maintscript-helper <command> ...
           fi

AUTORES

       Copyright (C) 2010 Raphael Hertzog
       Copyright (C) 2008 Joey Hess
       Copyright (C) 2007 Guillem Jover
       Copyright (C) 2005 Scott James Remnant

       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.