top | item 9498700

Creating Man Pages in Markdown with Ronn

2 points| silentbicycle | 10 years ago |spin.atomicobject.com

1 comment

order

nailer|10 years ago

As someone who's written a few well known man pages: that's awesome. The 'troff' format is pretty long in the tooth now.

Most Linux man pages are pretty poor quality: for a long time the the upstream Linux maintainer refused to accept any changes eg, adding an EXAMPLES section for cron tables - because Paul Vixie (the cron author) 'might not like them'. Forking man-pages , using markdown as a source format and allowing pull requests would help a lot.