In the javadocs some APIs (outside java.lang
and java.util
) the "Use" section is missing.
XMLStreamReader for example. It is a bit unpleasant that you can't tell what classes of the API return the class that you need, based on the javadoc, and you must employ some other tricks (like IDE features) to do this.
Is there any reason for not including the "Use" section in these APIs?