On 2016/10/02 15:30, Pavan Maddamsetti wrote:
> Hi,
>
> I often refer to the online documentation for OpenBSD. One feature that I
> find useful is that pages for the system calls and C library tend to have
> links under "See Also", for example if you look up open(2) or getc(3).
>
> However, there seem to be significant portions of the documentation that do
> not contain links. These include evp(3) and X(7). It would be a useful
> addition if these were included.
Pages like evp(3) and X(7) are written using man(7) ("legacy formatting
language for manual pages") and the cross-references only have "physical"
markup (i.e. typestyle). Outside of heuristics (a.k.a. guessing) there's
no way to identify these as the name of other manpages, so no good way
to generate a link to them.
The nicer pages with proper links are written in the semantic mdoc(7)
language where the cross-references can be properly annotated in the files,
which the html formatter can use to make an informed decisions.
For libressl-related manuals, as we have already forked, it might be
sane (though a lot of work) to rewrite them using mdoc. But for those
which are part of X, doing something different from upstream would
be unsustainable.
