diff options
author | rriggs <none@none> | 2013-12-03 16:20:44 -0500 |
---|---|---|
committer | rriggs <none@none> | 2013-12-03 16:20:44 -0500 |
commit | 16696ae9e248320544a47b685daa1ea24b36e946 (patch) | |
tree | 1b370ab5cef7446f3b68fc308a4588b575b0e29c /src | |
parent | ff9d835634d9d90fb12a4454856589a2fd62b21d (diff) | |
download | jdk8u_jdk-16696ae9e248320544a47b685daa1ea24b36e946.tar.gz |
8028019: AWT Doclint warning/error cleanup
Summary: Fix numerious javadoc and html errors and warnings
Reviewed-by: yan
Diffstat (limited to 'src')
55 files changed, 110 insertions, 131 deletions
diff --git a/src/share/classes/java/applet/Applet.java b/src/share/classes/java/applet/Applet.java index 2e8e39a19f..63d3f0a9f3 100644 --- a/src/share/classes/java/applet/Applet.java +++ b/src/share/classes/java/applet/Applet.java @@ -392,7 +392,7 @@ public class Applet extends Panel { * Each element of the array should be a set of three * <code>Strings</code> containing the name, the type, and a * description. For example: - * <p><blockquote><pre> + * <blockquote><pre> * String pinfo[][] = { * {"fps", "1-10", "frames per second"}, * {"repeat", "boolean", "repeat image loop"}, diff --git a/src/share/classes/java/applet/AppletContext.java b/src/share/classes/java/applet/AppletContext.java index f28308cfb1..c031686acc 100644 --- a/src/share/classes/java/applet/AppletContext.java +++ b/src/share/classes/java/applet/AppletContext.java @@ -107,7 +107,7 @@ public interface AppletContext { * <code>target</code> argument indicates in which HTML frame the * document is to be displayed. * The target argument is interpreted as follows: - * <p> + * * <center><table border="3" summary="Target arguments and their descriptions"> * <tr><th>Target Argument</th><th>Description</th></tr> * <tr><td><code>"_self"</code> <td>Show in the window and frame that diff --git a/src/share/classes/java/awt/AWTPermission.java b/src/share/classes/java/awt/AWTPermission.java index 2b371bce71..0859872cb7 100644 --- a/src/share/classes/java/awt/AWTPermission.java +++ b/src/share/classes/java/awt/AWTPermission.java @@ -43,7 +43,6 @@ import java.security.BasicPermission; * target names, and for each provides a description of what the * permission allows and a discussion of the risks of granting code * the permission. - * <P> * * <table border=1 cellpadding=5 summary="AWTPermission target names, descriptions, and associated risks."> * <tr> diff --git a/src/share/classes/java/awt/AlphaComposite.java b/src/share/classes/java/awt/AlphaComposite.java index 9f8b64f268..f08ea2b47b 100644 --- a/src/share/classes/java/awt/AlphaComposite.java +++ b/src/share/classes/java/awt/AlphaComposite.java @@ -175,7 +175,6 @@ import sun.java2d.SunCompositeContext; * <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>. * - * <p> * <h3>Preparing Results</h3> * * <p> @@ -193,7 +192,6 @@ import sun.java2d.SunCompositeContext; * by zero" and the color components are left as * all zeros. * - * <p> * <h3>Performance Considerations</h3> * * <p> @@ -216,7 +214,6 @@ import sun.java2d.SunCompositeContext; * for their pixels. Such sources supply an alpha of 1.0 for * all of their pixels. * - * <p> * <li> * Many destinations also have no place to store the alpha values * that result from the blending calculations performed by this class. @@ -227,7 +224,6 @@ import sun.java2d.SunCompositeContext; * values by the resulting alpha value before storing the color * values and discarding the alpha value. * - * <p> * <li> * The accuracy of the results depends on the manner in which pixels * are stored in the destination. @@ -248,7 +244,6 @@ import sun.java2d.SunCompositeContext; * the need to choose a pixel from a limited palette to match the * results of the blending equations. * - * <p> * <li> * Nearly all formats store pixels as discrete integers rather than * the floating point values used in the reference equations above. @@ -268,7 +263,6 @@ import sun.java2d.SunCompositeContext; * represents 0.0 and 0xff represents * 1.0. * - * <p> * <li> * The internal implementation can approximate some of the equations * and it can also eliminate some steps to avoid unnecessary operations. @@ -332,7 +326,6 @@ import sun.java2d.SunCompositeContext; * <p> * and thus they would all match. * - * <p> * <li> * Because of the technique of simplifying the equations for * calculation efficiency, some implementations might perform diff --git a/src/share/classes/java/awt/BasicStroke.java b/src/share/classes/java/awt/BasicStroke.java index 5cc466640c..80b4a3d3eb 100644 --- a/src/share/classes/java/awt/BasicStroke.java +++ b/src/share/classes/java/awt/BasicStroke.java @@ -39,7 +39,7 @@ import java.lang.annotation.Native; * {@link Shape} and the decorations applied at the ends and joins of * path segments of the <code>Shape</code>. * These rendering attributes include: - * <dl compact> + * <dl> * <dt><i>width</i> * <dd>The pen width, measured perpendicularly to the pen trajectory. * <dt><i>end caps</i> diff --git a/src/share/classes/java/awt/BorderLayout.java b/src/share/classes/java/awt/BorderLayout.java index 8b131c485d..52f56ed8bf 100644 --- a/src/share/classes/java/awt/BorderLayout.java +++ b/src/share/classes/java/awt/BorderLayout.java @@ -99,7 +99,7 @@ import java.util.Hashtable; * style="float:center; margin: 7px 10px;"> * <p> * The code for this applet is as follows: - * <p> + * * <hr><blockquote><pre> * import java.awt.*; * import java.applet.Applet; diff --git a/src/share/classes/java/awt/Button.java b/src/share/classes/java/awt/Button.java index 83506b6fdb..da7a01f853 100644 --- a/src/share/classes/java/awt/Button.java +++ b/src/share/classes/java/awt/Button.java @@ -388,7 +388,7 @@ public class Button extends Component implements Accessible { * This method is not called unless action events are * enabled for this button. Action events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ActionListener</code> object is registered * via <code>addActionListener</code>. * <li>Action events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/Checkbox.java b/src/share/classes/java/awt/Checkbox.java index 7568b0c5ae..0215382df3 100644 --- a/src/share/classes/java/awt/Checkbox.java +++ b/src/share/classes/java/awt/Checkbox.java @@ -41,7 +41,7 @@ import javax.accessibility.*; * <p> * The following code example creates a set of check boxes in * a grid layout: - * <p> + * * <hr><blockquote><pre> * setLayout(new GridLayout(3, 1)); * add(new Checkbox("one", null, true)); @@ -558,7 +558,7 @@ public class Checkbox extends Component implements ItemSelectable, Accessible { * This method is not called unless item events are * enabled for this component. Item events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ItemListener</code> object is registered * via <code>addItemListener</code>. * <li>Item events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/CheckboxGroup.java b/src/share/classes/java/awt/CheckboxGroup.java index 25b0697f11..90994f4a72 100644 --- a/src/share/classes/java/awt/CheckboxGroup.java +++ b/src/share/classes/java/awt/CheckboxGroup.java @@ -35,7 +35,7 @@ package java.awt; * <p> * The following code example produces a new check box group, * with three check boxes: - * <p> + * * <hr><blockquote><pre> * setLayout(new GridLayout(3, 1)); * CheckboxGroup cbg = new CheckboxGroup(); diff --git a/src/share/classes/java/awt/CheckboxMenuItem.java b/src/share/classes/java/awt/CheckboxMenuItem.java index 20265c7ad1..424a53102e 100644 --- a/src/share/classes/java/awt/CheckboxMenuItem.java +++ b/src/share/classes/java/awt/CheckboxMenuItem.java @@ -367,7 +367,7 @@ public class CheckboxMenuItem extends MenuItem implements ItemSelectable, Access * This method is not called unless item events are * enabled for this menu item. Item events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ItemListener</code> object is registered * via <code>addItemListener</code>. * <li>Item events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/Choice.java b/src/share/classes/java/awt/Choice.java index b50746205d..1a75f903c3 100644 --- a/src/share/classes/java/awt/Choice.java +++ b/src/share/classes/java/awt/Choice.java @@ -40,7 +40,7 @@ import javax.accessibility.*; * The current choice is displayed as the title of the menu. * <p> * The following code example produces a pop-up menu: - * <p> + * * <hr><blockquote><pre> * Choice ColorChooser = new Choice(); * ColorChooser.add("Green"); @@ -609,7 +609,7 @@ public class Choice extends Component implements ItemSelectable, Accessible { * This method is not called unless item events are * enabled for this component. Item events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ItemListener</code> object is registered * via <code>addItemListener</code>. * <li>Item events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/Component.java b/src/share/classes/java/awt/Component.java index bd913cbd50..87c8879d0b 100644 --- a/src/share/classes/java/awt/Component.java +++ b/src/share/classes/java/awt/Component.java @@ -106,7 +106,7 @@ import sun.util.logging.PlatformLogger; * adding/removing components to/from containers, the whole hierarchy must be * validated afterwards by means of the {@link Container#validate()} method * invoked on the top-most invalid container of the hierarchy. - * <p> + * * <h3>Serialization</h3> * It is important to note that only AWT listeners which conform * to the <code>Serializable</code> protocol will be saved when @@ -3859,7 +3859,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This is a proxy capabilities class used when a FlipBufferStrategy * is created instead of the requested Blit strategy. * - * @see sun.awt.SunGraphicsEnvironment#isFlipStrategyPreferred(ComponentPeer) + * @see sun.java2d.SunGraphicsEnvironment#isFlipStrategyPreferred(ComponentPeer) */ private class ProxyCapabilities extends ExtendedBufferCapabilities { private BufferCapabilities orig; @@ -4515,7 +4515,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * Private class to perform sub-region blitting. Swing will use * this subclass via the SubRegionShowable interface in order to * copy only the area changed during a repaint. - * @see javax.swing.BufferStrategyPaintManager + * See javax.swing.BufferStrategyPaintManager. */ private class BltSubRegionBufferStrategy extends BltBufferStrategy implements SubRegionShowable @@ -6328,7 +6328,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless component events are * enabled for this component. Component events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>A <code>ComponentListener</code> object is registered * via <code>addComponentListener</code>. * <li>Component events are enabled via <code>enableEvents</code>. @@ -6373,7 +6373,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless focus events are * enabled for this component. Focus events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>A <code>FocusListener</code> object is registered * via <code>addFocusListener</code>. * <li>Focus events are enabled via <code>enableEvents</code>. @@ -6393,7 +6393,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * with a <code>FocusEvent</code> as the argument will result in a * call to the <code>Component</code>'s <code>processFocusEvent</code> * method regardless of the current <code>KeyboardFocusManager</code>. - * <p> + * * <p>Note that if the event parameter is <code>null</code> * the behavior is unspecified and may result in an * exception. @@ -6430,7 +6430,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless key events are * enabled for this component. Key events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>A <code>KeyListener</code> object is registered * via <code>addKeyListener</code>. * <li>Key events are enabled via <code>enableEvents</code>. @@ -6499,7 +6499,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless mouse events are * enabled for this component. Mouse events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>A <code>MouseListener</code> object is registered * via <code>addMouseListener</code>. * <li>Mouse events are enabled via <code>enableEvents</code>. @@ -6547,7 +6547,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless mouse motion events are * enabled for this component. Mouse motion events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>A <code>MouseMotionListener</code> object is registered * via <code>addMouseMotionListener</code>. * <li>Mouse motion events are enabled via <code>enableEvents</code>. @@ -6586,7 +6586,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless mouse wheel events are * enabled for this component. Mouse wheel events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>A <code>MouseWheelListener</code> object is registered * via <code>addMouseWheelListener</code>. * <li>Mouse wheel events are enabled via <code>enableEvents</code>. @@ -6630,7 +6630,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless input method events * are enabled for this component. Input method events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>InputMethodListener</code> object is registered * via <code>addInputMethodListener</code>. * <li>Input method events are enabled via <code>enableEvents</code>. @@ -6669,7 +6669,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless hierarchy events * are enabled for this component. Hierarchy events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>HierarchyListener</code> object is registered * via <code>addHierarchyListener</code>. * <li>Hierarchy events are enabled via <code>enableEvents</code>. @@ -6705,7 +6705,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * This method is not called unless hierarchy bounds events * are enabled for this component. Hierarchy bounds events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>HierarchyBoundsListener</code> object is registered * via <code>addHierarchyBoundsListener</code>. * <li>Hierarchy bounds events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/Container.java b/src/share/classes/java/awt/Container.java index a779d72d48..b6bef12f91 100644 --- a/src/share/classes/java/awt/Container.java +++ b/src/share/classes/java/awt/Container.java @@ -186,7 +186,7 @@ public class Container extends Component { * the method can return the Container on which it is originally called * in case if none of its children are the current mouse event targets. * - * @see #getMouseEventTarget(int, int, boolean, boolean, boolean) + * @see #getMouseEventTarget(int, int, boolean) */ static final boolean INCLUDE_SELF = true; @@ -195,7 +195,7 @@ public class Container extends Component { * of <code>getMouseEventTarget</code>. It is used to specify whether * the method should search only lightweight components. * - * @see #getMouseEventTarget(int, int, boolean, boolean, boolean) + * @see #getMouseEventTarget(int, int, boolean) */ static final boolean SEARCH_HEAVYWEIGHTS = true; @@ -1037,7 +1037,7 @@ public class Container extends Component { * every add request to a container as all other add methods defer * to this one. An overriding method should * usually include a call to the superclass's version of the method: - * <p> + * * <blockquote> * <code>super.addImpl(comp, constraints, index)</code> * </blockquote> diff --git a/src/share/classes/java/awt/EventFilter.java b/src/share/classes/java/awt/EventFilter.java index 56c69dd050..1c38467f01 100644 --- a/src/share/classes/java/awt/EventFilter.java +++ b/src/share/classes/java/awt/EventFilter.java @@ -28,20 +28,20 @@ interface EventFilter { /** * Enumeration for possible values for <code>acceptEvent(AWTEvent ev)</code> method. - * @see EventDispatchThread#pumpEventsForFilters(EventFilter) + * @see EventDispatchThread#pumpEventsForFilter */ static enum FilterAction { /** * ACCEPT means that this filter do not filter the event and allowes other * active filters to proceed it. If all the active filters accept the event, it * is dispatched by the <code>EventDispatchThread</code> - * @see EventDispatchThread#pumpEventsForFilters(EventFilter) + * @see EventDispatchThread#pumpEventsForFilter */ ACCEPT, /** * REJECT means that this filter filter the event. No other filters are queried, * and the event is not dispatched by the <code>EventDispatchedThread</code> - * @see EventDispatchThread#pumpEventsForFilters(EventFilter) + * @see EventDispatchThread#pumpEventsForFilter */ REJECT, /** @@ -51,7 +51,7 @@ interface EventFilter { * It is not recommended to use ACCEPT_IMMEDIATELY as there may be some active * filters not queried yet that do not accept this event. It is primarily used * by modal filters. - * @see EventDispatchThread#pumpEventsForFilters(EventFilter) + * @see EventDispatchThread#pumpEventsForFilter * @see ModalEventFilter */ ACCEPT_IMMEDIATELY diff --git a/src/share/classes/java/awt/EventQueue.java b/src/share/classes/java/awt/EventQueue.java index af9e1bf08f..efe0421f71 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: - * <p> + * * <table border=1 summary="Event types, source types, and dispatch methods"> * <tr> * <th>Event Type</th> diff --git a/src/share/classes/java/awt/FileDialog.java b/src/share/classes/java/awt/FileDialog.java index 0fc63c7fde..b693b9b878 100644 --- a/src/share/classes/java/awt/FileDialog.java +++ b/src/share/classes/java/awt/FileDialog.java @@ -439,7 +439,6 @@ public class FileDialog extends Dialog { * Note that the method is private and it's intended to be used * by the peers through the AWTAccessor API. * - * @param directory the current directory * @param files the array that contains the short names of * all the files that the user selects. * diff --git a/src/share/classes/java/awt/FlowLayout.java b/src/share/classes/java/awt/FlowLayout.java index 4675bbc573..9961c9bfdb 100644 --- a/src/share/classes/java/awt/FlowLayout.java +++ b/src/share/classes/java/awt/FlowLayout.java @@ -57,7 +57,7 @@ import java.io.IOException; * style="float:center; margin: 7px 10px;"> * <p> * Here is the code for this applet: - * <p> + * * <hr><blockquote><pre> * import java.awt.*; * import java.applet.Applet; @@ -129,9 +129,9 @@ public class FlowLayout implements LayoutManager, java.io.Serializable { * how each row distributes empty space. * It can be one of the following values: * <ul> - * <code>LEFT</code> - * <code>RIGHT</code> - * <code>CENTER</code> + * <li><code>LEFT</code> + * <li><code>RIGHT</code> + * <li><code>CENTER</code> * </ul> * * @serial @@ -146,11 +146,11 @@ public class FlowLayout implements LayoutManager, java.io.Serializable { * v1.2 and greater. * It can be one of the following three values: * <ul> - * <code>LEFT</code> - * <code>RIGHT</code> - * <code>CENTER</code> - * <code>LEADING</code> - * <code>TRAILING</code> + * <li><code>LEFT</code> + * <li><code>RIGHT</code> + * <li><code>CENTER</code> + * <li><code>LEADING</code> + * <li><code>TRAILING</code> * </ul> * * @serial diff --git a/src/share/classes/java/awt/Font.java b/src/share/classes/java/awt/Font.java index c5c400c651..ed910e0834 100644 --- a/src/share/classes/java/awt/Font.java +++ b/src/share/classes/java/awt/Font.java @@ -75,13 +75,13 @@ import static sun.font.EAttribute.*; * * 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'</code>, - * <font size=-1>LATIN SMALL LETTER G</font>, is a character. + * LATIN SMALL LETTER G, is a character. * <p> * A <em>glyph</em> is a shape used to render a character or a sequence of * characters. In simple writing systems, such as Latin, typically one glyph * represents one character. In general, however, characters and glyphs do not * have one-to-one correspondence. For example, the character 'á' - * <font size=-1>LATIN SMALL LETTER A WITH ACUTE</font>, can be represented by + * LATIN SMALL LETTER A WITH ACUTE, can be represented by * two glyphs: one for 'a' and one for '´'. On the other hand, the * two-character string "fi" can be represented by a single glyph, an * "fi" ligature. In complex writing systems, such as Arabic or the South @@ -93,7 +93,7 @@ import static sun.font.EAttribute.*; * of characters as well as the tables needed to map sequences of characters to * corresponding sequences of glyphs. * - * <h4>Physical and Logical Fonts</h4> + * <h3>Physical and Logical Fonts</h3> * * The Java Platform distinguishes between two kinds of fonts: * <em>physical</em> fonts and <em>logical</em> fonts. @@ -130,7 +130,7 @@ import static sun.font.EAttribute.*; * <a href="http://www.oracle.com/technetwork/java/javase/tech/faq-jsp-138165.html">Internationalization FAQ</a> * document. * - * <h4>Font Faces and Names</h4> + * <h3>Font Faces and Names</h3> * * A <code>Font</code> * can have many faces, such as heavy, medium, oblique, gothic and @@ -160,7 +160,7 @@ import static sun.font.EAttribute.*; * with varying sizes, styles, transforms and font features via the * <code>deriveFont</code> methods in this class. * - * <h4>Font and TextAttribute</h4> + * <h3>Font and TextAttribute</h3> * * <p><code>Font</code> supports most * <code>TextAttribute</code>s. This makes some operations, such as @@ -197,7 +197,7 @@ import static sun.font.EAttribute.*; * avoid this problem. Clients who use input method highlights can * convert these to the platform-specific attributes for that * highlight on the current platform and set them on the Font as - * a workaround.</p> + * a workaround. * * <p>The <code>Map</code>-based constructor and * <code>deriveFont</code> APIs ignore the FONT attribute, and it is @@ -1419,7 +1419,7 @@ public class Font implements java.io.Serializable * To ensure that this method returns the desired Font, * format the <code>str</code> parameter in * one of these ways - * <p> + * * <ul> * <li><em>fontname-style-pointsize</em> * <li><em>fontname-pointsize</em> diff --git a/src/share/classes/java/awt/Graphics.java b/src/share/classes/java/awt/Graphics.java index 3e2dcb5500..c440b0a8fa 100644 --- a/src/share/classes/java/awt/Graphics.java +++ b/src/share/classes/java/awt/Graphics.java @@ -39,7 +39,7 @@ import java.text.AttributedCharacterIterator; * A <code>Graphics</code> object encapsulates state information needed * for the basic rendering operations that Java supports. This * state information includes the following properties: - * <p> + * * <ul> * <li>The <code>Component</code> object on which to draw. * <li>A translation origin for rendering and clipping coordinates. @@ -63,7 +63,7 @@ import java.text.AttributedCharacterIterator; * <p> * The graphics pen hangs down and to the right from the path it traverses. * This has the following implications: - * <p><ul> + * <ul> * <li>If you draw a figure that covers a given rectangle, that * figure occupies one extra row of pixels on the right and bottom edges * as compared to filling a figure that is bounded by that same rectangle. @@ -136,7 +136,7 @@ public abstract class Graphics { * interpreted in the coordinate system of the original * <code>Graphics</code> object. The new graphics context is * identical to the original, except in two respects: - * <p> + * * <ul> * <li> * The new graphics context is translated by (<i>x</i>, <i>y</i>). diff --git a/src/share/classes/java/awt/GridBagConstraints.java b/src/share/classes/java/awt/GridBagConstraints.java index 3651b39be9..bf53b39b21 100644 --- a/src/share/classes/java/awt/GridBagConstraints.java +++ b/src/share/classes/java/awt/GridBagConstraints.java @@ -457,7 +457,7 @@ public class GridBagConstraints implements Cloneable, java.io.Serializable { * resize the component, and if so, how. * <p> * The following values are valid for <code>fill</code>: - * <p> + * * <ul> * <li> * <code>NONE</code>: Do not resize the component. diff --git a/src/share/classes/java/awt/GridBagLayout.java b/src/share/classes/java/awt/GridBagLayout.java index 8ac290a7a4..0b0f2bc5de 100644 --- a/src/share/classes/java/awt/GridBagLayout.java +++ b/src/share/classes/java/awt/GridBagLayout.java @@ -55,7 +55,7 @@ import java.util.Arrays; * of the <code>GridBagConstraints</code> objects that are associated * with its components. You customize a <code>GridBagConstraints</code> * object by setting one or more of its instance variables: - * <p> + * * <dl> * <dt>{@link GridBagConstraints#gridx}, * {@link GridBagConstraints#gridy} @@ -121,7 +121,7 @@ import java.util.Arrays; * <code>ComponentOrientation</code> property while absolute values * are not. Baseline relative values are calculated relative to the * baseline. Valid values are: - * <p> + * * <center><table BORDER=0 WIDTH=800 * SUMMARY="absolute, relative and baseline values as described above"> * <tr> @@ -251,7 +251,7 @@ import java.util.Arrays; * managed by a grid bag layout. Figure 2 shows the layout for a horizontal, * left-to-right container and Figure 3 shows the layout for a horizontal, * right-to-left container. - * <p> + * * <center><table WIDTH=600 summary="layout"> * <tr ALIGN=CENTER> * <td> @@ -270,7 +270,7 @@ import java.util.Arrays; * of its associated <code>GridBagConstraints</code> object * set to <code>GridBagConstraints.BOTH</code>. * In addition, the components have the following non-default constraints: - * <p> + * * <ul> * <li>Button1, Button2, Button3: <code>weightx = 1.0</code> * <li>Button4: <code>weightx = 1.0</code>, @@ -285,7 +285,7 @@ import java.util.Arrays; * </ul> * <p> * Here is the code that implements the example shown above: - * <p> + * * <hr><blockquote><pre> * import java.awt.*; * import java.util.*; diff --git a/src/share/classes/java/awt/GridLayout.java b/src/share/classes/java/awt/GridLayout.java index 596208c3e6..ef506b025e 100644 --- a/src/share/classes/java/awt/GridLayout.java +++ b/src/share/classes/java/awt/GridLayout.java @@ -32,7 +32,7 @@ package java.awt; * and one component is placed in each rectangle. * For example, the following is an applet that lays out six buttons * into three rows and two columns: - * <p> + * * <hr><blockquote> * <pre> * import java.awt.*; @@ -54,7 +54,7 @@ package java.awt; * and left-to-right, the above example produces the output shown in Figure 1. * If the container's <code>ComponentOrientation</code> property is horizontal * and right-to-left, the example produces the output shown in Figure 2. - * <p> + * * <table style="float:center" WIDTH=600 summary="layout"> * <tr ALIGN=CENTER> * <td><img SRC="doc-files/GridLayout-1.gif" diff --git a/src/share/classes/java/awt/Label.java b/src/share/classes/java/awt/Label.java index 1772875d5f..090ef849ce 100644 --- a/src/share/classes/java/awt/Label.java +++ b/src/share/classes/java/awt/Label.java @@ -36,7 +36,7 @@ import javax.accessibility.*; * directly. * <p> * For example, the code . . . - * <p> + * * <hr><blockquote><pre> * setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10)); * add(new Label("Hi There!")); diff --git a/src/share/classes/java/awt/LinearGradientPaint.java b/src/share/classes/java/awt/LinearGradientPaint.java index f4af6026da..eed1f34333 100644 --- a/src/share/classes/java/awt/LinearGradientPaint.java +++ b/src/share/classes/java/awt/LinearGradientPaint.java @@ -75,7 +75,6 @@ import java.beans.ConstructorProperties; * <p> * The following code demonstrates typical usage of * {@code LinearGradientPaint}: - * <p> * <pre> * Point2D start = new Point2D.Float(0, 0); * Point2D end = new Point2D.Float(50, 50); @@ -92,7 +91,6 @@ import java.beans.ConstructorProperties; * <p> * This image demonstrates the example code above for each * of the three cycle methods: - * <p> * <center> * <img src = "doc-files/LinearGradientPaint.png" * alt="image showing the output of the example code"> diff --git a/src/share/classes/java/awt/LinearGradientPaintContext.java b/src/share/classes/java/awt/LinearGradientPaintContext.java index c0da02bffa..965e1484ec 100644 --- a/src/share/classes/java/awt/LinearGradientPaintContext.java +++ b/src/share/classes/java/awt/LinearGradientPaintContext.java @@ -66,8 +66,8 @@ final class LinearGradientPaintContext extends MultipleGradientPaintContext { * concatenated with this) * @param hints the hints that the context object uses to choose * between rendering alternatives - * @param dStart gradient start point, in user space - * @param dEnd gradient end point, in user space + * @param start gradient start point, in user space + * @param end gradient end point, in user space * @param fractions the fractions specifying the gradient distribution * @param colors the gradient colors * @param cycleMethod either NO_CYCLE, REFLECT, or REPEAT diff --git a/src/share/classes/java/awt/List.java b/src/share/classes/java/awt/List.java index b3be9aeaf2..754291809e 100644 --- a/src/share/classes/java/awt/List.java +++ b/src/share/classes/java/awt/List.java @@ -41,7 +41,7 @@ import javax.accessibility.*; * the user can choose either one item or multiple items. * <p> * For example, the code . . . - * <p> + * * <hr><blockquote><pre> * List lst = new List(4, false); * lst.add("Mercury"); @@ -1082,7 +1082,7 @@ public class List extends Component implements ItemSelectable, Accessible { * This method is not called unless item events are * enabled for this component. Item events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ItemListener</code> object is registered * via <code>addItemListener</code>. * <li>Item events are enabled via <code>enableEvents</code>. @@ -1113,7 +1113,7 @@ public class List extends Component implements ItemSelectable, Accessible { * This method is not called unless action events are * enabled for this component. Action events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ActionListener</code> object is registered * via <code>addActionListener</code>. * <li>Action events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/MenuItem.java b/src/share/classes/java/awt/MenuItem.java index b660e20d96..134469106a 100644 --- a/src/share/classes/java/awt/MenuItem.java +++ b/src/share/classes/java/awt/MenuItem.java @@ -648,7 +648,7 @@ public class MenuItem extends MenuComponent implements Accessible { * This method is not called unless action events are * enabled for this component. Action events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ActionListener</code> object is registered * via <code>addActionListener</code>. * <li>Action events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/RadialGradientPaint.java b/src/share/classes/java/awt/RadialGradientPaint.java index 5fd08734f1..9f569f4f02 100644 --- a/src/share/classes/java/awt/RadialGradientPaint.java +++ b/src/share/classes/java/awt/RadialGradientPaint.java @@ -104,7 +104,6 @@ import java.beans.ConstructorProperties; * The following code demonstrates typical usage of * {@code RadialGradientPaint}, where the center and focus points are * the same: - * <p> * <pre> * Point2D center = new Point2D.Float(50, 50); * float radius = 25; @@ -117,7 +116,6 @@ import java.beans.ConstructorProperties; * <p> * This image demonstrates the example code above, with default * (centered) focus for each of the three cycle methods: - * <p> * <center> * <img src = "doc-files/RadialGradientPaint-1.png" alt="image showing the * output of the sameple code"> @@ -126,7 +124,6 @@ import java.beans.ConstructorProperties; * <p> * It is also possible to specify a non-centered focus point, as * in the following code: - * <p> * <pre> * Point2D center = new Point2D.Float(50, 50); * float radius = 25; @@ -142,7 +139,6 @@ import java.beans.ConstructorProperties; * <p> * This image demonstrates the previous example code, with non-centered * focus for each of the three cycle methods: - * <p> * <center> * <img src = "doc-files/RadialGradientPaint-2.png" alt="image showing the * output of the sample code"> diff --git a/src/share/classes/java/awt/Scrollbar.java b/src/share/classes/java/awt/Scrollbar.java index 9849480719..0c980b3bf4 100644 --- a/src/share/classes/java/awt/Scrollbar.java +++ b/src/share/classes/java/awt/Scrollbar.java @@ -46,7 +46,7 @@ import javax.accessibility.*; * <p> * Each scroll bar in this example could be created with * code similar to the following: - * <p> + * * <hr><blockquote><pre> * redSlider=new Scrollbar(Scrollbar.VERTICAL, 0, 1, 0, 255); * add(redSlider); @@ -65,7 +65,7 @@ import javax.accessibility.*; * The value range represented by the bubble in this example * is the <em>visible amount</em>. The horizontal scroll bar * in this example could be created with code like the following: - * <p> + * * <hr><blockquote><pre> * ranger = new Scrollbar(Scrollbar.HORIZONTAL, 0, 60, 0, 300); * add(ranger); @@ -103,7 +103,7 @@ import javax.accessibility.*; * <p> * The <code>AdjustmentEvent</code> class defines five types * of adjustment event, listed here: - * <p> + * * <ul> * <li><code>AdjustmentEvent.TRACK</code> is sent out when the * user drags the scroll bar's bubble. @@ -136,7 +136,7 @@ import javax.accessibility.*; * that are associated with scroll bars in previous platform versions. * The following list gives the adjustment event type, * and the corresponding JDK 1.0 event type it replaces. - * <p> + * * <ul> * <li><code>AdjustmentEvent.TRACK</code> replaces * <code>Event.SCROLL_ABSOLUTE</code> @@ -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: - * <p> + * * <table border=1 summary="Scrollbar default properties"> * <tr> * <th>Property</th> @@ -1104,11 +1104,11 @@ public class Scrollbar extends Component implements Adjustable, Accessible { * This method is not called unless adjustment events are * enabled for this component. Adjustment events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>AdjustmentListener</code> object is registered * via <code>addAdjustmentListener</code>. * <li>Adjustment events are enabled via <code>enableEvents</code>. - * </ul><p> + * </ul> * <p>Note that if the event parameter is <code>null</code> * the behavior is unspecified and may result in an * exception. diff --git a/src/share/classes/java/awt/SystemColor.java b/src/share/classes/java/awt/SystemColor.java index 931cf326fb..ed5a26b494 100644 --- a/src/share/classes/java/awt/SystemColor.java +++ b/src/share/classes/java/awt/SystemColor.java @@ -463,7 +463,7 @@ public final class SystemColor extends Color implements java.io.Serializable { } /** - * Called from <init> & toolkit to update the above systemColors cache. + * Called from {@code <init>} and toolkit to update the above systemColors cache. */ private static void updateSystemColors() { if (!GraphicsEnvironment.isHeadless()) { diff --git a/src/share/classes/java/awt/SystemTray.java b/src/share/classes/java/awt/SystemTray.java index 20ba912870..58f3a0b268 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: - * <p> + * * <table border=1 summary="SystemTray properties"> * <tr> * <th>Property</th> diff --git a/src/share/classes/java/awt/TextArea.java b/src/share/classes/java/awt/TextArea.java index 6fc979f283..0528c0addf 100644 --- a/src/share/classes/java/awt/TextArea.java +++ b/src/share/classes/java/awt/TextArea.java @@ -45,7 +45,7 @@ import javax.accessibility.*; * style="float:center; margin: 7px 10px;"> * <p> * This text area could be created by the following line of code: - * <p> + * * <hr><blockquote><pre> * new TextArea("Hello", 5, 40); * </pre></blockquote><hr> diff --git a/src/share/classes/java/awt/TextField.java b/src/share/classes/java/awt/TextField.java index 85eaba2d17..e708821818 100644 --- a/src/share/classes/java/awt/TextField.java +++ b/src/share/classes/java/awt/TextField.java @@ -45,7 +45,7 @@ import javax.accessibility.*; * style="float:center; margin: 7px 10px;"> * <p> * Here is the code that produces these four text fields: - * <p> + * * <hr><blockquote><pre> * TextField tf1, tf2, tf3, tf4; * // a blank text field @@ -596,7 +596,7 @@ public class TextField extends TextComponent { * This method is not called unless action events are * enabled for this component. Action events are enabled * when one of the following occurs: - * <p><ul> + * <ul> * <li>An <code>ActionListener</code> object is registered * via <code>addActionListener</code>. * <li>Action events are enabled via <code>enableEvents</code>. diff --git a/src/share/classes/java/awt/Toolkit.java b/src/share/classes/java/awt/Toolkit.java index dcc1fa15b4..e1f86f22e5 100644 --- a/src/share/classes/java/awt/Toolkit.java +++ b/src/share/classes/java/awt/Toolkit.java @@ -80,19 +80,19 @@ import sun.util.CoreResourceBundleControl; * <br>For example, calling <code>ScrollPane.setScrollPosition</code> * and then <code>getScrollPosition</code> may return an incorrect * value if the original request has not yet been processed. - * <p> + * * <li>Moving the focus from one component to another. * <br>For more information, see * <a href="http://docs.oracle.com/javase/tutorial/uiswing/misc/focus.html#transferTiming">Timing * Focus Transfers</a>, a section in * <a href="http://java.sun.com/docs/books/tutorial/uiswing/">The Swing * Tutorial</a>. - * <p> + * * <li>Making a top-level container visible. * <br>Calling <code>setVisible(true)</code> on a <code>Window</code>, * <code>Frame</code> or <code>Dialog</code> may occur * asynchronously. - * <p> + * * <li>Setting the size or location of a top-level container. * <br>Calls to <code>setSize</code>, <code>setBounds</code> or * <code>setLocation</code> on a <code>Window</code>, diff --git a/src/share/classes/java/awt/WaitDispatchSupport.java b/src/share/classes/java/awt/WaitDispatchSupport.java index c9a671838a..ac59d77855 100644 --- a/src/share/classes/java/awt/WaitDispatchSupport.java +++ b/src/share/classes/java/awt/WaitDispatchSupport.java @@ -91,7 +91,7 @@ class WaitDispatchSupport implements SecondaryLoop { * * @param dispatchThread An event dispatch thread that * should not stop dispatching events while waiting - * @param extCondition A conditional object used to determine + * @param extCond A conditional object used to determine * if the loop should be terminated * * @since 1.7 @@ -161,7 +161,7 @@ class WaitDispatchSupport implements SecondaryLoop { } /** - * @inheritDoc + * {@inheritDoc} */ @Override public boolean enter() { @@ -281,7 +281,7 @@ class WaitDispatchSupport implements SecondaryLoop { } /** - * @inheritDoc + * {@inheritDoc} */ public boolean exit() { if (log.isLoggable(PlatformLogger.Level.FINE)) { diff --git a/src/share/classes/java/awt/Window.java b/src/share/classes/java/awt/Window.java index ceb901a3c4..13779fd412 100644 --- a/src/share/classes/java/awt/Window.java +++ b/src/share/classes/java/awt/Window.java @@ -212,7 +212,7 @@ public class Window extends Container implements Accessible { * * @serial * @see #getIconImages - * @see #setIconImages(List<? extends Image>) + * @see #setIconImages */ transient java.util.List<Image> icons; diff --git a/src/share/classes/java/awt/color/CMMException.java b/src/share/classes/java/awt/color/CMMException.java index 9aca938a30..04497f69cc 100644 --- a/src/share/classes/java/awt/color/CMMException.java +++ b/src/share/classes/java/awt/color/CMMException.java @@ -27,7 +27,8 @@ * */ -/********************************************************************** +/* + ********************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** diff --git a/src/share/classes/java/awt/color/ColorSpace.java b/src/share/classes/java/awt/color/ColorSpace.java index c0bcb4938c..ac21273d41 100644 --- a/src/share/classes/java/awt/color/ColorSpace.java +++ b/src/share/classes/java/awt/color/ColorSpace.java @@ -23,7 +23,8 @@ * questions. */ -/********************************************************************** +/* + ********************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** @@ -91,7 +92,6 @@ import sun.java2d.cmm.CMSManager; </pre> * - * <p> * @see ICC_ColorSpace */ diff --git a/src/share/classes/java/awt/color/ICC_ColorSpace.java b/src/share/classes/java/awt/color/ICC_ColorSpace.java index ace7f3db3a..53edefb599 100644 --- a/src/share/classes/java/awt/color/ICC_ColorSpace.java +++ b/src/share/classes/java/awt/color/ICC_ColorSpace.java @@ -23,7 +23,8 @@ * questions. */ -/********************************************************************** +/* + ********************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** @@ -77,7 +78,6 @@ import sun.java2d.cmm.PCMM; * imported images with a known color space. At most, such applets * would need to get one of the default color spaces via * ColorSpace.getInstance(). - * <p> * @see ColorSpace * @see ICC_Profile */ @@ -481,7 +481,6 @@ public class ICC_ColorSpace extends ColorSpace { * be the same as the media white point tag XYZ value in the ICC * profile for an sRGB device. * <p> - * <p> * @param colorvalue a float array with length of at least 3. * @return a float array with length equal to the number of * components in this ColorSpace. diff --git a/src/share/classes/java/awt/color/ICC_Profile.java b/src/share/classes/java/awt/color/ICC_Profile.java index 7e44947477..89abeca03d 100644 --- a/src/share/classes/java/awt/color/ICC_Profile.java +++ b/src/share/classes/java/awt/color/ICC_Profile.java @@ -23,7 +23,8 @@ * questions. */ -/********************************************************************** +/* + ********************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** @@ -86,7 +87,6 @@ import java.security.PrivilegedAction; * ICC Profile Format Specification. Most profiles of interest * either have invertible transformations or explicitly specify * transformations going both directions. - * <p> * @see ICC_ColorSpace */ diff --git a/src/share/classes/java/awt/color/ICC_ProfileGray.java b/src/share/classes/java/awt/color/ICC_ProfileGray.java index a868a6f50f..1b076a6f81 100644 --- a/src/share/classes/java/awt/color/ICC_ProfileGray.java +++ b/src/share/classes/java/awt/color/ICC_ProfileGray.java @@ -23,7 +23,8 @@ * questions. */ -/********************************************************************** +/* + ********************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** @@ -63,7 +64,6 @@ import sun.java2d.cmm.ProfileDeferralInfo; </pre> * The inverse transform is done by converting the PCS Y components to * device Gray via the inverse of the grayTRC. - * <p> */ diff --git a/src/share/classes/java/awt/color/ICC_ProfileRGB.java b/src/share/classes/java/awt/color/ICC_ProfileRGB.java index dcf6582865..c26697a85d 100644 --- a/src/share/classes/java/awt/color/ICC_ProfileRGB.java +++ b/src/share/classes/java/awt/color/ICC_ProfileRGB.java @@ -23,7 +23,8 @@ * questions. */ -/********************************************************************** +/* + ********************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** @@ -82,7 +83,6 @@ import sun.java2d.cmm.ProfileDeferralInfo; * The inverse transform is performed by converting PCS XYZ components to linear * RGB components through the inverse of the above 3x3 matrix, and then converting * linear RGB to device RGB through inverses of the TRCs. - * <p> */ @@ -111,7 +111,7 @@ extends ICC_Profile { /** * Constructs an new <code>ICC_ProfileRGB</code> from a CMM ID. * - * @param ID The CMM ID for the profile. + * @param p The CMM ID for the profile. * */ ICC_ProfileRGB(Profile p) { diff --git a/src/share/classes/java/awt/dnd/DnDEventMulticaster.java b/src/share/classes/java/awt/dnd/DnDEventMulticaster.java index 2e6c13a055..a9d9e6587f 100644 --- a/src/share/classes/java/awt/dnd/DnDEventMulticaster.java +++ b/src/share/classes/java/awt/dnd/DnDEventMulticaster.java @@ -71,7 +71,7 @@ class DnDEventMulticaster extends AWTEventMulticaster * Handles the <code>DragSourceDragEvent</code> by invoking * <code>dragOver</code> on listener-a and listener-b. * - * @param e the <code>DragSourceDragEvent</code> + * @param dsde the <code>DragSourceDragEvent</code> */ public void dragOver(DragSourceDragEvent dsde) { ((DragSourceListener)a).dragOver(dsde); diff --git a/src/share/classes/java/awt/dnd/DragSourceDropEvent.java b/src/share/classes/java/awt/dnd/DragSourceDropEvent.java index e1116bc68d..25f7630dd7 100644 --- a/src/share/classes/java/awt/dnd/DragSourceDropEvent.java +++ b/src/share/classes/java/awt/dnd/DragSourceDropEvent.java @@ -37,7 +37,6 @@ package java.awt.dnd; * to provide appropriate feedback to the end user * when the operation completes. * <P> - * <P> * @since 1.2 */ diff --git a/src/share/classes/java/awt/dnd/DropTarget.java b/src/share/classes/java/awt/dnd/DropTarget.java index 0480ba5f67..ad67293607 100644 --- a/src/share/classes/java/awt/dnd/DropTarget.java +++ b/src/share/classes/java/awt/dnd/DropTarget.java @@ -197,7 +197,7 @@ public class DropTarget implements DropTargetListener, Serializable { * <P> * The Component will receive drops only if it is enabled. * @param c The new <code>Component</code> this <code>DropTarget</code> - * is to be associated with.<P> + * is to be associated with. */ public synchronized void setComponent(Component c) { @@ -246,7 +246,6 @@ public class DropTarget implements DropTargetListener, Serializable { * Sets the default acceptable actions for this <code>DropTarget</code> * <P> * @param ops the default actions - * <P> * @see java.awt.dnd.DnDConstants */ diff --git a/src/share/classes/java/awt/event/MouseAdapter.java b/src/share/classes/java/awt/event/MouseAdapter.java index b908a6626d..dfc16d9c8b 100644 --- a/src/share/classes/java/awt/event/MouseAdapter.java +++ b/src/share/classes/java/awt/event/MouseAdapter.java @@ -49,7 +49,7 @@ package java.awt.event; * methods. * The relevant method in the listener object is invoked and the {@code MouseEvent} * or {@code MouseWheelEvent} is passed to it in following cases: - * <p><ul> + * <ul> * <li>when a mouse button is pressed, released, or clicked (pressed and released) * <li>when the mouse cursor enters or exits the component * <li>when the mouse wheel rotated, or mouse moved or dragged diff --git a/src/share/classes/java/awt/font/FontRenderContext.java b/src/share/classes/java/awt/font/FontRenderContext.java index f9f5f1eec7..240ea89532 100644 --- a/src/share/classes/java/awt/font/FontRenderContext.java +++ b/src/share/classes/java/awt/font/FontRenderContext.java @@ -57,7 +57,6 @@ import java.awt.geom.AffineTransform; * <code>FontRenderContext</code> which is directly constructed will * most likely not represent any actual graphics device, and may lead * to unexpected or incorrect results. -* <p> * @see java.awt.RenderingHints#KEY_TEXT_ANTIALIASING * @see java.awt.RenderingHints#KEY_FRACTIONALMETRICS * @see java.awt.Graphics2D#getFontRenderContext() diff --git a/src/share/classes/java/awt/font/StyledParagraph.java b/src/share/classes/java/awt/font/StyledParagraph.java index df231bf530..e0447dfcf3 100644 --- a/src/share/classes/java/awt/font/StyledParagraph.java +++ b/src/share/classes/java/awt/font/StyledParagraph.java @@ -322,7 +322,7 @@ final class StyledParagraph { } /** - * Return i such that starts[i] <= index < starts[i+1]. starts + * Return i such that starts[i] <= index < starts[i+1]. starts * must be in increasing order, with at least one element greater * than index. */ diff --git a/src/share/classes/java/awt/geom/AffineTransform.java b/src/share/classes/java/awt/geom/AffineTransform.java index d3c27ffa87..494e3c8e31 100644 --- a/src/share/classes/java/awt/geom/AffineTransform.java +++ b/src/share/classes/java/awt/geom/AffineTransform.java @@ -46,8 +46,7 @@ import java.beans.ConstructorProperties; * [ y'] = [ m10 m11 m12 ] [ y ] = [ m10x + m11y + m12 ] * [ 1 ] [ 0 0 1 ] [ 1 ] [ 1 ] * </pre> - * <p> - * <h4><a name="quadrantapproximation">Handling 90-Degree Rotations</a></h4> + * <h3><a name="quadrantapproximation">Handling 90-Degree Rotations</a></h3> * <p> * In some variations of the <code>rotate</code> methods in the * <code>AffineTransform</code> class, a double-precision argument diff --git a/src/share/classes/java/awt/geom/QuadCurve2D.java b/src/share/classes/java/awt/geom/QuadCurve2D.java index a2c41d91fa..56d435f0f5 100644 --- a/src/share/classes/java/awt/geom/QuadCurve2D.java +++ b/src/share/classes/java/awt/geom/QuadCurve2D.java @@ -1047,7 +1047,7 @@ public abstract class QuadCurve2D implements Shape, Cloneable { /** * Evaluate the t values in the first num slots of the vals[] array * and place the evaluated values back into the same array. Only - * evaluate t values that are within the range <0, 1>, including + * evaluate t values that are within the range <0, 1>, including * the 0 and 1 ends of the range iff the include0 or include1 * booleans are true. If an "inflection" equation is handed in, * then any points which represent a point of inflection for that @@ -1081,7 +1081,7 @@ public abstract class QuadCurve2D implements Shape, Cloneable { /** * Determine where coord lies with respect to the range from - * low to high. It is assumed that low <= high. The return + * low to high. It is assumed that low <= high. The return * value is one of the 5 values BELOW, LOWEDGE, INSIDE, HIGHEDGE, * or ABOVE. */ diff --git a/src/share/classes/java/awt/image/BufferStrategy.java b/src/share/classes/java/awt/image/BufferStrategy.java index 7a4f793b79..1bd882c157 100644 --- a/src/share/classes/java/awt/image/BufferStrategy.java +++ b/src/share/classes/java/awt/image/BufferStrategy.java @@ -54,7 +54,6 @@ import java.awt.Image; * <p> * Alternatively, the contents of the back buffer can be copied, or * <i>blitted</i> forward in a chain instead of moving the video pointer. - * <p> * <pre>{@code * Double buffering: * diff --git a/src/share/classes/java/awt/image/BufferedImage.java b/src/share/classes/java/awt/image/BufferedImage.java index 811c209a98..df968838d7 100644 --- a/src/share/classes/java/awt/image/BufferedImage.java +++ b/src/share/classes/java/awt/image/BufferedImage.java @@ -927,7 +927,6 @@ public class BufferedImage extends java.awt.Image * each color component in the returned data when * using this method. With a specified coordinate (x, y) in the * image, the ARGB pixel can be accessed in this way: - * <p> * * <pre> * pixel = rgbArray[offset + (y-startY)*scansize + (x-startX)]; </pre> diff --git a/src/share/classes/java/awt/image/ColorConvertOp.java b/src/share/classes/java/awt/image/ColorConvertOp.java index 7ba11582be..712eae4826 100644 --- a/src/share/classes/java/awt/image/ColorConvertOp.java +++ b/src/share/classes/java/awt/image/ColorConvertOp.java @@ -23,7 +23,8 @@ * questions. */ -/********************************************************************** +/* + ********************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** @@ -64,7 +65,6 @@ import java.awt.RenderingHints; * color conversion. * <p> * Note that Source and Destination may be the same object. - * <p> * @see java.awt.RenderingHints#KEY_COLOR_RENDERING * @see java.awt.RenderingHints#KEY_DITHERING */ diff --git a/src/share/classes/java/awt/peer/CheckboxPeer.java b/src/share/classes/java/awt/peer/CheckboxPeer.java index fb4c4e6608..abdbec9fa6 100644 --- a/src/share/classes/java/awt/peer/CheckboxPeer.java +++ b/src/share/classes/java/awt/peer/CheckboxPeer.java @@ -41,7 +41,7 @@ public interface CheckboxPeer extends ComponentPeer { * Sets the state of the checkbox to be checked ({@code true}) or * unchecked ({@code false}). * - * @param t the state to set on the checkbox + * @param state the state to set on the checkbox * * @see Checkbox#setState(boolean) */ diff --git a/src/share/classes/java/awt/peer/DesktopPeer.java b/src/share/classes/java/awt/peer/DesktopPeer.java index 72a87eccea..48603d6c51 100644 --- a/src/share/classes/java/awt/peer/DesktopPeer.java +++ b/src/share/classes/java/awt/peer/DesktopPeer.java @@ -87,7 +87,7 @@ public interface DesktopPeer { * filling the message fields including to, cc, etc, with the values * specified by the given mailto URL. * - * @param uri represents a mailto URL with specified values of the message. + * @param mailtoURL represents a mailto URL with specified values of the message. * The syntax of mailto URL is defined by * <a href="http://www.ietf.org/rfc/rfc2368.txt">RFC2368: The mailto * URL scheme</a> @@ -103,5 +103,5 @@ public interface DesktopPeer { * @throws IOException If the user default browser is not found, * or it fails to be launched. */ - void browse(URI url) throws IOException; + void browse(URI uri) throws IOException; } |