From owner-freebsd-doc@FreeBSD.ORG Mon Aug 22 03:25:25 2005 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8BF6916A41F for ; Mon, 22 Aug 2005 03:25:25 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from kane.otenet.gr (kane.otenet.gr [195.170.0.95]) by mx1.FreeBSD.org (Postfix) with ESMTP id D9ADE43D45 for ; Mon, 22 Aug 2005 03:25:22 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-a032.otenet.gr [212.205.215.32]) by kane.otenet.gr (8.13.4/8.13.4/Debian-1) with ESMTP id j7M3PHnk015779; Mon, 22 Aug 2005 06:25:18 +0300 Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.13.4/8.13.4) with ESMTP id j7M3PHBY008490; Mon, 22 Aug 2005 06:25:17 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.13.4/8.13.4/Submit) id j7M3PHq3008489; Mon, 22 Aug 2005 06:25:17 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Mon, 22 Aug 2005 06:25:17 +0300 From: Giorgos Keramidas To: "Gary W. Swearingen" Message-ID: <20050822032517.GB8408@gothmog.gr> References: <200508220310.j7M3AA9l068861@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200508220310.j7M3AA9l068861@freefall.freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: docs/85104: keyboard(4) manpage hides behind Xorg version X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 Aug 2005 03:25:25 -0000 On 2005-08-22 03:10, "Gary W. Swearingen" wrote: >Dejan Lesjak writes: >> I could still argue though that changing PATH is as advanced as >> changing MANPATH, but it doesn't feel [...] > > It sounds like Giorgos is arguing the same way, so you outvote me. > > But don't you HAVE to change the default path after installing X11? Not really. The default PATH (as set in /etc/login.conf) already includes /usr/X11R6/bin :-) > I sure hope the ports system isn't messin' with my "profile". That would be awful. > And where do we learn to put more-custom directories at the end of > PATH instead of the beginning (where I think they belong)? Nowhere, I guess. It's one of those things that you have to apply Common Sense(TM) to. For instance, on my Solaris workstation at work, where I really *MUST* use a local version of autoconf, automake and libtool (from /opt/autotools) and not the one that is part of the Sun Freeware collection (from /usr/sfw), I really *do* want /opt/autotools to be near the beginning of the PATH. That's something I found out by experimenting with various setups though. > The several examples of PATH setting in the Handbook show both > theories (even within the same PATH), with mine favored, including: > PATH=/usr/X11R6/bin:$PATH; > > (One theory is that more-custom directories should override less-custom > ones so you can easily "replace" their programs; the other theory is > that doing so makes it too easy to get unexpected custom behavior from > less-custom programs.) Unexpected behavior is, well, "unexpected" and should be avoided if possible. IMHO, it's rarely a good idea to prepend custom PATH entries that may happen to "shadow" some of the utilities of the standard path. What happens if you prepend /opt/foo to the default path that includes an "sh" binary that is an interpreter for language Foobar instead of a /bin/sh replacement and then you accidentally type "sh hello.sh"? :-) >> But then again if you change PATH so X11 stuff is first perhaps it is >> expected to also get manpages for X11 first? > > Yes, but it's not expected (by me) to be so hard to display both > manpages. > > But this will only waste a small amount of time for a small fraction > of FreeBSD users, so it's no big deal. Suspend or close the PR. Thanks.