From owner-freebsd-current@freebsd.org Tue Jan 10 13:02:25 2017 Return-Path: Delivered-To: freebsd-current@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id C976CCA887B; Tue, 10 Jan 2017 13:02:25 +0000 (UTC) (envelope-from baptiste.daroussin@gmail.com) Received: from mail-wm0-x242.google.com (mail-wm0-x242.google.com [IPv6:2a00:1450:400c:c09::242]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 5B96B17C3; Tue, 10 Jan 2017 13:02:25 +0000 (UTC) (envelope-from baptiste.daroussin@gmail.com) Received: by mail-wm0-x242.google.com with SMTP id r126so9269587wmr.3; Tue, 10 Jan 2017 05:02:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=W+9VwMr9BAFge3sXoW1rqUVLr+ZjaaPMy+vqK4+oYO0=; b=OuolBujgOeQwXFIUFE+WMcblu489vz89PdNgAuh9PX2mTbaUjZu7R01VhS0EC33dVB BdaGICpmrDvt+NuQ27L6ZJd27uBJGRmqz5dP1R4qI/3n/1jUi4V6of8BV3rRUXcr85dn NcOrLUyRhhrSQWQtFHVhzJoZBge+wdfXM318BTsJ5otOlgjK2JgFLvHsKreMvIGj1vMM C08b1BDCRwGHitAmS6Lw9VzUbHIEVsd+HoatTFmi3+khvpw1vVIHTRcrNvOY4G3bUN4y GlhB+m1UDt/uGiQxFfhfk0JgNXW0Iy7gyvRnoAH7WTLW4p4yAfWm53ZXlAV+utYUr/71 uJrw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:date:from:to:cc:subject:message-id :references:mime-version:content-disposition:in-reply-to:user-agent; bh=W+9VwMr9BAFge3sXoW1rqUVLr+ZjaaPMy+vqK4+oYO0=; b=TW3rKQNx8ssoFWXEpREhSLw8wcNjV819B5Tp/j4vHk7+YKWGN+hwmBfSEJmRCjDtZF hNYYYf79vijwjy/yN1SE9IAI1k6JMqohrlL0OCHjTNi0WWATjuvootM0jk1x8pSVT+OF TPHfJcxFkQ8auntcGHUSgiOavYE/XYFV2x/yT8FTtggvH0FXtc2Oo6ov1R8eoAVczwQJ R7btlurGCXErxhTR6TXtGpcfLXlacJipU6Jyo80konG1CVrcRnyph1anwDOU2qWAgq7d NR0xbFcTRGTMdYT8IlJPyPM4UFFQWuxCK9rtnVlhIbDoEOdK0pAcLYdf6kXn+OdKuEpZ GETw== X-Gm-Message-State: AIkVDXJCQS8TyrliRT/NhiVs1j/+J8l5OHxfGuMdu0mjwujDh5jKRsna67hsUyr5Rx6L8A== X-Received: by 10.28.60.5 with SMTP id j5mr7946937wma.119.1484053342483; Tue, 10 Jan 2017 05:02:22 -0800 (PST) Received: from ivaldir.etoilebsd.net ([2001:41d0:8:db4c::1]) by smtp.gmail.com with ESMTPSA id m10sm3154575wjg.45.2017.01.10.05.02.20 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 10 Jan 2017 05:02:21 -0800 (PST) Sender: Baptiste Daroussin Date: Tue, 10 Jan 2017 14:02:17 +0100 From: Baptiste Daroussin To: Steve Kargl Cc: freebsd-doc@freebsd.org, freebsd-current@freebsd.org, freebsd-hackers@freebsd.org Subject: Re: MANPATH not handled correctly Message-ID: <20170110130216.kfzpyhqkmrfie6pp@ivaldir.etoilebsd.net> References: <20170108192633.GA42537@troutmask.apl.washington.edu> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="upwsy5u42p4sko2n" Content-Disposition: inline In-Reply-To: <20170108192633.GA42537@troutmask.apl.washington.edu> User-Agent: NeoMutt/20161126 (1.7.1) X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Jan 2017 13:02:25 -0000 --upwsy5u42p4sko2n Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Jan 08, 2017 at 11:26:33AM -0800, Steve Kargl wrote: > MANPATH is not handled correctly. According to the documentation > in apropos(1) and whatis(1): >=20 > MANPATH The standard search path used by man(1) may be changed by > specifying a path in the MANPATH environment variable. Inval= id > paths, or paths without manual databases, are ignored. > Overridden by -M. If MANPATH begins with a colon, it is > appended to the default list; if it ends with a colon, it is > prepended to the default list; or if it contains two adjacent > colons, the standard search path is inserted between the > colons. If none of these conditions are met, it overrides the > standard search path. >=20 > I have a manpage named mkpic in $HOME/man/man1. I also have the FreeBSD > installed manpages, e.g., /usr/share/man/man1/cat.1.gz. If I have > 'setenv MANPATH :$HOME/man' in my .cshrc file, then the following occurs:= =20 >=20 > % setenv | grep MANPATH > MANPATH=3D:/home/kargl/man > % apropos mkpic > (Warning: MANPATH environment variable set) > mkpic(1) - construct a contour image in MIFF image format > % apropos cat > (Warning: MANPATH environment variable set) > matrix(3) - Array and matrix allocation for FFT library >=20 > So, the above description of MANPATH is incorrect as :/home/kargl/man > should have been appended to the default MANPATH. >=20 > Interestingly, manpath(1) seems to described what actually happens > (long lines wrapped): >=20 > % unsetenv MANPATH > % manpath > /home/kargl/man:/usr/local/man:/usr/share/man:/usr/share/openssl/man:\ > /usr/local/lib/perl5/site_perl/man:/usr/local/lib/perl5/5.20/perl/man:\ > /usr/local/share/xpdf/man > % setenv MANPATH :$HOME/sman > % manpath > (Warning: MANPATH environment variable set) > :/home/kargl/man >=20 > The expected result according apropos(1) and whatis(1) for last command is >=20 > % manpath > /home/kargl/man:/usr/local/man:/usr/share/man:/usr/share/openssl/man:\ > /usr/local/lib/perl5/site_perl/man:/usr/local/lib/perl5/5.20/perl/man:\ > /usr/local/share/xpdf/man:/home/kargl/man >=20 > Instead of (un)fixing the documentation for apropos(1) and whatis(1), it > would be preferable to fix manpath to match the description in those > manpages. In addition, the Warning should be removed or at least an > option should be available to suppress the (useless/annoying) Warning. > This would restore man(1), apropros(1), and whatis(1) to its historical > behavior prior to svn revision 213317. >=20 > If the documentation for apropos(1) and whatis(1) is unfixed, then manpat= h(1) > should have HISTORY and BUGS sections. The BUGS section should explicitly > not that MANPATH is no longer a changeable environmental variable by a > user without incurring the Warning. >=20 Sounds like a bug, I will have a look as soon as I can Thanks for reporting, Best regards, Bapt --upwsy5u42p4sko2n Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEgOTj3suS2urGXVU3Y4mL3PG3PloFAlh021YACgkQY4mL3PG3 PloyXhAA3y9ge8ds7DrzprPT45aC0s2GcsJ8YS013RlM3O//oI0sACEnWYEjP6H0 flIKoNf7LmMdPuJy60IettSZW11FcmCFzahXZ0ZXhba2fpJFq8P/fWH/XOQL+RZL J3xnZmSKsmD0EeuSnAQYtAClg1aFjRPfejU/L2XyHsQr1fnqloOeGc/V7LI276JT IdAYyswC0dAL9+0HihaUjkdMcNFLwXDNgApfSYfgbd/B5kbRUpotv3G6G/tW3EBk uEXv4X2XAcXcrtmycCTLxgYGzo7lGWeVBz+YKw4UGk9d4xPy8VhocML04PBwZr6x G6C/FZSmB/bYqUdzPKTQoW5lLWtJtgzg1rqIjyQq5XFfGkCNyRMfIMIHuHoYpqIC reOjLkmOvO6GTGoBQ52ImMG836/lLxs8QF6ksuXCtduaJ3V+vsy0xb0BNeV7R8D7 7fp8k4lQr09oRF6GzKxWjuj9F0vXlkD0VUw+ifypySBnMWJrf/7xmJJOgmZ1rpa/ u+cEHATmNyfA2e6riXxqiaVPp8aWbNmxzDzRUjPbJEerVWIAAYMzCJB5sPdL+4DH 1UKBo2BDR37UOAmdjB+5/KvLwyB9lFtzTvE7gpJI1PTkhORQwBpaTJj5pVpNsn03 4s3VT6Ebkv6KrWJ289S67gktSBXADP0yVwWvUfhHXmUoy2F8fls= =Xo3K -----END PGP SIGNATURE----- --upwsy5u42p4sko2n--