update documentation and javadoc, fix some unncessary logging