logging and javadocs