Improve Javadoc; downgrade some log messages to 'debug'.