Thanks, Stuart. In particular I was wondering about the X manuals, with the understanding that LibreSSL is a work in progress.
On Oct 2, 2016 4:50 PM, "Stuart Henderson" <[email protected]> wrote: > 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. > >
