Fix Javadocs warnings

This PR fixes all warnings thrown while running `ant docs` (incorrect links, parameters, markup).

To test this PR, check the output of the Javadocs target above does not throw any warning or error and that the Javadocs render correctly.