.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "INSTALL-DOCS 8" .TH INSTALL-DOCS 8 "21 January 2024" "doc-base v0.11.2" Debian .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAZWA .IX Header "NAZWA" install-docs \- zarządzanie dokumentacją Debiana .SH SKŁADNIA .IX Header "SKŁADNIA" .Vb 1 \& install\-docs [opcje] \-i,\-\-install | \-r,\-\-remove | \-c,\-\-check plik [ plik ... ] \& \& install\-docs [opcje] \-I,\-\-install\-all | \-C,\-\-install\-changed | \-R,\-\-remove\-all \& \& install\-docs [opcje] \-s,\-\-status docid [ docid ... ] \& \& install\-docs [opcje] \-\-dump\-db nazwa_db \& \& install\-docs \-h,\-\-help | \-V,\-\-version .Ve .SH OPIS .IX Header "OPIS" \&\fBinstall-docs\fR jest narzędziem pozwalającym opiekunom pakietów Debiana na rejestrowanie dokumentacji w różnych systemach. Obecnie wspiera przeglądarki \fBdhelp\fR, \fBdwww\fR, \fBdochelp\fR oraz \fBdoc-central\fR. .PP Ta strona podręcznika ekranowego zawiera podstawowe wskazówki dotyczące używania \fBinstall-docs\fR. Pełny opis programu wraz z opisem składni składni pliku konfiguracyjnego można znaleźć w dokumentacji dołączonej do pakietu. .SH OPCJE .IX Header "OPCJE" .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Tryb gadatliwy. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Wyświetla komunikaty diagnostyczne. .IP \fB\-\-no\-update\-menus\fR 4 .IX Item "--no-update-menus" Nie uruchamia \fBdwww\-build\-menu\fR\|(8) ani \fBdhelp_parse\fR\|(8). .IP "\fB\-\-rootdir\fR \fIkatalog\fR" 4 .IX Item "--rootdir katalog" Ustawia główny katalog na \fIkatlaog\fR, zamiast używać `\fI/\fR'. Użyteczne i poprawne tylko w przypadku akcji \fB\-\-check\fR. .SH AKCJE .IX Header "AKCJE" Poniżej podano listę akcji obsługiwanych przez \fBinstall-docs\fR. Programowi można podać tylko jedną akcję. Ponadto akcja ta łącznie z jej argumentami musi być przekazana jako ostatnia opcja linii poleceń. .PP Każdy argument \fIplik\fR powinien być pełną ścieżką do pliku kontrolnego doc\-base(t.j. "/usr/share/doc\-base/jakiś_plik" lub "/etc/doc\-base/documents/jakiś_plik"), a każde \fIdocid\fR powinno być identyfikatorem dokumentu (Identyfikatory dokumentów są ustawiane w polu "Document" pliku kontrolnego i zazwyczaj są takie same jak nazwa pakietu). .PP Jeżeli \fIplik\fR lub jest równe "\fB\-\fR" (znak minusa), to lista argumentów jest odczytywana ze standardowego wejścia (każda nazwa pliku lub każde id dokumentu w oddzielnej linii). .IP "\fB\-i\fR \fIplik\fR [\fIplik\fR ...], \fB\-\-install\fR \fIplik\fR [\fIplik\fR ...]" 4 .IX Item "-i plik [plik ...], --install plik [plik ...]" Instaluje dokumentację wymienioną w pliku kontrolnym \fIplik\fR. .IP "\fB\-r\fR \fIplik\fR [\fIplik\fR ...], \fB\-\-remove\fR \fIplik\fR [\fIplik\fR ...]" 4 .IX Item "-r plik [plik ...], --remove plik [plik ...]" Wyrejestrowuje dokumentację wymienioną w pliku kontrolnym \fIplik\fR. .IP "\fB\-c\fR \fIplik\fR [\fIplik\fR ...], \fB\-\-check\fR \fIplik\fR [\fIplik\fR ...]" 4 .IX Item "-c plik [plik ...], --check plik [plik ...]" Sprawdza poprawność pliku kontrolnego \fIplik\fR i wyświetla listę znalezionych problemów. Użyta z opcją \fI\-\-verbose\fR podaje lokalizacje błędów i ostrzeżeń. Jeśli podano także \fI\-\-rootdir\fR, to argument tej opcji zostanie dołączony do nazw plików wymienionych w polach "Files" i "Index" \fIplik\fRu. .IP "\fB\-R\fR, \fB\-\-remove\-all\fR" 4 .IX Item "-R, --remove-all" Wyrejestrowuje wszystkie zarejestrowane dokumenty. .IP "\fB\-I\fR, \fB\-\-install\-all\fR" 4 .IX Item "-I, --install-all" (Ponownie) rejestruje wszystkie dokumenty z katalogów \fI/usr/share/doc\-base\fR i \fI/etc/doc\-base/documents\fR. .IP "\fB\-C\fR, \fB\-\-install\-changed\fR" 4 .IX Item "-C, --install-changed" Porównuje zawartość katalogów \fI/usr/share/doc\-base\fR i \fI/etc/doc\-base/documents\fR z bazą danych zarejestrowanych dokumentów i wyrejestrowuje usunięte pliki oraz (ponownie) rejestruje pliki zmienione lub dodane. .IP "\fB\-s\fR \fIdocid\fR [\fIdocid\fR ...], \fB\-\-status\fR \fIdocid\fR [\fIdocid\fR ...]" 4 .IX Item "-s docid [docid ...], --status docid [docid ...]" Wyświetla stan dokumentu określonego przez \fIdocid\fR. .IP "\fB\-L\fR \fIdocid\fR [\fIdocid\fR ...], \fB\-\-listfiles\fR \fIdocid\fR [\fIdocid\fR ...]" 4 .IX Item "-L docid [docid ...], --listfiles docid [docid ...]" Opcja przestarzała. Nie robi nic. .IP "\fB\-\-dump\-db\fR \fInazwa_db\fR" 4 .IX Item "--dump-db nazwa_db" Wypisuje \- w celu debugowania programu \- zawartość wewnętrznych baz danych. \fInazwa_db\fR może być albo \fBfiles.db\fR, albo \fBstatus.db\fR. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Wyświetla krótki komunikat pomocy. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Wyświetla informacje o wersji programu. .SH "KOMPATYBILNOŚĆ Z POPRZEDNIMI WERSJAMI" .IX Header "KOMPATYBILNOŚĆ Z POPRZEDNIMI WERSJAMI" Następujące właściwości zostały dodane w wersji 0.8.4 programu, opiekunowie pakietów powinni dodać odpowiednie linie "\fIConflicts\fR" lub "\fIDepends\fR", jeśli planują ich używać w skryptach pakietów: .IP \(bu 4 obsługa wielu argumentów akcji \fB\-i\fR oraz \fB\-r\fR, .IP \(bu 4 czytanie argumentów ze standardowego wejścia, .IP \(bu 4 akcje \fB\-I\fR, \fB\-\-install\-all\fR, \fB\-R\fR, \fB\-\-\-remove\-all\fR, \fB\-c\fR, \fB\-\-check\fR, .IP \(bu 4 opcje \fB\-d\fR, \fB\-\-debug\fR, \fB\-h\fR, \fB\-\-help\fR. .PP Opcje \fB\-C\fR, \fB\-\-install\-changed\fR, \fB\-\-dump\-db\fR, \fB\-V\fR, \fB\-\-version\fR zostały dodane w wersji 0.8.12. .SH PLIKI .IX Header "PLIKI" .IP \fI/usr/share/doc\-base/\fR 4 .IX Item "/usr/share/doc-base/" Lokalizacja plików kontrolnych doc-base dostarczanych przez pakiety. .IP \fI/etc/doc\-base/documents/\fR 4 .IX Item "/etc/doc-base/documents/" Lokalizacja plików kontrolnych doc-base dostarczanych przez lokalnego administratora. .IP \fI/var/lib/doc\-base/info/documents/\fR 4 .IX Item "/var/lib/doc-base/info/documents/" Lokalizacja zarejestrowanych plików kontrolnych. .IP \fI/var/lib/doc\-base/info/status.db\fR 4 .IX Item "/var/lib/doc-base/info/status.db" Stany zarejestrowanych dokumentów. .IP \fI/var/lib/doc\-base/info/files.db\fR 4 .IX Item "/var/lib/doc-base/info/files.db" Znaczniku czasowe i identyfikatory zarejestrowanych plików doc-base. .SH BŁĘDY .IX Header "BŁĘDY" Patrz . .SH "ZOBACZ TAKŻE" .IX Header "ZOBACZ TAKŻE" \&\fBdhelp\fR\|(1), \fBdoccentral\fR\|(1), \fBdochelp\fR\|(1), \fBdwww\fR\|(7), Podręcznik doc-base \fI/usr/share/doc/doc\-base/doc\-base.html/index.html\fR .SH AUTOR .IX Header "AUTOR" Program napisał Christian Schwarz dla systemu Debian GNU/Linux; kolejnym opiekunem był Adam Di Carlo . Robert Luberda zajmuje się nim obecnie i go rozszerza o nowe funkcjonalności. .PP Ten program został napisany dla pożytku całej społeczności użytkowników i opiekunów Debiana. Aby zaangażować się w rozwój programu, prosimy dołączyć do listy dyskusyjnej .