NetBSD Problem Report #51243

From www@NetBSD.org  Wed Jun 15 03:36:41 2016
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client CN "mail.netbsd.org", Issuer "Postmaster NetBSD.org" (verified OK))
	by mollari.NetBSD.org (Postfix) with ESMTPS id DDEF57A48B
	for <gnats-bugs@gnats.NetBSD.org>; Wed, 15 Jun 2016 03:36:40 +0000 (UTC)
Message-Id: <20160615033639.ECE1E7AAA2@mollari.NetBSD.org>
Date: Wed, 15 Jun 2016 03:36:39 +0000 (UTC)
From: coypu@sdf.org
Reply-To: coypu@sdf.org
To: gnats-bugs@NetBSD.org
Subject: Add valid examples to pcictl(8)
X-Send-Pr-Version: www-1.0

>Number:         51243
>Category:       bin
>Synopsis:       Add valid examples to pcictl(8)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Jun 15 03:40:00 +0000 2016
>Closed-Date:    Sun Sep 25 00:07:12 +0000 2016
>Last-Modified:  Sun Sep 25 00:10:01 +0000 2016
>Originator:     coypu
>Release:        NetBSD-7.99.30
>Organization:
>Environment:
NetBSD  7.99.30 NetBSD 7.99.30 (GENERIC) #3: Fri Jun 10 15:20:40 IDT 2016  fly@net.Home:/usr/obj/sys/arch/amd64/compile/GENERIC amd64
>Description:
Maybe in retrospect the syntax is legible, reading:
SYNOPSIS
  pcictl pcibus command [arg [...]]

then
  the following commands are available:

  list [-Nn] [-b bus] [-d device] [-f function]

  any-other-command [-b bus] -d device ...

does not make me try "pcictl pci0 list" as the first try (or first 10 tries, my attempts were all "pcictl list -d pci0" and variants)

an example or two will be nice.
writing then man page as pcibus list ... is also nice.

nicer still, make pcictl list work without any argument, listing for all pci buses.
>How-To-Repeat:

>Fix:

>Release-Note:

>Audit-Trail:

State-Changed-From-To: open->closed
State-Changed-By: mrg@NetBSD.org
State-Changed-When: Sun, 25 Sep 2016 00:07:12 +0000
State-Changed-Why:
i added a couple of examples -- the ones i'm always trying to remember.


From: "matthew green" <mrg@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/51243 CVS commit: src/usr.sbin/pcictl
Date: Sun, 25 Sep 2016 00:06:49 +0000

 Module Name:	src
 Committed By:	mrg
 Date:		Sun Sep 25 00:06:49 UTC 2016

 Modified Files:
 	src/usr.sbin/pcictl: pcictl.8

 Log Message:
 add some examples:  "pcictl pci0 list" and "pcictl pci0 list -N".
 inspired by PR 51243.


 To generate a diff of this commit:
 cvs rdiff -u -r1.16 -r1.17 src/usr.sbin/pcictl/pcictl.8

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

>Unformatted:

Home	PR Database Search