Hi everyone.
Thanks for the feedback!
Firstly, I changed the wording from 'Creates' to 'Constructs' as per
Philip's suggestion (and corrected a spelling mistake).
Secondly, for the protected constructors (in the abstract classes) I
used the wording "Constructor for subclasses to call." as that seems to
be the norm now.
* webrev:
http://cr.openjdk.java.net/~ccleary/issues/webrevs-store/8250855/webrevs/webrev.02/
* specdiff:
http://cr.openjdk.java.net/~ccleary/issues/webrevs-store/8250855/webrevs/webrev.02/specdiff/overview-summary.html
* CSR: https://bugs.openjdk.java.net/browse/JDK-8252495
* bug: https://bugs.openjdk.java.net/browse/JDK-8250859
Regards,
Conor
On 31/08/2020 21:15, Philip Race wrote:
Right we have started to be consistent using "Constructor for
subclasses to call":
Also I prefer constructs over creates, even for the concrete classes,
eg this :
+
+ /**
+ * Creates an {@code ImageFilter}.
+ */
+ public ImageFilter() {}
+
should be "Constructs an {@code ImageFilter}"
-phil.
On 8/28/20, 5:29 PM, Sergey Bylokhov wrote:
Hi, Conor.
Please use such spec for the protected constructor: "Constructor for
subclasses to call":
https://cr.openjdk.java.net/~psadhukhan/8250850/webrev.1/src/java.desktop/share/classes/javax/swing/plaf/metal/MetalTheme.java.sdiff.html
Actually the current text is also fine to me, but looks like many
people use the text above as a description.
On 28.08.2020 01:28, Conor Cleary wrote:
Hello all,
Could someone please review my changes for JDK-8250855, 'Address
reliance on default constructors in the Java 2D APIs'? This issue
relates to JDK-8250639 '☂ Address reliance on default constructors
in the java.desktop module'. The changes address the reliance on
default constructors by adding in basic constructors in the
following classes:
* java.awt.Image
* java.awt.PrintJob
* java.awt.font.GlyphVector
* java.awt.font.LayoutPath
* java.awt.font.LineMetrics
* java.awt.image.AbstractMultiResolutionImage
* java.awt.image.BufferStrategy
* java.awt.image.ImageFilter
* java.awt.image.RGBImageFilter
* java.awt.image.VolatileImage
* javax.print.PrintServiceLookup
* javax.print.ServiceUI
* javax.print.ServiceUIFactory
* javax.print.StreamPrintServiceFactory
* javax.print.event.PrintJobAdapter
A key issue is the accompanying description for each of the added
constructors and is probably the feedback I would value most as it
has been a point of discussion previously. I have included a
specdiff to easily view the changes observed in the api
documentation. Currently drafting a CSR for these changes.
* webrev:
http://cr.openjdk.java.net/~ccleary/issues/webrevs-store/8250855/webrevs/webrev.01/
* specdiff:
http://cr.openjdk.java.net/~ccleary/issues/webrevs-store/8250855/webrevs/webrev.01/specdiff/overview-summary.html
* bug: https://bugs.openjdk.java.net/browse/JDK-8250855
Best Regards,
-Conor