improved javadoc
#61: fixed