On 12/10/2011 19:31, David Walker wrote:
Hey team.
I'm looking at cvs and man pages and stuff.
I notice that two cvs pages - cvs(1) and cvs(5) - don't have SEE ALSO
hyperlinks appearing in cgi ...
http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&manpath=OpenBSD+Current
http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=5&manpath=OpenBSD+Current
... so I browse mdoc and see this:
Xr
Link to another manual ...
.Xr name section
If
section is followed by non-punctuation, an Ns is inserted into the token
stream.
Hi David,
cvs(1) and cvs(5) aren't in mdoc(7), but in man(7). The legacy man(7)
language doesn't have support for tagging text as a cross-reference.
What you see is in fact font-modes being used to make the familiar
"bold(bold)", e.g., cvs(5). It's clear by inspection that man.cgi had
some heuristics for labelling cross-references (some of the curses
manuals, for example, have "linky" cross-references), but it's obviously
not perfect... mdoc(7) manuals, however, should always be linky.
Tip: you can usually tell straightaway whether a manual is in mdoc(7) or
man(7) by looking at the header. If it has the nice volume name as the
centre of three columns (e.g., "OpenBSD Reference Manuals"), then it's
most likely in mdoc(7).
Take care,
Kristaps
