slightly more verbose output
add another value to avoid false alarms (set to a default that doesn't change anything)
deprecate public method so it can be made non-public in the future
fix javadoc