From owner-p4-projects@FreeBSD.ORG Tue Feb 19 20:58:20 2008 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 6C8C016A418; Tue, 19 Feb 2008 20:58:20 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 31B9416A420 for ; Tue, 19 Feb 2008 20:58:20 +0000 (UTC) (envelope-from hselasky@FreeBSD.org) Received: from repoman.freebsd.org (repoman.freebsd.org [IPv6:2001:4f8:fff6::29]) by mx1.freebsd.org (Postfix) with ESMTP id 1777013C467 for ; Tue, 19 Feb 2008 20:58:20 +0000 (UTC) (envelope-from hselasky@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.14.1/8.14.1) with ESMTP id m1JKwJHb022681 for ; Tue, 19 Feb 2008 20:58:19 GMT (envelope-from hselasky@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.1/8.14.1/Submit) id m1JKwJZZ022678 for perforce@freebsd.org; Tue, 19 Feb 2008 20:58:19 GMT (envelope-from hselasky@FreeBSD.org) Date: Tue, 19 Feb 2008 20:58:19 GMT Message-Id: <200802192058.m1JKwJZZ022678@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to hselasky@FreeBSD.org using -f From: Hans Petter Selasky To: Perforce Change Reviews Cc: Subject: PERFORCE change 135748 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 19 Feb 2008 20:58:20 -0000 http://perforce.freebsd.org/chv.cgi?CH=135748 Change 135748 by hselasky@hselasky_laptop001 on 2008/02/19 20:58:16 Add more documentation. Affected files ... .. //depot/projects/usb/src/sys/dev/usb/usb_hid.c#13 edit Differences ... ==== //depot/projects/usb/src/sys/dev/usb/usb_hid.c#13 (text+ko) ==== @@ -76,6 +76,9 @@ int kindset; }; +/*------------------------------------------------------------------------* + * hid_clear_local + *------------------------------------------------------------------------*/ static void hid_clear_local(struct hid_item *c) { @@ -92,6 +95,9 @@ c->set_delimiter = 0; } +/*------------------------------------------------------------------------* + * hid_start_parse + *------------------------------------------------------------------------*/ struct hid_data * hid_start_parse(const void *d, int len, int kindset) { @@ -104,6 +110,9 @@ return (s); } +/*------------------------------------------------------------------------* + * hid_end_parse + *------------------------------------------------------------------------*/ void hid_end_parse(struct hid_data *s) { @@ -117,6 +126,9 @@ free(s, M_TEMP); } +/*------------------------------------------------------------------------* + * hid_get_item + *------------------------------------------------------------------------*/ int hid_get_item(struct hid_data *s, struct hid_item *h) { @@ -367,6 +379,9 @@ } } +/*------------------------------------------------------------------------* + * hid_report_size + *------------------------------------------------------------------------*/ int hid_report_size(const void *buf, int len, enum hid_kind k, uint8_t *idp) { @@ -396,6 +411,9 @@ return ((size + 7) / 8); } +/*------------------------------------------------------------------------* + * hid_locate + *------------------------------------------------------------------------*/ int hid_locate(const void *desc, int size, uint32_t u, enum hid_kind k, struct hid_location *loc, uint32_t *flags) @@ -418,6 +436,9 @@ return (0); } +/*------------------------------------------------------------------------* + * hid_get_data + *------------------------------------------------------------------------*/ u_long hid_get_data(const u_char *buf, uint32_t len, struct hid_location *loc) { @@ -449,6 +470,9 @@ return (data); } +/*------------------------------------------------------------------------* + * hid_is_collection + *------------------------------------------------------------------------*/ int hid_is_collection(const void *desc, int size, uint32_t usage) { @@ -467,6 +491,9 @@ return (err); } +/*------------------------------------------------------------------------* + * hid_get_descriptor_from_usb + *------------------------------------------------------------------------*/ usb_hid_descriptor_t * hid_get_descriptor_from_usb(usb_config_descriptor_t *cd, usb_interface_descriptor_t *id) @@ -488,6 +515,9 @@ return (NULL); } +/*------------------------------------------------------------------------* + * hid_read_report_desc_from_usb + *------------------------------------------------------------------------*/ usbd_status_t hid_read_report_desc_from_usb(struct usbd_device *udev, struct mtx *mtx, void **descp, uint16_t *sizep,