Date: Mon, 1 Aug 2011 13:46:48 +0000 (UTC) From: Alexander Motin <mav@FreeBSD.org> To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r224576 - projects/hid/usr.bin/usbhidctl Message-ID: <201108011346.p71Dkmps099410@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mav Date: Mon Aug 1 13:46:47 2011 New Revision: 224576 URL: http://svn.freebsd.org/changeset/base/224576 Log: Add SYNTAX section to manual page. Modified: projects/hid/usr.bin/usbhidctl/usbhidctl.1 Modified: projects/hid/usr.bin/usbhidctl/usbhidctl.1 ============================================================================== --- projects/hid/usr.bin/usbhidctl/usbhidctl.1 Mon Aug 1 13:41:38 2011 (r224575) +++ projects/hid/usr.bin/usbhidctl/usbhidctl.1 Mon Aug 1 13:46:47 2011 (r224576) @@ -103,6 +103,37 @@ Reset reports to zero before processing .Fl w arguments. If not specified, current values will be requested from device. .El +.Sh SYNTAX +.Nm +compares the names of items specified on the command line against the human +interface items reported by the USB device. +Each human interface item is mapped from its native form to a human readable +name, using the HID usage table file. +Command line items are compared with the generated item names, +and the USB HID device is operated on when a match is found. +.Pp +Each human interface item is named by the +.Qq page +it appears in, the +.Qq usage +within that page, and the list of +.Qq collections +containing the item. +Each collection in turn is also identified by page, and +the usage within that page. +.Pp +On the +.Nm +command line the page name is separated from the usage name with the character +.Sq Cm \&: . +The collections are separated by the character +.Sq Cm \&. . +.Pp +Some devices give the same name to more than one item. +.Nm +supports isolating each item by appending a +.Sq Cm \&# . +character and a decimal item instance number, starting at zero. .Sh FILES .Pa /usr/share/misc/usb_hid_usages The default HID usage table.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201108011346.p71Dkmps099410>