3 ms·
Strong agree on the lack of a decent definition list notation. Strong agree on roff. Moderately strong on most of his critique Pretty strong disagree that markd
by ggm 3y ago
Strong agree on the lack of a decent definition list notation. Strong agree on roff. Moderately strong on most of his critique Pretty strong disagree that markdown is an abominably bad choice: it's problems are fixable.
A single canonical reference and a little restraint and a dl definition would do it for me, regarding man page creation.
- deanebarker 3y ago>A single canonical reference https://commonmark.org/ https://commonmark.org/
- ggm 3y ago(2014 updated 2021) the original OpenBSD article is (2017) and there's still no good canonical DL instantiation -commonmark goes into "do it in HTML" which is .. FAIL in my book. So, a "standard" which has been continuously revised since 2014 and doesn't have definition lists except as "use HTML"
- apple4ever 3y agoThat was the best attempt to update it and improve upon it. Its mostly successful, but not entirely. Wish Gruber would just link to that instead of his old, bugger, out of date spec.