[539580] Correcting and clarifying Javadoc.
5 files changed