improved and added javadoc, spelling checks, some improvements