INSTALL-INFO

install-info - Erzeuge oder aktualisiere Einträge im Info Verzeichnis

install-info [--version] [--help] [--debug] [--maxwidth=nnn] [--section Regexp Titel] [--infodir=xxx] [--align=nnn] [--quiet] [--menuentry=xxx] [--description=xxx] [--remove|--remove-exactly] [--] Dateiname

install-info erstellt, aktualisiert oder entfernt Einträge im Info Verzeichnis, der Datei dir. Wenn beim Aktualisieren oder Erzeugen von Einträgen keine Beschreibung auf der Kommandozeile oder in der Info Datei angegeben ist, versucht es eine Beschreibung aus dem Inhalt der Datei zu raten.

Siehe die Beschreibung der Option --section zu Details wo der Eintrag platziert wird und einer Beschreibung des erwarteten Formats der Datei dir.

OPTIONEN

[--] Dateiname

Gibt den Dateinamen der Info Datei an, deren Menüeintrag erzeugt, aktualisiert oder entfernt werden soll. Wenn --remove-exactly angegeben ist, sollte Dateiname der genaue zu entfernende Eintragname sei (d.h. »emacs-20/emacs« oder »gcc«), ansonsten wird der Basisname dieses Dateinamens als der Referent des erzeugten Menüeintrags benutzt, außer wenn es einen nichtig machenden START-INFO-DIR Eintrag in der gegebenen Datei gibt. Diese Datei muss daher in demselben Verzeichnis wie die Datei dir (siehe die Option --infodir) existieren (oder im Begriff sein installiert zu werden, oder vorher existiert haben beim Entfernen eines Eintrags).

Wenn Dateiname auf .gz endet wird es als Verweis auf eine mit gzip komprimierte Datei genommen; wenn sie nicht existiert, aber eine entsprechende Dateiname.gz, wird stattdessen letztere benutzt.

Beim Hinzufügen oder Aktualisieren von Einträgen muss die Datei an dem angegebenen Pfad existieren (möglicherweise mit einem zusätzlichen .gz Suffix).

--remove

Gibt an, dass der Eintrag für Dateiname entfernt werden soll; per Voreinstellung werden Einträge erzeugt oder aktualisiert.

Wenn das Entfernen verursacht, dass ein Abschnitt leer wird, werden die Überschrift des Abschnitts (und die überflüssige Leerzeile) ebenfalls entfernt, außer wenn dies der letzte Abschnitt in der Datei ist oder --keep-old angegeben wurde. Siehe die Option --section für Details über das erwartete Format der Datei dir.

Wenn es mehrere passende Einträge in dir gibt, werden nur die in der ersten passenden zusammenhängenden Gruppe entfernt, die anderen still ignoriert.

Es ist kein Fehler, wenn kein passender Eintrag gefunden wird, jedoch gibt install-info eine Warnung aus, außer wenn die Option --quiet angegeben wurde.

Wenn --remove angegeben wird, werden die Formatierungsoptionen --maxwidth, --align und --calign still ignoriert.

--remove-exactly

Diese Option ist essenziell dieselbe wie --remove, außer dass Dateiname als exakt der zu entfernende Eintrag genommen wird, statt des Namens einer existierenden Datei. Dies kann wichtig sein, wenn man versucht Einträge zu entfernen, die auf Infodateien in Unterverzeichnissen verweisen (d.h. »emacs-20/emacs«), weil --remove mit dem Basisnamen des angegebenen Dateinamen arbeitet, statt mit dem exakten angegebenen Namen. (d.h. »--remove emacs-20/emacs« würde install-info veranlassen nach »emacs« zu suchen, nicht »emacs-20/emacs«).

--section Regexp Titel

Gibt an dass, wenn ein neuer Eintrag gemacht werden soll, dieser in einem Abschnitt der Datei dir platziert werden soll, dessen Titel auf Regexp passt. Wenn ein solcher Abschnitt nicht existiert, wird einer als der vorletzte in der Datei (siehe unten) mit dem Titel Titel erzeugt. Ein Abschnit ist ein durch Leerzeilen begrenzter Teil des Menüs dir; von der ersten Zeile wird angenommen, dass sie der Titel ist.

Wenn ein neuer Eintrag erzeugt werden soll, versucht install-info ihn innerhalb des Abschnittes entsprechend alphabetischer Ordnung einzufügen; wenn die Einträge des Abschnittes noch nicht sortiert sind, ist der neue Ort innerhalb des Abschnittes unvorhersagbar. Die Reihenfolge existierender Einträge wird nicht verändert.

Per Voreinstellung werden neue Einträge ans Ende der Datei angehängt. Der letzte Abschnitt (selbst wenn er nur aus der Titelzeile besteht) sollte immer existieren, um sicherzustellen dass neue Einträge am richtigen Ort erzeugt werden. Der letzte Abschnitt sollte so betitelt sein, dass es die Tatsache wiederspiegelt, dass Infodateien, für die die Platzierung nicht näher angegeben, an ihn angehängt werden.

Wenn es bereits einen Eintrag für die zu installierende Infodatei gibt, wird dieser in situ durch den neuen Eintrag ersetzt.

Wenn beim Entfernen eines Eintrags ein Abschnitt angegeben wird, wird der Abschnitt ignoriert und eine Warnung ausgegeben.

