Code review while adding/adjusting/enhancing java doc.