<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">



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

     Copyright (C) 2016-2017 Robert Luberda <robert@debian.org>
     Copyright (C) 2024 THE PACKAGE'S COPYRIGHT HOLDER

     Based on the example page docbook-to-man.sgml from docbook-to-man
-->
<refentry>
  <refentryinfo>
    <productname>apt-listchanges</productname>
    <address><email>mdz@debian.org</email></address>
    <author>
      <firstname>Matt</firstname>
      <surname>Zimmerman</surname>
      <contrib/>
    </author>
    <date>2017-07-08</date>
  </refentryinfo>
  <refmeta>
    <refentrytitle>apt-listchanges</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo class="manual">Debian</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>apt-listchanges</refname>
    <refpurpose>zeigt neue Changelog-Einträge von Debian-Paketarchiven.</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
<command>apt-listchanges</command> <group choice="opt"> <arg
rep="repeat"><replaceable>Optionen</replaceable></arg> </group> <group
choice="req"> <arg><option>--apt</option></arg> <arg
rep="repeat"><replaceable>Paket.deb</replaceable></arg> </group></cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>BESCHREIBUNG</title>

    <para><command>apt-listchanges</command> ist ein Werkzeug, das zeigt, was in einer
neuen Version eines Debian-Pakets verglichen mit der derzeit auf dem System
installierten Version geändert wurde.</para>

    <para>Es tut dies, indem es die relevanten Einträge aus den beiden Dateien
NEWS.Debian und changelog<optional>.Debian</optional> extrahiert. Sie sind
normalerweise in den Debian-Paketarchiven in
<filename>/usr/share/doc/</filename><replaceable>Paket</replaceable> zu
finden.
    </para>

    <para>Bitte beachten Sie, dass in der Standardinstallation, falls
<command>apt-listchanges</command> während Upgrades als APT-Erweiterung
ausgeführt wird, es nur NEWS.Debian-Einträge anzeigt. Dies kann mit der
Option <option>--which</option> geändert werden.
    </para>

    <para>Falls Changelog-Einträge angezeigt werden und das
<replaceable>Paket</replaceable> keine
changelog<optional>.Debian</optional>-Datei enthält, ruft
<command>apt-listchanges</command> den Befehl <command>apt-get
changelog</command> auf, um das Changelog aus dem Netzwerk
herunterzuladen. Dieses Verhalten kann mit der Option
<option>--no-network</option> deaktiviert werden.
    </para>

    <para>
       Mit einer angegebenen Zusammenstellung von Dateinamen als Argument (oder von
APT mittels <option>--apt</option> gelesen) wird Apt-listchanges die Dateien
(unter der Annahme, dass es sich um Debian-Paketarchive handelt) nach den
maßgeblichen Changelog-Einträgen durchsuchen und sie alle in einer nach
Quellpaketen gruppierten Zusammenstellung anzeigen. Die Gruppen werden nach
der maximalen Dringlichkeit und dann nach dem Paketnamen
sortiert. Änderungen innerhalb jeder Paketgruppe werden in der Reihenfolge
ihres Erscheinens in den changelog-Dateien angezeigt, d.h. beginnend mit dem
Neusten bis zum Ältesten. Die Option <option>--reverse</option> kann zum
Ändern dieser Reihenfolge benutzt werden.
    </para>

  </refsect1>

  <refsect1>
    <title>OPTIONEN</title>
    <para>
      <command>apt-listchanges</command> stellt die folgenden Optionen zur
Steuerung seines Verhaltens bereit. Die meisten davon haben Entsprechungen
in der Konfigurationsdatei, Einzelheiten finden Sie unter
»KONFIGURATIONSDATEI« weiter unten.
    </para>

    <variablelist>
      <varlistentry>
        <term><option>--apt</option></term>
        <listitem>
          <para>liest Dateinamen von einer besonders formatierten (von APT bereitgestellten)
