LPS-32364 Edit Javadoc

Thanks Peter! Here are the edits I have for the Javadoc. In addition fixed some inconsistencies in other comments in thje class.

@moltam89