From 374b0360a4c712eba277a844d9bf0cd5d95a5af2 Mon Sep 17 00:00:00 2001 From: cl Date: Wed, 2 Oct 2013 11:28:07 -0700 Subject: [PATCH] 8025409: Fix javadoc comments errors and warning reported by doclint report Reviewed-by: anthony, yan --- src/share/classes/java/awt/BorderLayout.java | 2 +- src/share/classes/java/awt/Button.java | 2 +- src/share/classes/java/awt/Checkbox.java | 2 +- src/share/classes/java/awt/CheckboxGroup.java | 2 +- .../classes/java/awt/CheckboxMenuItem.java | 2 +- src/share/classes/java/awt/Choice.java | 2 +- src/share/classes/java/awt/Color.java | 2 +- src/share/classes/java/awt/EventQueue.java | 4 +- src/share/classes/java/awt/FlowLayout.java | 2 +- src/share/classes/java/awt/FontMetrics.java | 4 +- src/share/classes/java/awt/Frame.java | 2 +- src/share/classes/java/awt/GridBagLayout.java | 12 ++-- src/share/classes/java/awt/GridLayout.java | 4 +- src/share/classes/java/awt/Label.java | 2 +- .../classes/java/awt/LinearGradientPaint.java | 2 +- src/share/classes/java/awt/List.java | 2 +- src/share/classes/java/awt/MenuBar.java | 2 +- src/share/classes/java/awt/MenuItem.java | 4 +- .../classes/java/awt/RadialGradientPaint.java | 8 +-- src/share/classes/java/awt/Scrollbar.java | 6 +- src/share/classes/java/awt/SystemTray.java | 4 +- src/share/classes/java/awt/TextArea.java | 2 +- src/share/classes/java/awt/TextField.java | 2 +- src/share/classes/java/awt/Window.java | 2 +- .../classes/java/awt/font/TextAttribute.java | 26 ++++---- .../java/awt/geom/AffineTransform.java | 2 +- src/share/classes/java/awt/geom/Line2D.java | 6 +- .../classes/java/awt/print/PrinterJob.java | 8 +-- src/share/classes/javax/print/Doc.java | 6 +- src/share/classes/javax/print/DocFlavor.java | 24 ++++---- src/share/classes/javax/print/MultiDoc.java | 8 +-- .../print/attribute/standard/Finishings.java | 48 +++++++-------- .../attribute/standard/JobStateReasons.java | 2 +- .../standard/MediaPrintableArea.java | 26 ++++---- .../standard/MultipleDocumentHandling.java | 10 ++-- .../standard/PrinterStateReasons.java | 2 +- .../javax/print/attribute/standard/Sides.java | 8 +-- .../classes/javax/swing/JLayeredPane.java | 6 +- .../classes/javax/swing/JOptionPane.java | 12 ++-- .../classes/javax/swing/JScrollPane.java | 6 +- .../classes/javax/swing/JTabbedPane.java | 60 +++++++++---------- .../classes/javax/swing/LookAndFeel.java | 4 +- .../swing/plaf/metal/MetalLookAndFeel.java | 4 +- .../javax/swing/plaf/metal/MetalTreeUI.java | 6 +- .../classes/javax/swing/text/Document.java | 10 ++-- .../javax/swing/text/MaskFormatter.java | 2 +- src/share/classes/javax/swing/text/View.java | 4 +- .../javax/swing/text/html/HTMLDocument.java | 14 ++--- 48 files changed, 191 insertions(+), 191 deletions(-) diff --git a/src/share/classes/java/awt/BorderLayout.java b/src/share/classes/java/awt/BorderLayout.java index 9b8644712..98bd4d5a9 100644 --- a/src/share/classes/java/awt/BorderLayout.java +++ b/src/share/classes/java/awt/BorderLayout.java @@ -96,7 +96,7 @@ import java.util.Hashtable; * alt="Diagram of an applet demonstrating BorderLayout. * Each section of the BorderLayout contains a Button corresponding to its position in the layout, one of: * North, West, Center, East, or South." - * ALIGN=center HSPACE=10 VSPACE=7> + * style="float:center; margin: 7px 10px;"> *

* The code for this applet is as follows: *

diff --git a/src/share/classes/java/awt/Button.java b/src/share/classes/java/awt/Button.java index 9fe42d41c..83506b6fd 100644 --- a/src/share/classes/java/awt/Button.java +++ b/src/share/classes/java/awt/Button.java @@ -40,7 +40,7 @@ import javax.accessibility.*; * under the Solaris operating system: *

* The following context describes the graphic + * style="float:center; margin: 7px 10px;"> *

* The first view shows the button as it appears normally. * The second view shows the button diff --git a/src/share/classes/java/awt/Checkbox.java b/src/share/classes/java/awt/Checkbox.java index f0486f35e..7568b0c5a 100644 --- a/src/share/classes/java/awt/Checkbox.java +++ b/src/share/classes/java/awt/Checkbox.java @@ -53,7 +53,7 @@ import javax.accessibility.*; * created by this code example: *

* The following context describes the graphic. + * style="float:center; margin: 7px 10px;"> *

* The button labeled one is in the "on" state, and the * other two are in the "off" state. In this example, which uses the diff --git a/src/share/classes/java/awt/CheckboxGroup.java b/src/share/classes/java/awt/CheckboxGroup.java index e953daaba..25b0697f1 100644 --- a/src/share/classes/java/awt/CheckboxGroup.java +++ b/src/share/classes/java/awt/CheckboxGroup.java @@ -48,7 +48,7 @@ package java.awt; *

* Shows three checkboxes, arranged vertically, labeled one, two, and three. Checkbox one is in the on state. + * style="float:center; margin: 7px 10px;"> *

* @author Sami Shaio * @see java.awt.Checkbox diff --git a/src/share/classes/java/awt/CheckboxMenuItem.java b/src/share/classes/java/awt/CheckboxMenuItem.java index ad12d4c29..4da887ee2 100644 --- a/src/share/classes/java/awt/CheckboxMenuItem.java +++ b/src/share/classes/java/awt/CheckboxMenuItem.java @@ -44,7 +44,7 @@ import sun.awt.AWTAccessor; *

* Menu labeled Examples, containing items Basic, Simple, Check, and More Examples. The Check item is a CheckBoxMenuItem instance, in the off state. + * style="float:center; margin: 7px 10px;"> *

* The item labeled Check shows a check box menu item * in its "off" state. diff --git a/src/share/classes/java/awt/Choice.java b/src/share/classes/java/awt/Choice.java index e026953b2..e74bd094f 100644 --- a/src/share/classes/java/awt/Choice.java +++ b/src/share/classes/java/awt/Choice.java @@ -52,7 +52,7 @@ import javax.accessibility.*; * it appears as follows in its normal state: *

* The following text describes the graphic + * style="float:center; margin: 7px 10px;"> *

