8220250: fix headings in java.desktop
authorpsadhukhan
Wed, 27 Mar 2019 12:27:56 +0530
changeset 54397 65030bbf5ac1
parent 54396 6526e0a7dd99
child 54398 62171da145f9
8220250: fix headings in java.desktop Reviewed-by: aivanov, jjg, serb
src/java.desktop/share/classes/java/awt/AlphaComposite.java
src/java.desktop/share/classes/java/awt/Component.java
src/java.desktop/share/classes/java/awt/Font.java
src/java.desktop/share/classes/java/awt/font/TextAttribute.java
src/java.desktop/share/classes/java/awt/geom/AffineTransform.java
src/java.desktop/share/classes/javax/accessibility/package-info.java
src/java.desktop/share/classes/javax/print/DocFlavor.java
src/java.desktop/share/classes/javax/print/attribute/package-info.java
src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java
src/java.desktop/share/classes/javax/print/package-info.java
src/java.desktop/share/classes/javax/swing/Action.java
src/java.desktop/share/classes/javax/swing/GroupLayout.java
src/java.desktop/share/classes/javax/swing/JTable.java
src/java.desktop/share/classes/javax/swing/SizeSequence.java
src/java.desktop/share/classes/javax/swing/SpringLayout.java
src/java.desktop/share/classes/javax/swing/UIManager.java
src/java.desktop/share/classes/javax/swing/plaf/metal/DefaultMetalTheme.java
--- a/src/java.desktop/share/classes/java/awt/AlphaComposite.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/java/awt/AlphaComposite.java	Wed Mar 27 12:27:56 2019 +0530
@@ -163,7 +163,7 @@
  * </tbody>
  * </table>
  *
- * <h3>Preparing Inputs</h3>
+ * <h2>Preparing Inputs</h2>
  *
  * <p>
  * The {@code AlphaComposite} class defines an additional alpha
@@ -204,7 +204,7 @@
  *      <em>C<sub>d</sub></em> = <em>C<sub>dr</sub></em> * <em>A<sub>d</sub></em>    (if destination is not premultiplied)
  *      <em>C<sub>d</sub></em> = <em>C<sub>dr</sub></em>         (if destination is premultiplied) </pre>
  *
- * <h3>Applying the Blending Equation</h3>
+ * <h2>Applying the Blending Equation</h2>
  *
  * <p>
  * The adjusted <em>A<sub>s</sub></em>, <em>A<sub>d</sub></em>,
@@ -213,7 +213,7 @@
  * <em>F<sub>s</sub></em> and <em>F<sub>d</sub></em> and then the resulting
  * premultiplied components <em>A<sub>r</sub></em> and <em>C<sub>r</sub></em>.
  *
- * <h3>Preparing Results</h3>
+ * <h2>Preparing Results</h2>
  *
  * <p>
  * The results only need to be adjusted if they are to be stored
@@ -230,7 +230,7 @@
  * by zero" and the color components are left as
  * all zeros.
  *
- * <h3>Performance Considerations</h3>
+ * <h2>Performance Considerations</h2>
  *
  * <p>
  * For performance reasons, it is preferable that
@@ -243,7 +243,7 @@
  * appropriate conversions are performed before and after the compositing
  * operation.
  *
- * <h3><a id="caveats">Implementation Caveats</a></h3>
+ * <h2><a id="caveats">Implementation Caveats</a></h2>
  *
  * <ul>
  * <li>
