8213049: Invalid HTML5 in javax.swing files
authorpsadhukhan
Wed, 05 Dec 2018 15:48:47 +0530
changeset 52965 fcbea0fb586c
parent 52964 840d66c98b6c
child 52966 7ed5edf6ba0c
8213049: Invalid HTML5 in javax.swing files Reviewed-by: aivanov, serb
src/java.desktop/share/classes/javax/swing/Action.java
src/java.desktop/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html
src/java.desktop/share/classes/javax/swing/plaf/nimbus/doc-files/properties.html
src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html
src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html
--- a/src/java.desktop/share/classes/javax/swing/Action.java	Wed Dec 05 15:42:29 2018 +0530
+++ b/src/java.desktop/share/classes/javax/swing/Action.java	Wed Dec 05 15:48:47 2018 +0530
@@ -370,7 +370,7 @@
      * Determines whether the action should be performed with the specified
      * sender object. The {@code sender} can be {@code null}.
      * The method must return false if the action is disabled.
-     * <p>
+     *
      * @param sender the object to check, can be null
      * @return {@code true} if the action should be performed with the sender
      *         object, must be false if the action is disabled.
--- a/src/java.desktop/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html	Wed Dec 05 15:42:29 2018 +0530
+++ b/src/java.desktop/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html	Wed Dec 05 15:48:47 2018 +0530
@@ -251,16 +251,14 @@
 the <code>javax.swing.plaf</code> package.
 </p>
 
-<a id="dosanddonts">
+<a id="dosanddonts"></a>
   <h3>Dos and Don'ts</h3>
-</a>
 
 <p>
 The following paragraphs provide some general recommendations for developing
 auxiliary look and feels.
 </p>
 
-<p>
 <h4>Use the <code>installUI</code> method
 to perform all initialization,
 and the <code>uninstallUI</code> method
--- a/src/java.desktop/share/classes/javax/swing/plaf/nimbus/doc-files/properties.html	Wed Dec 05 15:42:29 2018 +0530
+++ b/src/java.desktop/share/classes/javax/swing/plaf/nimbus/doc-files/properties.html	Wed Dec 05 15:48:47 2018 +0530
@@ -32,8 +32,12 @@
 <body>
 <main role="main">
 <h1 id="primaryColors">Primary Colors</h1>
-<table summary="Nimbus primary colors">
+<table>
+<caption>Primary colors used in Nimbus Look And Feel</caption>
+<thead>
 <tr><th>Key</th><th>Value</th><th>Preview</th></tr>
+</thead>
+<tbody>
 <tr>
 <td width="250"><code>control</code></td>
 <td><pre>#d6d9df (214,217,223)</pre></td>
@@ -110,11 +114,16 @@
 <td><pre>#000000 (0,0,0)</pre></td>
 <td width="100" bgcolor="#000000">&nbsp;</td>
 </tr>
+</tbody>
 </table>
 
 <h1 id="secondaryColors">Secondary Colors</h1>
-<table summary="Nimbus secondary colors">
+<table>
+<caption>Secondary colors used in Nimbus Look And Feel </caption>
+<thead>
 <tr><th>Key</th><th>Value</th><th>Preview</th></tr>
+</thead>
+<tbody>
 <tr>
 <td width="250"><code>activeCaption</code></td>
 
@@ -229,6 +238,7 @@
 <td><pre>#8e8f91 (142,143,145)</pre></td>
 <td width="100" bgcolor="#8e8f91">&nbsp;</td>
 </tr>
+</tbody>
 </table>
 </main>
 </body>
--- a/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html	Wed Dec 05 15:42:29 2018 +0530
+++ b/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html	Wed Dec 05 15:48:47 2018 +0530
@@ -53,8 +53,8 @@
 In       addition to the <a
  href="#buttonProperties">Button 	properties</a>, ArrowButton supports
 the following properties: </p>
-<h3>ArrowButton Specific Properties</h3>
-<table border="1" summary="ArrowButton specific properties">
+<table border="1">
+<caption>ArrowButton Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -75,8 +75,8 @@
 <p> JButton paints text using the TEXT_FOREGROUND ColorType. In addition
 to the <a href="#buttonProperties">Button 	properties</a>, JButton
 supports the following property: </p>
-<h3>JButton Specific Properties</h3>
-<table border="1" summary="JButton specific properties">
+<table border="1">
+<caption>JButton Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -98,8 +98,8 @@
 <p> JCheckBox paints text using the TEXT_FOREGROUND ColorType. In
 addition to the <a href="#buttonProperties">Button 	properties</a>,
 JCheckBox supports the following property: </p>
-<h3>JCheckBox Specific Properties</h3>
-<table border="1" summary="JCheckBox specific properties">
+<table border="1">
+<caption>JCheckBox Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -119,7 +119,8 @@
 <h2><a id="JComboBox">JComboBox</a></h2>
 <p> JComboBox is a composite component that consists of the following
 child Components: </p>
-<table border="1" summary="JComboBox child components">
+<table border="1">
+<caption>JComboBox child components</caption>
   <thead><tr>
     <th>Name</th>
     <th>Type</th>
