The trouble with those APIs is that its hard to tell just by looking at the interface as to how one should use it.
Does one
One should be able to look at the javadocs to see this. But one has to be able to do "reverse lookup" to do it, as in "ok, here's a [interface] that seems to have what I need, so how to get one, and click on "Use" to find public implementations and/or classes that return instances of that interface, so one can drill up to find the correct starting point for the API.
Leave off "-use" in your javadoc command and one has to click through every single package and almost every single class to try track down where it comes from. If there's a user's guide to look up, then its (a little tiny bit) less important, but having -use makes it so easy...
So everybody making public javadocs to distribute with your software: include the -use in the build instructions, ok?