CSP1150 A1: updated javadocs