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