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
 

Ä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.
  • 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.
  • Bunte Manpages anzeigen mit most und less
  • Shell-Tipps
    Erfahrene Linux-Nutzer schwören auf flexible Kommandozeilentools, mit denen sich manche Aufgabe schneller bewältigen lässt als in grafischen Programmen. Wir stellen die wichtigsten Anwendungen vor, um auch Einsteiger zu einem Ausflug in die Shell zu ermutigen.
  • Know-how für die Kommandozeile
    Erfahrene Linux-Nutzer schwören auf flexible Kommandozeilentools, mit denen sich manche Aufgabe schneller bewältigen lässt als in grafischen Programmen. Wir stellen die wichtigsten Anwendungen vor, um auch Einsteiger zu einem Ausflug in die Shell zu ermutigen.
Kommentare

Infos zur Publikation

LU 12/2014: ANONYM & SICHER

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

Mit der Zeitschrift LinuxUser sind Sie als Power-User, Shell-Guru oder Administrator im kleinen Unternehmen monatlich auf dem aktuelle Stand in Sachen Linux und Open Source.

Sie sind sich nicht sicher, ob die Themen Ihnen liegen? Im Probeabo erhalten Sie drei Ausgaben zum reduzierten Preis. Einzelhefte, Abonnements sowie digitale Ausgaben erwerben Sie ganz einfach in unserem Online-Shop.

NEU: DIGITALE AUSGABEN FÜR TABLET & SMARTPHONE

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

Tipp der Woche

Ubuntu 14.10 und VirtualBox
Ubuntu 14.10 und VirtualBox
Tim Schürmann, 08.11.2014 18:45, 0 Kommentare

Wer Ubuntu 14.10 in einer virtuellen Maschine unter VirtualBox startet, der landet unter Umständen in einem Fenster mit Grafikmüll. Zu einem korrekt ...

Aktuelle Fragen

Nach Ubdates alles weg ...
Maria Hänel, 15.11.2014 17:23, 4 Antworten
Ich brauche dringen eure Hilfe . Ich habe am wochenende ein paar Ubdates durch mein Notebook von...
Brother Drucker MFC-7420
helmut berger, 11.11.2014 12:40, 1 Antworten
Hallo, ich habe einen Drucker, brother MFC-7420. Bin erst seit einigen Tagen ubuntu 14.04-Nutzer...
Treiber für Drucker brother MFC-7420
helmut berger, 10.11.2014 16:05, 2 Antworten
Hallo, ich habe einen Drucker, brother MFC-7420. Bin erst seit einigen Tagen ubuntu12.14-Nutzer u...
Can't find X includes.
Roland Welcker, 05.11.2014 14:39, 1 Antworten
Diese Meldung erhalte ich beim Versuch, kdar zu installieren. OpenSuse 12.3. Gruß an alle Linuxf...
DVDs über einen geeigneten DLNA-Server schauen
GoaSkin , 03.11.2014 17:19, 0 Antworten
Mein DVD-Player wird fast nie genutzt. Darum möchte ich ihn eigentlich gerne abbauen. Dennoch wür...