'\" t
.\"     Title: apt-listchanges
.\"    Author: Matt Zimmerman
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2017-07-08
.\"    Manual: Debian
.\"    Source: apt-listchanges
.\"  Language: Polish
.\"
.TH "APT\-LISTCHANGES" "1" "2017\-07\-08" "apt-listchanges" "Debian"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAZWA"
apt-listchanges \- Wyświetla nowe wpisy zmian pakietów Debiana
.SH "STRESZCZENIE"
.HP \w'\fBapt\-listchanges\fR\ 'u
\fBapt\-listchanges\fR [[\fIopcje\fR...]] {[\fB\-\-apt\fR] | [\fIpakiet\&.deb\fR...]}
.SH "OPIS"
.PP
\fBapt\-listchanges\fR
jest narzędziem pokazującym zmiany pomiędzy nową wersją pakietu Debiana a wersją obecnie zainstalowaną w systemie\&.
.PP
Narzędzie wyciąga odpowiednie wpisy z plików zarówno NEWS\&.Debian, jak i changelog[\&.Debian], które zazwyczaj znajdują się w katalogu
/usr/share/doc/\fIpakiet\fR
pakietów pochodzących z archiwów Debiana\&.
.PP
Prosimy zwrócić uwagę na to, że według domyślnych ustawień instalacji jeśli
\fBapt\-listchanges\fR
jest uruchamiany podczas aktualizacji pakietów jako plugin APT, to wyświetla tylko i wyłącznie wpisy pochodzące z plików NEWS\&.Debian\&. Można to zmienić, używając opcji
\fB\-\-which\fR\&.
.PP
Jeśli wyświetlane są wpisy dzienników zmian i
\fIpakiet\fR
nie zawiera pliku changelog[\&.Debian], to
\fBapt\-listchanges\fR
uruchamia
\fBapt\-get changelog\fR
w celu pobrania dziennika zmian przez sieć\&. Można to wyłączyć, używając opcji
\fB\-\-no\-network\fR\&.
.PP
\fBapt\-listchanges\fR
przegląda pliki (które powinny być pakietami Debiana) podane w linii poleceń (lub odczytane z apt, jeżeli użyto
\fB\-\-apt\fR) w poszukiwaniu odpowiednich wpisów w plikach zmian, a potem wyświetla te wpisy, grupując je po pakietach źródłowych\&. Grupy są sortowane najpierw po ważności zmian, zaczynających od tych najbardziej istotnych, a następnie po nazwie pakietu\&. Zmiany w każdej grupie pakietów są wyświetlane w takiej kolejności, w jakiej się pojawiają w plikach zmian, to jest od najnowszej do najstarszej, ale kolejność tę można zmienić za pomocą opcji
\fB\-\-reverse\fR\&.
.SH "OPCJE"
.PP
\fBapt\-listchanges\fR
zawiera następujące opcje wpływające na jego zachowanie\&. Większość z nich ma swoje odpowiedniki w pliki konfiguracyjnym, szczegółowe informacje o tym zawiera rozdział "PLIK KONFIGURACYJNY" poniżej\&.
.PP
\fB\-\-apt\fR
.RS 4
Czyta nazwy plików z odpowiednio sformatowanego potoku (dostarczanego przez apt), a nie z argumentów linii poleceń\&. Uwzględnia pewne specyficzne dla apt opcje konfiguracyjne\&. Potok musi być w wersji 2, co jest określane w konfiguracji apt\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Wyświetla informacje dodatkowe (najczęściej niepożądane)\&. Na przykład wyświetla komunikat o tym, że jest już zainstalowany pakiet w tej samej lub starszej wersji, albo o tym, że pakiet jest nowo instalowany\&.
.RE
.PP
\fB\-f, \-\-frontend\fR
.RS 4
Pozwala na wybranie interfejsu wyświetlania informacji użytkownikowi\&. Obecnie obsługiwane interfejsy to:
.PP
pager
.RS 4
Używa programu
\fBsensible-pager\fR(1)
do wyświetlania informacji\&. Program ten korzysta ze zmiennej środowiskowej PAGER, w której można podać ulubiony pager (program do wyświetlania wyjścia z podziałem na strony)\&. W wartości opcji "pager" pliku konfiguracyjnego można także podać pager, którego ma używać apt\-listchanges\&.
.RE
.PP
browser
.RS 4
Wyświetla pliki zmian sformatowane w HTML\-u i zawierające łącza do adresów raportów o błędach i adresów e\-mail opiekunów, używając do tego programu
\fBsensible-browser\fR(1), który na podstawie wartości zmiennej środowiskowej BROWSER uruchamia ulubioną przeglądarkę www użytkownika\&. W opcji "browser" pliku konfiguracyjnego można także podać przeglądarkę www, której ma używać apt\-listchanges\&.
.RE
.PP
xterm\-pager
.RS 4
Używa ulubionego pagera do wyświetlania wyjścia, ale robi to w X terminalu (uruchamiając program x\-terminal\-emulator) w tle\&. Pozwala to na kontynuowanie aktualizacji pakietów i jednoczesne przeglądanie list zmian\&. Używany emulator terminala X można nadpisać w opcji "xterm" pliku konfiguracyjnego\&.
.RE
.PP
xterm\-browser
.RS 4
Kombinacja logiczna interfejsów xterm\-pager i browser\&. Właściwa tylko do użycia z tekstowymi przeglądarkami www\&.
.RE
.PP
text
.RS 4
Wyświetla wyjście na stdout, bez przerywania\&.
.RE
.PP
mail
.RS 4
Wysyła e\-mail do odbiorców podanych w opcji \-\-email\-address\&. Nie wyświetla zmian na standardowym wyjściu\&.
.RE
.PP
gtk
.RS 4
Otwiera okno gtk w celu wyświetlenia w nim listy zmian\&. Wymaga zainstalowanego pakietu python3\-gi\&.
.RE
.PP
none
.RS 4
Nic nie robi\&. Można tego użyć, aby apt\-listchanges nie wyświetlał zmian, gdy jest skonfigurowany tak, że się automatycznie uruchamia przez apt\&.
.RE
.sp
Należy zwrócić uwagę na to, że przed uruchomieniem jakichkolwiek poleceń przez interfejsy "browser", "xterm\-browser" oraz "xterm\-pager" apt\-listchanges będzie próbował pozbyć się uprawnień administratora\&. Nie dotyczy to jednak interfejsu "pager"\&. Patrz także "ZMIENNE ŚRODOWISKOWE" poniżej\&.
.RE
.PP
\fB\-\-email\-address=\fR\fB\fIadres\fR\fR
.RS 4
Oprócz wyświetlania zmian, wysyłany także jest e\-mail do podanych odbiorców\&. Aby tylko wysłać e\-mail, bez wyświetlania zmian, należy użyć tej opcji ze specjalnym interfejsem "mail"\&.
.RE
.PP
\fB\-\-email\-format={text|html}\fR
.RS 4
Jeśli włączono wysyłanie e\-maili (patrz
\fB\-\-email\-address\fR
powyżej), to ta opcja pozwala wybrać ich format: text \- stary, dobry niesformatowany tekst (co jest domyślnym zachowaniem); html \- dane z klikalnymi odnośnikami, co może być wygodniejsze, gdy się używa graficznych programów do wyświetlania e\-maili\&.
.RE
.PP
\fB\-c, \-\-confirm\fR
.RS 4
Po wyświetleniu listy zmian pyta użytkownika o zgodę na kontynuowania instalacji\&. Jeśli użytkownik się nie zgodzi, to apt\-listchanges zwróci niezerowy kod wyjścia i apt przerwie działanie\&.
.RE
.PP
\fB\-a, \-\-show\-all\fR
.RS 4
Wyświetla wszystkie zmiany, zamiast tylko nowszych niż obecnie zainstalowana wersja pakietu\&. Może być użyteczne do przeglądania pełnych list zmian pliku \&.deb przed jego rozpakowaniem\&.
.RE
.PP
\fB\-n, \-\-no\-network\fR
.RS 4
W rzadkich przypadkach kiedy pakiet binarny (albo żeby być bardziej precyzyjnym: żaden z pakietów binarnych budowanych z tego samego źródła i przetwarzanych jako grupa pakietów) nie zawiera pliku dziennika zmian, to domyślnie
\fBapt\-listchanges\fR
uruchamia polecenie
\fBapt\-get changelog\fR
w celu pobrania dziennika zmian z serwerów sieciowych zazwyczaj utrzymywanych przez dystrybutora systemu operacyjnego\&. Za pomocą tej opcji można wyłączyć to zachowanie, co może być użyteczne na przykład w systemach znajdujących się za firewallem\&.
.RE
.PP
\fB\-\-save\-seen=\fR\fB\fIplik\fR\fR
.RS 4
Ta opcja powoduje, że apt\-listchanges trzyma informacje o ostatnich wersjach pakietów, dla których już wyświetlił listy zmian, tak aby w przyszłości uniknąć ponownego wyświetlania tych samych zmian\&. Informacje te są przechowywane w pliku, którego nazwa jest podana jako wartość tej opcji\&. Podanie "none" spowoduje wyłączenie tej funkcjonalności\&.
.RE
.PP
\fB\-\-dump\-seen\fR
.RS 4
Wypisuje na standardowym wyjściu zawartość bazy danych o wyświetlonych zmianach w postaci listy linii składających się z nazwy pakietu i ostatniej wersji, dla której wyświetlono listy zmian\&. Opcja ta wymaga znajomości ścieżki do pliku bazy danych: należy ją albo podać za pomocą opcji
\fB\-\-save\-seen\fR, albo użyć
\fB\-\-profile=apt\fR, aby ta ścieżka została odczytana z pliku konfiguracyjnego\&.
.RE
.PP
\fB\-\-since=\fR\fB\fIwersja\fR\fR
.RS 4
Ta opcja spowoduje, że apt\-listchanges wyświetli wpisy starsze niż podana wersja pakietu\&. Jeśli podano tę opcję, to jedynym dopuszczalnym innym argumentem jest ścieżka do pliku \&.deb\&.
.RE
.PP
\fB\-\-which={news|changelogs|both}\fR
.RS 4
Pozwala na wybranie typu wyświetlanych zmian: news (z plików NEWS\&.Debian), changelogs (z changelog\&.Debian itp\&.) lub both (oba)\&. Wartość domyślna to "news"\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Wyświetla informacje o składni programu\&.
.RE
.PP
\fB\-h, \-\-headers\fR
.RS 4
Te opcje spowodują, że apt\-listchanges wyświetli linię nagłówka przed listą zmian pakietu\&. Linia ta zawiera nazwę pakietu źródłowego oraz nazwy pakietów binarnych (jeśli jest więcej niż jeden lub gdy nazwa pakietu binarnego różni się od nazwy pakietu źródłowego), które są aktualizowane\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Wyświetla informacje przydatne podczas debugowania\&.
.RE
.PP
\fB\-\-profile=\fR\fB\fInazwa\fR\fR
.RS 4
Wybiera profil opcji\&.
\fINazwa\fR
odpowiada nazwie sekcji w pliku
/etc/apt/listchanges\&.conf\&. Wartością domyślną jest "apt", jeśli program został uruchomiony przez apt, lub "cmdline" w przeciwnym wypadku\&.
.RE
.PP
\fB\-\-reverse\fR
.RS 4
Wyświetla wpisy pliku dziennika zmian w odwrotnej kolejności\&.
.RE
.PP
\fB\-\-ignore\-apt\-assume\fR, \fB\-\-ignore\-debian\-frontend\fR
.RS 4
Wyłącza niektóre z przypadków przełączania interfejsu na nieinteraktywny opisanych powyżej w rozdziale "AUTOMATYCZNE NADPISYWANIE INTERFEJSU"\&.
.RE
.PP
\fB\-\-select\-frontend\fR
.RS 4
Interaktywnie wybiera interfejs\&. Ta opcja jest przeznaczona głównie do celów testowania programu, prosimy o jej nieużywanie\&.
.RE
.SH "AUTOMATYCZNE NADPISYWANIE INTERFEJSU"
.PP
\fBapt\-listchanges\fR
w celu lepszej integracji z istniejącymi narzędziami do zarządzania pakietami stara się wykryć, czy aktualizacje pakietów są przeprowadzane w trybie nieinteraktywnym, i automatycznie przełącza interfejs na "text", jeśli zajdzie
\fIktórykolwiek\fR
z następujących warunków:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
standardowe wyjście nie jest podpięte do terminalu;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
opcja
\fB\-\-quiet\fR
(\fB\-q\fR) została przekazana do
\fBapt-get\fR(8)
(lub
\fBaptitude\fR(8)); jeśli jednakże podano tę opcję więcej niż raz, to apt\-listchanges przełączy interfejs na "mail";
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
opcja
\fB\-\-assume\-yes\fR
(\fB\-y\fR) jest przekazana do
\fBapt-get\fR(8);
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
zmienna środowiskowa
\fBDEBIAN_FRONTEND\fR
jest ustawiona na "noninteractive", a
\fBAPT_LISTCHANGES_FRONTED\fR
nie jest ustawiona\&.
.RE
.PP
W celu zachowania zgodności z poprzednimi wersjami apt\-listchanges ostatnie dwa spośród powyższych sprawdzeń można wyłączyć albo za pomocą wpisów "ignore_apt_assume=true" lub "ignore_debian_frontend=true" w pliku konfiguracyjnym (patrz poniżej "PLIK KONFIGURACYJNY"), albo za pomocą opcji linii poleceń
\fB\-\-ignore\-apt\-assume\fR
lub
\fB\-\-ignore\-debian\-frontend\fR\&.
.PP
Należy także zwrócić uwagę na to, że interfejs "mail" zawsze jest nieinteraktywny, więc nigdy nie zostanie przełączony na interfejs "text"\&.
.PP
Dodatkowo
\fBapt\-listchanges\fR
zamienia interfejsy graficzne oparte na X11 ("gtk", "xterm\-pager", "xterm\-browser") na interfejs "pager" (lub "browser" w przypadku "xterm\-browser"), jeżeli nie jest ustawiona zmienna środowiskowa
\fBDISPLAY\fR\&.
.SH "PLIK KONFIGURACYJNY"
.PP
\fBapt\-listchanges\fR
czyta konfigurację z pliku
/etc/apt/listchanges\&.conf\&. Plik ten składa się z
\fIsekcji\fR, których nazwy są objęte nawiasami kwadratowymi\&. Każda sekcja powinna składać się z linii w formacie
\fIklucz\fR=\fIwartość\fR\&. Linie rozpoczynające się od znaku "#" są uważane za komentarze i ignorowane\&.
.PP
\fISekcja\fR
jest nazwą profilu, którego można użyć jako parametr opcji
\fB\-\-profile\fR\&.
.PP
Konfiguracja sekcji "apt" może być zarządzana przez program
\fBdebconf\fR(7)
i większość ustawień tej sekcji można zmienić za pomocą polecenia
\fBdpkg\-reconfigure apt\-listchanges\fR\&.
.PP
\fIKlucz\fR
jest nazwą którejś z opcji linii poleceń (z wyjątkiem
\fB\-\-apt\fR,
\fB\-\-profile\fR,
\fB\-\-help\fR) z pominiętymi początkowymi myślnikami oraz z pozostałymi myślnikami zastąpionymi przez znaki podkreślenia, na przykład: "email_format" lub "save_seen"\&.
.PP
\fIWartość\fR
jest wartością odpowiadającej opcji\&. W przypadku opcji linii poleceń nieprzyjmujących argumentów, jak na przykład "confirm" lub "headers",
\fIwartością\fR
powinno być albo "1", "yes", "true" lub "on", aby włączyć tę opcję, albo "0", "no", "false" lub "off", aby ją wyłączyć\&.
.PP
Ponadto
\fIkluczem\fR
może być każde z następujących słów: "browser", "pager" lub "xterm"\&.
\fIWartością\fR
takiego wpisu konfiguracyjnego powinna być nazwa odpowiedniego polecenia z jego ewentualnymi parametrami, na przykład "pager=less \-R"\&.
.PP
\fBPrzykład 1. Przykładowy plik konfiguracyjny\fR
.sp
.if n \{\
.RS 4
.\}
.nf
[cmdline]
frontend=pager

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

