RFR: 8202056: Expand serial warning to check for bad overloads of serial-related methods and ineffectual fields

2021-09-27 Thread Joe Darcy
This is an initial PR for expanded lint warnings done under two bugs: 8202056: Expand serial warning to check for bad overloads of serial-related methods and ineffectual fields 8160675: Issue lint warning for non-serializable non-transient instance fields in serializable type to get feedback on

RFR: 8274396: Suppress more warnings on non-serializable non-transient intance fields in client libs

2021-09-27 Thread Joe Darcy
Follow-up changes to JDK-8231334. , augmentations to javac's Xlint:serial checking are out for review (#5709) and various client libraries would need some changes to pass under the expanded checks. The changes are to suppress warnings where non-transient fields in serializable types are not dec

Re: RFR: 8274396: Suppress more warnings on non-serializable non-transient intance fields in client libs [v2]

2021-09-27 Thread Joe Darcy
s in > serializable types are not declared with a type statically known to be > serializable. That isn't necessarily a correctness issues, but it does merit > further scrutiny. > > I'll run a script to update the copyright year before pushing. Joe Darcy has updated the p

Re: RFR: 8274396: Suppress more warnings on non-serializable non-transient intance fields in client libs

2021-09-27 Thread Joe Darcy
On Mon, 27 Sep 2021 21:40:13 GMT, Sergey Bylokhov wrote: > > > Can we add comments to SuppressWarnings on why it was added? Previously we > use this text > > > // Not statically typed as Serializable Added in revision; used a different comment wording. - PR: https://git.openjdk

Integrated: 8274396: Suppress more warnings on non-serializable non-transient instance fields in client libs

2021-09-28 Thread Joe Darcy
On Mon, 27 Sep 2021 20:21:43 GMT, Joe Darcy wrote: > Follow-up changes to JDK-8231334. , augmentations to javac's Xlint:serial > checking are out for review (#5709) and various client libraries would need > some changes to pass under the expanded checks. > > The cha

Re: RFR: JDK-8276447 Deprecate finalization-related methods for removal

2021-11-19 Thread Joe Darcy
On Thu, 18 Nov 2021 21:51:30 GMT, Brent Christian wrote: > Here are the code changes for the "Deprecate finalizers in the standard Java > API" portion of JEP 421 ("Deprecate Finalization for Removal") for code > review. > > This change makes the indicated deprecations, and updates the API spec

RFR: JDK-8278175: Enable all doclint warnings for build of java.desktop

2021-12-02 Thread Joe Darcy
In JDK 18, JDK-8189591 added the ability to suppress doclint warnings. Therefore, it is now possible to enable the full doclint checks for the java.desktop module if the instances of warnings are suppressed. This patch does this; it would be preferable to address the doc warnings directly, but

Integrated: JDK-8278175: Enable all doclint warnings for build of java.desktop

2021-12-03 Thread Joe Darcy
On Fri, 3 Dec 2021 01:18:20 GMT, Joe Darcy wrote: > In JDK 18, JDK-8189591 added the ability to suppress doclint warnings. > Therefore, it is now possible to enable the full doclint checks for the > java.desktop module if the instances of warnings are suppressed. This patch > d

Re: RFR: JDK-8278175: Enable all doclint warnings for build of java.desktop

2021-12-03 Thread Joe Darcy
On Fri, 3 Dec 2021 01:18:20 GMT, Joe Darcy wrote: > In JDK 18, JDK-8189591 added the ability to suppress doclint warnings. > Therefore, it is now possible to enable the full doclint checks for the > java.desktop module if the instances of warnings are suppressed. This patch > d

Re: RFR: 8278251: Enable "missing-explicit-ctor" check in the jdk.unsupported.desktop module

