Actually, this was intentional. Yes, the text "Silence Javadoc warnings" could be better, but did you see the "See also" section underneath that? We don't wish to document the same thing twice, because the documentation in the two places can start to drift apart. However, if we do nothing but add the @see tag to the Javadoc of the methods in question, we get lots of warnings about missing Javadoc, which makes it very difficult to see where we truly need to correct the Javadoc.
I'm open to suggestions or to a good replacement for the text "Silence Javadoc warnings".
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Actually, this was intentional. Yes, the text "Silence Javadoc warnings" could be better, but did you see the "See also" section underneath that? We don't wish to document the same thing twice, because the documentation in the two places can start to drift apart. However, if we do nothing but add the @see tag to the Javadoc of the methods in question, we get lots of warnings about missing Javadoc, which makes it very difficult to see where we truly need to correct the Javadoc.
I'm open to suggestions or to a good replacement for the text "Silence Javadoc warnings".
I have replaced "Silence Javadoc warnings" with "Please see the 'See Also' section to make clearer what the purpose of the documentation is.