.\" -*- 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 NAME install\-docs \- Debian\-Dokumentation online verwalten .SH ÜBERSICHT .IX Header "ÜBERSICHT" .Vb 1 \& install\-docs [Optionen] \-i,\-\-install | \-r,\-\-remove | \-c,\-\-check Datei [ Datei ... ] \& \& install\-docs [Optionen] \-I,\-\-install\-all | \-C,\-\-install\-changed | \-R,\-\-remove\-all \& \& install\-docs [Optionen] \-s,\-\-status docid [ docid ... ] \& \& install\-docs [Optionen] \-\-dump\-db dbname \& \& install\-docs \-h,\-\-help | \-V,\-\-version .Ve .SH BESCHREIBUNG .IX Header "BESCHREIBUNG" \&\fBinstall-docs\fR ist ein Werkzeug, das es Debian-Paketverwaltern erlaubt Dokumentationen in unterschiedlichen Dokumentationssystemen zu registrieren. Es unterstützt derzeit \fBdhelp\fR\-, \fBdwww\fR\-, \fBdochelp\fR\-, und \fBdoc-central\fR\-Browser. .PP Diese Handbuchseite stellt eine kurze Übersicht über den \fBinstall-docs\fR\-Aufruf zur Verfügung, einschließlich einer Beschreibung der Rechtschreibung und Grammatik der Steuerungsdatei. .SH OPTIONEN .IX Header "OPTIONEN" .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Mit detaillierter Ausgabe arbeiten. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Einige Fehlersuchinformationen ausgeben. .IP \fB\-\-no\-update\-menus\fR 4 .IX Item "--no-update-menus" Verhindern, dass \fBdwww\-build\-menu\fR\|(8) und \fBdhelp_parse\fR\|(8) ausgeführt werden. .IP "\fB\-\-rootdir\fR \fIVerz\fR" 4 .IX Item "--rootdir Verz" Setzt das Wurzelverzeichnis auf \fIVerz\fR anstelle von »\fI/\fR«. Hilfreich und gültig nur mit der \fB\-\-check\fR\-Aktion. .SH AKTIONEN .IX Header "AKTIONEN" Nachfolgend ist eine Liste mit möglichen Aktionen, die \fBinstall-docs\fR behandeln kann. Es kann dort nur eine Aktionsoption geben, die an install-docs übergeben wird, zudem muss die Aktion mit ihren Argumenten die letzte übergebene Option sein. .PP Jedes \fIDatei\fR\-Argument sollte den kompletten Pfad für die doc-base-Steuerungsdatei (z.B. »/usr/share/doc\-base/irgendeine_Datei«), und jedes \fIdocid\fR könnte einen Dokument-Bezeichner darstellen (Dokument-Bezeichner sind im »Document«\-Feld der Steuerungsdatei gesetzt und entsprechen üblicherweise dem Paketnamen.) .PP Wenn \fIDatei\fR oder \fIdocid\fR gleich »\fB\-\fR« sind (dem Minus-Zeichen), wird die Argumenteliste von der Standardeingabe gelesen (jeder Dateiname oder Dokument-ID in einer separaten Zeile). .IP "\fB\-i\fR \fIDatei\fR [\fIDatei\fR ...], \fB\-\-install\fR \fIDatei\fR [\fIDatei\fR ...]" 4 .IX Item "-i Datei [Datei ...], --install Datei [Datei ...]" Die Dokumentation installieren, die durch die Steuerungsdatei \fIDatei\fR beschrieben wird. .IP "\fB\-r\fR \fIDatei\fR [\fIDatei\fR ...], \fB\-\-remove\fR \fIDatei\fR [\fIDatei\fR ...]" 4 .IX Item "-r Datei [Datei ...], --remove Datei [Datei ...]" Die Dokumentation entfernen, die durch die Steuerungsdatei \fIDatei\fR beschrieben wird. .IP "\fB\-c\fR \fIDatei\fR [\fIDatei\fR ...], \fB\-\-check\fR \fIDatei\fR [\fIDatei\fR ...]" 4 .IX Item "-c Datei [Datei ...], --check Datei [Datei ...]" Die Steuerungsdatei \fIDatei\fR prüfen und die Anzahl gefundener möglicher Probleme anzeigen. Benutzen Sie es mit \fI\-\-verbose\fR, um die aktuellen Stellen von Fehlern und Warnungen zu erhalten. Wenn außerdem \fI\-\-rootdir\fR angegeben wurde und die »Files«\- und »Index«\-Felder von der \fIDatei\fR gegeben sind, werden seine Argumente den Namen der angegebenen Dateien vorangestellt. .IP "\fB\-R\fR, \fB\-\-remove\-all\fR" 4 .IX Item "-R, --remove-all" Alle registrierten Dokumente deregistrieren. .IP "\fB\-I\fR, \fB\-\-install\-all\fR" 4 .IX Item "-I, --install-all" (Wieder)registrieren aller Dokumente von \fI/usr/share/doc\-base\fR und \fI/etc/doc\-base/documents\fR. .IP "\fB\-C\fR, \fB\-\-install\-changed\fR" 4 .IX Item "-C, --install-changed" Inhalte von \fI/usr/share/doc\-base\fR\- und \fI/etc/doc\-base/documents\fR\-Verzeichnissen mit registrierter Dokumentendatenbank vergleichen und einige fehlende Dateien deregistrieren und nur geänderte oder neue Dateien (wieder) registrieren. .IP "\fB\-s\fR \fIdocid\fR [\fIdocid\fR ...], \fB\-\-status\fR \fIdocid\fR [\fIdocid\fR ...]" 4 .IX Item "-s docid [docid ...], --status docid [docid ...]" Zeigt den Status des Dokumentbezeichners \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 ...]" Missbilligte Option. Tut nichts. .IP "\fB\-\-dump\-db\fR \fIdbname\fR" 4 .IX Item "--dump-db dbname" Zu Fehlersuche-Zwecken einen Auszug des Inhalts interner Datenbanken erstellen. \fIdbname\fR kann entweder \fBfiles.db\fR oder \fBstatus.db\fR sein. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Ein kurze Hilfe-Nachricht anzeigen. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Versions-Information anzeigen. .SH KOMPATIBILITÄTSPROBLEME .IX Header "KOMPATIBILITÄTSPROBLEME" Die folgenden Funktionen wurden in Version 0.8.4 hinzugefügt; bitte stellen Sie sicher, dass ordentliche »\fIConflicts\fR«\- oder »\fIDepends\fR«\-Zeilen hinzugefügt werden, wenn Sie sie in Ihren Paket-Skripten benutzen möchten: .IP \(bu 4 Unterstützung, um mehr als ein Argument an die \fB\-i\fR\- und \fB\-r\fR\-Aktionen übergeben zu können, .IP \(bu 4 Argumente werden von Standardeingabe gelesen, .IP \(bu 4 \&\fB\-I\fR, \fB\-\-install\-all\fR, \fB\-R\fR, \fB\-\-\-remove\-all\fR, \fB\-c\fR, \fB\-\-check\fR Aktionen, .IP \(bu 4 Optionen \fB\-d\fR, \fB\-\-debug\fR, \fB\-h\fR, \fB\-\-help\fR. .PP Die Optionen \fB\-C\fR, \fB\-\-install\-changed\fR, \fB\-\-dump\-db\fR, \fB\-V\fR, \fB\-\-version\fR wurden in 0.8.12 hinzugefügt. .SH DATEIEN .IX Header "DATEIEN" .IP \fI/usr/share/doc\-base/\fR 4 .IX Item "/usr/share/doc-base/" Der Ort von doc-base-Steuerungsdateien wird von verschiedenen Paketen zur Verfügung gestellt. .IP \fI/etc/doc\-base/documents/\fR 4 .IX Item "/etc/doc-base/documents/" Der Ort von doc-base-Steuerungsdateien wird vom lokalen Administrator zur Verfügung gestellt. .IP \fI/var/lib/doc\-base/info/documents/\fR 4 .IX Item "/var/lib/doc-base/info/documents/" Der Ort von registrierten Steuerungsdateien. .IP \fI/var/lib/doc\-base/info/status.db\fR 4 .IX Item "/var/lib/doc-base/info/status.db" Status der registrierten Dokumente. .IP \fI/var/lib/doc\-base/info/files.db\fR 4 .IX Item "/var/lib/doc-base/info/files.db" Zeitstempel und Dokument-IDs von registrierten doc-base-Dateien. .SH FEHLER .IX Header "FEHLER" Lesen Sie . .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" \&\fBdhelp\fR\|(1), \fBdoccentral\fR\|(1), \fBdochelp\fR\|(1), \fBdwww\fR\|(7), Debian doc-base-Handbuch \fI/usr/share/doc/doc\-base/doc\-base.html/index.html\fR .SH AUTOR .IX Header "AUTOR" Dieses Programm wurde ursprünglich von Christian Schwarz für das Debian GNU/Linux\-System geschrieben und der nächste Betreuer war Adam Di Carlo . Robert Luberda betreut und erweitert es derzeit. .PP Diese Software war zum Nutzen sämtlicher Debian-Anwender und \-Entwickler gedacht. Wenn Sie daran interessiert sind, an dieser Software beteiligt zu werden, treten Sie bitte der Mailing-Liste bei.