[email protected] writes: > The aforementioned man pages use e.g. \fIunbound\fR(8) instead of > .Xr unbound 8. Instead of using font formatting options the > .Xr links should always be used to reference other man pages.
This is not a bug in OpenBSD. There are two languages used to write OpenBSD manpages, mdoc(7) and man(7). mdoc(7) is the modern format used by most OpenBSD manuals. man(7) is a much older format and is used primarily by large external projects that we include in OpenBSD but are not the main source of. .Xr is a mdoc(7) instruction that is not valid in a man(7) page. Unbound is one of those large external projects whose documentation we import wholesale. We don't write those pages--NLnet does. So we can't control whether they use mdoc(7) or not. It's possible to rewrite the pages. Such things have been done before; for example the LibreSSL manuals were converted from POD to mdoc(7). Upstream might be receptive to patches; then again, they may not. And it would be a lot of work. -- Anthony J. Bentley
