Hacker News new | ask | show | jobs
Creating Man Pages in Markdown with Ronn (spin.atomicobject.com)
2 points by silentbicycle 4056 days ago
1 comments

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.