[custom]
frontend=browser
browser=mozilla
.fi
.if n \{\
.RE
.\}
.PP
Powyższy plik konfiguracyjny określa że w trybie linii poleceń domyślnym interfejsem jest "pager"\&. W trybie apt domyślnym interfejsem jest "xter\-pager", kopia wpisów zmian powinna zostać wysłana e\-mailem do użytkownika root, a apt\-listchanges powinien pytać o potwierdzenia kontynuowania\&. Jeśli apt\-listchanges zostanie uruchomiony z opcją \-\-profile=custom, to zostanie użyty interfejs "browser", który uruchomi program mozilla\&.
.SH "ZMIENNE ŚRODOWISKOWE"
.PP
APT_LISTCHANGES_FRONTEND
.RS 4
Używany interfejs\&.
.RE
.PP
APT_LISTCHANGES_USER, SUDO_USER, USERNAME
.RS 4
Wartość pierwszej istniejącej spośród wyżej wymienionych zmiennych zostanie użyta jako nazwa użytkownika, na którego
\fBapt\-listchanges\fR, jeśli zostało uruchomione z uprawnieniami administratora, przełączy się podczas wykonywania poleceń uruchamianych przez interfejsy "browser", "xterm\-browser" oraz "xterm\-pager"\&.
.RE
.PP
DEBIAN_FRONTEND
.RS 4
Jeśli jest ustawiona na "noninteractive", to wymusza na
\fBapt\-listchanges\fR
użycie nieinteraktywnego interfejsu\&. Szczegóły można znaleźć w rozdziale "AUTOMATYCZNE NADPISYWANIE INTERFEJSU"\&.
.RE
.PP
BROWSER
.RS 4
Używana przez interfejs "browser", powinna być ustawiona na ścieżkę do polecenia pozwalającego wyświetlić URL file: lub plik HTML\&.
.RE
.PP
PAGER
.RS 4
Używana przez interfejs "pager"\&.
.RE
.PP
APT_HOOK_INFO_FD
.RS 4
Deskryptor pliku, z którego będą odczytane nazwy pakietów w trybie
\fB\-\-apt\fR\&. (Apt powinno ustawić tę zmienną na numer odpowiedniego deskryptora pliku)\&.
.RE
.SH "PLIKI"
.PP
/etc/apt/listchanges\&.conf
.RS 4
Plik konfiguracyjny\&.
.RE
.PP
/etc/apt/apt\&.conf\&.d/20listchanges
.RS 4
Plik używany do zarejestrowania programu apt\-listchanges w systemie apt\&.
.RE
.PP
/var/lib/apt/listchanges\&.db
.RS 4
Baza danych o wyświetlonych wersjach pakietów\&.
.RE
.SH "AUTOR"
.PP
apt\-listchanges napisał Matt Zimmerman <mdz@debian\&.org>
.PP
Obecnym opiekunem jest Robert Luberda <robert@debian\&.org>
.SH "ZOBACZ TAKŻE"
.PP
\fBsensible-pager\fR(1),
\fBsensible-browser\fR(1),
\fBapt-get\fR(8),
\fBaptitude\fR(8)
.SH "TŁUMACZENIE"
.PP
Robert Luberda <robert@debian\&.org>