Re:Mdoc(7) – semantic markup language for formatting manual ...
by tedunangst on Thursday March 09, 2017 @09:56PM
(#13835963)
It's very easy to write some plaintext and iteratively add mdoc markup. Trying to do get it all right in one shot is probably a mistake. Most of the common macros, like .Fa for function argument, are mneumonic.
[ Parent
| on HN ]
Re:Mdoc(7) – semantic markup language for formatting manual ...
by carussell on Thursday March 09, 2017 @11:14PM
(#13836324)
That's besides the point. No one is ever going to read mdoc, because it's not meant for human consumption, outside of editing an mdoc file. This is not true for markdown, where the raw form is as fit for consumption as the rendered form.
Re:Mdoc(7) – semantic markup language for formatting manual ...
by tedunangst on Thursday March 09, 2017 @11:46PM
(#13836447)
I guess I don't see the problem. It's not meant for reading, so don't read it.
Re:Mdoc(7) – semantic markup language for formatting manual ...
by carussell on Friday March 10, 2017 @12:31AM
(#13836608)
Man pages' source texts are not human readable.
If they were, that would bring good things.
This is the entire motivation behind my comment.
I don't know how I can be clearer here.