PERFORCE change 135748 for review

[Hans Petter Selasky]

http://perforce.freebsd.org/chv.cgi?CH=135748

Change 135748 by hselasky at 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,