clean up and fix links in javadoc

[BabakFarshchian]

The javadoc available here has lots of broken links and does not look very fancy. Needs to be fixed.

Some resources:

• javadoc tool documentation.
• javadoc overview of documentation.