BS-10272, update javadoc