Subject: Re: Man page hierarchy question.
To: Richard Rauch <rkr@olib.org>
From: Jeremy C. Reed <reed@reedmedia.net>
List: netbsd-help
Date: 01/05/2005 10:01:53
On Wed, 5 Jan 2005, Richard Rauch wrote:
> What methods are there to avoid clashes between section-title
> specifications of man pages?
>
> As I read it, only the system admin can set a man-page
> section in /etc/man.conf, and the set defined is fairly
> small.
A regular user can also choose their own custom man.conf and also define
a custom MANPATH.
> What if, e.g., one has two packages, both in pkgsrc
> say, that provide functions of the same name?
Sometimes, we rename one of the manpages (as installed by pkgsrc).
> Let us suppose
> that the distributions both try to install their man pages,
> but other than some (or a lot of) common man-page names, there
> is no conflict between the two.
>
> Is this a good time to use the (somewhat mysterious) "3f"
> man page section? Or is the "f" supposed to designate
> something like Fortran?
Yes the "f" is for Fortan.
I don't think it is a good idea to use a uncommon man page section,
because it may not be seen by default.
It is interesting to note that some sections are commonly available:
section "n" for newer versions of man pages and section "l" for local
versions of man pages.
Did you have a particular man page your were thinking about?
Jeremy C. Reed
open source, Unix, *BSD, Linux training
http://www.pugetsoundtechnology.com/