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 target above does not throw any warning (I still have 7 errors due to missing dependencies which will be fixed in another PR) and that the Javadocs render correctly.