An Ort und Stelle

Bleibt noch die Frage, was zu tun ist, damit andere Benutzer im System die Manpage mit dem Kommando man huhn lesen können. Kopieren Sie als Administrator die Datei huhn.1 an die richtige Stelle:

cp huhn.1 /usr/share/man/man1/

Wer nicht auf das tägliche Update der Manpage-Datenbank warten möchte, führt – ebenfalls als Administrator – den Befehl

mandb

aus. Praktisch: Sollte die Seite schwere syntaktische Fehler aufweisen, weist das mandb-Kommando darauf hin. Hat alles geklappt, sehen Sie hingegen eine Ausgabe wie z. B.:

…
4 man subdirectories contained newer manual pages.
27 manual pages were added.
0 stray cats were added.
0 old database entries were purged.

Text-Editor oder GUI?

Wer sich die Formatierungsbefehle nicht merken will, verwendet z. B. den grafischen Editor ManEdit (http://wolfpack.twu.net/ManEdit/). Mit Syntax-Highlighting, vorgefertigten Tags und einer Preview-Funktion wird das Doku-Schreiben zum Kinderspiel (Abbildung 4).

Eines ist allerdings sicher: Auch bei der Arbeit mit ManEdit lohnt es sich, mehr über die Hintergründe zur Manpage-Erstellung zu wissen – wer den Aufbau und die Funktionsweise von groff kennt, arbeitet auch mit dem GUI-Editor effektiver (hge).

Abbildung 4: Per Klick zur Manpage mit ManEdit.

Glossar

Optionen

Den meisten Programmen können Sie beim Aufruf neben dem Befehlsnamen weitere Informationen mitgeben. Dazu gehören u. a. ein oder mehrere Dateinamen der zu bearbeitenden Datei(en) und/oder Optionen (auch Parameter genannt), die Änderungen im Verhalten des Befehls bewirken.

apropos

Wer den genauen Namen eines Befehls nicht kennt, kann durch den Aufruf apropos <begriff> oder man -k <begriff> alle Kommandos auflisten, in deren Beschreibung <begriff> vorkommt. Die vorhandenen Manpages bzw. diese Kurzbeschreibungen der dritten Zeilen werden dazu in einer Datenbank verwaltet – auf den meisten Systemen ist ein täglicher Cron-Job dafür zuständig, die Einträge zu aktualisieren. Alternativ hilft nach dem Erstellen einer neuen Handbuchseite auch der Befehl mandb (als Administrator ausgeführt).

man -k

Wer den genauen Namen eines Befehls nicht kennt, kann durch den Aufruf apropos <begriff> oder man -k <begriff> alle Kommandos auflisten, in deren Beschreibung <begriff> vorkommt. Die vorhandenen Manpages bzw. diese Kurzbeschreibungen der dritten Zeilen werden dazu in einer Datenbank verwaltet – auf den meisten Systemen ist ein täglicher Cron-Job dafür zuständig, die Einträge zu aktualisieren. Alternativ hilft nach dem Erstellen einer neuen Handbuchseite auch der Befehl mandb (als Administrator ausgeführt).

LinuxCommunity kaufen

Einzelne Ausgabe
 
Abonnements
 
TABLET & SMARTPHONE APPS
Bald erhältlich
Get it on Google Play

Deutschland

Ähnliche Artikel

  • man und info
    Schnell eine Befehlsoption nachschauen, einfach stöbern, was ein Kommando sonst noch alles kann, oder ausführliche Hilfetexte lesen mit Querverweisen – mit man und info bleiben Sie im Bilde.
  • Shell-Tipps
    Erfahrene Linux-Nutzer schwören auf flexible Kommandozeilentools, mit denen sie manche Aufgabe schneller bewältigen als in grafischen Programmen. Wir stellen interessante Anwendungen und Aufrufparameter vor, um auch Einsteiger zu einem Ausflug in die Shell zu ermutigen.
  • Zu Befehl
    Auch wenn viele Dinge sich bequem über grafische Oberflächen wie KDE oder GNOME regeln lassen – wer sein Linux-System richtig ausreizen möchte, kommt um die Kommandozeile nicht herum. Und auch sonst gibt es viele Situationen, wo es gut ist, sich im Befehlszeilendschungel ein wenig auszukennen.
  • Kein Kauderwelsch
    Mit Po4a haben Sie alle notwendigen Werkzeuge an der Hand, um Dokumentationen an eine Landessprache anzupassen.
  • Bunte Manpages anzeigen mit most und less
Kommentare

Infos zur Publikation

LU 04/2017: SPEZIAL-DISTRIBUTIONEN

Digitale Ausgabe: Preis € 5,95
(inkl. 19% MwSt.)

LinuxUser erscheint monatlich und kostet 5,95 Euro (mit DVD 8,50 Euro). Weitere Infos zum Heft finden Sie auf der Homepage.

Das Jahresabo kostet ab 86,70 Euro. Details dazu finden Sie im Computec-Shop. Im Probeabo erhalten Sie zudem drei Ausgaben zum reduzierten Preis.

Bei Google Play finden Sie digitale Ausgaben für Tablet & Smartphone.

HINWEIS ZU PAYPAL: Die Zahlung ist ohne eigenes Paypal-Konto ganz einfach per Kreditkarte oder Lastschrift möglich!

Aktuelle Fragen

WLAN lässt sich nicht einrichten
Werner Hahn, 21.03.2017 14:16, 0 Antworten
Dell Latitude E6510, Ubuntu 16.4, Kabelbox von Telecolumbus. Nach Anklicken des Doppelpfeiles (o...
"Mit Gwenview importieren" funktioniert seit openSuse 42.2 nicht mehr
Wimpy *, 20.03.2017 13:34, 2 Antworten
Bisher konnte ich von Digitalkamera oder SD-Karte oder USB-Stick Fotos mit Gwenview importieren....
Ich habe eine awk Aufgabe und bekomme es nicht so Recht hin
Dennis Hamacher, 10.03.2017 18:27, 1 Antworten
Ich hoffe Ihr könnt mir dabei helfen oder mir zeigen wie der Befehl richtig geschrieben wird. Ich...
Unter Linux Open Suse Leap 42.1 einen Windows Boot/ ISO USB Stick erstellen...
Tim Koetsier, 07.03.2017 15:26, 1 Antworten
Hallo, weiß jemand wie ich oben genanntes Vorhaben in die Tat umsetzen kann ? Wäre echt dankba...
Druckertreiber installieren OpenSuse42.1
Tim Koetsier, 07.03.2017 15:22, 1 Antworten
hallo, kann mir BITTE jemand helfen ich verzweifel so langsam. Habe einen Super Toner von Canon...