Re: [PATCH] HID: Documentation for hidraw

From: Alan Ott
Date: Fri Jun 18 2010 - 09:38:11 EST


On 06/18/2010 05:57 AM, Antonio Ospite wrote:

Maybe both hidraw.txt and hiddev.txt can be moved to
Documentation/hid/?

Antonio,

You and Jiri seem to have the same idea on this one. Sounds good to me.
+
+HIDIOCGRAWNAME(len): Get Raw Name
+This ioctl returns a string containing the vendor and product strings of
+the device. The returned string is Unicode, UTF-8 encoded.
+
Is the encoding specified in the HID spec?
USB returns strings to the host as Unicode, UTF16LE encoded. The kernel converts them to UTF-8. See usb_string() in drivers/usb/core/message.c.


Just a very minimal remark, maybe the code should follow the kernel
coding style (early return on error, no braces for one line conditional
blocks) even if it is a userspace application. Being it in the
kernel Documentation I assume people reading it would be used to kernel
style more.

Good point. I'll run the style check on it and fix it up.

Alan.

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/