javadoc fixes and change of version numbering in pom.xml

Fixed a lot of javadoc issues in the source code.
Versioning numbering in the pom.xml is now just major.minor whereas the git numbering will keep its three numbers.