Use Javadocs rather than source code links when possible
Use javadoc extlink across the board
Fix double whitespaces and add Javadoc links
Merge pull request #1489 from sbesson/api_links

Use Javadocs rather than source code links when possible