As promised, here's kerneldoc for about 20 more public usbcore functions. "make htmldocs" to see this through the linux/Documentation/DocBook/kernel-api/usb.html file. The patch is against 2.4.15-pre7, but I'd expect it to apply reasonably cleanly against other recent kernels. (That is, not just for 2.5.0 ... :)
It's worth some review of the text here, but I think it's pretty good as-is. If nobody updates this doc in the next day or two, I'd like to see this get merged into current kernels (before anything evolves much further :), and use patches to address any later issues. You'll notice one minor code change: an err() added in usb_driver_claim_interface() in the case of a bug that the current API can't report. And there are a few comments about other things I noted in what was effectively a mini code-review. But it's basically all just kerneldoc for functions declared in <linux/usb.h> and exported from "usb.c". - Dave
coredoc-1125.patch
Description: Binary data
