javadoc up the public API
cleanup the logging