From rehsack@liwing.de Mon May 27 03:56:55 2002 Return-Path: Received: from mail.liwing.de (mail.liwing.de [213.70.188.162]) by hub.freebsd.org (Postfix) with ESMTP id 6C37537B408 for ; Mon, 27 May 2002 03:56:53 -0700 (PDT) Received: (qmail 34331 invoked from network); 27 May 2002 11:07:42 -0000 Received: from stingray.liwing.de (HELO liwing.de) ([213.70.188.164]) (envelope-sender ) by mail.liwing.de (qmail-ldap-1.03) with SMTP for ; 27 May 2002 11:07:42 -0000 Message-Id: <3CF20F43.15385C75@liwing.de> Date: Mon, 27 May 2002 12:49:39 +0200 From: Jens Rehsack To: Ruslan Ermilov Cc: bug-followup@FreeBSD.org, rifter@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> <20020527075420.GE19313@sunbay.com> >Number: 38606 >Category: conf >Synopsis: Re: conf/38567: man could not find manpages for library functions in >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 04:00:12 PDT 2002 >Closed-Date: Mon Jun 03 17:39:49 PDT 2002 >Last-Modified: Mon Jun 03 17:39:49 PDT 2002 >Originator: >Release: >Organization: >Environment: >Description: Ruslan Ermilov wrote: > > 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: I try manpath command as you write and it works. I try to get gettext-manpage, and it works. I do not why it didn't work all the time before - maybe no 'makewhatis' run ...? > # > # 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 I've seen it, but I didn't understand. But I think now it's $PATH -> manpath mapping, right? If I have /usr/local/bin in my $PATH, I have /usr/local/man in my manpath. Maybe this should be told more clearly... :-) > 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? No, I didn't. I do not know why it fails before, but now it works. Thanks, Jens > 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 -- L i W W W i Jens Rehsack L W W W L i W W W W i nnn gggg LiWing IT-Services L i W W W W i n n g g LLLL i W W i n n g g Friesenstraße 2 gggg 06112 Halle g g g Tel.: +49 - 3 45 - 5 17 05 91 ggg e-Mail: Fax: +49 - 3 45 - 5 17 05 92 http://www.liwing.de/ >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:39:10 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:39:10 PDT 2002 Responsible-Changed-Why: Follow-up to PR 38567 http://www.freebsd.org/cgi/query-pr.cgi?pr=38606 >Unformatted: installed ports