Pipeline, anstatt aus Befehlszeilenargumenten und berücksichtigt bestimmte
APT-spezifische Optionen in der Konfigurationsdatei. Diese Pipeline muss im
»Version 2«-Format in der APT-Konfiguration angegeben werden.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-v, --verbose</option></term>
        <listitem>
          <para>zeigt zusätzliche (üblicherweise unerwünschte) Informationen. Es wird zum
Beispiel eine Nachricht ausgegeben, wenn ein Paket derselben oder einer
älteren Version installiert werden soll oder wenn ein Paket neu installiert
werden soll.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>-f, --frontend</option></term>
        <listitem>
          <para>
            wählt aus, welche Oberfläche für die Ausgabe von Informationen an den
Benutzer verwendet werden soll. Zu den aktuellen Oberflächen gehören:
          </para>
          <variablelist>
            <varlistentry>
              <term>pager</term>
              <listitem>
                <para>
                  benutzt den Befehl
<citerefentry><refentrytitle>sensible-pager</refentrytitle>
<manvolnum>1</manvolnum></citerefentry>, um die Ausgabe anzuzeigen. Der
Befehl verwendet die Umgebungsvariable PAGER zur Auswahl ihres
Lieblingsseitenanzeigeprogramms. Die Option »pager« kann in der
Konfigurationsdatei angegeben werden, um ein spezielles
Seitenanzeigeprogramm auszuwählen, der mit Apt-listchanges benutzt wird.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>browser</term>
              <listitem>
                <para>
                  zeigt mit dem Befehl <citerefentry>
<refentrytitle>sensible-browser</refentrytitle><manvolnum>1</manvolnum>
</citerefentry> ein Changelog im HTML-Format mit Querverweisen für Fehler
und E-Mail-Adressen, der Ihren Lieblings-Browser anhand der
Umgebungsvariable BROWSER auswählt. Die Option »browser« kann in der
Konfigurationsdatei angegeben werden, um einen speziellen Browser
auszuwählen, der mit Apt-listchanges benutzt wird.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>xterm-pager</term>
              <listitem>
                <para>
                  verwendet Ihr bevorzugtes Seitenanzeigeprogramm, um die Ausgabe anzuzeigen,
tut dies jedoch in einem Xterm (mittels der Alternative
»x-terminal-emulator«) im Hintergrund. Dies ermöglicht Ihnen, falls Sie dies
wollen, mit dem Upgrade fortzufahren und das Durchstöbern der Changelogs
fortzusetzen. Sie können die Verwendung des Terminal-Emulators mit der
Konfigurationsoption »xterm« außer Kraft setzen.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>xterm-browser</term>
              <listitem>
                <para>
                  die logische Kombination von Xterm-Pager und Browser. Nur geeignet für
Textmodus-Browser.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>text</term>
              <listitem>
                <para>
                  gibt ohne Pausen auf die Standardausgabe aus.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>syslog</term>
              <listitem>
                <para>
                  gibt die Ausgabe in das Systemprotokoll aus. Es wird empfohlen, die Option
»titled« zu deaktivieren.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>log</term>
              <listitem>
                <para>
                  hängt die Ausgabe an eine Protokolldatei an, mit einem optionalen
Filterprozess. Es wird empfohlen, die Option »titled« zu deaktivieren.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>mail</term>
              <listitem>
                <para>
                  sendet eine E-Mail an die mit --email-address angegebene Adresse und zeigt
keine Changelogs an.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>gtk</term>
              <listitem>
                <para>
                  öffnet ein GTK-Fenster zum Anzeigen der Changelogs. Erfordert, dass
»phyton3-gi« installiert ist.
                </para>
              </listitem>
            </varlistentry>

            <varlistentry>
              <term>none</term>
              <listitem>
                <para>
                  tut nichts. Kann benutzt werden, um zu verhindern, dass Apt-listchanges
ausgeführt wird, wenn automatische Ausführung von APT eingerichtet ist.
                </para>
              </listitem>
            </varlistentry>
          </variablelist>
          <para>
           Bitte beachten Sie, dass Apt-listchanges versuchen wird, zu einem nicht
privilegierten Benutzer zu wechseln, bevor die Befehle in den Oberflächen
»browser«, »xterm-browser« und »xterm-pager« geöffnet werden. Dies wird
derzeit jedoch nicht für die Oberfläche »pager« getan. Siehe auch
»UMGEBUNGSVARIABLEN« unten.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--hide</option></term>
        <listitem>
          <para>
            Für Oberflächen, die das unterstützen (derzeit nur gtk), wird das Fenster
standardmäßig versteckt.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--email-address=<replaceable>Adresse</replaceable></option></term>
        <listitem>
          <para>
            Zusätzlich zur Anzeige wird eine Kopie der Changelog-Daten an die angegebene
Adresse geschickt. Um die Changelog-Einträge nur per E-Mail zu versenden,
benutzen Sie diese Option mit der speziellen Oberfläche »mail«.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--email-format={text|html}</option></term>
        <listitem>
          <para>
            Falls das Versenden von E-Mail-Kopien aktiviert ist (siehe
<option>--email-address</option> oben), wählt diese Option aus, ob die
E-Mail als gute alte Klartextdaten oder als HTML-Daten mit anklickbaren
Verweisen, die möglicherweise für Leute mit grafischen E-Mail-Clients
geeigneter sind, gesendet werden soll.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-c, --confirm</option></term>
        <listitem>
          <para>
            Sobald Changelogs angezeigt wurden, wird der Anwender gefragt, ob er
fortfahren möchte oder nicht. Falls er sich entscheidet, nicht fortzufahren,
wird ein Rückgabewert ungleich null zurückgegeben und APT wird abgebrochen.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-a, --show-all</option></term>
        <listitem>
          <para>
            versucht, statt Changelog-Einträgen, die neuer als die derzeit installierte
Version des Pakets sind, einfach alle Changelog-Einträge für alle Pakete
anzuzeigen. Dies ist nützlich, um das ganze Changelog eines .debs
anzuzeigen, bevor es entpackt wird.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-n, --no-network</option></term>
        <listitem>
          <para>
            In seltenen Fällen, wenn ein Binärpaket (oder genauer: keines der
Binärpakete, die aus demselben Quellpaket gebaut wurden, die zusammen als
Gruppe verarbeitet werden) keine Changelog-Datei enthält, führt
<command>apt-listchanges</command> standardmäßig <command>apt-get
changelog</command> aus, um die Changelogs von den Netzwerkservern
herunterzuladen. Sie werden üblicherweise von der Distribution Ihres
Betriebssystems bereitgestellt. Diese Option wird dieses Verhalten
deaktivieren, was zum Beispiel für Systeme hinter einer Firewall nützlich
sein kann.
          </para>
        </listitem>
      </varlistentry>


      <varlistentry>
        <term><option>--save-seen=<replaceable>Datei</replaceable></option></term>
        <listitem>
          <para>
            Diese Option wird Apt-listchanges veranlassen, die letzte Version eines
Pakets zu verfolgen, für das Changelogs angezeigt wurden, um zu vermeiden,
dass dieselben Changelogs bei einem zukünftigen Aufruf erneut angezeigt
werden. Die Datenbank wird in der genannten Datei gespeichert. Geben Sie
»none« an, um diese Funktionalität zu deaktivieren.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--dump-seen</option></term>
        <listitem>
          <para>
            zeigt den Inhalt der Datenbank mit dem Gesehenen auf der Standardausgabe als
Liste. In den Zeilen stehen durch Leerzeichen getrennt Quellpaketnamen und
die zuletzt gesehene Version. Diese Option benötigt den Pfad zur Datenbank
mit dem Gesehenen: Bitte geben Sie ihn mittels der Option
<option>--save-seen</option> an oder übergeben Sie die Option
<option>--profile=apt</option>, damit er aus der Konfigurationsdatei gelesen
wird.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--since=<replaceable>Version</replaceable></option></term>
        <listitem>
          <para>
            Diese Option wird Apt-listchanges veranlassen, die Einträge anzuzeigen, die
