Javadoc note pertaining to #1454.