2021-12-06 Thread Joe Darcy
On Fri, 3 Dec 2021 20:55:23 GMT, Sergey Bylokhov wrote: > The "missing-explicit-ctor" check was disabled by the > [JDK-8071961](https://bugs.openjdk.java.net/browse/JDK-8071961) and later was > fixed by the [JDK-8250853](https://bugs.openjdk.java.net/browse/JDK-8250853). > So we can re-enable

RFR: JDK-8280492: Address remaining doclint issues in JDK build

2022-01-22 Thread Joe Darcy
Use presumed syntax that will be introduced by JDK-8280488. - Commit messages: - JDK-8280492: Address remaining doclint issues in JDK build Changes: https://git.openjdk.java.net/jdk/pull/7189/files Webrev: https://webrevs.openjdk.java.net/?repo=jdk&pr=7189&range=00 Issue: https:/

Re: RFR: JDK-8280492: Address remaining doclint issues in JDK build

2022-01-22 Thread Joe Darcy
On Sat, 22 Jan 2022 21:09:03 GMT, Joe Darcy wrote: > Use presumed syntax that will be introduced by JDK-8280488. This should be the (near) final step to fully enable all doclint checks during the javac portion of the build. The "reference" doclint check is currently disabled

Re: RFR: JDK-8280492: Address remaining doclint issues in JDK build

2022-01-24 Thread Joe Darcy
On Mon, 24 Jan 2022 11:33:18 GMT, Pavel Rappo wrote: > > Use presumed syntax that will be introduced by JDK-8280488. > > Is that a wrong bug? If you are talking about module-prefix syntax for links, > then it was introduced in JDK 15; JDK-8164408: Add module support for @see, > @link and @link

Re: RFR: JDK-8280492: Use cross-module syntax for cross-module links [v2]

2022-01-24 Thread Joe Darcy
> Use presumed syntax that will be introduced by JDK-8280488. Joe Darcy has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains three additional commits si

Integrated: JDK-8280492: Use cross-module syntax for cross-module links

2022-01-24 Thread Joe Darcy
On Sat, 22 Jan 2022 21:09:03 GMT, Joe Darcy wrote: > Use presumed syntax that will be introduced by JDK-8280488. This pull request has now been integrated. Changeset: 8e82d002 Author: Joe Darcy URL: https://git.openjdk.java.net/jdk/commit/8e82d0021c119b7793870811fad37d7659c11

Re: RFR: 8282657: Code cleanup: removing double semicolons at the end of lines

2022-03-04 Thread Joe Darcy
On Fri, 28 Jan 2022 14:39:31 GMT, Matteo Baccan wrote: > Hi > > I have reviewed the code for removing double semicolons at the end of lines > > all the best > matteo Marked as reviewed by darcy (Reviewer). - PR: https://git.openjdk.java.net/jdk/pull/7268

Re: RFR: 8283700: Add final or sealed modifier to appropriate java.awt API classes

2022-03-28 Thread Joe Darcy
On Mon, 28 Mar 2022 16:30:50 GMT, Phil Race wrote: > JDK 17 delivered JEP 409: Sealed Classes : https://openjdk.java.net/jeps/409 > In essence this JEP allows a class to limit which classes can subclass it. > If a class has no subclasses and cannot be subclassed outside the JDK it can > also be

Re: RFR: 8283700: Add final or sealed modifier to appropriate java.awt API classes

2022-03-28 Thread Joe Darcy
On Mon, 28 Mar 2022 16:30:50 GMT, Phil Race wrote: > JDK 17 delivered JEP 409: Sealed Classes : https://openjdk.java.net/jeps/409 > In essence this JEP allows a class to limit which classes can subclass it. > If a class has no subclasses and cannot be subclassed outside the JDK it can > also be

Re: RFR: 8283700: Add final or sealed modifier to appropriate java.awt API classes

2022-03-28 Thread Joe Darcy
On Tue, 29 Mar 2022 04:16:06 GMT, Prasanta Sadhukhan wrote: > > Suitable classes across the JDK are being retro-fitted to be sealed > > How does this "suitability" check done? Are these exhaustive or more awt > classes will be added? Do we need to do the same for swing classes too? I wrote an

Re: RFR: 8283706: Add final or sealed modifier to appropriate javax.swing API classes

2022-04-05 Thread Joe Darcy
On Wed, 6 Apr 2022 05:25:43 GMT, Sergey Bylokhov wrote: >> Update Swing classes to use JEP 409 sealed and non-sealed modifiers and add >> the final modifier where appropriate. >> >> jtreg tests and JCK API tests pass >> >> CSR for review here : https://bugs.openjdk.java.net/browse/JDK-8284214

Re: RFR: 8283706: Add final or sealed modifier to appropriate javax.swing API classes

2022-04-06 Thread Joe Darcy
On Wed, 6 Apr 2022 20:14:12 GMT, Sergey Bylokhov wrote: >> Yes, that is fine; javadoc will filter out displaying non-public classes in >> a permits clause. > > Just to double-check, it is fine to have it in the output of the > getPermittedSubclasses for the public class as well? I'm not certai

Re: RFR: 8283706: Add final or sealed modifier to appropriate javax.swing API classes

2022-04-07 Thread Joe Darcy
On Thu, 7 Apr 2022 19:33:28 GMT, Phil Race wrote: >> Thank you for your clarification. > > You have to include it in the list, else it would not be a permitted > sub-class, and then you couldn't use the new syntax at all. > > the javadoc doesn't mention it - it still just says > public sealed c

RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces

2022-04-26 Thread Joe Darcy
To enable more complete doclint checking (courtesy @jonathan-gibbons), please review this PR to add type-level @param tags where they are missing. To the maintainers of java.util.concurrent, those changes could be separated out in another bug if that would ease maintenance of that code. Making

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces

2022-04-27 Thread Joe Darcy
On Wed, 27 Apr 2022 01:39:27 GMT, Stuart Marks wrote: >> To enable more complete doclint checking (courtesy @jonathan-gibbons), >> please review this PR to add type-level @param tags where they are missing. >> >> To the maintainers of java.util.concurrent, those changes could be separated >> o

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces

2022-04-27 Thread Joe Darcy
On Wed, 27 Apr 2022 10:54:00 GMT, Daniel Fuchs wrote: >> To enable more complete doclint checking (courtesy @jonathan-gibbons), >> please review this PR to add type-level @param tags where they are missing. >> >> To the maintainers of java.util.concurrent, those changes could be separated >> o

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v2]

