[539580] Correcting and clarifying Javadoc.
3 files changed