(Minor, in the unbound man pages, "SEE ALSO" refs don't hyperlink)

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

(Minor, in the unbound man pages, "SEE ALSO" refs don't hyperlink)

Tinker
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.

Tinker

Reply | Threaded
Open this post in threaded view
|

Re: (Minor, in the unbound man pages, "SEE ALSO" refs don't hyperlink)

Jason McIntyre-2
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.
>
> Tinker
>

morning.

you could petition the unbound project to convert their pages to mdoc
format. better still, convert them yourself and submit those.

jmc

Reply | Threaded
Open this post in threaded view
|

Re: (Minor, in the unbound man pages, "SEE ALSO" refs don't hyperlink)

Ingo Schwarze
Hi,

Jason McIntyre wrote on Tue, Feb 27, 2018 at 07:07:04AM +0000:
> 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