From owner-freebsd-doc@FreeBSD.ORG Wed Oct 14 15:30:02 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CCC66106568B for ; Wed, 14 Oct 2009 15:30:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 90CD68FC14 for ; Wed, 14 Oct 2009 15:30:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n9EFU2l0030153 for ; Wed, 14 Oct 2009 15:30:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n9EFU2gD030152; Wed, 14 Oct 2009 15:30:02 GMT (envelope-from gnats) Resent-Date: Wed, 14 Oct 2009 15:30:02 GMT Resent-Message-Id: <200910141530.n9EFU2gD030152@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Warren Block Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A4DC9106566C for ; Wed, 14 Oct 2009 15:23:54 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 93E398FC18 for ; Wed, 14 Oct 2009 15:23:54 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n9EFNsgO050587 for ; Wed, 14 Oct 2009 15:23:54 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n9EFNriA050586; Wed, 14 Oct 2009 15:23:53 GMT (envelope-from nobody) Message-Id: <200910141523.n9EFNriA050586@www.freebsd.org> Date: Wed, 14 Oct 2009 15:23:53 GMT From: Warren Block To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/139605: [patch] Add basic examples to usbconfig man page 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: Wed, 14 Oct 2009 15:30:02 -0000 >Number: 139605 >Category: docs >Synopsis: [patch] Add basic examples to usbconfig man page >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Wed Oct 14 15:30:02 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: 8.0-RC1 >Organization: >Environment: FreeBSD lightning 8.0-RC1 FreeBSD 8.0-RC1 #5: Wed Oct 14 05:35:25 MDT 2009 root@lightning:/usr/obj/usr/src/sys/LIGHTNING i386 >Description: usbconfig man page shows no examples of what kind of input format to use. usbconfig shows devices in the "ugen3.2" format but does not accept that format for input. >How-To-Repeat: Search the usbconfig(8) manpage for an example of whether usbconfig wants /dev/usb/3.2.0, ugen3.2, or any of a number of other possible formats. >Fix: Apply attached patch as a starting point. More examples are needed, particularly about quirks. Patch attached with submission follows: --- usbconfig.8.orig 2009-10-14 08:59:00.000000000 -0600 +++ usbconfig.8 2009-10-14 09:22:24.000000000 -0600 @@ -49,5 +49,14 @@ .It Fl h Show help and available commands. .El +.Sh EXAMPLES +.Pp +List all USB devices: +.Pp +.Dl usbconfig +.Pp +Show information about the device on USB bus 1 at address 2: +.Pp +.Dl usbconfig -u 1 -a 2 dump_info .Sh SEE ALSO .Xr usb 4 >Release-Note: >Audit-Trail: >Unformatted: