Provided by: dpkg_1.16.1.2ubuntu7_i386 bug

NOMBRE

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

SINOPSIS

       dpkg-maintscript-helper        command        [parameter...]         --
       maint-script-parameter...

'ORDENES Y PAR'AMETROS

       rm_ conffile ['ultima-versi'on [paquete]]

       mv_conffile conffile-antiguo conffile-nuevo ['ultima-versi'on [paquete]]

DESCRIPCI'ON

       Este programa esta disenado 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 diseno o limitaciones actuales.

       Many of those tasks require coordinated actions from several maintainer
       scripts (preinst, postinst, prerm, postrm). To avoid mistakes the  same
       call  simply  needs  to  be  put  in  all  scripts and the program will
       automatically adapt its behaviour based  on  the  environment  variable
       DPKG_MAINTSCRIPT_NAME  and on the maintainer scripts arguments that you
       have to forward after a double dash.

TAREAS CON FICHEROS DE CONFIGURACI'ON <<CONFFILES>>

       Al actualizar un paquete, dpkg no eliminara automaticamente un  fichero
       de  configuracion  (un fichero de configuracion con cambios del usuario
       que dpkg deberia preservar) si no  esta  presente  en  la  version  mas
       reciente.  Existen dos razones principales para esto: la primera es que
       puede que el fichero de configuracion  <<conffile>>  haya  desaparecido
       accidentalmente,  con  lo  que la siguiente version la restauraria. Los
       usuarios no querrian ver desparecer los cambios hechos. La  segunda  es
       permitir  a  los paquetes una transicion de un fichero de configuracion
       <<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   configuracion,   debe   hacerlo   de   forma  explicita.
       dpkg-maintscript-helper se puede usar para  implementar  con  sencillez
       dentro de los scripts del mantenedor la eliminacion y el desplazamiento
       de ficheros de configuracion <<conffile>>.

   ELIMINAR UN FICHERO DE CONFIGURACI'ON <<CONFFILE>>
       Si se elimina un fichero de configuracion <<conffile>> por completo, se
       deberia  eliminar  del disco a menos que un usuario lo haya modificado.
       Se deberian preservar modificaciones locales en caso de existir. Si  se
       cancela  la  actualizacion  del  paquete,  el  fichero de configuracion
       <<conffile>> declarado como obsoleto no deberia 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 'ultima-versi'on paquete -- "$@"

       conffile  es  el  nombre  del  fichero  de configuracion <<conffile>> a
       eliminar. 'ultima-versi'on es la ultima version del paquete que  contenia
       el  fichero  de  configuracion  <<conffile>>  (o  la ultima version del
       paquete que no  se  ocupo  de  eliminar  el  fichero  de  configuracion
       <<conffile>>  obsoleto  en  el caso de que este metodo no se implemento
       inmediatamente). Si 'ultima-versi'on esta vacio o se omite, se  intentara
       la  operacion  en cada actualizacion. paquete es el nombre del paquete,
       su  aparicion  es  opcional  ya   que   el   valor   por   omision   es
       <<$DPKG_MAINTSCRIPT_PACKAGE>>  (dpkg define esta variable con el nombre
       del paquete sobre el que actua). Todos los parametros de los scripts de
       mantenedor se deben introducir al programa despues de <<-->>.

       Implementacion  actual:  en  el  script  preinst,  comprueba  si  se ha
       modificado  el  fichero  de  configuracion  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  actualizacion del
       paquete, el script  postrm  reinstalara  el  fichero  de  configuracion
       <<conffile>>  original.  Durante  el  purgado, el script postrm borrara
       tambien el fichero .dpkg-bak mantenido hasta ahora.

   RENOMBRAR UN FICHERO DE CONFIGURACI'ON <<CONFFILE>>
       Si  se  ha  cambiado  la  ubicacion  de  un  fichero  de  configuracion
       <<conffile>>  debe  asegurarse  de que tambien migra los cambios hechos
       por el usuario. Esto puede parecer en principio como un sencillo cambio
       en  el  script  preinst,  aunque  resultara  en un dialogo de dpkg para
       confirmar la  edicion  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 'ultima-versi'on
               paquete -- "$@"

       conffile-antiguo y conffile-nuevo son el nombre  antiguo  y  nuevo  del
       fichero de configuracion <<conffile>> a renombrar. 'ultima-versi'on es la
       ultima version del paquete que contenia  el  fichero  de  configuracion
       <<conffile>>  con  el nombre antiguo. Si ultima-versi'on esta vacio o se
       omite, se ejecutara la operacion en cada actualizacion  (nota:  es  mas
       seguro dar la version y ejecutar la operacion una sola vez). paquete es
       el nombre del  paquete,  opcional  ya  que  su  valor  por  omision  es
       <<$DPKG_MAINTSCRIPT_PACKAGE>>  (dpkg define esta variable con el nombre
       del paquete sobre el que actua). Todos los  parametros  de  scripts  de
       mantenedor se deben introducir despues de <<-->>.

       Implementacion  actual: el script preinst comprueba si se ha modificado
       el fichero de configuracion <<conffile>>, preservandolo en su lugar  si
       es  asi,  o  renombrandolo  como  conffile-antiguo.dpkg-remove  en caso
       contrario.  Durante  la  configuracion,  el  script  postinst   elimina
       conffile-antiguo.dpkg-remove    y    renombra   conffile-antiguo   como
       conffile-nuevo  si  el  primero  aun  esta   disponible.   Durante   la
       cancelacion  de  una  instalacion  o  actualizacion  el  script  postrm
       renombra conffile-antiguo.dpkg-remove nuevamente como  conffile-antiguo
       de ser necesario.

INTEGRACI'ON EN PAQUETES

       Given  that  dpkg-maintscript-helper  is  used in the preinst, using it
       unconditionally requires a pre-dependency to ensure that  the  required
       version  of dpkg has been unpacked before. The required version depends
       on the command used, for rm_conffile and mv_conffile it is 1.15.7.2:

           Pre-Depends: dpkg (>= 1.15.7.2)

       Aun asi, en muchos casos la operacion efectuada por el programa  no  es
       critica  para  el  paquete, y en lugar de usar un pre-dependencia puede
       invocar  el  programa  solo  si  sabemos  que  la  orden  requerida  es
       compatible con la version 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 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.