News for hackers. Stuff that matters.
Re:Practical Unix Manuals: mdoc by nerdponx on Saturday November 25, 2017 @10:17AM (#15776261)
I'm not sure Markdown->Roff makes sense. I know Pandoc can do it, but how do you convey semantic information with Markdown? I'd sooner write YAML.
Re:Practical Unix Manuals: mdoc by emj on Tuesday November 28, 2017 @08:43PM (#15803744)
It works, not as good as a good template for LibreOffice though, my point was that the sematics is lost with markdown and you only get formating.
Re:Practical Unix Manuals: mdoc by DC-3 on Sunday November 26, 2017 @07:00AM (#15780534)
It might not be trendy like Markdown or YAML (both of which I like, and have their uses), but to markup text with higher-level semantics (i.e. not relating to formatting) the best option is XML.
Re:Practical Unix Manuals: mdoc by nerdponx on Sunday November 26, 2017 @10:38AM (#15781316)
Sure, but do you really want to hand write XML? It's nice for computers but makes for really ugly source when humans are involved, and humans are still very heavily involved when it comes to writing documentation.