review javadocs
Merge branch 'master' of https://github.com/nromanen/Ch-025
merge with master