Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 9 Jan 2017 22:59:17 -0800
From:      Steve Kargl <sgk@troutmask.apl.washington.edu>
To:        "Simon J. Gerraty" <sjg@juniper.net>
Cc:        freebsd-doc@freebsd.org, freebsd-current@freebsd.org, freebsd-hackers@freebsd.org
Subject:   Re: MANPATH not handled correctly
Message-ID:  <20170110065917.GA19146@troutmask.apl.washington.edu>
In-Reply-To: <85392.1484029576@kaos.jnpr.net>
References:  <20170108192633.GA42537@troutmask.apl.washington.edu> <78804.1484011141@kaos.jnpr.net> <20170110015413.GA17884@troutmask.apl.washington.edu> <85392.1484029576@kaos.jnpr.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Jan 09, 2017 at 10:26:16PM -0800, Simon J. Gerraty wrote:
> Steve Kargl <sgk@troutmask.apl.washington.edu> wrote:
> 
> > On Mon, Jan 09, 2017 at 05:19:01PM -0800, Simon J. Gerraty wrote:
> > > Steve Kargl <sgk@troutmask.apl.washington.edu> wrote:
> > > 
> > > > MANPATH is not handled correctly.  According to the documentation
> > > > in apropos(1) and whatis(1):
> > > 
> > > Can you clarify where you are seeing this documentation?
> > > I don't see it in 7.x 10.x or current.
> > > 
> > 
> > This an unaltered FreeBSD-current at r311832.
> > 
> > The text I quoted can be seen at 
> > 
> > https://svnweb.freebsd.org/base/head/contrib/mdocml/apropos.1?revision=294113&view=markup
> > 
> 
> But that isn't the man page that gets installed.
> 

Well, yes, it is the manpage that gets installed.

> usr.bin/man/apropos.1
> 
> is the one that matches apropos(1)
> 

>From src/usr.bin/man/Makefile

.if ${MK_MANDOCDB} == no
LINKS+= ${BINDIR}/man ${BINDIR}/apropos \
        ${BINDIR}/man ${BINDIR}/whatis
MAN+=   apropos.1
MLINKS= apropos.1 whatis.1
.endif

I have not set or unset MK_MANDOCDB.  From src.opt.mk

__DEFAULT_YES_OPTIONS = \
...
    MANDOCDB \
...

% svn blame src.opts.mk | grep MANDOC
283777       bapt     MANDOCDB \
% svn log -r 283777
------------------------------------------------------------------------
r283777 | bapt | 2015-05-30 10:41:37 -0700 (Sat, 30 May 2015) | 11 lines

Switch to mandoc's version of makewhatis(8), whatis(1), apropos(1) utilities.

This change among other things improve search capabilities over the manpages
allowing fine grain query.

A new build option WITHOUT_MANDOCDB has been added to keep the ancient version
of the database and the tools. The plan is to entirely remove this option before
11.0-RELEASE.

Differential Revision:  https://reviews.freebsd.org/D2603

-- 
Steve
20161221 https://www.youtube.com/watch?v=IbCHE-hONow



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20170110065917.GA19146>