Aus Raspberry Pi Geek 06/2018

Dokumentation mit Man und Info lesen (Seite 2)

Die Tabelle “Man: Tastaturbefehle” zeigt einige nützliche Tastenkombinationen zum schnellen Navigieren innerhalb einer Manpage. Weitere Tastenkombinationen erhalten Sie, wenn Sie nach dem Start von Man [H] drücken. Einige interessante Optionen von Man fasst die Tabelle “Man: Nützliche Optionen” zusammen.

Man: Tastaturbefehle

Tasten

Funktion

[Q]

Anzeige verlassen

[Umschalt]+[**7**]

Suche vorwärts

[Umschalt]+[ß]

Suche rückwärts

[N]

Suche in gleicher Richtung wiederholen

[Umschalt]+[N]

Suche in umgekehrter Richtung wiederholen

[F]/Leertaste

Seite vorwärts

[B]

Seite rückwärts

[D]

halbe Seite vorwärts

[U]

halbe Seite rückwärts

[G]

Seitenanfang

[Umschalt]+[G]

Seitenende

Man: Nützliche Optionen

Aufruf

Beschreibung

man -k Begriff

Suche in den Handbuchseiten nach Begriff (statt apropos Begriff)

man -f Begriff

Übersicht über das Kommando Begriff (statt whatis Begriff)

man -a AbschnittBegriff

Anzeige der zugehörigen Handbuchseiten aus allen Abschnitten, bei mehreren Einträgen erfolgt die Anzeige nacheinander

man -L en Begriff

Anzeige der englischsprachigen Handbuchseite zum Begriff

man Abschnitt intro

Übersicht über den Abschnitt (1 bis 9) anzeigen

Handelt es sich beim gesuchten Begriff nicht um ein Kommando, sondern um eine Libc-Funktion, enthält der Bereich ÜBERSICHT die zugehörige Header-Datei sowie die entsprechenden Parameter der Funktion. Die bei den Kommandos aufgeführten Regeln gelten auch hier. Die Beschreibung der Parameter sowie eventuelle Besonderheiten finden sich in weiteren Bereichen der Manpage.

TIPP

Bei Man dürfen Sie den Abschnitt auch direkt hinter dem Schlüsselwort angeben, mit einem Punkt als Trennzeichen, also nach dem Schema man Begriff.Abschnitt. Außerdem unterstützen viele Distributionen eine Autovervollständigung des Suchbegriffs, samt optionaler Angabe des Abschnitts. Abbildung 2 zeigt die Eingabe von man open und man 3 open, jeweils gefolgt von einem Druck auf die Tabulatortaste. Im zweiten Fall erhalten Sie weniger Vorschläge, da Man nur im Abschnitt 3 sucht.

Abbildung 2: Bei der Eingabe des gesuchten Begriffs hilft die automatische Vervollständigung weiter.

Abbildung 2: Bei der Eingabe des gesuchten Begriffs hilft die automatische Vervollständigung weiter.

Info

Das Info-Dokumentationssystem, im Folgenden kurz Info genannt, zählt zu den festen Bestandteilen der Dokumentation auf Linux-Systemen. Es steht bei den meisten Desktop-Distributionen direkt nach der Installation bereit. Der Kasten “Debian und die Hilfe” beschreibt einige Besonderheiten dieser Distribution und ihrer Ableger.

Debian und die Hilfe

Bei Debian 9 “Stretch” gehört das Info-System nicht zur Standardinstallation, Sie müssen es bei Bedarf mittels sudo apt install info nachziehen. Des Weiteren unterliegen einige der Man- und Info-Seiten der GNU Free Documentation License (GFDL), die Debian nicht als freie Lizenz bewertet [2]. Das betrifft etwa die Seiten von Info selbst oder auch die des GNU-C-Compilers GCC. Beide stehen nur über die Zweige contrib und non-free bereit. Möchten Sie diese Pakete installieren, erstellen Sie zunächst eine Sicherungskopie der Apt-Konfigurationsdatei /etc/apt/sources.list und fügen dann die beiden genannten Zweige in der Originaldatei hinzu (Abbildung 3). Anschließend installieren Sie die noch fehlenden Seiten mit den Befehlen aus Listing 3.

Abbildung 3: Einige Info-Seiten gibt es bei Debian nur in den Repo-Zweigen »contrib« und »non-free«.

Abbildung 3: Einige Info-Seiten gibt es bei Debian nur in den Repo-Zweigen »contrib« und »non-free«.

Listing 3

 

$ sudo apt-update
$ sudo apt-get install gcc-6-doc
$ sudo apt-get install texinfo-doc-nonfree

