8253322: Update the specification in the newly added constructors

Reviewed-by: psadhukhan, prr

Author: mrserb

src/java.desktop/share/classes/java/applet/Applet.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -579,7 +579,7 @@ protected class AccessibleApplet extends AccessibleAWTPanel {
         private static final long serialVersionUID = 8127374778187708896L;
 
         /**
-         * Constructs an {@code AccessibleApplet}
+         * Constructs an {@code AccessibleApplet}.
          */
         protected AccessibleApplet() {}
 

src/java.desktop/share/classes/java/awt/Button.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -538,7 +538,7 @@ protected class AccessibleAWTButton extends AccessibleAWTComponent
         private static final long serialVersionUID = -5932203980244017102L;
 
         /**
-         * Constructs an {@code AccessibleAWTButton}
+         * Constructs an {@code AccessibleAWTButton}.
          */
         protected AccessibleAWTButton() {}
 

src/java.desktop/share/classes/java/awt/Canvas.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -241,7 +241,7 @@ protected class AccessibleAWTCanvas extends AccessibleAWTComponent
         private static final long serialVersionUID = -6325592262103146699L;
 
         /**
-         * Constructs an {@code AccessibleAWTCanvas}
+         * Constructs an {@code AccessibleAWTCanvas}.
          */
         protected AccessibleAWTCanvas() {}
 

src/java.desktop/share/classes/java/awt/CheckboxMenuItem.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -537,7 +537,7 @@ protected class AccessibleAWTCheckboxMenuItem extends AccessibleAWTMenuItem
         private static final long serialVersionUID = -1122642964303476L;
 
         /**
-         * Constructs an {@code AccessibleAWTCheckboxMenuItem}
+         * Constructs an {@code AccessibleAWTCheckboxMenuItem}.
          */
         protected AccessibleAWTCheckboxMenuItem() {}
 

src/java.desktop/share/classes/java/awt/Component.java

@@ -9342,7 +9342,7 @@ protected class AccessibleAWTComponentHandler implements ComponentListener, Seri
             private static final long serialVersionUID = -1009684107426231869L;
 
             /**
-             * Constructs an {@code AccessibleAWTComponentHandler}
+             * Constructs an {@code AccessibleAWTComponentHandler}.
              */
             protected AccessibleAWTComponentHandler() {}
 
@@ -9379,7 +9379,7 @@ protected class AccessibleAWTFocusHandler implements FocusListener, Serializable
             private static final long serialVersionUID = 3150908257351582233L;
 
             /**
-             * Constructs an {@code AccessibleAWTFocusHandler}
+             * Constructs an {@code AccessibleAWTFocusHandler}.
              */
             protected AccessibleAWTFocusHandler() {}
 

src/java.desktop/share/classes/java/awt/Container.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -3807,7 +3807,7 @@ protected class AccessibleAWTContainer extends AccessibleAWTComponent {
         private static final long serialVersionUID = 5081320404842566097L;
 
         /**
-         * Constructs an {@code AccessibleAWTContainer}
+         * Constructs an {@code AccessibleAWTContainer}.
          */
         protected AccessibleAWTContainer() {}
 
@@ -3869,7 +3869,7 @@ protected class AccessibleContainerHandler
             private static final long serialVersionUID = -480855353991814677L;
 
             /**
-             * Constructs an {@code AccessibleContainerHandler}
+             * Constructs an {@code AccessibleContainerHandler}.
              */
             protected AccessibleContainerHandler() {}
 

src/java.desktop/share/classes/java/awt/Dialog.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -1659,7 +1659,7 @@ protected class AccessibleAWTDialog extends AccessibleAWTWindow
         private static final long serialVersionUID = 4837230331833941201L;
 
         /**
-         * Constructs an {@code AccessibleAWTDialog}
+         * Constructs an {@code AccessibleAWTDialog}.
          */
         protected AccessibleAWTDialog() {}
 

src/java.desktop/share/classes/java/awt/Frame.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -1298,7 +1298,7 @@ protected class AccessibleAWTFrame extends AccessibleAWTWindow
         private static final long serialVersionUID = -6172960752956030250L;
 
         /**
-         * Constructs an {@code AccessibleAWTFrame}
+         * Constructs an {@code AccessibleAWTFrame}.
          */
         protected AccessibleAWTFrame() {}
 

src/java.desktop/share/classes/java/awt/Menu.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -625,7 +625,7 @@ protected class AccessibleAWTMenu extends AccessibleAWTMenuItem
         private static final long serialVersionUID = 5228160894980069094L;
 
         /**
-         * Constructs an {@code AccessibleAWTMenu}
+         * Constructs an {@code AccessibleAWTMenu}.
          */
         protected AccessibleAWTMenu() {}
 

src/java.desktop/share/classes/java/awt/MenuBar.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -512,7 +512,7 @@ protected class AccessibleAWTMenuBar extends AccessibleAWTMenuComponent
         private static final long serialVersionUID = -8577604491830083815L;
 
         /**
-         * Constructs an {@code AccessibleAWTMenuBar}
+         * Constructs an {@code AccessibleAWTMenuBar}.
          */
         protected AccessibleAWTMenuBar() {}
 

src/java.desktop/share/classes/java/awt/MenuItem.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -824,7 +824,7 @@ protected class AccessibleAWTMenuItem extends AccessibleAWTMenuComponent
         private static final long serialVersionUID = -217847831945965825L;
 
         /**
-         * Constructs an {@code AccessibleAWTMenuItem}
+         * Constructs an {@code AccessibleAWTMenuItem}.
          */
         protected AccessibleAWTMenuItem() {}
 

src/java.desktop/share/classes/java/awt/Panel.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -120,7 +120,7 @@ protected class AccessibleAWTPanel extends AccessibleAWTContainer {
         private static final long serialVersionUID = -6409552226660031050L;
 
         /**
-         * Constructs an {@code AccessibleAWTPanel}
+         * Constructs an {@code AccessibleAWTPanel}.
          */
         protected AccessibleAWTPanel() {}
 

src/java.desktop/share/classes/java/awt/PopupMenu.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -229,7 +229,7 @@ protected class AccessibleAWTPopupMenu extends AccessibleAWTMenu
         private static final long serialVersionUID = -4282044795947239955L;
 
         /**
-         * Constructs an {@code AccessibleAWTPopupMenu}
+         * Constructs an {@code AccessibleAWTPopupMenu}.
          */
         protected AccessibleAWTPopupMenu() {}
 

src/java.desktop/share/classes/java/awt/ScrollPane.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -792,7 +792,7 @@ protected class AccessibleAWTScrollPane extends AccessibleAWTContainer
         private static final long serialVersionUID = 6100703663886637L;
 
         /**
-         * Constructs an {@code AccessibleAWTScrollPane}
+         * Constructs an {@code AccessibleAWTScrollPane}.
          */
         protected AccessibleAWTScrollPane() {}
 

src/java.desktop/share/classes/java/awt/Scrollbar.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -1263,7 +1263,7 @@ protected class AccessibleAWTScrollBar extends AccessibleAWTComponent
         private static final long serialVersionUID = -344337268523697807L;
 
         /**
-         * Constructs an {@code AccessibleAWTScrollBar}
+         * Constructs an {@code AccessibleAWTScrollBar}.
          */
         protected AccessibleAWTScrollBar() {}
 

src/java.desktop/share/classes/java/awt/TextArea.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -720,7 +720,7 @@ protected class AccessibleAWTTextArea extends AccessibleAWTTextComponent
         private static final long serialVersionUID = 3472827823632144419L;
 
         /**
-         * Constructs an {@code AccessibleAWTTextArea}
+         * Constructs an {@code AccessibleAWTTextArea}.
          */
         protected AccessibleAWTTextArea() {}
 

src/java.desktop/share/classes/java/awt/TextField.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -789,7 +789,7 @@ protected class AccessibleAWTTextField extends AccessibleAWTTextComponent
         private static final long serialVersionUID = 6219164359235943158L;
 
         /**
-         * Constructs an {@code AccessibleAWTTextField}
+         * Constructs an {@code AccessibleAWTTextField}.
          */
         protected AccessibleAWTTextField() {}
 

src/java.desktop/share/classes/java/awt/Window.java

@@ -3164,7 +3164,7 @@ protected class AccessibleAWTWindow extends AccessibleAWTContainer
         private static final long serialVersionUID = 4215068635060671780L;
 
         /**
-         * Constructs an {@code AccessibleAWTWindow}
+         * Constructs an {@code AccessibleAWTWindow}.
          */
         protected AccessibleAWTWindow() {}
 

src/java.desktop/share/classes/javax/sound/midi/spi/MidiDeviceProvider.java

@@ -39,7 +39,7 @@
 public abstract class MidiDeviceProvider {
 
     /**
-     * Constructs a {@code MidiDeviceProvider}.
+     * Constructor for subclasses to call.
      */
     protected MidiDeviceProvider() {}
 

src/java.desktop/share/classes/javax/sound/midi/spi/MidiFileReader.java

@@ -46,7 +46,7 @@
 public abstract class MidiFileReader {
 
     /**
-     * Constructs a {@code MidiFileReader}.
+     * Constructor for subclasses to call.
      */
     protected MidiFileReader() {}
 

src/java.desktop/share/classes/javax/sound/midi/spi/MidiFileWriter.java

@@ -43,7 +43,7 @@
 public abstract class MidiFileWriter {
 
     /**
-     * Constructs a {@code MidiFileWriter}.
+     * Constructor for subclasses to call.
      */
     protected MidiFileWriter() {}
 

src/java.desktop/share/classes/javax/sound/midi/spi/SoundbankReader.java

@@ -45,7 +45,7 @@
 public abstract class SoundbankReader {
 
     /**
-     * Constructs a {@code SoundbankReader}.
+     * Constructor for subclasses to call.
      */
     protected SoundbankReader() {}
 

src/java.desktop/share/classes/javax/sound/sampled/spi/AudioFileReader.java

@@ -45,7 +45,7 @@
 public abstract class AudioFileReader {
 
     /**
-     * Constructs an {@code AudioFileReader}.
+     * Constructor for subclasses to call.
      */
     protected AudioFileReader() {}
 

src/java.desktop/share/classes/javax/sound/sampled/spi/AudioFileWriter.java

@@ -46,7 +46,7 @@
 public abstract class AudioFileWriter {
 
     /**
-     * Constructs an {@code AudioFileWriter}.
+     * Constructor for subclasses to call.
      */
     protected AudioFileWriter() {}
 

src/java.desktop/share/classes/javax/sound/sampled/spi/FormatConversionProvider.java

@@ -52,7 +52,7 @@
 public abstract class FormatConversionProvider {
 
     /**
-     * Constructs a {@code FormatConversionProvider}.
+     * Constructor for subclasses to call.
      */
     protected FormatConversionProvider() {}
 

src/java.desktop/share/classes/javax/sound/sampled/spi/MixerProvider.java

@@ -40,7 +40,7 @@
 public abstract class MixerProvider {
 
     /**
-     * Constructs a {@code MixerProvider}.
+     * Constructor for subclasses to call.
      */
     protected MixerProvider() {}
 

src/java.desktop/share/classes/javax/swing/Box.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2020, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -384,8 +384,9 @@ public AccessibleContext getAccessibleContext() {
          */
         @SuppressWarnings("serial")
         protected class AccessibleBoxFiller extends AccessibleAWTComponent {
+
             /**
-             * Constructor for subclasses to call.
+             * Constructs an {@code AccessibleBoxFiller}.
              */
             protected AccessibleBoxFiller() {}
 
@@ -431,8 +432,9 @@ public AccessibleContext getAccessibleContext() {
      */
     @SuppressWarnings("serial")
     protected class AccessibleBox extends AccessibleAWTContainer {
+
         /**
-         * Constructor for subclasses to call.
+         * Constructs an {@code AccessibleBox}.
          */
         protected AccessibleBox() {}