ref #10101 add some javadoc