Merge "clarify javadoc for constructors. bug: 10563421" into jb-mr2-docs