wenn ich in den letzten jahren manpages fuer programme erstellen musste, hab ich mich immer so irgendwie durch manedit, gmanedit und text editoren rumgeschlagen.
trotzdem finde ich das erstellen von manpages immer noch irgendwie cryptisch. mich wurd mal interessieren, was ihr so benutzt.
womit erstellt ihr manpages
Re: womit erstellt ihr manpages
Ich schreibe manpages mittlerweile in 
asciidoc. Mit einem Umweg über docbook kann man diese dann in manpages konvertieren lassen. Ich finde die asciidoc-Syntax einfach sehr angenehm. Das lässt sich auch im Quellcode vernünftig lesen. Und es gibt Syntaxhighlighting im vim dafür.
Die Konvertierung lässt ich z.B. damit erreichen:
asciidoc. Mit einem Umweg über docbook kann man diese dann in manpages konvertieren lassen. Ich finde die asciidoc-Syntax einfach sehr angenehm. Das lässt sich auch im Quellcode vernünftig lesen. Und es gibt Syntaxhighlighting im vim dafür.Die Konvertierung lässt ich z.B. damit erreichen:
Code: Alles auswählen
asciidoc -b docbook -d manpage -o - mymanpage.1.txt | docbook2x-man --to-stdout - > mymanpage.1
Re: womit erstellt ihr manpages
... cryptisch???startx hat geschrieben: trotzdem finde ich das erstellen von manpages immer noch irgendwie cryptisch.
Nachhilfe gefaellig? http://ulm.ccc.de/ChaosSeminar/2009/11_ ... nd-friends
Use ed once in a while!
-
MustrumRidcully
- Beiträge: 124
- Registriert: 16.06.2005 04:11:24
- Lizenz eigener Beiträge: GNU General Public License
- Wohnort: berlin