From prr at openjdk.java.net Fri Oct 2 18:24:41 2020 From: prr at openjdk.java.net (Phil Race) Date: Fri, 2 Oct 2020 18:24:41 GMT Subject: RFR: 8251123: doclint warnings about missing javadoc tags and comments In-Reply-To: References: Message-ID: On Fri, 25 Sep 2020 21:45:39 GMT, Sergey Bylokhov wrote: > We have a number of missing javadoc tags and comments in the desktop module. > Most of the missing comments are related to the serialized form. > > The fix: > - Adds missing comments to the non-static/non-transient fields(even private) of the "serializable" classes > - Adds comments to the "serializable" classes even if those classes are non-public > - Fixes references/adds missing tags to the special methods(like readObject/writeObject) > - Delete the java.awt.PeerFixer class. > > I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) > > Note that in some cases I added the comments to the "implementation details", so I did not specify it fully. > > The old review request: > https://mail.openjdk.java.net/pipermail/beans-dev/2020-August/000423.html src/java.desktop/share/classes/javax/imageio/metadata/IIOMetadataNode.java line 44: > 42: /** > 43: * A {@code IIODOMException} is thrown by the {@code IIOMetadataNode} in > 44: * "exceptional" circumstances. "A" -> "An" ------------- PR: https://git.openjdk.java.net/jdk/pull/369 From prr at openjdk.java.net Fri Oct 2 18:38:39 2020 From: prr at openjdk.java.net (Phil Race) Date: Fri, 2 Oct 2020 18:38:39 GMT Subject: RFR: 8251123: doclint warnings about missing javadoc tags and comments In-Reply-To: References: Message-ID: <_0gBfrD0z0Z7EFJ4SHXPR3namwcJkFJofC7GGwXOdq8=.901366c2-b6bc-4215-866d-f613def1006e@github.com> On Fri, 25 Sep 2020 21:45:39 GMT, Sergey Bylokhov wrote: > We have a number of missing javadoc tags and comments in the desktop module. > Most of the missing comments are related to the serialized form. > > The fix: > - Adds missing comments to the non-static/non-transient fields(even private) of the "serializable" classes > - Adds comments to the "serializable" classes even if those classes are non-public > - Fixes references/adds missing tags to the special methods(like readObject/writeObject) > - Delete the java.awt.PeerFixer class. > > I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) > > Note that in some cases I added the comments to the "implementation details", so I did not specify it fully. > > The old review request: > https://mail.openjdk.java.net/pipermail/beans-dev/2020-August/000423.html I think the main thing here is I would separate out removing the duplicate PeerFixer into a new bug. I also see that the CSR is still just a pure template. src/java.desktop/share/classes/java/awt/ScrollPane.java line 815: > 813: > 814: /* > 815: * In JDK 1.1.1, the pkg private class java.awt.PeerFixer was moved to As I mentioned in the OLD review thread for hg, this definitely needs a CSR and it needs to be called out. I think it should be separated out from this fix which is about fixing doclint warnings but here you are making an incompatible change. Let's not mix the two. src/java.desktop/share/classes/java/awt/CheckboxMenuItem.java line 434: > 432: * @serial > 433: */ > 434: private int checkboxMenuItemSerializedDataVersion = 1; OK. Good this was being discussed in the old review and it should stay. src/java.desktop/share/classes/java/awt/ContainerOrderFocusTraversalPolicy.java line 75: > 73: * This constant is used when the backward focus traversal order is active. > 74: */ > 75: private final int BACKWARD_TRAVERSAL = 1; I see you also reverted the change of these two to static so that is also good. ------------- Changes requested by prr (Reviewer). PR: https://git.openjdk.java.net/jdk/pull/369 From prr at openjdk.java.net Fri Oct 2 19:48:40 2020 From: prr at openjdk.java.net (Phil Race) Date: Fri, 2 Oct 2020 19:48:40 GMT Subject: RFR: 8251123: doclint warnings about missing javadoc tags and comments In-Reply-To: <_0gBfrD0z0Z7EFJ4SHXPR3namwcJkFJofC7GGwXOdq8=.901366c2-b6bc-4215-866d-f613def1006e@github.com> References: <_0gBfrD0z0Z7EFJ4SHXPR3namwcJkFJofC7GGwXOdq8=.901366c2-b6bc-4215-866d-f613def1006e@github.com> Message-ID: On Fri, 2 Oct 2020 18:35:25 GMT, Phil Race wrote: >> We have a number of missing javadoc tags and comments in the desktop module. >> Most of the missing comments are related to the serialized form. >> >> The fix: >> - Adds missing comments to the non-static/non-transient fields(even private) of the "serializable" classes >> - Adds comments to the "serializable" classes even if those classes are non-public >> - Fixes references/adds missing tags to the special methods(like readObject/writeObject) >> - Delete the java.awt.PeerFixer class. >> >> I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) >> >> Note that in some cases I added the comments to the "implementation details", so I did not specify it fully. >> >> The old review request: >> https://mail.openjdk.java.net/pipermail/beans-dev/2020-August/000423.html > > I think the main thing here is I would separate out removing the duplicate PeerFixer into a new bug. > > I also see that the CSR is still just a pure template. > I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) Probably almost all of it. ------------- PR: https://git.openjdk.java.net/jdk/pull/369 From serb at openjdk.java.net Sat Oct 3 00:31:48 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Sat, 3 Oct 2020 00:31:48 GMT Subject: RFR: 8251123: doclint warnings about missing javadoc tags and comments [v2] In-Reply-To: References: Message-ID: <6Ov7jdR5aBYuiqkmH1WnBXafvEMKjs0J56Qu5icFAzw=.eef7d4ff-1daf-44c7-8424-030a638c7c30@github.com> > We have a number of missing javadoc tags and comments in the desktop module. > Most of the missing comments are related to the serialized form. > > The fix: > - Adds missing comments to the non-static/non-transient fields(even private) of the "serializable" classes > - Adds comments to the "serializable" classes even if those classes are non-public > - Fixes references/adds missing tags to the special methods(like readObject/writeObject) > - Delete the java.awt.PeerFixer class. > > I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) > > Note that in some cases I added the comments to the "implementation details", so I did not specify it fully. > > The old review request: > https://mail.openjdk.java.net/pipermail/beans-dev/2020-August/000423.html Sergey Bylokhov has updated the pull request incrementally with two additional commits since the last revision: - Update ScrollPane.java - Update based on the feedback ------------- Changes: - all: https://git.openjdk.java.net/jdk/pull/369/files - new: https://git.openjdk.java.net/jdk/pull/369/files/cfc1df5d..c1d83696 Webrevs: - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=369&range=01 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=369&range=00-01 Stats: 52 lines in 3 files changed: 49 ins; 1 del; 2 mod Patch: https://git.openjdk.java.net/jdk/pull/369.diff Fetch: git fetch https://git.openjdk.java.net/jdk pull/369/head:pull/369 PR: https://git.openjdk.java.net/jdk/pull/369 From serb at openjdk.java.net Sat Oct 3 03:59:39 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Sat, 3 Oct 2020 03:59:39 GMT Subject: RFR: 8251123: doclint warnings about missing javadoc tags and comments [v2] In-Reply-To: References: <_0gBfrD0z0Z7EFJ4SHXPR3namwcJkFJofC7GGwXOdq8=.901366c2-b6bc-4215-866d-f613def1006e@github.com> Message-ID: On Fri, 2 Oct 2020 19:46:10 GMT, Phil Race wrote: >> I think the main thing here is I would separate out removing the duplicate PeerFixer into a new bug. >> >> I also see that the CSR is still just a pure template. > >> I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) > > Probably almost all of it. The PeerFixer is extracted to the separate CR: https://bugs.openjdk.java.net/browse/JDK-8253965 https://github.com/openjdk/jdk/pull/493 Other review comments fixed as well, CSR is in progress. ------------- PR: https://git.openjdk.java.net/jdk/pull/369 From serb at openjdk.java.net Sat Oct 3 04:47:38 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Sat, 3 Oct 2020 04:47:38 GMT Subject: RFR: 8251123: doclint warnings about missing javadoc tags and comments [v2] In-Reply-To: References: <_0gBfrD0z0Z7EFJ4SHXPR3namwcJkFJofC7GGwXOdq8=.901366c2-b6bc-4215-866d-f613def1006e@github.com> Message-ID: On Sat, 3 Oct 2020 03:57:21 GMT, Sergey Bylokhov wrote: >>> I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) >> >> Probably almost all of it. > > The PeerFixer is extracted to the separate CR: > https://bugs.openjdk.java.net/browse/JDK-8253965 > https://github.com/openjdk/jdk/pull/493 > > Other review comments fixed as well, CSR is in progress. CSR is updated. ------------- PR: https://git.openjdk.java.net/jdk/pull/369 From prr at openjdk.java.net Sat Oct 3 19:36:38 2020 From: prr at openjdk.java.net (Phil Race) Date: Sat, 3 Oct 2020 19:36:38 GMT Subject: RFR: 8251123: doclint warnings about missing javadoc tags and comments [v2] In-Reply-To: <6Ov7jdR5aBYuiqkmH1WnBXafvEMKjs0J56Qu5icFAzw=.eef7d4ff-1daf-44c7-8424-030a638c7c30@github.com> References: <6Ov7jdR5aBYuiqkmH1WnBXafvEMKjs0J56Qu5icFAzw=.eef7d4ff-1daf-44c7-8424-030a638c7c30@github.com> Message-ID: On Sat, 3 Oct 2020 00:31:48 GMT, Sergey Bylokhov wrote: >> We have a number of missing javadoc tags and comments in the desktop module. >> Most of the missing comments are related to the serialized form. >> >> The fix: >> - Adds missing comments to the non-static/non-transient fields(even private) of the "serializable" classes >> - Adds comments to the "serializable" classes even if those classes are non-public >> - Fixes references/adds missing tags to the special methods(like readObject/writeObject) >> - Delete the java.awt.PeerFixer class. >> >> I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) >> >> Note that in some cases I added the comments to the "implementation details", so I did not specify it fully. >> >> The old review request: >> https://mail.openjdk.java.net/pipermail/beans-dev/2020-August/000423.html > > Sergey Bylokhov has updated the pull request incrementally with two additional commits since the last revision: > > - Update ScrollPane.java > - Update based on the feedback Marked as reviewed by prr (Reviewer). ------------- PR: https://git.openjdk.java.net/jdk/pull/369 From serb at openjdk.java.net Tue Oct 6 10:52:46 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Tue, 6 Oct 2020 10:52:46 GMT Subject: Integrated: 8251123: doclint warnings about missing javadoc tags and comments In-Reply-To: References: Message-ID: On Fri, 25 Sep 2020 21:45:39 GMT, Sergey Bylokhov wrote: > We have a number of missing javadoc tags and comments in the desktop module. > Most of the missing comments are related to the serialized form. > > The fix: > - Adds missing comments to the non-static/non-transient fields(even private) of the "serializable" classes > - Adds comments to the "serializable" classes even if those classes are non-public > - Fixes references/adds missing tags to the special methods(like readObject/writeObject) > - Delete the java.awt.PeerFixer class. > > I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal) > > Note that in some cases I added the comments to the "implementation details", so I did not specify it fully. > > The old review request: > https://mail.openjdk.java.net/pipermail/beans-dev/2020-August/000423.html This pull request has now been integrated. Changeset: f397b60a Author: Sergey Bylokhov URL: https://git.openjdk.java.net/jdk/commit/f397b60a Stats: 1256 lines in 69 files changed: 809 ins; 165 del; 282 mod 8251123: doclint warnings about missing javadoc tags and comments Reviewed-by: jdv, prr ------------- PR: https://git.openjdk.java.net/jdk/pull/369 From serb at openjdk.java.net Wed Oct 14 05:27:23 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Wed, 14 Oct 2020 05:27:23 GMT Subject: RFR: 8231454: File lock in Windows on a loaded jar due to a leak in Introspector::getBeanInfo Message-ID: java.beans.Introspector is using a new cache mechanism since Java9 in com.sun.beans.introspect.ClassInfo::CACHE which uses a SoftReference cache over the class, which makes the class "leak", unless clearing the cache manually or collecting the SoftReference by the GC. Note that this is not a pure "leak", because the SoftReference will be collected if there is no enough memory on the system, but if the heap is big enough then all objects referenced from the cached class will be in the memory. The class has a reference to the ClassLoader, and If the soft reference to the class is not collected by the GC, then the ClassLoader cannot be unloaded and this block the jar file removing. The solution is to update the implementation of Introspector.flushCaches()/flushFromCaches(Class) to clear the whole cache or the cache for the specific class. ------------- Commit messages: - Update FlushClassInfoCache.java - Initial fix Changes: https://git.openjdk.java.net/jdk/pull/647/files Webrev: https://webrevs.openjdk.java.net/?repo=jdk&pr=647&range=00 Issue: https://bugs.openjdk.java.net/browse/JDK-8231454 Stats: 113 lines in 3 files changed: 109 ins; 1 del; 3 mod Patch: https://git.openjdk.java.net/jdk/pull/647.diff Fetch: git fetch https://git.openjdk.java.net/jdk pull/647/head:pull/647 PR: https://git.openjdk.java.net/jdk/pull/647 From serb at openjdk.java.net Tue Oct 20 08:41:19 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Tue, 20 Oct 2020 08:41:19 GMT Subject: RFR: 8255043: Incorrectly styled copyright text Message-ID: In some files, the copyright text is styled as a JavaDoc comment. Most of the affected files are tests, only one product file is affected: src/java.sql/share/classes/javax/sql/package-info.java The chenge is trivial: - /** + /* * Copyright (c) ------------- Commit messages: - Initial fix Changes: https://git.openjdk.java.net/jdk/pull/759/files Webrev: https://webrevs.openjdk.java.net/?repo=jdk&pr=759&range=00 Issue: https://bugs.openjdk.java.net/browse/JDK-8255043 Stats: 49 lines in 49 files changed: 0 ins; 0 del; 49 mod Patch: https://git.openjdk.java.net/jdk/pull/759.diff Fetch: git fetch https://git.openjdk.java.net/jdk pull/759/head:pull/759 PR: https://git.openjdk.java.net/jdk/pull/759 From dholmes at openjdk.java.net Tue Oct 20 11:50:12 2020 From: dholmes at openjdk.java.net (David Holmes) Date: Tue, 20 Oct 2020 11:50:12 GMT Subject: RFR: 8255043: Incorrectly styled copyright text In-Reply-To: References: Message-ID: On Tue, 20 Oct 2020 08:17:27 GMT, Sergey Bylokhov wrote: > In some files, the copyright text is styled as a JavaDoc comment. > Most of the affected files are tests, only one product file is affected: > src/java.sql/share/classes/javax/sql/package-info.java > > The chenge is trivial: > - /** > + /* > * Copyright (c) Seems trivially fine. Thanks, David ------------- Marked as reviewed by dholmes (Reviewer). PR: https://git.openjdk.java.net/jdk/pull/759 From trebari at openjdk.java.net Tue Oct 20 14:36:16 2020 From: trebari at openjdk.java.net (Tejpal Rebari) Date: Tue, 20 Oct 2020 14:36:16 GMT Subject: RFR: 8255043: Incorrectly styled copyright text In-Reply-To: References: Message-ID: On Tue, 20 Oct 2020 08:17:27 GMT, Sergey Bylokhov wrote: > In some files, the copyright text is styled as a JavaDoc comment. > Most of the affected files are tests, only one product file is affected: > src/java.sql/share/classes/javax/sql/package-info.java > > The chenge is trivial: > - /** > + /* > * Copyright (c) Marked as reviewed by trebari (Committer). ------------- PR: https://git.openjdk.java.net/jdk/pull/759 From jdv at openjdk.java.net Tue Oct 20 15:43:14 2020 From: jdv at openjdk.java.net (Jayathirth D V) Date: Tue, 20 Oct 2020 15:43:14 GMT Subject: RFR: 8255043: Incorrectly styled copyright text In-Reply-To: References: Message-ID: <3HXa_fWqHw4PKAfkD6oo5xKl8gR5ss7yhfl87HdSuGI=.fd3fa01c-a7a1-4e13-ab60-9852ff93162d@github.com> On Tue, 20 Oct 2020 08:17:27 GMT, Sergey Bylokhov wrote: > In some files, the copyright text is styled as a JavaDoc comment. > Most of the affected files are tests, only one product file is affected: > src/java.sql/share/classes/javax/sql/package-info.java > > The chenge is trivial: > - /** > + /* > * Copyright (c) Marked as reviewed by jdv (Reviewer). ------------- PR: https://git.openjdk.java.net/jdk/pull/759 From kizune at openjdk.java.net Tue Oct 20 21:47:13 2020 From: kizune at openjdk.java.net (Alexander Zuev) Date: Tue, 20 Oct 2020 21:47:13 GMT Subject: RFR: 8231454: File lock in Windows on a loaded jar due to a leak in Introspector::getBeanInfo In-Reply-To: References: Message-ID: On Wed, 14 Oct 2020 05:18:23 GMT, Sergey Bylokhov wrote: > java.beans.Introspector is using a new cache mechanism since Java9 in com.sun.beans.introspect.ClassInfo::CACHE which > uses a SoftReference cache over the class, which makes the class "leak", unless clearing the cache manually or > collecting the SoftReference by the GC. Note that this is not a pure "leak", because the SoftReference will be > collected if there is no enough memory on the system, but if the heap is big enough then all objects referenced from > the cached class will be in the memory. The class has a reference to the ClassLoader, and If the soft reference to the > class is not collected by the GC, then the ClassLoader cannot be unloaded and this block the jar file removing. > The solution is to update the implementation of Introspector.flushCaches()/flushFromCaches(Class) to clear the whole > cache or the cache for the specific class. Looks good. ------------- Marked as reviewed by kizune (Reviewer). PR: https://git.openjdk.java.net/jdk/pull/647 From serb at openjdk.java.net Wed Oct 21 02:08:16 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Wed, 21 Oct 2020 02:08:16 GMT Subject: Integrated: 8231454: File lock in Windows on a loaded jar due to a leak in Introspector::getBeanInfo In-Reply-To: References: Message-ID: On Wed, 14 Oct 2020 05:18:23 GMT, Sergey Bylokhov wrote: > java.beans.Introspector is using a new cache mechanism since Java9 in com.sun.beans.introspect.ClassInfo::CACHE which > uses a SoftReference cache over the class, which makes the class "leak", unless clearing the cache manually or > collecting the SoftReference by the GC. Note that this is not a pure "leak", because the SoftReference will be > collected if there is no enough memory on the system, but if the heap is big enough then all objects referenced from > the cached class will be in the memory. The class has a reference to the ClassLoader, and If the soft reference to the > class is not collected by the GC, then the ClassLoader cannot be unloaded and this block the jar file removing. > The solution is to update the implementation of Introspector.flushCaches()/flushFromCaches(Class) to clear the whole > cache or the cache for the specific class. This pull request has now been integrated. Changeset: 2ee2b4ae Author: Sergey Bylokhov URL: https://git.openjdk.java.net/jdk/commit/2ee2b4ae Stats: 113 lines in 3 files changed: 109 ins; 1 del; 3 mod 8231454: File lock in Windows on a loaded jar due to a leak in Introspector::getBeanInfo Reviewed-by: kizune ------------- PR: https://git.openjdk.java.net/jdk/pull/647 From serb at openjdk.java.net Wed Oct 21 04:59:11 2020 From: serb at openjdk.java.net (Sergey Bylokhov) Date: Wed, 21 Oct 2020 04:59:11 GMT Subject: Integrated: 8255043: Incorrectly styled copyright text In-Reply-To: References: Message-ID: On Tue, 20 Oct 2020 08:17:27 GMT, Sergey Bylokhov wrote: > In some files, the copyright text is styled as a JavaDoc comment. > Most of the affected files are tests, only one product file is affected: > src/java.sql/share/classes/javax/sql/package-info.java > > The chenge is trivial: > - /** > + /* > * Copyright (c) This pull request has now been integrated. Changeset: 2e510e04 Author: Sergey Bylokhov URL: https://git.openjdk.java.net/jdk/commit/2e510e04 Stats: 49 lines in 49 files changed: 0 ins; 0 del; 49 mod 8255043: Incorrectly styled copyright text Reviewed-by: dholmes, trebari, jdv ------------- PR: https://git.openjdk.java.net/jdk/pull/759