Für die meisten UNIX/Linux-Werkzeuge bestehen Informations- und
Hilfeseiten, auch genannt Info und Man(ual) Pages. Um in Erfahrung zu
bringen, ob diese überhaupt vorhanden und installiert sind, bieten sich
zunächst die beiden UNIX-Kommandos apropos
und whereis
(Paket
util-linux [Debian-Paket-util-linux]) an. Ebenso hilft Ihnen das
bereits mehrfach genutzte Werkzeug dlocate
[Debian-Paket-dlocate]
weiter.
Manpages aus deb
-Paketen, die noch nicht auf ihrem System installiert
sind, aber als lokale Datei vorliegen, zeigen Sie mit Hilfe von debman
und debmany
aus dem Paket debian-goodies
[Debian-Paket-debian-goodies] an. Liegt das Paket nicht lokal vor,
beziehen Sie es über zusätzliche Schalter oder stöbern in der
Manpages-Sammlung des Debian-Projekts [Debian-Manpages].
Mittels apropos
Paketname sehen Sie, ob zu dem von Ihnen angefragten
Programm lokal Dokumentation verfügbar ist. Für das Stichwort aptitude
sieht das bspw. wie folgt aus:
Verfügbare Manpages für das Paket aptitude mittels aptitude
lokalisieren.
$ apropos aptitude aptitude (8) - Benutzerschnittstelle für den Paketmanager aptitude-curses (8) - Benutzerschnittstelle für den Paketmanager aptitude-create-state-bundle (1) - bundle the current aptitude state aptitude-run-state-bundle (1) - unpack an aptitude state bundle and invoke aptitude on it $
Eine ähnliche Hilfe leistet auch das Kommando dlocate
mit dem Schalter
-man
gefolgt vom Paketnamen. Das Ergebnis des Aufrufs sieht für das
Programm aptitude
sieht wie folgt aus:
Verfügbare Manpages für das Paket aptitude mittels dlocate
aufspüren.
$ dlocate -man aptitude 8 aptitude-curses $
Nun können Sie die Manpage mittels man aptitude
bzw. man
aptitude-curses
aufrufen.
Benötigen Sie zusätzlich den exakten Pfad zur Datei, in der die Manpage
liegt, nutzen Sie stattdessen entweder whereis
mit dem Schalter -m
oder dlocate
mit dem Schalter -lsman
.
Verfügbare Manpages für das Paket aptitude mittels whereis
lokalisieren.
$ whereis -m aptitude aptitude: /usr/share/man/man8/aptitude.8.gz $
Bei letzterem erfahren Sie bspw. aus dem nachfolgenden Aufruf, dass die
Manpage für mehrere Sprachen wie bspw. Deutsch (de), Spanisch (es) und
Polnisch (pl) im Verzeichnis /usr/share/man
bereitsteht.
Verfügbare Manpages für das Paket aptitude mit vollständigem Pfad.
$ dlocate -lsman aptitude /usr/share/man/cs/man8/aptitude-curses.8.gz /usr/share/man/es/man8/aptitude-curses.8.gz /usr/share/man/ja/man8/aptitude-curses.8.gz /usr/share/man/fr/man8/aptitude-curses.8.gz /usr/share/man/gl/man8/aptitude-curses.8.gz /usr/share/man/fi/man8/aptitude-curses.8.gz /usr/share/man/man8/aptitude-curses.8.gz /usr/share/man/it/man8/aptitude-curses.8.gz /usr/share/man/pl/man8/aptitude-curses.8.gz /usr/share/man/de/man8/aptitude-curses.8.gz $
Benötigen Sie Hilfe zu einem Paket, welches Sie nicht installiert haben,
sind die beiden Werkzeuge debman
und debmany
aus dem Paket
debian-goodies [Debian-Paket-debian-goodies] für Sie nützlich.
debman
zeigt Ihnen nur die Manpages zu einem Paket an, welches nicht
installiert ist. Es unterstützt dabei diese beiden Schalter:
-f
Dateiname Name
Anzeigen der Manpage Name zu einem bereits lokal vorliegenden deb
-Paket Dateiname
Aufruf der Manpage chase zur lokal vorliegenden Datei chase_0.5.2-4_amd64.deb.
$ debman -f chase_0.5.2-4_amd64.deb chase
-p
Paketname Name
Herunterladen des Pakets Paketname mittels
debget
und Anzeigen der darin enthaltenen Manpage Name
Herunterladen des Pakets chase und Anzeigen der darin enthaltenen Manpage chase.
$ debman -p chase chase
Das Werkzeug debmany
funktionert etwas anders. Es sammelt Manpages
oder Dokumentation zu einem Paket zusammen, welches entweder bereits als
Paket installiert ist, sich noch in einem Repository befindet oder als
lokale deb
-Datei vorliegt. Es wertet dazu die Paketdatenbank aus.
Ergebnis ist ein Auswahlmenü wie in Abbildung 8.24, „Aufruf von debmany
für das Paket apt
“, über das Sie
die Betrachtung der gewünschten Dokumentation auswählen. Für das
Debianpaket apt sieht der vereinfachte Aufruf wie folgt aus:
Aufruf von debmany
für das Paket apt.
$ debmany apt
Wählen Sie einen Menüeintrag aus, öffnet sich ihr bevorzugtes
Anzeigeprogramm dafür. debmany
bietet Ihnen zudem mehrere Schalter
an, über die Sie dieses Anzeigeprogramm angeben können:
-g
.gz
-Dateien
unterstützen. Kurzform von -m 'gnome-open man:%s'
.
-k
.gz
-Dateien
unterstützen. Kurzform von -m 'kfmclient exec man:%s'
bzw. -m
'kfmclient exec %s'
für andere Dateien.
-m
Programm
.gz
-Dateien unterstützen.
-o
Programm
/usr/share/doc
.
-x
.gz
-Dateien
unterstützen. Kurzform von -m 'xdg-open man:%s'
. xdg-open
ist
Bestandteil des Pakets xdg-utils.
Weiterhin stehen diese Schalter zur Verfügung, über die Sie das
Verhalten von debmany
steuern können:
-L
Limit
-l
Sprachliste
de,fr
für deutsch- und
französischsprachige Manpages. Die Angabe de*
liefert alle Varianten,
bspw. de_DE
, de_AT
und de_CH
.
-z
Zur Darstellung des Auswahlmenüs wird Zenity benutzt (siehe
Abbildung 8.25, „Aufruf von debmany
für das Paket apt
mit Hilfe von Zenity“). Default ist whiptail
, alternativ dialog
oder curl
.
Sind Sie mit dem Webbrowser unterwegs und bevorzugen diese Darstellung,
greifen Sie darüber auf die Manpages-Sammlung des Debian-Projekts zurück
[Debian-Manpages]. Abbildung 8.26, „Suche in der Manpages-Sammlung nach htop
“ zeigt das Ergebnis der Recherche
nach htop
.
Über diesen Service recherchieren Sie in allen Veröffentlichungen von Debian sowie auch testing, unstable und experimental. Über die Auswahllisten legen Sie neben dem zu durchsuchenden Bereich das Ausgabeformat fest — hier HTML, PostScript, PDF oder Plaintext. Der Service ist noch nicht ganz vollständig, so dass derzeit noch nicht alle Manpages für die über das Menü offerierten Sprachen hinterlegt sind.