logic and javadoc
Merge remote-tracking branch 'origin/master'