Wenn beim Hinzufügen eines Eintrags ein Abschnitt angefordert wird, aber die Datei enthält gar keine Abschnittsüberschriften, erzeugt install-info sowohl den angeforderten wie auch einen Abschnitt für Verschiedenes am Ende der Datei.

--infodir=Infoverzeichnis

Gibt an, dass die Datei dir im Verzeichnis Infoverzeichnis platziert ist und die installierte Kopie der neuen Infodatei dort platziert war, ist oder sein wird. Die Voreinstellung ist /usr/info.

--align=nnn [veraltet]

Gibt an, dass die erste Zeile der Beschreibung mindestens nnn Zeichen eingerückt sein sollte; zusätzliche Leerzeichen werden hinzugefügt, falls benötigt. Wegen der Länge der dir-Menüeintragseinzelheiten kann es mehr ausgeglichen sein. Die Voreinstellung ist 27.

--calign=nnn [veraltet]

Gibt an, dass die zweite und folgende Zeilen der Beschreibung mindestens nnn Zeichen eingerückt sein sollten. Voreinstellung ist 29.

--maxwidth=nnn [veraltet]

Gibt an, dass die maximale Breite für die Infodatei nnn Zeichen ist. Dies wird beim wortweisen Umbrechen des beschreibenden Text benutzt. Voreinstellung ist 79.

--quiet

Unterdrückt die gewöhnliche Anzeige des neuen Menüeintrags bevor er eingefügt wird und von Nachrichten, die das Ersetzen und Entfernen existierender Einträge und das Erzeugen und Löschen von Abschnitten ankündigen.

--help

Lässt install-info seine Benutzungsinformation anzeigen und sich beenden.

--version

Lässt install-info seine Version und Copyright-Information anzeigen und sich beenden.

--description=xxx

Gibt die nach dem Menü-Eintrag in neuen oder aktualisierten Einträgen zu benutzende Beschreibung xxx an. Voreinstellung ist den in der Infodatei selbst angegebenen Wert zu benutzen; dieser wird gefunden indem ein Abschnitt folgender Form gesucht wird:
START-INFO-DIR-ENTRY
* Auto-PGP: (auto-pgp). PGP under GNU Emacs.
END-INFO-DIR-ENTRY

Wenn sich der in der Infodatei gefundene Eintrag über mehrere Zeilen erstreckt, von denen jede einen Menü-Eintrag ergibt, wird der in der Datei gefundene Text wörtlich genommen. In diesem Fall wird das alphabetische Sortierschema deaktiviert, und die Einträge werden am Anfang des fraglichen Abschnitts eingefügt. In diesem Fall werden die Optionen --menuentry, --maxwidth, --align, --calign und --menuentry ignoriert.

Wenn es in der Datei keinen dir-Eintrag in der Datei gibt, versucht das Programm am Anfang der Datei einen Absatz zu finden, der mit this file documents beginnt. Es macht aus dem ersten Zeichen des Folgenden einen Großbuchstaben und benutzt das.

Es ist ein Fehler, wenn keine dieser Methoden eine Beschreibung ergibt.

Wenn eine Beschreibung gegeben wird, wenn --remove angegeben ist, wird diese ignoriert und eine Warnung ausgegeben.

--menuentry=xxx

Gibt an, dass der Eintrag im Menü xxx sein soll. Voreinstellung ist es, den in der Info-Datei selbst angegebenen Wert zu benutzen. Falls dieser nicht vorhanden ist, wird der Basisname der Info-Datei benutzt (jegliches .info wird gelöscht, und der Eintrag wird in gemischte Groß-Klein-Schreibung überführt). Für Details über das erwartete Format des Menüeintrags in der Info-Datei siehe oben.

Beim Entfernen von Einträgen muss der Wert der Option --menuentry auf das tatsächliche Menüeintragsfeld in dem zu entfernenden Menüpunkt passen (Groß-Klein-Schreibung irrelevant). Wenn --menuentry ausgelassen wird, wird keine Prüfung des Menüeintrags vorgenommen.

--keep-old

Verhindert die Ersetzung existierender Einträge und das Entfernen leerer Abschnitte.

Wenn die zu installierende Datei bereits einen Eintrag im Verzeichnis hat, bleibt der alte Eintrag unangetastet anstatt ersetzt zu werden; Voreinstellung ist es jeglichen alten gefundenen Eintrag mit dem neu erzeugten zu überschreiben.

Wenn --remove angegeben ist, verhindert --keep-old das Entfernen der Abschnittsüberschrift, was sonst passieren würde, wenn der Abschnitt durch das Entfernen leer würde.

--test

Aktiviert den Testmodus, was das Aktualisieren der Verzeichnis-Datei verhindert.

--debug

Aktiviert den Fehlersuche-Modus, bei dem die Ergebnisse einiger interner Bearbeitungsschritte angezeigt werden.

emacs(1), info(1), gzip(1)

Copyright 1994, Ian Jackson. install-info ist Freie Software; siehe die GNU General Public Licence Version 2 oder später für Kopierbedingungen. Es gibt keine Garantie.

Übersetzung dieser Manpage von Florian »eix« Rehnisch, 2007-Feb-10.

###