From rehsack@liwing.de  Mon May 27 03:56:55 2002
Return-Path: <rehsack@liwing.de>
Received: from mail.liwing.de (mail.liwing.de [213.70.188.162])
	by hub.freebsd.org (Postfix) with ESMTP id 6C37537B408
	for <bug-followup@FreeBSD.org>; 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 <rehsack@liwing.de>)
          by mail.liwing.de (qmail-ldap-1.03) with SMTP
          for <ru@FreeBSD.org>; 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 <rehsack@liwing.de>
To: Ruslan Ermilov <ru@FreeBSD.org>
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    Friesenstrae 2
                                   gggg    06112 Halle
                                      g
                                  g   g
 Tel.:  +49 - 3 45 - 5 17 05 91    ggg     e-Mail: <rehsack@liwing.de>
 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
