LRDOCS-990 Edit Javadoc based on tinatian's suggestions