JDF-286 improved comments in code
Improve javadoc