3 ms·
markdown isn't semantic. roff macros allow one to clearly specify that function arguments (Fa) and command line flags (Fl) are different things, even if they re
by tedunangst 12y ago
markdown isn't semantic. roff macros allow one to clearly specify that function arguments (Fa) and command line flags (Fl) are different things, even if they render similarly.
- rakoo 12y agoIs this really needed in a manpage, though ? AFAIK manpages are ASCII document created with any variation of troff/nroff/groff and piped into less -s. There is no need for any semantical distinction if display is the same, since the best interaction you can have is searching for something.
- tedunangst 12y agoASCII is not the only possible output format, and yes, semantic search is useful.
- mseepgood 12y agoThese are manpages http://imgur.com/a/JZfTr http://imgur.com/a/JZfTr
- rakoo 12y agoWhile I like the venerable look they have, those books aren't what you use daily to document yourself on how your machine works. I was speaking about those manpages we use when we don't know what the letters are for in the itemized output of rsync, for instance.
- cogburnd02 12y ago> While I like the venerable look they have, those books aren't what you use daily to document yourself on how your machine works. But you can create pretty hard-copy versions of the manpages on your system with groff, the same way these books were created with troff (which groff is a replacement for.)