Provided by: dpkg_1.16.1.2ubuntu7_i386 bug

NOMBRE

       dpkg-maintscript-helper  -  Solución  alternativa a las limitaciones de
       dpkg en scripts de mantenedor

SINOPSIS

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

ÓRDENES Y PARÁMETROS

       rm_ conffile [ltima-versin [paquete]]

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

DESCRIPCIÓN

       Este programa está diseñado 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 diseño 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ÓN «CONFFILES»

       Al actualizar un paquete, dpkg no eliminará automáticamente un  fichero
       de  configuración  (un fichero de configuración con cambios del usuario
       que dpkg debería preservar) si no  está  presente  en  la  versión  más
       reciente.  Existen dos razones principales para esto: la primera es que
       puede que el fichero  de  configuración  «conffile»  haya  desaparecido
       accidentalmente,  con  lo  que la siguiente versión la restauraría. Los
       usuarios no querrían ver desparecer los cambios hechos. La  segunda  es
       permitir  a  los paquetes una transición de un fichero de configuración
       «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   configuración,   debe   hacerlo   de   forma  explícita.
       dpkg-maintscript-helper se puede usar para  implementar  con  sencillez
       dentro de los scripts del mantenedor la eliminación y el desplazamiento
       de ficheros de configuración «conffile».

   ELIMINAR UN FICHERO DE CONFIGURACIÓN «CONFFILE»
       Si se elimina un fichero de configuración «conffile» por  completo,  se
       debería  eliminar  del disco a menos que un usuario lo haya modificado.
       Se deberían preservar modificaciones locales en caso de existir. Si  se
       cancela  la  actualización  del  paquete,  el  fichero de configuración
       «conffile» declarado como obsoleto no debería 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  configuración  «conffile» a
       eliminar. ltima-versin es la última versión del paquete que  contenía
       el fichero de configuración «conffile» (o la última versión del paquete
       que no se ocupó de eliminar  el  fichero  de  configuración  «conffile»
       obsoleto   en   el   caso   de   que   este  método  no  se  implementó
       inmediatamente). Si ltima-versin está vacío o se omite, se  intentará
       la  operación  en cada actualización. paquete es el nombre del paquete,
       su  aparición  es  opcional  ya   que   el   valor   por   omisión   es
       «$DPKG_MAINTSCRIPT_PACKAGE»  (dpkg  define  esta variable con el nombre
       del paquete sobre el que actúa). Todos los parámetros de los scripts de
       mantenedor se deben introducir al programa después de «--».

       Implementación  actual:  en  el  script  preinst,  comprueba  si  se ha
       modificado  el  fichero  de  configuración  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  actualización del
       paquete, el script  postrm  reinstalará  el  fichero  de  configuración
       «conffile»  original.  Durante  el  purgado,  el  script postrm borrará
       también el fichero .dpkg-bak mantenido hasta ahora.

   RENOMBRAR UN FICHERO DE CONFIGURACIÓN «CONFFILE»
       Si  se  ha  cambiado  la  ubicación  de  un  fichero  de  configuración
       «conffile»  debe asegurarse de que también migra los cambios hechos por
       el usuario. Esto puede parecer en principio como un sencillo cambio  en
       el  script  preinst,  aunque  resultará  en  un  diálogo  de  dpkg para
       confirmar  la  edición  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  configuración «conffile» a renombrar. ltima-versin es la
       última versión del paquete que contenía  el  fichero  de  configuración
       «conffile»  con  el  nombre  antiguo. Si ultima-versin está vacío o se
       omite, se ejecutará la operación en cada actualización  (nota:  es  más
       seguro dar la versión y ejecutar la operación una sola vez). paquete es
       el nombre del  paquete,  opcional  ya  que  su  valor  por  omisión  es
       «$DPKG_MAINTSCRIPT_PACKAGE»  (dpkg  define  esta variable con el nombre
       del paquete sobre el que actúa). Todos los  parámetros  de  scripts  de
       mantenedor se deben introducir después de «--».

       Implementación  actual: el script preinst comprueba si se ha modificado
       el fichero de configuración «conffile», preservándolo en su lugar si es
       así,   o   renombrándolo   como  conffile-antiguo.dpkg-remove  en  caso
       contrario.  Durante  la  configuración,  el  script  postinst   elimina
       conffile-antiguo.dpkg-remove    y    renombra   conffile-antiguo   como
       conffile-nuevo  si  el  primero  aún  está   disponible.   Durante   la
       cancelación  de  una  instalación  o  actualización  el  script  postrm
       renombra conffile-antiguo.dpkg-remove nuevamente como  conffile-antiguo
       de ser necesario.

INTEGRACIÓN 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)

       Aún así, en muchos casos la operación efectuada por el programa  no  es
       crítica  para  el  paquete, y en lugar de usar un pre-dependencia puede
       invocar  el  programa  sólo  si  sabemos  que  la  orden  requerida  es
       compatible con la versión de dpkg actualmente instalada:

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

AUTORES

       Copyright © 2010 Raphaël Hertzog
       Copyright © 2008 Joey Hess
       Copyright © 2007 Guillem Jover
       Copyright © 2005 Scott James Remnant

       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.