<!doctype refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
  <!ENTITY debian  "<productname>Debian GNU/Linux</productname>">
  <!ENTITY docbook "<productname>DocBook</productname>">
]>

<!-- Manual page for debchanges, DocBook source file
     (C) 2000 Matt Zimmerman <mdz@debian.org>

     Based on the example page docbook-to-man.sgml from docbook-to-man

     $Id: apt-listchanges.es.sgml,v 1.5 2004/04/04 05:58:12 mdz Exp $
-->

<!-- 
(c) 2003 Software in the Public Interest
Esta traduccin ha sido realizada por Rubn Porras Campo <nahoo@inicia.es>
Est basada en la pgina de manual original:
versin 1.6 del CVS de
/cvs/debian-doc/manpages/english/apt-listchanges/apt-listchanges.sgml
 -->

<refentry lang=es>
  <docinfo>
    <address>
      <email>mdz@debian.org</email>
    </address>
    <author>
      <firstname>Matt</firstname>
      <surname>Zimmerman</surname>
    </author>
    <date>07-07-2003</date>
  </docinfo>
  <refmeta>
    <refentrytitle>apt-listchanges</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>apt-listchanges</refname> <refpurpose>Muestra las nuevas entradas
      de los ficheros de cambios de los paquetes de Debian
    </refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>apt-listchanges</command>
      <group choice=opt>
        <arg rep=repeat><replaceable>opciones</replaceable></arg>
      </group>

      <group choice=req>
	<arg><option>--apt</option></arg>
	<arg rep=repeat><replaceable>paquete.deb</replaceable></arg>
      </group>

    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPCIN</title>

    <para><command>apt-listchanges</command> es una herramienta que muestra los
      cambios de una nueva versin de un paquete de Debian respecto a la versin
      instalada actualmente en el sistema.</para>

    <para>
      Esto se realiza extrayendo las entradas relevantes de los ficheros
      NEWS.Debian y changelog<optional>.Debian</optional>, normalmente se
      encuentran en
      <filename>/usr/share/doc/</filename><replaceable>paquete</replaceable>, de los
      archivos de paquetes Debian.
    </para>

    <para>
      Cuando se le proporciona un conjunto de ficheros como argumentos (o ledos
      a travs de apt con la opcin <option>--apt</option>),
      <command>apt-listchanges</command> analizar los ficheros (asumiendo que
      son archivos de paquetes de Debian) en busca de las entradas relevantes
      del fichero de cambios, y mostrar un resumen, ordenado por urgencia.
    </para>

  </refsect1>

  <refsect1>
    <title>OPCIONES</title>

    <VARIABLELIST>
      <VARLISTENTRY>
	<TERM><option>--apt</option>
	</TERM>
	<LISTITEM>
	  <PARA>Lee los nombres de los ficheros de una tubera con un formato
	    especial (tal como lo proporciona apt), en vez de la lnea de
	    rdenes, y tiene en cuenta ciertas opciones especificas de apt en el
	    fichero de configuracin. Esta tubera debe estar en el formato de
	    la "versin 2", especificado en el fichero de configuracin de apt.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>
      <VARLISTENTRY>
	<TERM><option>-v, --verbose</option>
	</TERM>
	<LISTITEM>
	  <PARA>Muestra informacin adicional (normalmente no se quiere). Por
	    ejemplo, mostrar un mensaje cuando un paquete con la misma versin o
	    anterior va a ser instalado, o cuando es la primera vez que se
	    instala el paquete.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>
      <VARLISTENTRY>
	<TERM><option>-f, --frontend</option>
	</TERM>
	<LISTITEM>
	  <PARA>
	    Selecciona la interfaz a usar para mostrar la informacin al
	    usuario. Las interfaces actuales son:
	  </PARA>
	  <VARIABLELIST>
	    <VARLISTENTRY>
	      <TERM>pager</TERM>
	      <LISTITEM>
		<PARA>
		  Usa su paginador favorito para mostrar la salida. Por omisin,
		  se usar la variable de entorno PAGER. La opcin "pager" puede
		  especificarse en el fichero de configuracin para que
		  apt-listchanges use un paginador especfico.
		</PARA>
	      </LISTITEM>
	    </VARLISTENTRY>

            <varlistentry>
              <term>browser</term>
              <listitem>
                <para>
                  Muestra los cambios en formato HTML usando un navegador, con
                  enlaces para los fallos y las direcciones de correo
		  electrnico. Por omisin, se usar la variable de entorno
                  BROWSER. La opcin "browser" puede especificarse en el fichero
                  de configuracin para que apt-listchanges use un navegador
                  especfico.
                </para>
              </listitem>
            </varlistentry>

	    <VARLISTENTRY>
	      <TERM>xterm-pager</TERM>
	      <LISTITEM>
		<PARA>
		  Usa su paginador favorito para mostrar la salida, pero lo hace
		  sobre un xterm (usando la alternativa x-terminal-emulator) de
		  fondo. Esto le permite realizar la actualizacin mientras mira
		  los cambios. Puede cambiar el emulador de terminal con la
		  opcin "xterm".
		</PARA>
	      </LISTITEM>
	    </VARLISTENTRY>

            <varlistentry>
              <term>xterm-browser</term>
              <listitem>
                <para>
                  La combinacin lgica de xterm-pager y browser. Apropiada slo
                  para navegadores en modo texto.
                </para>
              </listitem>
            </varlistentry>

	    <VARLISTENTRY>
	      <TERM>text</TERM>
	      <LISTITEM>
		<PARA>
		  Vuelca la salida a stdout, sin pausas.
		</PARA>
	      </LISTITEM>
	    </VARLISTENTRY>

	    <VARLISTENTRY>
	      <TERM>mail</TERM>
	      <LISTITEM>
		<PARA>
		  Manda correos a las direcciones especificadas con
          --email-address, y no muestra los cambios.
		</PARA>
	      </LISTITEM>
	    </VARLISTENTRY>

	    <VARLISTENTRY>
	      <TERM>none</TERM>
	      <LISTITEM>
		<PARA>
		  No hace nada. Puede usarse para prevenir que apt-listchanges se
		  ejecuta cunado se invoque apt de forma automtica.
		</PARA>
	      </LISTITEM>
	    </VARLISTENTRY>
	  </VARIABLELIST>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
	<TERM><OPTION>--email-address=direccin</OPTION></TERM>
	<LISTITEM>
	  <PARA>
       Adems de mostrar los cambios, mandar una copia a la direccin
       especificada. Si slo quiere mandar los cambios, use esta opcin
       junto con la interfaz 'mail'.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
	<TERM><OPTION>-c, --confirm</OPTION></TERM>
	<LISTITEM>
	  <PARA>
	    Una vez que se han mostrado los cambios, preguntar al usuario si
	    desea continuar. Si el usuario elige no continuar, se devolver un
	    estado de salida distinto de cero, y apt abortar.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
	<TERM><OPTION>-a, --all</OPTION></TERM>
	<LISTITEM>
	  <PARA>
	    En vez de tratar de mostrar los cambios desde la versin instalada,
	    simplemente mostrar todos los cambios de todos los paquetes. Esto es
	    til para ver todo el fichero de cambios de un .deb antes de
	    extraerlo.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
	<TERM><OPTION>--save_seen=fichero</OPTION></TERM>
	<LISTITEM>
	  <PARA>
	    Esta opcin har que apt-listchanges lleve la cuenta de la ltima
	    versin de un paquete para la que se han mostrado los cambios, para
	    as, evitar mostrar los mismos cambios en futuras ejecuciones. La
	    base de datos se guarda en el fichero especificado. Especifique
	    &laquo;none&raquo; para deshabilitar esta caracterstica.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
	<TERM><OPTION>--which={news|changelogs|both}</OPTION></TERM>
	<LISTITEM>
	  <PARA>
	    Esta opcin indica si se deben mostrar la noticias (de NEWS.Debian
	    et al.), registros de cambios (de changelog.Debian et al.) o
	    ambos. Por omisin slo se muestran las noticias.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
	<TERM><OPTION>--help</OPTION></TERM>
	<LISTITEM>
	  <PARA>
	    Muestra informacin acerca de la sintaxis.
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
	<TERM><OPTION>-h, --headers</OPTION></TERM>
	<LISTITEM>
	  <PARA>
	    Esta opcin har que apt-listchanges inserte una cabecera antes de
	    los cambios de cada paquete, mostrando el nombre del paquete, y los
	    nombres de los paquetes binarios que van a ser actualizados (si es
	    que hay ms de uno o difiere respecto del nombre del paquete
	    fuente).
	  </PARA>
	</LISTITEM>
      </VARLISTENTRY>

      <varlistentry>
        <term><option>--debug</option></term>
        <listitem>
          <para>Muestra alguna informacin de depuracin.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--profile=<replaceable>nombre</replaceable></option></term>
	<listitem>
	  <para>Selecciona un perfil.
	    <replaceable>nombre</replaceable> corresponde a una seccin en
	    <filename>/etc/apt/listchanges.conf</filename>.  De forma
	    predeterminada, cuando se invoca desde apt es "apt", y "cmdline" en
	    otro caso.
	  </para>
	</listitem>
      </varlistentry>

    </VARIABLELIST>

  </refsect1>

  <refsect1>
    <title>ENTORNO</title>

    <variablelist>
      <varlistentry>
        <term>APT_LISTCHANGES_FRONTEND</term>
        <listitem><para>Interfaz a usar</para></listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term>BROWSER</term>
        <listitem><para>Usado por la interfaz browser, debera ser una orden que
        espere una URL de un fichero en formato HTML a mostrar.</para>

        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>FICHEROS</title>

    <variablelist>
      <varlistentry>
	<term>/etc/apt/listchanges.conf</term>

        <listitem>
          <para>Fichero de configuracin. La mayora de las opciones tienen el
          nombre de las opciones de la lnea de rdenes, con los guiones
          cambiados por guiones bajos.</para>

          <example>
            <title>Fichero de configuracin de ejemplo</title>
	    <programlisting>
	      [cmdline]
	      frontend=pager
	      
	      [apt]
	      frontend=xterm-pager
	      email_address=root
	      confirm=1

	      [custom]
	      frontend=browser
	      browser=mozilla
	    </programlisting>
	  </example>

          <para>El fichero de configuracin anterior especifica que, en el modo
          lnea de rdenes, la interfaz predeterminada es "pager".
          En modo apt, la interfaz predeterminado es xterm-pager, una copia de
          los cambios (si es que hay algunos) debe enviarse al superusuario, y
          apt-listchanges debe pedir confirmacin. Si se invoca a
          apt-listchanges con --profile=custom se usar la interfaz de
          navegador, y se ejecutar mozilla.</para>

        </listitem>
      </varlistentry>

      <varlistentry>
	<term>/var/lib/apt/listchanges.db</term>
        <listitem><para>Base de datos usada por save-seen</para></listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>AUTOR</title>

    <PARA>
      apt-listchanges fue escrito por Matt Zimmerman
      &lt;mdz@debian.org&gt;
    </PARA>
  </refsect1>

  <refsect1>
    <title>TRADUCTOR</title>
    <para>
      Traduccin de Rubn Porras Campo
      &lt;debian-l10n-spanish@lists.debian.org&gt;
    </para>
  </refsect1>

  <refsect1>
    <title>VASE ADEMS</title>

    <para>
      <citerefentry><refentrytitle>apt.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
    </para>
  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->