On Mon, Nov 26, 2001 at 09:15:55PM -0800, David Brownell wrote: > > 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.
Very nice, thanks for doing this, I really appreciate it. > 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. Yeah, that might be a good idea, but I don't think it really matters right now. thanks again for the patch. greg k-h _______________________________________________ [EMAIL PROTECTED] To unsubscribe, use the last form field at: https://lists.sourceforge.net/lists/listinfo/linux-usb-devel
