NetBSD Problem Report #49895

From paul@pokey.whooppee.com  Wed May 13 03:37:59 2015
Return-Path: <paul@pokey.whooppee.com>
Received: from mail.netbsd.org (mail.netbsd.org [149.20.53.66])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client CN "mail.netbsd.org", Issuer "Postmaster NetBSD.org" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 3F2DDA6552
	for <gnats-bugs@gnats.NetBSD.org>; Wed, 13 May 2015 03:37:59 +0000 (UTC)
Message-Id: <20150513032239.4A02C16E4C@pokey.whooppee.com>
Date: Wed, 13 May 2015 11:22:39 +0800 (PHT)
From: paul@whooppee.com
Reply-To: paul@whooppee.com
To: gnats-bugs@NetBSD.org
Subject: Bad cross-ref in drvctl(8) man page
X-Send-Pr-Version: 3.95

>Number:         49895
>Category:       bin
>Synopsis:       Bad cross-ref in drvctl(8) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    mlelstv
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed May 13 03:40:00 +0000 2015
>Closed-Date:    Sat Jul 04 08:37:43 +0000 2015
>Last-Modified:  Sat Jul 04 08:37:43 +0000 2015
>Originator:     paul@whooppee.com
>Release:        NetBSD 7.99.15
>Organization:
-------------------------------------------------------------------------
| Paul Goyette     | PGP Key fingerprint:     | E-mail addresses:       |
| (Retired)        | FA29 0E3B 35AF E8AE 6651 | paul at whooppee.com    |
| Kernel Developer | 0786 F758 55DE 53BA 7731 | pgoyette at netbsd.org  |
-------------------------------------------------------------------------
>Environment:
System: NetBSD pokey.whooppee.com 7.99.15 NetBSD 7.99.15 (POKEY 2015-04-09 09:49:29) #1: Sun May 3 17:01:17 PHT 2015 paul@pokey.whooppee.com:/build/netbsd-local/obj/amd64/sys/arch/amd64/compile/POKEY amd64
Architecture: x86_64
Machine: amd64
>Description:
	The drvctl(8) man page includes a cross-reference (in the first
	paragraph) to drvctl(4) device.  However, there is no drvctl(4)
	man page.
>How-To-Repeat:
	man 8 drvctl
>Fix:
	The best solution:  document the drvctl(4) device, including all
	of its interfaces (presumably, ioctl's).

	Worst solution: replace the '.Xr drvctl 4' directive in the
	section 8 man page with a '.Nm' directive?

>Release-Note:

>Audit-Trail:

Responsible-Changed-From-To: bin-bug-people->mlelstv
Responsible-Changed-By: mlelstv@NetBSD.org
Responsible-Changed-When: Wed, 13 May 2015 04:55:35 +0000
Responsible-Changed-Why:
I'm preparing a drvctl(4) man page.


From: "Michael van Elst" <mlelstv@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/49895 CVS commit: src
Date: Wed, 13 May 2015 07:28:49 +0000

 Module Name:	src
 Committed By:	mlelstv
 Date:		Wed May 13 07:28:49 UTC 2015

 Modified Files:
 	src/distrib/sets/lists/man: mi
 	src/sbin/drvctl: drvctl.8
 	src/share/man/man4: Makefile
 Added Files:
 	src/share/man/man4: drvctl.4

 Log Message:
 Add documentation for the drvctl driver and add reference.
 Fixes PR 49895.


 To generate a diff of this commit:
 cvs rdiff -u -r1.1500 -r1.1501 src/distrib/sets/lists/man/mi
 cvs rdiff -u -r1.15 -r1.16 src/sbin/drvctl/drvctl.8
 cvs rdiff -u -r1.619 -r1.620 src/share/man/man4/Makefile
 cvs rdiff -u -r0 -r1.1 src/share/man/man4/drvctl.4

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Sat, 04 Jul 2015 08:37:43 +0000
State-Changed-Why:
fixed same day


>Unformatted:

Home	PR Database Search