javadoc
doc on problems encountered