improve javadoc
tiny code cleanup
[de] fix false alarms