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 11/2014: VIDEOS BEARBEITEN

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

Schnell Multi-Boot-Medien mit MultiCD erstellen
Schnell Multi-Boot-Medien mit MultiCD erstellen
Tim Schürmann, 24.06.2014 12:40, 0 Kommentare

Wer mehrere nützliche Live-Systeme auf eine DVD brennen möchte, kommt mit den Startmedienerstellern der Distributionen nicht besonders weit: Diese ...

Aktuelle Fragen

WLAN-Signalqualität vom Treiber abhängig
GoaSkin , 29.10.2014 14:16, 0 Antworten
Hallo, für einen WLAN-Stick mit Ralink 2870 Chipsatz gibt es einen Treiber von Ralink sowie (m...
Artikelsuche
Erwin Ruitenberg, 09.10.2014 07:51, 1 Antworten
Ich habe seit einige Jahre ein Dugisub LinuxUser. Dann weiß ich das irgendwann ein bestimmtes Art...
Windows 8 startet nur mit externer Festplatte
Anne La, 10.09.2014 17:25, 6 Antworten
Hallo Leute, also, ich bin auf folgendes Problem gestoßen: Ich habe Ubuntu 14.04 auf meiner...
Videoüberwachung mit Zoneminder
Heinz Becker, 10.08.2014 17:57, 0 Antworten
Hallo, ich habe den ZONEMINDER erfolgreich installiert. Das Bild erscheint jedoch nicht,...
internes Wlan und USB-Wlan-Srick
Gerhard Blobner, 04.08.2014 15:20, 2 Antworten
Hallo Linux-Forum: ich bin ein neuer Linux-User (ca. 25 Jahre Windows) und bin von WIN 8 auf Mint...