Linux / Befehl info: GNU-Dokumentation durchsuchen

info ist ein Befehl, um Info-Format-Handbücher von GNU-Programmen im Terminal zu lesen. Während man eher einem Referenzdokument ähnelt, das Sie Seite für Seite auf- und abwärts lesen, teilt info das Dokument in Einheiten, die Knoten genannt werden, und verlinkt sie mit Menüs und Querverweisen, sodass Sie darin wie in einem Buch navigieren können.

Für Programme mit umfangreicher Dokumentation wie GNU Coreutils bieten Info-Dokumente oft detailliertere Erklärungen zu Konzepten, der Interaktion von Optionen und Beispielen. Dieser Artikel erklärt, wie man Dokumente öffnet, zwischen Knoten und Menüs navigiert, im Text und Index sucht, direkt zu einem bestimmten Ort im Dokument geht und was zu tun ist, wenn das Dokument fehlt.

Was ist der info-Befehl?

info ist ein textbasierter Dokumentbetrachter, der Info-Dateien liest, die mit dem Texinfo-Dokumentationssystem erstellt wurden. Typischerweise werden Info-Dateien in Verzeichnissen wie /usr/share/info installiert, und ein einzelnes Handbuch ist in mehrere Knoten unterteilt, die eine hierarchische Struktur bilden.

Info-Dokumente können Menüs zum Navigieren zu Unterthemen, Querverweise, die auf andere Knoten oder Handbücher verweisen, und fachbezogene Register enthalten. Sie eignen sich nicht nur zum Lesen der erforderlichen Punkte in der Reihenfolge, sondern auch zum Nachverfolgen verwandter Erklärungen oder zum Nachschlagen von Begriffen im Register.

Grundlegende Syntax und wie man startet

Die grundlegende Syntax von GNU Info ist wie folgt. Eckige Klammern kennzeichnen optionale Elemente, und Auslassungspunkte bedeuten, dass mehrere Elemente angegeben werden können, sodass sie nicht im eigentlichen Befehl eingegeben werden.

info [options...] [manual] [menu-or-index-item...]

Wenn ohne Argumente ausgeführt, öffnet sich das oberste Verzeichnismenü, das die im System registrierten Info-Dokumente sammelt.

info

Der allgemeine Benutzungsleitfaden für info selbst und das detaillierte Handbuch des eigenständigen GNU Info können wie folgt geöffnet werden.

info info
info info-stnd

Wenn ein spezifischer Programmname angegeben wird, sucht es den entsprechenden Eintrag im obersten Verzeichnis und navigiert zu diesem Handbuch oder Knoten.

info ls
info coreutils

info ls kann auf den ls-bezogenen Knoten innerhalb des GNU Coreutils-Handbuchs verlinken, anstatt auf eine separate ls.info-Datei. Dies liegt daran, dass Einträge im obersten Verzeichnis direkt auf bestimmte Knoten innerhalb eines Handbuchs zeigen können.

Die Struktur von Info-Dokumenten verstehen

Beim ersten Ausführen kann es kompliziert erscheinen aufgrund von Begriffen, die sich von normalen Webseiten oder man unterscheiden. Das Verstehen der folgenden vier Konzepte erleichtert das Erfassen der Dokumentenstruktur.

Oben auf dem Bildschirm können die aktuellen Datei- und Knotennamen sowie Navigationsziele wie Next, Prev und Up angezeigt werden. In der unteren Modusleiste wird der Status, wie das aktuelle Handbuch, der Knoten und die Position innerhalb des Dokuments, angezeigt.

Tasten zur Bildschirmbewegung und Dokumentnavigation

Die folgende Tabelle basiert auf den Standardtasten des eigenständigen GNU Info. Einige Tasten können je nach Benutzereinstellungen oder der --vi-keys-Option abweichen.

Wenn Sie es zum ersten Mal verwenden, wird empfohlen, info info-stnd zu öffnen, H zu drücken, um die Grundtasten zu überprüfen, und das Dokument mit Space und Backspace zu lesen.

Wie man Menüs und Querverweise verfolgt

Auswählen von Elementen auf dem Bildschirm mit Tab und Enter

Wenn ein Menü oder ein Querverweis auf dem Bildschirm sichtbar ist, können Sie mit Tab zwischen den Elementen navigieren und mit Enter auswählen. Shift+Tab kehrt zum vorherigen Element zurück. Dies ist die intuitivste Navigationsmethode, wenn Sie die Dokumentstruktur noch nicht kennen.

