Re: [jdk16] RFR: JDK-8251200: False positive messages about missing comments for serialization

2021-01-06 Thread Jonathan Gibbons
On Tue, 5 Jan 2021 17:00:10 GMT, Hannes Wallnöfer wrote: >> Using the `@serial` tag, a class can explicitly opt-in to being documented >> on the serialized form page. However, a class that does not want to opt-in >> should not be required to have a doc comment, and should not trigger the >> "

Re: [jdk16] RFR: JDK-8251200: False positive messages about missing comments for serialization [v2]

2021-01-06 Thread Jonathan Gibbons
> Using the `@serial` tag, a class can explicitly opt-in to being documented on > the serialized form page. However, a class that does not want to opt-in > should not be required to have a doc comment, and should not trigger the > "missing comment" warning if there is no comment. > > The fix i

[jdk16] Integrated: JDK-8251200: False positive messages about missing comments for serialization

2021-01-06 Thread Jonathan Gibbons
On Thu, 24 Dec 2020 21:16:35 GMT, Jonathan Gibbons wrote: > Using the `@serial` tag, a class can explicitly opt-in to being documented on > the serialized form page. However, a class that does not want to opt-in > should not be required to have a doc comment, and should not trigger the > "mis

Re: [jdk16] RFR: JDK-8249633: doclint reports missing javadoc for JavaFX property methods that have a property description [v2]

2021-01-06 Thread Jonathan Gibbons
> There are two parts to the fix: > > 1. Similar to that of JDK-8251200: predicate methods in `Utils` used to > check if an element has certain tags in its doc comment may trigger the > missing comment check even when there does not need to be a comment. > > 2. When synthesizing comments for t

Re: [jdk16] RFR: JDK-8249633: doclint reports missing javadoc for JavaFX property methods that have a property description [v3]

2021-01-06 Thread Jonathan Gibbons
> There are two parts to the fix: > > 1. Similar to that of JDK-8251200: predicate methods in `Utils` used to > check if an element has certain tags in its doc comment may trigger the > missing comment check even when there does not need to be a comment. > > 2. When synthesizing comments for t

[jdk16] Integrated: JDK-8249633: doclint reports missing javadoc for JavaFX property methods that have a property description

2021-01-06 Thread Jonathan Gibbons
On Fri, 25 Dec 2020 01:56:03 GMT, Jonathan Gibbons wrote: > There are two parts to the fix: > > 1. Similar to that of JDK-8251200: predicate methods in `Utils` used to > check if an element has certain tags in its doc comment may trigger the > missing comment check even when there does not ne

Integrated: 8247957: remove doclint support for HTML 4

2021-01-06 Thread Yoshiki Sato
On Wed, 28 Oct 2020 03:26:16 GMT, Yoshiki Sato wrote: > HTML4 is no longer supported in javadoc. > > doclint needs to drop HTML4 support as well. > The changes consist of: > * Removing -Xhtmlversion option from doclint and --doclint-format from javac. > * Removing jdk.javadoc.internal.doclint.Ht