HNHacker News
TopNewBestAskShowJobs

TerminalPrgrmr

65 karma · joined March 3, 2012

submissionscomments
TerminalPrgrmr··on Write Unix manpages in Markdown with md2man
One drawback is that it doesn't follow the standard $MANPATH directory structure (man/manX/Y.X where X is the section number and Y is the manual page) but instead uses a single flattened directory (man/Y.X).

I filed an issue about this here: https://github.com/defunkt/gem-man/issues/8

TerminalPrgrmr··on Write Unix manpages in Markdown with md2man
Thanks for clarifying. Defensive instincts engage when one's pet project fades from the spotlight on its own stage. You're right about Pandoc fulfilling my quoted aspect of Unix philosophy; I realized it later but was too proud to admit it. :)
TerminalPrgrmr··on Write Unix manpages in Markdown with md2man
Hurray! Thanks. :)
TerminalPrgrmr··on Write Unix manpages in Markdown with md2man
"when you don't create things, you become defined by your tastes rather than ability. your tastes only narrow & exclude people. so create." --Why The Lucky Stiff
TerminalPrgrmr··on Write Unix manpages in Markdown with md2man
"Write programs that do one thing and do it well." --Doug McIlroy
TerminalPrgrmr··on Write Unix manpages in Markdown with md2man
md2man's input is already Markdown and its Roff output already supports hyperlinks: https://github.com/sunaku/md2man/blob/master/test/md2man/rof...
TerminalPrgrmr··on Write Unix manpages in Markdown with md2man
Ronn's HTML output is indeed pretty, but I cannot say the same of its input. In particular, I find md2man's syntax for tagged paragraphs (all lines indented by +2 spaces except the first line) to be less intrusive and easier to maintain than Ronn's (list items that begin with boldface and end with a colon, followed by +2 space indented lines).