Eigene manpages

Ich benutze das Kommando man relativ häufig. man bash zum Beispiel. Warum sollte man dieses System nicht auch für eigene Zwecke missbrauchen? manpages sind in troff gesetzt. Leider ist dieses Format nicht gerade Benutzerfreundlich, daher nutze ich folgenden Flow:

1. das Dokument in Perl POD schreiben. Perl POD ist nicht das schönste Format, aber immer noch deutlich besser als troff.
2. mit pod2man (Teil der Perl Standarddistribution) kann man das Dokument in ein man-taugliches Format umwandeln.
3. Datei nach z.B. ~/man kopieren und das Verzeichnis zu $MANPATH hinzuzufügen.

$MANPATH siehe ~/.zshenv. : muss am Anfang oder Ende stehen, um den Standardpfad hinzuzufügen.

Siehe auch

• documentation - How can I add man page entries for my own power tools? - Unix & Linux Stack Exchange
• command line - How do I manually install a man page file? - Ask Ubuntu