> 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
