From owner-freebsd-current  Sun Feb  9 13:39:18 1997
Return-Path: <owner-current>
Received: (from root@localhost)
          by freefall.freebsd.org (8.8.5/8.8.5) id NAA10883
          for current-outgoing; Sun, 9 Feb 1997 13:39:18 -0800 (PST)
Received: from rocky.mt.sri.com (rocky.mt.sri.com [206.127.76.100])
          by freefall.freebsd.org (8.8.5/8.8.5) with ESMTP id NAA10874
          for <freebsd-current@freefall.freebsd.org>; Sun, 9 Feb 1997 13:39:13 -0800 (PST)
Received: (from nate@localhost) by rocky.mt.sri.com (8.7.5/8.7.3) id OAA06583; Sun, 9 Feb 1997 14:39:08 -0700 (MST)
Date: Sun, 9 Feb 1997 14:39:08 -0700 (MST)
Message-Id: <199702092139.OAA06583@rocky.mt.sri.com>
From: Nate Williams <nate@mt.sri.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
To: Poul-Henning Kamp <phk@critter.dk.tfs.com>
Cc: joerg_wunsch@uriah.heep.sax.de (Joerg Wunsch),
        freebsd-current@freefall.freebsd.org
Subject: Re: 3.0-970124-SNAP: man page search order 
In-Reply-To: <9632.855479839@critter.dk.tfs.com>
References: <Mutt.19970208234401.j@uriah.heep.sax.de>
	<9632.855479839@critter.dk.tfs.com>
Sender: owner-current@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

> >> 2. The real thing is this.  The man page search order finds all of the c
> >> programming calls after the TCL ones, so "man bind" returns TCL's bind,
> >> not the syscall bind.
> 
> Well, somebody find out what it takes to fix the search order and 
> that end of that story.

Looking in man/lib/config.h:
  static char *std_sections[] = 
    {
       "1", "l", "8", "6", "2", "3", "n", "4", "5", "7", "p", "o", NULL
    };

This is the order that is searches in (it doesn't care the order of the
man pages, it cares about the order of the sections).  Although, it will
pickup the man pages in the same sections in the order by which they are
set, so if you have two bind.1 man-pages, the one that is set first in
/etc/manpath.config will be used.

(Note, the above line is modified by me to not care about .n man-pages
since I could care less about TCL manpages, which are the by far the
most common pages stored in our system.)

> >I'm also fairly annoyed by this.  I never got it right why Tcl
> >installs its man pages into the inofficial section `n' in the manual
> >at all (is it really something to be considered `new' these days? :),
> >but it's particularly annoying to have this section being searched in
> >front of the standard sections.
> 
> Well maybe it should be called .t instead then ?

There are so many of them they really deserve their own section.  But,
we'd become non-standard. :(


Nate