Hi,
Jason McIntyre wrote on Tue, Feb 27, 2018 at 07:07:04AM +:
> On Tue, Feb 27, 2018 at 02:01:30AM -0500, Tinker wrote:
>> The links in the unbound documentation
>> e.g. http://man.openbsd.org/unbound#SEE_ALSO
>> do not share format with the other OpenBSD docs
>> http://man.openbsd.org/cat#SEE_ALSO , so that the references
>> not are hyperlinks in the web version.
>> https://cvsweb.openbsd.org/cgi-bin/cvsweb/src/usr.sbin/unbound/doc/
>> Normally OpenBSD man pages link by .Xr and the unbound man pages don't.
> you could petition the unbound project to convert their pages to mdoc
> format. better still, convert them yourself and submit those.
No, please don't.
Last time we talked to upstream (NLnet Labs) about this topic (in the
summer of 2014), they explicitly said they wanted to keep using man(7),
admittedly only citing weak reasons ("we don't need semantic markup
for these pages", which implies that they don't care about hyperlinks).
The rejection may also be motivated by using man(7) conistently for
all their projects including nsd(8), ldns, OpenDNSSEC, Net::DNS(3p),
and so on (though that's merely my guess).
So this is neither a technical question nor merely a question of doing
the work to modernize. It is a political question, and solving it
requires diplomacy and system integration / build system design skills.
Yours,
Ingo