neuer als die angegebene Version sind. Das einzige andere Argument, das Sie
mit dieser Option übergeben können, ist der Pfad zu einer .deb-Datei.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--latest=<replaceable>N</replaceable></option></term>
        <listitem>
          <para>
            Diese Option wird Apt-listchanges veranlassen, nur die letzten
<replaceable>N</replaceable> Einträge anzuzeigen.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--which={news|changelogs|both}</option></term>
        <listitem>
          <para>
            Diese Option wählt aus, ob Neuigkeiten (von NEWS.Debian und anderen),
Changelogs (von changelog.Debian und anderen) oder beide angezeigt werden
soll. Standardmäßig werden beim Betrieb als APT-Erweiterung nur Neuigkeiten
angezeigt, ansonsten beide.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--help</option></term>
        <listitem>
          <para>
            zeigt Syntaxinformationen.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-h, --headers</option></term>
        <listitem>
          <para>
            Diese Optionen werden Apt-listchanges veranlassen, eine Kopfzeile vor jedem
Paket-Changelog einzufügen, der den Namen des Pakets und die Namen der
Binärpakete anzeigt, von denen ein Upgrade durchgeführt wird (falls es mehr
als eines gibt oder der Name sich von dem des Quellpakets unterscheidet).
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--debug</option></term>
        <listitem>
          <para>zeigt einige Informationen zur Fehlersuche.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--profile=<replaceable>Name</replaceable></option></term>
        <listitem>
          <para>wählt ein Optionsprofil aus. <replaceable>Name</replaceable> entspricht
einem Abschnitt in
<filename>/etc/apt/listchanges.conf</filename>. Voreinstellung beim Aufruf
von APT ist »apt«, ansonsten »cmdline«.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--log=<replaceable>Datei</replaceable></option></term>
        <listitem>
          <para>
            wählt die Datei aus, die von dem Protokollierungsprogramm angehängt werden
soll. Die Vorgabe ist <filename>/var/log/apt/listchanges.log</filename>. Die
Filter-Befehl-Option kann zur Veränderung der Ausgabe, bevor diese an die
Protokolldatei angehängt wird, verwandt werden. Bitte stellten Sie sicher,
dass eine Protokollrotation für diese Datei einrichten.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--filter=<replaceable>Befehl</replaceable></option></term>
        <listitem>
          <para>
            wählt den Befehl aus, der zum Filtern der Ausgabe verwandt werden soll,
bevor dieser durch das Protokollierungsprogramm an die Protokolldatei
gehängt wird. Stdin wird die Ausgabe von <command>apt-listchanges</command>
empfangen und Stdout wird an die Protokolldatei angehängt werden. Trennen
Sie Argumente durch Leerzeichen und schließen Sie Argumente mit Leerzeichen
in englische Anführungszeichen ein. Der Befehl wird nur dann mittels der
Shell ausgeführt, wenn die Shell Teil des Befehlsnamens ist: <command>sh -c
'date ; cat'</command>
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--reverse</option></term>
        <listitem>
          <para>
            zeigt die Changelog-Einträge in umgekehrter Reihenfolge.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--ignore-apt-assume</option>,
<option>--ignore-debian-frontend</option></term>
        <listitem>
          <para>
            deaktiviert, dass eine nicht interaktive Oberfläche in einigen im Abschnitt
»AUTOMATISCHES AUßERKRAFTSETZEN VON OBERFLÄCHEN« beschriebenen Fällen,
erzwungen wird.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--titled</option>, <option>--untitled</option></term>
        <listitem>
          <para>
            aktiviert oder deaktiviert den Titel am Anfang der Ausgabe.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--select-frontend</option></term>
        <listitem>
          <para>
            wählt die Oberfläche interaktiv aus. Diese Option dient hauptsächlich
