JavaDocs are hard to read with fully qualified names for java.lang, java.util and other non-Spring classes [SPR-5734]

[spring-projects-issues]

Thomas Risberg opened SPR-5734 and commented

JavaDocs are hard to read with fully qualified names for java.lang, java.util and other non-Spring classes

---

Affects: 3.0 M3

Referenced from: commits 54c768d

[spring-projects-issues]

Mark Pollack commented

The javadoc option noqualifier, for example

noqualifier="java.:com.sun."

will remove this...so one gets

<T> Future<T> submit(Callable<T> task)

instead of

<T> java.util.concurrent.Future<T> submit(java.util.concurrent.Callable<T> task)

I've put an issue to Ben to include this in an update to the build infrastructure.

[spring-projects-issues]

nebhale commented

I didn't update spring-build with the noqualifier content. Instead, I update the spring-framework build to be more like the 2.5 version where external types were javadoc linked.

You can see the update I made in the build-spring-framework/build.xml file. I simply copied the list from the 2.5 build, but it is incorrect and incomplete in places. Someone should go back and update the links that are there for the new dependencies.