> > > Somewhat related, more of the usbcore functions should show up in
> > > the kernel programming guide -- not a separate doc.
> > 
> > Are there any public functions that aren't documented?
> 
> Yes.  I'll try provide a patch to document some of them soon.

Coming up shortly.  I documented about twenty more
functions, which is more than were already documented.
(That is, by "make htmldocs" at the top level).  There's a
lot of stuff in "usb.h" that's not documented.

As usual, this kind of stuff makes me think "API Cleanup!!"

I added docs for the "usbcore-internal" functions that are
accessed both by hub code and by virtual root hubs, but
not for stuff that's hub-only ... a lot of those functions should
IMO move into the "hub.c" file and no longer be exported.

Ideally all of those "usbcore-internal" functions would be in
a separate file so "make htmldocs" would show them up
in a separate category -- that can be done easily enough
in the 2.5 tree.  The "hcd.c" file only holds functions like that.

I also chose not to document various functions that exist
for HID-only functionality.  It's not clear why any of that
exists outside of "hid.c"; again, I think they should move,
and no longer be used.  (The few that are used!)

- Dave



_______________________________________________
[EMAIL PROTECTED]
To unsubscribe, use the last form field at:
https://lists.sourceforge.net/lists/listinfo/linux-usb-devel

Reply via email to