From owner-freebsd-doc@FreeBSD.ORG Mon Aug 22 01:10:16 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0B93B16A41F for ; Mon, 22 Aug 2005 01:10:16 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B593D43D45 for ; Mon, 22 Aug 2005 01:10:15 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j7M1AFUd051588 for ; Mon, 22 Aug 2005 01:10:15 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j7M1AFHj051587; Mon, 22 Aug 2005 01:10:15 GMT (envelope-from gnats) Date: Mon, 22 Aug 2005 01:10:15 GMT Message-Id: <200508220110.j7M1AFHj051587@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Cc: 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 Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 Aug 2005 01:10:16 -0000 The following reply was made to PR docs/85104; it has been noted by GNATS. From: Giorgos Keramidas To: "Gary W. Swearingen" Cc: bug-followup@freebsd.org Subject: Re: docs/85104: keyboard(4) manpage hides behind Xorg version Date: Mon, 22 Aug 2005 04:07:09 +0300 On 2005-08-22 00:50, "Gary W. Swearingen" wrote: >Dejan Lesjak writes: > >> Getting keyboard manpage seems to work as expected here: >> >> % man -w keyboard >> /usr/share/man/man4/keyboard.4.gz >> >> % man -wa keyboard >> /usr/share/man/man4/keyboard.4.gz >> /usr/X11R6/man/man4/keyboard.4x.gz >> >> Putting manpages from X11 into 4x was done exactly so there would be an easy >> way to get to them - see PR ports/25576. >> Could it be that you have misconfigured manpath.config or MANPATH variable set >> perhaps? > > Neither (untouched "manpath.config", no MANPATH), but my PATH obviously > doesn't work well with the installed "manpath.config". > > Of course I could fix this with manpath.config, but > it seems like too much learning to make (normal?) users do, esp. > without telling them about it, not even in the Handbook. The average Joe Random User has to learn about "apropos" and "man -k" though. This is the canonical way of looking for manpages related to a topic, and invoking either one of "apropos" or "man -k" shows there are two manpages: % giorgos@gothmog:/home/giorgos$ man -k ^keyboard % keyboard(4) - pc keyboard interface % keyboard(4x) - Keyboard input driver % giorgos@gothmog:/home/giorgos$ > I noticed the .4x. but it didn't occur to me to try "man 4x keyboard", > since I thought the "4" was for "man4". But this doesn't help me > because "man 4 keyboard" still brings up keyboard(4x) manpage. The correct way to bring up manpages of section XX is to use "man XX", so you shouldn't really expect to see keyboard(4x) by running: % man 4 keyboard The correct command: % man 4x keyboard pulls the correct manpage, so I don't see what the problem is :-/