From owner-freebsd-doc  Sun Sep 30 12:30: 9 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 798D937B40F
	for <freebsd-doc@freebsd.org>; Sun, 30 Sep 2001 12:30:00 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id f8UJU0G34723;
	Sun, 30 Sep 2001 12:30:00 -0700 (PDT)
	(envelope-from gnats)
Received: from colon.colondot.net (colon.colondot.net [212.135.138.209])
	by hub.freebsd.org (Postfix) with ESMTP id 10A0337B403
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 30 Sep 2001 12:29:50 -0700 (PDT)
Received: from jdamery by colon.colondot.net with local (Exim 3.31 #1)
	id 15nmHc-000F3Q-00
	for FreeBSD-gnats-submit@freebsd.org; Sun, 30 Sep 2001 20:29:48 +0100
Message-Id: <E15nmHc-000F3Q-00@colon.colondot.net>
Date: Sun, 30 Sep 2001 20:29:48 +0100
From: Jonathan Amery <jdamery@colon.colondot.net>
Reply-To: Jonathan Amery <jdamery@colon.colondot.net>
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.113
Subject: docs/30940: manpath documentation confusing or confused
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         30940
>Category:       docs
>Synopsis:       manpath documentation confusing or confused
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep 30 12:30:00 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Jonathan Amery
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
Chiark Orbital / :.
>Environment:
System: FreeBSD colon.colondot.net 4.4-STABLE FreeBSD 4.4-STABLE #0: Sat Sep 22 18:07:46 BST 2001 root@colon.colondot.net:/usr/obj/usr/src/sys/COLONDOT i386

>Description:

 The manpath manpage reads:

     Manpath tries to determine the user's manpath from a set of system
     defaults and the user's PATH, echoing the result to the standard output.
     Warnings and errors are written to the standard error.  If a directory in
     the user's path is not listed in the /etc/manpath.config file, manpath
     looks for the subdirectories man or MAN.  If they exist, they are added
     to the search path.

 Which suggests that the manpages for /foo/bar/bin are looked for in
/foo/bar/bin/man and not in /foo/bar/man (where they probably are, and
it certainly does appear to look).

>How-To-Repeat:

 Should be obvious.

>Fix:

 Discover what manpath actually does do then document that.

>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message