On 17/08/2020 12:16, Lance Andersen wrote:
The description for almost all of the constructors indicate:
————
Constructor for subclasses to call
——————
Is the above wording used elsewhere in the JDK? Not sure I like it, I might
suggest a little wordsmithing
As far as I know that's what Joe Darcy used to document
public implicit constructors in abstract classes in
recent similar cleanup patches, see for instance here:
http://cr.openjdk.java.net/~darcy/8250244.0/src/java.base/share/classes/java/net/SocketAddress.java.frames.html
I wouldn't use that description if the class could be instantiated,
but if it's abstract then we have a precedent...
Not sure if there is already a different convention for that
in 2D/AWT code base though.
best regards,
-- daniel