Die Info-Seiten basieren auf einem Hypertext-Format namens Texinfo, das ähnlich wie HTML ein Verlinken der Seiten erlaubt. Eine einzelne Seite heißt hier Knoten, englisch Node. Die Anzeige der Seiten erfolgt entweder mit dem eigenständigen Programm Info im Terminal oder innerhalb des Texteditors Emacs. Bei Letzterem erhalten Sie die Info-Seiten mit [Alt]+[X] oder [Strg]+[H],[I].

Der Aufruf des eigenständigen Leseprogramms erfolgt nach dem Schema info OptionEintrag. Der Parameter Eintrag enthält entweder das gesuchte Schlüsselwort oder den Bereich, den Sie einsehen möchten. Dabei können Sie auch Unterbereiche angeben. Der Aufruf von Info ohne Parameter bringt Sie in ein Hauptmenü, das die vorhandenen Themen anzeigt.

Die Navigation innerhalb der Seiten erfolgt auf eine für Nicht-Emacs-Benutzer ein wenig gewöhnungsbedürftige Weise. Je nach Distribution bringen die Tastenkombination [Umschalt]+[H] oder [Umschalt]+[ß] eine ellenlange Liste der Tastenbelegungen auf den Bildschirm. Die meisten davon benötigen Sie jedoch für den täglichen Gebrauch nicht. Die typischen Navigationstasten funktionieren wie erwartet; die Tabelle “Info: Navigation” fasst eine Handvoll weiterer wichtiger Tasten und Tastenkombinationen zusammen.

Info: Navigation

Tasten

Funktion

[H]

Anzeige der Hilfe zur Tastenbelegung

[Tab]

Cursor auf nächsten Knoteneintrag

[Eingabe]

Knoten unter Cursor öffnen

[T]

Top des aktuellen Dokuments

[N]

nächster Knoten im aktuellen Level

[P]

vorheriger Knoten im aktuellen Level

[U]

übergeordneten Knoten öffnen

[S] oder [/]

Suche vorwärts

[AltGr]+[**0**]

nächstes Vorkommen

[AltGr]+[**7**]

vorheriges Vorkommen

[Leertaste]

Seite vor

[Entf]

Seite zurück

[G]

Info beenden

Tastenkürzel für mehrere Fenster

[Strg]+[X],[**2**]

neues Fenster mit gleichem Inhalt

[Strg]+[X],[**1**]

andere Fenster schließen

[Strg]+[X],[**0**]

aktuelles Fenster schließen

[Strg]+[X],[O]

in nächstes Fenster wechseln

Das Info-System zeigt sich für Erweiterungen offen: Bringen nachträglich installierte Programmpakete entsprechende Info-Dateien mit, lassen diese sich ebenfalls ins System integrieren. Abbildung 4 zeigt das am Beispiel jener des On-Chip-Debuggers OpenOCD. Existiert zu einem Programm oder einem Paket nur eine entsprechende Manpage, zeigt Info diese an.

Abbildung 4: Nach der Installation von OpenOCD gibt es eine neue Info-Seite, die Sie mit »info openocd« aufrufen.

Abbildung 4: Nach der Installation von OpenOCD gibt es eine neue Info-Seite, die Sie mit »info openocd« aufrufen.

Die Eigenschaft des Info-Browsers, mit mehreren Fenstern zu arbeiten, erweist sich bei umfangreicheren Recherchen oder beim Stöbern in der Dokumentation als sehr hilfreich (Abbildung 5).

Abbildung 5: Der Info-Browser »info« ist in der Lage, mehr als ein Fenster zu öffnen, was die parallele Lektüre von Informationen ermöglicht.

Abbildung 5: Der Info-Browser »info« ist in der Lage, mehr als ein Fenster zu öffnen, was die parallele Lektüre von Informationen ermöglicht.

Fazit

Der Blick auf die Informationen in den Manpages und auf den Info-Seiten lohnt sich fast immer: Die hier gebotenen Informationen sind aktuell und übersichtlich. Viele Manpages liegen in deutscher Sprache vor, bei den Info-Seiten lieferten allerdings alle getesteten Distributionen ausschließlich englischsprachige Texte.

Man und Info verwenden einen unterschiedlichen Ansatz: Während sich Man schwerpunktmäßig an einem konkreten Sachverhalt orientiert, wie etwa einem Kommando, hangelt sich Info mehr an Themenbereichen entlang und liefert dazu umfangreiche Beschreibungen. Die Info-Seiten eignen sich also hervorragend für einen Leseabend. 

DIESEN ARTIKEL ALS PDF KAUFEN
EXPRESS-KAUF ALS PDFUmfang: 5 HeftseitenPreis €0,99
(inkl. 19% MwSt.)
RASPBERRY PI GEEK KAUFEN
EINZELNE AUSGABE Print-Ausgaben Digitale Ausgaben
ABONNEMENTS Print-Abos Digitales Abo
TABLET & SMARTPHONE APPS Raspberry Pi Geek bei Google Play Readly Logo
Nach oben