JavaDoc reports warning for methods named is*Property*

[Asier Lostale]

When generating javadoc, warnings are reported if there are methods named like is*Property* (ie. public boolean isProperty).

This fails with:
openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-8u131-b11-0ubuntu1.16.04.2-b11)
OpenJDK 64-Bit Server VM (build 25.131-b11, mixed mode)

But it works with OracleJDK 8:
java version "1.8.0_131"
Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode)

and it also works with OpenJDK 7:
java version "1.7.0_95"
OpenJDK Runtime Environment (IcedTea 2.6.4) (7u95-2.6.4-3)
OpenJDK 64-Bit Server VM (build 24.95-b01, mixed mode)

Steps to reproduce:
Having the following class:

public class TestJavaDoc {
  public boolean isProperty() {
    return false;
  }
}

run: javadoc TestJavaDoc.java -verbose
Loading source file TestJavaDoc.java...
[parsing started RegularFileObject[TestJavaDoc.java]]
[parsing completed 11ms]
Constructing Javadoc information...
[search path for source files: .]
[search path for class files: /usr/lib/jvm/java-8-openjdk-amd64/jre/lib/resources.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/rt.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/sunrsasign.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/jsse.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/jce.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/charsets.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/jfr.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/classes,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/nashorn.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/sunec.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/icedtea-sound.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/localedata.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/dnsns.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/sunpkcs11.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/jaccess.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/cldrdata.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/zipfs.jar,/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/ext/sunjce_provider.jar,.]
[loading ZipFileIndexFileObject[/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/rt.jar(java/lang/Object.class)]]
Standard Doclet version 1.8.0_131
Building tree for all the packages and classes...
Generating ./TestJavaDoc.html...
TestJavaDoc.java:3: warning - @propertyDescription is an unknown tag.
TestJavaDoc.java:3: warning - Tags @propertyGetter, @propertySetter and @propertyDescription can only be used in JavaFX properties getters and setters.
TestJavaDoc.java:3: warning - Tags @propertyGetter, @propertySetter and @propertyDescription can only be used in JavaFX properties getters and setters.
TestJavaDoc.java:3: warning - @propertyDescription is an unknown tag.
TestJavaDoc.java:3: warning - Tags @propertyGetter, @propertySetter and @propertyDescription can only be used in JavaFX properties getters and setters.
TestJavaDoc.java:3: warning - Tags @propertyGetter, @propertySetter and @propertyDescription can only be used in JavaFX properties getters and setters.
TestJavaDoc.java:3: warning - Tags @propertyGetter, @propertySetter and @propertyDescription can only be used in JavaFX properties getters and setters.
TestJavaDoc.java:3: warning - Tags @propertyGetter, @propertySetter and @propertyDescription can only be used in JavaFX properties getters and setters.
[loading ZipFileIndexFileObject[/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/rt.jar(java/io/Serializable.class)]]
Generating ./package-frame.html...
Generating ./package-summary.html...
Generating ./package-tree.html...
Generating ./constant-values.html...
Building index for all the packages and classes...
Generating ./overview-tree.html...
Generating ./index-all.html...
Generating ./deprecated-list.html...
Building index for all classes...
Generating ./allclasses-frame.html...
Generating ./allclasses-noframe.html...
Generating ./index.html...
Generating ./help-doc.html...
[done in 449 ms]
8 warnings

Note: I reported this issue to openjdk but they rejected considering it a bug in Ubuntu's build:
https://bugs.openjdk.java.net/browse/JDK-8185424

ProblemType: Bug
DistroRelease: Ubuntu 16.04
Package: openjdk-8-jdk-headless 8u131-b11-0ubuntu1.16.04.2
ProcVersionSignature: Ubuntu 4.4.0-79.100-generic 4.4.67
Uname: Linux 4.4.0-79-generic x86_64
ApportVersion: 2.20.1-0ubuntu2.6
Architecture: amd64
CurrentDesktop: Unity
Date: Thu Jul 27 14:53:50 2017
InstallationDate: Installed on 2015-08-03 (724 days ago)
InstallationMedia: Ubuntu 15.04 "Vivid Vervet" - Release amd64 (20150422)
SourcePackage: openjdk-8
UpgradeStatus: Upgraded to xenial on 2016-09-23 (306 days ago)

[Launchpad Janitor (janitor)]

Status changed to 'Confirmed' because the bug affects multiple users.

[Stefan Huehner (stefan-huehner)]

After some more testing that seems to be an upstream openjdk issue as reported in https://bugs.openjdk.java.net/browse/JDK-8185424 [1].

Reason why it did only show up in debian/ubuntu builds is the patch: disable-doclint-by-default.diff.
which defaults javadoc to -Xdoclint:none to avoid warnings.

Adding that -Xdoclint:none option manually make the issue easily reproducible in
a.) oracle binary jdk 8u151
b.) jdk8u openjdk mercurial checkout
c.) not in oracle binary jdk 9.0.1

As i can't directly comment on the openjdk bug i asked in #openjdk to get that issue re-opened there and the info added.

[Thorsten Glaser (mirabilos)]

The messages are no longer shown, I believe there is now a patch to hide them.