Testzwecken, bitte verwenden Sie sie nicht.
          </para>
        </listitem>
      </varlistentry>

    </variablelist>

  </refsect1>

  <refsect1>
    <title>AUTOMATISCHES AUßERKRAFTSETZEN VON OBERFLÄCHEN</title>
        <para>
            Für eine bessere Eingliederung in bestehende Paketverwaltungswerkzeuge
versucht <command>apt-listchanges</command> festzustellen, ob Paket-Upgrades
auf eine nicht interaktive Art durchgeführt wurden und ändert seine
Oberfläche automatisch zu »text«, wenn <emphasis>irgendeine</emphasis> der
nachfolgenden Bedingungen erfüllt ist:
            <itemizedlist mark="opencircle">
                <listitem>
                    <para>Die Standardausgabe ist nicht mit einem Terminal verbunden.</para>
                </listitem>
                <listitem>
                    <para>Die Option <option>--quiet</option> (<option>-q</option>) wurde an
<citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum>
</citerefentry> (oder <citerefentry><refentrytitle>aptitude</refentrytitle>
<manvolnum>8</manvolnum></citerefentry>) übergeben. Beachten Sie jedoch,
dass Apt-listchanges die Oberfläche in »mail« ändert, wenn die Option
mehrfach übergeben wurde.</para>
                </listitem>
                <listitem>
                    <para>Die Option <option>--assume-yes</option> (<option>-y</option>) wurde an
<citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum>
</citerefentry> übergeben.</para>
                </listitem>
                <listitem>
                    <para>Die Umgebungsvariable <envar>DEBIAN_FRONTEND</envar> ist auf
»noninteractive« und <envar>APT_LISTCHANGES_FRONTEND</envar> nicht gesetzt.</para>
                </listitem>
            </itemizedlist>
        </para>
        <para>
            Aus Gründen der Rückwärtskompatibilität können die beiden letzten Prüfungen
oberhalb entweder mit den Konfigurationsdateieinträgen
»ignore_apt_assume=true« oder »ignore_debian_frontend=true« deaktiviert
werden (siehe »KONFIGURATIONSDATEI« weiter unten) oder mittels der
Befehlszeilenoptionen: <option>--ignore-apt-assume</option> oder
<option>--ignore-debian-frontend</option>.
        </para>
        <para>
            Bitte beachten Sie, dass die Oberfläche »mail« bereits nichtinteraktiv ist,
weswegen sie nie zur Oberfläche »text« umgeschaltet wird.
        </para>
        <para>
            Zusätzlich überschreibt <command>apt-listchanges</command> X11-basierte
Oberflächen (»gtk«, »xterm-pager«, »xterm-browser«) mit »pager« (oder
»browser« im Fall von »xterm-browser«), wenn die Umgebungsvariable
<envar>DISPLAY</envar> nicht gesetzt ist.
        </para>
        <para>
            Bitte beachten Sie, dass diese stillen Oberflächen nicht folgenden
Außerkraftsetzungen unterliegen: syslog, log.
        </para>
  </refsect1>

  <refsect1>
    <title>KONFIGURATIONSDATEI</title>
        <para>
          <command>apt-listchanges</command> liest seine Konfiguration aus
<filename>/etc/apt/listchanges.conf</filename>. Die Datei besteht aus
<replaceable>Abschnitten</replaceable> mit in quadratische Klammern
eingeschlossenen Namen. Jeder Abschnitt sollte Zeilen im Format
<replaceable>Schlüssel</replaceable>=<replaceable>Wert</replaceable>
enthalten. Zeilen, die mit dem Zeichen »#« beginnen, werden als Kommentar
angesehen und ignoriert. Dateien mit Namen
<filename><replaceable>Name</replaceable>.conf</filename> in dem Verzeichnis
<filename>/etc/apt/listchanges.conf.d</filename> werden auch auf die gleiche
Art gelesen und setzen Werte, die in der Hauptkonfigurationsdatei gesetzt
sind, außer Kraft.
        </para>
        <para>
          <replaceable>Abschnitt</replaceable> ist ein Profilname, der als Parameter
