.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29) .\" .\" 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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . 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 turned on, 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 "27 January 2016" "doc-base v0.10.7" "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, \fBdoc-central\fR oraz \fBscrollkeeper\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 \fIdwww\-build\-menu\fR\|(8), \fIdhelp_parse\fR\|(8), ani \&\fIscrollkeeper\-update\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. \*(L"/usr/share/doc\-base/jakiś_plik\*(R" lub \&\*(L"/etc/doc\-base/documents/jakiś_plik\*(R"), a każde \fIdocid\fR powinno być identyfikatorem dokumentu (Identyfikatory dokumentów są ustawiane w polu \&\*(L"Document\*(R" 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 \*(L"Files\*(R" i \*(L"Index\*(R" \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\*(L" lub \*(R"\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. .IP "\fI/var/lib/doc\-base/omf/\fR" 4 .IX Item "/var/lib/doc-base/omf/" Lokalizacja wygenerowanych plików \s-1OMF\s0 scrollkeepera. Uwaga: \&\fI/usr/share/omf/doc\-base\fR powinien być dowiązaniem symbolicznym wskazującym na ten katalog. .SH "BŁĘDY" .IX Header "BŁĘDY" Patrz . .SH "ZOBACZ TAKŻE" .IX Header "ZOBACZ TAKŻE" \&\fIdhelp\fR\|(1), \fIdoccentral\fR\|(1), \fIdwww\fR\|(7), \fIscrollkeeper\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 .