> linux/usb.h needs to be converted to the kerneldoc format too (it now > supports structures and #defines.) Any volunteers? :)
Thus far and no further! Any more work on this stuff and I'll be compelled to convert it to using the DocBook XML/XSLT stylesheets just to get reasonable output -- this Jade/DSSL stuff is just not as good as more current tools. And the Perl scripts are just not as robust as a GCC front end would be ... might be worth looking at switching to one of the other C-ish doc generators. (This _really_ makes me appreciate Javadoc!) This covers the three structs that driver developers really ought to know about: usb_device_id, usb_driver, and (drumroll) urb. There's also a little bonus background info tossed in, stuff that I know I wasn't alone in struggling to figure out way back when, summarizing the (complex) model of a USB device. Strongly tempted to reorganize the fields in "urb" so they make some sense in terms of presentation, but ... no. Not yet. I did some cross checking with Deti's stuff too. It doesn't sound as simple as I'd like, mostly because it really isn't simple at all, but being able to present struct fields in smarter order would be a big help. - Dave
coredoc-1126.patch
Description: Binary data