2022-04-27 Thread Joe Darcy
On Wed, 27 Apr 2022 10:55:22 GMT, Daniel Fuchs wrote: >> Joe Darcy has updated the pull request with a new target base due to a merge >> or a rebase. The incremental webrev excludes the unrelated changes brought >> in by the merge/rebase. The pull request contains three

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v2]

2022-04-27 Thread Joe Darcy
tenance of that code. > > Making these library fixes is a blocker for correcting and expanding the > doclint checks (JDK-8285496). > > I'll update copyright years before pushing. Joe Darcy has updated the pull request with a new target base due to a merge or a rebase. The increm

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v3]

2022-04-27 Thread Joe Darcy
tenance of that code. > > Making these library fixes is a blocker for correcting and expanding the > doclint checks (JDK-8285496). > > I'll update copyright years before pushing. Joe Darcy has updated the pull request incrementally with one additional commit since the last

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v3]

2022-04-27 Thread Joe Darcy
On Wed, 27 Apr 2022 23:24:57 GMT, Stuart Marks wrote: >> I said "keys maintained", omitting "by this map" to finesse the question of >> if the SimpleEntry class *is* a map, or is used to implement a map, etc. I >> can change it to include "by this map" if the map/entry distinction is okay >> t

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v3]

2022-04-28 Thread Joe Darcy
On Thu, 28 Apr 2022 08:08:37 GMT, Alan Bateman wrote: >> Joe Darcy has updated the pull request incrementally with one additional >> commit since the last revision: >> >> Respond to more review feedback. > > src/java.base/share/classes/java/nio/file/Secu

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v4]

2022-04-28 Thread Joe Darcy
tenance of that code. > > Making these library fixes is a blocker for correcting and expanding the > doclint checks (JDK-8285496). > > I'll update copyright years before pushing. Joe Darcy has updated the pull request incrementally with one additional commit since the last

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v3]

2022-04-28 Thread Joe Darcy
On Thu, 28 Apr 2022 08:10:38 GMT, Alan Bateman wrote: >> Joe Darcy has updated the pull request incrementally with one additional >> commit since the last revision: >> >> Respond to more review feedback. > > src/java.base/share/classes/java/nio/file/Wat

Re: RFR: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces [v5]

2022-04-28 Thread Joe Darcy
tenance of that code. > > Making these library fixes is a blocker for correcting and expanding the > doclint checks (JDK-8285496). > > I'll update copyright years before pushing. Joe Darcy has updated the pull request with a new target base due to a merge or a rebase. The increm

Integrated: JDK-8285676: Add missing @param tags for type parameters on classes and interfaces

2022-04-28 Thread Joe Darcy
On Tue, 26 Apr 2022 22:24:26 GMT, Joe Darcy wrote: > To enable more complete doclint checking (courtesy @jonathan-gibbons), please > review this PR to add type-level @param tags where they are missing. > > To the maintainers of java.util.concurrent, those changes could be separat

Re: RFR: 8244681: Add a warning for possibly lossy conversion in compound assignments

2022-05-09 Thread Joe Darcy
On Mon, 9 May 2022 15:56:35 GMT, Adam Sotona wrote: > Please review this patch adding new lint option, **lossy-conversions**, to > javac to warn about type casts in compound assignments with possible lossy > conversions. > > The new lint warning is shown if the type of the right-hand operand o

RFR: JDK-8286787: Expand use of @inheritDoc in AudioInputStream

2022-05-15 Thread Joe Darcy
Client libs counterpart of JDK-8286783, refactor the docs in AudioInputStream to inhertiDoc text from InputStream. I'll update copyrights before pushing. - Commit messages: - JDK-8286787: Expand use of @inheritDoc in AudioInputStream Changes: https://git.openjdk.java.net/jdk/pull/

Re: RFR: JDK-8286787: Expand use of @inheritDoc in AudioInputStream [v2]

2022-05-16 Thread Joe Darcy
> Client libs counterpart of JDK-8286783, refactor the docs in AudioInputStream > to inhertiDoc text from InputStream. > > I'll update copyrights before pushing. Joe Darcy has updated the pull request with a new target base due to a merge or a rebase. The incremental we

Integrated: JDK-8286787: Expand use of @inheritDoc in AudioInputStream

2022-05-16 Thread Joe Darcy
On Sun, 15 May 2022 21:05:47 GMT, Joe Darcy wrote: > Client libs counterpart of JDK-8286783, refactor the docs in AudioInputStream > to inhertiDoc text from InputStream. > > I'll update copyrights before pushing. This pull request has now been integrated. Changeset: af2918