@@ -165,8 +166,9 @@
   </tbody>
 </table>
 
-<h3>JComboBox Specific Properties</h3>
-<table border="1" summary="JComboBox specific properties">
+<p>&nbsp;</p>
+<table border="1">
+<caption>JComboBox Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -185,9 +187,8 @@
 </table>
 <br>
 <h2>JFileChooser</h2>
-<h3>JFileChooser Specific Properties</h3>
-<table cellpadding="2" cellspacing="2" border="1" summary="JFileChooser specific properties"
- style="width: 100%; text-align: left;">
+<table cellpadding="2" cellspacing="2" border="1" style="width: 100%; text-align: left;">
+<caption>JFileChooser Specific Properties</caption>
   <tbody>
     <tr>
       <th style="vertical-align: top; text-align: center;">Property</th>
@@ -345,9 +346,8 @@
 </table>
 <br>
 <h2><a id="JInternalFrame"></a>JInternalFrame</h2>
-<h3>JInternalFrame Specific Properties</h3>
-<table cellpadding="2" cellspacing="2" border="1" summary="JInternalFrame specific properties"
- style="text-align: left; width: 100%;">
+<table cellpadding="2" cellspacing="2" border="1" style="text-align: left; width: 100%;">
+<caption>JInternalFrame Specific Properties</caption>
   <tbody>
     <tr>
       <th style="vertical-align: top; text-align: center;">Property<br>
@@ -378,9 +378,8 @@
 <p>JInternalFrameTitlePane is the control bar located at the top of the
 internal frame similar to that found in a frame.<br>
 </p>
-<h3>JInternalFrameTitlePane Specific Properties</h3>
-<table cellpadding="2" cellspacing="2" border="1" summary="JInternalFrameTitlePane specific properties"
- style="text-align: left; width: 100%;">
+<table cellpadding="2" cellspacing="2" border="1" style="text-align: left; width: 100%;">
+<caption>JInternalFrameTitlePane Specific Properties</caption>
   <tbody>
     <tr>
       <th style="vertical-align: top; text-align: center;">Property<br>
@@ -477,8 +476,8 @@
 <h2><a id="JList">JList</a></h2>
 <p> JList's sets the name of the renderer to List.renderer.       JList
 supports the following properties: </p>
-<h3>JList Specific Properties</h3>
-<table border="1" summary="JList specific properties">
+<table border="1">
+<caption>JList Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -521,7 +520,8 @@
 MENU_ITEM_ACCELERATOR is used for painting the accelerator. Both Regions
 paint text using the TEXT_FOREGROUND ColorType. The following set of
 properties are supported: </p>
-<table border="1" summary="Menu classes common properties">
+<table border="1">
+<caption>Menu classes common properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -575,7 +575,8 @@
 <p> <code>Prefix</code> is one of: CheckBoxMenuItem, Menu, MenuItem, or
 RadioButtonMenuItem. </p>
 <p> JMenu also supports the following properties: </p>
-<table border="1" summary="JMenu specific properties">
+<table border="1">
+<caption>JMenu specific properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -603,8 +604,8 @@
 components, they are: OptionPane.button, OptionPane.label,
 OptionPane.comboBox, OptionPane.scrollPane, OptionPane.list,
 OptionPane.textField, OptionPane.iconLabel. </p>
-<h3>JOptionPane Specific Properties</h3>
-<table border="1" summary="JOptionPane specific properties">
+<table border="1">
+<caption>JOptionPane Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -716,10 +717,8 @@
 <br>
 <h2><a id="JProgressBar"></a>JProgressBar<br>
 </h2>
-<h3>JProgressBar Specific Properties<br>
-</h3>
-<table cellpadding="2" cellspacing="2" border="1" summary="JProgressBar specific properties"
- style="text-align: left; width: 100%;">
+<table cellpadding="2" cellspacing="2" border="1" style="text-align: left; width: 100%;">
+<caption>JProgressBar Specific Properties</caption>
   <tbody>
     <tr>
       <th style="vertical-align: top; text-align: center;">Property</th>
@@ -758,8 +757,8 @@
 <p> JRadioButton paints text using the TEXT_FOREGROUND ColorType. In
 addition to the <a href="#buttonProperties">Button 	properties</a>,
 JRadioButton supports the following property: </p>
-<h3>JRadioButton Specific Properties</h3>
-<table border="1" summary="JRadioButton specific properties">
+<table border="1">
+<caption>JRadioButton Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -779,7 +778,8 @@
 <h2><a id="JScrollBar">JScrollBar</a></h2>
 <p> JScrollBar is a composite component that consists of the following
 child Components: </p>
-<table border="1" summary="JScrollBar child components">
+<table border="1">
+<caption>JScrollBar child components</caption>
   <thead><tr>
     <th>Name</th>
     <th>Type</th>
@@ -794,8 +794,9 @@
   </tbody>
 </table>
 
