From owner-freebsd-doc@FreeBSD.ORG  Mon Aug 22 01:30:37 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 8626316A41F
	for <freebsd-doc@hub.freebsd.org>; Mon, 22 Aug 2005 01:30:37 +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 44F8843D48
	for <freebsd-doc@hub.freebsd.org>; Mon, 22 Aug 2005 01:30:37 +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 j7M1UbAV052212
	for <freebsd-doc@freefall.freebsd.org>; Mon, 22 Aug 2005 01:30:37 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j7M1Uado052210;
	Mon, 22 Aug 2005 01:30:36 GMT (envelope-from gnats)
Date: Mon, 22 Aug 2005 01:30:36 GMT
Message-Id: <200508220130.j7M1Uado052210@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: garys@opusnet.com (Gary W. Swearingen)
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: "Gary W. Swearingen" <garys@opusnet.com>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 22 Aug 2005 01:30:37 -0000

The following reply was made to PR docs/85104; it has been noted by GNATS.

From: garys@opusnet.com (Gary W. Swearingen)
To: Giorgos Keramidas <keramida@ceid.upatras.gr>
Cc: bug-followup@freebsd.org
Subject: Re: docs/85104: keyboard(4) manpage hides behind Xorg version
Date: Sun, 21 Aug 2005 18:27:45 -0700

 Giorgos Keramidas <keramida@ceid.upatras.gr> writes:
 
 > 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$
 
 OK, so JRU now knows about the two manpages.  Show me what commands JRU
 uses to view each one (regardless of JRU's PATH value, I hope). But
 don't bother unless it's better than my awkward solution below.
 
 > 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 :-/
 
 The problem is that JRU might, and I do, get the keyboard(4x) manpage
 no matter which of your commands we use, and as you say we "shouldn't
 really expect to see keyboard(4x) by running: man 4 keyboard".  The
 other problem is that in order to see keyboard(4), one might have to
 do all this and know enough to do it:
 
    $ man -wa keyboard
    /usr/X11R6/man/man4/keyboard.4x.gz
    /usr/share/man/man4/keyboard.4.gz
    $ man -M /usr/share/man keyboard