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.

... and think I'm not used to seeing punctuation after the last link
which the two offending man pages have (one has a punctuation which
probably isn't good at any rate).

So I check against a 5.0 snapshot and the pages square with cgi, viz.
the SEE ALSO is formatted differently on the operating system from
what I'm used to.
Take mdoc and afterboot as examples, they both have cgi hyperlinks and
the OS pages are what I'm used to.

So I'd like to look at that and the place to start is src ...

http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/cvs/cvs.1?rev=1.127
http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/cvs/cvs.5?rev=1.8

... where I run into other issues.
Those man pages are quite different to what I see on the OS and on the web.
I readily accept there might be build processes I'm not looking at but
is this correct?

One difference I'm particularly curious about is the presence of
cvsintro.7 both as a file in
http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/cvs/ and referred to
in the previous cvs files but if I'm looking in the wrong place that
would make a lot of sense.

Of minor note also is the "page demarcations" on the cgi and the OS,
which looks like it's done by Dt, is in lowercase on cvs(5) which is a
clear violation of the rules. :]
As I apparently can't find the source, however, I can't think about fixing this.

I love to be clued in on how this works or correct source for those pages ...
Regardless, in terms of formatting, there's an inconsistency between
those two man pages and other man pages as they appear on a console
which I guess is at least worth noting.

Best wishes.

Reply via email to