On a related note to the (Usb)NotActiveException discussion, the 
control-type UsbIrp is currently called ControlUsbIrp; but a suggestion 
was made to rename it to UsbControlIrp.  This keeps consistency of the Usb 
prefix.  While we're at it though, let's review all the names:

UsbHub
UsbPort
UsbDevice
UsbConfig
UsbInterface
UsbEndpoint
UsbPipe

all those match the USB spec and are Usb-prefixed, except 'config' is 
abbreviated.  Should it be expanded to UsbConfiguration?

Descriptor
DeviceDescriptor
ConfigDescriptor
InterfaceDescriptor
EndpointDescriptor
StringDescriptor

config is again abbreviated, and none are Usb-prefixed.  Should config be 
expanded and/or all of them be Usb-prefixed?

UsbIrp
ControlUsbIrp -> UsbControlIrp

should ControlUsbIrp -> UsbControlIrp?

UsbException
NotActiveException -> UsbNotActiveException
NotOpenException -> UsbNotOpenException

assuming NotActiveException is restored (instead of using 
java.io.NotActiveExeption), should both use the Usb prefix?  Also, should 
all future javax.usb exceptions have a Usb-prefix?  Note that 
NotActiveException and NotOpenException are _not_ subclasses of 
UsbException, they subclass RuntimeException, as they really are runtime 
exceptions.

UsbHostManager
UsbServices
UsbConst
Version

Assuming UsbHostManager, UsbServices, and UsbConst are ok; should Version 
-> UsbVersion?  It's likely that very few people will use it, and they can 
use the full path if needed; but, it may wind up being the only class not 
prefixed with Usb...

and in the util package, there is

DefaultUsbIrp
DefaultControlUsbIrp -> DefaultUsbControlIrp
StandardRequest
UsbUtil

I think the defaults should stay as is (except as noted), and 
StandardRequest and UsbUtil I think are ok (unless anyone has better 
suggestions for the names).


My opinion is, for all classes (except the util package classes), they 
should be prefixed with Usb; it maintains consistency.  Also, I think 
Config should be expanded to Configuration, even though it's a bit long, 
since nothing else is abbreviated.  I think ControlUsbIrp->UsbControlIrp.



-- 
Dan Streetman
[EMAIL PROTECTED]
---------------------
186,272 miles per second:
It isn't just a good idea, it's the law!


-------------------------------------------------------
This SF.NET email is sponsored by: Take your first step towards giving 
your online business a competitive advantage. Test-drive a Thawte SSL 
certificate - our easy online guide will show you how. Click here to get 
started: http://ads.sourceforge.net/cgi-bin/redirect.pl?thaw0027en
_______________________________________________
javax-usb-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/javax-usb-devel

Reply via email to