Generate Javadoc cross-reference pages; use javadoc's "-use" option

[dsbos]

Please use the javadoc "-use" option to include class-use pages when generating the JUnit Javadoc documentation.

Having that index of back-links to uses of classes and interfaces can be extremely helpful.

(See
http://docs.oracle.com/javase/7/docs/technotes/tools/solaris/javadoc.html#use
and, for an example, see
the "USE" link at the top of
https://docs.oracle.com/javase/8/docs/api/java/security/MessageDigest.html
and its target page
https://docs.oracle.com/javase/8/docs/api/java/security/class-use/MessageDigest.html
.)

[marcphilipp]

Sounds useful. Can you provide a pull request that adds it to the Maven build?

[Tibor17]

The maven plugin has this option, but we did not set it to true in order to cover same result with the Ant script.

[npathai]

@marcphilipp I hope we had to achieve this using maven plugin. I have updated pom.xml with #1051

[marcphilipp]

Fixed by #1051.