* In the picture, "Green" is the current choice. * Pushing the mouse button down on the object causes a menu to diff --git a/src/share/classes/java/awt/Color.java b/src/share/classes/java/awt/Color.java index 51d46a45f..464fe9873 100644 --- a/src/share/classes/java/awt/Color.java +++ b/src/share/classes/java/awt/Color.java @@ -823,7 +823,7 @@ public class Color implements Paint, java.io.Serializable { *

* The integer that is returned by HSBtoRGB encodes the * value of a color in bits 0-23 of an integer value that is the same - * format used by the method {@link #getRGB() getRGB}. + * format used by the method {@link #getRGB() getRGB}. * This integer can be supplied as an argument to the * Color constructor that takes a single integer argument. * @param hue the hue component of the color diff --git a/src/share/classes/java/awt/EventQueue.java b/src/share/classes/java/awt/EventQueue.java index 1a04dcb50..d6a1dabfc 100644 --- a/src/share/classes/java/awt/EventQueue.java +++ b/src/share/classes/java/awt/EventQueue.java @@ -652,7 +652,7 @@ public class EventQueue { * Dispatches an event. The manner in which the event is * dispatched depends upon the type of the event and the * type of the event's source object: - *

+ *

* * * @@ -680,7 +680,7 @@ public class EventQueue { * * *
Event TypeNo action (ignored)
- *

+ *

* @param event an instance of java.awt.AWTEvent, * or a subclass of it * @throws NullPointerException if event is null diff --git a/src/share/classes/java/awt/FlowLayout.java b/src/share/classes/java/awt/FlowLayout.java index 228035d10..4675bbc57 100644 --- a/src/share/classes/java/awt/FlowLayout.java +++ b/src/share/classes/java/awt/FlowLayout.java @@ -54,7 +54,7 @@ import java.io.IOException; *

* Graphic of Layout for Three Buttons + * style="float:center; margin: 7px 10px;"> *

* Here is the code for this applet: *

diff --git a/src/share/classes/java/awt/FontMetrics.java b/src/share/classes/java/awt/FontMetrics.java index 31f2e764f..cd6c0fbba 100644 --- a/src/share/classes/java/awt/FontMetrics.java +++ b/src/share/classes/java/awt/FontMetrics.java @@ -51,8 +51,8 @@ import java.text.CharacterIterator; *

  • {@link #charsWidth(char[], int, int)} * *

    - * The letter 'p' showing its 'reference point' + * The letter 'p' showing its 'reference point' * Note that the implementations of these methods are * inefficient, so they are usually overridden with more efficient * toolkit-specific implementations. diff --git a/src/share/classes/java/awt/Frame.java b/src/share/classes/java/awt/Frame.java index c7f5d4bcb..7a7f02fd8 100644 --- a/src/share/classes/java/awt/Frame.java +++ b/src/share/classes/java/awt/Frame.java @@ -83,7 +83,7 @@ import javax.accessibility.*; * Diagram of virtual device encompassing three physical screens and one primary physical screen. The primary physical screen * shows (0,0) coords while a different physical screen shows (-80,-100) coords. + * style="float:center; margin: 7px 10px;"> *

    * In such an environment, when calling setLocation, * you must pass a virtual coordinate to this method. Similarly, diff --git a/src/share/classes/java/awt/GridBagLayout.java b/src/share/classes/java/awt/GridBagLayout.java index fb306a8d3..1362e57dd 100644 --- a/src/share/classes/java/awt/GridBagLayout.java +++ b/src/share/classes/java/awt/GridBagLayout.java @@ -125,9 +125,9 @@ import java.util.Arrays; *

    * - * - * - * + * + * + * * * * * *

    Absolute Values

    Orientation Relative Values

    Baseline Relative Values

    Absolute Values

    Orientation Relative Values

    Baseline Relative Values

    @@ -201,7 +201,7 @@ import java.util.Arrays; *
    * The following text describes this graphic (Figure 1). + * alt="The following text describes this graphic (Figure 1)." style="float:center"> *
    * This layout consists of three components: @@ -255,10 +255,10 @@ import java.util.Arrays; *
    * * * * * diff --git a/src/share/classes/java/awt/GridLayout.java b/src/share/classes/java/awt/GridLayout.java index b08802e8e..596208c3e 100644 --- a/src/share/classes/java/awt/GridLayout.java +++ b/src/share/classes/java/awt/GridLayout.java @@ -55,7 +55,7 @@ package java.awt; * If the container's ComponentOrientation property is horizontal * and right-to-left, the example produces the output shown in Figure 2. *

    - *

    - * The preceeding text describes this graphic (Figure 1). + * The preceeding text describes this graphic (Figure 1). * - * The preceeding text describes this graphic (Figure 2). + * The preceeding text describes this graphic (Figure 2). *
    Figure 2: Horizontal, Left-to-Right
    + *
    * *
    Shows 6 buttons in rows of 2. Row 1 shows buttons 1 then 2. @@ -73,7 +73,7 @@ package java.awt; * * <td>Figure 2: Horizontal, Right-to-Left</td> * </tr> - * </table></center> + * </table> * <p> * When both the number of rows and the number of columns have * been set to non-zero values, either by a constructor or diff --git a/src/share/classes/java/awt/Label.java b/src/share/classes/java/awt/Label.java index c5f174a75..1772875d5 100644 --- a/src/share/classes/java/awt/Label.java +++ b/src/share/classes/java/awt/Label.java @@ -46,7 +46,7 @@ import javax.accessibility.*; * produces the following labels: * <p> * <img src= + * style="float:center; margin: 7px 10px;"> * * @author Sami Shaio * @since JDK1.0 diff --git a/src/share/classes/java/awt/LinearGradientPaint.java b/src/share/classes/java/awt/LinearGradientPaint.java index ffb5c9b2d..e9fbcfc5d 100644 --- a/src/share/classes/java/awt/LinearGradientPaint.java +++ b/src/share/classes/java/awt/LinearGradientPaint.java @@ -94,7 +94,7 @@ import java.beans.ConstructorProperties; * of the three cycle methods: *

    *

    - * + * LinearGradientPaint *
    * * @see java.awt.Paint diff --git a/src/share/classes/java/awt/List.java b/src/share/classes/java/awt/List.java index 92a1867d8..dba6ac0bc 100644 --- a/src/share/classes/java/awt/List.java +++ b/src/share/classes/java/awt/List.java @@ -61,7 +61,7 @@ import javax.accessibility.*; * scrolling list: *

    * Shows a list containing: Venus, Earth, JavaSoft, and Mars. Javasoft is selected. + * alt="Shows a list containing: Venus, Earth, JavaSoft, and Mars. Javasoft is selected." style="float:center; margin: 7px 10px;"> *

    * If the List allows multiple selections, then clicking on * an item that is already selected deselects it. In the preceding diff --git a/src/share/classes/java/awt/MenuBar.java b/src/share/classes/java/awt/MenuBar.java index feae49a4d..2c494ade0 100644 --- a/src/share/classes/java/awt/MenuBar.java +++ b/src/share/classes/java/awt/MenuBar.java @@ -45,7 +45,7 @@ import javax.accessibility.*; * Diagram of MenuBar containing 2 menus: Examples and Options. * Examples menu is expanded showing items: Basic, Simple, Check, and More Examples. + * style="float:center; margin: 7px 10px;"> *

    * A menu bar handles keyboard shortcuts for menu items, passing them * along to its child menus. diff --git a/src/share/classes/java/awt/MenuItem.java b/src/share/classes/java/awt/MenuItem.java index 4838d187a..b660e20d9 100644 --- a/src/share/classes/java/awt/MenuItem.java +++ b/src/share/classes/java/awt/MenuItem.java @@ -42,8 +42,8 @@ import sun.awt.AWTAccessor; *

    * This picture of a menu bar shows five menu items: * The following text describes this graphic. - *
    + * style="float:center; margin: 7px 10px;"> + *
    * The first two items are simple menu items, labeled * "Basic" and "Simple". * Following these two items is a separator, which is itself diff --git a/src/share/classes/java/awt/RadialGradientPaint.java b/src/share/classes/java/awt/RadialGradientPaint.java index c9cc43a8e..a0bf944b9 100644 --- a/src/share/classes/java/awt/RadialGradientPaint.java +++ b/src/share/classes/java/awt/RadialGradientPaint.java @@ -80,14 +80,14 @@ import java.beans.ConstructorProperties; * from the focus point. The following figure shows that the distance AB * is equal to the distance BC, and the distance AD is equal to the distance DE. *

    - * + * RadialGradientPaint-3 *
    * If the gradient and graphics rendering transforms are uniformly scaled and * the user sets the focus so that it coincides with the center of the circle, * the gradient color proportions are equal for any line drawn from the center. * The following figure shows the distances AB, BC, AD, and DE. They are all equal. *
    - * + * RadialGradientPaint-4 *
    * Note that some minor variations in distances may occur due to sampling at * the granularity of a pixel. @@ -117,7 +117,7 @@ import java.beans.ConstructorProperties; * (centered) focus for each of the three cycle methods: *

    *

    - * + * RadialGradientPaint-1 *
    * *

    @@ -141,7 +141,7 @@ import java.beans.ConstructorProperties; * focus for each of the three cycle methods: *

    *

    - * + * RadialGradientPaint-2 *
    * * @see java.awt.Paint diff --git a/src/share/classes/java/awt/Scrollbar.java b/src/share/classes/java/awt/Scrollbar.java index 8ecf57830..984948071 100644 --- a/src/share/classes/java/awt/Scrollbar.java +++ b/src/share/classes/java/awt/Scrollbar.java @@ -42,7 +42,7 @@ import javax.accessibility.*; * the red, green, and blue components of a color: *

    * Image shows 3 vertical sliders, side-by-side. + * style="float:center; margin: 7px 10px;"> *

    * Each scroll bar in this example could be created with * code similar to the following: @@ -60,7 +60,7 @@ import javax.accessibility.*; *

    * Image shows horizontal slider with starting range of 0 and ending range of 300. The slider thumb is labeled 60. + * style="float:center; margin: 7px 10px;"> *

    * The value range represented by the bubble in this example * is the visible amount. The horizontal scroll bar @@ -295,7 +295,7 @@ public class Scrollbar extends Component implements Adjustable, Accessible { * Constructs a new vertical scroll bar. * The default properties of the scroll bar are listed in * the following table: - *

    + *

    * * * diff --git a/src/share/classes/java/awt/SystemTray.java b/src/share/classes/java/awt/SystemTray.java index 84e89265c..20ba91287 100644 --- a/src/share/classes/java/awt/SystemTray.java +++ b/src/share/classes/java/awt/SystemTray.java @@ -361,7 +361,7 @@ public class SystemTray { /** * Adds a {@code PropertyChangeListener} to the list of listeners for the * specific property. The following properties are currently supported: - *

    + *

    *

    Property
    * * @@ -384,7 +384,7 @@ public class SystemTray { * The property is accessed by the {@link #getSystemTray} method. * *
    Property
    - *

    + *

    * The {@code listener} listens to property changes only in this context. *

    * If {@code listener} is {@code null}, no exception is thrown diff --git a/src/share/classes/java/awt/TextArea.java b/src/share/classes/java/awt/TextArea.java index 8b16d9ec6..6fc979f28 100644 --- a/src/share/classes/java/awt/TextArea.java +++ b/src/share/classes/java/awt/TextArea.java @@ -42,7 +42,7 @@ import javax.accessibility.*; * The following image shows the appearance of a text area: *

    * A TextArea showing the word 'Hello!' + * style="float:center; margin: 7px 10px;"> *

    * This text area could be created by the following line of code: *

    diff --git a/src/share/classes/java/awt/TextField.java b/src/share/classes/java/awt/TextField.java index cbaf649f1..cfdaf51e2 100644 --- a/src/share/classes/java/awt/TextField.java +++ b/src/share/classes/java/awt/TextField.java @@ -42,7 +42,7 @@ import javax.accessibility.*; * display the predefined text "Hello". *

    * The preceding text describes this image. + * style="float:center; margin: 7px 10px;"> *

    * Here is the code that produces these four text fields: *

    diff --git a/src/share/classes/java/awt/Window.java b/src/share/classes/java/awt/Window.java index 1994f4795..1df36b1ab 100644 --- a/src/share/classes/java/awt/Window.java +++ b/src/share/classes/java/awt/Window.java @@ -85,7 +85,7 @@ import sun.util.logging.PlatformLogger; *

    * Diagram shows virtual device containing 4 physical screens. Primary physical screen shows coords (0,0), other screen shows (-80,-100). + * style="float:center; margin: 7px 10px;"> *

    * In such an environment, when calling {@code setLocation}, * you must pass a virtual coordinate to this method. Similarly, diff --git a/src/share/classes/java/awt/font/TextAttribute.java b/src/share/classes/java/awt/font/TextAttribute.java index 50d47dace..c46263634 100644 --- a/src/share/classes/java/awt/font/TextAttribute.java +++ b/src/share/classes/java/awt/font/TextAttribute.java @@ -97,10 +97,10 @@ import java.util.HashMap; *

    Summary of attributes

    *

    * - * - * + * * * * @@ -115,7 +115,7 @@ import java.util.HashMap; * * - * + * * * * @@ -127,7 +127,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -139,7 +139,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -151,7 +151,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -163,7 +163,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -175,7 +175,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -187,7 +187,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -199,7 +199,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -211,7 +211,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -223,7 +223,7 @@ import java.util.HashMap; * * * - * + * * * * @@ -235,7 +235,7 @@ import java.util.HashMap; * * * - * + * * * * diff --git a/src/share/classes/java/awt/geom/AffineTransform.java b/src/share/classes/java/awt/geom/AffineTransform.java index 751deac24..0977cf8ea 100644 --- a/src/share/classes/java/awt/geom/AffineTransform.java +++ b/src/share/classes/java/awt/geom/AffineTransform.java @@ -47,7 +47,7 @@ import java.beans.ConstructorProperties; * [ 1 ] [ 0 0 1 ] [ 1 ] [ 1 ] * *

    - *

    Handling 90-Degree Rotations

    + *

    Handling 90-Degree Rotations

    *

    * In some variations of the rotate methods in the * AffineTransform class, a double-precision argument diff --git a/src/share/classes/java/awt/geom/Line2D.java b/src/share/classes/java/awt/geom/Line2D.java index 2eccbd0c5..35f70ad5d 100644 --- a/src/share/classes/java/awt/geom/Line2D.java +++ b/src/share/classes/java/awt/geom/Line2D.java @@ -82,7 +82,7 @@ public abstract class Line2D implements Shape, Cloneable { public float y2; /** - * Constructs and initializes a Line with coordinates (0, 0) -> (0, 0). + * Constructs and initializes a Line with coordinates (0, 0) → (0, 0). * @since 1.2 */ public Float() { @@ -249,7 +249,7 @@ public abstract class Line2D implements Shape, Cloneable { public double y2; /** - * Constructs and initializes a Line with coordinates (0, 0) -> (0, 0). + * Constructs and initializes a Line with coordinates (0, 0) → (0, 0). * @since 1.2 */ public Double() { @@ -623,7 +623,7 @@ public abstract class Line2D implements Shape, Cloneable { * specified line segment * @param y2 the Y coordinate of the end point of the * specified line segment - * @return if this line segment and the specified line segment + * @return {@code } if this line segment and the specified line segment * intersect each other; false otherwise. * @since 1.2 */ diff --git a/src/share/classes/java/awt/print/PrinterJob.java b/src/share/classes/java/awt/print/PrinterJob.java index 2735ef7ed..6ac1133b6 100644 --- a/src/share/classes/java/awt/print/PrinterJob.java +++ b/src/share/classes/java/awt/print/PrinterJob.java @@ -98,7 +98,7 @@ public abstract class PrinterJob { * Calling this method is equivalent to calling * {@link javax.print.PrintServiceLookup#lookupPrintServices( * DocFlavor, AttributeSet) - * PrintServiceLookup.lookupPrintServices()} + * PrintServiceLookup.lookupPrintServices()} * and specifying a Pageable DocFlavor. * @return a possibly empty array of 2D print services. * @since 1.4 @@ -136,8 +136,8 @@ public abstract class PrinterJob { * PrinterJob instances which support print services. * Calling this method is equivalent to calling * {@link javax.print.StreamPrintServiceFactory#lookupStreamPrintServiceFactories(DocFlavor, String) - * StreamPrintServiceFactory.lookupStreamPrintServiceFactories() - * } and specifying a Pageable DocFlavor. + * StreamPrintServiceFactory.lookupStreamPrintServiceFactories() + * } and specifying a Pageable DocFlavor. * * @param mimeType the required output format, or null to mean any format. * @return a possibly empty array of 2D stream print service factories. @@ -155,7 +155,7 @@ public abstract class PrinterJob { /** * A PrinterJob object should be created using the - * static {@link #getPrinterJob() getPrinterJob} method. + * static {@link #getPrinterJob() getPrinterJob} method. */ public PrinterJob() { } diff --git a/src/share/classes/javax/print/Doc.java b/src/share/classes/javax/print/Doc.java index 04d92d2e4..187873135 100644 --- a/src/share/classes/javax/print/Doc.java +++ b/src/share/classes/javax/print/Doc.java @@ -65,8 +65,8 @@ import javax.print.attribute.DocAttributeSet; * representation object "consumes" the print data as the caller obtains the * print data, such as a print data representation object which is a stream. * Once the Print Job has called {@link #getPrintData() - * getPrintData()} and obtained the stream, any further calls to - * {@link #getPrintData() getPrintData()} will return the same + * getPrintData()} and obtained the stream, any further calls to + * {@link #getPrintData() getPrintData()} will return the same * stream object upon which reading may already be in progress, not a new * stream object that will re-read the print data from the beginning. Specifying * a doc object to behave this way simplifies the implementation of doc objects, @@ -83,7 +83,7 @@ import javax.print.attribute.DocAttributeSet; * object is constructed. In this case the doc object might provide a "lazy" * implementation that generates the print data representation object (and/or * the print data) only when the Print Job calls for it (when the Print Job - * calls the {@link #getPrintData() getPrintData()} method). + * calls the {@link #getPrintData() getPrintData()} method). *

    * There is no restriction on the number of client threads that may be * simultaneously accessing the same doc. Therefore, all implementations of diff --git a/src/share/classes/javax/print/DocFlavor.java b/src/share/classes/javax/print/DocFlavor.java index 5b3f10c24..c5d96af42 100644 --- a/src/share/classes/javax/print/DocFlavor.java +++ b/src/share/classes/javax/print/DocFlavor.java @@ -53,7 +53,7 @@ import java.io.Serializable; *

  • * Representation class name. This specifies the fully-qualified name of * the class of the object from which the actual print data comes, as returned - * by the {@link java.lang.Class#getName() Class.getName()} method. + * by the {@link java.lang.Class#getName() Class.getName()} method. * (Thus the class name for byte[] is "[B", for * char[] it is "[C".) * @@ -174,7 +174,7 @@ import java.io.Serializable; * platform for data (eg files) stored in that platform's encoding. * A CharSet which corresponds to this and is suitable for use in a * mime-type for a DocFlavor can be obtained - * from {@link DocFlavor#hostEncoding DocFlavor.hostEncoding} + * from {@link DocFlavor#hostEncoding DocFlavor.hostEncoding} * This may not always be the primary IANA name but is guaranteed to be * understood by this VM. * For common flavors, the pre-defined *HOST DocFlavors may be used. @@ -669,7 +669,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Doc flavor with MIME type = "text/plain", * encoded in the host platform encoding. - * See {@link DocFlavor#hostEncoding hostEncoding} + * See {@link DocFlavor#hostEncoding hostEncoding} * Print data representation class name = * "[B" (byte array). */ @@ -728,7 +728,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Doc flavor with MIME type = "text/html", * encoded in the host platform encoding. - * See {@link DocFlavor#hostEncoding hostEncoding} + * See {@link DocFlavor#hostEncoding hostEncoding} * Print data representation class name = * "[B" (byte array). */ @@ -838,7 +838,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Class DocFlavor.INPUT_STREAM provides predefined static constant * DocFlavor objects for example doc flavors using a byte stream ({@link - * java.io.InputStream java.io.InputStream}) as the print + * java.io.InputStream java.io.InputStream}) as the print * data representation class. *

    * @@ -868,7 +868,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Doc flavor with MIME type = "text/plain", * encoded in the host platform encoding. - * See {@link DocFlavor#hostEncoding hostEncoding} + * See {@link DocFlavor#hostEncoding hostEncoding} * Print data representation class name = * "java.io.InputStream" (byte stream). */ @@ -925,7 +925,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Doc flavor with MIME type = "text/html", * encoded in the host platform encoding. - * See {@link DocFlavor#hostEncoding hostEncoding} + * See {@link DocFlavor#hostEncoding hostEncoding} * Print data representation class name = * "java.io.InputStream" (byte stream). */ @@ -1041,7 +1041,7 @@ public class DocFlavor implements Serializable, Cloneable { * Class DocFlavor.URL provides predefined static constant DocFlavor * objects. * For example doc flavors using a Uniform Resource Locator ({@link - * java.net.URL java.net.URL}) as the print data + * java.net.URL java.net.URL}) as the print data * representation class. *

    * @@ -1068,7 +1068,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Doc flavor with MIME type = "text/plain", * encoded in the host platform encoding. - * See {@link DocFlavor#hostEncoding hostEncoding} + * See {@link DocFlavor#hostEncoding hostEncoding} * Print data representation class name = * "java.net.URL" (byte stream). */ @@ -1125,7 +1125,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Doc flavor with MIME type = "text/html", * encoded in the host platform encoding. - * See {@link DocFlavor#hostEncoding hostEncoding} + * See {@link DocFlavor#hostEncoding hostEncoding} * Print data representation class name = * "java.net.URL" (byte stream). */ @@ -1280,7 +1280,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Class DocFlavor.STRING provides predefined static constant DocFlavor * objects for example doc flavors using a string ({@link java.lang.String - * java.lang.String}) as the print data representation class. + * java.lang.String}) as the print data representation class. * As such, the character set is Unicode. *

    * @@ -1328,7 +1328,7 @@ public class DocFlavor implements Serializable, Cloneable { /** * Class DocFlavor.READER provides predefined static constant DocFlavor * objects for example doc flavors using a character stream ({@link - * java.io.Reader java.io.Reader}) as the print data + * java.io.Reader java.io.Reader}) as the print data * representation class. As such, the character set is Unicode. *

    * diff --git a/src/share/classes/javax/print/MultiDoc.java b/src/share/classes/javax/print/MultiDoc.java index 69a1756d8..4813a5993 100644 --- a/src/share/classes/javax/print/MultiDoc.java +++ b/src/share/classes/javax/print/MultiDoc.java @@ -39,9 +39,9 @@ import java.io.IOException; * docs. A multidoc object is like a node in the linked list, containing the * current doc in the list and a pointer to the next node (multidoc) in the * list. The Print Job can call the multidoc's {@link #getDoc() - * getDoc()} method to get the current doc. When it's ready to go + * getDoc()} method to get the current doc. When it's ready to go * on to the next doc, the Print Job can call the multidoc's {@link #next() - * next()} method to get the next multidoc, which contains the + * next()} method to get the next multidoc, which contains the * next doc. So Print Job code for accessing a multidoc might look like this: * 

      *      void processMultiDoc(MultiDoc theMultiDoc) {
@@ -88,12 +88,12 @@ import java.io.IOException;
 * multiple docs to a Print Job, every Print Service proxy that supports
  * multidoc print jobs is required to access a MultiDoc object using the
  * interleaved pattern. That is, given a MultiDoc object, the print service
- * proxy will call {@link #getDoc() getDoc()} one or more times
+ * proxy will call {@link #getDoc() getDoc()} one or more times
  * until it successfully obtains the current Doc object. The print service proxy
  * will then obtain the current doc's print data, not proceeding until all the
  * print data is obtained or an unrecoverable error occurs. If it is able to
  * continue, the print service proxy will then call {@link #next()
- * next()} one or more times until it successfully obtains either
+ * next()} one or more times until it successfully obtains either
  * the next MultiDoc object or an indication that there are no more. An
  * implementation of interface MultiDoc can assume the print service proxy will
  * follow this interleaved pattern; for any other pattern of usage, the MultiDoc
diff --git a/src/share/classes/javax/print/attribute/standard/Finishings.java b/src/share/classes/javax/print/attribute/standard/Finishings.java
index 3f09cd908..65332e54e 100644
--- a/src/share/classes/javax/print/attribute/standard/Finishings.java
+++ b/src/share/classes/javax/print/attribute/standard/Finishings.java
@@ -42,16 +42,16 @@ import javax.print.attribute.PrintJobAttribute;
  * Standard Finishings values are:
  *
    • KeyValue TypePrincipal Constants"Default" (use platform default)
    {@link #WEIGHT}NumberWEIGHT_REGULAR, WEIGHT_BOLDWIDTH_CONDENSED, WIDTH_REGULAR,
    WIDTH_EXTENDED    		WIDTH_REGULAR
    {@link #POSTURE}NumberPOSTURE_REGULAR, POSTURE_OBLIQUEnone12.0
    {@link #TRANSFORM}{@link TransformAttribute}See TransformAttribute {@link TransformAttribute#IDENTITY IDENTITY}SUPERSCRIPT_SUPER, SUPERSCRIPT_SUB0 (use the standard glyphs and metrics)
    {@link #FONT}{@link java.awt.Font}nonenonenull (draw text using font glyphs)
    {@link #FOREGROUND}{@link java.awt.Paint}nonenonenull (do not render background)
    {@link #UNDERLINE}IntegerUNDERLINE_ONSTRIKETHROUGH_ONfalse (do not render strikethrough)
    {@link #RUN_DIRECTION}BooleanRUN_DIRECTION_LTR
    RUN_DIRECTION_RTL    		none0 (use base line direction)
    {@link #JUSTIFICATION}NumberJUSTIFICATION_FULL(see class)null (do not apply input highlighting)
    {@link #INPUT_METHOD_UNDERLINE}IntegerUNDERLINE_LOW_ONE_PIXEL,
    UNDERLINE_LOW_TWO_PIXEL    		SWAP_COLORS_ONfalse (do not swap colors)
    {@link #NUMERIC_SHAPING}{@link java.awt.font.NumericShaper}noneKERNING_ON0 (do not request kerning)
    {@link #LIGATURES}IntegerLIGATURES_ON
    * - * - * - * - * * @@ -78,70 +78,70 @@ import javax.print.attribute.PrintJobAttribute; * corner or an edge as if the document were a portrait document: *
    + * *   * + * * {@link #NONE NONE} * + * * {@link #STAPLE STAPLE} * + * * {@link #EDGE_STITCH EDGE_STITCH} *
    * - * - * - * - * - * * * - * - * - * - * - * * * - * - * - * - * - * * * - * - * - * - * - * * diff --git a/src/share/classes/javax/print/attribute/standard/JobStateReasons.java b/src/share/classes/javax/print/attribute/standard/JobStateReasons.java index 9cb104b5c..d9e225f62 100644 --- a/src/share/classes/javax/print/attribute/standard/JobStateReasons.java +++ b/src/share/classes/javax/print/attribute/standard/JobStateReasons.java @@ -110,7 +110,7 @@ public final class JobStateReasons * The underlying hash set's initial capacity and load factor are as * specified in the superclass constructor {@link * java.util.HashSet#HashSet(java.util.Collection) - * HashSet(Collection)}. + * HashSet(Collection)}. * * @param collection Collection to copy. * diff --git a/src/share/classes/javax/print/attribute/standard/MediaPrintableArea.java b/src/share/classes/javax/print/attribute/standard/MediaPrintableArea.java index a800f7c6c..9f33f054e 100644 --- a/src/share/classes/javax/print/attribute/standard/MediaPrintableArea.java +++ b/src/share/classes/javax/print/attribute/standard/MediaPrintableArea.java @@ -56,7 +56,7 @@ import javax.print.attribute.PrintRequestAttribute; * any specified finishings. * PrintService provides the method to query the supported * values of an attribute in a suitable context : - * See {@link javax.print.PrintService#getSupportedAttributeValues(Class,DocFlavor, AttributeSet) PrintService.getSupportedAttributeValues()} + * See {@link javax.print.PrintService#getSupportedAttributeValues(Class,DocFlavor, AttributeSet) PrintService.getSupportedAttributeValues()} *

    * The rectangular printable area is defined thus: * The (x,y) origin is positioned at the top-left of the paper in portrait @@ -153,8 +153,8 @@ public final class MediaPrintableArea * Get the printable area as an array of 4 values in the order * x, y, w, h. The values returned are in the given units. * @param units - * Unit conversion factor, e.g. {@link #INCH INCH} or - * {@link #MM MM}. + * Unit conversion factor, e.g. {@link #INCH INCH} or + * {@link #MM MM}. * * @return printable area as array of x, y, w, h in the specified units. * @@ -170,8 +170,8 @@ public final class MediaPrintableArea * Get the x location of the origin of the printable area in the * specified units. * @param units - * Unit conversion factor, e.g. {@link #INCH INCH} or - * {@link #MM MM}. + * Unit conversion factor, e.g. {@link #INCH INCH} or + * {@link #MM MM}. * * @return x location of the origin of the printable area in the * specified units. @@ -187,8 +187,8 @@ public final class MediaPrintableArea * Get the y location of the origin of the printable area in the * specified units. * @param units - * Unit conversion factor, e.g. {@link #INCH INCH} or - * {@link #MM MM}. + * Unit conversion factor, e.g. {@link #INCH INCH} or + * {@link #MM MM}. * * @return y location of the origin of the printable area in the * specified units. @@ -203,8 +203,8 @@ public final class MediaPrintableArea /** * Get the width of the printable area in the specified units. * @param units - * Unit conversion factor, e.g. {@link #INCH INCH} or - * {@link #MM MM}. + * Unit conversion factor, e.g. {@link #INCH INCH} or + * {@link #MM MM}. * * @return width of the printable area in the specified units. * @@ -218,8 +218,8 @@ public final class MediaPrintableArea /** * Get the height of the printable area in the specified units. * @param units - * Unit conversion factor, e.g. {@link #INCH INCH} or - * {@link #MM MM}. + * Unit conversion factor, e.g. {@link #INCH INCH} or + * {@link #MM MM}. * * @return height of the printable area in the specified units. * @@ -292,8 +292,8 @@ public final class MediaPrintableArea * given units. * * @param units - * Unit conversion factor, e.g. {@link #INCH INCH} or - * {@link #MM MM}. + * Unit conversion factor, e.g. {@link #INCH INCH} or + * {@link #MM MM}. * @param unitsName * Units name string, e.g. "in" or "mm". If * null, no units name is appended to the result. diff --git a/src/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java b/src/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java index 6c43fd6f5..30f4fe0a5 100644 --- a/src/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java +++ b/src/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java @@ -71,7 +71,7 @@ import javax.print.attribute.PrintJobAttribute; *

      *
    • * {@link #SINGLE_DOCUMENT - * SINGLE_DOCUMENT}. If a print job has multiple + * SINGLE_DOCUMENT}. If a print job has multiple * documents -- say, the document data is called a and * b -- then the result of processing all the document data * (a and then b) must be treated as a single sequence @@ -86,7 +86,7 @@ import javax.print.attribute.PrintJobAttribute; *

      *

    • * {@link #SEPARATE_DOCUMENTS_UNCOLLATED_COPIES - * SEPARATE_DOCUMENTS_UNCOLLATED_COPIES}. If a print job + * SEPARATE_DOCUMENTS_UNCOLLATED_COPIES}. If a print job * has multiple documents -- say, the document data is called a and * b -- then the result of processing the data in each document * instance must be treated as a single sequence of media sheets for finishing @@ -99,7 +99,7 @@ import javax.print.attribute.PrintJobAttribute; *

      *

    • * {@link #SEPARATE_DOCUMENTS_COLLATED_COPIES - * SEPARATE_DOCUMENTS_COLLATED_COPIES}. If a print job + * SEPARATE_DOCUMENTS_COLLATED_COPIES}. If a print job * has multiple documents -- say, the document data is called a and * b -- then the result of processing the data in each document * instance must be treated as a single sequence of media sheets for finishing @@ -112,7 +112,7 @@ import javax.print.attribute.PrintJobAttribute; *

      *

    • * {@link #SINGLE_DOCUMENT_NEW_SHEET - * SINGLE_DOCUMENT_NEW_SHEET}. Same as SINGLE_DOCUMENT, + * SINGLE_DOCUMENT_NEW_SHEET}. Same as SINGLE_DOCUMENT, * except that the printer must ensure that the first impression of each * document instance in the job is placed on a new media sheet. This value * allows multiple documents to be stapled together with a single staple where @@ -127,7 +127,7 @@ import javax.print.attribute.PrintJobAttribute; * next document or document copy on to a new sheet. *

      * In addition, if a {@link Finishings Finishings} attribute of - * {@link Finishings#STAPLE STAPLE} is specified, then: + * {@link Finishings#STAPLE STAPLE} is specified, then: *

        *
      • * With SINGLE_DOCUMENT, documents a and b are diff --git a/src/share/classes/javax/print/attribute/standard/PrinterStateReasons.java b/src/share/classes/javax/print/attribute/standard/PrinterStateReasons.java index 48707636f..52758fadd 100644 --- a/src/share/classes/javax/print/attribute/standard/PrinterStateReasons.java +++ b/src/share/classes/javax/print/attribute/standard/PrinterStateReasons.java @@ -129,7 +129,7 @@ public final class PrinterStateReasons * Severity} mappings as the given map. The underlying hash map's initial * capacity and load factor are as specified in the superclass constructor * {@link java.util.HashMap#HashMap(java.util.Map) - * HashMap(Map)}. + * HashMap(Map)}. * * @param map Map to copy. * diff --git a/src/share/classes/javax/print/attribute/standard/Sides.java b/src/share/classes/javax/print/attribute/standard/Sides.java index eaff96b2e..93fed683e 100644 --- a/src/share/classes/javax/print/attribute/standard/Sides.java +++ b/src/share/classes/javax/print/attribute/standard/Sides.java @@ -134,7 +134,7 @@ public final class Sides extends EnumSyntax * sides of consecutive media sheets, such that the orientation of each * pair of print-stream pages on the medium would be correct for the * reader as if for binding on the long edge. This imposition is also - * known as "duplex" (see {@link #DUPLEX DUPLEX}). + * known as "duplex" (see {@link #DUPLEX DUPLEX}). */ public static final Sides TWO_SIDED_LONG_EDGE = new Sides(1); @@ -143,19 +143,19 @@ public final class Sides extends EnumSyntax * sides of consecutive media sheets, such that the orientation of each * pair of print-stream pages on the medium would be correct for the * reader as if for binding on the short edge. This imposition is also - * known as "tumble" (see {@link #TUMBLE TUMBLE}). + * known as "tumble" (see {@link #TUMBLE TUMBLE}). */ public static final Sides TWO_SIDED_SHORT_EDGE = new Sides(2); /** * An alias for "two sided long edge" (see {@link #TWO_SIDED_LONG_EDGE - * TWO_SIDED_LONG_EDGE}). + * TWO_SIDED_LONG_EDGE}). */ public static final Sides DUPLEX = TWO_SIDED_LONG_EDGE; /** * An alias for "two sided short edge" (see {@link #TWO_SIDED_SHORT_EDGE - * TWO_SIDED_SHORT_EDGE}). + * TWO_SIDED_SHORT_EDGE}). */ public static final Sides TUMBLE = TWO_SIDED_SHORT_EDGE; diff --git a/src/share/classes/javax/swing/JLayeredPane.java b/src/share/classes/javax/swing/JLayeredPane.java index 3b61f28f1..bf5bc695c 100644 --- a/src/share/classes/javax/swing/JLayeredPane.java +++ b/src/share/classes/javax/swing/JLayeredPane.java @@ -44,12 +44,12 @@ import javax.accessibility.*; * How to Use a Layered Pane, * a section in The Java Tutorial. *

        - *

    + * *   * + * * {@link #STAPLE_TOP_LEFT STAPLE_TOP_LEFT} * + * * {@link #EDGE_STITCH_LEFT EDGE_STITCH_LEFT} * + * * {@link #STAPLE_DUAL_LEFT STAPLE_DUAL_LEFT} * + * *   *
    + * *   * + * * {@link #STAPLE_BOTTOM_LEFT STAPLE_BOTTOM_LEFT} * + * * {@link #EDGE_STITCH_TOP EDGE_STITCH_TOP} * + * * {@link #STAPLE_DUAL_TOP STAPLE_DUAL_TOP} * + * *   *
    + * *   * + * * {@link #STAPLE_TOP_RIGHT STAPLE_TOP_RIGHT} * + * * {@link #EDGE_STITCH_RIGHT EDGE_STITCH_RIGHT} * + * * {@link #STAPLE_DUAL_RIGHT STAPLE_DUAL_RIGHT} * + * *   *
    + * *   * + * * {@link #STAPLE_BOTTOM_RIGHT STAPLE_BOTTOM_RIGHT} * + * * {@link #EDGE_STITCH_BOTTOM EDGE_STITCH_BOTTOM} * + * * {@link #STAPLE_DUAL_BOTTOM STAPLE_DUAL_BOTTOM} * + * *   *
    + *
    * * * *
    - *

    The following text describes this image. + * WIDTH="269" HEIGHT="264" STYLE="FLOAT:BOTTOM; BORDER=0"> *

    diff --git a/src/share/classes/javax/swing/JOptionPane.java b/src/share/classes/javax/swing/JOptionPane.java index c532cf619..23ed02f6b 100644 --- a/src/share/classes/javax/swing/JOptionPane.java +++ b/src/share/classes/javax/swing/JOptionPane.java @@ -108,16 +108,16 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP * the caller until the user's interaction is complete. *

    * - * + *
    * - * - * + * + * * * - * + * * * - * + * * *
    iconmessageiconmessage
    input valueinput value
    option buttonsoption buttons
    * @@ -127,7 +127,7 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP * ultimately responsible for the final result. In particular, the * look-and-feels will adjust the layout to accommodate the option pane's * ComponentOrientation property. - *
    + *
    *

    * Parameters:
    * The parameters to these methods follow consistent patterns: diff --git a/src/share/classes/javax/swing/JScrollPane.java b/src/share/classes/javax/swing/JScrollPane.java index 25918e5a3..7d30b7dff 100644 --- a/src/share/classes/javax/swing/JScrollPane.java +++ b/src/share/classes/javax/swing/JScrollPane.java @@ -54,12 +54,12 @@ import java.beans.Transient; * a section in The Java Tutorial. Note that * JScrollPane does not support heavyweight components. *

    - * + *
    * * * *
    - *

    The following text describes this image. + * WIDTH="256" HEIGHT="248" STYLE="FLOAT:BOTTOM; BORDER:0px"> *

    diff --git a/src/share/classes/javax/swing/JTabbedPane.java b/src/share/classes/javax/swing/JTabbedPane.java index 6c7165778..f36615a74 100644 --- a/src/share/classes/javax/swing/JTabbedPane.java +++ b/src/share/classes/javax/swing/JTabbedPane.java @@ -207,7 +207,7 @@ public class JTabbedPane extends JComponent } /** - * Returns the UI object which implements the L&F for this component. + * Returns the UI object which implements the L&F for this component. * * @return a TabbedPaneUI object * @see #setUI @@ -217,7 +217,7 @@ public class JTabbedPane extends JComponent } /** - * Sets the UI object which implements the L&F for this component. + * Sets the UI object which implements the L&F for this component. * * @param ui the new UI object * @see UIDefaults#getUI @@ -250,7 +250,7 @@ public class JTabbedPane extends JComponent /** * Returns the name of the UI class that implements the - * L&F for this component. + * L&F for this component. * * @return the string "TabbedPaneUI" * @see JComponent#getUIClassID @@ -576,7 +576,7 @@ public class JTabbedPane extends JComponent * * @param index the index to be selected * @exception IndexOutOfBoundsException if index is out of range - * (index < -1 || index >= tab count) + * {@code (index < -1 || index >= tab count)} * * @see #getSelectedIndex * @see SingleSelectionModel#setSelectedIndex @@ -924,7 +924,7 @@ public class JTabbedPane extends JComponent * if added to other containers. * @param index the index of the tab to be removed * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #addTab * @see #insertTab @@ -1043,7 +1043,7 @@ public class JTabbedPane extends JComponent * @param index the index of the component to remove from the * tabbedpane * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * @see #addTab * @see #removeTabAt */ @@ -1105,7 +1105,7 @@ public class JTabbedPane extends JComponent * @param index the index of the item being queried * @return the title at index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * @see #setTitleAt */ public String getTitleAt(int index) { @@ -1118,7 +1118,7 @@ public class JTabbedPane extends JComponent * @param index the index of the item being queried * @return the icon at index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setIconAt */ @@ -1137,7 +1137,7 @@ public class JTabbedPane extends JComponent * @param index the index of the item being queried * @return the icon at index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setDisabledIconAt */ @@ -1155,7 +1155,7 @@ public class JTabbedPane extends JComponent * @param index the index of the item being queried * @return a string containing the tool tip text at index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setToolTipTextAt * @since 1.3 @@ -1171,7 +1171,7 @@ public class JTabbedPane extends JComponent * @return the Color of the tab background at * index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setBackgroundAt */ @@ -1186,7 +1186,7 @@ public class JTabbedPane extends JComponent * @return the Color of the tab foreground at * index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setForegroundAt */ @@ -1202,7 +1202,7 @@ public class JTabbedPane extends JComponent * @return true if the tab at index is enabled; * false otherwise * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setEnabledAt */ @@ -1216,7 +1216,7 @@ public class JTabbedPane extends JComponent * @param index the index of the item being queried * @return the Component at index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setComponentAt */ @@ -1281,7 +1281,7 @@ public class JTabbedPane extends JComponent * index is not currently visible in the UI, * or if there is no UI set on this tabbedpane * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} */ public Rectangle getBoundsAt(int index) { checkIndex(index); @@ -1303,7 +1303,7 @@ public class JTabbedPane extends JComponent * @param index the tab index where the title should be set * @param title the title to be displayed in the tab * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #getTitleAt * @see #setTabComponentAt @@ -1345,7 +1345,7 @@ public class JTabbedPane extends JComponent * @param index the tab index where the icon should be set * @param icon the icon to be displayed in the tab * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setDisabledIconAt * @see #getIconAt @@ -1389,7 +1389,7 @@ public class JTabbedPane extends JComponent * @param index the tab index where the disabled icon should be set * @param disabledIcon the icon to be displayed in the tab when disabled * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #getDisabledIconAt * @beaninfo @@ -1414,7 +1414,7 @@ public class JTabbedPane extends JComponent * @param index the tab index where the tooltip text should be set * @param toolTipText the tooltip text to be displayed for the tab * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #getToolTipTextAt * @beaninfo @@ -1443,14 +1443,14 @@ public class JTabbedPane extends JComponent * which can be null, in which case the tab's background color * will default to the background color of the tabbedpane. * An internal exception is raised if there is no tab at that index. - *

    + *

    * It is up to the look and feel to honor this property, some may * choose to ignore it. * * @param index the tab index where the background should be set * @param background the color to be displayed in the tab's background * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #getBackgroundAt * @beaninfo @@ -1476,14 +1476,14 @@ public class JTabbedPane extends JComponent * null, in which case the tab's foreground color * will default to the foreground color of this tabbedpane. * An internal exception is raised if there is no tab at that index. - *

    + *

    * It is up to the look and feel to honor this property, some may * choose to ignore it. * * @param index the tab index where the foreground should be set * @param foreground the color to be displayed as the tab's foreground * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #getForegroundAt * @beaninfo @@ -1510,7 +1510,7 @@ public class JTabbedPane extends JComponent * @param index the tab index which should be enabled/disabled * @param enabled whether or not the tab should be enabled * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #isEnabledAt */ @@ -1530,7 +1530,7 @@ public class JTabbedPane extends JComponent * @param index the tab index where this component is being placed * @param component the component for the tab * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #getComponentAt * @beaninfo @@ -1605,8 +1605,8 @@ public class JTabbedPane extends JComponent * @param tabIndex the index of the tab that the mnemonic refers to * @param mnemonicIndex index into the String to underline * @exception IndexOutOfBoundsException if tabIndex is - * out of range (tabIndex < 0 || tabIndex >= tab - * count) + * out of range ({@code tabIndex < 0 || tabIndex >= tab + * count}) * @exception IllegalArgumentException will be thrown if * mnemonicIndex is >= length of the tab * title , or < -1 @@ -1649,7 +1649,7 @@ public class JTabbedPane extends JComponent * @param tabIndex the index of the tab that the mnemonic refers to * @param mnemonic the key code which represents the mnemonic * @exception IndexOutOfBoundsException if tabIndex is out - * of range (tabIndex < 0 || tabIndex >= tab count) + * of range ({@code tabIndex < 0 || tabIndex >= tab count}) * @see #getMnemonicAt(int) * @see #setDisplayedMnemonicIndexAt(int,int) * @@ -2354,7 +2354,7 @@ public class JTabbedPane extends JComponent * @param component the component to render the title for the * specified tab * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * @exception IllegalArgumentException if component has already been * added to this JTabbedPane * @@ -2386,7 +2386,7 @@ public class JTabbedPane extends JComponent * @param index the index of the item being queried * @return the tab component at index * @exception IndexOutOfBoundsException if index is out of range - * (index < 0 || index >= tab count) + * {@code (index < 0 || index >= tab count)} * * @see #setTabComponentAt * @since 1.6 diff --git a/src/share/classes/javax/swing/LookAndFeel.java b/src/share/classes/javax/swing/LookAndFeel.java index 5b792c872..785512dd5 100644 --- a/src/share/classes/javax/swing/LookAndFeel.java +++ b/src/share/classes/javax/swing/LookAndFeel.java @@ -91,7 +91,7 @@ import java.util.StringTokenizer; * to provide a specific set of defaults. These are documented in the * classes that require the specific default. * - *

    ComponentUIs and defaults

    + *

    ComponentUIs and defaults

    * * All {@code ComponentUIs} typically need to set various properties * on the {@code JComponent} the {@code ComponentUI} is providing the @@ -590,7 +590,7 @@ public abstract class LookAndFeel * Distinct look and feels should have different names, e.g. * a subclass of MotifLookAndFeel that changes the way a few components * are rendered should be called "CDE/Motif My Way"; something - * that would be useful to a user trying to select a L&F from a list + * that would be useful to a user trying to select a L&F from a list * of names. * * @return short identifier for the look and feel diff --git a/src/share/classes/javax/swing/plaf/metal/MetalLookAndFeel.java b/src/share/classes/javax/swing/plaf/metal/MetalLookAndFeel.java index 0ca32d24a..b6208df57 100644 --- a/src/share/classes/javax/swing/plaf/metal/MetalLookAndFeel.java +++ b/src/share/classes/javax/swing/plaf/metal/MetalLookAndFeel.java @@ -293,8 +293,8 @@ public class MetalLookAndFeel extends BasicLookAndFeel * * - * *
    Key - * Value + * Key + * Value *
    "desktop" * {@code theme.getDesktopColor()} diff --git a/src/share/classes/javax/swing/plaf/metal/MetalTreeUI.java b/src/share/classes/javax/swing/plaf/metal/MetalTreeUI.java index 131a5bdb7..29e7f45db 100644 --- a/src/share/classes/javax/swing/plaf/metal/MetalTreeUI.java +++ b/src/share/classes/javax/swing/plaf/metal/MetalTreeUI.java @@ -46,7 +46,7 @@ import javax.swing.plaf.basic.*; * * * - * + * * * * - * + * * * * - * + * * * *

    Angled

    Angled

    		A line is drawn connecting the child to the parent. For handling * of the root node refer to * {@link javax.swing.JTree#setRootVisible} and @@ -54,11 +54,11 @@ import javax.swing.plaf.basic.*; *

    Horizontal

    Horizontal

    		A horizontal line is drawn dividing the children of the root node.

    None

    None

    		Do not draw any visual indication between nodes.
    diff --git a/src/share/classes/javax/swing/text/Document.java b/src/share/classes/javax/swing/text/Document.java index 0e89c3d02..5ce9b4c93 100644 --- a/src/share/classes/javax/swing/text/Document.java +++ b/src/share/classes/javax/swing/text/Document.java @@ -46,7 +46,7 @@ import javax.swing.event.*; * used are the location between two characters. As the diagram * below shows, a location in a text document can be referred to * as a position, or an offset. This position is zero-based. - *

    The following text describes this graphic. *

    * In the example, if the content of a document is the @@ -69,7 +69,7 @@ import javax.swing.event.*; * Exactly what structure is modeled is up to a particular Document * implementation. It might be as simple as no structure (i.e. a * simple text field), or it might be something like diagram below. - *

    Diagram shows Book->Chapter->Paragraph *

    * The unit of structure (i.e. a node of the tree) is referred to @@ -122,7 +122,7 @@ import javax.swing.event.*; * generated since that edit is actually the source of the change * rather than a mutation to the Document made through its * api. - *

    The preceeding text describes this graphic. *

    * Referring to the above diagram, suppose that the component shown @@ -267,7 +267,7 @@ public interface Document { * For a removal, the end of the removal range is collapsed * down to the start of the range, and any marks in the removal * range are collapsed down to the start of the range. - *

    Diagram shows removal of 'quick' from 'The quick brown fox.' *

    * If the Document structure changed as result of the removal, @@ -300,7 +300,7 @@ public interface Document { * insertUpdate method on the DocumentListener. * The offset and length of the generated DocumentEvent * will indicate what change was actually made to the Document. - *

    Diagram shows insertion of 'quick' in 'The quick brown fox' *

    * If the Document structure changed as result of the insertion, diff --git a/src/share/classes/javax/swing/text/MaskFormatter.java b/src/share/classes/javax/swing/text/MaskFormatter.java index a477e610b..f54a1768a 100644 --- a/src/share/classes/javax/swing/text/MaskFormatter.java +++ b/src/share/classes/javax/swing/text/MaskFormatter.java @@ -40,7 +40,7 @@ import javax.swing.*; * * * - * + * * * * diff --git a/src/share/classes/javax/swing/text/View.java b/src/share/classes/javax/swing/text/View.java index 8223cc8ed..1bd352070 100644 --- a/src/share/classes/javax/swing/text/View.java +++ b/src/share/classes/javax/swing/text/View.java @@ -68,7 +68,7 @@ A view has the following responsibilities: implementation, the minimum span will be <= the preferred span which in turn will be <= the maximum span.

    -

    The above text describes this graphic.

    The minimum set of methods for layout are:

      @@ -95,7 +95,7 @@ A view has the following responsibilities: This allows parent View implementations to cache the child requirements if desired. The calling sequence looks something like the following:

      -

      +

      Sample calling sequence between parent view and child view: setSize, getMinimum, getPreferred, getMaximum, getAlignment, setSize diff --git a/src/share/classes/javax/swing/text/html/HTMLDocument.java b/src/share/classes/javax/swing/text/html/HTMLDocument.java index 71f260932..7f11b2999 100644 --- a/src/share/classes/javax/swing/text/html/HTMLDocument.java +++ b/src/share/classes/javax/swing/text/html/HTMLDocument.java @@ -195,14 +195,14 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR; *

    * * - * * - * * - * * - * * - * * - * * - *
    Character 

    Description

    Description

    #setOuterHTML
    + * *
    *

    Paragraph 1

    *

    Paragraph 2

    *
    *     		+ * *
    *
      *
    • List Item
      • @@ -212,7 +212,7 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR; *
    *     		+ * *
    *

    Paragraph 1

    *

    Paragraph 2

    @@ -222,7 +222,7 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR; *
    *     		+ * *
      *
    • List Item
      • *
    @@ -232,7 +232,7 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR; * *     		+ * *
    *

    Paragraph 1

    *

    Paragraph 2

    @@ -242,7 +242,7 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR; * *
    		+ * *
    *
      *
    • List Item
      • @@ -250,7 +250,7 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR; *
    *     		+ * *
      *
    • List Item
      • *
    -- GitLab