From the package description of javax.xml.transform.stax:

Provides for StAX-specific transformation APIs. TODO: better description(s).

I just wanted to know what it is! Apparently it has to do with XSLT and the new Java Stream API for XML, whatever that is - because it doesn't contain any description, not even a "TODO."

I expect this level of documentation from random open source libraries, but I kind of expected something more from Sun.