Bug#736720: Interrelation between this package and Linux manpages.

[Mats Erik Andersson <mats.andersson@gisladisker.se>]

Package: freebsd-manpages
Version: 8.2-1
Severity: normal

A standard installation of GNU/kFreeBSD, with a manual
addition of "freebsd-manpages", will result in a mixture
of Linux-only manpages, FreeBSD manpages, and glibc manpages.
A typical example is this:

    $ man -a -w socket
    /usr/share/man/man2/socket.2.gz            (Linux oriented)
    /usr/share/man/man2/socket.2freebsd.gz
    /usr/share/man/man9/socket.9freebsd.gz
    /usr/share/man/man7/socket.7.gz            (Linux oriented)
    /usr/share/man/man3/socket.3pm.gz

Observe that a Linux oriented page is preferred.

One mechanism to resolve this inconvenience is to manually
insert "2freebsd" and "4freebsd" into the manpage search
order, like so:

    ### /etc/manpath.config

    SECTION   1 n l 8 3 2freebsd 2 3posix 3pm 3perl 5 4freebsd 4 9 6 7

The only change to the official content is the insertion of
the FreeBSD related sections.

A loose idea would be to influence the package "man-db" to export
such a line for "kfreebsd-any". Another mode of attack would be
to convince the package "manpages" to separate its Linux-only
pages into a separate package, but this latter mode would still
lead to some ambiguity concerning the ordering of FreeBSD and
glibc pages.

Best regards,
  Mats Erik Andersson, DM