für die Option <option>--profile</option> benutzt werden kann.
        </para>
        <para>
          Die Konfiguration des Abschnitts »apt« kann durch
<citerefentry><refentrytitle>debconf</refentrytitle><manvolnum>7</manvolnum></citerefentry>
verwaltet werden. Dort können auch die meisten Einstellungen miitels des
Befehls <command>dpkg-reconfigure apt-listchanges</command> geändert werden.
        </para>
        <para>
          <replaceable>Schlüssel</replaceable> ist ein Name einer Befehlszeilenoption
(außer für <option>--apt</option>, <option>--profile</option> und
<option>--help</option>) bei der die führenden Bindestriche entfernt und die
verbleibenden Bindestriche in Unterstriche umgewandelt werden, zum Beispiel:
»email_format« oder »save_seen«.
        </para>
        <para>
          <replaceable>Wert</replaceable> steht für den Wert der entsprechenden
Option. Für Befehlszeilenoptionen, die kein Argument entgegennehmen, wie
»confirm« oder »headers«, sollte der Wert entweder zum Aktivieren auf »1«,
»yes«, »true« und »on« oder zum Deaktivieren auf »0«, »no«, »false« und
»off« gesetzt werden.
        </para>
        <para>
           Zusätzlich kann <replaceable>Schlüssel</replaceable> eines der folgenden
Schlüsselwörter sein: »browser«, »pager« oder »xterm«. Der
<replaceable>Wert</replaceable> eines derartigen Konfigurationseintrags
sollte der Name eines zugehörigen Befehls, eventuell von seinen Argumenten
gefolgt, sein zum Beispiel: »pager=less -R«.
        </para>

        <example>
          <title>Beispielkonfigurationsdatei</title>
<programlisting>
[cmdline]
frontend=pager

[apt]
frontend=xterm-pager
email_address=root
confirm=1

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

        <para>Obige Konfigurationsdatei gibt an, dass die Standardoberfläche im
Befehlzeilenmodus »pager« sein soll. Im APT-Modus ist die
Xterm-Pager-Oberfläche voreingestellt, eine Kopie der Changelogs sollte
(falls vorhanden) per E-Mail an Root geschickt werden und Apt-listchanges
sollte um Bestätigung ersuchen. Falls Apt-listchanges mit --profile=custom
aufgerufen wird, soll die Browser-Oberfläche benutzt und Mozilla aufgerufen
werden.</para>
  </refsect1>

  <refsect1>
    <title>UMGEBUNG</title>

    <variablelist>
      <varlistentry>
        <term>APT_LISTCHANGES_FRONTEND</term>
        <listitem><para>Oberfläche, die benutzt werden soll</para></listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term>APT_LISTCHANGES_USER, SUDO_USER, USERNAME</term>
        <listitem><para>Der Wert der ersten der obigen Variablen wird als Name des Benutzers
verwendet, zu dem gewechselt wird, wenn Befehle ausgeführt werden, die durch
die Oberflächen »browser«, »xterm-browser« und »xterm-pager« hervorgebracht
wurden, falls <command>apt-listchanges</command> durch einen privilegierten
Benutzer gestartet wurde.</para></listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term>DEBIAN_FRONTEND</term>
        <listitem><para>Falls es auf »noninteractive« gesetzt ist, kann es erzwingen, dass
<command>apt-listchanges</command> eine nicht interaktive Oberfläche
benutzt. Einzelheiten finden Sie im Abschnitt »AUTOMATISCHES
AUßERKRAFTSETZEN VON OBERFLÄCHEN«.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term>BROWSER</term>
        <listitem><para>wird von der Browser-Oberfläche benutzt, sollte auf einen Befehl gesetzt
sein, der eine Datei erwartet: URL für eine HTML-Datei, die angezeigt werden
soll.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term>PAGER</term>
        <listitem><para>von der Seitenanzeigeprogrammoberfläche (Pager) benutzt</para></listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term>APT_HOOK_INFO_FD</term>
        <listitem><para>Dateideskriptor, um Paketnamen im Modus <option>--apt</option> daraus