Eingabe von Menünamen mit m

Drücken Sie m, um den Namen des Menüelements in den Eingabebereich am unteren Bildschirmrand einzugeben. Sie können dann einen Teil des Namens eingeben und Tab verwenden, um die vervollständigbaren Elemente zu überprüfen, sodass es einfach ist, sich schnell in einem langen Menü zu bewegen.

Nachdem Sie ein weiteres Dokument über das Menü gelesen haben, verwenden Sie l, um zur ursprünglichen Position zurückzukehren. Wenn Sie zu einem höheren Knoten in der Struktur wechseln möchten, sollten Sie u anstelle der Besuchshistorie verwenden.

Wie man nach dem gewünschten Inhalt im Dokument sucht

Text im Hauptteil suchen

Drücken Sie s oder / und geben Sie dann den Suchbegriff ein, um die Zeichenfolge in der aktuellen Info-Datei zu finden. Ein Suchbegriff ohne Großbuchstaben ist standardmäßig nicht case-sensitiv, und ein Suchbegriff mit Großbuchstaben ist case-sensitiv.

? sucht in die entgegengesetzte Richtung (rückwärts). Inkrementelle Suche, bei der Ergebnisse während der Eingabe angezeigt werden, verwendet Ctrl+s, und die umgekehrte inkrementelle Suche verwendet Ctrl+r.

Themen im Index finden

i sucht nach dem eingegebenen Begriff im Index des aktuellen Handbuchs und springt zu dem Knoten, auf den der erste passende Eintrag verweist. Dies kann schneller und genauer sein als die Suche im gesamten Text, wenn Sie nach Optionsnamen oder Konzepten in langen Handbüchern suchen.

I sammelt passende Indexeinträge in einem virtuellen Knoten zur Anzeige. Nach einer i-Suche führt das Drücken der Kommataste (,) zum nächsten passenden Indexeintrag.

Suche in allen installierten Info-Indizes

Wenn Sie nicht wissen, welches Handbuch die Erklärung enthält, verwenden Sie die Option -k oder --apropos in der Shell. Dies durchsucht die Indexe aller installierten Info-Dateien, daher kann es einige Zeit dauern, wenn viele Dokumente vorhanden sind.

info -k permissions
info --apropos='regular expression'

Direktes Springen zu einem bestimmten Handbuch und Knoten

Öffnen nach Handbuch- oder Programmnamen

Wenn Sie den Namen des Handbuchs kennen, können Sie ihn direkt angeben. Die gesamte GNU Coreutils-Dokumentation kann wie folgt geöffnet werden.

info coreutils

Wenn programmspezifische Einträge im Stammverzeichnis registriert sind, können Sie direkt zum entsprechenden Knoten innerhalb des Handbuchs nur mit dem Programmnamen gehen.

info ls
info cp
info date

Diese Befehle gehen davon aus, dass GNU Coreutils installiert ist und die Info-Verzeichniseinträge ordnungsgemäß registriert sind.

Angeben eines Knotennamens

Sie können den anfänglichen Knoten, der geöffnet werden soll, mit -n oder --node angeben. Knotennamen mit Leerzeichen sollten in Anführungszeichen gesetzt werden, damit sie als einzelnes Argument an die Shell übergeben werden.

info coreutils -n 'ls invocation'

Sie können auch das Info-Querreferenzformat (manual)node als einzelnes Argument angeben. Setzen Sie die gesamte Zeichenfolge in Anführungszeichen, damit Klammern und Leerzeichen von der Shell nicht interpretiert werden.

info '(coreutils)ls invocation'

Der Knotenname kann je nach installierter Dokumentversion variieren. Wenn Sie sich über den genauen Namen nicht sicher sind, ist es sicherer, zunächst info ls oder eine Indexsuche zu verwenden.

Knoten finden, die erklären, wie Befehle ausgeführt werden

-O, --show-options oder --usage finden Invocation-Knoten, die erklären, wie das angegebene Programm von der Befehlszeile aus ausgeführt wird.

info ls -O
info --show-options coreutils

Abhängig von der Dokumentationsstruktur finden Sie möglicherweise keinen geeigneten Invocation-Knoten. In diesem Fall öffnen Sie ihn mit info program und verwenden die i-Indexsuche.

