|
I definitely would prefer a -mdoc manual over a -man manual.
The two most common troff implementations are currently groff and mandoc. Both of these support -mdoc out of the box. This accounts for at least Linux, OpenBSD, FreeBSD, NetBSD, Mac OS X, Illumos, and Minix, and possibly others.
The main advantage -mdoc macros provide over -man macros is semantic annotation. This is especially visible in mandoc (used by default on the BSDs, Illumos, and Minix), which provides semantic searching capabilities for manuals written in -mdoc. This is nice. (Ingo Schwarze gave a good talk on this, if you're interested: https://www.youtube.com/watch?v=oifYhwTaOuw) Groff doesn't provide these but it is no worse at -mdoc than it is at -man.
-mdoc manpages are also visually consistent with each other; this is nice too even though it's less important.
The above things are nice, and I can't think of any disadvantages to providing a -mdoc manual. (Are there any systems that NetSurf supports that typically use troff but without -mdoc support?)
Of course, you can provide both if you like...
|
|