javadoc, logging and formatting