From ru@whale.sunbay.crimea.ua  Mon May 27 00:54:38 2002
Return-Path: <ru@whale.sunbay.crimea.ua>
Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65])
	by hub.freebsd.org (Postfix) with ESMTP id B3FCE37B401
	for <bug-followup@FreeBSD.org>; Mon, 27 May 2002 00:54:33 -0700 (PDT)
Received: (from ru@localhost)
	by whale.sunbay.crimea.ua (8.11.6/8.11.2) id g4R7sKR31301;
	Mon, 27 May 2002 10:54:20 +0300 (EEST)
	(envelope-from ru)
Message-Id: <20020527075420.GE19313@sunbay.com>
Date: Mon, 27 May 2002 10:54:20 +0300
From: Ruslan Ermilov <ru@FreeBSD.org>
To: Jens Rehsack <rehsack@liwing.de>
Cc: bug-followup@FreeBSD.org
In-Reply-To: <3CF1E18E.C03B0933@liwing.de>
Subject: Re: conf/38567: man could not find manpages for library functions in installed ports
References: <200205261105.g4QB51g77839@helo.liwing.de> <20020527073655.GD19313@sunbay.com> <3CF1E18E.C03B0933@liwing.de>

>Number:         38600
>Category:       conf
>Synopsis:       Re: conf/38567: man could not find manpages for library functions in installed ports
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon May 27 01:00:09 PDT 2002
>Closed-Date:    Mon Jun 03 17:39:00 PDT 2002
>Last-Modified:  Mon Jun 03 17:39:00 PDT 2002
>Originator:     
>Release:        
>Organization:
>Environment:
>Description:
 On Mon, May 27, 2002 at 09:34:38AM +0200, Jens Rehsack wrote:
 > 
 > 
 > Ruslan Ermilov wrote:
 > > 
 > > On Sun, May 26, 2002 at 11:05:01AM +0000, Jens Rehsack wrote:
 > > >
 > > >       when trying to get some information 'bout - let's say gettext - 'man dcgettext'
 > > >       fails. To repair this I always set MANPATH environment variable until I see
 > > >       /etc/manpath.conf. After a short look I saw that only binaries are mapped, so
 > > >       neither ports library functions nor X (or X-related) library function calls
 > > >       could be looked up via man.
 > > >       This two appended lines fix this :-)
 > > >
 > > > --- manpath.patch begins here ---
 > > > --- manpath.config.orig       Sun May 26 10:52:14 2002
 > > > +++ manpath.config    Sun May 26 10:54:19 2002
 > > > @@ -17,6 +17,8 @@
 > > >  # check if the directory exists and if it does, add it to MANPATH
 > > >  #
 > > >  OPTIONAL_MANPATH     /usr/local/lib/perl5/5.6.1/man
 > > > +OPTIONAL_MANPATH     /usr/local/man
 > > > +OPTIONAL_MANPATH     /usr/X11R6/man
 > > >  #
 > > >  # set up PATH to MANPATH mapping
 > > >  #
 > > > --- manpath.patch ends here ---
 > > >
 > > No.  Please instead fix your $PATH to include /usr/local/bin and
 > > /usr/X11R6/bin.  That would automatically tune up your manpath(1)
 > > output.  The purpose is to avoid displaying those manpages that
 > > you do not use.
 > 
 > # echo $PATH
 > /sbin:/bin:/usr/sbin:/usr/bin:/usr/games:/usr/local/sbin:/usr/local/bin:/usr/X11R6/bin
 > 
 > And it doesn't work as you say. Maybe you have done sth. other, but I installed
 > a new, naked machine to try - and as you described I tested before submitting
 > a bug. This fails!
 > It's not for bin - it's for library functions!
 > 
 No, it's called PATH -> MANPATH mapping, have a look at /etc/manpath.config:
 
 #
 # set up PATH to MANPATH mapping
 #
 MANPATH_MAP     /bin                    /usr/share/man
 MANPATH_MAP     /usr/bin                /usr/share/man
 MANPATH_MAP     /usr/local/bin          /usr/local/man
 MANPATH_MAP     /usr/X11R6/bin          /usr/X11R6/man
 
 Whether /usr/local/bin actually exists or not, if you have it set
 in path, manpath(1) (which is also part of man(1)) will "map" it
 for you to /usr/local/man.  Does ``manpath'' output show you
 /usr/local/man?
 
 # echo $PATH
 /sbin:/bin:/usr/sbin:/usr/bin:/usr/games:/usr/local/sbin:/usr/local/bin:/usr/X11R6/bin:/root/bin
 # echo $MANPATH
 
 # ls -l /usr/local/bin
 ls: /usr/local/bin: No such file or directory
 # manpath
 /usr/share/man:/usr/local/man:/usr/X11R6/man
 # man -w libtiff
 /usr/local/man/man3/libtiff.3t.gz
 
 Perhaps you have MANPATH set to some value in environment already?
 
 
 Cheers,
 -- 
 Ruslan Ermilov		Sysadmin and DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age
>How-To-Repeat:
>Fix:
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: johan 
State-Changed-When: Mon Jun 3 17:38:24 PDT 2002 
State-Changed-Why:  
Follow-up to PR 38567 


Responsible-Changed-From-To: gnats-admin->freebsd-bugs 
Responsible-Changed-By: johan 
Responsible-Changed-When: Mon Jun 3 17:38:24 PDT 2002 
Responsible-Changed-Why:  
Follow-up to PR 38567 

http://www.freebsd.org/cgi/query-pr.cgi?pr=38600 
>Unformatted:
