improved javadoc
3 files changed