-<h3>JScrollBar Specific Properties</h3>
-<table border="1" summary="JScrollBar specific properties">
+<p>&nbsp;</p>
+<table border="1">
+<caption>JScrollBar Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -849,7 +850,8 @@
 <h2><a id="Separator">Separators</a></h2>
 <p> All of the separator classes, JSeparator, JPopupMenu.Separator and
 JToolBar.Separator use the same property: </p>
-<table border="1" summary="Separator classes common properties">
+<table border="1">
+<caption>Separator classes common properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -868,7 +870,8 @@
   </tbody>
 </table>
 <p> JToolBar.Separator also supports the following property: </p>
-<table border="1" summary="JToolBar.Separator specific properties">
+<table border="1">
+<caption>JToolBar.Separator specific properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -901,8 +904,8 @@
       <code>paintViewportBorder</code> is called to paint the
       <code>Viewport</code>s border.
  </p>
-<h3>JScrollPane Specific Properties</h3>
-<table border="1" summary="JScrollPane specific properties">
+<table border="1">
+<caption>JScrollPane Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -925,8 +928,8 @@
 invoked. The two buttons will be named:
 SplitPaneDivider.leftOneTouchButton and
 SplitPaneDivider.rightOneTouchButton. </p>
-<h3>JSplitPane Specific Properties</h3>
-<table border="1" summary="JSplitPane specific properties">
+<table border="1">
+<caption>JSplitPane Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -969,9 +972,8 @@
 </table>
 <br>
 <h2><a id="JSlider"></a>JSlider</h2>
-<h3>JSlider Specific Properties</h3>
-<table cellpadding="2" cellspacing="2" border="1" summary="JSlider specific properties"
- style="text-align: left; width: 100%;">
+<table cellpadding="2" cellspacing="2" border="1" style="text-align: left; width: 100%;">
+<caption>JSlider Specific Properties</caption>
   <tbody>
     <tr>
       <th style="vertical-align: top; text-align: center;">Property<br>
@@ -1029,9 +1031,8 @@
 </table>
 <br>
 <h2><a id="JTabbedPane"></a>JTabbedPane</h2>
-<h3>JTabbedPane Specific Properties</h3>
-<table cellpadding="2" cellspacing="2" border="1" summary="JTabbedPane specific properties"
- style="text-align: left; width: 100%;">
+<table cellpadding="2" cellspacing="2" border="1" style="text-align: left; width: 100%;">
+<caption>JTabbedPane Specific Properties</caption>
   <tbody>
     <tr>
       <th style="vertical-align: top; text-align: center;">Property</th>
@@ -1093,8 +1094,8 @@
 <h2><a id="JTable">JTable</a></h2>
 <p> JTable sets the name of the renderer to Table.cellRenderer.
 JTable supports the following properties: </p>
-<h3>JTable Specific Properties</h3>
-<table border="1" summary="JTable specific properties">
+<table border="1">
+<caption>JTable Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -1138,8 +1139,8 @@
 <h2><a id="JTree">JTree</a></h2>
 <p> JTree sets the name of the renderer to Tree.renderer, the name of
 the editor is Tree.cellEditor.</p>
-<h3>JTree Specific Properties</h3>
-<table border="1" summary="JTree specific properties">
+<table border="1">
+<caption>JTree Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -1222,8 +1223,8 @@
 <p> JToggleButton paints text using the TEXT_FOREGROUND ColorType. In
 addition to the <a href="#buttonProperties">Button 	properties</a>,
 JToggleButton supports the following property: </p>
-<h3>JToggleButton Specific Properties</h3>
-<table border="1" summary="JToggleButton specific properties">
+<table border="1">
+<caption>JToggleButton Specific Properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -1244,7 +1245,8 @@
 <p> Each of the Button classes (JButton, JCheckBox, JRadioButton,
 JToggleButton and SynthArrowButton) support a similar set of properties.
 These properties are: </p>
-<table border="1" summary="Button classes common properties">
+<table border="1">
+<caption>Button classes common properties</caption>
   <thead><tr>
     <th>Property</th>
     <th>Expected Type</th>
@@ -1295,8 +1297,7 @@
 </p>
 <h2><a id="textProperties"></a>Text Properties<br>
 </h2>
-<table cellpadding="2" cellspacing="2" border="1" summary="Text properties"
- style="text-align: left; width: 100%;">
+<table cellpadding="2" cellspacing="2" border="1" style="text-align: left; width: 100%;">
   <tbody>
     <tr>
       <th style="vertical-align: top; text-align: center;">Property</th>
--- a/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html	Wed Dec 05 15:42:29 2018 +0530
+++ b/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html	Wed Dec 05 15:48:47 2018 +0530
@@ -776,7 +776,8 @@
       The following outlines which painter will be used for what
       SynthPainter method:
     </p>
-    <table border=1 summary="Painters for SynthPainter methods">
+    <table border=1>
+     <caption> Painters for SynthPainter methods </caption>
       <tr><th>State<th>Method<th>Painter
 	<tr><td>SELECTED<td>paintButtonBackground<td>stateButtonBackgroundPainter
 	<tr><td>SELECTED<td>Anything but paintButtonBackground<td>stateFallbackPainter