Häufig verwendete Info-Optionen

Die untenstehenden Optionen basieren auf dem eigenständigen GNU Info. Für die vollständigen Optionen der installierten Version überprüfen Sie info --help oder info info-stnd.

Überprüft den Speicherort der Info-Datei und gibt Text aus.

Überprüfen Sie die tatsächlich ausgewählte Dokumentdatei.

-w gibt den Speicherort der Datei Info aus, ohne das Dokument zu öffnen. Dadurch können Sie prüfen, welches Dokument gelesen wird, wenn mehrere Dateien mit demselben Namen im Suchpfad vorhanden sind.

info -w coreutils

In Umgebungen, die alle passenden Dateipfade unterstützen, kann es zusammen mit --all verwendet werden.

info --all --where coreutils

Dokumente in eine Textdatei exportieren

Mit -o können Sie den Inhalt in eine Datei aufzeichnen, anstatt auf dem interaktiven Bildschirm anzuzeigen. Die gleichzeitige Verwendung von --subnodes gibt rekursiv die durch das Menü verknüpften Unterknoten aus.

info --subnodes -o coreutils.txt coreutils

Wenn Sie - als Ausgabedatei angeben, können Sie sie an die Standardausgabe senden, was die Verbindung mit anderen Befehlen erleichtert.

info -o - coreutils | less

Da das gesamte Handbuch sehr groß sein kann, sollte zuerst die Dateigröße und der benötigte Umfang bedacht werden. Wenn nur bestimmte Knoten benötigt werden, ist es effizient, -n zusammen zu verwenden.

Angeben von Benutzerdokumenten und Suchpfaden

Direktes Öffnen lokaler Info-Dateien

Info-Dateien im aktuellen Verzeichnis können durch Angabe eines relativen Pfads geöffnet werden. Wenn ein Schrägstrich im Pfad enthalten ist, wird die Datei an diesem Ort und nicht über den allgemeinen Suchpfad angesprochen.

info ./project.info
info -f ./project.info

Komprimierte Info-Dateien können ebenfalls direkt gelesen werden, wenn das Format von der Implementierung unterstützt wird.

Angeben zusätzlicher Suchverzeichnisse

Sie können Verzeichnisse hinzufügen, um nach Dokumenten mit -d zu suchen. Dies ist nützlich, um vorübergehend die Dokumentation von außerhalb des Systempfads installierten Tools zu öffnen.

info -d /opt/example/share/info example

Persistente Suchpfade können durch die Umgebungsvariable INFOPATH beeinflusst werden. Wenn Sie den Wert direkt setzen, kann sich die Einbeziehung der Standardpfade ändern, prüfen Sie daher zunächst den aktuellen Zustand und das Ergebnis von info -w manual.

printf '%s\n' "$INFOPATH"
info -w info-stnd

Unterschiede zwischen info und man

Sie müssen nicht nur eines von ihnen verwenden. Wenn Sie schnell die Bedeutung einer Option überprüfen möchten, sind man oder --help praktisch, und wenn Sie das Gesamtkonzept der GNU-Programme und die Beziehungen zwischen Optionen im Detail sehen möchten, ist info nützlich. Wählen Sie das geeignete Werkzeug abhängig vom Programm bereitgestellten Dokumentformat und dem Installationsstatus.

Wenn Info fehlt oder das Dokument nicht gefunden werden kann

Installation des Info-Programms

In minimalen Installationsumgebungen kann info fehlen. In den Debian/Ubuntu- und Fedora/Rocky-Linux-Familien lautet der Paketname in der Regel info.

sudo apt update
sudo apt install info

sudo dnf install info

Da die Paketnamen je nach Distributionsversion und Repository-Konfiguration variieren können, überprüfen Sie bei Nichtinstallation die Paketsuchergebnisse für diese Distribution.

Überprüfen Sie, ob die Info-Dokumentation eines bestimmten Programms installiert ist.

Selbst wenn die info ausführbare Datei existiert, ist das gewünschte Handbuch möglicherweise nicht installiert. Überprüfen Sie zuerst die Top-Level-Liste und die Suchergebnisse.

info
info -k 'program or topic'
info -w manual

Wenn Programm und Dokumentation in separaten Paketen bereitgestellt werden, suchen Sie das Dokumentationspaket für dieses Programm im Paketmanager der Distribution.

Wenn das Dokument nicht im Verzeichnis-Menü erscheint

