8028019: AWT Doclint warning/error cleanup

Fix numerious javadoc and html errors and warnings

Reviewed-by: yan
This commit is contained in:
Roger Riggs 2013-12-03 16:20:44 -05:00
parent 6c3fdefd1d
commit e2a0a41dd3
55 changed files with 110 additions and 131 deletions

View File

@ -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"},

View File

@ -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

View File

@ -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>

View File

@ -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

View File

@ -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>

View File

@ -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;

View File

@ -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>.

View File

@ -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>.

View File

@ -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();

View File

@ -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>.

View File

@ -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>.

View File

@ -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>.

View File

@ -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>

View File

@ -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

View File

@ -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>

View File

@ -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.
*

View File

@ -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

View File

@ -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 '&aacute;'
* <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 '&acute;'. 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>

View File

@ -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>,&nbsp;<i>y</i>).

View File

@ -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.

View File

@ -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&nbsp;=&nbsp;1.0</code>
* <li>Button4: <code>weightx&nbsp;=&nbsp;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.*;

View File

@ -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"

View File

@ -36,7 +36,7 @@ import javax.accessibility.*;
* directly.
* <p>
* For example, the code&nbsp;.&nbsp;.&nbsp;.
* <p>
*
* <hr><blockquote><pre>
* setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10));
* add(new Label("Hi There!"));

View File

@ -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">

View File

@ -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

View File

@ -41,7 +41,7 @@ import javax.accessibility.*;
* the user can choose either one item or multiple items.
* <p>
* For example, the code&nbsp;.&nbsp;.&nbsp;.
* <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>.

View File

@ -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>.

View File

@ -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">

View File

@ -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&nbsp;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.

View File

@ -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()) {

View File

@ -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>

View File

@ -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>

View File

@ -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>.

View File

@ -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>,

View File

@ -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)) {

View File

@ -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;

View File

@ -27,7 +27,8 @@
*
*/
/**********************************************************************
/*
**********************************************************************
**********************************************************************
**********************************************************************
*** COPYRIGHT (c) Eastman Kodak Company, 1997 ***

View File

@ -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
*/

View File

@ -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.

View File

@ -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
*/

View File

@ -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>
*/

View File

@ -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) {

View File

@ -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);

View File

@ -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
*/

View File

@ -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
*/

View File

@ -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

View File

@ -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()

View File

@ -322,7 +322,7 @@ final class StyledParagraph {
}
/**
* Return i such that starts[i] <= index < starts[i+1]. starts
* Return i such that starts[i] &lt;= index &lt; starts[i+1]. starts
* must be in increasing order, with at least one element greater
* than index.
*/

View File

@ -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

View File

@ -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 &lt;0, 1&gt;, 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 &lt;= high. The return
* value is one of the 5 values BELOW, LOWEDGE, INSIDE, HIGHEDGE,
* or ABOVE.
*/

View File

@ -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:
*

View File

@ -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,&nbsp;y) in the
* image, the ARGB pixel can be accessed in this way:
* <p>
*
* <pre>
* pixel = rgbArray[offset + (y-startY)*scansize + (x-startX)]; </pre>

View File

@ -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
*/

View File

@ -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)
*/

View File

@ -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;
}