Added some Javadocs

I had some issues to fully understand the public methods, thats why i decided to add some javadocs to the methods.

I guess other developers might find this javadocs useful.
I know they aren't perfect, but i hope they are understandable.