I created a JIRA issue for this:

https://bugs.openjdk.java.net/browse/JDK-8253240

Naoto

On 9/16/20 2:11 AM, Pavel Rappo wrote:


On 15 Sep 2020, at 21:50, Rob Spoor <open...@icemanx.nl> wrote:

On 15/09/2020 22:02, Pavel Rappo wrote:
On 15 Sep 2020, at 20:50, Brian Burkhalter <brian.burkhal...@oracle.com> wrote:

On Sep 15, 2020, at 12:38 PM, Kevin Rushforth <kevin.rushfo...@oracle.com> 
wrote:

I see this in DecimalFormatSymbols:


     /**
      * Override hashCode.
      */
   private volatile int hashCode;
     @Override
     public int hashCode() {

Although, I'm not sure why the intervening private field would prevent javadoc 
from generating at least a method with an empty doc
https://bugs.openjdk.java.net/browse/JDK-8187386

So in this case, the solution would be to remove the superfluous "Override 
equals." comment from the equals method, right?

It depends on what you want to achieve. On the one hand, if you 'remove the superfluous 
"Override equals."' it will eliminate the discrepancy that you described in 
your original email. On the other hand, a reader might no longer have a clear indication 
that equals and hashCode are meaningfully overridden.

I would simply return "/** Override hashCode */" to its original place, as it 
is clearly a bug that affects documentation.

-Pavel

Reply via email to