einzulesen. (Es wird erwartet, dass APT diese Variable auf eine korrekte
Dateideskriptornummer setzt.)</para></listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>GESEHEN-DATENBANK-INITIALISIERUNG</title>

    <para>
      Wird <command>apt-listchanges</command> erstmalig installiert oder von einer
älteren Version aktualisiert, die nicht das aktuelle Format der
Gesehen-Datenbank verwandte, wird ein <command>systemd</command>-Timer
<command>apt-listchanges.timer</command> aktiviert, der stündlich versucht,
<command>apt-listchanges.service</command> zu aktivieren, der die changelog-
und NEWS-Dateien aller installierten Pakete durchsucht und ihre Inhalte dazu
verwendet, die Gesehen-Datenbank zu befüllen.
    </para>
    <para>    
      Durch die Vorbefüllung der Datenbank auf diese Art wird
<command>apt-listchanges</command> beschleunigt, da es dann nicht die
changelog- und NEWS-Dateien der aktuell installierten Pakete während der
Aktualisierungen auswerten muss, um zu bestimmen, welche neuen Einträge
anzuzeigen sind.
    </para>
    <para>
      Die Vorbefüllung der Datenbank sollte auf jedem Rechner nur einmalig
erfolgen, da von diesem Zeitpunkt an <command>apt-listchanges</command> die
Datenbank während Upgrades automatisch aktualisiert. Daher wird der Timer
automatisch deaktiviert, nachdem der Dienst erfolgreich abgeschlossen wurde.
    </para>
    <para>
      Falls Sie aus irgendeinem Grund annehmen, dass die Gesehen-Datenbank von
<command>apt-listchanges</command> unvollständig oder ungenau ist, können
Sie sie durch Entfernen von <filename>/var/lib/apt/listchanges</filename>
und darauffolgenden Ausführen von <command>systemctl start
apt-listchanges.service</command> neu bauen. Beachten Sie, dass diese
Ausführung komplett im Vordergrund erfolgt.
    </para>
  </refsect1>
    
  <refsect1>
    <title>DATEIEN</title>

    <variablelist>
      <varlistentry>
        <term>/etc/apt/listchanges.conf</term>
        <listitem><para>Konfigurationsdatei</para></listitem>
      </varlistentry>

      <varlistentry>
        <term>/etc/apt/listchanges.conf.d/*.conf</term>
        <listitem><para>Dateien, zum Außerkraftsetzen von Konfigurationsdatei</para></listitem>
      </varlistentry>

      <varlistentry>
        <term>/etc/apt/apt.conf.d/20listchanges</term>
        <listitem><para>Datei, die zum Registrieren von Apt-listchanges im APT-System benutzt wird</para></listitem>
      </varlistentry>

      <varlistentry>
        <term>/var/lib/apt/listchanges</term>
        <listitem><para>Datenbank, die für Save-seen benutzt wird</para></listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>AUTOR</title>

    <para>
      Apt-listchanges wurde von Matt Zimmerman &lt;mdz@debian.org&gt; geschrieben.
    </para>
    <para>
      Der derzeitige Betreuer ist Jonathan Kamens &lt;jik@kamens.us&gt;.
    </para>
  </refsect1>

  <refsect1>
    <title>SIEHE AUCH</title>

    <para>
      <citerefentry><refentrytitle>sensible-pager</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sensible-browser</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>apt-get</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>aptitude</refentrytitle><manvolnum>8</manvolnum></citerefentry>
    </para>
  </refsect1>
<refsect1>
  <title>ÜBERSETZUNG</title>
  <para>
    Chris Leick &lt;c.leick@vollbio.de&gt;; 
    Helge Kreutzmann &lt;debian@helgefjell.de&gt;
  </para>
</refsect1>
</refentry>

<!-- vim:set fileencoding=utf-8 et ts=2 sts=2 sw=2: -->