Wenn die Datei existiert, aber nicht im obersten Verzeichnis registriert ist, können Sie sie öffnen, indem Sie den Pfad oder die Datei direkt angeben.

info -d /additional/document/path manual
info -f /full/path/manual.info

Wenn die Software direkt aus der Quelle installiert wurde, überprüfen Sie auch, ob der Installationsprozess die Info-Verzeichnisdateien aktualisiert hat. Bevor Sie die Systemdokumentationsregistrierung manuell ändern, prüfen Sie zuerst die Paket-Installationsaufzeichnungen und die Installationsanweisungen des Programms.

Praktische Reihenfolge der Verwendung

1. Überprüfen Sie, ob das relevante Dokument mit dem Programm info geöffnet wird.
2. Überprüfen Sie die aktuelle Tastenhilfe mit H und navigieren Sie die Struktur mit Space, n, p, u.
3. Wählen Sie die auf dem Bildschirm angezeigten Menüs mit Tab und Enter oder m aus.
4. Wenn Sie den genauen Begriff kennen, suchen Sie den Index mit i, und für allgemeine Phrasen suchen Sie den Text mit s oder /.
5. Wenn Sie nicht wissen, welches Handbuch Sie verwenden sollen, durchsuchen Sie den gesamten installierten Index in der Shell mit info -k keyword.
6. Wenn Sie einen Ort wiederholt anzeigen möchten, geben Sie den Knoten direkt mit -n an oder geben Sie den erforderlichen Inhalt mit -o aus.

Häufig gestellte Fragen

Wie beendet man info?

Drücken Sie q, um zu beenden. Wenn Sie die aktuellen Tasteneinstellungen nicht kennen, drücken Sie Großbuchstaben H, um die Schnellhilfe zu überprüfen.

Beim Drücken von n wird zu einem anderen Dokument gewechselt, anstatt zu den Suchergebnissen

In den Standard-Tasteneinstellungen wechselt n zum Next-Knoten des aktuellen Knotens, nicht zu den Suchergebnissen. Verwenden Sie s oder / für die Textsuche und i für die Indexsuche. Die Tastenzuordnungen können sich ändern, wenn Sie --vi-keys verwenden.

Was ist der Unterschied zwischen info ls und info coreutils?

info ls findet den ls-Eintrag im obersten Verzeichnis und geht direkt zum zugehörigen Knoten, während info coreutils den Startort des Coreutils-Handbuchs öffnet. Abhängig von den installierten Verzeichniseinträgen und der Dokumentversion kann der tatsächliche Startknoten unterschiedlich sein.

Haben alle Befehle Info-Dokumente?

Nein. Info wird im GNU-Projekt weit verbreitet verwendet, aber nicht alle Linux-Programme stellen Info-Dokumente bereit. Wenn kein Info-Dokument vorhanden ist, überprüfen Sie man command, command --help oder die offizielle Dokumentation des Programms.

Sind Info-Dokumente immer genauer als man-Handbücher?

Das ist nicht immer der Fall. Jedes Projekt hat unterschiedliche Referenzdokumente und Aktualisierungsmethoden. Einige Projekte, wie GNU Coreutils, stellen das Info-Handbuch als detailliertes Referenzdokument bereit, während andere Programme Manpages oder Webdokumente priorisieren können. Es wird empfohlen, sowohl die aktuell installierte Programmversion als auch die offizielle Projektdokumentation zu überprüfen.

Zusammenfassung

info ermöglicht es Ihnen, die langen Handbücher von GNU-Programmen über Knoten, Menüs, Querverweise und Indizes zu navigieren. Anfangs können Sie den Großteil der Dokumentation lesen, indem Sie nur info program, H, Space, n, p, u, i und q lernen.

Es ist effizient, schnell die einfache Syntax und Optionen mit --help oder man zu überprüfen, und info für Hintergrundkonzepte und Beispiele bei Bedarf zu verwenden. Wenn Sie sich andere grundlegende Befehle ansehen möchten, können Sie Liste und Übersicht der Linux-Befehle konsultieren.

Verweisen Sie auf offizielle Dokumente

• GNU Stand-alone Info Offizielles Handbuch
• Wie man GNU Info ausführt und die Optionen
• GNU Coreutils Offizielles Handbuch
• Debian Info-Paketinformationen
• Fedora Info-Paketinformationen