Fix some straightforward Javadoc problems

I've fixed some of the more straightforward Javadoc output warnings.

There's still lots of warnings - some for links to dependent libraries (e.g. opengl, asm). But I thought I'd send a pull request the more trivial ones first and then try and work out if the others can be practically fixed.