#28 Better formatting of javadoc output

[Hanno Braun]

Javadoc ignores all line breaks in the code, which causes the html documentation of some methods to be unreadable.
This could be solved by putting html line breaks (<br>) into the documentation, but only at the expense of readability of the source code documentation.

There has to be some way to tell javadoc to insert line breaks for every line break in the source code, which would be the best way to solve this problem.

[Hanno Braun]

Logged In: YES
user_id=1090331
Originator: YES

Also enhance the Javadoc output by putting links to other classes and "See also" - links where appropriate.