--- a/src/java.desktop/share/classes/java/awt/Component.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/java/awt/Component.java	Wed Mar 27 12:27:56 2019 +0530
@@ -135,7 +135,7 @@
  * validated afterwards by means of the {@link Container#validate()} method
  * invoked on the top-most invalid container of the hierarchy.
  *
- * <h3>Serialization</h3>
+ * <h2>Serialization</h2>
  * It is important to note that only AWT listeners which conform
  * to the {@code Serializable} protocol will be saved when
  * the object is stored.  If an AWT object has listeners that
--- a/src/java.desktop/share/classes/java/awt/Font.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/java/awt/Font.java	Wed Mar 27 12:27:56 2019 +0530
@@ -74,7 +74,7 @@
  * and to render sequences of glyphs on {@code Graphics} and
  * {@code Component} objects.
  *
- * <h3>Characters and Glyphs</h3>
+ * <h2>Characters and Glyphs</h2>
  *
  * A <em>character</em> is a symbol that represents an item such as a letter,
  * a digit, or punctuation in an abstract way. For example, {@code 'g'},
@@ -96,7 +96,7 @@
  * of characters as well as the tables needed to map sequences of characters to
  * corresponding sequences of glyphs.
  *
- * <h3>Physical and Logical Fonts</h3>
+ * <h2>Physical and Logical Fonts</h2>
  *
  * The Java Platform distinguishes between two kinds of fonts:
  * <em>physical</em> fonts and <em>logical</em> fonts.
@@ -135,7 +135,7 @@
  * in <a href="https://docs.oracle.com/javase/tutorial/index.html">The Java Tutorials</a>
  * document.
  *
- * <h3>Font Faces and Names</h3>
+ * <h2>Font Faces and Names</h2>
  *
  * A {@code Font}
  * can have many faces, such as heavy, medium, oblique, gothic and
@@ -169,7 +169,7 @@
  * with varying sizes, styles, transforms and font features via the
  * {@code deriveFont} methods in this class.
  *
- * <h3>Font and TextAttribute</h3>
+ * <h2>Font and TextAttribute</h2>
  *
  * <p>{@code Font} supports most
  * {@code TextAttribute}s.  This makes some operations, such as
--- a/src/java.desktop/share/classes/java/awt/font/TextAttribute.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/java/awt/font/TextAttribute.java	Wed Mar 27 12:27:56 2019 +0530
@@ -67,7 +67,7 @@
  *   <LI>a description of the effect.
  * </UL>
  *
- * <H3>Values</H3>
+ * <H2>Values</H2>
  * <UL>
  *   <LI>The values of attributes must always be immutable.
  *   <LI>Where value limitations are given, any value outside of that
@@ -95,7 +95,7 @@
  *
  * </UL>
  *
- * <h4>Summary of attributes</h4>
+ * <h3>Summary of attributes</h3>
  *
  * <table style="width:95%;margin: 0px auto" class="striped">
  * <caption>Key, value type, principal constants, and default value behavior of
--- a/src/java.desktop/share/classes/java/awt/geom/AffineTransform.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/java/awt/geom/AffineTransform.java	Wed Mar 27 12:27:56 2019 +0530
@@ -46,7 +46,7 @@
  *      [ y'] = [  m10  m11  m12  ] [ y ] = [ m10x + m11y + m12 ]
  *      [ 1 ]   [   0    0    1   ] [ 1 ]   [         1         ]
  * </pre>
- * <h3><a id="quadrantapproximation">Handling 90-Degree Rotations</a></h3>
+ * <h2><a id="quadrantapproximation">Handling 90-Degree Rotations</a></h2>
  * <p>
  * In some variations of the {@code rotate} methods in the
  * {@code AffineTransform} class, a double-precision argument
--- a/src/java.desktop/share/classes/javax/accessibility/package-info.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/accessibility/package-info.java	Wed Mar 27 12:27:56 2019 +0530
@@ -37,8 +37,8 @@
  * interfaces, and 6 Java programming language classes. These are described
  * below.
  *
- * <h3><a id="Accessible"></a><a href="Accessible.html">Interface
- * Accessible</a></h3>
+ * <h2><a id="Accessible"></a><a href="Accessible.html">Interface
+ * Accessible</a></h2>
  * <a href="Accessible.html">Interface Accessible</a> is the main interface of
  * the Java Accessibility API. All components that support the Java
  * Accessibility API must implement this interface. It contains a single method,
@@ -48,8 +48,8 @@
  * object that is part of the user interface of a Java application, if that
  * program is to be compatible with assistive technologies.
  *
- * <h3><a id="AccessibleContext"></a><a href="AccessibleContext.html">Class
- * AccessibleContext</a></h3>
+ * <h2><a id="AccessibleContext"></a><a href="AccessibleContext.html">Class
+ * AccessibleContext</a></h2>
  * <a href="AccessibleContext.html">AccessibleContext</a> represents the minimum
  * information all accessible objects return and is obtained by calling the
  * {@code getAccessibleContext} method on an object that implements the
@@ -108,8 +108,8 @@
  *     called on an AccessibleContext.</li>
  * </ul>
  *
- * <h3><a id="AccessibleRole"></a><a href="AccessibleRole.html">Class
- * AccessibleRole</a></h3>
+ * <h2><a id="AccessibleRole"></a><a href="AccessibleRole.html">Class
+ * AccessibleRole</a></h2>
  * This class encapsulates the Accessible object's role in the user interface
  * and is obtained by calling the {@code getAccessibleRole} method on an
  * <a href="#AccessibleContext">AccessibleContext</a>. Accessible roles include
@@ -123,8 +123,8 @@
  * programmer-defined roles can be added in the future without needing to modify
  * the base class.
  *
- * <h3><a id="AccessibleState"></a><a href="AccessibleState.html">Class
- * AccessibleState</a></h3>
+ * <h2><a id="AccessibleState"></a><a href="AccessibleState.html">Class
+ * AccessibleState</a></h2>
  * This class encapsulates a particular state of the Accessible object.
  * Accessible states include things like "Armed", "Busy", "Checked", "Focused",
  * etc. These roles are identified by the constants in this class such as
@@ -142,8 +142,8 @@
  * additional, programmer-defined roles can be added in the future without
  * needing to modify the base class.
  *
- * <h3><a id="AccessibleStateSet"></a><a href="AccessibleStateSet.html">Class
- * AccessibleStateSet</a></h3>
+ * <h2><a id="AccessibleStateSet"></a><a href="AccessibleStateSet.html">Class
+ * AccessibleStateSet</a></h2>
  * This class encapsulates a collection of states of the Accessible object and
  * is obtained by calling the {@code getAccessibleStateSet} method on an
  * <a href="#AccessibleContext">AccessibleContext</a>. Since an object might
@@ -152,8 +152,8 @@
  * class provide for retrieving the individual
  * <a href="#AccessibleState">AccessibleStates</a> on the state set.
  *
- * <h3><a id="AccessibleBundle"></a><a href="AccessibleBundle.html">Class
- * AccessibleBundle</a></h3>
+ * <h2><a id="AccessibleBundle"></a><a href="AccessibleBundle.html">Class
+ * AccessibleBundle</a></h2>
  * This class is used to maintain a strongly typed enumeration. It is the super
  * class of both the <a href="#AccessibleRole">AccessibleRole</a> and
  * <a href="#AccessibleState">AccessibleState</a> classes. Programmers normally
@@ -161,8 +161,8 @@
  * <a href="#AccessibleRole">AccessibleRole</a> and
  * <a href="#AccessibleState">AccessibleState</a> classes.
  *
- * <h3><a id="AccessibleAction"></a><a href="AccessibleAction.html">Interface
- * AccessibleAction</a></h3>
+ * <h2><a id="AccessibleAction"></a><a href="AccessibleAction.html">Interface
+ * AccessibleAction</a></h2>
  * The <a href="AccessibleAction.html">AccessibleAction</a> interface should be
  * supported by any object that can perform one or more actions. This interface
  * provides the standard mechanism for an assistive technology to determine what
@@ -177,8 +177,8 @@
  * <a href="#AccessibleContext">AccessibleContext</a>. If the return value is
  * not {@code null}, the object supports this interface.
  *
- * <h3> <a id="AccessibleComponent"></a><a href="AccessibleComponent.html">
- * Interface AccessibleComponent</a></h3>
+ * <h2> <a id="AccessibleComponent"></a><a href="AccessibleComponent.html">
+ * Interface AccessibleComponent</a></h2>
  * The <a href="AccessibleComponent.html">AccessibleComponent</a> interface
  * should be supported by any object that is rendered on the screen. This
  * interface provides the standard mechanism for an assistive technology to
@@ -190,8 +190,8 @@
  * <a href="#AccessibleContext">AccessibleContext</a>. If the return value is
  * not {@code null}, the object supports this interface.
  *
- * <h3><a id="AccessibleSelection"></a><a href="AccessibleSelection.html">
- * Interface AccessibleSelection</a></h3>
+ * <h2><a id="AccessibleSelection"></a><a href="AccessibleSelection.html">
+ * Interface AccessibleSelection</a></h2>
  * The <a href="AccessibleSelection.html">AccessibleSelection</a> interface
  * provides the standard mechanism for an assistive technology to determine what
  * the current selected children are, as well as modify the selection set. Any
@@ -206,8 +206,8 @@
  * <a href="#AccessibleContext">AccessibleContext</a>. If the return value is
  * not {@code null}, the object supports this interface.
  *
- * <h3><a id="AccessibleText"></a><a href="AccessibleText.html">Interface
- * AccessibleText</a></h3>
+ * <h2><a id="AccessibleText"></a><a href="AccessibleText.html">Interface
+ * AccessibleText</a></h2>
  * Interface <a href="AccessibleText.html">AccessibleText</a> is the contract
  * for making rich, editable text Accessible. Not all text displayed on the
  * screen is rich and editable (e.g. text contained in buttons, labels, menus,
@@ -230,8 +230,8 @@
  * <a href="#AccessibleContext">AccessibleContext</a>. If the return value is
  * not {@code null}, the object supports this interface.
  *
- * <h3><a id="AccessibleHypertext"></a> <a href="AccessibleHypertext.html">
- * Interface AccessibleHypertext</a></h3>
+ * <h2><a id="AccessibleHypertext"></a> <a href="AccessibleHypertext.html">
+ * Interface AccessibleHypertext</a></h2>
  * The <a href="AccessibleHypertext.html">AccessibleHypertext</a> interface
  * should be supported by any object that presents hypertext information on the
  * display. This interface provides the standard mechanism for an assistive
@@ -246,16 +246,16 @@
  * class which extends AccessibleHypertext, then that object supports
  * AccessibleHypertext.
  *
- * <h3><a id="AccessibleHyperlink"></a><a href="AccessibleHyperlink.html">
- * Interface AccessibleHyperlink</a></h3>
+ * <h2><a id="AccessibleHyperlink"></a><a href="AccessibleHyperlink.html">
+ * Interface AccessibleHyperlink</a></h2>
  * An object that is a hyperlink should support the
  * <a href="AccessibleHyperlink.html">AccessibleHyperlink</a> interface.&nbsp;
  * An object that implements this interface will be returned by calling the
  * getLink method on an <a href="#AccessibleHypertext">AccessibleHypertext</a>
  * object.
  *
- * <h3><a id="AccessibleValue"></a><a href="AccessibleValue.html">Interface
- * AccessibleValue</a></h3>
+ * <h2><a id="AccessibleValue"></a><a href="AccessibleValue.html">Interface
+ * AccessibleValue</a></h2>
  * The <a href="AccessibleValue.html">AccessibleValue</a> interface should be
  * supported by any object that supports a numerical value (e.g., a scroll bar).
  * This interface provides the standard mechanism for an assistive technology to
--- a/src/java.desktop/share/classes/javax/print/DocFlavor.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/print/DocFlavor.java	Wed Mar 27 12:27:56 2019 +0530
@@ -60,7 +60,7 @@
  * class, from which the {@code DocPrintJob} then obtains the actual print data.
  *
  * <hr>
- * <h3>Client Formatted Print Data</h3>
+ * <h2>Client Formatted Print Data</h2>
  * There are two broad categories of print data, client formatted print data and
  * service formatted print data.
  * <p>
@@ -120,7 +120,7 @@
  * </ul>
  *
  * <hr>
- * <h3>Default and Platform Encodings</h3>
+ * <h2>Default and Platform Encodings</h2>
  * For byte print data where the doc flavor's MIME type does not include a
  * {@code charset} parameter, the Java Print Service instance assumes the
  * US-ASCII character set by default. This is in accordance with
@@ -161,7 +161,7 @@
  * the Java platform.
  *
  * <hr>
- * <h3>Recommended DocFlavors</h3>
+ * <h2>Recommended DocFlavors</h2>
  * The Java Print Service API does not define any mandatorily supported
  * {@code DocFlavors}. However, here are some examples of MIME types that a Java
  * Print Service instance might support for client formatted print data. Nested
@@ -261,7 +261,7 @@
  * </ul>
  *
  * <hr>
- * <h3>Service Formatted Print Data</h3>
+ * <h2>Service Formatted Print Data</h2>
  * For <b>service formatted print data</b>, the Java Print Service instance
  * determines the print data format. The doc flavor's representation class
  * denotes an interface whose methods the {@code DocPrintJob} invokes to
@@ -296,7 +296,7 @@
  * </ul>
  *
  * <hr>
- * <h3>Pre-defined Doc Flavors</h3>
+ * <h2>Pre-defined Doc Flavors</h2>
  * A Java Print Service instance is not <b><i>required</i></b> to support the
  * following print data formats and print data representation classes. In fact,
  * a developer using this class should <b>never</b> assume that a particular
@@ -342,7 +342,7 @@
  * The client must itself perform all plain text print data formatting not
  * addressed by the above requirements.
  *
- * <h3>Design Rationale</h3>
+ * <h2>Design Rationale</h2>
  * Class {@code DocFlavor} in package {@code javax.print} is similar to class
  * {@link java.awt.datatransfer.DataFlavor}. Class {@code DataFlavor} is not
  * used in the Java Print Service (JPS) API for three reasons which are all
--- a/src/java.desktop/share/classes/javax/print/attribute/package-info.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/print/attribute/package-info.java	Wed Mar 27 12:27:56 2019 +0530
@@ -27,7 +27,7 @@
  * Provides classes and interfaces that describe the types of Java&trade; Print
  * Service attributes and how they can be collected into attribute sets.
  *
- * <h3>What is an Attribute?</h3>
+ * <h2>What is an Attribute?</h2>
  * When setting up a print job, a client specifies two things: <b>print data</b>
  * and <b>processing instructions.</b> The print data is the actual content to
  * be printed. The processing instructions tell the printer how to print the
@@ -60,7 +60,7 @@
  * instructions as descriptive items provides more flexibility for implementing
  * print jobs.
  *
- * <h4>Attribute Categories and Values</h4>
+ * <h3>Attribute Categories and Values</h3>
  * Each printer has a set of capabilities, such as the ability to print on
  * different paper sizes or the ability to print more than one copy. Each of the
  * capabilities has a range of values. For example, a printer's orientation
@@ -80,7 +80,7 @@
  * attribute category, and the {@code Copies} instance represents the attribute
  * value.
  *
- * <h4><a id="role"></a>Attribute Roles</h4>
+ * <h3><a id="role"></a>Attribute Roles</h3>
  * When submitting a print job to a printer, the client provides the attributes
  * describing the characteristics of the print data, such as the document name,
  * and how the print data should be printed, such as double-sided, five copies.
@@ -128,7 +128,7 @@
  * conceptually separate from the generic apparatus defined in package
  * {@code javax.print.attribute}.
  *
- * <h3>Attribute Sets</h3>
+ * <h2>Attribute Sets</h2>
  * A client usually needs to provide more than one processing instruction when
  * submitting a print job. For example, the client might need to specify a media
  * size of A4 and a landscape orientation. To send more than one processing
@@ -201,7 +201,7 @@
  * restriction that the attribute set is only allowed to contain the
  * corresponding kind of attribute.
  *
- * <h3>Attribute Class Design</h3>
+ * <h2>Attribute Class Design</h2>
  * An attribute value is a small, atomic data item, such as an integer or an
  * enumerated value. The Java Print Service API does not use primitive data
  * types, such as int, to represent attribute values for these reasons:
@@ -295,7 +295,7 @@
  * references can be passed around freely. To get a different attribute value,
  * construct a different attribute object.
  *
- * <h3>Attribute Vendors</h3>
+ * <h2>Attribute Vendors</h2>
  * The Java Print Service API is designed so that vendors can:
  * <ul>
  *   <li>define new vendor-specific values for any standard attribute defined in
@@ -321,7 +321,7 @@
  * a new one. The new vendor-defined attribute can be used wherever an
  * {@code Attribute} is used, such as in an {@code AttributeSet}.
  *
- * <h3>Using Attributes</h3>
+ * <h2>Using Attributes</h2>
  * A typical printing application uses the {@code PrintRequestAttributeSet}
  * because print-request attributes are the types of attributes that client
  * usually specifies. This example demonstrates creating an attribute set of
--- a/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java	Wed Mar 27 12:27:56 2019 +0530
@@ -82,19 +82,19 @@
  * from the above documents. The above authors' contribution to the API is
  * gratefully acknowledged.
  *
- * <h3>Attribute Organization</h3>
+ * <h2>Attribute Organization</h2>
  * There are five kinds of printing attributes: doc attributes, print request
  * attributes, print job attributes, print service attributes, and
  * supported-values attributes.
  *
- * <h4>Doc Attributes</h4>
+ * <h3>Doc Attributes</h3>
  * Doc attributes specify the characteristics of an individual doc and the print
  * job settings to be applied to an individual doc. A doc attribute class
  * implements interface <a href="../DocAttribute.html">DocAttribute</a>. A doc
  * attribute can appear in a <a href="../DocAttributeSet.html">
  * DocAttributeSet</a>.
  *
- * <h4>Print Request Attributes</h4>
+ * <h3>Print Request Attributes</h3>
  * Print request attributes specify the settings to be applied to a whole print
  * job and to all the docs in the print job. A print request attribute class
  * implements interface <a href="../PrintRequestAttribute.html">
@@ -114,7 +114,7 @@
  * the doc level overrides an attribute in the same category specified at the
  * Print Request level.
  *
- * <h4>Print Job Attributes</h4>
+ * <h3>Print Job Attributes</h3>
  * Print job attributes report the status of a Print Job. A print job attribute
  * class implements interface <a href="../PrintJobAttribute.html">
  * PrintJobAttribute</a>. A print job attribute can appear in a
@@ -127,14 +127,14 @@
  * attributes but not print request attributes; the print service itself adds
  * these attributes to the Print Job's attribute set.
  *
- * <h4>Print Service Attributes</h4>
+ * <h3>Print Service Attributes</h3>
  * Print service attributes report the status of a print service. A print
  * service attribute class implements interface
  * <a href="../PrintServiceAttribute.html">PrintServiceAttribute</a>. A print
  * service attribute can appear in a <a href="../PrintServiceAttributeSet.html">
  * PrintServiceAttributeSet</a>.
  *
- * <h4>Supported-Values Attributes</h4>
+ * <h3>Supported-Values Attributes</h3>
  * A supported-value attribute indicates the legal values for another attribute
  * that a print service supports. A supported-values attribute class implements
  * interface <a href="../SupportedValuesAttribute.html">
@@ -142,7 +142,7 @@
  * appear in attribute sets, so there is no restricted
  * <a href="../AttributeSet.html">AttributeSet</a> subinterface for them.
  *
- * <h4>Attribute Table</h4>
+ * <h3>Attribute Table</h3>
  * The table below lists all the printing attributes. The table shows the
  * tagging interfaces each attribute class implements in addition to interface
  * <a href="../Attribute.html"> Attribute</a>, thus indicating how each
--- a/src/java.desktop/share/classes/javax/print/package-info.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/print/package-info.java	Wed Mar 27 12:27:56 2019 +0530
@@ -34,7 +34,7 @@
  *   printed.
  * </ul>
  *
- * <h3>Print Service Discovery</h3>
+ * <h2>Print Service Discovery</h2>
  * An application invokes the static methods of the abstract class
  * {@link javax.print.PrintServiceLookup PrintServiceLookup} to locate print
  * services that have the capabilities to satisfy the application's print
@@ -48,7 +48,7 @@
  * dynamically install these {@code PrintServiceLookup} implementations using
  * the {@link java.util.ServiceLoader} facility.
  *
- * <h3>Attribute Definitions</h3>
+ * <h2>Attribute Definitions</h2>
  * The {@link javax.print.attribute} and {@link javax.print.attribute.standard}
  * packages define print attributes, which describe the capabilities of a print
  * service, specify the requirements of a print job, and track the progress of a
@@ -65,7 +65,7 @@
  * capabilities, such as: resolution, copies, media sizes, job priority, and
  * page ranges.
  *
- * <h3>Document Type Specification</h3>
+ * <h2>Document Type Specification</h2>
  * The {@link javax.print.DocFlavor DocFlavor} class represents the print data
  * format, such as JPEG or PostScript. A {@code DocFlavor} object consists of a
  * MIME type, which describes the format, and a document representation class
@@ -74,7 +74,7 @@
  * find printers that can print the document type specified by the
  * {@code DocFlavor} and have the capabilities specified by the attribute set.
  *
- * <h3>Using the API</h3>
+ * <h2>Using the API</h2>
  * A typical application using the Java Print Service API performs these steps
  * to process a print request:
  * <ol>
--- a/src/java.desktop/share/classes/javax/swing/Action.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/swing/Action.java	Wed Mar 27 12:27:56 2019 +0530
@@ -69,7 +69,7 @@
  * are desired, and use simple <code>ActionListener</code>s elsewhere.
  * <br>
  *
- * <h3><a id="buttonActions"></a>Swing Components Supporting <code>Action</code></h3>
+ * <h2><a id="buttonActions"></a>Swing Components Supporting <code>Action</code></h2>
  * <p>
  * Many of Swing's components have an <code>Action</code> property.  When
  * an <code>Action</code> is set on a component, the following things
--- a/src/java.desktop/share/classes/javax/swing/GroupLayout.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/swing/GroupLayout.java	Wed Mar 27 12:27:56 2019 +0530
@@ -2377,7 +2377,7 @@
      * {@code ParallelGroup} aligns its children in
      * four possible ways: along the baseline, centered, anchored to the
      * leading edge, or anchored to the trailing edge.
-     * <h3>Baseline</h3>
+     * <h2>Baseline</h2>
      * A {@code ParallelGroup} that aligns its children along the
      * baseline must first decide where the baseline is
      * anchored. The baseline can either be anchored to the top, or
@@ -2427,7 +2427,7 @@
      * ways: centered, anchored to the leading edge, or anchored to the
      * trailing edge.
      *
-     * <h3>Non-baseline {@code ParallelGroup}</h3>
+     * <h2>Non-baseline {@code ParallelGroup}</h2>
      * {@code ParallelGroup}s created with an alignment other than
      * {@code BASELINE} align elements that are smaller than the size
      * of the group in one of three ways: centered, anchored to the
--- a/src/java.desktop/share/classes/javax/swing/JTable.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/swing/JTable.java	Wed Mar 27 12:27:56 2019 +0530
@@ -3050,9 +3050,9 @@
      *   of elements with a size, preferred size, maximum size and minimum size
      *   to have its elements manipulated by the algorithm.
      *
-     * <H3> Distributing the delta </H3>
-     *
-     * <H4> Overview </H4>
+     * <H4> Distributing the delta </H4>
+     *
+     * <H5> Overview </H5>
      * <P>
      * Call "DELTA" the difference between the target size and the
      * sum of the preferred sizes of the elements in r. The individual
@@ -3061,7 +3061,7 @@
      * how far each preferred size is from its limiting bound (minimum or
      * maximum).
      *
-     * <H4>Definition</H4>
+     * <H5>Definition</H5>
      * <P>
      * Call the individual constraints min[i], max[i], and pref[i].
      * <p>
@@ -3093,7 +3093,7 @@
      * k, towards the total minimum or maximum and that percentage guarantees
      * accommodation of the required space, DELTA.
      *
-     * <H4>Details</H4>
+     * <H5>Details</H5>
      * <P>
      * Naive evaluation of the formulae presented here would be subject to
      * the aggregated rounding errors caused by doing this operation in finite
@@ -3104,7 +3104,7 @@
      * <code>targetSize</code>, and does so by spreading the rounding
      * errors evenly over the given elements.
      *
-     * <H4>When the MAX and MIN bounds are hit</H4>
+     * <H5>When the MAX and MIN bounds are hit</H5>
      * <P>
      * When <code>targetSize</code> is outside the [MIN, MAX] range,
      * the algorithm sets all sizes to their appropriate limiting value
--- a/src/java.desktop/share/classes/javax/swing/SizeSequence.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/swing/SizeSequence.java	Wed Mar 27 12:27:56 2019 +0530
@@ -76,7 +76,7 @@
  * could be just as valid.
  *
  *
- * <h3>Implementation Notes</h3>
+ * <h2>Implementation Notes</h2>
  *
  * Normally when storing the size and position of entries,
  * one would choose between
--- a/src/java.desktop/share/classes/javax/swing/SpringLayout.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/swing/SpringLayout.java	Wed Mar 27 12:27:56 2019 +0530
@@ -128,9 +128,9 @@
  * the edges of components from different containers (either internal or
  * external) is undefined.
  *
- * <h3>
+ * <h2>
  * SpringLayout vs. Other Layout Managers
- * </h3>
+ * </h2>
  *
  * <blockquote>
  * <hr>
--- a/src/java.desktop/share/classes/javax/swing/UIManager.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/swing/UIManager.java	Wed Mar 27 12:27:56 2019 +0530
@@ -70,7 +70,7 @@
  * are notified when the look and feel changes, look and feel defaults, and
  * convenience methods for obtaining various default values.
  *
- * <h3>Specifying the look and feel</h3>
+ * <h2>Specifying the look and feel</h2>
  *
  * The look and feel can be specified in two distinct ways: by
  * specifying the fully qualified name of the class for the look and
@@ -94,7 +94,7 @@
  * unspecified. It is very possible to receive unexpected exceptions,
  * painting problems, or worse.
  *
- * <h3>Default look and feel</h3>
+ * <h2>Default look and feel</h2>
  *
  * The class used for the default look and feel is chosen in the following
  * manner:
@@ -114,7 +114,7 @@
  *   <li>Otherwise use the cross platform look and feel.
  * </ol>
  *
- * <h3>Defaults</h3>
+ * <h2>Defaults</h2>
  *
  * {@code UIManager} manages three sets of {@code UIDefaults}. In order, they
  * are:
--- a/src/java.desktop/share/classes/javax/swing/plaf/metal/DefaultMetalTheme.java	Wed Mar 27 12:24:28 2019 +0530
+++ b/src/java.desktop/share/classes/javax/swing/plaf/metal/DefaultMetalTheme.java	Wed Mar 27 12:27:56 2019 +0530
@@ -42,7 +42,7 @@
  * All colors returned by {@code DefaultMetalTheme} are completely
  * opaque.
  *
- * <h3><a id="fontStyle"></a>Font Style</h3>
+ * <h2><a id="fontStyle"></a>Font Style</h2>
  *
  * {@code DefaultMetalTheme} uses bold fonts for many controls.  To make all
  * controls (with the exception of the internal frame title bars and