findFolder(int folderType) and
- * findFolder(short domain, int folderType) except that it can create the folder if it does not already exist.
+ * not exist. The behavior is similar to {@code findFolder(int folderType)} and
+ * {@code findFolder(short domain, int folderType)} except that it can create the folder if it does not already exist.
*
* @param createIfNeeded
- * set to true, by setting to false the behavior will be the
- * same as findFolder(short domain, int folderType, boolean createIfNeeded)
+ * set to {@code true}, by setting to {@code false} the behavior will be the
+ * same as {@code findFolder(short domain, int folderType, boolean createIfNeeded)}
* @return the path to the folder searched for
*
* @since 1.4
@@ -263,9 +263,9 @@
/**
- * Opens the path specified by a URL in the appropriate application for that URL. HTTP URL's (http://)
- * open in the default browser as set in the Internet pane of System Preferences. File (file://) and
- * FTP URL's (ftp://) open in the Finder. Note that opening an FTP URL will prompt the user for where
+ * Opens the path specified by a URL in the appropriate application for that URL. HTTP URL's ({@code http://})
+ * open in the default browser as set in the Internet pane of System Preferences. File ({@code file://}) and
+ * FTP URL's ({@code ftp://}) open in the Finder. Note that opening an FTP URL will prompt the user for where
* they want to save the downloaded file(s).
*
* @param url
--- old/src/java.desktop/macosx/classes/com/apple/laf/AquaInternalFrameUI.java 2015-10-04 22:51:44.849276792 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaInternalFrameUI.java 2015-10-04 22:51:44.661276800 +0400
@@ -295,9 +295,9 @@
}
/**
- * Installs necessary mouse handlers on newPane
+ * Installs necessary mouse handlers on {@code newPane}
* and adds it to the frame.
- * Reverse process for the currentPane.
+ * Reverse process for the {@code currentPane}.
*/
@Override
protected void replacePane(final JComponent currentPane, final JComponent newPane) {
--- old/src/java.desktop/macosx/classes/com/apple/laf/AquaLookAndFeel.java 2015-10-04 22:51:45.393276767 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaLookAndFeel.java 2015-10-04 22:51:45.205276776 +0400
@@ -82,9 +82,9 @@
}
/**
- * Returns true if the LookAndFeel returned
- * RootPaneUI instances support providing Window decorations
- * in a JRootPane.
+ * Returns true if the {@code LookAndFeel} returned
+ * {@code RootPaneUI} instances support providing Window decorations
+ * in a {@code JRootPane}.
*
* The default implementation returns false, subclasses that support
* Window decorations should override this and return true.
@@ -174,20 +174,20 @@
}
/**
- * Returns an ActionMap.
+ * Returns an {@code ActionMap}.
*
- * This ActionMap contains Actions that
+ * This {@code ActionMap} contains {@code Actions} that
* embody the ability to render an auditory cue. These auditory
* cues map onto user and system activities that may be useful
* for an end user to know about (such as a dialog box appearing).
*
- * At the appropriate time in a JComponent UI's lifecycle,
+ * At the appropriate time in a {@code JComponent} UI's lifecycle,
* the ComponentUI is responsible for getting the appropriate
- * Action out of the ActionMap and passing
- * it on to playSound.
+ * {@code Action} out of the {@code ActionMap} and passing
+ * it on to {@code playSound}.
*
- * The Actions in this ActionMap are
- * created by the createAudioAction method.
+ * The {@code Actions} in this {@code ActionMap} are
+ * created by the {@code createAudioAction} method.
*
* @return an ActionMap containing Actions
* responsible for rendering auditory cues
--- old/src/java.desktop/macosx/classes/com/apple/laf/AquaOptionPaneUI.java 2015-10-04 22:51:45.925276743 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaOptionPaneUI.java 2015-10-04 22:51:45.737276752 +0400
@@ -47,7 +47,7 @@
/**
* Creates and returns a Container containin the buttons. The buttons
- * are created by calling getButtons.
+ * are created by calling {@code getButtons}.
*/
protected Container createButtonArea() {
final Container bottom = super.createButtonArea();
--- old/src/java.desktop/macosx/classes/com/apple/laf/AquaRootPaneUI.java 2015-10-04 22:51:46.457276719 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaRootPaneUI.java 2015-10-04 22:51:46.257276728 +0400
@@ -164,7 +164,7 @@
/**
* Invoked when a property changes on the root pane. If the event
- * indicates the defaultButton has changed, this will
+ * indicates the {@code defaultButton} has changed, this will
* update the animation.
* If the enabled state changed, it will start or stop the animation
*/
--- old/src/java.desktop/macosx/classes/com/apple/laf/AquaTabbedPaneCopyFromBasicUI.java 2015-10-04 22:51:46.981276696 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaTabbedPaneCopyFromBasicUI.java 2015-10-04 22:51:46.789276704 +0400
@@ -235,9 +235,9 @@
}
/**
- * Invoked by installUI to create
+ * Invoked by {@code installUI} to create
* a layout manager object to manage
- * the JTabbedPane.
+ * the {@code JTabbedPane}.
*
* @return a layout manager object
*
@@ -536,7 +536,7 @@
/**
* Sets the tab the mouse is over by location. This is a cover method
- * for setRolloverTab(tabForCoordinate(x, y, false)).
+ * for {@code setRolloverTab(tabForCoordinate(x, y, false))}.
*/
private void setRolloverTab(final int x, final int y) {
// NOTE:
@@ -547,8 +547,8 @@
}
/**
- * Sets the tab the mouse is currently over to index.
- * index will be -1 if the mouse is no longer over any
+ * Sets the tab the mouse is currently over to {@code index}.
+ * {@code index} will be -1 if the mouse is no longer over any
* tab. No checking is done to ensure the passed in index identifies a
* valid tab.
*
@@ -676,7 +676,7 @@
/**
* Returns the amount the baseline is offset by. This is typically
- * the same as getTabLabelShiftY.
+ * the same as {@code getTabLabelShiftY}.
*
* @return amount to offset the baseline by
* @since 1.6
@@ -765,10 +765,10 @@
/**
* Paints the tabs in the tab area.
* Invoked by paint().
- * The graphics parameter must be a valid Graphics
+ * The graphics parameter must be a valid {@code Graphics}
* object. Tab placement may be either:
- * JTabbedPane.TOP, JTabbedPane.BOTTOM,
- * JTabbedPane.LEFT, or JTabbedPane.RIGHT.
+ * {@code JTabbedPane.TOP}, {@code JTabbedPane.BOTTOM},
+ * {@code JTabbedPane.LEFT}, or {@code JTabbedPane.RIGHT}.
* The selected index must be a valid tabbed pane tab index (0 to
* tab count - 1, inclusive) or -1 if no tab is currently selected.
* The handling of invalid parameters is unspecified.
@@ -1406,7 +1406,7 @@
* designated Rectangle object (rather than instantiating and returning
* a new Rectangle each time). The tab index parameter must be a valid
* tabbed pane tab index (0 to tab count - 1, inclusive). The destination
- * rectangle parameter must be a valid Rectangle instance.
+ * rectangle parameter must be a valid {@code Rectangle} instance.
* The handling of invalid parameters is unspecified.
*
* @param tabIndex the index of the tab
@@ -3717,7 +3717,7 @@
/**
* An ActionMap that populates its contents as necessary. The
- * contents are populated by invoking the loadActionMap
+ * contents are populated by invoking the {@code loadActionMap}
* method on the passed in Object.
*
* @version 1.6, 11/17/05
@@ -3726,14 +3726,14 @@
@SuppressWarnings("serial") // Superclass is not serializable across versions
static class LazyActionMap extends ActionMapUIResource {
/**
- * Object to invoke loadActionMap on. This may be
+ * Object to invoke {@code loadActionMap} on. This may be
* a Class object.
*/
private transient Object _loader;
/**
* Installs an ActionMap that will be populated by invoking the
- * loadActionMap method on the specified Class
+ * {@code loadActionMap} method on the specified Class
* when necessary.
*
* This should be used if the ActionMap can be shared.
@@ -3755,7 +3755,7 @@
/**
* Returns an ActionMap that will be populated by invoking the
- * loadActionMap method on the specified Class
+ * {@code loadActionMap} method on the specified Class
* when necessary.
*
* This should be used if the ActionMap can be shared.
--- old/src/java.desktop/macosx/classes/com/apple/laf/AquaTreeUI.java 2015-10-04 22:51:47.541276671 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaTreeUI.java 2015-10-04 22:51:47.353276679 +0400
@@ -179,8 +179,8 @@
}
/**
- * Paints the expand (toggle) part of a row. The receiver should NOT modify clipBounds, or
- * insets.
+ * Paints the expand (toggle) part of a row. The receiver should NOT modify {@code clipBounds}, or
+ * {@code insets}.
*/
protected void paintExpandControl(final Graphics g, final Rectangle clipBounds, final Insets insets, final Rectangle bounds, final TreePath path, final int row, final boolean isExpanded, final boolean hasBeenExpanded, final boolean isLeaf) {
final Object value = path.getLastPathComponent();
--- old/src/java.desktop/macosx/classes/sun/font/NativeFont.java 2015-10-04 22:51:48.117276645 +0400
+++ new/src/java.desktop/macosx/classes/sun/font/NativeFont.java 2015-10-04 22:51:47.877276656 +0400
@@ -41,7 +41,7 @@
/**
* Verifies native font is accessible.
- * @throws FontFormatException - if the font can't be located.
+ * @throws FontFormatException if the font can't be located.
*/
public NativeFont(String platName, boolean isBitmapDelegate)
throws FontFormatException {
--- old/src/java.desktop/macosx/classes/sun/java2d/DataBufferNIOInt.java 2015-10-04 22:51:48.637276621 +0400
+++ new/src/java.desktop/macosx/classes/sun/java2d/DataBufferNIOInt.java 2015-10-04 22:51:48.449276630 +0400
@@ -37,10 +37,10 @@
IntBuffer bankdata[];
/**
- * Constructs an integer-based DataBuffer with a single bank
+ * Constructs an integer-based {@code DataBuffer} with a single bank
* and the specified size.
*
- * @param size The size of the DataBuffer.
+ * @param size The size of the {@code DataBuffer}.
*/
public DataBufferNIOInt(int size) {
super(TYPE_INT,size);
@@ -51,7 +51,7 @@
}
/**
- * Returns the default (first) IntBuffer in DataBuffer.
+ * Returns the default (first) IntBuffer in {@code DataBuffer}.
*
* @return The first IntBuffer.
*/
@@ -70,7 +70,7 @@
}
/**
- * Returns the default (first) int data array in DataBuffer.
+ * Returns the default (first) int data array in {@code DataBuffer}.
*
* @return The first integer data array.
*/
@@ -137,7 +137,7 @@
/**
* Sets the requested data array element in the specified bank
- * to the integer value i.
+ * to the integer value {@code i}.
* @param bank The bank in which you want to set the data array element.
* @param i The data array element you want to set.
* @param val The integer value to which you want to set the specified data array element.
--- old/src/java.desktop/macosx/classes/sun/lwawt/macosx/CDesktopPeer.java 2015-10-04 22:51:49.157276598 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CDesktopPeer.java 2015-10-04 22:51:48.969276607 +0400
@@ -33,7 +33,7 @@
/**
- * Concrete implementation of the interface DesktopPeer for MacOS X
+ * Concrete implementation of the interface {@code DesktopPeer} for MacOS X
*
* @see DesktopPeer
*/
--- old/src/java.desktop/macosx/classes/sun/lwawt/macosx/CInputMethod.java 2015-10-04 22:51:49.677276575 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CInputMethod.java 2015-10-04 22:51:49.489276583 +0400
@@ -101,7 +101,7 @@
* method.
*
* @param context the input method context for this input method
- * @exception NullPointerException if context is null
+ * @exception NullPointerException if {@code context} is null
*/
public void setInputMethodContext(InputMethodContext context) {
fIMContext = context;
@@ -124,7 +124,7 @@
*
* @param lang locale to input
* @return whether the specified locale is supported
- * @exception NullPointerException if locale is null
+ * @exception NullPointerException if {@code locale} is null
*/
public boolean setLocale(Locale lang) {
return setLocale(lang, false);
@@ -205,7 +205,7 @@
* are dispatched to the current input method for this component before
* they are dispatched to the component's methods or event listeners.
* The input method decides whether it needs to handle the event. If it
- * does, it also calls the event's consume method; this
+ * does, it also calls the event's {@code consume} method; this
* causes the event to not get dispatched to the component's event
* processing methods or event listeners.
*
@@ -216,7 +216,7 @@
* This method is called by {@link java.awt.im.InputContext#dispatchEvent InputContext.dispatchEvent}.
*
* @param event the event being dispatched to the input method
- * @exception NullPointerException if event is null
+ * @exception NullPointerException if {@code event} is null
*/
public void dispatchEvent(final AWTEvent event) {
// No-op for Mac OS X.
--- old/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterDevice.java 2015-10-04 22:51:50.209276551 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterDevice.java 2015-10-04 22:51:50.021276559 +0400
@@ -35,8 +35,8 @@
}
/**
- * Returns the type of this GraphicsDevice.
- * @return the type of this GraphicsDevice, which can
+ * Returns the type of this {@code GraphicsDevice}.
+ * @return the type of this {@code GraphicsDevice}, which can
* either be TYPE_RASTER_SCREEN, TYPE_PRINTER or TYPE_IMAGE_BUFFER.
* @see #TYPE_RASTER_SCREEN
* @see #TYPE_PRINTER
@@ -48,30 +48,30 @@
/**
* Returns the identification string associated with this
- * GraphicsDevice.
- * @return a String that is the identification
- * of this GraphicsDevice.
+ * {@code GraphicsDevice}.
+ * @return a {@code String} that is the identification
+ * of this {@code GraphicsDevice}.
*/
public String getIDstring() {
return ("Printer");
}
/**
- * Returns all of the GraphicsConfiguration
- * objects associated with this GraphicsDevice.
- * @return an array of GraphicsConfiguration
+ * Returns all of the {@code GraphicsConfiguration}
+ * objects associated with this {@code GraphicsDevice}.
+ * @return an array of {@code GraphicsConfiguration}
* objects that are associated with this
- * GraphicsDevice.
+ * {@code GraphicsDevice}.
*/
public GraphicsConfiguration[] getConfigurations() {
return new GraphicsConfiguration[] { gc };
}
/**
- * Returns the default GraphicsConfiguration
- * associated with this GraphicsDevice.
- * @return the default GraphicsConfiguration
- * of this GraphicsDevice.
+ * Returns the default {@code GraphicsConfiguration}
+ * associated with this {@code GraphicsDevice}.
+ * @return the default {@code GraphicsConfiguration}
+ * of this {@code GraphicsDevice}.
*/
public GraphicsConfiguration getDefaultConfiguration() {
return gc;
--- old/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterGraphicsConfig.java 2015-10-04 22:51:50.729276528 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterGraphicsConfig.java 2015-10-04 22:51:50.541276536 +0400
@@ -49,9 +49,9 @@
/**
* Returns the {@link GraphicsDevice} associated with this
- * GraphicsConfiguration.
- * @return a GraphicsDevice object that is
- * associated with this GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
+ * @return a {@code GraphicsDevice} object that is
+ * associated with this {@code GraphicsConfiguration}.
*/
public GraphicsDevice getDevice() {
return gd;
@@ -59,16 +59,16 @@
/**
* Returns a {@link BufferedImage} with a data layout and color model
- * compatible with this GraphicsConfiguration. This
+ * compatible with this {@code GraphicsConfiguration}. This
* method has nothing to do with memory-mapping
- * a device. The returned BufferedImage has
+ * a device. The returned {@code BufferedImage} has
* a layout and color model that is closest to this native device
* configuration and can therefore be optimally blitted to this
* device.
- * @param width the width of the returned BufferedImage
- * @param height the height of the returned BufferedImage
- * @return a BufferedImage whose data layout and color
- * model is compatible with this GraphicsConfiguration.
+ * @param width the width of the returned {@code BufferedImage}
+ * @param height the height of the returned {@code BufferedImage}
+ * @return a {@code BufferedImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}.
*/
public BufferedImage createCompatibleImage(int width, int height) {
return createCompatibleImage(width, height, Transparency.OPAQUE);
@@ -76,15 +76,15 @@
/**
* Returns a {@link VolatileImage} with a data layout and color model
- * compatible with this GraphicsConfiguration.
- * The returned VolatileImage
+ * compatible with this {@code GraphicsConfiguration}.
+ * The returned {@code VolatileImage}
* may have data that is stored optimally for the underlying graphics
* device and may therefore benefit from platform-specific rendering
* acceleration.
- * @param width the width of the returned VolatileImage
- * @param height the height of the returned VolatileImage
- * @return a VolatileImage whose data layout and color
- * model is compatible with this GraphicsConfiguration.
+ * @param width the width of the returned {@code VolatileImage}
+ * @param height the height of the returned {@code VolatileImage}
+ * @return a {@code VolatileImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}.
* @see Component#createVolatileImage(int, int)
*/
public VolatileImage createCompatibleVolatileImage(int width, int height) {
@@ -97,18 +97,18 @@
}
/**
- * Returns a BufferedImage that supports the specified
+ * Returns a {@code BufferedImage} that supports the specified
* transparency and has a data layout and color model
- * compatible with this GraphicsConfiguration. This
+ * compatible with this {@code GraphicsConfiguration}. This
* method has nothing to do with memory-mapping
- * a device. The returned BufferedImage has a layout and
+ * a device. The returned {@code BufferedImage} has a layout and
* color model that can be optimally blitted to a device
- * with this GraphicsConfiguration.
- * @param width the width of the returned BufferedImage
- * @param height the height of the returned BufferedImage
+ * with this {@code GraphicsConfiguration}.
+ * @param width the width of the returned {@code BufferedImage}
+ * @param height the height of the returned {@code BufferedImage}
* @param transparency the specified transparency mode
- * @return a BufferedImage whose data layout and color
- * model is compatible with this GraphicsConfiguration
+ * @return a {@code BufferedImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}
* and also supports the specified transparency.
* @see Transparency#OPAQUE
* @see Transparency#BITMASK
@@ -121,21 +121,21 @@
/**
* Returns the {@link ColorModel} associated with this
- * GraphicsConfiguration.
- * @return a ColorModel object that is associated with
- * this GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
+ * @return a {@code ColorModel} object that is associated with
+ * this {@code GraphicsConfiguration}.
*/
public ColorModel getColorModel() {
return getColorModel(Transparency.OPAQUE);
}
/**
- * Returns the ColorModel associated with this
- * GraphicsConfiguration that supports the specified
+ * Returns the {@code ColorModel} associated with this
+ * {@code GraphicsConfiguration} that supports the specified
* transparency.
* @param transparency the specified transparency mode
- * @return a ColorModel object that is associated with
- * this GraphicsConfiguration and supports the
+ * @return a {@code ColorModel} object that is associated with
+ * this {@code GraphicsConfiguration} and supports the
* specified transparency.
*/
public ColorModel getColorModel(int transparency) {
@@ -144,22 +144,22 @@
/**
* Returns the default {@link AffineTransform} for this
- * GraphicsConfiguration. This
- * AffineTransform is typically the Identity transform
- * for most normal screens. The default AffineTransform
+ * {@code GraphicsConfiguration}. This
+ * {@code AffineTransform} is typically the Identity transform
+ * for most normal screens. The default {@code AffineTransform}
* maps coordinates onto the device such that 72 user space
* coordinate units measure approximately 1 inch in device
* space. The normalizing transform can be used to make
* this mapping more exact. Coordinates in the coordinate space
- * defined by the default AffineTransform for screen and
+ * defined by the default {@code AffineTransform} for screen and
* printer devices have the origin in the upper left-hand corner of
* the target region of the device, with X coordinates
* increasing to the right and Y coordinates increasing downwards.
* For image buffers not associated with a device, such as those not
- * created by createCompatibleImage,
- * this AffineTransform is the Identity transform.
- * @return the default AffineTransform for this
- * GraphicsConfiguration.
+ * created by {@code createCompatibleImage},
+ * this {@code AffineTransform} is the Identity transform.
+ * @return the default {@code AffineTransform} for this
+ * {@code GraphicsConfiguration}.
*/
public AffineTransform getDefaultTransform() {
return new AffineTransform();
@@ -167,9 +167,9 @@
/**
*
- * Returns a AffineTransform that can be concatenated
- * with the default AffineTransform
- * of a GraphicsConfiguration so that 72 units in user
+ * Returns a {@code AffineTransform} that can be concatenated
+ * with the default {@code AffineTransform}
+ * of a {@code GraphicsConfiguration} so that 72 units in user
* space equals 1 inch in device space.
*
* For a particular {@link Graphics2D}, g, one
@@ -181,16 +181,16 @@
* g.setTransform(gc.getDefaultTransform());
* g.transform(gc.getNormalizingTransform());
*
- * Note that sometimes this AffineTransform is identity,
+ * Note that sometimes this {@code AffineTransform} is identity,
* such as for printers or metafile output, and that this
- * AffineTransform is only as accurate as the information
+ * {@code AffineTransform} is only as accurate as the information
* supplied by the underlying system. For image buffers not
* associated with a device, such as those not created by
- * createCompatibleImage, this
- * AffineTransform is the Identity transform
+ * {@code createCompatibleImage}, this
+ * {@code AffineTransform} is the Identity transform
* since there is no valid distance measurement.
- * @return an AffineTransform to concatenate to the
- * default AffineTransform so that 72 units in user
+ * @return an {@code AffineTransform} to concatenate to the
+ * default {@code AffineTransform} so that 72 units in user
* space is mapped to 1 inch in device space.
*/
public AffineTransform getNormalizingTransform() {
@@ -198,12 +198,12 @@
}
/**
- * Returns the bounds of the GraphicsConfiguration
+ * Returns the bounds of the {@code GraphicsConfiguration}
* in the device coordinates. In a multi-screen environment
* with a virtual device, the bounds can have negative X
* or Y origins.
* @return the bounds of the area covered by this
- * GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
* @since 1.3
*/
public Rectangle getBounds() {
--- old/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterJob.java 2015-10-04 22:51:51.253276504 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterJob.java 2015-10-04 22:51:51.065276512 +0400
@@ -83,13 +83,13 @@
* to these native print services.
* To present the cross platform print dialog for all services,
* including native ones instead use
- * printDialog(PrintRequestAttributeSet).
+ * {@code printDialog(PrintRequestAttributeSet)}.
*
* PrinterJob implementations which can use PrintService's will update
* the PrintService for this PrinterJob to reflect the new service
* selected by the user.
- * @return true if the user does not cancel the dialog;
- * false otherwise.
+ * @return {@code true} if the user does not cancel the dialog;
+ * {@code false} otherwise.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -117,19 +117,19 @@
/**
* Displays a dialog that allows modification of a
- * PageFormat instance.
- * The page argument is used to initialize controls
+ * {@code PageFormat} instance.
+ * The {@code page} argument is used to initialize controls
* in the page setup dialog.
* If the user cancels the dialog then this method returns the
- * original page object unmodified.
+ * original {@code page} object unmodified.
* If the user okays the dialog then this method returns a new
- * PageFormat object with the indicated changes.
- * In either case, the original page object is
+ * {@code PageFormat} object with the indicated changes.
+ * In either case, the original {@code page} object is
* not modified.
- * @param page the default PageFormat presented to the
+ * @param page the default {@code PageFormat} presented to the
* user for modification
- * @return the original page object if the dialog
- * is cancelled; a new PageFormat object
+ * @return the original {@code page} object if the dialog
+ * is cancelled; a new {@code PageFormat} object
* containing the format indicated by the user if the
* dialog is acknowledged.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
@@ -157,11 +157,11 @@
}
/**
- * Clones the PageFormat argument and alters the
+ * Clones the {@code PageFormat} argument and alters the
* clone to describe a default page size and orientation.
- * @param page the PageFormat to be cloned and altered
- * @return clone of page, altered to describe a default
- * PageFormat.
+ * @param page the {@code PageFormat} to be cloned and altered
+ * @return clone of {@code page}, altered to describe a default
+ * {@code PageFormat}.
*/
@Override
public PageFormat defaultPage(PageFormat page) {
--- old/src/java.desktop/macosx/classes/sun/lwawt/macosx/CRobot.java 2015-10-04 22:51:51.781276480 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CRobot.java 2015-10-04 22:51:51.593276489 +0400
@@ -73,7 +73,7 @@
* Presses one or more mouse buttons.
*
* @param buttons the button mask (combination of
- * InputEvent.BUTTON1/2/3_MASK)
+ * {@code InputEvent.BUTTON1/2/3_MASK})
*/
@Override
public void mousePress(int buttons) {
@@ -87,7 +87,7 @@
* Releases one or more mouse buttons.
*
* @param buttons the button mask (combination of
- * InputEvent.BUTTON1/2/3_MASK)
+ * {@code InputEvent.BUTTON1/2/3_MASK})
*/
@Override
public void mouseRelease(int buttons) {
@@ -133,14 +133,14 @@
* Presses a given key.
*
* Key codes that have more than one physical key associated with them
- * (e.g. KeyEvent.VK_SHIFT could mean either the
+ * (e.g. {@code KeyEvent.VK_SHIFT} could mean either the
* left or right shift key) will map to the left key.
*
* Assumes that the
* peer implementations will throw an exception for other bogus
* values e.g. -1, 999999
*
- * @param keycode the key to press (e.g. KeyEvent.VK_A)
+ * @param keycode the key to press (e.g. {@code KeyEvent.VK_A})
*/
@Override
public void keyPress(final int keycode) {
@@ -151,14 +151,14 @@
* Releases a given key.
*
* Key codes that have more than one physical key associated with them
- * (e.g. KeyEvent.VK_SHIFT could mean either the
+ * (e.g. {@code KeyEvent.VK_SHIFT} could mean either the
* left or right shift key) will map to the left key.
*
* Assumes that the
* peer implementations will throw an exception for other bogus
* values e.g. -1, 999999
*
- * @param keycode the key to release (e.g. KeyEvent.VK_A)
+ * @param keycode the key to release (e.g. {@code KeyEvent.VK_A})
*/
@Override
public void keyRelease(final int keycode) {
--- old/src/java.desktop/macosx/classes/sun/lwawt/macosx/LWCToolkit.java 2015-10-04 22:51:52.301276457 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/LWCToolkit.java 2015-10-04 22:51:52.113276465 +0400
@@ -515,13 +515,13 @@
* key for menu shortcuts.
*
* Menu shortcuts, which are embodied in the
- * MenuShortcut class, are handled by the
- * MenuBar class.
+ * {@code MenuShortcut} class, are handled by the
+ * {@code MenuBar} class.
*
- * By default, this method returns Event.CTRL_MASK.
+ * By default, this method returns {@code Event.CTRL_MASK}.
* Toolkit implementations should override this method if the
* Control key isn't the correct key for accelerators.
- * @return the modifier mask on the Event class
+ * @return the modifier mask on the {@code Event} class
* that is used for menu shortcuts on this toolkit.
* @see java.awt.MenuBar
* @see java.awt.MenuShortcut
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/bmp/BMPImageReader.java 2015-10-04 22:51:52.829276433 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/bmp/BMPImageReader.java 2015-10-04 22:51:52.637276442 +0400
@@ -74,7 +74,7 @@
/** This class is the Java Image IO plugin reader for BMP images.
* It may subsample the image, clip the image, select sub-bands,
* and shift the decoded image origin if the proper decoding parameter
- * are set in the provided ImageReadParam.
+ * are set in the provided {@code ImageReadParam}.
*
* This class supports Microsoft Windows Bitmap Version 3-5,
* as well as OS/2 Bitmap Version 2.x (for single-image BMP file).
@@ -159,8 +159,8 @@
/** source and destination bands. */
private int[] sourceBands, destBands;
- /** Constructs BMPImageReader from the provided
- * ImageReaderSpi.
+ /** Constructs {@code BMPImageReader} from the provided
+ * {@code ImageReaderSpi}.
*/
public BMPImageReader(ImageReaderSpi originator) {
super(originator);
@@ -1670,8 +1670,8 @@
/** Decodes the jpeg/png image embedded in the bitmap using any jpeg
* ImageIO-style plugin.
*
- * @param bi The destination BufferedImage.
- * @param bmpParam The ImageReadParam for decoding this
+ * @param bi The destination {@code BufferedImage}.
+ * @param bmpParam The {@code ImageReadParam} for decoding this
* BMP image. The parameters for subregion, band selection and
* subsampling are used in decoding the jpeg image.
*/
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/bmp/BMPImageWriter.java 2015-10-04 22:51:53.369276409 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/bmp/BMPImageWriter.java 2015-10-04 22:51:53.181276417 +0400
@@ -69,7 +69,7 @@
* a BMP format.
*
* The encoding process may clip, subsample using the parameters
- * specified in the ImageWriteParam.
+ * specified in the {@code ImageWriteParam}.
*
* @see javax.imageio.plugins.bmp.BMPImageWriteParam
*/
@@ -88,8 +88,8 @@
private short[] spixels;
private int[] ipixels;
- /** Constructs BMPImageWriter based on the provided
- * ImageWriterSpi.
+ /** Constructs {@code BMPImageWriter} based on the provided
+ * {@code ImageWriterSpi}.
*/
public BMPImageWriter(ImageWriterSpi originator) {
super(originator);
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/common/BogusColorSpace.java 2015-10-04 22:51:53.901276385 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/BogusColorSpace.java 2015-10-04 22:51:53.713276394 +0400
@@ -28,7 +28,7 @@
import java.awt.color.ColorSpace;
/**
- * A dummy ColorSpace to enable ColorModel
+ * A dummy {@code ColorSpace} to enable {@code ColorModel}
* for image data which do not have an innate color representation.
*/
@SuppressWarnings("serial") // JDK-implementation class
@@ -37,8 +37,8 @@
* Return the type given the number of components.
*
* @param numComponents The number of components in the
- * ColorSpace.
- * @exception IllegalArgumentException if numComponents
+ * {@code ColorSpace}.
+ * @exception IllegalArgumentException if {@code numComponents}
* is less than 1.
*/
private static int getType(int numComponents) {
@@ -62,11 +62,11 @@
}
/**
- * Constructs a bogus ColorSpace.
+ * Constructs a bogus {@code ColorSpace}.
*
* @param numComponents The number of components in the
- * ColorSpace.
- * @exception IllegalArgumentException if numComponents
+ * {@code ColorSpace}.
+ * @exception IllegalArgumentException if {@code numComponents}
* is less than 1.
*/
public BogusColorSpace(int numComponents) {
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/common/I18NImpl.java 2015-10-04 22:51:54.421276362 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/I18NImpl.java 2015-10-04 22:51:54.233276370 +0400
@@ -37,9 +37,9 @@
* the file from the jar as the package name is included automatically.
*
*
Extenders need only provide a static method
- * getString(String) which calls the static method in this
+ * {@code getString(String)} which calls the static method in this
* class with the name of the invoking class and returns a
- * String.
+ * {@code String}.
*/
public class I18NImpl {
/**
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/common/ImageUtil.java 2015-10-04 22:51:55.041276334 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/ImageUtil.java 2015-10-04 22:51:54.849276342 +0400
@@ -106,35 +106,35 @@
*/
/**
- * Creates a ColorModel that may be used with the
- * specified SampleModel. If a suitable
- * ColorModel cannot be found, this method returns
- * null.
- *
- *
Suitable ColorModels are guaranteed to exist
- * for all instances of ComponentSampleModel.
- * For 1- and 3- banded SampleModels, the returned
- * ColorModel will be opaque. For 2- and 4-banded
- * SampleModels, the output will use alpha transparency
+ * Creates a {@code ColorModel} that may be used with the
+ * specified {@code SampleModel}. If a suitable
+ * {@code ColorModel} cannot be found, this method returns
+ * {@code null}.
+ *
+ *
Suitable {@code ColorModel}s are guaranteed to exist
+ * for all instances of {@code ComponentSampleModel}.
+ * For 1- and 3- banded {@code SampleModel}s, the returned
+ * {@code ColorModel} will be opaque. For 2- and 4-banded
+ * {@code SampleModel}s, the output will use alpha transparency
* which is not premultiplied. 1- and 2-banded data will use a
- * grayscale ColorSpace, and 3- and 4-banded data a sRGB
- * ColorSpace. Data with 5 or more bands will have a
- * BogusColorSpace.
An instance of DirectColorModel will be created for
- * instances of SinglePixelPackedSampleModel with no more
+ *
An instance of {@code DirectColorModel} will be created for + * instances of {@code SinglePixelPackedSampleModel} with no more * than 4 bands.
* - *An instance of IndexColorModel will be created for
- * instances of MultiPixelPackedSampleModel. The colormap
- * will be a grayscale ramp with 1 << numberOfBits
+ *
An instance of {@code IndexColorModel} will be created for
+ * instances of {@code MultiPixelPackedSampleModel}. The colormap
+ * will be a grayscale ramp with 1 << numberOfBits
* entries ranging from zero to at most 255.
ColorModel that is suitable for
- * the supplied SampleModel, or null.
+ * @return An instance of {@code ColorModel} that is suitable for
+ * the supplied {@code SampleModel}, or {@code null}.
*
- * @throws IllegalArgumentException If sampleModel is
- * null.
+ * @throws IllegalArgumentException If {@code sampleModel} is
+ * {@code null}.
*/
public static final ColorModel createColorModel(SampleModel sampleModel) {
// Check the parameter.
@@ -242,19 +242,19 @@
}
/**
- * For the case of binary data (isBinary() returns
- * true), return the binary data as a packed byte array.
+ * For the case of binary data ({@code isBinary()} returns
+ * {@code true}), return the binary data as a packed byte array.
* The data will be packed as eight bits per byte with no bit offset,
* i.e., the first bit in each image line will be the left-most of the
* first byte of the line. The line stride in bytes will be
- * (int)((getWidth()+7)/8). The length of the returned
- * array will be the line stride multiplied by getHeight()
+ * {@code (int)((getWidth()+7)/8)}. The length of the returned
+ * array will be the line stride multiplied by {@code getHeight()}
*
* @return the binary data as a packed array of bytes with zero offset
- * of null if the data are not binary.
- * @throws IllegalArgumentException if isBinary() returns
- * false with the SampleModel of the
- * supplied Raster as argument.
+ * of {@code null} if the data are not binary.
+ * @throws IllegalArgumentException if {@code isBinary()} returns
+ * {@code false} with the {@code SampleModel} of the
+ * supplied {@code Raster} as argument.
*/
public static byte[] getPackedBinaryData(Raster raster,
Rectangle rect) {
@@ -435,11 +435,11 @@
/**
* Returns the binary data unpacked into an array of bytes.
- * The line stride will be the width of the Raster.
+ * The line stride will be the width of the {@code Raster}.
*
- * @throws IllegalArgumentException if isBinary() returns
- * false with the SampleModel of the
- * supplied Raster as argument.
+ * @throws IllegalArgumentException if {@code isBinary()} returns
+ * {@code false} with the {@code SampleModel} of the
+ * supplied {@code Raster} as argument.
*/
public static byte[] getUnpackedBinaryData(Raster raster,
Rectangle rect) {
@@ -515,13 +515,13 @@
}
/**
- * Sets the supplied Raster's data from an array
+ * Sets the supplied {@code Raster}'s data from an array
* of packed binary data of the form returned by
- * getPackedBinaryData().
+ * {@code getPackedBinaryData()}.
*
- * @throws IllegalArgumentException if isBinary() returns
- * false with the SampleModel of the
- * supplied Raster as argument.
+ * @throws IllegalArgumentException if {@code isBinary()} returns
+ * {@code false} with the {@code SampleModel} of the
+ * supplied {@code Raster} as argument.
*/
public static void setPackedBinaryData(byte[] binaryDataArray,
WritableRaster raster,
@@ -761,16 +761,16 @@
}
/**
- * Copies data into the packed array of the Raster
+ * Copies data into the packed array of the {@code Raster}
* from an array of unpacked data of the form returned by
- * getUnpackedBinaryData().
+ * {@code getUnpackedBinaryData()}.
*
* If the data are binary, then the target bit will be set if
* and only if the corresponding byte is non-zero.
*
- * @throws IllegalArgumentException if These classes are designed to be used while the
- * corresponding
* The class is public so it can be instantiated by UIDefaults.ProxyLazyValue.
@@ -520,7 +520,7 @@
}
/**
- * @return the These classes are designed to be used while the
- * corresponding
* Invoked when the user attempts an invalid operation,
- * such as pasting into an uneditable
@@ -1948,7 +1948,7 @@
* @param component Component the error occurred in, may be
* null indicating the error condition is
* not directly associated with a
- *
* This Action contains the information and logic to render an
- * auditory cue. The
- * This These classes are designed to be used while the
- * corresponding An application opening a synthesizer explicitly with this call
* has to close the synthesizer by calling {@link #close}. This is
@@ -77,13 +77,13 @@
*
* Note that some synthesizers, once closed, cannot be reopened.
* Attempts to reopen such a synthesizer will always result in
- * a An application opening a synthesizer explicitly with this call
* has to close the synthesizer by calling {@link #close}. This is
@@ -107,13 +107,13 @@
*
* Note that some synthesizers, once closed, cannot be reopened.
* Attempts to reopen such a synthesizer will always result in
- * a
- * The
- * Note: Many methods in If there is a security manager, its If there is a security manager, its {@code checkPermission}
* method is called with the
- *
- * then a call to
- * The
* This method always returns immediately, whether or not the image
@@ -278,10 +278,10 @@
}
/**
- * Returns an
* This method always returns immediately, whether or not the image
* exists. When this applet attempts to draw the image on the screen,
@@ -290,7 +290,7 @@
*
* @param url an absolute URL giving the base location of the image.
* @param name the location of the image, relative to the
- *
* This method always returns immediately, whether or not the audio
* clip exists. When this applet attempts to play the audio clip, the
@@ -331,8 +331,8 @@
}
/**
- * Returns the
* This method always returns immediately, whether or not the audio
* clip exists. When this applet attempts to play the audio clip, the
@@ -341,7 +341,7 @@
* @param url an absolute URL giving the base location of the
* audio clip.
* @param name the location of the audio clip, relative to the
- *
* The implementation of this method provided by the
- *
* Each element of the array should be a set of three
- *
* The implementation of this method provided by the
- *
- * A subclass of
* The implementation of this method provided by the
- *
- * A subclass of
- * Note: some methods, such as
* The implementation of this method provided by the
- *
- * A subclass of
* The implementation of this method provided by the
- *
- * A subclass of
* The implementation of this method provided by the
- *
- *
* The "virtual key" constants defined in
- *
* The "virtual key" constants defined in
- *
- * This method obtains the keyChar from a
- * The following table lists all the possible
* This is a very useful mechanism for avoiding deadlocks. If
* a thread is executing in a critical section (i.e., it has entered
* one or more monitors), calling other synchronized code may
* cause deadlocks. To avoid the potential deadlocks, an
- *
- * For security reasons, it is often desirable to use an
* Calling this method does not fire an
- *
* This class extends the standard equations defined by Porter and
* Duff to include one additional factor.
- * An instance of the
- * The
* For performance reasons, it is preferable that
- *
* If integer math were being used and this value were being
* composited in
- *
- * The result is
- * In addition,
- * For compatibility with previous releases,
* Mixing both absolute and relative positioning constants can lead to
* unpredictable results. If
* you use both types, the relative constants will take precedence.
- * For example, if you add components using both the
* NOTE: Currently (in the Java 2 platform v1.2),
- *
* The components are laid out according to their
* preferred sizes and the constraints of the container's size.
- * The
* Here is an example of five buttons in an applet laid out using
- * the
*
*
* When a button is pressed and released, AWT sends an instance
- * of
* If an application wants to perform some action based on
* a button being pressed and released, it should implement
- *
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -384,17 +384,17 @@
/**
* Processes action events occurring on this button
* by dispatching them to any registered
- *
* This method is not called unless action events are
* enabled for this button. Action events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -412,11 +412,11 @@
}
/**
- * Returns a string representing the state of this
- * An application must subclass the
- * Most applications that subclass
- * This method is called in response to a call to
* The ordering of cards is determined by the container's own internal
- * ordering of its component objects.
- * Each component in the
@@ -55,14 +55,14 @@
*
- * The button labeled
* Alternatively, several check boxes can be grouped together under
* the control of a single object, using the
- * Note that this method should be primarily used to
* initialize the state of the checkbox. Programmatically
* setting the state of the checkbox will not trigger
- * an
- * If the state of this check box is
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -552,17 +552,17 @@
/**
* Processes item events occurring on this check box by
* dispatching them to any registered
- *
* This method is not called unless item events are
* enabled for this component. Item events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -581,11 +581,11 @@
}
/**
- * Returns a string representing the state of this
* The following picture depicts a menu which contains an instance
- * of
*
- * The item labeled
* When a check box menu item is selected, AWT sends an item event to
- * the item. Since the event is an instance of Note that this method should be primarily used to
* initialize the state of the check box menu item.
* Programmatically setting the state of the check box
* menu item will not trigger
- * an
- * You can specify the
* Check box menu items currently support only item events.
- * Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -361,17 +361,17 @@
/**
* Processes item events occurring on this check box menu item by
- * dispatching them to any registered
* This method is not called unless item events are
* enabled for this menu item. Item events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -403,11 +403,11 @@
/**
* Returns a string representing the state of this
- *
* This class implements accessibility support for the
- *
* The following code example produces a pop-up menu:
@@ -54,17 +54,17 @@
*
- * In the picture,
* Some native platforms do not support arbitrary resizing of
- *
* By default, the first item added to the choice menu becomes the
* selected item, until a different selection is made by the user
- * by calling one of the
- * Adds an item to this
* If the item is the first one being added to the choice,
* then the item becomes selected. Otherwise, if the
@@ -266,7 +266,7 @@
* item in the choice becomes the selected item. If the
* selected item was no among those shifted, it remains
* the selected item.
- * @param item the non- Note that this method should be primarily used to
* initially select an item in this component.
* Programmatically calling this method will not trigger
- * an Note that this method should be primarily used to
* initially select an item in this component.
* Programmatically calling this method will not trigger
- * an Refer to AWT Threading Issues for details on AWT's threading model.
@@ -492,8 +492,8 @@
/**
* Removes the specified item listener so that it no longer receives
- * item events from this Refer to AWT Threading Issues for details on AWT's threading model.
@@ -515,7 +515,7 @@
* Returns an array of all the item listeners
* registered on this choice.
*
- * @return all of this choice's
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -607,19 +607,19 @@
}
/**
- * Processes item events occurring on this
* This method is not called unless item events are
* enabled for this component. Item events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -638,13 +638,13 @@
}
/**
- * Returns a string representing the state of this
* The default color space for the Java 2D(tm) API is sRGB, a proposed
@@ -210,11 +210,11 @@
int value;
/**
- * The color value in the default sRGB
* This method applies an arbitrary scale factor to each of the three RGB
- * components of this
* This method applies an arbitrary scale factor to each of the three RGB
- * components of this
- * The result is
* The argument is treated as the name of a system property to
* be obtained. The string value of this property is then interpreted
- * as an integer which is then converted to a
* If the specified property is not found or could not be parsed as
- * an integer then
* The first argument is treated as the name of a system property to
* be obtained. The string value of this property is then interpreted
- * as an integer which is then converted to a
* If the specified property is not found or cannot be parsed as
- * an integer then the
* The first argument is treated as the name of a system property to
* be obtained. The string value of this property is then interpreted
- * as an integer which is then converted to a
* If the specified property is not found or could not be parsed as
- * an integer then the integer value
- * The
- * The integer that is returned by
- * If the
- * The
- * The
* Because of possible rounding errors it is recommended
@@ -988,11 +988,11 @@
}
/**
- * Constructs a new component. Class
- * For
* Sometimes the exact mouse coordinates are not important, and the only thing
- * that matters is whether a specific Note: Disabling a lightweight component does not prevent it from
@@ -1484,7 +1484,7 @@
* in this container from receiving any input events. But disabling a
* lightweight container affects only this container.
*
- * @param b If
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
*
- * @param b if
* Due to the asynchronous nature of native event handling, this
* method can return outdated values (for instance, after several calls
- * of
* This method changes layout-related information, and therefore,
@@ -2136,7 +2136,7 @@
* top-left corner in the parent's coordinate space
*
* @deprecated As of JDK version 1.1,
- * replaced by
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
@@ -2168,12 +2168,12 @@
/**
* Returns the size of this component in the form of a
- *
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
@@ -2220,7 +2220,7 @@
* @param width the new width of the component
* @param height the new height of the component
* @deprecated As of JDK version 1.1,
- * replaced by
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
@@ -2255,7 +2255,7 @@
*
* @param d the new size of this component
* @deprecated As of JDK version 1.1,
- * replaced by
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
*
* @param x the new x-coordinate of this component
* @param y the new y-coordinate of this component
- * @param width the new
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
@@ -2468,8 +2468,8 @@
/**
* Returns the current x coordinate of the components origin.
* This method is preferable to writing
- *
- * This method will always return
* The default implementation returns -1. Subclasses that support
* baseline should override appropriately. If a value >= 0 is
* returned, then the component has a valid baseline for any
- * size >= the minimum size and
* The default implementation returns
- *
* The method may have no visual effect if the Java platform
* implementation and/or the native system do not support
* changing the mouse cursor shape.
* @param cursor One of the constants defined
- * by the
- * For performance reasons,
@@ -3288,21 +3288,21 @@
* Updates this component.
*
* If this component is not a lightweight component, the
- * AWT calls the
- * The
* The origin of the graphics context, its
- * (
* The origin of the graphics context, its
- * (
* If this component is a lightweight component, this method
- * causes a call to this component's
* Note: For more information on the paint mechanisms utilitized
@@ -3383,8 +3383,8 @@
/**
* Repaints the component. If this component is a lightweight
- * component, this results in a call to
* Note: For more information on the paint mechanisms utilitized
* by AWT and Swing, including information on how to write the most
@@ -3404,9 +3404,9 @@
* Repaints the specified rectangle of this component.
*
* If this component is a lightweight component, this method
- * causes a call to this component's
* Note: For more information on the paint mechanisms utilitized
* by AWT and Swing, including information on how to write the most
@@ -3426,12 +3426,12 @@
/**
* Repaints the specified rectangle of this component within
- *
* If this component is a lightweight component, this method causes
- * a call to this component's
* Note: For more information on the paint mechanisms utilitized
* by AWT and Swing, including information on how to write the most
@@ -3489,10 +3489,10 @@
* printed or should be printed differently than they are painted.
*
* The default implementation of this method calls the
- *
* The origin of the graphics context, its
- * (
* The origin of the graphics context, its
- * (
- * The
- * If the system property
* Also, if incremental drawing is in effect, the value of the
- * system property
- * The interpretation of the
* This method does not cause the image to begin loading. An
- * application must use the
* Information on the flags returned by this method can be found
- * with the discussion of the
* This method does not cause the image to begin loading. An
- * application must use the
- * The
* Information on the flags returned by this method can be found
- * with the discussion of the
* Each time this method
- * is called,
- * The Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5309,7 +5309,7 @@
* receives component events from this component. This method performs
* no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5331,7 +5331,7 @@
* Returns an array of all the component listeners
* registered on this component.
*
- * @return all Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5377,7 +5377,7 @@
* receives focus events from this component. This method performs
* no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5400,7 +5400,7 @@
* Returns an array of all the focus listeners
* registered on this component.
*
- * @return all of this component's Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5454,7 +5454,7 @@
* receives hierarchy changed events from this component. This method
* performs no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5491,7 +5491,7 @@
* Returns an array of all the hierarchy listeners
* registered on this component.
*
- * @return all of this component's Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5547,7 +5547,7 @@
* receives hierarchy bounds events from this component. This method
* performs no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5653,7 +5653,7 @@
* Returns an array of all the hierarchy bounds listeners
* registered on this component.
*
- * @return all of this component's Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5732,7 +5732,7 @@
* Returns an array of all the key listeners
* registered on this component.
*
- * @return all of this component's Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5778,7 +5778,7 @@
* receives mouse events from this component. This method performs
* no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5801,7 +5801,7 @@
* Returns an array of all the mouse listeners
* registered on this component.
*
- * @return all of this component's Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5847,7 +5847,7 @@
* receives mouse motion events from this component. This method performs
* no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5870,7 +5870,7 @@
* Returns an array of all the mouse motion listeners
* registered on this component.
*
- * @return all of this component's
- * If l is Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5943,7 +5943,7 @@
* Returns an array of all the mouse wheel listeners
* registered on this component.
*
- * @return all of this component's Refer to AWT Threading Issues for details on AWT's threading model.
@@ -5987,7 +5987,7 @@
* receives input method events from this component. This method performs
* no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -6010,7 +6010,7 @@
* Returns an array of all the input method listeners
* registered on this component.
*
- * @return all of this component's
- * You can specify the
* This method only needs to be invoked by subclasses of
- *
- * This implementation of Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6403,17 +6403,17 @@
/**
* Processes component events occurring on this component by
* dispatching them to any registered
- *
* This method is not called unless component events are
* enabled for this component. Component events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6448,33 +6448,33 @@
/**
* Processes focus events occurring on this component by
* dispatching them to any registered
- *
* This method is not called unless focus events are
* enabled for this component. Focus events are enabled
* when one of the following occurs:
*
- * If focus events are enabled for a
- * If focus events are enabled for a
+ * If focus events are enabled for a {@code Component}, calling
+ * the {@code Component}'s {@code dispatchEvent} method
+ * with a {@code FocusEvent} as the argument will result in a
+ * call to the {@code Component}'s {@code processFocusEvent}
+ * method regardless of the current {@code KeyboardFocusManager}.
*
- * Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6505,39 +6505,39 @@
/**
* Processes key events occurring on this component by
* dispatching them to any registered
- *
* This method is not called unless key events are
* enabled for this component. Key events are enabled
* when one of the following occurs:
*
- * If key events are enabled for a
- * As of J2SE 1.4,
- * Calling a If the event parameter is If the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6574,17 +6574,17 @@
/**
* Processes mouse events occurring on this component by
* dispatching them to any registered
- *
* This method is not called unless mouse events are
* enabled for this component. Mouse events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6622,17 +6622,17 @@
/**
* Processes mouse motion events occurring on this component by
* dispatching them to any registered
- *
* 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:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6661,21 +6661,21 @@
/**
* Processes mouse wheel events occurring on this component by
* dispatching them to any registered
- *
* 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:
*
* For information on how mouse wheel events are dispatched, see
* the class description for {@link MouseWheelEvent}.
*
- * Note that if the event parameter is
* 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:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6744,17 +6744,17 @@
/**
* Processes hierarchy events occurring on this component by
* dispatching them to any registered
- *
* This method is not called unless hierarchy events
* are enabled for this component. Hierarchy events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6780,17 +6780,17 @@
/**
* Processes hierarchy bounds events occurring on this component by
* dispatching them to any registered
- *
* 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:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6977,7 +6977,7 @@
}
/**
- * Makes this
* This method is called by the toolkit internally and should
* not be called directly by programs. Code overriding
- * this method should call
* If a Set of traversal keys has not been explicitly defined for this
* Component, then this Component's parent's Set is returned. If no Set
@@ -7443,15 +7443,15 @@
/**
* Returns whether the Set of focus traversal keys for the given focus
* traversal operation has been explicitly defined for this Component. If
- * this method returns
* This method cannot be used to set the focus owner to no Component at
- * all. Use
* Because the focus behavior of this method is platform-dependent,
* developers are strongly encouraged to use
- * Note: Not all focus transfers result from invoking this method. As
* such, a component may receive focus without this or any of the other
@@ -7554,9 +7554,9 @@
}
/**
- * Requests that this
- * This method returns a boolean value. If
* This method cannot be used to set the focus owner to no component at
- * all. Use
* Because the focus behavior of this method is platform-dependent,
* developers are strongly encouraged to use
- *
- * Every effort will be made to ensure that
- * This method returns a boolean value. If
* This method cannot be used to set the focus owner to no Component at
- * all. Use
* The focus behavior of this method can be implemented uniformly across
* platforms, and thus developers are strongly encouraged to use this
- * method over Note: Not all focus transfers result from invoking this method. As
* such, a component may receive focus without this or any of the other
* {@code requestFocus} methods of {@code Component} being invoked.
*
- * @return
- * This method returns a boolean value. If
* This method cannot be used to set the focus owner to no component at
- * all. Use
* The focus behavior of this method can be implemented uniformly across
* platforms, and thus developers are strongly encouraged to use this
- * method over
- * Every effort will be made to ensure that
- * If
- * If
- * If
* At construction time, a component's orientation is set to
- *
* To set the orientation of a single component, use this method.
* To set the orientation of an entire component
@@ -9012,8 +9012,8 @@
/**
* Retrieves the language-sensitive orientation that is to be used to order
- * the elements or text within this component.
* This method changes layout-related information, and therefore,
@@ -9036,7 +9036,7 @@
*
* @param orientation the new component orientation of this component and
* the components contained within it.
- * @exception NullPointerException if
* The method may have no visual effect if the Java platform
* implementation and/or the native system do not support
* changing the mouse cursor shape.
- * @param cursor the new
- * Instances of classes implementing
* Since this interface must expose the contents of pixels on the
* target device or image to potentially arbitrary code, the use of
* custom objects which implement this interface when rendering directly
- * to a screen device is governed by the
- * A
* This method is obsolete as of 1.1. Please use the
- * method
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy. If the container has already been
@@ -471,11 +471,11 @@
*
* @param comp the component to be added
* @param index the position at which to insert the component,
- * or
* This property is guaranteed to apply only to lightweight
- * non-
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
*
* Note: Not all platforms support changing the z-order of
* heavyweight components from one container into another without
- * the call to
* The constraints are
* defined by the particular layout manager being used. For
- * example, the
- * The
* If the current layout manager implements {@code LayoutManager2}, then
* {@link LayoutManager2#addLayoutComponent(Component,Object)} is invoked on
@@ -1061,7 +1061,7 @@
* usually include a call to the superclass's version of the method:
*
*
* This method changes layout-related information, and therefore,
@@ -1073,7 +1073,7 @@
* @param constraints an object expressing layout constraints
* for this component
* @param index the position in the container's list at which to
- * insert the component, where
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy. If the container has already been
@@ -1263,7 +1263,7 @@
* Removes the specified component from this container.
* This method also notifies the layout manager to remove the
* component from this container's layout via the
- *
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy. If the container has already been
@@ -1292,7 +1292,7 @@
* Removes all the components from this container.
* This method also notifies the layout manager to remove the
* components from this container's layout via the
- *
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy. If the container has already been
@@ -1512,7 +1512,7 @@
/**
* Causes this container to lay out its components. Most programs
* should not call this method directly, but should invoke
- * the
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -2267,10 +2267,10 @@
* following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -2365,11 +2365,11 @@
* controllable behaviors. This method searches for the top-most
* descendant of this container that contains the given coordinates
* and is accepted by the given filter. The search will be constrained to
- * lightweight descendants if the last argument is
* The immediate children of the container are printed with
- * an indentation of
* The immediate children of the container are printed with
- * an indentation of
* If a Set of traversal keys has not been explicitly defined for this
* Container, then this Container's parent's Set is returned. If no Set
@@ -3188,16 +3188,16 @@
/**
* Returns whether the Set of focus traversal keys for the given focus
* traversal operation has been explicitly defined for this Container. If
- * this method returns
* This method changes layout-related information, and therefore,
@@ -3557,7 +3557,7 @@
*
* @param o the new component orientation of this container and
* the components contained within it.
- * @exception NullPointerException if
* By default, ContainerOrderFocusTraversalPolicy implicitly transfers focus
* down-cycle. That is, during normal forward focus traversal, the Component
* traversed after a focus cycle root will be the focus-cycle-root's default
* Component to focus. This behavior can be disabled using the
- *
* By default, methods of this class will return a Component only if it is
* visible, displayable, enabled, and focusable. Subclasses can modify this
- * behavior by overriding the
* This policy takes into account focus traversal
@@ -193,7 +193,7 @@
* focus down-cycle. That is, during normal forward focus traversal, the
* Component traversed after a focus cycle root will be the focus-cycle-
* root's default Component to focus. This behavior can be disabled using
- * the
* If aContainer is focus
* traversal policy provider, the focus is always transferred down-cycle.
@@ -519,7 +519,7 @@
* Returns the default Component to focus. This Component will be the first
* to receive focus when traversing down into a new focus traversal cycle
* rooted at aContainer. The default implementation of this method
- * returns the same Component as
* If client code has explicitly set the focusability of a Component by either
- * overriding
- * In all cases, this method returns A
* Warning: To avoid deadlock, do not declare this method
* synchronized in a subclass.
*
* @exception EmptyStackException if no previous push was made
- * on this
* Since it is a modal dialog, when the application calls
- * its
* Note: Some platforms may not support
* showing the user-specified title in a file dialog.
@@ -192,7 +192,7 @@
* Creates a file dialog window with the specified title for loading
* a file. The files shown are those in the current directory.
* This is a convenience method for
- *
* Note: Some platforms may not support
* showing the user-specified title in a file dialog.
@@ -211,10 +211,10 @@
* Creates a file dialog window with the specified title for loading
* or saving a file.
*
- * If the value of
* Note: Some platforms may not support
@@ -226,7 +226,7 @@
* @param parent the owner of the dialog
* @param title the title of the dialog
* @param mode the mode of the dialog; either
- *
* Note: Some platforms may not support
* showing the user-specified title in a file dialog.
@@ -250,13 +250,13 @@
* displayed.
*
* @param parent the owner of the dialog
- * @exception java.lang.IllegalArgumentException if the
* Note: Some platforms may not support
* showing the user-specified title in a file dialog.
@@ -277,16 +277,16 @@
* displayed.
*
* @param parent the owner of the dialog
- * @param title the title of the dialog; a
- * If the value of
* Note: Some platforms may not support
@@ -311,20 +311,20 @@
* displayed.
*
* @param parent the owner of the dialog
- * @param title the title of the dialog; a
* Specifying "" as the directory is exactly equivalent to
- * specifying
* The value of the alignment argument must be one of
- *
* A glyph is a shape used to render a character or a sequence of
@@ -135,46 +135,46 @@
*
*
* There are three different names that you can get from a
- *
- * The
* The {@link GraphicsEnvironment#getAllFonts() getAllFonts} method
- * of the {@code Font} supports most
+ * {@code TextAttribute}s. This makes some operations, such as
* rendering underlined text, convenient since it is not
- * necessary to explicitly construct a The values of some The values of some {@code TextAttributes} are not
* serializable, and therefore attempting to serialize an instance of
- * Clients who create custom subclasses of Clients who create custom subclasses of {@code Paint} and
+ * {@code GraphicAttribute} can make them serializable and
* 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.
*
- * The The {@code Map}-based constructor and
+ * {@code deriveFont} APIs ignore the FONT attribute, and it is
* not retained by the Font; the static {@link #getFont} method should
* be used if the FONT attribute might be present. See {@link
* java.awt.font.TextAttribute#FONT} for more information. Several attributes will cause additional rendering overhead
- * and potentially invoke layout. If a
* The font name can be a font face name or a font family name.
@@ -518,7 +518,7 @@
* name is specified, the face's style and the style argument are
* merged to locate the best matching font from the same family.
* For example if face name "Arial Bold" is specified with style
- *
* If no face for the requested style can be found, the font system
* may apply algorithmic styling to achieve the desired style.
- * For example, if
* Font name lookup is case insensitive, using the case folding
* rules of the US locale.
*
- * If the
- * If
- * To make the
- * To make the
* Typically, fonts will not be transformed. Clients generally
* should call {@link #isTransformed} first, and only call this
- * method if The family name of a font is font specific. Two fonts such as
* Helvetica Italic and Helvetica Bold have the same family name,
@@ -1172,10 +1172,10 @@
* available family names may be obtained by using the
* {@link GraphicsEnvironment#getAvailableFontFamilyNames()} method.
*
- * Use Use {@code getName} to get the logical name of the font.
+ * Use {@code getFontName} to get the font face name of the font.
+ * @return a {@code String} that is the family name of this
+ * {@code Font}.
*
* @see #getName
* @see #getFontName
@@ -1194,7 +1194,7 @@
}
/**
- * Returns the family name of this The family name of a font is font specific. Two fonts such as
@@ -1204,9 +1204,9 @@
* available family names may be obtained by using the
* {@link GraphicsEnvironment#getAvailableFontFamilyNames()} method.
*
- * Use Use {@code getFontName} to get the font face name of the font.
* @param l locale for which to get the family name
- * @return a
* A valid trailing decimal field is always interpreted as the pointsize.
@@ -1456,32 +1456,32 @@
* as valid fields with the default value for that field.
*
* Some font names may include the separator characters ' ' or '-'.
- * If
* The default size is 12 and the default style is PLAIN.
- * If
* The property value should be one of the forms accepted by
- * Note: This method cannot handle supplementary
* characters. To support all Unicode characters, including
* supplementary characters, use the {@link #canDisplay(int)}
- * method or Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.Font class notes}).
- * @param str the specified Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.Font class notes}).
- * @param str the specified Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.Font class notes}).
* @param chars an array of characters
* @param beginIndex the initial offset in the array of
* characters
* @param limit the end offset in the array of characters
- * @param frc the specified Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.Font class notes}).
- * @param ci the specified Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.Font class notes}).
- * @param frc the specified
* Layout requires bidi analysis, as performed by
- *
* All other values for the flags parameter are reserved.
*
- * @param frc the specified
@@ -76,11 +76,11 @@
* maximum ascent of any character in the array. The descent is the
* maximum descent of any character in the array. The advance width
* is the sum of the advance widths of each of the characters in the
- * character array. The advance of a Note that the advance of a Note that the advance of a {@code String} is not necessarily
* the sum of the advances of its characters measured in isolation
* because the width of a character can vary depending on its context.
* For example, in Arabic text, the shape of a character can change
@@ -125,10 +125,10 @@
private static final long serialVersionUID = 1681126225205050147L;
/**
- * Creates a new
- * Note that methods in this class which take a This method doesn't validate the specified character to be a
@@ -289,8 +289,8 @@
*
* @param codePoint the character (Unicode code point) to be measured
* @return the advance width of the specified character
- * in the Note: This method cannot handle Font
- * Note that the advance of a Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.FontMetrics class notes}).
- * @param str the specified Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.FontMetrics class notes}).
- * @param str the specified Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.FontMetrics class notes}).
* @param chars an array of characters
* @param beginIndex the initial offset of the array of
* characters
* @param limit the end offset of the array of characters
- * @param context the specified Note: The returned bounds is in baseline-relative coordinates
* (see {@link java.awt.FontMetrics class notes}).
- * @param ci the specified
* The size of the frame includes any area designated for the
* border. The dimensions of the border area may be obtained
- * using the
- * The default layout for a frame is
- * A frame may have its native decorations (i.e.
- * In a multi-screen environment, you can create a
* In a virtual device multi-screen environment in which the desktop
@@ -87,22 +87,22 @@
* shows (0,0) coords while a different physical screen shows (-80,-100) coords."
* style="float:center; margin: 7px 10px;">
*
- * In such an environment, when calling
* The following code sets the
- * location of the
* Frames are capable of generating the following types of
- * Note that if the state is not supported on a
* given platform, neither the state nor the return
@@ -780,11 +780,11 @@
* expanded and frame state is represented as a bitwise mask.
*
* For compatibility with old programs this method still returns
- *
- * If
* Note, the given maximized bounds are used as a hint for the native
* system, because the underlying platform may not support setting the
@@ -874,10 +874,10 @@
/**
* Gets maximized bounds for this frame.
- * Some fields may contain
* Note: To obtain a list of all ownerless windows, including
* ownerless {@code Dialog}s (introduced in release 1.6), use {@link
@@ -1164,7 +1164,7 @@
*/
/**
- *
- * A
* All coordinates that appear as arguments to the methods of this
- *
* All rendering operations modify only pixels which lie within the
* area bounded by the current clip, which is specified by a {@link Shape}
* in user space and is controlled by the program using the
- *
- * Since
* Beginning with Java 1.1, the background color
* of offscreen images may be system dependent. Applications should
- * use
* The oval covers an area that is
*
- * The resulting arc begins at
* The center of the arc is the center of the rectangle whose origin
* is (x, y) and whose size is specified by the
- *
* The resulting arc covers an area
*
- * The resulting arc begins at
* The center of the arc is the center of the rectangle whose origin
* is (x, y) and whose size is specified by the
- *
* The resulting arc covers an area
*
- * This method draws the polygon defined by
- * This method draws the polygon defined by
* The area inside the polygon is defined using an
* even-odd fill rule, also known as the alternating rule.
- * @param xPoints a an array of
* If the image has completely loaded and its pixels are
* no longer being changed, then
- *
* A scaled version of an image will not necessarily be
* available immediately just because an unscaled version of the
@@ -906,15 +906,15 @@
* the image may be cached separately and generated from the original
* data in a separate image production sequence.
* @param img the specified image to be drawn. This method does
- * nothing if
* If the image has completely loaded and its pixels are
* no longer being changed, then
- *
@@ -991,7 +991,7 @@
* the image may be cached separately and generated from the original
* data in a separate image production sequence.
* @param img the specified image to be drawn. This method does
- * nothing if
@@ -1035,7 +1035,7 @@
* mapped to the second destination coordinate. The subimage is
* scaled and flipped as needed to preserve those mappings.
* @param img the specified image to be drawn. This method does
- * nothing if
@@ -1094,7 +1094,7 @@
* mapped to the second destination coordinate. The subimage is
* scaled and flipped as needed to preserve those mappings.
* @param img the specified image to be drawn. This method does
- * nothing if
- * When a Java program runs, a large number of
* Graphics objects which are provided as arguments to the
- *
* Coordinates in device space usually refer to individual device pixels
* and are aligned on the infinitely thin gaps between these pixels.
- * Some
* Some of the operations performed by the rendering attribute objects
- * occur in the device space, but all
- * Every
- * When creating a
* The following two rules provide predictable rendering behavior whether
@@ -315,7 +315,7 @@
* covered. On the other hand, since coordinates are defined to be
* between pixels, a shape like a rectangle would have no half covered
* pixels, whether or not it is rendered using antialiasing.
- *
- * The
- * Rendering hints set on the If this If this {@code Graphics2D} context is drawing to a
+ * {@code Component} on the display screen and the
+ * {@code Composite} is a custom object rather than an
+ * instance of the {@code AlphaComposite} class, and if
+ * there is a security manager, its {@code checkPermission}
+ * method is called with an {@code AWTPermission("readDisplayPixels")}
* permission.
* @throws SecurityException
- * if a custom To add a coordinate transform, use the
- *
* In a virtual device multi-screen environment in which the desktop
* area could span multiple physical screen devices, the bounds of the
- *
* To determine if your environment is a virtual device
- * environment, call
- * You can also use
* For a particular {@link Graphics2D}, g, one
@@ -375,27 +375,27 @@
* g.setTransform(gc.getDefaultTransform());
* g.transform(gc.getNormalizingTransform());
*
- * In a multi-screen environment, the
* A particular program might use more than one
- *
* Exclusive mode implies:
*
@@ -341,10 +341,10 @@
}
/**
- * Returns the
* This method provides for the application the most precise control
- * over which
* If a font in this environment has multiple programmable variations,
* such as Multiple-Master fonts, only one instance of that font is
- * returned in the
* Typical usage would be for presentation to a user for selection of
* a particular family name. An application can then specify this name
@@ -295,7 +295,7 @@
* italic, giving the font system flexibility in choosing its own best
* match among multiple fonts in the same font family.
*
- * @return an array of
* Typical usage would be for presentation to a user for selection of
* a particular family name. An application can then specify this name
@@ -317,10 +317,10 @@
*
* @param l a {@link Locale} object that represents a
* particular geographical, political, or cultural region.
- * Specifying
* Reasons that this method might not register the font and therefore
- * return
* To get the usable bounds of a single display, use
- *
- * The default value is
- * The default value is
- * Use
- *
- * Use
- *
* The grid bag layout manager calculates the weight of a column to
- * be the maximum
- * The default value of this field is
* The grid bag layout manager calculates the weight of a row to be
- * the maximum
- * The default value of this field is
- * The following values are valid for
- * The default value is
- * The default value is
- * The default value is
* The default value is 0.
* @serial
@@ -537,14 +537,14 @@
int tempHeight;
/**
* The minimum width of the component. It is used to calculate
- *
- * Each component managed by a
@@ -52,8 +52,8 @@
* increasing downward.
*
* To use a grid bag layout effectively, you must customize one or more
- * of the
@@ -206,12 +206,12 @@
*
* This layout consists of three components:
*
- * Each of the ten components has the
- * If
* If the
* Most applications do not call this method directly.
*
* @param parent the container in which to do the layout
* @see java.awt.Container#getPreferredSize
- * @return the preferred size of the
* Most applications do not call this method directly.
* @param parent the container in which to do the layout
* @see java.awt.Container#doLayout
- * @return the minimum size of the
* Most applications do not call this method directly.
@@ -890,7 +890,7 @@
*/
/**
- * Fills in an instance of
* This method should only be used internally by
- *
* Individual property names are defined by the various image
* formats. If a property is not defined for a particular image, this
- * method returns the
* If the properties for this image are not yet known, this method
- * returns
- * The property name
*
- * If either
- * If an implementation of this method returns
- * If an implementation of this method returns
* This method does not actually set the focus to the specified Component.
* It merely stores the value to be subsequently returned by
- *
* If a SecurityManager is installed, the calling thread must be granted
@@ -729,9 +729,9 @@
*
* This method does not actually set the focus to the specified Component.
* It merely stores the value to be subsequently returned by
- *
* This method does not actually change the focused Window as far as the
* native windowing system is concerned. It merely stores the value to be
- * subsequently returned by
* This method does not actually change the active Window as far as the
* native windowing system is concerned. It merely stores the value to be
- * subsequently returned by
@@ -1714,7 +1714,7 @@
* Removes a KeyEventDispatcher which was previously added to this
* KeyboardFocusManager's dispatcher chain. This KeyboardFocusManager
* cannot itself be removed, unless it was explicitly re-registered via a
- * call to
* If a null dispatcher is specified, if the specified dispatcher is not
* in the dispatcher chain, or if this KeyboardFocusManager is specified
@@ -1744,7 +1744,7 @@
* Returns this KeyboardFocusManager's KeyEventDispatcher chain as a List.
* The List will not include this KeyboardFocusManager unless it was
* explicitly re-registered via a call to
- *
* If a null post-processor is specified, if the specified post-processor
@@ -1835,7 +1835,7 @@
/**
* Returns this KeyboardFocusManager's KeyEventPostProcessor chain as a
* List. The List will not include this KeyboardFocusManager unless it was
- * explicitly added via a call to
* This method is intended to be used only by KeyboardFocusManagers and
* KeyEventDispatchers. It is not for general client use.
@@ -1960,30 +1960,30 @@
}
/**
- * Typically this method will be called by
* Swing's painting architecture assumes the children of a
- *
@@ -57,7 +57,7 @@
* cnt.add(lst);
*
- * where
*
* Note that the list in the example shown was created with four visible
* rows. Once the list has been created, the number of visible rows
- * cannot be changed. A default
* Beginning with Java 1.1, the Abstract Window Toolkit
- * sends the
* When an item is selected or deselected by the user, AWT sends an instance
- * of
* If an application wants to perform some action based on an item
* in this list being selected or activated by the user, it should implement
- *
@@ -119,7 +119,7 @@
/**
* This field will represent the number of visible rows in the
- * Note that this method should be primarily used to
* initially select an item in this component.
* Programmatically calling this method will not trigger
- * an Refer to AWT Threading Issues for details on AWT's threading model.
@@ -910,7 +910,7 @@
/**
* Removes the specified item listener so that it no longer
* receives item events from this list.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -933,7 +933,7 @@
* Returns an array of all the item listeners
* registered on this list.
*
- * @return all of this list's
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -977,7 +977,7 @@
* Removes the specified action listener so that it no longer
* receives action events from this list. Action events
* occur when a user double-clicks on a list item.
- * If listener Refer to AWT Threading Issues for details on AWT's threading model.
@@ -1000,7 +1000,7 @@
* Returns an array of all the action listeners
* registered on this list.
*
- * @return all of this list's
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -1113,17 +1113,17 @@
/**
* Processes item events occurring on this list by
* dispatching them to any registered
- *
* This method is not called unless item events are
* enabled for this component. Item events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -1144,17 +1144,17 @@
/**
* Processes action events occurring on this component
* by dispatching them to any registered
- *
* This method is not called unless action events are
* enabled for this component. Action events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -1209,7 +1209,7 @@
*/
/**
- * The
* To use a media tracker, create an instance of
- *
- * Here is an example of using
* If there is an error while loading or scaling an image, then that
* image is considered to have finished loading. Use the
- *
- * If the value of the
* If there is an error while loading or scaling an image, that
* image is considered to have finished loading. Use the
- *
* If there is an error while loading or scaling an image, then that
* image is considered to have finished loading. Use the
- *
* If there is an error while loading or scaling an image, then
* that image is considered to have finished loading. Use the
- *
* Possible flags defined by the
- *
- * If the value of
* If there is an error while loading or scaling an image, then that
* image is considered to have finished loading. Use the
- *
- * If the value of the
* If there is an error while loading or scaling an image, then that
* image is considered to have finished loading. Use the
- *
* If there is an error while loading or scaling an image, then that
* image is considered to have finished loading. Use the
- *
* If there is an error while loading or scaling an image, then that
* image is considered to have finished loading. Use the
- *
* Possible flags defined by the
- *
- * If the value of
* A menu can optionally be a tear-off menu. A tear-off menu
@@ -45,10 +45,10 @@
* On platforms that do not support tear-off menus, the tear-off
* property is ignored.
*
- * Each item in a menu must belong to the
* This class implements accessibility support for the
- *
*
* This is what a menu bar might look like:
@@ -52,8 +52,8 @@
* (Keyboard shortcuts, which are optional, provide the user with
* an alternative to the mouse for invoking a menu item and the
* action that is associated with it.)
- * Each menu item can maintain an instance of
* This class implements accessibility support for the
- *
* Menu components receive and process AWT events, just as components do,
- * through the method
* Some platforms may not support setting of all font attributes
- * of a menu component; in such cases, calling Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -397,10 +397,10 @@
/**
* Returns a string representing the state of this
- *
* The method may have no visual effect if the Java platform
* implementation and/or the native system do not support
* changing the mouse cursor shape.
- * @param cursor the new Note that the index represents the i-th selected child, which
* is different from the i-th child.
*
@@ -987,7 +987,7 @@
* @return true if the current child of this object is selected;
* else false
* @param i the zero-based index of the child in this
- *
- * The default
* This picture of a menu bar shows five menu items:
@@ -45,24 +45,24 @@
* style="float:center; margin: 7px 10px;">
*
* When a menu item is selected, AWT sends an action event to
* the menu item. Since the event is an
- * instance of
- * Note that the subclass
* Since event types are automatically enabled when a listener for
* that type is added to the menu item, this method only needs
- * to be invoked by subclasses of
- * You can specify the
* Currently, menu items only support action events.
- * Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -654,16 +654,16 @@
/**
* Processes action events occurring on this menu item,
* by dispatching them to any registered
- * Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -681,11 +681,11 @@
}
/**
- * Returns a string representing the state of this
* This class implements accessibility support for the
- *
* Menu shortcuts are created using virtual keycodes, not characters.
* For example, a menu shortcut for Ctrl-a (assuming that Control is
* the accelerator key) would be created with code like the following:
*
- * or alternatively
*
- *
* Menu shortcuts may also be constructed for a wider set of keycodes
- * using the
*
- * Note that shortcuts created with a keycode or an extended keycode defined as a constant in
* The accelerator key is platform-dependent and may be obtained
@@ -128,8 +128,8 @@
/**
* Returns whether this MenuShortcut must be invoked using the SHIFT key.
- * @return
- * If there is a security manager, its
- * Instances of classes implementing
* The default layout manager for a panel is the
- *
* This method is included for completeness, to parallel the
- *
* If an operation that calculates the bounding box of this
- *
- * As the inheritance hierarchy implies, a
- * If this
- * A
* Note that the actual maximum value of the scroll bar is the
- *
* When the user changes the value of the scroll bar, the scroll bar
- * receives an instance of
* Any object that wishes to be notified of changes to the
* scroll bar's value should implement
- *
- * The
- * Note: We recommend using a
- * The
- * The
* The parameters supplied to this constructor are subject to the
@@ -395,7 +395,7 @@
* @param minimum the minimum value of the scroll bar
* @param maximum the maximum value of the scroll bar
* @exception IllegalArgumentException when an illegal value for
- * the
- * If the value supplied is less than the current
* Normally, a program should change a scroll bar's
- * value only by calling
* Calling this method does not fire an
- *
- * When
* Normally, a program should change a scroll bar's minimum
- * value only by calling
- * Note that setting the minimum value to
- * When
* Normally, a program should change a scroll bar's maximum
- * value only by calling
- * Note that setting the maximum value to
- * If the visible amount supplied is less than
* Normally, a program should change a scroll bar's
- * value only by calling
@@ -869,18 +869,18 @@
* of four scroll bar properties, assuring that the values of
* these properties are mutually consistent. It enforces the
* following constraints:
- *
* Calling this method does not fire an
- * Refer to AWT Threading Issues for details on AWT's threading model.
@@ -1001,8 +1001,8 @@
/**
* Removes the specified adjustment listener so that it no longer
- * receives instances of Refer to AWT Threading Issues for details on AWT's threading model.
@@ -1025,7 +1025,7 @@
* Returns an array of all the adjustment listeners
* registered on this scrollbar.
*
- * @return all of this scrollbar's
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -1116,17 +1116,17 @@
/**
* Processes adjustment events occurring on this
* scrollbar by dispatching them to any registered
- *
* This method is not called unless adjustment events are
* enabled for this component. Adjustment events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -1145,11 +1145,11 @@
}
/**
- * Returns a string representing the state of this
* Definition of insideness:
* A point is considered to lie inside a
- * The The {@code contains} and {@code intersects} methods
+ * consider the interior of a {@code Shape} to be the area it
* encloses as if it were filled. This means that these methods
* consider
* unclosed shapes to be implicitly closed for the purpose of
@@ -78,14 +78,14 @@
public interface Shape {
/**
* Returns an integer {@link Rectangle} that completely encloses the
- *
* {@code bounds.contains(x,y)} does not imply {@code shape.contains(x,y)}
*
@@ -159,8 +159,8 @@
*
* {@code bounds.contains(p)} does not imply {@code shape.contains(p)}
*
* The {@code Shape.intersects()} method allows a {@code Shape}
* implementation to conservatively return {@code true} when:
*
* The {@code Shape.contains()} method allows a {@code Shape}
* implementation to conservatively return {@code false} when:
*
- * Each call to this method returns a fresh
* It is recommended, but not guaranteed, that objects
- * implementing the
* Only SEG_MOVETO, SEG_LINETO, and SEG_CLOSE point types are
* returned by the iterator.
*
- * If an optional
* The amount of subdivision of the curved segments is controlled
- * by the
- * Each call to this method returns a fresh
* It is recommended, but not guaranteed, that objects
- * implementing the
* The pixel (0, 0) in the coordinate space of the graphics context
@@ -402,7 +402,7 @@
/**
* The instance reference for the singleton.
- * (
- * The methods of the
- * The objects of the classes implementing
* Note that the way in which these system colors are applied to GUI objects
* may vary slightly from platform to platform since GUI objects may be
* rendered differently on each platform.
*
- * System color values may also be available through the The The {@code SystemTray} may contain one or more {@link
* TrayIcon TrayIcons}, which are added to the tray using the {@link
* #add} method, and removed when no longer needed, using the
- * {@link #remove}. Every Java application has a single Every Java application has a single {@code SystemTray}
* instance that allows the app to interface with the system tray of
- * the desktop while the app is running. The The following code snippet demonstrates how to access
* and customize the system tray:
@@ -141,7 +141,7 @@
}
/**
- * Private Note: When implementing Note: When implementing {@code SystemTray} and
+ * {@code TrayIcon} it is strongly recommended that
* you assign different gestures to the popup menu and an action
* event. Overloading a gesture for both purposes is confusing
* and may prevent the user from accessing one or the other.
*
* @see #getSystemTray
- * @return All icons added by the application are automatically
- * removed from the All icons added by the application are automatically
- * removed from the If If {@code trayIcon} is {@code null} or was not
* added to the system tray, no exception is thrown and no action
* is performed.
*
- * @param trayIcon the The returned array is a copy of the actual array and may be
* modified in any way without affecting the system tray. To
- * remove a
@@ -56,7 +56,7 @@
public class TextArea extends TextComponent {
/**
- * The number of rows in the
- * The Note that passing Note that passing {@code null} or inconsistent
* parameters is invalid and will result in unspecified
* behavior.
*
- * @param str the non- Note that passing Note that passing {@code null} or inconsistent
* parameters is invalid and will result in unspecified
* behavior.
*
- * @param str the non- Note that passing Note that passing {@code null} or inconsistent
* parameters is invalid and will result in unspecified
* behavior.
*
- * @param str the non-
- * The
* A text component embodies a string of text. The
- *
- * If the flag is set to
@@ -437,10 +437,10 @@
* start position, it is reset to the start position.
*
* @param selectionStart the zero-based index of the first
- character ( Refer to AWT Threading Issues for details on AWT's threading model.
@@ -568,7 +568,7 @@
/**
* Removes the specified text event listener so that it no longer
* receives text events from this text component
- * If Refer to AWT Threading Issues for details on AWT's threading model.
@@ -590,7 +590,7 @@
* Returns an array of all the text listeners
* registered on this text component.
*
- * @return all of this text component's
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -678,17 +678,17 @@
/**
* Processes text events occurring on this text component by
- * dispatching them to any registered
* NOTE: This method will not be called unless text events
* are enabled for this component. This happens when one of the
* following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -709,11 +709,11 @@
/**
* Returns a string representing the state of this
- *
* For example, the following image depicts a frame with four
* text fields of varying widths. Two of these text fields
- * display the predefined text
*
* Every time the user types a key in the text field, one or
- * more key events are sent to the text field. A
- * The key event is passed to every
- * It is also possible to fire an
- * The
* A Java platform implementation may support only a limited,
@@ -252,7 +252,7 @@
* An echo character is useful for text fields where
* user input should not be echoed to the screen, as in
* the case of a text field for entering a password.
- * Setting
* A Java platform implementation may support only a limited,
@@ -277,7 +277,7 @@
* @param c the echo character for this text field
*
* @deprecated As of JDK version 1.1,
- * replaced by
- * You can specify the Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -607,17 +607,17 @@
/**
* Processes action events occurring on this text field by
* dispatching them to any registered
- *
* This method is not called unless action events are
* enabled for this component. Action events are enabled
* when one of the following occurs:
* Note that if the event parameter is Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -635,11 +635,11 @@
}
/**
- * Returns a string representing the state of this
* Many GUI events may be delivered to user
@@ -82,8 +82,8 @@
* limited to:
*
* Most applications should not call any of the methods in this
- * class directly. The methods defined by
- *
* This toolkit method is called by the
- *
* Since the mechanism required to facilitate this sharing of
- *
* This method first checks if there is a security manager installed.
* If so, the method calls the security manager's
- *
* Since the mechanism required to facilitate this sharing of
- *
* This method first checks if there is a security manager installed.
* If so, the method calls the security manager's
- *
* This method first checks if there is a security manager installed.
* If so, the method calls the security manager's
- *
* This method first checks if there is a security manager installed.
* If so, the method calls the security manager's
- *
* If the values of the width and height arguments are both
- *
@@ -730,23 +730,23 @@
* and an appropriately scaled screen representation of the image is
* generated.
*
- * This method is called by components
* Information on the flags returned by this method can be found
- * with the definition of the
* If the values of the width and height arguments are both
- *
* This method does not cause the image to begin loading.
- * An application must call
- * This method is called by the component's
* Information on the flags returned by this method can be found
- * with the definition of the
* Each actual implementation of this method should first check if there
* is a security manager installed. If there is, the method should call
- * the security manager's
* Each actual implementation of this method should first check if there
* is a security manager installed. If there is, the method should call
- * the security manager's
* In addition to any and all default formats text returned by the system
- * Clipboard's
* Each actual implementation of this method should first check if there
@@ -990,37 +990,37 @@
/**
* Gets the singleton instance of the system selection as a
- *
* An application is responsible for updating the system selection whenever
* the user selects text, using either the mouse or the keyboard.
* Typically, this is implemented by installing a
- *
- * Some platforms do not support a system selection
* Each actual implementation of this method should first check if there
* is a security manager installed. If there is, the method should call
* the security manager's {@link SecurityManager#checkPermission
* checkPermission} method to check {@code AWTPermission("accessClipboard")}.
*
- * @return the system selection as a
* Menu shortcuts, which are embodied in the
- *
- * By default, this method returns Note that supporting a given concept is a platform-
@@ -1280,11 +1280,11 @@
*
- * First, if there is a security manager, its
- *
* Note: event listener use is not recommended for normal
* application use, but are intended solely to support special
@@ -1761,7 +1761,7 @@
* @param eventMask the bitmask of event types to receive
* @throws SecurityException
* if a security manager exists and its
- *
- * First, if there is a security manager, its
* Note: event listener use is not recommended for normal
@@ -1830,7 +1830,7 @@
* @param listener the event listener.
* @throws SecurityException
* if a security manager exists and its
- * A A {@code TrayIcon} can generate various {@link MouseEvent
* MouseEvents} and supports adding corresponding listeners to receive
- * notification of these events. Note: When the Note: When the {@code MouseEvent} is
+ * dispatched to its registered listeners its {@code component}
+ * property will be set to {@code null}. (See {@link
* java.awt.event.ComponentEvent#getComponent}) The
- * Note: A well-behaved {@link TrayIcon} implementation
* will assign different gestures to showing a popup menu and
* selecting a tray icon.
*
- * A A {@code TrayIcon} can generate an {@link ActionEvent
* ActionEvent}. On some platforms, this occurs when the user selects
* the tray icon using either the mouse or keyboard.
*
@@ -71,7 +71,7 @@
* SecurityException.
*
* See the {@link SystemTray} class overview for an example on how
- * to use the Calling this method with the same image that is currently
* being used has no effect.
*
- * @throws NullPointerException if Note that this Note that this {@code popup} must not be added to any
* parent before or after it is set on the tray icon. If you add
- * it to some parent, the The {@code popup} can be set on one {@code TrayIcon} only.
@@ -295,7 +295,7 @@
*
* @throws IllegalArgumentException if the {@code popup} is already
* set for another {@code TrayIcon}
- * @param popup a If auto-size is If auto-size is {@code false}, and the image size
* doesn't match the tray icon space, the image is painted as-is
* inside that space — if larger than the allocated space, it will
* be cropped.
*
- * If auto-size is If auto-size is {@code true}, the image is stretched or shrunk to
* fit the tray icon space.
*
- * @param autosize Note: The {@code MouseEvent}'s coordinates (received
* from the {@code TrayIcon}) are relative to the screen, not the
* {@code TrayIcon}.
*
- * Note: The Note: The {@code MOUSE_ENTERED} and
+ * {@code MOUSE_EXITED} mouse events are not supported.
* Refer to AWT Threading Issues for details on AWT's threading model.
*
@@ -427,7 +427,7 @@
/**
* Removes the specified mouse listener. Calling this method with
- * Refer to AWT Threading Issues for details on AWT's threading model.
*
@@ -446,10 +446,10 @@
/**
* Returns an array of all the mouse listeners
- * registered on this Note: The {@code MouseEvent}'s coordinates (received
* from the {@code TrayIcon}) are relative to the screen, not the
* {@code TrayIcon}.
*
- * Note: The Note: The {@code MOUSE_DRAGGED} mouse event is not supported.
* Refer to AWT Threading Issues for details on AWT's threading model.
*
@@ -488,7 +488,7 @@
/**
* Removes the specified mouse-motion listener. Calling this method with
- * Refer to AWT Threading Issues for details on AWT's threading model.
*
@@ -507,10 +507,10 @@
/**
* Returns an array of all the mouse-motion listeners
- * registered on this Calling this method with a Calling this method with a {@code null} value has no
* effect.
* Refer to AWT Threading Issues for details on AWT's threading model.
@@ -574,7 +574,7 @@
/**
* Removes the specified action listener. Calling this method with
- * Refer to AWT Threading Issues for details on AWT's threading model.
*
@@ -594,10 +594,10 @@
/**
* Returns an array of all the action listeners
- * registered on this Either the caption or the text may be Either the caption or the text may be {@code null}, but an
+ * {@code NullPointerException} is thrown if both are
+ * {@code null}.
*
* When displayed, the caption or text strings may be truncated on
* some platforms; the number of characters that may be displayed is
@@ -645,12 +645,12 @@
* showing a message.
*
* @param caption the caption displayed above the text, usually in
- * bold; may be
- * The
- * The
* If the string is recognized as a constant name for
--- old/src/java.desktop/share/classes/java/awt/color/ICC_ProfileRGB.java 2015-10-04 22:53:11.061272920 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ICC_ProfileRGB.java 2015-10-04 22:53:10.873272928 +0400
@@ -45,13 +45,13 @@
* that represents profiles which meet the following criteria:
*
@@ -109,7 +109,7 @@
/**
- * Constructs an new
* This matrix can be used for color transforms in the forward
* direction of the profile--from the profile color space
* to the CIEXYZ PCS.
*
- * @return A 3x3
- * If a GUI control is both an active
* An autoscrolling gesture is initiated by the user by keeping the drag
- * cursor motionless with a border region of the
- * This value is read once by the
- * The appropriate
- * Once the
- * Once the
- * When a concrete
- * This method is used by a
* The initial interpretation of the user's gesture,
* and the subsequent starting of the drag operation
* are the responsibility of the implementing
- *
* When a drag gesture occurs, the
- *
* The startDrag() method invokes the
* createDragSourceContext() method to
* instantiate an appropriate
- *
* If the Drag and Drop System is
* unable to initiate a drag operation for
* some reason, the startDrag() method throws
- * a
- * To incorporate a new
- * If
- * If
- * If the system property
- * Extend this class to create a
* Create a listener object using the extended class and then register it with
- * a
- * The drop site is associated with the previous
- * Note that the
@@ -97,28 +97,28 @@
// used by updateCurrentCursor
/**
- * An
- * The
- * Target drop action is one of
* User drop action depends on the drop actions supported by the drag
@@ -52,18 +52,18 @@
* Shift -> ACTION_MOVE
*
* If the user selects a drop action, the user drop action is one of
- *
* If the user doesn't select a drop action, the set of
- *
- * The arguments
- * The arguments
- * If the
- * If the
- * The argument
- * The argument
- *
* In a multi-screen environment without a virtual device, the cursor location is
* specified in the coordinate system of the initiator
- *
* In a multi-screen environment with a virtual device, the location is specified
* in the corresponding virtual coordinate system. If the cursor location is
@@ -62,7 +62,7 @@
private static final long serialVersionUID = -763287114604032641L;
/**
- * The
- * The drop site is associated with the previous
* The class that is interested in processing mouse motion events during
* a drag operation either implements this interface or extends the abstract
- *
* Create a listener object using that class and then register it with
- * a
* Each
- *
* The Component will receive drops only if it is enabled.
- * @param c The
* The Component will receive drops only if it is enabled.
- * @param c The
* The Component will receive drops only if it is enabled.
- * @param c The
* The Component will receive drops only if it is enabled.
- * @param c The
* The Component will receive drops only if it is enabled.
- * @param c The new
* This method itself does not throw any exception
* for null parameter but for exceptions thrown by
* the respective method of the listener.
*
- * @param dte the
- * Extend this class to create a
* Create a listener object using the extended class and then register it with
- * a
- * The operable part of the drop site for the
* During the drag, the data associated with the current drag operation can be
- * retrieved by calling
- * Note that
- * The
- * Source drop actions is a bitwise mask of
@@ -54,18 +54,18 @@
* Shift -> ACTION_MOVE
*
* If the user selects a drop action, the user drop action is one of
- *
* If the user doesn't select a drop action, the set of
- *
- * The
- * Source drop actions is a bitwise mask of
@@ -53,18 +53,18 @@
* Shift -> ACTION_MOVE
*
* If the user selects a drop action, the user drop action is one of
- *
* If the user doesn't select a drop action, the set of
- *
* Create a listener object by implementing the interface and then register it
- * with a
- * The operable part of the drop site for the
* During the drag, the data associated with the current drag operation can be
- * retrieved by calling
- * Note that
* This method is responsible for undertaking
* the transfer of the data associated with the
- * gesture. The
- * From this method, the
* Subsequent to acceptDrop(), but not before,
- *
* At the completion of a drop, an implementation
* of this method is required to signal the success/failure
* of the drop by passing an appropriate
- *
* Note: The data transfer should be completed before the call to the
- *
- * Note: To invoke an
- * The object that implements the
* This method throws an
- *
* This method throws an
- *
* This method throws an
- *
- * Note that if a This method throws an
- * This method throws an
- *
- * Extend this class to create a
* Create a listener object using your class and then register it with a
- * component using the component's
* This low-level event is generated by a component object (such as a
* List) when the component is moved, resized, rendered invisible, or made
- * visible again. The event is passed to every
* An unspecified behavior will be caused if the {@code id} parameter
* of any particular {@code ComponentEvent} instance is not
@@ -103,16 +103,16 @@
private static final long serialVersionUID = 8101406823902992965L;
/**
- * Constructs a This method throws an
- *
* Component events are provided for notification purposes ONLY;
* The AWT will automatically handle component moves and resizes
* internally so that GUI layout works properly regardless of
- * whether a program registers a
- * Extend this class to create a
* Create a listener object using the extended class and then register it with
- * a component using the component's
* This low-level event is generated by a container object (such as a
* Panel) when a component is added to it or removed from it.
- * The event is passed to every
* An unspecified behavior will be caused if the {@code id} parameter
* of any particular {@code ContainerEvent} instance is not
@@ -95,18 +95,18 @@
private static final long serialVersionUID = -4114942250539772041L;
/**
- * Constructs a This method throws an
- *
* Container events are provided for notification purposes ONLY;
* The AWT will automatically handle add and remove operations
--- old/src/java.desktop/share/classes/java/awt/event/FocusAdapter.java 2015-10-04 22:53:28.249272148 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/FocusAdapter.java 2015-10-04 22:53:28.061272156 +0400
@@ -30,17 +30,17 @@
* The methods in this class are empty. This class exists as
* convenience for creating listener objects.
*
- * Extend this class to create a
* Create a listener object using the extended class and then register it with
- * a component using the component's
* There are two levels of focus events: permanent and temporary. Permanent
@@ -114,30 +114,30 @@
private static final long serialVersionUID = 523753786457416396L;
/**
- * Constructs a This method throws an
- * This method throws an
- * This method throws an
- *
* Extend this class and override the method for the event of interest. (If
- * you implement the
* Create a listener object using your class and then register it with a
- * Component using the Component's
* Hierarchy events are provided for notification purposes ONLY;
* The AWT will automatically handle changes to the hierarchy internally so
* that GUI layout works properly regardless of whether a
- * program registers an
* An unspecified behavior will be caused if the {@code id} parameter
* of any particular {@code HierarchyEvent} instance is not
@@ -122,20 +122,20 @@
public static final int HIERARCHY_LAST = ANCESTOR_RESIZED;
/**
- * A change flag indicates that the This method throws an
- * This method throws an
- *
* Hierarchy events are provided for notification purposes ONLY;
* The AWT will automatically handle changes to the hierarchy internally so
* that GUI layout, displayability, and visibility work properly regardless
- * of whether a program registers a This method throws an
- *
* It is not recommended to compare the return value of this method
- * using
* Note that passing negative parameter is incorrect,
* and will cause the returning an unspecified string.
--- old/src/java.desktop/share/classes/java/awt/event/InputMethodEvent.java 2015-10-04 22:53:32.461271959 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/InputMethodEvent.java 2015-10-04 22:53:32.257271968 +0400
@@ -106,45 +106,45 @@
private transient TextHitInfo visiblePosition;
/**
- * Constructs an
* The offsets of caret and visiblePosition are relative to the current
- * composed text; that is, the composed text within Note that passing in an invalid Note that passing in an invalid {@code id} results in
* unspecified behavior. This method throws an
- *
* The offsets of caret and visiblePosition are relative to the current
- * composed text; that is, the composed text within Note that passing in an invalid Note that passing in an invalid {@code id} results in
* unspecified behavior. This method throws an
- *
- * The offsets of Note that passing in an invalid Note that passing in an invalid {@code id} results in
* unspecified behavior. This method throws an
- *
* The offset of the caret is relative to the current
* composed text; that is, the composed text within getText()
- * if this is an
* The offset of the visible position is relative to the current
* composed text; that is, the composed text within getText()
- * if this is an
- * The object that implements the This method throws an
- *
- * Extend this class to create a
* Create a listener object using the extended class and then register it with
- * a component using the component's
* This low-level event is generated by a component object (such as a text
* field) when a key is pressed, released, or typed.
- * The event is passed to every
* "Key typed" events are higher-level and generally do not depend on
* the platform or keyboard layout. They are generated when a Unicode character
@@ -974,7 +974,7 @@
/**
* A constant indicating that the keyLocation is indeterminate
* or not relevant.
- * This method throws an
- * This method throws an
- *
- *
* NOTE: use of this method is not recommended, because many AWT
* implementations do not recognize modifier changes. This is
- * especially true for
- * Note that
* The listener object created from that class is then registered with a
- * component using the component's
* The class that is interested in processing a mouse event
* either implements this interface (and all the methods it
- * contains) or extends the abstract
* The listener object created from that class is then registered with a
- * component using the component's
- * Extend this class to create a
* Create a listener object using the extended class and then register it with
- * a component using the component's
* The class that is interested in processing a mouse motion event
* either implements this interface (and all the methods it
- * contains) or extends the abstract
* The listener object created from that class is then registered with a
- * component using the component's
* Due to platform-dependent Drag&Drop implementations,
- *
- * A MouseWheelEvent object is passed to every
* Due to the mouse wheel's special relationship to scrolling Components,
* MouseWheelEvents are delivered somewhat differently than other MouseEvents.
@@ -77,11 +77,11 @@
* platform settings can be changed at any time by the user. MouseWheelEvents
* reflect the most recent settings.
*
- * The Absolute coordinates xAbs and yAbs are set to source's location on screen plus
* relative coordinates x and y. xAbs and yAbs are set to zero if the source is not showing.
- * Note that passing in an invalid Note that passing in an invalid {@code id} results in
* unspecified behavior. This method throws an
- * Note that passing in an invalid Note that passing in an invalid {@code id} results in
* unspecified behavior. This method throws an
- *
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
* Even if inconsistent values for relative and absolute coordinates are
* passed to the constructor, the MouseWheelEvent instance is still
* created and no exception is thrown.
*
- * @param source the Note that passing in an invalid Note that passing in an invalid {@code id} parameter results
* in unspecified behavior. This method throws an
- * Even if inconsistent values for relative and absolute coordinates
- * are passed to the constructor, a
* This method returns the number of units to scroll when scroll type is
* MouseWheelEvent.WHEEL_UNIT_SCROLL, and should only be called if
- *
* Direction of scroll, amount of wheel movement,
* and platform settings for wheel scrolling are all accounted for.
--- old/src/java.desktop/share/classes/java/awt/event/MouseWheelListener.java 2015-10-04 22:53:38.465271689 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseWheelListener.java 2015-10-04 22:53:38.277271698 +0400
@@ -29,16 +29,16 @@
/**
* The listener interface for receiving mouse wheel events on a component.
- * (For clicks and other mouse events, use the
* The class that is interested in processing a mouse wheel event
* implements this interface (and all the methods it contains).
*
* The listener object created from that class is then registered with a
- * component using the component's
* For information on how mouse wheel events are dispatched, see
--- old/src/java.desktop/share/classes/java/awt/event/PaintEvent.java 2015-10-04 22:53:38.989271666 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/PaintEvent.java 2015-10-04 22:53:38.797271674 +0400
@@ -84,18 +84,18 @@
private static final long serialVersionUID = 1267492026433337593L;
/**
- * Constructs a This method throws an
- *
- * The object that implements the
@@ -74,17 +74,17 @@
private static final long serialVersionUID = 6269902291250941179L;
/**
- * Constructs a This method throws an
- *
- * Extend this class to create a
* Create a listener object using the extended class and then register it with
- * a Window using the window's
- * The event is passed to every
* An unspecified behavior will be caused if the {@code id} parameter
* of any particular {@code WindowEvent} instance is not
@@ -176,23 +176,23 @@
/**
- * Constructs a This method throws an
- * This method throws an
- * This method throws an
- * This method throws an
- *
* The class that is interested in processing a window state event
* either implements this interface (and all the methods it contains)
- * or extends the abstract
* The listener object created from that class is then registered with
- * a window using the
-* Typically, instances of
* To specify other hint values, use the constructor which
* specifies the rendering hint values as parameters :
* {@link #FontRenderContext(AffineTransform, Object, Object)}.
* @param tx the transform which is used to scale typographical points
- * to pixels in this
* Weight is the overall 'weight' of the glyph in the line. Generally it is
@@ -67,7 +67,7 @@
* Limit determines the maximum or minimum amount by which the glyph can
* change. Left and right sides of the glyph can have different limits.
*
- * Each
* Glyphs are either STANDARD, LIGATURE, COMBINING, or COMPONENT.
*
- * Other metrics available through
- * Glyphs for a rotated font, or obtained from a
* The advance of a glyph is the distance from the glyph's origin to the
* origin of the next glyph along the baseline, which is either vertical
- * or horizontal. Note that, in a
@@ -88,13 +88,13 @@
* affected when rendering the glyph, because of rasterization and pixel
* adjustment effects.
*
- * Although instances of
* Example:
- * Querying a
- * The
- * Instances of
* In a text processing application that can cache intermediate
* representations of text, creation and subsequent caching of a
- *
- * A
- * For each glyph in the
- * Altering the data used to create the
* Methods are provided to adjust the positions of the glyphs
- * within the
* Methods are provided to transform individual glyphs within the
- *
* Methods are provided to return both the visual, logical, and pixel bounds
- * of the entire
* Methods are provided to return a {@link Shape} for the
- *
- * The
* Subclasses must ensure that their objects are immutable once they
- * are constructed. Mutating a
- *
* Segments of text are obtained by calling the method
- *
- *
- * The
* In general, if the text used to construct the
- *
@@ -255,21 +255,21 @@
private CharArrayIterator charIter;
/**
- * Constructs a
* Fonts can have different metrics for different ranges of
-* characters. The
- * Instances of
@@ -290,11 +290,11 @@
*
* For service formatted print data, the Java Print Service instance
* determines the print data format. The doc flavor's representation class
- * denotes an interface whose methods the
* A Java Print Service instance is allowed to support any other doc flavors
@@ -390,7 +390,7 @@
*
* Class DocFlavor in package javax.print.data is similar to class
* {@link java.awt.datatransfer.DataFlavor DataFlavor}. Class
- *
* Special rules applied:
*
* Note that some doc flavors may not be supported in combination
- * with all attributes. Use
* Note that some doc flavors may not be supported in combination
- * with all attributes. Use
* Some categories may not be supported in a particular context (ie
- * for a particular
* This is a convenience method to determine if the category
* would be a member of the result of
- *
* Some attributes may not be supported in a particular context (ie
- * for a particular
* Not all attributes have a default value. For example the
- * service will not have a defaultvalue for
- * If
- * If the
- *
* This method returns an Object because different printing attribute
@@ -321,7 +321,7 @@
* containing the legal values -- used, for example, by an attribute with
* a list of enumerated values. The type of the array is an array of the
* specified attribute category type as returned by its
- *
- * If
* Also if DocFlavor is not null it must be a flavor supported by this
* PrintService, else IllegalArgumentException will be thrown.
*
- *
* This is a convenience method to determine if the value
* would be a member of the result of
- *
- *
* If the return value is non-null, all attributes in the returned
@@ -428,7 +428,7 @@
* to select the attribute(s) to be identified as the cause of the
* conflict.
*
- * Use This method is useful to help locate a service that can print
- * a
* If the print data is a stream, or a print job requests data as a
- * stream, then
- * Note that a
- * Applications can use a
- * Whereas a
* Note: This method is intended to provide a default, nonlocalized
* string for the attribute's category. If two attribute objects return the
- * same category from the
- * Under the hood, a date-time attribute is stored as a value of class
* To construct a date-time attribute from separate values of the year, month,
- * day, hour, minute, and so on, use a
* You can convert an enumeration value to a string by calling {@link
* #toString() toString()}. The string is obtained from a table
@@ -97,8 +97,8 @@
* You can define a subclass of an enumeration class that extends it with
* additional enumeration values. The subclass's enumeration values' integer
* values need not be distinct from the superclass's enumeration values' integer
- * values; the
* If an attribute implements {@link DocAttribute DocAttribute}
* as well as PrintRequestAttribute, the client may include the
- * attribute in a
* You can also construct an instance of SetOfIntegerSyntax by giving it in
* "array form." Array form consists of an array of zero or more integer groups
* where each integer group is a length-1 or length-2 array of
- *
* In both string form and array form, each successive integer group gives a
* range of integers to be included in the set. The first integer in each group
@@ -68,7 +67,7 @@
* array form." This is the same as array form, except there are no null ranges;
* the members of the set are represented in as few ranges as possible (i.e.,
* overlapping ranges are coalesced); the ranges appear in ascending order; and
- * each range is always represented as a length-two array of
@@ -98,7 +97,7 @@
* constructed.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if
- * For class Chromaticity, the category name is
* IPP Compatibility: The IPP boolean value is "true" for SUPPORTED and
* "false" for NOT_SUPPORTED. The category name returned by
- *
- * For class ColorSupported, the category name is
* IPP Compatibility: The category name returned by
- *
* For class Compression and any vendor-defined subclasses, the category
- * name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
- * For class Copies, the category name is
* For class CopiesSupported, the category
- * name is
* IPP Compatibility: The information needed to construct an IPP
* "date-time-at-completed" attribute can be obtained as described above. The
- * category name returned by
* For class DateTimeAtCompleted, the category name is
- *
* IPP Compatibility: The information needed to construct an IPP
* "date-time-at-creation" attribute can be obtained as described above. The
- * category name returned by
* For class DateTimeAtCreation, the category name is
- *
* IPP Compatibility: The information needed to construct an IPP
* "date-time-at-processing" attribute can be obtained as described above. The
- * category name returned by
* For class DateTimeAtProcessing, the category name is
- *
@@ -64,7 +64,7 @@
* @param uri URI.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if
- * For class Destination, the category name is
* For class DialogTypeSelection the category name is
- *
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
- * For class DocumentName, the category name is
* IPP Compatibility: The IPP boolean value is "true" for FIDELITY_TRUE
* and "false" for FIDELITY_FALSE. The category name returned by
- *
* For class Fidelity the category name is
- *
* For class Finishings and any vendor-defined subclasses, the
- * category name is
- * For class JobHoldUntil, the category name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class JobImpressions, the category name is
- *
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class JobImpressionsCompleted, the category name is
- *
* For class JobImpressionsSupported, the category name is
- *
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
- * For class JobKOctets, the category name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class JobKOctetsProcessed, the category name is
- *
* For class JobKOctetsSupported, the category name is
- *
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class JobMediaSheets and any vendor-defined subclasses, the
- * category name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class JobMediaSheetsCompleted, the category name is
- *
* For class JobMediaSheetsSupported, the
- * category name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class JobMessageFromOperator, the
- * category name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
- * For class JobName, the category name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class JobOriginatingUserName, the
- * category name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
- * For class JobPriority, the category name is
* IPP Compatibility: The integer value gives the IPP integer value.
- * The category name returned by
* For class JobPrioritySupported, the
- * category name is
* IPP Compatibility: The category name returned by
- *
* For class JobSheets and any vendor-defined subclasses, the category
- * name is
* IPP Compatibility: The category name returned by
- *
* For class JobState and any vendor-defined subclasses, the category
- * name is
* IPP Compatibility: The category name returned by
- *
* For class JobStateReason and any vendor-defined subclasses, the
- * category name is
* IPP Compatibility: The category name returned by
- *
* For class Media and any vendor-defined subclasses, the category name is
- *
@@ -236,16 +236,16 @@
* To be equivalent, all of the following conditions must be true:
*
* For class MediaPrintableArea,
- * the category name is This is not an IPP V1.1 attribute.
*
* @return Attribute category name.
@@ -295,7 +295,7 @@
* Unit conversion factor, e.g. {@link #INCH INCH} or
* {@link #MM MM}.
* @param unitsName
- * Units name string, e.g.
* For class MediaSize and any vendor-defined subclasses, the category
- * name is
- * In the detailed explanations below, if "
* The standard MultipleDocumentHandling values are:
*
* Note: None of these values provide means to produce uncollated
@@ -150,8 +150,8 @@
* To specify that, see the {@link SheetCollate SheetCollate} attribute.
*
* IPP Compatibility: The category name returned by
- *
* For class MultipleDocumentHandling and any vendor-defined subclasses,
- * the category name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class NumberOfDocuments, the
- * category name is
* IPP Compatibility: The integer value gives the IPP integer value.
- * The category name returned by
* For class NumberOfInterveningJobs, the
- * category name is
- * For class NumberUp, the category name is
* For class NumberUpSupported, the
- * category name is
- * For some document formats (such as
* IPP Compatibility: The category name returned by
- *
* For class OrientationRequested, the
- * category name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class OutputDeviceAssigned, the
- * category name is
* IPP Compatibility: The category name returned by
- *
* For class PDLOverrideSupported and any vendor-defined subclasses, the
- * category name is
* If a PageRanges attribute is not specified for a print job, all pages of
* the document will be printed. In other words, the default value for the
- * PageRanges attribute is always
* The effect of a PageRanges attribute on a multidoc print job (a job with
* multiple documents) depends on whether all the docs have the same page ranges
@@ -99,7 +99,7 @@
* and IPP "page-ranges" attribute. See class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of canonical array form. The category name returned by
- *
- * For class PageRanges, the category name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class PagesPerMinute, the
- * category name is
* IPP Compatibility: The integer value gives the IPP integer value. The
- * category name returned by
* For class PagesPerMinuteColor, the
- * category name is
* For class PresentationDirection
- * the category name is
* IPP Compatibility: The category name returned by
- *
* For class PrintQuality and any vendor-defined subclasses, the category
- * name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
- * For class PrinterInfo, the category name is
* IPP Compatibility: The IPP boolean value is "true" for ACCEPTING_JOBS
* and "false" for NOT_ACCEPTING_JOBS. The category name returned by
- *
* For class PrinterIsAcceptingJobs, the
- * category name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class PrinterLocation, the
- * category name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class PrinterMakeAndModel, the
- * category name is
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class PrinterMessageFromOperator,
- * the category name is
* IPP Compatibility: The string form returned by
- *
* For class PrinterMoreInfo, the
- * category name is
* IPP Compatibility: The string form returned by
- *
* For class PrinterMoreInfoManufacturer, the category name is
- *
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class PrinterName, the category
- * name is
* IPP Compatibility: The information needed to construct an IPP
- *
* For class PrinterResolution, the
- * category name is
* IPP Compatibility: The category name returned by
- *
- * For class PrinterState, the category name is
* IPP Compatibility:
* The string values returned by each individual {@link PrinterStateReason} and
- * associated {@link Severity} object's
* For class PrinterStateReason and any vendor-defined subclasses, the
- * category name is
* IPP Compatibility: This implements the
* IPP printer-uri attribute. The string form returned by
- *
* For class PrinterURI and any vendor-defined subclasses, the category
- * name is
* IPP Compatibility: The integer value gives the IPP integer value.
- * The category name returned by
* For class QueuedJobCount, the
- * category name is
* IPP Compatibility: The category name returned by
- *
* For class ReferenceUriSchemesSupported and any vendor-defined
* subclasses, the category name is
- *
* IPP Compatibility: The string value gives the IPP name value. The
* locale gives the IPP natural language. The category name returned by
- *
* For class RequestingUserName, the
- * category name is
* IPP Compatibility:
- *
- * For class Severit, the category name is
- * For class SheetCollate, the category name is
* IPP Compatibility: The category name returned by
- *
- * For class Sides, the category name is
* Warning:
* Serialized objects of this class will not be compatible with
@@ -50,7 +50,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * A
* Buttons can be configured, and to some degree controlled, by
*
* Some look and feels might not render the disabled selected Icon, in
* which case they will ignore this.
*
- * @return the
- * Setting the
* This method uses three other methods to set
- * and help track the
* Refer to the table at
- * Swing Components Supporting
* Warning: If you subclass this do not create an anonymous
* inner class. If you do the lifetime of the button will be tied to
- * that of the
* Some look and feels might not support
- * the
* This function may cause the component's opaque property to change.
*
@@ -1503,9 +1503,9 @@
}
/**
- * Gets the
* A mnemonic must correspond to a single key on the keyboard
- * and should be specified using one of the
* Warning:
* Serialized objects of this class will not be compatible with
@@ -1978,7 +1978,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * Overriding
@@ -2400,7 +2400,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
* Warning:
* Serialized objects of this class will not be compatible with
@@ -39,7 +39,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * You can specify the
- * In addition to the
* This interface can be added to an existing class or used to create an
- * adapter (typically, by subclassing
- * Note that
- * Many of Swing's components have an
* The following table describes the properties used by
- *
- *
- *
- * If the same
* This property differs from the others in that it is both read
* by the component and set by the component. For example,
- * if an
* Note: the value of this field is prefixed with 'Swing' to
- * avoid possible collisions with existing
* Note: the value of this field is prefixed with 'Swing' to
- * avoid possible collisions with existing
- * If the same
* Note: the value of this field is prefixed with 'Swing' to
- * avoid possible collisions with existing As with As with {@code InputMap} if you create a cycle, eg:
* In most instances, In most instances, {@code key} will be
+ * {@code action.getValue(NAME)}.
*
* @param key a key
* @param action a binding for {@code key}
@@ -114,8 +114,8 @@
}
/**
- * Returns the binding for
* This is a convenience method that ActionMap/InputMap and
* AbstractAction use to avoid having the same code in each class.
@@ -251,7 +251,7 @@
}
/*
- * Returns a clone of the
* When a BoundedRange model is used with a scrollbar the value
* specifies the origin of the scrollbar knob (aka the "thumb" or
--- old/src/java.desktop/share/classes/javax/swing/Box.java 2015-10-04 22:56:28.785264040 +0400
+++ new/src/java.desktop/share/classes/javax/swing/Box.java 2015-10-04 22:56:28.593264049 +0400
@@ -41,23 +41,23 @@
* even non-Box containers.
*
*
- * The
- * If you are implementing a
*
* To use glue,
- * call
- * A
* Initially, all buttons in the group are unselected.
@@ -60,7 +60,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
* In simple terms, pressing and releasing the mouse over a regular
- * button triggers the button and causes and
*
* Having this interface enables complex components (the client of the
- * editor) such as
*
* To use this interface, a developer creating a new editor can have the
* new component implement the interface. Or the developer can
* choose a wrapper based approach and provide a companion object which
- * implements the
* The selected item may not necessarily be managed by the underlying
- *
- * At most, one
- * You can specify the
* Warning:
* Serialized objects of this class will not be compatible with
@@ -40,7 +40,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * You can specify the This class provides a policy for the various JInternalFrame methods,
* it is not meant to be called directly rather the various JInternalFrame
@@ -83,8 +83,8 @@
/**
* Removes the frame, and, if necessary, the
- *
* Please see
*
--- old/src/java.desktop/share/classes/javax/swing/DefaultListCellRenderer.java 2015-10-04 22:56:36.189263708 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultListCellRenderer.java 2015-10-04 22:56:35.997263716 +0400
@@ -42,13 +42,13 @@
*
* Implementation Note:
* This class overrides
- *
* Warning:
@@ -45,7 +45,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * This method is identical to
- * Throws an
- * Throws an
- * Throws an
- * Throws an
- * Throws an
- * Throws an
- * Throws an
- * Throws an
- * You can specify the
- * This method can be used in the
- * Sorting is done based on the current
- * Sorting of each column is done by way of a
- * If you specify a
- * In addition to sorting,
* By default, rows are in unsorted order (the same as the model) and
- * every column is sortable. The default
* If the underlying model structure changes (the
- *
* If the underlying model structure changes (the
- *
- *
- *
* The maximum number of sort keys is enforced by
- *
- *
* This method triggers a sort.
*
@@ -561,7 +561,7 @@
/**
* Sorts and filters the rows in the view based on the sort keys
* of the columns currently being sorted and the filter, if any,
- * associated with this sorter. An empty
- *
- * You can specify the
* Please see
*
@@ -53,7 +53,7 @@
* specification is incompatible with the 1.4 focus APIs.
* The current FocusManager is no longer a property of the UI.
* Client code must query for the current FocusManager using
- *
- * If a
@@ -591,7 +591,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
* The following example has two text fields, with the first one expecting
* the string "pass" to be entered by the user. If that string is entered in
@@ -103,7 +103,7 @@
* of the argument's input.
*
* @param input the JComponent to verify
- * @return
- * The
- * Please see the
* Warning: Swing is not thread safe. For more
* information see java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see javax.swing.RootPaneContainer
@@ -107,9 +107,9 @@
protected JRootPane rootPane;
/**
- * If true then calls to
* This constructor sets the component's locale property to the value
- * returned by
* Buttons can be configured, and to some degree controlled, by
*
@@ -306,7 +306,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
* Buttons can be configured, and to some degree controlled, by
*
@@ -334,7 +334,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * Either
* Menu items can be configured, and to some degree controlled, by
*
@@ -293,7 +293,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
@@ -70,7 +70,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
*
@@ -366,14 +366,14 @@
* Some look and feels might not support automatic drag and drop;
* they will ignore this property. You can work around such
* look and feels by modifying the component
- * to directly call the
@@ -169,13 +169,13 @@
private boolean selectingItem = false;
/**
- * Creates a
* See the article Mixing Heavy and Light Components
* This method fires a property changed event.
*
- * @param aFlag if
* To display the selected item,
- *
- * If
* If this constitutes a change in the selected item,
- *
- *
* If the combo box is editable, then this value may not have been added
- * to the combo box with
* Warning:
@@ -729,7 +729,7 @@
/**
* Inserts an item into the item list at a given index.
- * This method works only if the
- *
- * The
* For all standard look and feels shipped with Java, the popup list
- * portion of combo box is implemented as a
* This method is public but should not be called by anything other than
@@ -972,7 +972,7 @@
}
/**
- * Notifies
* This method is public but should not be called by anything other than
@@ -993,7 +993,7 @@
}
/**
- * Notifies
* This method is public but should not be called by anything other than
@@ -1041,33 +1041,33 @@
private PropertyChangeListener actionPropertyChangeListener;
/**
- * Sets the
- * Setting the
* This method uses three other methods to set
- * and help track the
* Warning: If you subclass this do not create an anonymous
* inner class. If you do the lifetime of the combobox will be tied to
- * that of the
* Refer to the table at
- * Swing Components Supporting
* Warning:
@@ -1647,7 +1647,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * The
- *
@@ -160,7 +160,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
- * The default value for this is false, but some
* This is a bound property.
@@ -502,15 +502,15 @@
}
/**
- * Sets the
- * If
@@ -535,14 +535,14 @@
}
/**
- * Returns
- * Additionally
* If you override this in a subclass you should not make permanent
- * changes to the passed in
- * The passed in
* If you override this in a subclass you should not make permanent
- * changes to the passed in
* This method actually delegates the work of painting to three
- * protected methods:
* Alternatively, or for components that delegate painting to other objects,
* you can query during painting whether or not the component is in the
- * midst of a print operation. The
* This method sets the component's state such that the double buffer
* will not be used: painting will be done directly on the passed in
- *
* You can detect changes in the value of this property by listening for
* property change events on this component with name
- *
* Note: This method provides complimentary functionality to that provided
* by other high level Swing printing APIs. However, it deals strictly with
@@ -1287,7 +1287,7 @@
* full component, and the return value of this method can change multiple
* times during that operation. It is even possible for the component to be
* painted to the screen while the printing process is ongoing. In such a
- * case, the return value of this method is
- * Changes this
- * Overrides the default
- * Returns the
* Please see
*
@@ -1437,7 +1437,7 @@
* for more information.
*
* @param requestFocusEnabled indicates whether you want this
- *
* Please see
*
@@ -1455,8 +1455,8 @@
* a section in The Java Tutorial,
* for more information.
*
- * @return
* This method is intended for use by focus implementations. Client code
* should not use this method; instead, it should use
- *
* Although technically you can set the border on any object
- * that inherits from
* This is a bound property.
*
@@ -1814,7 +1814,7 @@
}
/**
- * Returns the border of this component or
* Register a new keyboard action.
- *
- * The
- * The
* If an action has already been registered for the receiving
* container, with the same charCode and the same modifiers,
- *
* Unregisters a keyboard action.
- * This will remove the binding from the
- * For Java 2 platform v1.3, a
- * This method calls into the
- * This method calls into the
- * Requests focus on this
* It is up to the look and feel to honor this property, some may
* choose to ignore it.
*
- * @param bg the desired background
- * The
- * The
* Moves and resizes this component.
*
@@ -4261,15 +4261,15 @@
/**
* Stores the bounds of this component into "return value"
- *
- * The default value of this property is false for
*
- * You can specify the
- * Calls
* This method will automatically be called on this component
* when a property value changes such that size, location, or
* internal layout of this component has been affected. This automatic
* updating differs from the AWT because programs generally no
- * longer need to invoke
* As each component is read in we keep track of the current set of
* root components here, in the roots vector. Note that there's only one
- *
- * This class is normally used as the parent of
* For further documentation and examples see
@@ -78,7 +78,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
@@ -619,7 +619,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
* This component uses implementations of the
- *
* By default, the following types of content are known:
@@ -62,14 +62,14 @@
*
@@ -78,27 +78,27 @@
*
* Some kinds of content may provide hyperlink support by generating
- * hyperlink events. The HTML
* There are multiple ways to get a character set mapping to happen
- * with
* This may load either synchronously or asynchronously
- * depending upon the document returned by the
* If the document is loaded synchronously, it will be
* filled in with the stream prior to being installed into
- * the editor with a call to
* If the document is loaded asynchronously, the document
* will be installed into the editor immediately using a
- * call to
* This method is expected to have the side effect of
* establishing the content type, and therefore setting the
- * appropriate
* If this the stream was an http connection, redirects
* will be followed and the resulting URL will be set as
- * the
* If there is a charset definition specified as a parameter
* of the content type specification, it will be used when
- * loading input streams using the associated
* NOTE: This has the side effect of changing the model,
- * because the
@@ -1081,7 +1081,7 @@
* be reimplemented to use the Java Activation
* Framework, for example.
*
- * @param type the non-
- * Once a prototype
* This is implemented to remove the contents of the current document,
* and replace them by parsing the given string using the current
- *
* By default this is not enabled; to enable
* it set the client {@link #putClientProperty property} with this name
- * to
* The default varies based on the look and feel;
* to enable it set the client {@link #putClientProperty property} with
- * this name to
@@ -1651,7 +1651,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
* Warning:
* Serialized objects of this class will not be compatible with
@@ -1706,7 +1706,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
*
@@ -434,7 +434,7 @@
* most look and feels begin a drag-and-drop operation
* whenever the user presses the mouse button over an item
* and then moves the mouse a few pixels.
- * Setting this property to
*
- * The
- * Once a
- * Value Description
- *
- * Alternatively, you could invoke
- *
- *
- *
- * If an
- * Warning: As the
* Warning: Swing is not thread safe. For more
* information see java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @since 1.4
@@ -184,8 +184,8 @@
/**
* Constant identifying that when focus is lost,
- *
- * This will throw an
* The default value of this property is
- *
- * If you have not explicitly set an
* This is a JavaBeans bound property.
*
- * @param tf
* You should not normally invoke this, instead set the
- *
* This is a JavaBeans bound property.
*
@@ -469,7 +469,7 @@
}
/**
- * Returns the
* The default value of this property is null.
*
@@ -504,9 +504,9 @@
/**
* Returns the last valid value. Based on the editing policy of
- * the
* Not all formatters will allow the component to get into an invalid
* state, and thus this may never be invoked.
@@ -559,7 +559,7 @@
/**
* Returns true if the current value being edited is valid. The value of
- * this is managed by the current
- * An
* Subclasses must override the conversion methods
- *
- * Subclasses that allow the
* Subclasses will typically only need to override this if they
* wish to install additional listeners on the
- *
- * If there is a
* While this is a public method, this is typically only useful
- * for subclassers of
- * The
- * Unlike a
* For more information on content panes
* and other features that root panes provide,
* see Using Top-Level Containers in The Java Tutorial.
*
- * In a multi-screen environment, you can create a
@@ -103,7 +103,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
* This constructor sets the component's locale property to the value
- * returned by
* This constructor sets the component's locale property to the value
- * returned by
* This constructor sets the component's locale property to the value
- * returned by
* This constructor sets the component's locale property to the value
- * returned by
- * The value is set to
@@ -364,9 +364,9 @@
* @see #getDefaultCloseOperation
* @see WindowConstants
* @throws SecurityException
- * if
- * Swing's painting architecture requires an opaque
* You can get the same effect on a single JFrame by doing the following:
@@ -817,7 +817,7 @@
/**
- * Returns true if newly created
*
* Generally,
- * you add
- * The isBinary() returns
- * false with the SampleModel of the
- * supplied Raster as argument.
+ * @throws IllegalArgumentException if {@code isBinary()} returns
+ * {@code false} with the {@code SampleModel} of the
+ * supplied {@code Raster} as argument.
*/
public static void setUnpackedBinaryData(byte[] bdata,
WritableRaster raster,
@@ -1031,7 +1031,7 @@
* @param g The green channel color indices.
* @param b The blue channel color indices.
* @return If all the indices have 256 entries, and are identical mappings,
- * return true; otherwise, return false.
+ * return {@code true}; otherwise, return {@code false}.
*/
public static boolean isIndicesForGrayscale(byte[] r, byte[] g, byte[] b) {
if (r.length != g.length || r.length != b.length)
@@ -1052,7 +1052,7 @@
return true;
}
- /** Converts the provided object to String */
+ /** Converts the provided object to {@code String} */
public static String convertObjectToString(Object obj) {
if (obj == null)
return "";
@@ -1083,10 +1083,10 @@
}
- /** Checks that the provided ImageWriter can encode
- * the provided ImageTypeSpecifier or not. If not, an
- * IIOException will be thrown.
- * @param writer The provided ImageWriter.
+ /** Checks that the provided {@code ImageWriter} can encode
+ * the provided {@code ImageTypeSpecifier} or not. If not, an
+ * {@code IIOException} will be thrown.
+ * @param writer The provided {@code ImageWriter}.
* @param type The image to be tested.
* @throws IIOException If the writer cannot encoded the provided image.
*/
@@ -1101,12 +1101,12 @@
}
}
- /** Checks that the provided ImageWriter can encode
- * the provided ColorModel and SampleModel.
- * If not, an IIOException will be thrown.
- * @param writer The provided ImageWriter.
- * @param colorModel The provided ColorModel.
- * @param sampleModel The provided SampleModel.
+ /** Checks that the provided {@code ImageWriter} can encode
+ * the provided {@code ColorModel} and {@code SampleModel}.
+ * If not, an {@code IIOException} will be thrown.
+ * @param writer The provided {@code ImageWriter}.
+ * @param colorModel The provided {@code ColorModel}.
+ * @param sampleModel The provided {@code SampleModel}.
* @throws IIOException If the writer cannot encoded the provided image.
*/
public static final void canEncodeImage(ImageWriter writer,
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/common/LZWStringTable.java 2015-10-04 22:51:55.577276310 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/LZWStringTable.java 2015-10-04 22:51:55.389276318 +0400
@@ -31,9 +31,9 @@
* General purpose LZW String Table.
* Extracted from GIFEncoder by Adam Doppelt
* Comments added by Robin Luiten
- * expandCode added by Robin Luiten
+ * {@code expandCode} added by Robin Luiten
* The strLen table to give quick access to the lenght of an expanded
- * code for use by the expandCode method added by Robin.
+ * code for use by the {@code expandCode} method added by Robin.
**/
public class LZWStringTable {
/** codesize + Reserved Codes */
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/common/PaletteBuilder.java 2015-10-04 22:51:56.097276286 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/PaletteBuilder.java 2015-10-04 22:51:55.909276295 +0400
@@ -70,19 +70,19 @@
/**
* Creates an image representing given image
- * src using IndexColorModel.
+ * {@code src} using {@code IndexColorModel}.
*
* Lossless conversion is not always possible (e.g. if number
* of colors in the given image exceeds maximum palette size).
* Result image then is an approximation constructed by octree
* quantization method.
*
- * @exception IllegalArgumentException if src is
- * null.
+ * @exception IllegalArgumentException if {@code src} is
+ * {@code null}.
*
* @exception UnsupportedOperationException if implemented method
- * is unable to create approximation of src
- * and canCreatePalette returns false.
+ * is unable to create approximation of {@code src}
+ * and {@code canCreatePalette} returns {@code false}.
*
* @see createIndexColorModel
*
@@ -97,15 +97,15 @@
/**
* Creates an palette representing colors from given image
- * img. If number of colors in the given image exceeds
+ * {@code img}. If number of colors in the given image exceeds
* maximum palette size closest colors would be merged.
*
- * @exception IllegalArgumentException if img is
- * null.
+ * @exception IllegalArgumentException if {@code img} is
+ * {@code null}.
*
* @exception UnsupportedOperationException if implemented method
- * is unable to create approximation of img
- * and canCreatePalette returns false.
+ * is unable to create approximation of {@code img}
+ * and {@code canCreatePalette} returns {@code false}.
*
* @see createIndexedImage
*
@@ -119,17 +119,17 @@
}
/**
- * Returns true if PaletteBuilder is able to create
+ * Returns {@code true} if PaletteBuilder is able to create
* palette for given image type.
*
- * @param type an instance of ImageTypeSpecifier to be
+ * @param type an instance of {@code ImageTypeSpecifier} to be
* indexed.
*
- * @return true if the PaletteBuilder
+ * @return {@code true} if the {@code PaletteBuilder}
* is likely to be able to create palette for this image type.
*
- * @exception IllegalArgumentException if type
- * is null.
+ * @exception IllegalArgumentException if {@code type}
+ * is {@code null}.
*/
public static boolean canCreatePalette(ImageTypeSpecifier type) {
if (type == null) {
@@ -139,17 +139,17 @@
}
/**
- * Returns true if PaletteBuilder is able to create
+ * Returns {@code true} if PaletteBuilder is able to create
* palette for given rendered image.
*
- * @param image an instance of RenderedImage to be
+ * @param image an instance of {@code RenderedImage} to be
* indexed.
*
- * @return true if the PaletteBuilder
+ * @return {@code true} if the {@code PaletteBuilder}
* is likely to be able to create palette for this image type.
*
- * @exception IllegalArgumentException if image
- * is null.
+ * @exception IllegalArgumentException if {@code image}
+ * is {@code null}.
*/
public static boolean canCreatePalette(RenderedImage image) {
if (image == null) {
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/common/ReaderUtil.java 2015-10-04 22:51:56.625276263 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/ReaderUtil.java 2015-10-04 22:51:56.437276271 +0400
@@ -134,25 +134,25 @@
* pixels that will be written during a particular decoding pass.
* The intent is to simplify the work done by readers in combining
* the source region, source subsampling, and destination offset
- * information obtained from the ImageReadParam with
+ * information obtained from the {@code ImageReadParam} with
* the offsets and periods of a progressive or interlaced decoding
* pass.
*
- * @param sourceRegion a Rectangle containing the
+ * @param sourceRegion a {@code Rectangle} containing the
* source region being read, offset by the source subsampling
* offsets, and clipped against the source bounds, as returned by
- * the getSourceRegion method.
- * @param destinationOffset a Point containing the
+ * the {@code getSourceRegion} method.
+ * @param destinationOffset a {@code Point} containing the
* coordinates of the upper-left pixel to be written in the
* destination.
* @param dstMinX the smallest X coordinate (inclusive) of the
- * destination Raster.
+ * destination {@code Raster}.
* @param dstMinY the smallest Y coordinate (inclusive) of the
- * destination Raster.
+ * destination {@code Raster}.
* @param dstMaxX the largest X coordinate (inclusive) of the destination
- * Raster.
+ * {@code Raster}.
* @param dstMaxY the largest Y coordinate (inclusive) of the destination
- * Raster.
+ * {@code Raster}.
* @param sourceXSubsampling the X subsampling factor.
* @param sourceYSubsampling the Y subsampling factor.
* @param passXStart the smallest source X coordinate (inclusive)
@@ -168,7 +168,7 @@
* @param passPeriodY the Y period (vertical spacing between
* pixels) of the current progressive pass.
*
- * @return an array of 6 ints containing the
+ * @return an array of 6 {@code int}s containing the
* destination min X, min Y, width, height, X period and Y period
* of the region that will be updated.
*/
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFImageReader.java 2015-10-04 22:51:57.165276238 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFImageReader.java 2015-10-04 22:51:56.973276247 +0400
@@ -1017,7 +1017,7 @@
/**
* Remove all settings including global settings such as
- * Locales and listeners, as well as stream settings.
+ * {@code Locale}s and listeners, as well as stream settings.
*/
public void reset() {
super.reset();
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFImageWriter.java 2015-10-04 22:51:57.697276215 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFImageWriter.java 2015-10-04 22:51:57.509276223 +0400
@@ -70,7 +70,7 @@
GIFWritableImageMetadata.NATIVE_FORMAT_NAME;
/**
- * The output case to an ImageOutputStream.
+ * The {@code output} case to an {@code ImageOutputStream}.
*/
private ImageOutputStream stream = null;
@@ -272,7 +272,7 @@
}
/**
- * Merges inData into outData. The supplied
+ * Merges {@code inData} into {@code outData}. The supplied
* metadata format name is attempted first and failing that the standard
* metadata format name is attempted.
*/
@@ -554,8 +554,8 @@
*
* @param writeHeader Whether to write the header.
* @param writeTrailer Whether to write the trailer.
- * @param sm The stream metadata or null if
- * writeHeader is false.
+ * @param sm The stream metadata or {@code null} if
+ * {@code writeHeader} is {@code false}.
* @param iioimage The image and image metadata.
* @param p The write parameters.
*
@@ -564,10 +564,10 @@
* greater than 8.
* @throws IllegalArgumentException if the color component size is
* greater than 8.
- * @throws IllegalArgumentException if writeHeader is
- * true and sm is null.
- * @throws IllegalArgumentException if writeHeader is
- * false and a sequence is not being written.
+ * @throws IllegalArgumentException if {@code writeHeader} is
+ * {@code true} and {@code sm} is {@code null}.
+ * @throws IllegalArgumentException if {@code writeHeader} is
+ * {@code false} and a sequence is not being written.
*/
private void write(boolean writeHeader,
boolean writeTrailer,
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFMetadata.java 2015-10-04 22:51:58.233276191 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFMetadata.java 2015-10-04 22:51:58.041276199 +0400
@@ -32,7 +32,7 @@
/**
* Class which adds utility DOM element attribute access methods to
- * IIOMetadata for subclass use.
+ * {@code IIOMetadata} for subclass use.
*/
abstract class GIFMetadata extends IIOMetadata {
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/COMMarkerSegment.java 2015-10-04 22:51:58.757276167 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/COMMarkerSegment.java 2015-10-04 22:51:58.569276175 +0400
@@ -39,7 +39,7 @@
* comment data as it is read from the stream. If the marker segment is
* constructed from a String, then local default encoding is assumed
* when creating the byte array. If the marker segment is created from
- * an IIOMetadataNode, the user object, if present is
+ * an {@code IIOMetadataNode}, the user object, if present is
* assumed to be a byte array containing the comment data. If there is
* no user object then the comment attribute is used to create the
* byte array, again assuming the default local encoding.
@@ -49,7 +49,7 @@
/**
* Constructs a marker segment from the given buffer, which contains
- * data from an ImageInputStream. This is used when
+ * data from an {@code ImageInputStream}. This is used when
* reading metadata from a stream.
*/
COMMarkerSegment(JPEGBuffer buffer) throws IOException {
@@ -69,7 +69,7 @@
/**
* Constructs a marker segment from a native tree node. If the node
- * is an IIOMetadataNode and contains a user object,
+ * is an {@code IIOMetadataNode} and contains a user object,
* that object is used rather than the string attribute. If the
* string attribute is used, the default encoding is used.
*/
@@ -103,7 +103,7 @@
}
/**
- * Returns an IIOMetadataNode containing the data array
+ * Returns an {@code IIOMetadataNode} containing the data array
* as a user object and a string encoded using ISO-8895-1, as an
* attribute.
*/
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JFIFMarkerSegment.java 2015-10-04 22:51:59.281276143 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JFIFMarkerSegment.java 2015-10-04 22:51:59.089276152 +0400
@@ -90,7 +90,7 @@
private final boolean debug = false;
/**
- * Set to true when reading the chunks of an
+ * Set to {@code true} when reading the chunks of an
* ICC profile. All chunks are consolidated to create a single
* "segment" containing all the chunks. This flag is a state
* variable identifying whether to construct a new segment or
@@ -594,10 +594,10 @@
/**
* Writes out a default JFIF marker segment to the given
- * output stream. If thumbnails is not null,
+ * output stream. If {@code thumbnails} is not {@code null},
* writes out the set of thumbnail images as JFXX marker segments, or
* incorporated into the JFIF segment if appropriate.
- * If iccProfile is not null,
+ * If {@code iccProfile} is not {@code null},
* writes out the profile after the JFIF segment using as many APP2
* marker segments as necessary.
*/
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEG.java 2015-10-04 22:51:59.813276120 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEG.java 2015-10-04 22:51:59.625276128 +0400
@@ -36,7 +36,7 @@
/**
* A class containing JPEG-related constants, definitions, and
* static methods. This class and its constants must be public so that
- * JPEGImageWriteParam can see it.
+ * {@code JPEGImageWriteParam} can see it.
*/
public class JPEG {
@@ -234,10 +234,10 @@
public static final float DEFAULT_QUALITY = 0.75F;
/**
- * Returns true if the given ColorSpace
+ * Returns {@code true} if the given {@code ColorSpace}
* object is an instance of ICC_ColorSpace but is not one of the
- * standard ColorSpaces returned by
- * ColorSpace.getInstance().
+ * standard {@code ColorSpaces} returned by
+ * {@code ColorSpace.getInstance()}.
*/
static boolean isNonStandardICC(ColorSpace cs) {
boolean retval = false;
@@ -255,8 +255,8 @@
/**
- * Returns true if the given imageType can be used
- * in a JFIF file. If input is true, then the
+ * Returns {@code true} if the given imageType can be used
+ * in a JFIF file. If {@code input} is true, then the
* image type is considered before colorspace conversion.
*/
static boolean isJFIFcompliant(ImageTypeSpecifier imageType,
@@ -295,7 +295,7 @@
/**
* Given an image type, return the Adobe transform corresponding to
* that type, or ADOBE_IMPOSSIBLE if the image type is incompatible
- * with an Adobe marker segment. If input is true, then
+ * with an Adobe marker segment. If {@code input} is true, then
* the image type is considered before colorspace conversion.
*/
static int transformForType(ImageTypeSpecifier imageType, boolean input) {
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGBuffer.java 2015-10-04 22:52:00.341276096 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGBuffer.java 2015-10-04 22:52:00.153276104 +0400
@@ -75,12 +75,12 @@
}
/**
- * Ensures that there are at least count bytes available
+ * Ensures that there are at least {@code count} bytes available
* in the buffer, loading more data and moving any remaining
* bytes to the front. A count of 0 means to just fill the buffer.
* If the count is larger than the buffer size, just fills the buffer.
* If the end of the stream is encountered before a non-0 count can
- * be satisfied, an IIOException is thrown with the
+ * be satisfied, an {@code IIOException} is thrown with the
* message "Image Format Error".
*/
void loadBuf(int count) throws IOException {
@@ -122,7 +122,7 @@
* the buffer and then reading directly from the stream
* if necessary. The buffer is left in an appropriate
* state. If the end of the stream is encountered, an
- * IIOException is thrown with the
+ * {@code IIOException} is thrown with the
* message "Image Format Error".
*/
void readData(byte [] data) throws IOException {
@@ -149,9 +149,9 @@
}
/**
- * Skips count bytes, leaving the buffer
+ * Skips {@code count} bytes, leaving the buffer
* in an appropriate state. If the end of the stream is
- * encountered, an IIOException is thrown with the
+ * encountered, an {@code IIOException} is thrown with the
* message "Image Format Error".
*/
void skipData(int count) throws IOException {
@@ -195,8 +195,8 @@
* the buffer as necessary. The buffer position is left
* pointing to the first non-0xff byte after a run of
* 0xff bytes. If the end of the stream is encountered,
- * an EOI marker is inserted into the buffer and true
- * is returned. Otherwise returns false.
+ * an EOI marker is inserted into the buffer and {@code true}
+ * is returned. Otherwise returns {@code false}.
*/
boolean scanForFF(JPEGImageReader reader) throws IOException {
boolean retval = false;
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGImageReader.java 2015-10-04 22:52:00.865276072 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGImageReader.java 2015-10-04 22:52:00.677276081 +0400
@@ -544,7 +544,7 @@
}
/**
- * Returns true if there is an image beyond
+ * Returns {@code true} if there is an image beyond
* the current stream position. Does not disturb the
* stream position.
*/
@@ -614,13 +614,13 @@
/**
* Read in the header information starting from the current
- * stream position, returning true if the
+ * stream position, returning {@code true} if the
* header was a tables-only image. After this call, the
* native IJG decompression struct will contain the image
* information required by most query calls below
* (e.g. getWidth, getHeight, etc.), if the header was not
* a tables-only image.
- * If reset is true, the state of the IJG
+ * If reset is {@code true}, the state of the IJG
* object is reset so that it can read a header again.
* This happens automatically if the header was a tables-only
* image.
@@ -867,7 +867,7 @@
* Checks the implied color conversion between the stream and
* the target image, altering the IJG output color space if necessary.
* If a java color conversion is required, then this sets up
- * convert.
+ * {@code convert}.
* If bands are being rearranged at all (either source or destination
* bands are specified in the param), then the default color
* conversions are assumed to be correct.
@@ -1394,7 +1394,7 @@
}
/**
- * Returns true if the read was aborted.
+ * Returns {@code true} if the read was aborted.
*/
private native boolean readImage(long structPointer,
byte [] buffer,
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGImageWriter.java 2015-10-04 22:52:01.401276048 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGImageWriter.java 2015-10-04 22:52:01.213276057 +0400
@@ -1130,10 +1130,10 @@
/*
* from jpeg_metadata.html:
* If no stream metadata is supplied to
- * ImageWriter.prepareWriteSequence, then no
+ * {@code ImageWriter.prepareWriteSequence}, then no
* tables-only image is written. If stream metadata containing
* no tables is supplied to
- * ImageWriter.prepareWriteSequence, then a tables-only
+ * {@code ImageWriter.prepareWriteSequence}, then a tables-only
* image containing default visually lossless tables is written.
*/
if (streamMetadata != null) {
@@ -1699,7 +1699,7 @@
private native void setDest(long structPointer);
/**
- * Returns true if the write was aborted.
+ * Returns {@code true} if the write was aborted.
*/
private native boolean writeImage(long structPointer,
byte [] data,
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGMetadata.java 2015-10-04 22:52:01.945276024 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGMetadata.java 2015-10-04 22:52:01.753276032 +0400
@@ -66,17 +66,17 @@
private static final boolean debug = false;
/**
- * A copy of markerSequence, created the first time the
- * markerSequence is modified. This is used by reset
+ * A copy of {@code markerSequence}, created the first time the
+ * {@code markerSequence} is modified. This is used by reset
* to restore the original state.
*/
private Listtrue when reading a thumbnail stored as
+ * Set to {@code true} when reading a thumbnail stored as
* JPEG. This is used to enforce the prohibition of JFIF thumbnails
* containing any JFIF marker segments, and to ensure generation of
- * a correct native subtree during getAsTree.
+ * a correct native subtree during {@code getAsTree}.
*/
private boolean inThumb = false;
@@ -93,7 +93,7 @@
/////// Package-access variables
/**
- * All data is a list of MarkerSegment objects.
+ * All data is a list of {@code MarkerSegment} objects.
* When accessing the list, use the tag to identify the particular
* subclass. Any JFIF marker segment must be the first element
* of the list if it is present, and any JFXX or APP2ICC marker
@@ -132,17 +132,17 @@
}
/*
- * Constructs a JPEGMetadata object by reading the
- * contents of an ImageInputStream. Has package-only
+ * Constructs a {@code JPEGMetadata} object by reading the
+ * contents of an {@code ImageInputStream}. Has package-only
* access.
*
* @param isStream A boolean indicating whether this object will be
* stream or image metadata.
* @param isThumb A boolean indicating whether this metadata object
* is for an image or for a thumbnail stored as JPEG.
- * @param iis An ImageInputStream from which to read
+ * @param iis An {@code ImageInputStream} from which to read
* the metadata.
- * @param reader The JPEGImageReader calling this
+ * @param reader The {@code JPEGImageReader} calling this
* constructor, to which warnings should be sent.
*/
JPEGMetadata(boolean isStream,
@@ -365,7 +365,7 @@
}
/**
- * Constructs a default stream JPEGMetadata object appropriate
+ * Constructs a default stream {@code JPEGMetadata} object appropriate
* for the given write parameters.
*/
JPEGMetadata(ImageWriteParam param, JPEGImageWriter writer) {
@@ -398,7 +398,7 @@
}
/**
- * Constructs a default image JPEGMetadata object appropriate
+ * Constructs a default image {@code JPEGMetadata} object appropriate
* for the given image type and write parameters.
*/
JPEGMetadata(ImageTypeSpecifier imageType,
@@ -2248,7 +2248,7 @@
/**
* Check that this metadata object is in a consistent state and
- * return true if it is or false
+ * return {@code true} if it is or {@code false}
* otherwise. All the constructors and modifiers should call
* this method at the end to guarantee that the data is always
* consistent, as the writer relies on this.
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGMetadataFormat.java 2015-10-04 22:52:02.493275999 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGMetadataFormat.java 2015-10-04 22:52:02.305276008 +0400
@@ -133,12 +133,12 @@
}
/**
- * Returns true if the named element occurs in the
+ * Returns {@code true} if the named element occurs in the
* subtree of the format starting with the node named by
- * subtreeName, including the node
- * itself. subtreeName may be any node in
+ * {@code subtreeName}, including the node
+ * itself. {@code subtreeName} may be any node in
* the format. If it is not, an
- * IllegalArgumentException is thrown.
+ * {@code IllegalArgumentException} is thrown.
*/
protected boolean isInSubtree(String elementName,
String subtreeName) {
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/MarkerSegment.java 2015-10-04 22:52:03.013275976 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/MarkerSegment.java 2015-10-04 22:52:02.825275984 +0400
@@ -51,8 +51,8 @@
boolean unknown = false; // Set to true if the tag is not recognized
/**
- * Constructor for creating MarkerSegments by reading
- * from an ImageInputStream.
+ * Constructor for creating {@code MarkerSegment}s by reading
+ * from an {@code ImageInputStream}.
*/
MarkerSegment(JPEGBuffer buffer) throws IOException {
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/png/PNGMetadata.java 2015-10-04 22:52:03.541275952 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/png/PNGMetadata.java 2015-10-04 22:52:03.349275961 +0400
@@ -254,7 +254,7 @@
/**
* Sets the IHDR_bitDepth and IHDR_colorType variables.
- * The numBands parameter is necessary since
+ * The {@code numBands} parameter is necessary since
* we may only be writing a subset of the image bands.
*/
public void initialize(ImageTypeSpecifier imageType, int numBands) {
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/wbmp/WBMPImageReader.java 2015-10-04 22:52:04.081275928 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/wbmp/WBMPImageReader.java 2015-10-04 22:52:03.889275937 +0400
@@ -50,7 +50,7 @@
/** This class is the Java Image IO plugin reader for WBMP images.
* It may subsample the image, clip the image,
* and shift the decoded image origin if the proper decoding parameter
- * are set in the provided WBMPImageReadParam.
+ * are set in the provided {@code WBMPImageReadParam}.
*/
public class WBMPImageReader extends ImageReader {
/** The input stream where reads from */
@@ -69,8 +69,8 @@
private WBMPMetadata metadata;
- /** Constructs WBMPImageReader from the provided
- * ImageReaderSpi.
+ /** Constructs {@code WBMPImageReader} from the provided
+ * {@code ImageReaderSpi}.
*/
public WBMPImageReader(ImageReaderSpi originator) {
super(originator);
--- old/src/java.desktop/share/classes/com/sun/imageio/plugins/wbmp/WBMPImageWriter.java 2015-10-04 22:52:04.601275905 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/wbmp/WBMPImageWriter.java 2015-10-04 22:52:04.413275913 +0400
@@ -57,7 +57,7 @@
* a WBMP format.
*
* The encoding process may clip, subsample using the parameters
- * specified in the ImageWriteParam.
+ * specified in the {@code ImageWriteParam}.
*
* @see com.sun.media.imageio.plugins.WBMPImageWriteParam
*/
@@ -92,8 +92,8 @@
return multiBytes;
}
- /** Constructs WBMPImageWriter based on the provided
- * ImageWriterSpi.
+ /** Constructs {@code WBMPImageWriter} based on the provided
+ * {@code ImageWriterSpi}.
*/
public WBMPImageWriter(ImageWriterSpi originator) {
super(originator);
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKColorChooserPanel.java 2015-10-04 22:52:05.157275880 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKColorChooserPanel.java 2015-10-04 22:52:04.937275889 +0400
@@ -113,7 +113,7 @@
}
/**
- * Returns the mnemonic to use with getDisplayName.
+ * Returns the mnemonic to use with {@code getDisplayName}.
*/
public int getMnemonic() {
String m = (String)UIManager.get("GTKColorChooserPanel.mnemonic");
@@ -878,8 +878,8 @@
}
/**
- * Adjusts the saturation and brightness. x and
- * y give the location to adjust to and are relative
+ * Adjusts the saturation and brightness. {@code x} and
+ * {@code y} give the location to adjust to and are relative
* to the origin of the wheel/triangle.
*
* @param x X coordinate on the triangle to adjust to
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKLookAndFeel.java 2015-10-04 22:52:05.689275856 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKLookAndFeel.java 2015-10-04 22:52:05.497275864 +0400
@@ -85,7 +85,7 @@
private Font fallbackFont;
/**
- * If true, GTKLookAndFeel is inside the initialize
+ * If true, GTKLookAndFeel is inside the {@code initialize}
* method.
*/
private boolean inInitialize;
@@ -1671,11 +1671,11 @@
/**
* Returns whether or not the UIs should update their
- * SynthStyles from the SynthStyleFactory
+ * {@code SynthStyles} from the {@code SynthStyleFactory}
* when the ancestor of the Component changes.
*
* @return whether or not the UIs should update their
- * SynthStyles from the SynthStyleFactory
+ * {@code SynthStyles} from the {@code SynthStyleFactory}
* when the ancestor changed.
*/
public boolean shouldUpdateStyleOnAncestorChanged() {
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKStyle.java 2015-10-04 22:52:06.229275831 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKStyle.java 2015-10-04 22:52:06.041275840 +0400
@@ -132,8 +132,8 @@
}
/**
- * Returns a SynthPainter that will route the appropriate
- * calls to a GTKEngine.
+ * Returns a {@code SynthPainter} that will route the appropriate
+ * calls to a {@code GTKEngine}.
*
* @param state SynthContext identifying requestor
* @return SynthPainter
@@ -305,7 +305,7 @@
}
/**
- * Returns the Insets. If insets is non-null the resulting
+ * Returns the Insets. If {@code insets} is non-null the resulting
* insets will be placed in it, otherwise a new Insets object will be
* created and returned.
*
@@ -616,7 +616,7 @@
* @param key Key identifying class specific value
* @param defaultValue Returned if there is no value for the specified
* type
- * @return Value, or defaultValue if key is not defined
+ * @return Value, or defaultValue if {@code key} is not defined
*/
private static int getClassSpecificIntValue(WidgetType wt, String key,
int defaultValue)
@@ -648,7 +648,7 @@
* @param key Key identifying class specific value
* @param defaultValue Returned if there is no value for the specified
* type
- * @return Value, or defaultValue if key is not defined
+ * @return Value, or defaultValue if {@code key} is not defined
*/
int getClassSpecificIntValue(SynthContext context, String key,
int defaultValue)
@@ -668,7 +668,7 @@
* @param key Key identifying class specific value
* @param defaultValue Returned if there is no value for the specified
* type
- * @return Value, or defaultValue if key is not defined
+ * @return Value, or defaultValue if {@code key} is not defined
*/
Insets getClassSpecificInsetsValue(SynthContext context, String key,
Insets defaultValue)
@@ -688,7 +688,7 @@
* @param key Key identifying class specific value
* @param defaultValue Returned if there is no value for the specified
* type
- * @return Value, or defaultValue if key is not defined
+ * @return Value, or defaultValue if {@code key} is not defined
*/
boolean getClassSpecificBoolValue(SynthContext context, String key,
boolean defaultValue)
@@ -1068,7 +1068,7 @@
}
/**
- * GTKLazyValue is a slimmed down version of ProxyLaxyValue.
+ * GTKLazyValue is a slimmed down version of {@code ProxyLaxyValue}.
* The code is duplicate so that it can get at the package private
* classes in gtk.
*/
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKStyleFactory.java 2015-10-04 22:52:06.765275807 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/gtk/GTKStyleFactory.java 2015-10-04 22:52:06.573275816 +0400
@@ -52,8 +52,8 @@
}
/**
- * Returns the GTKStyle to use based on the
- * Region id
+ * Returns the {@code GTKStyle} to use based on the
+ * {@code Region} id
*
* @param c this parameter isn't used, may be null.
* @param id of the region to get the style.
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/motif/MotifOptionPaneUI.java 2015-10-04 22:52:07.285275784 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/motif/MotifOptionPaneUI.java 2015-10-04 22:52:07.097275792 +0400
@@ -59,7 +59,7 @@
/**
* Creates and returns a Container containin the buttons. The buttons
- * are created by calling getButtons.
+ * are created by calling {@code getButtons}.
*/
protected Container createButtonArea() {
Container b = super.createButtonArea();
@@ -97,8 +97,8 @@
/**
* Creates and adds a JLabel representing the icon returned from
- * getIcon to top. This is messaged from
- * createMessageArea
+ * {@code getIcon} to {@code top}. This is messaged from
+ * {@code createMessageArea}
*/
protected void addIcon(Container top) {
/* Create the icon. */
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/motif/MotifSplitPaneDivider.java 2015-10-04 22:52:07.797275761 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/motif/MotifSplitPaneDivider.java 2015-10-04 22:52:07.617275769 +0400
@@ -222,7 +222,7 @@
}
/**
- * Returns true if the point at x, y
+ * Returns true if the point at {@code x}, {@code y}
* is inside the thumb.
*/
private boolean isInThumb(int x, int y) {
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/DesktopProperty.java 2015-10-04 22:52:08.893275712 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/DesktopProperty.java 2015-10-04 22:52:08.437275732 +0400
@@ -32,10 +32,10 @@
/**
* Wrapper for a value from the desktop. The value is lazily looked up, and
- * can be accessed using the UIManager.ActiveValue method
- * createValue. If the underlying desktop property changes this
+ * can be accessed using the {@code UIManager.ActiveValue} method
+ * {@code createValue}. If the underlying desktop property changes this
* will force the UIs to update all known Frames. You can invoke
- * invalidate to force the value to be fetched again.
+ * {@code invalidate} to force the value to be fetched again.
*
*/
// NOTE: Don't rely on this class staying in this location. It is likely
@@ -191,7 +191,7 @@
/**
* Invalides the current value so that the next invocation of
- * createValue will ask for the property again.
+ * {@code createValue} will ask for the property again.
*/
public void invalidate() {
value = null;
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/TMSchema.java 2015-10-04 22:52:09.413275688 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/TMSchema.java 2015-10-04 22:52:09.225275697 +0400
@@ -25,14 +25,14 @@
/*
* LookAndFeel class has been installed
+ * corresponding {@code LookAndFeel} class has been installed
* (UIManager.setLookAndFeel(new XXXLookAndFeel())).
- * Using them while a different LookAndFeel is installed
+ * Using them while a different {@code LookAndFeel} is installed
* may produce unexpected results, including exceptions.
- * Additionally, changing the LookAndFeel
- * maintained by the UIManager without updating the
- * corresponding ComponentUI of any
- * JComponents may also produce unexpected results,
+ * Additionally, changing the {@code LookAndFeel}
+ * maintained by the {@code UIManager} without updating the
+ * corresponding {@code ComponentUI} of any
+ * {@code JComponent}s may also produce unexpected results,
* such as the wrong colors showing up, and is generally not
* encouraged.
*
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsComboBoxUI.java 2015-10-04 22:52:09.929275665 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsComboBoxUI.java 2015-10-04 22:52:09.753275673 +0400
@@ -374,9 +374,9 @@
/**
* Creates the default editor that will be used in editable combo boxes.
* A default editor will be used only if an editor has not been
- * explicitly set with setEditor.
+ * explicitly set with {@code setEditor}.
*
- * @return a ComboBoxEditor used for the combo box
+ * @return a {@code ComboBoxEditor} used for the combo box
* @see javax.swing.JComboBox#setEditor
*/
protected ComboBoxEditor createEditor() {
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsFileChooserUI.java 2015-10-04 22:52:10.445275642 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsFileChooserUI.java 2015-10-04 22:52:10.265275650 +0400
@@ -589,8 +589,8 @@
/**
* Creates a selection listener for the list of files and directories.
*
- * @param fc a JFileChooser
- * @return a ListSelectionListener
+ * @param fc a {@code JFileChooser}
+ * @return a {@code ListSelectionListener}
*/
public ListSelectionListener createListSelectionListener(JFileChooser fc) {
return super.createListSelectionListener(fc);
@@ -631,14 +631,14 @@
/**
* Returns the preferred size of the specified
- * JFileChooser.
+ * {@code JFileChooser}.
* The preferred size is at least as large,
* in both height and width,
* as the preferred size recommended
* by the file chooser's layout manager.
*
- * @param c a JFileChooser
- * @return a Dimension specifying the preferred
+ * @param c a {@code JFileChooser}
+ * @return a {@code Dimension} specifying the preferred
* width and height of the file chooser
*/
@Override
@@ -654,10 +654,10 @@
}
/**
- * Returns the minimum size of the JFileChooser.
+ * Returns the minimum size of the {@code JFileChooser}.
*
- * @param c a JFileChooser
- * @return a Dimension specifying the minimum
+ * @param c a {@code JFileChooser}
+ * @return a {@code Dimension} specifying the minimum
* width and height of the file chooser
*/
@Override
@@ -666,10 +666,10 @@
}
/**
- * Returns the maximum size of the JFileChooser.
+ * Returns the maximum size of the {@code JFileChooser}.
*
- * @param c a JFileChooser
- * @return a Dimension specifying the maximum
+ * @param c a {@code JFileChooser}
+ * @return a {@code Dimension} specifying the maximum
* width and height of the file chooser
*/
@Override
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsInternalFrameTitlePane.java 2015-10-04 22:52:10.969275619 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsInternalFrameTitlePane.java 2015-10-04 22:52:10.789275627 +0400
@@ -489,7 +489,7 @@
/**
* A versatile Icon implementation which can take an array of Icon
- * instances (typically ImageIcons) and choose one that gives the best
+ * instances (typically {@code ImageIcon}s) and choose one that gives the best
* quality for a given Graphics2D scale factor when painting.
* Icon closest to the requested size
+ * @return the {@code Icon} closest to the requested size
*/
protected Icon getBestIcon(int size) {
if (icons != null && icons.length > 0) {
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsLookAndFeel.java 2015-10-04 22:52:11.485275595 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsLookAndFeel.java 2015-10-04 22:52:11.305275603 +0400
@@ -25,14 +25,14 @@
/*
* LookAndFeel class has been installed
+ * corresponding {@code LookAndFeel} class has been installed
* (UIManager.setLookAndFeel(new XXXLookAndFeel())).
- * Using them while a different LookAndFeel is installed
+ * Using them while a different {@code LookAndFeel} is installed
* may produce unexpected results, including exceptions.
- * Additionally, changing the LookAndFeel
- * maintained by the UIManager without updating the
- * corresponding ComponentUI of any
- * JComponents may also produce unexpected results,
+ * Additionally, changing the {@code LookAndFeel}
+ * maintained by the {@code UIManager} without updating the
+ * corresponding {@code ComponentUI} of any
+ * {@code JComponent}s may also produce unexpected results,
* such as the wrong colors showing up, and is generally not
* encouraged.
*
@@ -1934,7 +1934,7 @@
/**
* JTextField
+ * such as pasting into an uneditable {@code JTextField}
* that has focus.
* Component.
+ * {@code Component}.
*
* @see javax.swing.LookAndFeel#provideErrorFeedback
*/
@@ -1971,18 +1971,18 @@
// ********* Auditory Cue support methods and objects *********
/**
- * Returns an Action.
+ * Returns an {@code Action}.
* Object that is passed to this
+ * auditory cue. The {@code Object} that is passed to this
* method contains the information needed to render the auditory
- * cue. Normally, this Object is a String
- * that points to a Toolkit desktopProperty.
- * This desktopProperty is resolved by AWT and the
+ * cue. Normally, this {@code Object} is a {@code String}
+ * that points to a {@code Toolkit desktopProperty}.
+ * This {@code desktopProperty} is resolved by AWT and the
* Windows OS.
* Action's actionPerformed method
- * is fired by the playSound method.
+ * This {@code Action}'s {@code actionPerformed} method
+ * is fired by the {@code playSound} method.
*
* @return an Action which knows how to render the auditory
* cue for one particular system or user activity
@@ -2018,8 +2018,8 @@
* Pass the name String to the super constructor. This is used
* later to identify the Action and decide whether to play it or
* not. Store the resource String. It is used to get the audio
- * resource. In this case, the resource is a Runnable
- * supplied by Toolkit. This Runnable is
+ * resource. In this case, the resource is a {@code Runnable}
+ * supplied by {@code Toolkit}. This {@code Runnable} is
* effectively a pointer down into the Win32 OS that knows how to
* play the right sound.
*
@@ -2050,7 +2050,7 @@
}
/**
- * Gets an Icon from the native libraries if available,
+ * Gets an {@code Icon} from the native libraries if available,
* otherwise gets it from an image resource file.
*/
private static class LazyWindowsIcon implements UIDefaults.LazyValue {
@@ -2077,7 +2077,7 @@
/**
- * Gets an Icon from the native libraries if available.
+ * Gets an {@code Icon} from the native libraries if available.
* A desktop property is used to trigger reloading the icon when needed.
*/
private class ActiveWindowsIcon implements UIDefaults.ActiveValue {
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsPopupMenuUI.java 2015-10-04 22:52:12.029275571 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsPopupMenuUI.java 2015-10-04 22:52:11.849275579 +0400
@@ -78,8 +78,8 @@
}
/**
- * Returns the Popup that will be responsible for
- * displaying the JPopupMenu.
+ * Returns the {@code Popup} that will be responsible for
+ * displaying the {@code JPopupMenu}.
*
* @param popupMenu JPopupMenu requesting Popup
* @param x Screen x location Popup is to be shown at
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsScrollBarUI.java 2015-10-04 22:52:12.541275548 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsScrollBarUI.java 2015-10-04 22:52:12.361275556 +0400
@@ -471,7 +471,7 @@
}
/**
- * Actually renders the grid into the Graphics g.
+ * Actually renders the grid into the Graphics {@code g}.
*/
private void paintGrid(Graphics g, Color fg, Color bg) {
Rectangle clipRect = g.getClipBounds();
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsTreeUI.java 2015-10-04 22:52:13.081275524 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/WindowsTreeUI.java 2015-10-04 22:52:12.889275532 +0400
@@ -203,8 +203,8 @@
/**
* Configures the renderer based on the passed in components.
* The value is set from messaging the tree with
- * convertValueToText, which ultimately invokes
- * toString on value.
+ * {@code convertValueToText}, which ultimately invokes
+ * {@code toString} on {@code value}.
* The foreground color is set based on the selection and the icon
* is set based on on leaf and expanded.
*/
--- old/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/XPStyle.java 2015-10-04 22:52:13.605275500 +0400
+++ new/src/java.desktop/share/classes/com/sun/java/swing/plaf/windows/XPStyle.java 2015-10-04 22:52:13.413275509 +0400
@@ -25,14 +25,14 @@
/*
* LookAndFeel class has been installed
+ * corresponding {@code LookAndFeel} class has been installed
* (UIManager.setLookAndFeel(new XXXLookAndFeel())).
- * Using them while a different LookAndFeel is installed
+ * Using them while a different {@code LookAndFeel} is installed
* may produce unexpected results, including exceptions.
- * Additionally, changing the LookAndFeel
- * maintained by the UIManager without updating the
- * corresponding ComponentUI of any
- * JComponents may also produce unexpected results,
+ * Additionally, changing the {@code LookAndFeel}
+ * maintained by the {@code UIManager} without updating the
+ * corresponding {@code ComponentUI} of any
+ * {@code JComponent}s may also produce unexpected results,
* such as the wrong colors showing up, and is generally not
* encouraged.
*
@@ -123,12 +123,12 @@
return (xp != null && xp.isSkinDefined(null, Part.CP_DROPDOWNBUTTONRIGHT));
}
- /** Get a named String value from the current style
+ /** Get a named {@code String} value from the current style
*
- * @param part a Part
- * @param state a String
- * @param attributeKey a String
- * @return a String or null if key is not found
+ * @param part a {@code Part}
+ * @param state a {@code String}
+ * @param attributeKey a {@code String}
+ * @return a {@code String} or null if key is not found
* in the current style
*
* This is currently only used by WindowsInternalFrameTitlePane for painting
@@ -158,10 +158,10 @@
- /** Get a named int value from the current style
+ /** Get a named {@code int} value from the current style
*
- * @param part a Part
- * @return an int or null if key is not found
+ * @param part a {@code Part}
+ * @return an {@code int} or null if key is not found
* in the current style
*/
int getInt(Component c, Part part, State state, Prop prop, int fallback) {
@@ -170,10 +170,10 @@
prop.getValue());
}
- /** Get a named Dimension value from the current style
+ /** Get a named {@code Dimension} value from the current style
*
- * @param key a String
- * @return a Dimension or null if key is not found
+ * @param key a {@code String}
+ * @return a {@code Dimension} or null if key is not found
* in the current style
*
* This is currently only used by WindowsProgressBarUI and the value
@@ -186,11 +186,11 @@
return (d != null) ? d : new Dimension();
}
- /** Get a named Point (e.g. a location or an offset) value
+ /** Get a named {@code Point} (e.g. a location or an offset) value
* from the current style
*
- * @param key a String
- * @return a Point or null if key is not found
+ * @param key a {@code String}
+ * @return a {@code Point} or null if key is not found
* in the current style
*
* This is currently only used by WindowsInternalFrameTitlePane for painting
@@ -203,10 +203,10 @@
return (d != null) ? new Point(d.width, d.height) : new Point();
}
- /** Get a named Insets value from the current style
+ /** Get a named {@code Insets} value from the current style
*
- * @param key a String
- * @return an Insets object or null if key is not found
+ * @param key a {@code String}
+ * @return an {@code Insets} object or null if key is not found
* in the current style
*
* This is currently only used to create borders and by
@@ -221,10 +221,10 @@
}
- /** Get a named Color value from the current style
+ /** Get a named {@code Color} value from the current style
*
- * @param part a Part
- * @return a Color or null if key is not found
+ * @param part a {@code Part}
+ * @return a {@code Color} or null if key is not found
* in the current style
*/
synchronized Color getColor(Skin skin, Prop prop, Color fallback) {
@@ -249,10 +249,10 @@
- /** Get a named Border value from the current style
+ /** Get a named {@code Border} value from the current style
*
- * @param part a Part
- * @return a Border or null if key is not found
+ * @param part a {@code Part}
+ * @return a {@code Border} or null if key is not found
* in the current style or if the style for the particular
* part is not defined as "borderfill".
*/
@@ -446,11 +446,11 @@
}
- /** Get a Skin object from the current style
+ /** Get a {@code Skin} object from the current style
* for a named part (component type)
*
- * @param part a Part
- * @return a Skin object
+ * @param part a {@code Part}
+ * @return a {@code Skin} object
*/
synchronized Skin getSkin(Component c, Part part) {
assert isSkinDefined(c, part) : "part " + part + " is not defined";
@@ -564,7 +564,7 @@
/** Paint a skin in an area defined by a rectangle.
*
* @param g the graphics context to use for painting
- * @param r a Rectangle defining the area to fill,
+ * @param r a {@code Rectangle} defining the area to fill,
* may cause the image to be stretched or tiled
* @param state which state to paint
*/
--- old/src/java.desktop/share/classes/com/sun/media/sound/AudioSynthesizer.java 2015-10-04 22:52:14.153275476 +0400
+++ new/src/java.desktop/share/classes/com/sun/media/sound/AudioSynthesizer.java 2015-10-04 22:52:13.961275484 +0400
@@ -32,9 +32,9 @@
import javax.sound.sampled.SourceDataLine;
/**
- * AudioSynthesizer is a Synthesizer
- * which renders it's output audio into SourceDataLine
- * or AudioInputStream.
+ * {@code AudioSynthesizer} is a {@code Synthesizer}
+ * which renders it's output audio into {@code SourceDataLine}
+ * or {@code AudioInputStream}.
*
* @see MidiSystem#getSynthesizer
* @see Synthesizer
@@ -59,7 +59,7 @@
* Gets information about the possible properties for the synthesizer.
*
* @param info a proposed list of tag/value pairs that will be sent on open.
- * @return an array of AudioSynthesizerPropertyInfo objects
+ * @return an array of {@code AudioSynthesizerPropertyInfo} objects
* describing possible properties. This array may be an empty array if
* no properties are required.
*/
@@ -68,7 +68,7 @@
/**
* Opens the synthesizer and starts rendering audio into
- * SourceDataLine.
+ * {@code SourceDataLine}.
*
* MidiUnavailableException.
+ * a {@code MidiUnavailableException}.
*
- * @param line which AudioSynthesizer writes output audio into.
- * If line is null, then line from system default mixer is used.
- * @param info a Map object containing
+ * @param line which {@code AudioSynthesizer} writes output audio into.
+ * If {@code line} is null, then line from system default mixer is used.
+ * @param info a {@code Mapinfo is null then default settings are used.
+ * If {@code info} is null then default settings are used.
*
* @throws MidiUnavailableException thrown if the synthesizer cannot be
* opened due to resource restrictions.
@@ -98,7 +98,7 @@
/**
* Opens the synthesizer and renders audio into returned
- * AudioInputStream.
+ * {@code AudioInputStream}.
*
* MidiUnavailableException
*
* @param dm The new display mode of this graphics device.
- * @exception IllegalArgumentException if the .
+ * a {@code MidiUnavailableException}.
*
- * @param targetFormat specifies the described by this
- * AudioFormat
- * used in returned AudioInputStream.
- * @param info a Map object containing
+ * @param targetFormat specifies the {@code AudioFormat}
+ * used in returned {@code AudioInputStream}.
+ * @param info a {@code Mapinfo is null then default settings are used.
+ * If {@code info} is null then default settings are used.
*
* @throws MidiUnavailableException thrown if the synthesizer cannot be
* opened due to resource restrictions.
--- old/src/java.desktop/share/classes/com/sun/media/sound/AudioSynthesizerPropertyInfo.java 2015-10-04 22:52:14.673275452 +0400
+++ new/src/java.desktop/share/classes/com/sun/media/sound/AudioSynthesizerPropertyInfo.java 2015-10-04 22:52:14.485275461 +0400
@@ -25,16 +25,16 @@
package com.sun.media.sound;
/**
- * Information about property used in opening AudioSynthesizer.
+ * Information about property used in opening {@code AudioSynthesizer}.
*
* @author Karl Helgason
*/
public final class AudioSynthesizerPropertyInfo {
/**
- * Constructs a AudioSynthesizerPropertyInfo object with a given
- * name and value. The description and choices
- * are initialized by null values.
+ * Constructs a {@code AudioSynthesizerPropertyInfo} object with a given
+ * name and value. The {@code description} and {@code choices}
+ * are initialized by {@code null} values.
*
* @param name the name of the property
* @param value the current value or class used for values.
@@ -60,18 +60,18 @@
*/
public String description = null;
/**
- * The value field specifies the current value of
+ * The {@code value} field specifies the current value of
* the property.
*/
public Object value = null;
/**
- * The valueClass field specifies class
- * used in value field.
+ * The {@code valueClass} field specifies class
+ * used in {@code value} field.
*/
public Class valueClass = null;
/**
* An array of possible values if the value for the field
- * AudioSynthesizerPropertyInfo.value may be selected
+ * {@code AudioSynthesizerPropertyInfo.value} may be selected
* from a particular set of values; otherwise null.
*/
public Object[] choices = null;
--- old/src/java.desktop/share/classes/com/sun/media/sound/SoftControl.java 2015-10-04 22:52:15.193275429 +0400
+++ new/src/java.desktop/share/classes/com/sun/media/sound/SoftControl.java 2015-10-04 22:52:15.005275437 +0400
@@ -25,7 +25,7 @@
package com.sun.media.sound;
/**
- * SoftControl are the basic controls
+ * {@code SoftControl} are the basic controls
* used for control-rate processing.
*
* @author Karl Helgason
--- old/src/java.desktop/share/classes/java/applet/Applet.java 2015-10-04 22:52:15.765275403 +0400
+++ new/src/java.desktop/share/classes/java/applet/Applet.java 2015-10-04 22:52:15.573275412 +0400
@@ -38,9 +38,9 @@
* An applet is a small program that is intended not to be run on
* its own, but rather to be embedded inside another application.
* Applet class must be the superclass of any
+ * The {@code Applet} class must be the superclass of any
* applet that is to be embedded in a Web page or viewed by the Java
- * Applet Viewer. The Applet class provides a standard
+ * Applet Viewer. The {@code Applet} class provides a standard
* interface between applets and their environment.
*
* @author Arthur van Hoff
@@ -52,10 +52,10 @@
/**
* Constructs a new Applet.
* java.applet.Applet
+ * Note: Many methods in {@code java.applet.Applet}
* may be invoked by the applet only after the applet is
* fully constructed; applet should avoid calling methods
- * in java.applet.Applet in the constructor.
+ * in {@code java.applet.Applet} in the constructor.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
@@ -88,8 +88,8 @@
* Read an applet from an object input stream.
* @param s an object input stream.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless() returns
- * true
+ * {@code GraphicsEnvironment.isHeadless()} returns
+ * {@code true}
* @serial
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.4
@@ -104,9 +104,9 @@
/**
* Sets this applet's stub. This is done automatically by the system.
- * checkPermission
+ * AWTPermission("setAppletStub")
+ * {@code AWTPermission("setAppletStub")}
* permission if a stub has already been set.
* @param stub the new stub.
* @exception SecurityException if the caller cannot set the stub
@@ -123,11 +123,11 @@
/**
* Determines if this applet is active. An applet is marked active
- * just before its start method is called. It becomes
- * inactive just before its stop method is called.
+ * just before its {@code start} method is called. It becomes
+ * inactive just before its {@code stop} method is called.
*
- * @return true if the applet is active;
- * false otherwise.
+ * @return {@code true} if the applet is active;
+ * {@code false} otherwise.
* @see java.applet.Applet#start()
* @see java.applet.Applet#stop()
*/
@@ -179,14 +179,14 @@
* </applet>
*
* getParameter("Color") returns the
- * value "blue".
+ * then a call to {@code getParameter("Color")} returns the
+ * value {@code "blue"}.
* name argument is case insensitive.
+ * The {@code name} argument is case insensitive.
*
* @param name a parameter name.
* @return the value of the named parameter,
- * or null if not set.
+ * or {@code null} if not set.
*/
public String getParameter(String name) {
return stub.getParameter(name);
@@ -260,8 +260,8 @@
}
/**
- * Returns an Image object that can then be painted on
- * the screen. The url that is passed as an argument
+ * Returns an {@code Image} object that can then be painted on
+ * the screen. The {@code url} that is passed as an argument
* must specify an absolute URL.
* Image object that can then be painted on
- * the screen. The url argument must specify an absolute
- * URL. The name argument is a specifier that is
- * relative to the url argument.
+ * Returns an {@code Image} object that can then be painted on
+ * the screen. The {@code url} argument must specify an absolute
+ * URL. The {@code name} argument is a specifier that is
+ * relative to the {@code url} argument.
* url argument.
+ * {@code url} argument.
* @return the image at the specified URL.
* @see java.awt.Image
*/
@@ -315,8 +315,8 @@
}
/**
- * Returns the AudioClip object specified by the
- * URL argument.
+ * Returns the {@code AudioClip} object specified by the
+ * {@code URL} argument.
* AudioClip object specified by the
- * URL and name arguments.
+ * Returns the {@code AudioClip} object specified by the
+ * {@code URL} and {@code name} arguments.
* url argument.
+ * {@code url} argument.
* @return the audio clip at the specified URL.
* @see java.applet.AudioClip
*/
@@ -355,11 +355,11 @@
/**
* Returns information about this applet. An applet should override
- * this method to return a String containing information
+ * this method to return a {@code String} containing information
* about the author, version, and copyright of the applet.
* Applet class returns null.
+ * {@code Applet} class returns {@code null}.
*
* @return a string containing information about the author, version, and
* copyright of the applet.
@@ -388,10 +388,10 @@
/**
* Returns information about the parameters that are understood by
* this applet. An applet should override this method to return an
- * array of Strings describing these parameters.
+ * array of {@code Strings} describing these parameters.
* Strings containing the name, the type, and a
+ * {@code Strings} containing the name, the type, and a
* description. For example:
*
*
* String pinfo[][] = {
@@ -402,7 +402,7 @@
* Applet class returns null.
+ * {@code Applet} class returns {@code null}.
*
* @return an array describing the parameters this applet looks for.
*/
@@ -430,7 +430,7 @@
* @param url an absolute URL giving the base location of the
* audio clip.
* @param name the location of the audio clip, relative to the
- * url argument.
+ * {@code url} argument.
*/
public void play(URL url, String name) {
AudioClip clip = getAudioClip(url, name);
@@ -442,16 +442,16 @@
/**
* Called by the browser or applet viewer to inform
* this applet that it has been loaded into the system. It is always
- * called before the first time that the start method is
+ * called before the first time that the {@code start} method is
* called.
* Applet should override this method if
+ * A subclass of {@code Applet} should override this method if
* it has initialization to perform. For example, an applet with
- * threads would use the init method to create the
- * threads and the destroy method to kill them.
+ * threads would use the {@code init} method to create the
+ * threads and the {@code destroy} method to kill them.
* Applet class does nothing.
+ * {@code Applet} class does nothing.
*
* @see java.applet.Applet#destroy()
* @see java.applet.Applet#start()
@@ -463,25 +463,25 @@
/**
* Called by the browser or applet viewer to inform
* this applet that it should start its execution. It is called after
- * the init method and each time the applet is revisited
+ * the {@code init} method and each time the applet is revisited
* in a Web page.
* Applet should override this method if
+ * A subclass of {@code Applet} should override this method if
* it has any operation that it wants to perform each time the Web
* page containing it is visited. For example, an applet with
- * animation might want to use the start method to
- * resume animation, and the stop method to suspend the
+ * animation might want to use the {@code start} method to
+ * resume animation, and the {@code stop} method to suspend the
* animation.
* getLocationOnScreen, can only
+ * Note: some methods, such as {@code getLocationOnScreen}, can only
* provide meaningful results if the applet is showing. Because
- * isShowing returns false when the applet's
- * start is first called, methods requiring
- * isShowing to return true should be called from
- * a ComponentListener.
+ * {@code isShowing} returns {@code false} when the applet's
+ * {@code start} is first called, methods requiring
+ * {@code isShowing} to return {@code true} should be called from
+ * a {@code ComponentListener}.
* Applet class does nothing.
+ * {@code Applet} class does nothing.
*
* @see java.applet.Applet#destroy()
* @see java.applet.Applet#init()
@@ -498,15 +498,15 @@
* the Web page that contains this applet has been replaced by
* another page, and also just before the applet is to be destroyed.
* Applet should override this method if
+ * A subclass of {@code Applet} should override this method if
* it has any operation that it wants to perform each time the Web
* page containing it is no longer visible. For example, an applet
- * with animation might want to use the start method to
- * resume animation, and the stop method to suspend the
+ * with animation might want to use the {@code start} method to
+ * resume animation, and the {@code stop} method to suspend the
* animation.
* Applet class does nothing.
+ * {@code Applet} class does nothing.
*
* @see java.applet.Applet#destroy()
* @see java.applet.Applet#init()
@@ -517,17 +517,17 @@
/**
* Called by the browser or applet viewer to inform
* this applet that it is being reclaimed and that it should destroy
- * any resources that it has allocated. The stop method
- * will always be called before destroy.
+ * any resources that it has allocated. The {@code stop} method
+ * will always be called before {@code destroy}.
* Applet should override this method if
+ * A subclass of {@code Applet} should override this method if
* it has any operation that it wants to perform before it is
* destroyed. For example, an applet with threads would use the
- * init method to create the threads and the
- * destroy method to kill them.
+ * {@code init} method to create the threads and the
+ * {@code destroy} method to kill them.
* Applet class does nothing.
+ * {@code Applet} class does nothing.
*
* @see java.applet.Applet#init()
* @see java.applet.Applet#start()
@@ -561,7 +561,7 @@
/**
* This class implements accessibility support for the
- * Applet class. It provides an implementation of the
+ * {@code Applet} class. It provides an implementation of the
* Java Accessibility API appropriate to applet user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/applet/AudioClip.java 2015-10-04 22:52:16.293275379 +0400
+++ new/src/java.desktop/share/classes/java/applet/AudioClip.java 2015-10-04 22:52:16.105275388 +0400
@@ -26,8 +26,8 @@
package java.applet;
/**
- * The AudioClip interface is a simple abstraction for
- * playing a sound clip. Multiple AudioClip items can be
+ * The {@code AudioClip} interface is a simple abstraction for
+ * playing a sound clip. Multiple {@code AudioClip} items can be
* playing at the same time, and the resulting sound is mixed
* together to produce a composite.
*
--- old/src/java.desktop/share/classes/java/awt/AWTError.java 2015-10-04 22:52:16.813275356 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTError.java 2015-10-04 22:52:16.625275365 +0400
@@ -38,7 +38,7 @@
private static final long serialVersionUID = -1819846354050686206L;
/**
- * Constructs an instance of AWTError with the specified
+ * Constructs an instance of {@code AWTError} with the specified
* detail message.
* @param msg the detail message.
* @since 1.0
--- old/src/java.desktop/share/classes/java/awt/AWTEvent.java 2015-10-04 22:52:17.337275333 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTEvent.java 2015-10-04 22:52:17.149275341 +0400
@@ -410,11 +410,11 @@
}
/**
- * Returns a string representing the state of this Event.
+ * Returns a string representing the state of this {@code Event}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return a string representation of this event
*/
--- old/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java 2015-10-04 22:52:17.861275309 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java 2015-10-04 22:52:17.673275317 +0400
@@ -122,9 +122,9 @@
/**
* Creates an event multicaster instance which chains listener-a
- * with listener-b. Input parameters a and b
- * should not be null, though implementations may vary in
- * choosing whether or not to throw NullPointerException
+ * with listener-b. Input parameters {@code a} and {@code b}
+ * should not be {@code null}, though implementations may vary in
+ * choosing whether or not to throw {@code NullPointerException}
* in that case.
* @param a listener-a
* @param b listener-b
@@ -1078,30 +1078,30 @@
/**
* Returns an array of all the objects chained as
* FooListeners by the specified
- * java.util.EventListener.
+ * {@code java.util.EventListener}.
* FooListeners are chained by the
- * AWTEventMulticaster using the
+ * {@code AWTEventMulticaster} using the
* addFooListener method.
- * If a null listener is specified, this method returns an
+ * If a {@code null} listener is specified, this method returns an
* empty array. If the specified listener is not an instance of
- * AWTEventMulticaster, this method returns an array which
+ * {@code AWTEventMulticaster}, this method returns an array which
* contains only the specified listener. If no such listeners are chained,
* this method returns an empty array.
*
* @param java.util.EventListener
+ * @param l the specified {@code java.util.EventListener}
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects chained as
* FooListeners by the specified multicast
* listener, or an empty array if no such listeners have been
* chained by the specified multicast listener
* @exception NullPointerException if the specified
* {@code listenertype} parameter is {@code null}
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @since 1.4
*/
--- old/src/java.desktop/share/classes/java/awt/AWTException.java 2015-10-04 22:52:18.397275285 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTException.java 2015-10-04 22:52:18.205275294 +0400
@@ -38,9 +38,9 @@
private static final long serialVersionUID = -1900414231151323879L;
/**
- * Constructs an instance of AWTException with the
+ * Constructs an instance of {@code AWTException} with the
* specified detail message. A detail message is an
- * instance of String that describes this particular
+ * instance of {@code String} that describes this particular
* exception.
* @param msg the detail message
* @since 1.0
--- old/src/java.desktop/share/classes/java/awt/AWTKeyStroke.java 2015-10-04 22:52:18.937275261 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTKeyStroke.java 2015-10-04 22:52:18.745275269 +0400
@@ -37,22 +37,22 @@
import sun.swing.SwingAccessor;
/**
- * An AWTKeyStroke represents a key action on the
- * keyboard, or equivalent input device. AWTKeyStrokes
+ * An {@code AWTKeyStroke} represents a key action on the
+ * keyboard, or equivalent input device. {@code AWTKeyStroke}s
* can correspond to only a press or release of a
- * particular key, just as KEY_PRESSED and
- * KEY_RELEASED KeyEvents do;
+ * particular key, just as {@code KEY_PRESSED} and
+ * {@code KEY_RELEASED KeyEvent}s do;
* alternately, they can correspond to typing a specific Java character, just
- * as KEY_TYPED KeyEvents do.
- * In all cases, AWTKeyStrokes can specify modifiers
+ * as {@code KEY_TYPED KeyEvent}s do.
+ * In all cases, {@code AWTKeyStroke}s can specify modifiers
* (alt, shift, control, meta, altGraph, or a combination thereof) which must be present
* during the action for an exact match.
* AWTKeyStrokes are immutable, and are intended
+ * {@code AWTKeyStrokes} are immutable, and are intended
* to be unique. Client code should never create an
- * AWTKeyStroke on its own, but should instead use
- * a variant of getAWTKeyStroke. Client use of these factory
- * methods allows the AWTKeyStroke implementation
+ * {@code AWTKeyStroke} on its own, but should instead use
+ * a variant of {@code getAWTKeyStroke}. Client use of these factory
+ * methods allows the {@code AWTKeyStroke} implementation
* to cache and share instances efficiently.
*
* @see #getAWTKeyStroke
@@ -88,17 +88,17 @@
}
/**
- * Constructs an AWTKeyStroke with default values.
+ * Constructs an {@code AWTKeyStroke} with default values.
* The default values used are:
*
*
*
- * Property Default Value
*
* Key Char
- * KeyEvent.CHAR_UNDEFINED{@code KeyEvent.CHAR_UNDEFINED}
*
*
* Key Code
- * KeyEvent.VK_UNDEFINED{@code KeyEvent.VK_UNDEFINED}
*
*
* Modifiers
@@ -106,12 +106,12 @@
*
*
* On key release?
- * false{@code false}
* AWTKeyStrokes should not be constructed
- * by client code. Use a variant of getAWTKeyStroke
+ * {@code AWTKeyStroke}s should not be constructed
+ * by client code. Use a variant of {@code getAWTKeyStroke}
* instead.
*
* @see #getAWTKeyStroke
@@ -120,17 +120,17 @@
}
/**
- * Constructs an AWTKeyStroke with the specified
- * values. AWTKeyStrokes should not be constructed
- * by client code. Use a variant of getAWTKeyStroke
+ * Constructs an {@code AWTKeyStroke} with the specified
+ * values. {@code AWTKeyStroke}s should not be constructed
+ * by client code. Use a variant of {@code getAWTKeyStroke}
* instead.
*
* @param keyChar the character value for a keyboard key
- * @param keyCode the key code for this AWTKeyStroke
+ * @param keyCode the key code for this {@code AWTKeyStroke}
* @param modifiers a bitwise-ored combination of any modifiers
- * @param onKeyRelease true if this
- * AWTKeyStroke corresponds
- * to a key release; false otherwise
+ * @param onKeyRelease {@code true} if this
+ * {@code AWTKeyStroke} corresponds
+ * to a key release; {@code false} otherwise
* @see #getAWTKeyStroke
*/
protected AWTKeyStroke(char keyChar, int keyCode, int modifiers,
@@ -185,12 +185,12 @@
}
/**
- * Returns a shared instance of an AWTKeyStroke
- * that represents a KEY_TYPED event for the
+ * Returns a shared instance of an {@code AWTKeyStroke}
+ * that represents a {@code KEY_TYPED} event for the
* specified character.
*
* @param keyChar the character value for a keyboard key
- * @return an AWTKeyStroke object for that key
+ * @return an {@code AWTKeyStroke} object for that key
*/
public static AWTKeyStroke getAWTKeyStroke(char keyChar) {
return getCachedStroke(keyChar, KeyEvent.VK_UNDEFINED, 0, false);
@@ -202,7 +202,7 @@
* specified Character object and a set of modifiers. Note
* that the first parameter is of type Character rather than
* char. This is to avoid inadvertent clashes with
- * calls to getAWTKeyStroke(int keyCode, int modifiers).
+ * calls to {@code getAWTKeyStroke(int keyCode, int modifiers)}.
*
* The modifiers consist of any combination of following:
*
AWTKeyStroke object for that key
- * @throws IllegalArgumentException if keyChar is
- * null
+ * @return an {@code AWTKeyStroke} object for that key
+ * @throws IllegalArgumentException if {@code keyChar} is
+ * {@code null}
*
* @see java.awt.event.InputEvent
*/
@@ -243,19 +243,19 @@
}
/**
- * Returns a shared instance of an AWTKeyStroke,
+ * Returns a shared instance of an {@code AWTKeyStroke},
* given a numeric key code and a set of modifiers, specifying
* whether the key is activated when it is pressed or released.
* java.awt.event.KeyEvent can be
+ * {@code java.awt.event.KeyEvent} can be
* used to specify the key code. For example:
- *
* Alternatively, the key code may be obtained by calling
- * java.awt.event.KeyEvent.VK_ENTER
- * java.awt.event.KeyEvent.VK_TAB
- * java.awt.event.KeyEvent.VK_SPACE
+ * java.awt.event.KeyEvent.getExtendedKeyCodeForChar.
+ * {@code java.awt.event.KeyEvent.getExtendedKeyCodeForChar}.
*
* The modifiers consist of any combination of:
*
true if the AWTKeyStroke
- * should represent a key release; false otherwise
+ * @param onKeyRelease {@code true} if the {@code AWTKeyStroke}
+ * should represent a key release; {@code false} otherwise
* @return an AWTKeyStroke object for that key
*
* @see java.awt.event.KeyEvent
@@ -293,16 +293,16 @@
}
/**
- * Returns a shared instance of an AWTKeyStroke,
+ * Returns a shared instance of an {@code AWTKeyStroke},
* given a numeric key code and a set of modifiers. The returned
- * AWTKeyStroke will correspond to a key press.
+ * {@code AWTKeyStroke} will correspond to a key press.
* java.awt.event.KeyEvent can be
+ * {@code java.awt.event.KeyEvent} can be
* used to specify the key code. For example:
- *
* The modifiers consist of any combination of:java.awt.event.KeyEvent.VK_ENTER
- * java.awt.event.KeyEvent.VK_TAB
- * java.awt.event.KeyEvent.VK_SPACE
+ *
*
AWTKeyStroke object for that key
+ * @return an {@code AWTKeyStroke} object for that key
*
* @see java.awt.event.KeyEvent
* @see java.awt.event.InputEvent
@@ -337,18 +337,18 @@
}
/**
- * Returns an AWTKeyStroke which represents the
- * stroke which generated a given KeyEvent.
+ * Returns an {@code AWTKeyStroke} which represents the
+ * stroke which generated a given {@code KeyEvent}.
* KeyTyped
- * event, and the keyCode from a KeyPressed or
- * KeyReleased event. The KeyEvent modifiers are
- * obtained for all three types of KeyEvent.
- *
- * @param anEvent the KeyEvent from which to
- * obtain the AWTKeyStroke
- * @throws NullPointerException if anEvent is null
- * @return the AWTKeyStroke that precipitated the event
+ * This method obtains the keyChar from a {@code KeyTyped}
+ * event, and the keyCode from a {@code KeyPressed} or
+ * {@code KeyReleased} event. The {@code KeyEvent} modifiers are
+ * obtained for all three types of {@code KeyEvent}.
+ *
+ * @param anEvent the {@code KeyEvent} from which to
+ * obtain the {@code AWTKeyStroke}
+ * @throws NullPointerException if {@code anEvent} is null
+ * @return the {@code AWTKeyStroke} that precipitated the event
*/
public static AWTKeyStroke getAWTKeyStrokeForEvent(KeyEvent anEvent) {
int id = anEvent.getID();
@@ -371,7 +371,7 @@
}
/**
- * Parses a string and returns an AWTKeyStroke.
+ * Parses a string and returns an {@code AWTKeyStroke}.
* The string must have the following syntax:
*
* <modifiers>* (<typedID> | <pressedReleasedID>)
@@ -393,8 +393,8 @@
*
*
* @param s a String formatted as described above
- * @return an AWTKeyStroke object for that String
- * @throws IllegalArgumentException if s is null,
+ * @return an {@code AWTKeyStroke} object for that String
+ * @throws IllegalArgumentException if {@code s} is {@code null},
* or is formatted incorrectly
*/
public static AWTKeyStroke getAWTKeyStroke(String s) {
@@ -500,8 +500,8 @@
}
/**
* Returns the integer constant for the KeyEvent.VK field named
- * key. This will throw an
- * IllegalArgumentException if key is
+ * {@code key}. This will throw an
+ * {@code IllegalArgumentException} if {@code key} is
* not a valid constant.
*/
private static int getVKValue(String key) {
@@ -527,7 +527,7 @@
}
/**
- * Returns the character for this AWTKeyStroke.
+ * Returns the character for this {@code AWTKeyStroke}.
*
* @return a char value
* @see #getAWTKeyStroke(char)
@@ -538,7 +538,7 @@
}
/**
- * Returns the numeric key code for this AWTKeyStroke.
+ * Returns the numeric key code for this {@code AWTKeyStroke}.
*
* @return an int containing the key code value
* @see #getAWTKeyStroke(int,int)
@@ -549,7 +549,7 @@
}
/**
- * Returns the modifier keys for this AWTKeyStroke.
+ * Returns the modifier keys for this {@code AWTKeyStroke}.
*
* @return an int containing the modifiers
* @see #getAWTKeyStroke(int,int)
@@ -559,10 +559,10 @@
}
/**
- * Returns whether this AWTKeyStroke represents a key release.
+ * Returns whether this {@code AWTKeyStroke} represents a key release.
*
- * @return true if this AWTKeyStroke
- * represents a key release; false otherwise
+ * @return {@code true} if this {@code AWTKeyStroke}
+ * represents a key release; {@code false} otherwise
* @see #getAWTKeyStroke(int,int,boolean)
*/
public final boolean isOnKeyRelease() {
@@ -570,12 +570,12 @@
}
/**
- * Returns the type of KeyEvent which corresponds to
- * this AWTKeyStroke.
+ * Returns the type of {@code KeyEvent} which corresponds to
+ * this {@code AWTKeyStroke}.
*
- * @return KeyEvent.KEY_PRESSED,
- * KeyEvent.KEY_TYPED,
- * or KeyEvent.KEY_RELEASED
+ * @return {@code KeyEvent.KEY_PRESSED},
+ * {@code KeyEvent.KEY_TYPED},
+ * or {@code KeyEvent.KEY_RELEASED}
* @see java.awt.event.KeyEvent
*/
public final int getKeyEventType() {
@@ -617,8 +617,8 @@
/**
* Returns a string that displays and identifies this object's properties.
- * The String returned by this method can be passed
- * as a parameter to getAWTKeyStroke(String) to produce
+ * The {@code String} returned by this method can be passed
+ * as a parameter to {@code getAWTKeyStroke(String)} to produce
* a key stroke equal to this key stroke.
*
* @return a String representation of this object
@@ -695,8 +695,8 @@
}
/**
- * Returns a cached instance of AWTKeyStroke (or a subclass of
- * AWTKeyStroke) which is equal to this instance.
+ * Returns a cached instance of {@code AWTKeyStroke} (or a subclass of
+ * {@code AWTKeyStroke}) which is equal to this instance.
*
* @return a cached instance which is equal to this instance
* @throws java.io.ObjectStreamException if a serialization problem occurs
--- old/src/java.desktop/share/classes/java/awt/AWTPermission.java 2015-10-04 22:52:19.473275237 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTPermission.java 2015-10-04 22:52:19.285275245 +0400
@@ -29,7 +29,7 @@
/**
* This class is for AWT permissions.
- * An AWTPermission contains a target name but
+ * An {@code AWTPermission} contains a target name but
* no actions list; you either have the named permission
* or you don't.
*
@@ -39,7 +39,7 @@
* Also, an asterisk could be used to represent all AWT permissions.
*
* AWTPermission
+ * The following table lists all the possible {@code AWTPermission}
* target names, and for each provides a description of what the
* permission allows and a discussion of the risks of granting code
* the permission.
@@ -125,12 +125,12 @@
*
*
*
*
* replaceKeyboardFocusManager
- * Sets the KeyboardFocusManager for
+ * Sets the {@code KeyboardFocusManager} for
* a particular thread.
- * When SecurityManager is installed, the invoking
+ * When {@code SecurityManager} is installed, the invoking
* thread must be granted this permission in order to replace
- * the current KeyboardFocusManager. If permission
- * is not granted, a SecurityException will be thrown.
+ * the current {@code KeyboardFocusManager}. If permission
+ * is not granted, a {@code SecurityException} will be thrown.
*
@@ -201,15 +201,15 @@
private static final long serialVersionUID = 8890392402588814465L;
/**
- * Creates a new
*
*
- * @param event an instance of AWTPermission with the specified name.
- * The name is the symbolic name of the AWTPermission,
+ * Creates a new {@code AWTPermission} with the specified name.
+ * The name is the symbolic name of the {@code AWTPermission},
* such as "topLevelWindow", "systemClipboard", etc. An asterisk
* may be used to indicate all AWT permissions.
*
* @param name the name of the AWTPermission
*
- * @throws NullPointerException if name is null.
- * @throws IllegalArgumentException if name is empty.
+ * @throws NullPointerException if {@code name} is {@code null}.
+ * @throws IllegalArgumentException if {@code name} is empty.
*/
public AWTPermission(String name)
@@ -218,15 +218,15 @@
}
/**
- * Creates a new AWTPermission object with the specified name.
- * The name is the symbolic name of the AWTPermission, and the
- * actions string is currently unused and should be null.
+ * Creates a new {@code AWTPermission} object with the specified name.
+ * The name is the symbolic name of the {@code AWTPermission}, and the
+ * actions string is currently unused and should be {@code null}.
*
- * @param name the name of the AWTPermission
- * @param actions should be null
+ * @param name the name of the {@code AWTPermission}
+ * @param actions should be {@code null}
*
- * @throws NullPointerException if name is null.
- * @throws IllegalArgumentException if name is empty.
+ * @throws NullPointerException if {@code name} is {@code null}.
+ * @throws IllegalArgumentException if {@code name} is empty.
*/
public AWTPermission(String name, String actions)
--- old/src/java.desktop/share/classes/java/awt/ActiveEvent.java 2015-10-04 22:52:20.001275213 +0400
+++ new/src/java.desktop/share/classes/java/awt/ActiveEvent.java 2015-10-04 22:52:19.813275221 +0400
@@ -28,19 +28,19 @@
/**
* An interface for events that know how to dispatch themselves.
* By implementing this interface an event can be placed upon the event
- * queue and its dispatch() method will be called when the event
- * is dispatched, using the EventDispatchThread.
+ * queue and its {@code dispatch()} method will be called when the event
+ * is dispatched, using the {@code EventDispatchThread}.
* ActiveEvent can be created to run the second section of
+ * {@code ActiveEvent} can be created to run the second section of
* code at later time. If there is contention on the monitor,
* the second thread will simply block until the first thread
* has finished its work and exited its monitors.
* ActiveEvent
+ * For security reasons, it is often desirable to use an {@code ActiveEvent}
* to avoid calling untrusted code from a critical thread. For
* instance, peer implementations can use this facility to avoid
* making calls into user code from a system thread. Doing so avoids
--- old/src/java.desktop/share/classes/java/awt/Adjustable.java 2015-10-04 22:52:20.525275189 +0400
+++ new/src/java.desktop/share/classes/java/awt/Adjustable.java 2015-10-04 22:52:20.337275198 +0400
@@ -39,25 +39,25 @@
public interface Adjustable {
/**
- * Indicates that the Adjustable has horizontal orientation.
+ * Indicates that the {@code Adjustable} has horizontal orientation.
*/
@Native public static final int HORIZONTAL = 0;
/**
- * Indicates that the Adjustable has vertical orientation.
+ * Indicates that the {@code Adjustable} has vertical orientation.
*/
@Native public static final int VERTICAL = 1;
/**
- * Indicates that the Adjustable has no orientation.
+ * Indicates that the {@code Adjustable} has no orientation.
*/
@Native public static final int NO_ORIENTATION = 2;
/**
* Gets the orientation of the adjustable object.
* @return the orientation of the adjustable object;
- * either HORIZONTAL, VERTICAL,
- * or NO_ORIENTATION
+ * either {@code HORIZONTAL}, {@code VERTICAL},
+ * or {@code NO_ORIENTATION}
*/
int getOrientation();
@@ -124,15 +124,15 @@
/**
* Sets the current value of the adjustable object. If
- * the value supplied is less than minimum
- * or greater than maximum - visibleAmount,
+ * the value supplied is less than {@code minimum}
+ * or greater than {@code maximum} - {@code visibleAmount},
* then one of those values is substituted, as appropriate.
* AdjustmentEvent.
+ * {@code AdjustmentEvent}.
*
- * @param v the current value, between minimum
- * and maximum - visibleAmount
+ * @param v the current value, between {@code minimum}
+ * and {@code maximum} - {@code visibleAmount}
*/
void setValue(int v);
--- old/src/java.desktop/share/classes/java/awt/AlphaComposite.java 2015-10-04 22:52:21.053275166 +0400
+++ new/src/java.desktop/share/classes/java/awt/AlphaComposite.java 2015-10-04 22:52:20.861275174 +0400
@@ -30,7 +30,7 @@
import sun.java2d.SunCompositeContext;
/**
- * The AlphaComposite class implements basic alpha
+ * The {@code AlphaComposite} class implements basic alpha
* compositing rules for combining source and destination colors
* to achieve blending and transparency effects with graphics and
* images.
@@ -44,7 +44,7 @@
* AlphaComposite class can contain
+ * An instance of the {@code AlphaComposite} class can contain
* an alpha value that is used to modify the opacity or coverage of
* every source pixel before it is used in the blending equations.
*
@@ -52,7 +52,7 @@
* It is important to note that the equations defined by the Porter
* and Duff paper are all defined to operate on color components
* that are premultiplied by their corresponding alpha components.
- * Since the ColorModel and Raster classes
+ * Since the {@code ColorModel} and {@code Raster} classes
* allow the storage of pixel data in either premultiplied or
* non-premultiplied form, all input data must be normalized into
* premultiplied form before applying the equations and all results
@@ -96,7 +96,7 @@
* that specify visual effects.
* For example,
* the description for
- * SRC_OVER
+ * {@code SRC_OVER}
* specifies that Fs = 1 and Fd = (1-As).
* Once a set of equations for determining the blending factors is
* known they can then be applied to each pixel to produce a result
@@ -128,12 +128,12 @@
* Preparing Inputs
*
* AlphaComposite class defines an additional alpha
+ * The {@code AlphaComposite} class defines an additional alpha
* value that is applied to the source alpha.
* This value is applied as if an implicit SRC_IN rule were first
* applied to the source pixel against a pixel with the indicated
* alpha by multiplying both the raw source alpha and the raw
- * source colors by the alpha in the AlphaComposite.
+ * source colors by the alpha in the {@code AlphaComposite}.
* This leads to the following equation for producing the alpha
* used in the Porter and Duff blending equation:
*
@@ -141,7 +141,7 @@
* As = Asr * Aac
*
* All of the raw source color components need to be multiplied
- * by the alpha in the AlphaComposite instance.
+ * by the alpha in the {@code AlphaComposite} instance.
* Additionally, if the source was not in premultiplied form
* then the color components also need to be multiplied by the
* source alpha.
@@ -196,11 +196,11 @@
*
* Raster objects passed to the compose
+ * {@code Raster} objects passed to the {@code compose}
* method of a {@link CompositeContext} object created by the
- * AlphaComposite class have premultiplied data.
- * If either the source Raster
- * or the destination Raster
+ * {@code AlphaComposite} class have premultiplied data.
+ * If either the source {@code Raster}
+ * or the destination {@code Raster}
* is not premultiplied, however,
* appropriate conversions are performed before and after the compositing
* operation.
@@ -210,7 +210,7 @@
*
*
- * @return BufferedImage class, do not store alpha values
+ * in the {@code BufferedImage} class, do not store alpha values
* for their pixels. Such sources supply an alpha of 1.0 for
* all of their pixels.
*
@@ -237,7 +237,7 @@
* that does not separately store
* color components is not a
* good candidate for any type of translucent blending.
- * For example, BufferedImage.TYPE_BYTE_INDEXED
+ * For example, {@code BufferedImage.TYPE_BYTE_INDEXED}
* should not be used as a destination for a blending operation
* because every operation
* can introduce large errors, due to
@@ -277,7 +277,7 @@
* SRC
+ * {@code SRC}
* mode with no extra alpha, then the math would
* indicate that the results were (in integer format):
*
@@ -510,21 +510,21 @@
@Native public static final int XOR = 12;
/**
- * AlphaComposite object that implements the opaque CLEAR rule
+ * {@code AlphaComposite} object that implements the opaque CLEAR rule
* with an alpha of 1.0f.
* @see #CLEAR
*/
public static final AlphaComposite Clear = new AlphaComposite(CLEAR);
/**
- * AlphaComposite object that implements the opaque SRC rule
+ * {@code AlphaComposite} object that implements the opaque SRC rule
* with an alpha of 1.0f.
* @see #SRC
*/
public static final AlphaComposite Src = new AlphaComposite(SRC);
/**
- * AlphaComposite object that implements the opaque DST rule
+ * {@code AlphaComposite} object that implements the opaque DST rule
* with an alpha of 1.0f.
* @see #DST
* @since 1.4
@@ -532,49 +532,49 @@
public static final AlphaComposite Dst = new AlphaComposite(DST);
/**
- * AlphaComposite object that implements the opaque SRC_OVER rule
+ * {@code AlphaComposite} object that implements the opaque SRC_OVER rule
* with an alpha of 1.0f.
* @see #SRC_OVER
*/
public static final AlphaComposite SrcOver = new AlphaComposite(SRC_OVER);
/**
- * AlphaComposite object that implements the opaque DST_OVER rule
+ * {@code AlphaComposite} object that implements the opaque DST_OVER rule
* with an alpha of 1.0f.
* @see #DST_OVER
*/
public static final AlphaComposite DstOver = new AlphaComposite(DST_OVER);
/**
- * AlphaComposite object that implements the opaque SRC_IN rule
+ * {@code AlphaComposite} object that implements the opaque SRC_IN rule
* with an alpha of 1.0f.
* @see #SRC_IN
*/
public static final AlphaComposite SrcIn = new AlphaComposite(SRC_IN);
/**
- * AlphaComposite object that implements the opaque DST_IN rule
+ * {@code AlphaComposite} object that implements the opaque DST_IN rule
* with an alpha of 1.0f.
* @see #DST_IN
*/
public static final AlphaComposite DstIn = new AlphaComposite(DST_IN);
/**
- * AlphaComposite object that implements the opaque SRC_OUT rule
+ * {@code AlphaComposite} object that implements the opaque SRC_OUT rule
* with an alpha of 1.0f.
* @see #SRC_OUT
*/
public static final AlphaComposite SrcOut = new AlphaComposite(SRC_OUT);
/**
- * AlphaComposite object that implements the opaque DST_OUT rule
+ * {@code AlphaComposite} object that implements the opaque DST_OUT rule
* with an alpha of 1.0f.
* @see #DST_OUT
*/
public static final AlphaComposite DstOut = new AlphaComposite(DST_OUT);
/**
- * AlphaComposite object that implements the opaque SRC_ATOP rule
+ * {@code AlphaComposite} object that implements the opaque SRC_ATOP rule
* with an alpha of 1.0f.
* @see #SRC_ATOP
* @since 1.4
@@ -582,7 +582,7 @@
public static final AlphaComposite SrcAtop = new AlphaComposite(SRC_ATOP);
/**
- * AlphaComposite object that implements the opaque DST_ATOP rule
+ * {@code AlphaComposite} object that implements the opaque DST_ATOP rule
* with an alpha of 1.0f.
* @see #DST_ATOP
* @since 1.4
@@ -590,7 +590,7 @@
public static final AlphaComposite DstAtop = new AlphaComposite(DST_ATOP);
/**
- * AlphaComposite object that implements the opaque XOR rule
+ * {@code AlphaComposite} object that implements the opaque XOR rule
* with an alpha of 1.0f.
* @see #XOR
* @since 1.4
@@ -620,11 +620,11 @@
}
/**
- * Creates an AlphaComposite object with the specified rule.
+ * Creates an {@code AlphaComposite} object with the specified rule.
*
* @param rule the compositing rule
* @return the {@code AlphaComposite} object created
- * @throws IllegalArgumentException if rule is not one of
+ * @throws IllegalArgumentException if {@code rule} is not one of
* the following: {@link #CLEAR}, {@link #SRC}, {@link #DST},
* {@link #SRC_OVER}, {@link #DST_OVER}, {@link #SRC_IN},
* {@link #DST_IN}, {@link #SRC_OUT}, {@link #DST_OUT},
@@ -662,19 +662,19 @@
}
/**
- * Creates an AlphaComposite object with the specified rule and
+ * Creates an {@code AlphaComposite} object with the specified rule and
* the constant alpha to multiply with the alpha of the source.
* The source is multiplied with the specified alpha before being composited
* with the destination.
*
* @param rule the compositing rule
* @param alpha the constant alpha to be multiplied with the alpha of
- * the source. alpha must be a floating point number in the
+ * the source. {@code alpha} must be a floating point number in the
* inclusive range [0.0, 1.0].
* @return the {@code AlphaComposite} object created
* @throws IllegalArgumentException if
- * alpha is less than 0.0 or greater than 1.0, or if
- * rule is not one of
+ * {@code alpha} is less than 0.0 or greater than 1.0, or if
+ * {@code rule} is not one of
* the following: {@link #CLEAR}, {@link #SRC}, {@link #DST},
* {@link #SRC_OVER}, {@link #DST_OVER}, {@link #SRC_IN},
* {@link #DST_IN}, {@link #SRC_OUT}, {@link #DST_OUT},
@@ -692,8 +692,8 @@
* The context contains state that is used in performing
* the compositing operation.
* @param srcColorModel the {@link ColorModel} of the source
- * @param dstColorModel the ColorModel of the destination
- * @return the CompositeContext object to be used to perform
+ * @param dstColorModel the {@code ColorModel} of the destination
+ * @return the {@code CompositeContext} object to be used to perform
* compositing operations.
*/
public CompositeContext createContext(ColorModel srcColorModel,
@@ -703,32 +703,32 @@
}
/**
- * Returns the alpha value of this AlphaComposite. If this
- * AlphaComposite does not have an alpha value, 1.0 is returned.
- * @return the alpha value of this AlphaComposite.
+ * Returns the alpha value of this {@code AlphaComposite}. If this
+ * {@code AlphaComposite} does not have an alpha value, 1.0 is returned.
+ * @return the alpha value of this {@code AlphaComposite}.
*/
public float getAlpha() {
return extraAlpha;
}
/**
- * Returns the compositing rule of this AlphaComposite.
- * @return the compositing rule of this AlphaComposite.
+ * Returns the compositing rule of this {@code AlphaComposite}.
+ * @return the compositing rule of this {@code AlphaComposite}.
*/
public int getRule() {
return rule;
}
/**
- * Returns a similar AlphaComposite object that uses
+ * Returns a similar {@code AlphaComposite} object that uses
* the specified compositing rule.
* If this object already uses the specified compositing rule,
* this object is returned.
- * @return an AlphaComposite object derived from
+ * @return an {@code AlphaComposite} object derived from
* this object that uses the specified compositing rule.
* @param rule the compositing rule
* @throws IllegalArgumentException if
- * rule is not one of
+ * {@code rule} is not one of
* the following: {@link #CLEAR}, {@link #SRC}, {@link #DST},
* {@link #SRC_OVER}, {@link #DST_OVER}, {@link #SRC_IN},
* {@link #DST_IN}, {@link #SRC_OUT}, {@link #DST_OUT},
@@ -742,17 +742,17 @@
}
/**
- * Returns a similar AlphaComposite object that uses
+ * Returns a similar {@code AlphaComposite} object that uses
* the specified alpha value.
* If this object already has the specified alpha value,
* this object is returned.
- * @return an AlphaComposite object derived from
+ * @return an {@code AlphaComposite} object derived from
* this object that uses the specified alpha value.
* @param alpha the constant alpha to be multiplied with the alpha of
- * the source. alpha must be a floating point number in the
+ * the source. {@code alpha} must be a floating point number in the
* inclusive range [0.0, 1.0].
* @throws IllegalArgumentException if
- * alpha is less than 0.0 or greater than 1.0
+ * {@code alpha} is less than 0.0 or greater than 1.0
* @since 1.6
*/
public AlphaComposite derive(float alpha) {
@@ -771,16 +771,16 @@
/**
* Determines whether the specified object is equal to this
- * AlphaComposite.
+ * {@code AlphaComposite}.
* true if and only if
- * the argument is not null and is an
- * AlphaComposite object that has the same
+ * The result is {@code true} if and only if
+ * the argument is not {@code null} and is an
+ * {@code AlphaComposite} object that has the same
* compositing rule and alpha value as this object.
*
- * @param obj the Object to test for equality
- * @return true if obj equals this
- * AlphaComposite; false otherwise.
+ * @param obj the {@code Object} to test for equality
+ * @return {@code true} if {@code obj} equals this
+ * {@code AlphaComposite}; {@code false} otherwise.
*/
public boolean equals(Object obj) {
if (!(obj instanceof AlphaComposite)) {
--- old/src/java.desktop/share/classes/java/awt/BorderLayout.java 2015-10-04 22:52:21.593275141 +0400
+++ new/src/java.desktop/share/classes/java/awt/BorderLayout.java 2015-10-04 22:52:21.401275150 +0400
@@ -33,8 +33,8 @@
* north, south, east, west, and center.
* Each region may contain no more than one component, and
* is identified by a corresponding constant:
- * NORTH, SOUTH, EAST,
- * WEST, and CENTER. When adding a
+ * {@code NORTH}, {@code SOUTH}, {@code EAST},
+ * {@code WEST}, and {@code CENTER}. When adding a
* component to a container with a border layout, use one of these
* five constants, for example:
*
@@ -42,55 +42,55 @@
* p.setLayout(new BorderLayout());
* p.add(new Button("Okay"), BorderLayout.SOUTH);
*
- * As a convenience, BorderLayout interprets the
+ * As a convenience, {@code BorderLayout} interprets the
* absence of a string specification the same as the constant
- * CENTER:
+ * {@code CENTER}:
*
* Panel p2 = new Panel();
* p2.setLayout(new BorderLayout());
* p2.add(new TextArea()); // Same as p.add(new TextArea(), BorderLayout.CENTER);
*
* BorderLayout supports the relative
- * positioning constants, PAGE_START, PAGE_END,
- * LINE_START, and LINE_END.
- * In a container whose ComponentOrientation is set to
- * ComponentOrientation.LEFT_TO_RIGHT, these constants map to
- * NORTH, SOUTH, WEST, and
- * EAST, respectively.
+ * In addition, {@code BorderLayout} supports the relative
+ * positioning constants, {@code PAGE_START}, {@code PAGE_END},
+ * {@code LINE_START}, and {@code LINE_END}.
+ * In a container whose {@code ComponentOrientation} is set to
+ * {@code ComponentOrientation.LEFT_TO_RIGHT}, these constants map to
+ * {@code NORTH}, {@code SOUTH}, {@code WEST}, and
+ * {@code EAST}, respectively.
* BorderLayout
- * also includes the relative positioning constants BEFORE_FIRST_LINE,
- * AFTER_LAST_LINE, BEFORE_LINE_BEGINS and
- * AFTER_LINE_ENDS. These are equivalent to
- * PAGE_START, PAGE_END, LINE_START
- * and LINE_END respectively. For
+ * For compatibility with previous releases, {@code BorderLayout}
+ * also includes the relative positioning constants {@code BEFORE_FIRST_LINE},
+ * {@code AFTER_LAST_LINE}, {@code BEFORE_LINE_BEGINS} and
+ * {@code AFTER_LINE_ENDS}. These are equivalent to
+ * {@code PAGE_START}, {@code PAGE_END}, {@code LINE_START}
+ * and {@code LINE_END} respectively. For
* consistency with the relative positioning constants used by other
* components, the latter constants are preferred.
* NORTH
- * and PAGE_START constants in a container whose
- * orientation is LEFT_TO_RIGHT, only the
- * PAGE_START will be laid out.
+ * For example, if you add components using both the {@code NORTH}
+ * and {@code PAGE_START} constants in a container whose
+ * orientation is {@code LEFT_TO_RIGHT}, only the
+ * {@code PAGE_START} will be laid out.
* BorderLayout does not support vertical
- * orientations. The isVertical setting on the container's
- * ComponentOrientation is not respected.
+ * {@code BorderLayout} does not support vertical
+ * orientations. The {@code isVertical} setting on the container's
+ * {@code ComponentOrientation} is not respected.
* NORTH and SOUTH components may
- * be stretched horizontally; the EAST and
- * WEST components may be stretched vertically;
- * the CENTER component may stretch both horizontally
+ * The {@code NORTH} and {@code SOUTH} components may
+ * be stretched horizontally; the {@code EAST} and
+ * {@code WEST} components may be stretched vertically;
+ * the {@code CENTER} component may stretch both horizontally
* and vertically to fill any space left over.
* BorderLayout layout manager:
+ * the {@code BorderLayout} layout manager:
* 
UNDEFINED, the
+ * When flip contents are {@code UNDEFINED}, the
* contents of the back buffer are undefined after flipping.
* @see #isPageFlipping
* @see #getFlipContents
@@ -170,7 +170,7 @@
new FlipContents(I_UNDEFINED);
/**
- * When flip contents are BACKGROUND, the
+ * When flip contents are {@code BACKGROUND}, the
* contents of the back buffer are cleared with the background color after
* flipping.
* @see #isPageFlipping
@@ -183,7 +183,7 @@
new FlipContents(I_BACKGROUND);
/**
- * When flip contents are PRIOR, the
+ * When flip contents are {@code PRIOR}, the
* contents of the back buffer are the prior contents of the front buffer
* (a true page flip).
* @see #isPageFlipping
@@ -196,7 +196,7 @@
new FlipContents(I_PRIOR);
/**
- * When flip contents are COPIED, the
+ * When flip contents are {@code COPIED}, the
* contents of the back buffer are copied to the front buffer when
* flipping.
* @see #isPageFlipping
--- old/src/java.desktop/share/classes/java/awt/Button.java 2015-10-04 22:52:22.653275094 +0400
+++ new/src/java.desktop/share/classes/java/awt/Button.java 2015-10-04 22:52:22.465275102 +0400
@@ -36,7 +36,7 @@
/**
* This class creates a labeled button. The application can cause
* some action to happen when the button is pushed. This image
- * depicts three views of a "Quit" button as it appears
+ * depicts three views of a "{@code Quit}" button as it appears
* under the Solaris operating system:
* 
* The gesture of clicking on a button with the mouse
- * is associated with one instance of ActionEvent,
+ * is associated with one instance of {@code ActionEvent},
* which is sent out when the mouse is both pressed and released
* over the button. If an application is interested in knowing
* when the button has been pressed but not released, as a separate
- * gesture, it can specialize processMouseEvent,
+ * gesture, it can specialize {@code processMouseEvent},
* or it can register itself as a listener for mouse events by
- * calling addMouseListener. Both of these methods are
- * defined by Component, the abstract superclass of
+ * calling {@code addMouseListener}. Both of these methods are
+ * defined by {@code Component}, the abstract superclass of
* all components.
* ActionEvent to the button, by calling
- * processEvent on the button. The button's
- * processEvent method receives all events
+ * of {@code ActionEvent} to the button, by calling
+ * {@code processEvent} on the button. The button's
+ * {@code processEvent} method receives all events
* for the button; it passes an action event along by
- * calling its own processActionEvent method.
+ * calling its own {@code processActionEvent} method.
* The latter method passes the action event on to any action
* listeners that have registered an interest in action
* events generated by this button.
* ActionListener and register the new listener
+ * {@code ActionListener} and register the new listener
* to receive events from this button, by calling the button's
- * addActionListener method. The application can
+ * {@code addActionListener} method. The application can
* make use of the button's action command as a messaging protocol.
*
* @author Sami Shaio
@@ -143,7 +143,7 @@
* Constructs a button with the specified label.
*
* @param label a string label for the button, or
- * null for no label
+ * {@code null} for no label
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -181,7 +181,7 @@
/**
* Gets the label of this button.
*
- * @return the button's label, or null
+ * @return the button's label, or {@code null}
* if the button has no label.
* @see java.awt.Button#setLabel
*/
@@ -192,7 +192,7 @@
/**
* Sets the button's label to be the specified string.
*
- * @param label the new label, or null
+ * @param label the new label, or {@code null}
* if the button has no label.
* @see java.awt.Button#getLabel
*/
@@ -224,7 +224,7 @@
*
* @param command a string used to set the button's
* action command.
- * If the string is null then the action command
+ * If the string is {@code null} then the action command
* is set to match the label of the button.
* @see java.awt.event.ActionEvent
* @since 1.1
@@ -235,7 +235,7 @@
/**
* Returns the command name of the action event fired by this button.
- * If the command name is null (default) then this method
+ * If the command name is {@code null} (default) then this method
* returns the label of the button.
*
* @return the action command name (or label) for this button
@@ -291,7 +291,7 @@
* Returns an array of all the action listeners
* registered on this button.
*
- * @return all of this button's ActionListeners
+ * @return all of this button's {@code ActionListener}s
* or an empty array if no action
* listeners are currently registered
*
@@ -307,16 +307,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this Button.
+ * upon this {@code Button}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * Button b
+ * {@code Button b}
* for its action listeners with the following code:
*
* ActionListener[] als = (ActionListener[])(b.getListeners(ActionListener.class));
@@ -325,14 +325,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this button,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getActionListeners
* @since 1.3
@@ -361,10 +361,10 @@
/**
* Processes events on this button. If an event is
- * an instance of ActionEvent, this method invokes
- * the processActionEvent method. Otherwise,
- * it invokes processEvent on the superclass.
- * null
+ * an instance of {@code ActionEvent}, this method invokes
+ * the {@code processActionEvent} method. Otherwise,
+ * it invokes {@code processEvent} on the superclass.
+ * ActionListener objects.
+ * {@code ActionListener} objects.
*
- *
- * ActionListener object is registered
- * via addActionListener.
- * enableEvents.
+ * null
+ * Button.
+ * Returns a string representing the state of this {@code Button}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this button
*/
@@ -436,19 +436,19 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable ActionListeners
+ * a list of serializable {@code ActionListeners}
* as optional data. The non-serializable
- * ActionListeners are detected and
+ * {@code ActionListeners} are detected and
* no attempt is made to serialize them.
*
- * @serialData null terminated sequence of 0 or
- * more pairs: the pair consists of a String
- * and an Object; the String
+ * @serialData {@code null} terminated sequence of 0 or
+ * more pairs: the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String}
* indicates the type of object and is one of the following:
- * actionListenerK indicating an
- * ActionListener object
+ * {@code actionListenerK} indicating an
+ * {@code ActionListener} object
*
- * @param s the ObjectOutputStream to write
+ * @param s the {@code ObjectOutputStream} to write
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see java.awt.Component#actionListenerK
* @see #readObject(ObjectInputStream)
@@ -463,15 +463,15 @@
}
/**
- * Reads the ObjectInputStream and if
- * it isn't null adds a listener to
+ * Reads the {@code ObjectInputStream} and if
+ * it isn't {@code null} adds a listener to
* receive action events fired by the button.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @serial
* @see #removeActionListener(ActionListener)
* @see #addActionListener(ActionListener)
@@ -502,15 +502,15 @@
////////////////
/**
- * Gets the AccessibleContext associated with
- * this Button. For buttons, the
- * AccessibleContext takes the form of an
- * AccessibleAWTButton.
- * A new AccessibleAWTButton instance is
+ * Gets the {@code AccessibleContext} associated with
+ * this {@code Button}. For buttons, the
+ * {@code AccessibleContext} takes the form of an
+ * {@code AccessibleAWTButton}.
+ * A new {@code AccessibleAWTButton} instance is
* created if necessary.
*
- * @return an AccessibleAWTButton that serves as the
- * AccessibleContext of this Button
+ * @return an {@code AccessibleAWTButton} that serves as the
+ * {@code AccessibleContext} of this {@code Button}
* @beaninfo
* expert: true
* description: The AccessibleContext associated with this Button.
@@ -525,7 +525,7 @@
/**
* This class implements accessibility support for the
- * Button class. It provides an implementation of the
+ * {@code Button} class. It provides an implementation of the
* Java Accessibility API appropriate to button user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/Canvas.java 2015-10-04 22:52:23.193275070 +0400
+++ new/src/java.desktop/share/classes/java/awt/Canvas.java 2015-10-04 22:52:23.001275078 +0400
@@ -29,13 +29,13 @@
import javax.accessibility.*;
/**
- * A Canvas component represents a blank rectangular
+ * A {@code Canvas} component represents a blank rectangular
* area of the screen onto which the application can draw or from
* which the application can trap input events from the user.
* Canvas class in
+ * An application must subclass the {@code Canvas} class in
* order to get useful functionality such as creating a custom
- * component. The paint method must be overridden
+ * component. The {@code paint} method must be overridden
* in order to perform custom graphics on the canvas.
*
* @author Sami Shaio
@@ -108,7 +108,7 @@
/**
* Paints this canvas.
* Canvas should
+ * Most applications that subclass {@code Canvas} should
* override this method in order to perform some useful operation
* (typically, custom painting of the canvas).
* The default operation is simply to clear the canvas.
@@ -126,10 +126,10 @@
/**
* Updates this canvas.
* repaint.
+ * This method is called in response to a call to {@code repaint}.
* The canvas is first cleared by filling it with the background
* color, and then completely redrawn by calling this canvas's
- * paint method.
+ * {@code paint} method.
* Note: applications that override this method should either call
* super.update(g) or incorporate the functionality described
* above into their own code.
@@ -151,7 +151,7 @@
* Creates a new strategy for multi-buffering on this component.
* Multi-buffering is useful for rendering performance. This method
* attempts to create the best strategy available with the number of
- * buffers supplied. It will always create a BufferStrategy
+ * buffers supplied. It will always create a {@code BufferStrategy}
* with that number of buffers.
* A page-flipping strategy is attempted first, then a blitting strategy
* using accelerated buffers. Finally, an unaccelerated blitting
@@ -180,13 +180,13 @@
* is called, the existing buffer strategy for this component is discarded.
* @param numBuffers number of buffers to create
* @param caps the required capabilities for creating the buffer strategy;
- * cannot be null
+ * cannot be {@code null}
* @exception AWTException if the capabilities supplied could not be
* supported or met; this may happen, for example, if there is not enough
* accelerated memory currently available, or if page flipping is specified
* but not possible.
* @exception IllegalArgumentException if numBuffers is less than 1, or if
- * caps is null
+ * caps is {@code null}
* @see #getBufferStrategy
* @since 1.4
*/
@@ -196,8 +196,8 @@
}
/**
- * Returns the BufferStrategy used by this component. This
- * method will return null if a BufferStrategy has not yet
+ * Returns the {@code BufferStrategy} used by this component. This
+ * method will return null if a {@code BufferStrategy} has not yet
* been created or has been disposed.
*
* @return the buffer strategy used by this component
@@ -232,7 +232,7 @@
/**
* This class implements accessibility support for the
- * Canvas class. It provides an implementation of the
+ * {@code Canvas} class. It provides an implementation of the
* Java Accessibility API appropriate to canvas user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/CardLayout.java 2015-10-04 22:52:23.717275046 +0400
+++ new/src/java.desktop/share/classes/java/awt/CardLayout.java 2015-10-04 22:52:23.529275054 +0400
@@ -36,15 +36,15 @@
import java.io.IOException;
/**
- * A CardLayout object is a layout manager for a
+ * A {@code CardLayout} object is a layout manager for a
* container. It treats each component in the container as a card.
* Only one card is visible at a time, and the container acts as
* a stack of cards. The first component added to a
- * CardLayout object is the visible component when the
+ * {@code CardLayout} object is the visible component when the
* container is first displayed.
* CardLayout
+ * ordering of its component objects. {@code CardLayout}
* defines a set of methods that allow an application to flip
* through these cards sequentially, or to show a specified card.
* The {@link CardLayout#addLayoutComponent}
@@ -188,10 +188,10 @@
/**
* Adds the specified component to this card layout's internal
- * table of names. The object specified by constraints
+ * table of names. The object specified by {@code constraints}
* must be a string. The card layout stores this string as a key-value
* pair that can be used for random access to a particular card.
- * By calling the show method, an application can
+ * By calling the {@code show} method, an application can
* display the component with the specified name.
* @param comp the component to be added.
* @param constraints a tag that identifies a particular
@@ -214,7 +214,7 @@
/**
* @deprecated replaced by
- * addLayoutComponent(Component, Object).
+ * {@code addLayoutComponent(Component, Object)}.
*/
@Deprecated
public void addLayoutComponent(String name, Component comp) {
@@ -365,7 +365,7 @@
/**
* Lays out the specified container using this card layout.
* parent container is reshaped
+ * Each component in the {@code parent} container is reshaped
* to be the size of the container, minus space for surrounding
* insets, horizontal gaps, and vertical gaps.
*
@@ -515,7 +515,7 @@
/**
* Flips to the component that was added to this layout with the
- * specified name, using addLayoutComponent.
+ * specified {@code name}, using {@code addLayoutComponent}.
* If no such component exists, then nothing happens.
* @param parent the parent container in which to do the layout
* @param name the component name
--- old/src/java.desktop/share/classes/java/awt/Checkbox.java 2015-10-04 22:52:24.249275022 +0400
+++ new/src/java.desktop/share/classes/java/awt/Checkbox.java 2015-10-04 22:52:24.057275031 +0400
@@ -35,7 +35,7 @@
/**
* A check box is a graphical component that can be in either an
- * "on" (true) or "off" (false) state.
+ * "on" ({@code true}) or "off" ({@code false}) state.
* Clicking on a check box changes its state from
* "on" to "off," or from "off" to "on."
* 
* one is in the "on" state, and the
+ * The button labeled {@code one} is in the "on" state, and the
* other two are in the "off" state. In this example, which uses the
- * GridLayout class, the states of the three check
+ * {@code GridLayout} class, the states of the three check
* boxes are set independently.
* CheckboxGroup class.
+ * {@code CheckboxGroup} class.
* In a check box group, at most one button can be in the "on"
* state at any given time. Clicking on a check box to turn it on
* forces any other check box in the same group that is on
@@ -93,7 +93,7 @@
String label;
/**
- * The state of the Checkbox.
+ * The state of the {@code Checkbox}.
* @serial
* @see #getState()
* @see #setState(boolean)
@@ -150,10 +150,10 @@
* any check box group.
*
* @param label a string label for this check box,
- * or null for no label.
+ * or {@code null} for no label.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless
- * returns true
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public Checkbox(String label) throws HeadlessException {
@@ -166,11 +166,11 @@
* This check box is not part of any check box group.
*
* @param label a string label for this check box,
- * or null for no label
+ * or {@code null} for no label
* @param state the initial state of this check box
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless
- * returns true
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public Checkbox(String label, boolean state) throws HeadlessException {
@@ -182,13 +182,13 @@
* specified state, and in the specified check box group.
*
* @param label a string label for this check box,
- * or null for no label.
+ * or {@code null} for no label.
* @param state the initial state of this check box.
* @param group a check box group for this check box,
- * or null for no group.
+ * or {@code null} for no group.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless
- * returns true
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.1
*/
@@ -208,13 +208,13 @@
* check box group, and set to the specified state.
*
* @param label a string label for this check box,
- * or null for no label.
+ * or {@code null} for no label.
* @param group a check box group for this check box,
- * or null for no group.
+ * or {@code null} for no group.
* @param state the initial state of this check box.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless
- * returns true
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.1
*/
@@ -225,7 +225,7 @@
/**
* Constructs a name for this component. Called by
- * getName when the name is null.
+ * {@code getName} when the name is {@code null}.
*
* @return a name for this component
*/
@@ -252,7 +252,7 @@
/**
* Gets the label of this check box.
*
- * @return the label of this check box, or null
+ * @return the label of this check box, or {@code null}
* if this check box has no label.
* @see #setLabel(String)
*/
@@ -264,7 +264,7 @@
* Sets this check box's label to be the string argument.
*
* @param label a string to set as the new label, or
- * null for no label.
+ * {@code null} for no label.
* @see #getLabel
*/
public void setLabel(String label) {
@@ -290,8 +290,8 @@
/**
* Determines whether this check box is in the "on" or "off" state.
- * The boolean value true indicates the "on" state,
- * and false indicates the "off" state.
+ * The boolean value {@code true} indicates the "on" state,
+ * and {@code false} indicates the "off" state.
*
* @return the state of this check box, as a boolean value
* @see #setState
@@ -302,14 +302,14 @@
/**
* Sets the state of this check box to the specified state.
- * The boolean value true indicates the "on" state,
- * and false indicates the "off" state.
+ * The boolean value {@code true} indicates the "on" state,
+ * and {@code false} indicates the "off" state.
*
* ItemEvent. The only way to trigger an
- * ItemEvent is by user interaction.
+ * an {@code ItemEvent}. The only way to trigger an
+ * {@code ItemEvent} is by user interaction.
*
* @param state the boolean state of the check box
* @see #getState
@@ -343,7 +343,7 @@
/**
* Determines this check box's group.
- * @return this check box's group, or null
+ * @return this check box's group, or {@code null}
* if the check box is not part of a check box group.
* @see #setCheckboxGroup(CheckboxGroup)
*/
@@ -356,14 +356,14 @@
* If this check box is already in a different check box group,
* it is first taken out of that group.
* true and the new
+ * If the state of this check box is {@code true} and the new
* group already has a check box selected, this check box's state
- * is changed to false. If the state of this check
- * box is true and the new group has no check box
+ * is changed to {@code false}. If the state of this check
+ * box is {@code true} and the new group has no check box
* selected, this check box becomes the selected checkbox for
- * the new group and its state is true.
+ * the new group and its state is {@code true}.
*
- * @param g the new check box group, or null
+ * @param g the new check box group, or {@code null}
* to remove this check box from any check box group
* @see #getCheckboxGroup
*/
@@ -458,7 +458,7 @@
* Returns an array of all the item listeners
* registered on this checkbox.
*
- * @return all of this checkbox's ItemListeners
+ * @return all of this checkbox's {@code ItemListener}s
* or an empty array if no item
* listeners are currently registered
*
@@ -475,16 +475,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this Checkbox.
+ * upon this {@code Checkbox}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * Checkbox c
+ * {@code Checkbox c}
* for its item listeners with the following code:
*
* ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
@@ -493,14 +493,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this checkbox,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getItemListeners
* @since 1.3
@@ -529,10 +529,10 @@
/**
* Processes events on this check box.
- * If the event is an instance of ItemEvent,
- * this method invokes the processItemEvent method.
- * Otherwise, it calls its superclass's processEvent method.
- * null
+ * If the event is an instance of {@code ItemEvent},
+ * this method invokes the {@code processItemEvent} method.
+ * Otherwise, it calls its superclass's {@code processEvent} method.
+ * ItemListener objects.
+ * {@code ItemListener} objects.
*
- *
- * ItemListener object is registered
- * via addItemListener.
- * enableEvents.
+ * null
+ * Checkbox.
+ * Returns a string representing the state of this {@code Checkbox}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this check box
*/
@@ -610,18 +610,18 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable ItemListeners
+ * a list of serializable {@code ItemListeners}
* as optional data. The non-serializable
- * ItemListeners are detected and
+ * {@code ItemListeners} are detected and
* no attempt is made to serialize them.
*
- * @param s the ObjectOutputStream to write
- * @serialData null terminated sequence of 0
- * or more pairs; the pair consists of a String
- * and an Object; the String indicates
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData {@code null} terminated sequence of 0
+ * or more pairs; the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String} indicates
* the type of object and is one of the following:
- * itemListenerK indicating an
- * ItemListener object
+ * {@code itemListenerK} indicating an
+ * {@code ItemListener} object
*
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see java.awt.Component#itemListenerK
@@ -637,15 +637,15 @@
}
/**
- * Reads the ObjectInputStream and if it
- * isn't null adds a listener to receive
- * item events fired by the Checkbox.
+ * Reads the {@code ObjectInputStream} and if it
+ * isn't {@code null} adds a listener to receive
+ * item events fired by the {@code Checkbox}.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @serial
* @see #removeItemListener(ItemListener)
* @see #addItemListener(ItemListener)
@@ -700,7 +700,7 @@
/**
* This class implements accessibility support for the
- * Checkbox class. It provides an implementation of the
+ * {@code Checkbox} class. It provides an implementation of the
* Java Accessibility API appropriate to checkbox user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/CheckboxMenuItem.java 2015-10-04 22:52:24.785274998 +0400
+++ new/src/java.desktop/share/classes/java/awt/CheckboxMenuItem.java 2015-10-04 22:52:24.597275007 +0400
@@ -40,20 +40,20 @@
* "on" to "off" or from "off" to "on."
* CheckBoxMenuItem:
+ * of {@code CheckBoxMenuItem}:
* 
* Check shows a check box menu item
+ * The item labeled {@code Check} shows a check box menu item
* in its "off" state.
* ItemEvent,
- * the processEvent method examines the event and passes
- * it along to processItemEvent. The latter method redirects
- * the event to any ItemListener objects that have
+ * the item. Since the event is an instance of {@code ItemEvent},
+ * the {@code processEvent} method examines the event and passes
+ * it along to {@code processItemEvent}. The latter method redirects
+ * the event to any {@code ItemListener} objects that have
* registered an interest in item events generated by this menu item.
*
* @author Sami Shaio
@@ -113,7 +113,7 @@
* The item's state is initially set to "off."
* @param label a string label for the check box menu item,
- * or null for an unlabeled menu item.
+ * or {@code null} for an unlabeled menu item.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -125,10 +125,10 @@
/**
* Create a check box menu item with the specified label and state.
* @param label a string label for the check box menu item,
- * or null for an unlabeled menu item.
+ * or {@code null} for an unlabeled menu item.
* @param state the initial state of the menu item, where
- * true indicates "on" and
- * false indicates "off."
+ * {@code true} indicates "on" and
+ * {@code false} indicates "off."
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -170,8 +170,8 @@
* is "on" or "off."
*
* @return the state of this check box menu item, where
- * true indicates "on" and
- * false indicates "off"
+ * {@code true} indicates "on" and
+ * {@code false} indicates "off"
* @see #setState
*/
public boolean getState() {
@@ -180,18 +180,18 @@
/**
* Sets this check box menu item to the specified state.
- * The boolean value true indicates "on" while
- * false indicates "off."
+ * The boolean value {@code true} indicates "on" while
+ * {@code false} indicates "off."
*
* ItemEvent. The only way to trigger an
- * ItemEvent is by user interaction.
+ * an {@code ItemEvent}. The only way to trigger an
+ * {@code ItemEvent} is by user interaction.
*
- * @param b true if the check box
- * menu item is on, otherwise false
+ * @param b {@code true} if the check box
+ * menu item is on, otherwise {@code false}
* @see #getState
*/
public synchronized void setState(boolean b) {
@@ -265,7 +265,7 @@
* Returns an array of all the item listeners
* registered on this checkbox menuitem.
*
- * @return all of this checkbox menuitem's ItemListeners
+ * @return all of this checkbox menuitem's {@code ItemListener}s
* or an empty array if no item
* listeners are currently registered
*
@@ -282,16 +282,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this CheckboxMenuItem.
+ * upon this {@code CheckboxMenuItem}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * CheckboxMenuItem c
+ * {@code CheckboxMenuItem c}
* for its item listeners with the following code:
*
* ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
@@ -300,14 +300,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this checkbox menuitem,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getItemListeners
* @since 1.3
@@ -336,13 +336,13 @@
/**
* Processes events on this check box menu item.
- * If the event is an instance of ItemEvent,
- * this method invokes the processItemEvent method.
+ * If the event is an instance of {@code ItemEvent},
+ * this method invokes the {@code processItemEvent} method.
* If the event is not an item event,
- * it invokes processEvent on the superclass.
+ * it invokes {@code processEvent} on the superclass.
* null
+ * ItemListener objects.
+ * dispatching them to any registered {@code ItemListener} objects.
*
- *
- * ItemListener object is registered
- * via addItemListener.
- * enableEvents.
+ * null
+ * CheckBoxMenuItem. This
+ * {@code CheckBoxMenuItem}. This
* method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this check box menu item
*/
@@ -426,18 +426,18 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable ItemListeners
+ * a list of serializable {@code ItemListeners}
* as optional data. The non-serializable
- * ItemListeners are detected and
+ * {@code ItemListeners} are detected and
* no attempt is made to serialize them.
*
- * @param s the ObjectOutputStream to write
- * @serialData null terminated sequence of
- * 0 or more pairs; the pair consists of a String
- * and an Object; the String indicates
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData {@code null} terminated sequence of
+ * 0 or more pairs; the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String} indicates
* the type of object and is one of the following:
- * itemListenerK indicating an
- * ItemListener object
+ * {@code itemListenerK} indicating an
+ * {@code ItemListener} object
*
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see java.awt.Component#itemListenerK
@@ -453,12 +453,12 @@
}
/*
- * Reads the ObjectInputStream and if it
- * isn't null adds a listener to receive
- * item events fired by the Checkbox menu item.
+ * Reads the {@code ObjectInputStream} and if it
+ * isn't {@code null} adds a listener to receive
+ * item events fired by the {@code Checkbox} menu item.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @serial
* @see removeActionListener()
* @see addActionListener()
@@ -515,7 +515,7 @@
* subclassed by menu component developers.
* CheckboxMenuItem class. It provides an implementation
+ * {@code CheckboxMenuItem} class. It provides an implementation
* of the Java Accessibility API appropriate to checkbox menu item
* user-interface elements.
* @since 1.3
--- old/src/java.desktop/share/classes/java/awt/Choice.java 2015-10-04 22:52:25.333274973 +0400
+++ new/src/java.desktop/share/classes/java/awt/Choice.java 2015-10-04 22:52:25.129274983 +0400
@@ -36,7 +36,7 @@
/**
- * The Choice class presents a pop-up menu of choices.
+ * The {@code Choice} class presents a pop-up menu of choices.
* The current choice is displayed as the title of the menu.
* 
* "Green" is the current choice.
+ * In the picture, {@code "Green"} is the current choice.
* Pushing the mouse button down on the object causes a menu to
* appear with the current choice highlighted.
* Choice components and the behavior of
- * setSize()/getSize() is bound by
+ * {@code Choice} components and the behavior of
+ * {@code setSize()/getSize()} is bound by
* such limitations.
- * Native GUI Choice components' size are often bound by such
+ * Native GUI {@code Choice} components' size are often bound by such
* attributes as font size and length of items contained within
- * the Choice.
+ * the {@code Choice}.
*
* @author Sami Shaio
* @author Arthur van Hoff
@@ -72,8 +72,8 @@
*/
public class Choice extends Component implements ItemSelectable, Accessible {
/**
- * The items for the Choice.
- * This can be a null value.
+ * The items for the {@code Choice}.
+ * This can be a {@code null} value.
* @serial
* @see #add(String)
* @see #addItem(String)
@@ -85,7 +85,7 @@
VectorChoice
+ * The index of the current choice for this {@code Choice}
* or -1 if nothing is selected.
* @serial
* @see #getSelectedItem()
@@ -117,7 +117,7 @@
* select methods.
+ * by calling one of the {@code select} methods.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -131,7 +131,7 @@
/**
* Constructs a name for this component. Called by
- * getName when the name is null.
+ * {@code getName} when the name is {@code null}.
*/
String constructComponentName() {
synchronized (Choice.class) {
@@ -140,9 +140,9 @@
}
/**
- * Creates the Choice's peer. This peer allows us
+ * Creates the {@code Choice}'s peer. This peer allows us
* to change the look
- * of the Choice without changing its functionality.
+ * of the {@code Choice} without changing its functionality.
* @see java.awt.Component#getToolkit()
*/
public void addNotify() {
@@ -154,9 +154,9 @@
}
/**
- * Returns the number of items in this Choice menu.
+ * Returns the number of items in this {@code Choice} menu.
*
- * @return the number of items in this Choice menu
+ * @return the number of items in this {@code Choice} menu
* @see #getItem
* @since 1.1
*/
@@ -169,7 +169,7 @@
*
* @return the number of items in this {@code Choice} menu
* @deprecated As of JDK version 1.1,
- * replaced by getItemCount().
+ * replaced by {@code getItemCount()}.
*/
@Deprecated
public int countItems() {
@@ -178,7 +178,7 @@
/**
* Gets the string at the specified index in this
- * Choice menu.
+ * {@code Choice} menu.
*
* @param index the index at which to begin
* @return the item at the specified index
@@ -197,10 +197,10 @@
}
/**
- * Adds an item to this Choice menu.
+ * Adds an item to this {@code Choice} menu.
* @param item the item to be added
* @exception NullPointerException if the item's value is
- * null
+ * {@code null}
* @since 1.1
*/
public void add(String item) {
@@ -209,12 +209,12 @@
/**
* Obsolete as of Java 2 platform v1.1. Please use the
- * add method instead.
+ * {@code add} method instead.
* Choice menu.
+ * Adds an item to this {@code Choice} menu.
* @param item the item to be added
* @exception NullPointerException if the item's value is equal to
- * null
+ * {@code null}
*/
public void addItem(String item) {
synchronized (this) {
@@ -226,14 +226,14 @@
}
/**
- * Inserts an item to this Choice,
- * but does not invalidate the Choice.
+ * Inserts an item to this {@code Choice},
+ * but does not invalidate the {@code Choice}.
* Client methods must provide their own synchronization before
* invoking this method.
* @param item the item to be added
* @param index the new item position
* @exception NullPointerException if the item's value is equal to
- * null
+ * {@code null}
*/
private void insertNoInvalidate(String item, int index) {
if (item == null) {
@@ -255,10 +255,10 @@
/**
* Inserts the item into this choice at the specified position.
* Existing items at an index greater than or equal to
- * index are shifted up by one to accommodate
- * the new item. If index is greater than or
+ * {@code index} are shifted up by one to accommodate
+ * the new item. If {@code index} is greater than or
* equal to the number of items in this choice,
- * item is added to the end of this choice.
+ * {@code item} is added to the end of this choice.
* null item to be inserted
+ * @param item the non-{@code null} item to be inserted
* @param index the position at which the item should be inserted
* @exception IllegalArgumentException if index is less than 0
*/
@@ -286,14 +286,14 @@
}
/**
- * Removes the first occurrence of item
- * from the Choice menu. If the item
+ * Removes the first occurrence of {@code item}
+ * from the {@code Choice} menu. If the item
* being removed is the currently selected item,
* then the first item in the choice becomes the
* selected item. Otherwise, the currently selected
* item remains selected (and the selected index is
* updated accordingly).
- * @param item the item to remove from this Choice menu
+ * @param item the item to remove from this {@code Choice} menu
* @exception IllegalArgumentException if the item doesn't
* exist in the choice menu
* @since 1.1
@@ -336,8 +336,8 @@
}
/**
- * Removes an item from the Choice at the
- * specified position, but does not invalidate the Choice.
+ * Removes an item from the {@code Choice} at the
+ * specified position, but does not invalidate the {@code Choice}.
* Client methods must provide their
* own synchronization before invoking this method.
* @param position the position of the item
@@ -389,7 +389,7 @@
/**
* Returns an array (length 1) containing the currently selected
- * item. If this choice has no items, returns null.
+ * item. If this choice has no items, returns {@code null}.
* @see ItemSelectable
*/
public synchronized Object[] getSelectedObjects() {
@@ -414,14 +414,14 @@
}
/**
- * Sets the selected item in this Choice menu to be the
+ * Sets the selected item in this {@code Choice} menu to be the
* item at the specified position.
*
* ItemEvent. The only way to trigger an
- * ItemEvent is by user interaction.
+ * an {@code ItemEvent}. The only way to trigger an
+ * {@code ItemEvent} is by user interaction.
*
* @param pos the position of the selected item
* @exception IllegalArgumentException if the specified
@@ -444,7 +444,7 @@
}
/**
- * Sets the selected item in this Choice menu
+ * Sets the selected item in this {@code Choice} menu
* to be the item whose name is equal to the specified string.
* If more than one item matches (is equal to) the specified string,
* the one with the smallest index is selected.
@@ -452,8 +452,8 @@
* ItemEvent. The only way to trigger an
- * ItemEvent is by user interaction.
+ * an {@code ItemEvent}. The only way to trigger an
+ * {@code ItemEvent} is by user interaction.
*
* @param str the specified string
* @see #getSelectedItem
@@ -468,9 +468,9 @@
/**
* Adds the specified item listener to receive item events from
- * this Choice menu. Item events are sent in response
- * to user input, but not in response to calls to select.
- * If l is null, no exception is thrown and no action
+ * this {@code Choice} menu. Item events are sent in response
+ * to user input, but not in response to calls to {@code select}.
+ * If l is {@code null}, no exception is thrown and no action
* is performed.
* Choice menu.
- * If l is null, no exception is thrown and no
+ * item events from this {@code Choice} menu.
+ * If l is {@code null}, no exception is thrown and no
* action is performed.
* ItemListeners
+ * @return all of this choice's {@code ItemListener}s
* or an empty array if no item
* listeners are currently registered
*
@@ -532,16 +532,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this Choice.
+ * upon this {@code Choice}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * Choice c
+ * {@code Choice c}
* for its item listeners with the following code:
*
* ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
@@ -550,14 +550,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this choice,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getItemListeners
* @since 1.3
@@ -586,10 +586,10 @@
/**
* Processes events on this choice. If the event is an
- * instance of ItemEvent, it invokes the
- * processItemEvent method. Otherwise, it calls its
- * superclass's processEvent method.
- * null
+ * instance of {@code ItemEvent}, it invokes the
+ * {@code processItemEvent} method. Otherwise, it calls its
+ * superclass's {@code processEvent} method.
+ * Choice
+ * Processes item events occurring on this {@code Choice}
* menu by dispatching them to any registered
- * ItemListener objects.
+ * {@code ItemListener} objects.
*
- *
- * ItemListener object is registered
- * via addItemListener.
- * enableEvents.
+ * null
+ * Choice
+ * Returns a string representing the state of this {@code Choice}
* menu. This method is intended to be used only for debugging purposes,
* and the content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
- * @return the parameter string of this Choice menu
+ * @return the parameter string of this {@code Choice} menu
*/
protected String paramString() {
return super.paramString() + ",current=" + getSelectedItem();
@@ -662,18 +662,18 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable ItemListeners
+ * a list of serializable {@code ItemListeners}
* as optional data. The non-serializable
- * ItemListeners are detected and
+ * {@code ItemListeners} are detected and
* no attempt is made to serialize them.
*
- * @param s the ObjectOutputStream to write
- * @serialData null terminated sequence of 0
- * or more pairs; the pair consists of a String
- * and an Object; the String indicates
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData {@code null} terminated sequence of 0
+ * or more pairs; the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String} indicates
* the type of object and is one of the following:
- * itemListenerK indicating an
- * ItemListener object
+ * {@code itemListenerK} indicating an
+ * {@code ItemListener} object
*
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see java.awt.Component#itemListenerK
@@ -689,15 +689,15 @@
}
/**
- * Reads the ObjectInputStream and if it
- * isn't null adds a listener to receive
- * item events fired by the Choice item.
+ * Reads the {@code ObjectInputStream} and if it
+ * isn't {@code null} adds a listener to receive
+ * item events fired by the {@code Choice} item.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @serial
* @see #removeItemListener(ItemListener)
* @see #addItemListener(ItemListener)
@@ -733,14 +733,14 @@
/**
- * Gets the AccessibleContext associated with this
- * Choice. For Choice components,
- * the AccessibleContext takes the form of an
- * AccessibleAWTChoice. A new AccessibleAWTChoice
+ * Gets the {@code AccessibleContext} associated with this
+ * {@code Choice}. For {@code Choice} components,
+ * the {@code AccessibleContext} takes the form of an
+ * {@code AccessibleAWTChoice}. A new {@code AccessibleAWTChoice}
* instance is created if necessary.
*
- * @return an AccessibleAWTChoice that serves as the
- * AccessibleContext of this Choice
+ * @return an {@code AccessibleAWTChoice} that serves as the
+ * {@code AccessibleContext} of this {@code Choice}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
@@ -752,7 +752,7 @@
/**
* This class implements accessibility support for the
- * Choice class. It provides an implementation of the
+ * {@code Choice} class. It provides an implementation of the
* Java Accessibility API appropriate to choice user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/Color.java 2015-10-04 22:52:25.869274949 +0400
+++ new/src/java.desktop/share/classes/java/awt/Color.java 2015-10-04 22:52:25.681274958 +0400
@@ -32,7 +32,7 @@
import java.awt.color.ColorSpace;
/**
- * The Color class is used to encapsulate colors in the default
+ * The {@code Color} class is used to encapsulate colors in the default
* sRGB color space or colors in arbitrary color spaces identified by a
* {@link ColorSpace}. Every color has an implicit alpha value of 1.0 or
* an explicit one provided in the constructor. The alpha value
@@ -41,8 +41,8 @@
* An alpha value of 1.0 or 255 means that the color is completely
* opaque and an alpha value of 0 or 0.0 means that the color is
* completely transparent.
- * When constructing a Color with an explicit alpha or
- * getting the color/alpha components of a Color, the color
+ * When constructing a {@code Color} with an explicit alpha or
+ * getting the color/alpha components of a {@code Color}, the color
* components are never premultiplied by the alpha component.
* ColorSpace as
- * float components (no alpha).
- * If null after object construction, this must be an
+ * The color value in the default sRGB {@code ColorSpace} as
+ * {@code float} components (no alpha).
+ * If {@code null} after object construction, this must be an
* sRGB color constructed with 8-bit precision, so compute from the
- * int color value.
+ * {@code int} color value.
* @serial
* @see #getRGBColorComponents
* @see #getRGBComponents
@@ -222,11 +222,11 @@
private float frgbvalue[] = null;
/**
- * The color value in the native ColorSpace as
- * float components (no alpha).
- * If null after object construction, this must be an
+ * The color value in the native {@code ColorSpace} as
+ * {@code float} components (no alpha).
+ * If {@code null} after object construction, this must be an
* sRGB color constructed with 8-bit precision, so compute from the
- * int color value.
+ * {@code int} color value.
* @serial
* @see #getRGBColorComponents
* @see #getRGBComponents
@@ -234,9 +234,9 @@
private float fvalue[] = null;
/**
- * The alpha value as a float component.
- * If frgbvalue is null, this is not valid
- * data, so compute from the int color value.
+ * The alpha value as a {@code float} component.
+ * If {@code frgbvalue} is {@code null}, this is not valid
+ * data, so compute from the {@code int} color value.
* @serial
* @see #getRGBComponents
* @see #getComponents
@@ -244,7 +244,7 @@
private float falpha = 0.0f;
/**
- * The ColorSpace. If null, then it's
+ * The {@code ColorSpace}. If {@code null}, then it's
* default is sRGB.
* @serial
* @see #getColor
@@ -313,9 +313,9 @@
}
/**
- * Checks the color float components supplied for
+ * Checks the color {@code float} components supplied for
* validity.
- * Throws an IllegalArgumentException if the value is out
+ * Throws an {@code IllegalArgumentException} if the value is out
* of range.
* @param r the Red component
* @param g the Green component
@@ -354,8 +354,8 @@
* available for a given output device.
* Alpha is defaulted to 255.
*
- * @throws IllegalArgumentException if r, g
- * or b are outside of the range
+ * @throws IllegalArgumentException if {@code r}, {@code g}
+ * or {@code b} are outside of the range
* 0 to 255, inclusive
* @param r the red component
* @param g the green component
@@ -373,8 +373,8 @@
* Creates an sRGB color with the specified red, green, blue, and alpha
* values in the range (0 - 255).
*
- * @throws IllegalArgumentException if r, g,
- * b or a are outside of the range
+ * @throws IllegalArgumentException if {@code r}, {@code g},
+ * {@code b} or {@code a} are outside of the range
* 0 to 255, inclusive
* @param r the red component
* @param g the green component
@@ -418,12 +418,12 @@
* Creates an sRGB color with the specified combined RGBA value consisting
* of the alpha component in bits 24-31, the red component in bits 16-23,
* the green component in bits 8-15, and the blue component in bits 0-7.
- * If the hasalpha argument is false, alpha
+ * If the {@code hasalpha} argument is {@code false}, alpha
* is defaulted to 255.
*
* @param rgba the combined RGBA components
- * @param hasalpha true if the alpha bits are valid;
- * false otherwise
+ * @param hasalpha {@code true} if the alpha bits are valid;
+ * {@code false} otherwise
* @see java.awt.image.ColorModel#getRGBdefault
* @see #getRed
* @see #getGreen
@@ -446,8 +446,8 @@
* match given the color space available for a particular output
* device.
*
- * @throws IllegalArgumentException if r, g
- * or b are outside of the range
+ * @throws IllegalArgumentException if {@code r}, {@code g}
+ * or {@code b} are outside of the range
* 0.0 to 1.0, inclusive
* @param r the red component
* @param g the green component
@@ -473,8 +473,8 @@
* alpha values in the range (0.0 - 1.0). The actual color
* used in rendering depends on finding the best match given the
* color space available for a particular output device.
- * @throws IllegalArgumentException if r, g
- * b or a are outside of the range
+ * @throws IllegalArgumentException if {@code r}, {@code g}
+ * {@code b} or {@code a} are outside of the range
* 0.0 to 1.0, inclusive
* @param r the red component
* @param g the green component
@@ -497,19 +497,19 @@
}
/**
- * Creates a color in the specified ColorSpace
- * with the color components specified in the float
+ * Creates a color in the specified {@code ColorSpace}
+ * with the color components specified in the {@code float}
* array and the specified alpha. The number of components is
- * determined by the type of the ColorSpace. For
+ * determined by the type of the {@code ColorSpace}. For
* example, RGB requires 3 components, but CMYK requires 4
* components.
- * @param cspace the ColorSpace to be used to
+ * @param cspace the {@code ColorSpace} to be used to
* interpret the components
* @param components an arbitrary number of color components
- * that is compatible with the ColorSpace
+ * that is compatible with the {@code ColorSpace}
* @param alpha alpha value
* @throws IllegalArgumentException if any of the values in the
- * components array or alpha is
+ * {@code components} array or {@code alpha} is
* outside of the range 0.0 to 1.0
* @see #getComponents
* @see #getColorComponents
@@ -592,7 +592,7 @@
* (Bits 24-31 are alpha, 16-23 are red, 8-15 are green, 0-7 are
* blue).
* @return the RGB value of the color in the default sRGB
- * ColorModel.
+ * {@code ColorModel}.
* @see java.awt.image.ColorModel#getRGBdefault
* @see #getRed
* @see #getGreen
@@ -606,19 +606,19 @@
private static final double FACTOR = 0.7;
/**
- * Creates a new Color that is a brighter version of this
- * Color.
+ * Creates a new {@code Color} that is a brighter version of this
+ * {@code Color}.
* Color to create a brighter version
- * of this Color.
+ * components of this {@code Color} to create a brighter version
+ * of this {@code Color}.
* The {@code alpha} value is preserved.
- * Although brighter and
- * darker are inverse operations, the results of a
+ * Although {@code brighter} and
+ * {@code darker} are inverse operations, the results of a
* series of invocations of these two methods might be inconsistent
* because of rounding errors.
- * @return a new Color object that is
- * a brighter version of this Color
+ * @return a new {@code Color} object that is
+ * a brighter version of this {@code Color}
* with the same {@code alpha} value.
* @see java.awt.Color#darker
* @since 1.0
@@ -649,19 +649,19 @@
}
/**
- * Creates a new Color that is a darker version of this
- * Color.
+ * Creates a new {@code Color} that is a darker version of this
+ * {@code Color}.
* Color to create a darker version of
- * this Color.
+ * components of this {@code Color} to create a darker version of
+ * this {@code Color}.
* The {@code alpha} value is preserved.
- * Although brighter and
- * darker are inverse operations, the results of a series
+ * Although {@code brighter} and
+ * {@code darker} are inverse operations, the results of a series
* of invocations of these two methods might be inconsistent because
* of rounding errors.
- * @return a new Color object that is
- * a darker version of this Color
+ * @return a new {@code Color} object that is
+ * a darker version of this {@code Color}
* with the same {@code alpha} value.
* @see java.awt.Color#brighter
* @since 1.0
@@ -674,7 +674,7 @@
}
/**
- * Computes the hash code for this Color.
+ * Computes the hash code for this {@code Color}.
* @return a hash code value for this object.
* @since 1.0
*/
@@ -684,15 +684,15 @@
/**
* Determines whether another object is equal to this
- * Color.
+ * {@code Color}.
* true if and only if the argument is not
- * null and is a Color object that has the same
+ * The result is {@code true} if and only if the argument is not
+ * {@code null} and is a {@code Color} object that has the same
* red, green, blue, and alpha values as this object.
* @param obj the object to test for equality with this
- * Color
- * @return true if the objects are the same;
- * false otherwise.
+ * {@code Color}
+ * @return {@code true} if the objects are the same;
+ * {@code false} otherwise.
* @since 1.0
*/
public boolean equals(Object obj) {
@@ -700,25 +700,25 @@
}
/**
- * Returns a string representation of this Color. This
+ * Returns a string representation of this {@code Color}. This
* method is intended to be used only for debugging purposes. The
* content and format of the returned string might vary between
* implementations. The returned string might be empty but cannot
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this Color.
+ * @return a string representation of this {@code Color}.
*/
public String toString() {
return getClass().getName() + "[r=" + getRed() + ",g=" + getGreen() + ",b=" + getBlue() + "]";
}
/**
- * Converts a String to an integer and returns the
- * specified opaque Color. This method handles string
+ * Converts a {@code String} to an integer and returns the
+ * specified opaque {@code Color}. This method handles string
* formats that are used to represent octal and hexadecimal numbers.
- * @param nm a String that represents
+ * @param nm a {@code String} that represents
* an opaque color as a 24-bit integer
- * @return the new Color object.
+ * @return the new {@code Color} object.
* @see java.lang.Integer#decode
* @exception NumberFormatException if the specified string cannot
* be interpreted as a decimal,
@@ -736,13 +736,13 @@
* Color
+ * as an integer which is then converted to a {@code Color}
* object.
* null is returned.
+ * an integer then {@code null} is returned.
* @param nm the name of the color property
- * @return the Color converted from the system
+ * @return the {@code Color} converted from the system
* property.
* @see java.lang.System#getProperty(java.lang.String)
* @see java.lang.Integer#getInteger(java.lang.String)
@@ -758,16 +758,16 @@
* Color
+ * as an integer which is then converted to a {@code Color}
* object.
* Color specified by the second
+ * an integer then the {@code Color} specified by the second
* argument is returned instead.
* @param nm the name of the color property
- * @param v the default Color
- * @return the Color converted from the system
- * property, or the specified Color.
+ * @param v the default {@code Color}
+ * @return the {@code Color} converted from the system
+ * property, or the specified {@code Color}.
* @see java.lang.System#getProperty(java.lang.String)
* @see java.lang.Integer#getInteger(java.lang.String)
* @see java.awt.Color#Color(int)
@@ -787,16 +787,16 @@
* Color
+ * as an integer which is then converted to a {@code Color}
* object.
* v is used instead,
- * and is converted to a Color object.
+ * an integer then the integer value {@code v} is used instead,
+ * and is converted to a {@code Color} object.
* @param nm the name of the color property
* @param v the default color value, as an integer
- * @return the Color converted from the system
- * property or the Color converted from
+ * @return the {@code Color} converted from the system
+ * property or the {@code Color} converted from
* the specified integer.
* @see java.lang.System#getProperty(java.lang.String)
* @see java.lang.Integer#getInteger(java.lang.String)
@@ -813,19 +813,19 @@
* Converts the components of a color, as specified by the HSB
* model, to an equivalent set of values for the default RGB model.
* saturation and brightness components
+ * The {@code saturation} and {@code brightness} components
* should be floating-point values between zero and one
- * (numbers in the range 0.0-1.0). The hue component
+ * (numbers in the range 0.0-1.0). The {@code hue} component
* can be any floating-point number. The floor of this number is
* subtracted from it to create a fraction between 0 and 1. This
* fractional number is then multiplied by 360 to produce the hue
* angle in the HSB color model.
* HSBtoRGB encodes the
+ * The integer that is returned by {@code HSBtoRGB} encodes the
* value of a color in bits 0-23 of an integer value that is the same
* format used by the method {@link #getRGB() getRGB}.
* This integer can be supplied as an argument to the
- * Color constructor that takes a single integer argument.
+ * {@code Color} constructor that takes a single integer argument.
* @param hue the hue component of the color
* @param saturation the saturation of the color
* @param brightness the brightness of the color
@@ -887,15 +887,15 @@
* model, to an equivalent set of values for hue, saturation, and
* brightness that are the three components of the HSB model.
* hsbvals argument is null, then a
+ * If the {@code hsbvals} argument is {@code null}, then a
* new array is allocated to return the result. Otherwise, the method
- * returns the array hsbvals, with the values put into
+ * returns the array {@code hsbvals}, with the values put into
* that array.
* @param r the red component of the color
* @param g the green component of the color
* @param b the blue component of the color
* @param hsbvals the array used to return the
- * three HSB values, or null
+ * three HSB values, or {@code null}
* @return an array of three elements containing the hue, saturation,
* and brightness (in that order), of the color with
* the indicated red, green, and blue components.
@@ -942,12 +942,12 @@
}
/**
- * Creates a Color object based on the specified values
+ * Creates a {@code Color} object based on the specified values
* for the HSB color model.
* s and b components should be
+ * The {@code s} and {@code b} components should be
* floating-point values between zero and one
- * (numbers in the range 0.0-1.0). The h component
+ * (numbers in the range 0.0-1.0). The {@code h} component
* can be any floating-point number. The floor of this number is
* subtracted from it to create a fraction between 0 and 1. This
* fractional number is then multiplied by 360 to produce the hue
@@ -955,7 +955,7 @@
* @param h the hue component
* @param s the saturation of the color
* @param b the brightness of the color
- * @return a Color object with the specified hue,
+ * @return a {@code Color} object with the specified hue,
* saturation, and brightness.
* @since 1.0
*/
@@ -964,16 +964,16 @@
}
/**
- * Returns a float array containing the color and alpha
- * components of the Color, as represented in the default
+ * Returns a {@code float} array containing the color and alpha
+ * components of the {@code Color}, as represented in the default
* sRGB color space.
- * If compArray is null, an array of length
+ * If {@code compArray} is {@code null}, an array of length
* 4 is created for the return value. Otherwise,
- * compArray must have length 4 or greater,
+ * {@code compArray} must have length 4 or greater,
* and it is filled in with the components and returned.
* @param compArray an array that this method fills with
* color and alpha components and returns
- * @return the RGBA components in a float array.
+ * @return the RGBA components in a {@code float} array.
*/
public float[] getRGBComponents(float[] compArray) {
float[] f;
@@ -997,15 +997,15 @@
}
/**
- * Returns a float array containing only the color
- * components of the Color, in the default sRGB color
- * space. If compArray is null, an array of
+ * Returns a {@code float} array containing only the color
+ * components of the {@code Color}, in the default sRGB color
+ * space. If {@code compArray} is {@code null}, an array of
* length 3 is created for the return value. Otherwise,
- * compArray must have length 3 or greater, and it is
+ * {@code compArray} must have length 3 or greater, and it is
* filled in with the components and returned.
* @param compArray an array that this method fills with color
* components and returns
- * @return the RGB components in a float array.
+ * @return the RGB components in a {@code float} array.
*/
public float[] getRGBColorComponents(float[] compArray) {
float[] f;
@@ -1027,19 +1027,19 @@
}
/**
- * Returns a float array containing the color and alpha
- * components of the Color, in the
- * ColorSpace of the Color.
- * If compArray is null, an array with
+ * Returns a {@code float} array containing the color and alpha
+ * components of the {@code Color}, in the
+ * {@code ColorSpace} of the {@code Color}.
+ * If {@code compArray} is {@code null}, an array with
* length equal to the number of components in the associated
- * ColorSpace plus one is created for
- * the return value. Otherwise, compArray must have at
+ * {@code ColorSpace} plus one is created for
+ * the return value. Otherwise, {@code compArray} must have at
* least this length and it is filled in with the components and
* returned.
* @param compArray an array that this method fills with the color and
- * alpha components of this Color in its
- * ColorSpace and returns
- * @return the color and alpha components in a float
+ * alpha components of this {@code Color} in its
+ * {@code ColorSpace} and returns
+ * @return the color and alpha components in a {@code float}
* array.
*/
public float[] getComponents(float[] compArray) {
@@ -1060,19 +1060,19 @@
}
/**
- * Returns a float array containing only the color
- * components of the Color, in the
- * ColorSpace of the Color.
- * If compArray is null, an array with
+ * Returns a {@code float} array containing only the color
+ * components of the {@code Color}, in the
+ * {@code ColorSpace} of the {@code Color}.
+ * If {@code compArray} is {@code null}, an array with
* length equal to the number of components in the associated
- * ColorSpace is created for
- * the return value. Otherwise, compArray must have at
+ * {@code ColorSpace} is created for
+ * the return value. Otherwise, {@code compArray} must have at
* least this length and it is filled in with the components and
* returned.
* @param compArray an array that this method fills with the color
- * components of this Color in its
- * ColorSpace and returns
- * @return the color components in a float array.
+ * components of this {@code Color} in its
+ * {@code ColorSpace} and returns
+ * @return the color components in a {@code float} array.
*/
public float[] getColorComponents(float[] compArray) {
if (fvalue == null)
@@ -1091,19 +1091,19 @@
}
/**
- * Returns a float array containing the color and alpha
- * components of the Color, in the
- * ColorSpace specified by the cspace
- * parameter. If compArray is null, an
+ * Returns a {@code float} array containing the color and alpha
+ * components of the {@code Color}, in the
+ * {@code ColorSpace} specified by the {@code cspace}
+ * parameter. If {@code compArray} is {@code null}, an
* array with length equal to the number of components in
- * cspace plus one is created for the return value.
- * Otherwise, compArray must have at least this
+ * {@code cspace} plus one is created for the return value.
+ * Otherwise, {@code compArray} must have at least this
* length, and it is filled in with the components and returned.
- * @param cspace a specified ColorSpace
+ * @param cspace a specified {@code ColorSpace}
* @param compArray an array that this method fills with the
- * color and alpha components of this Color in
- * the specified ColorSpace and returns
- * @return the color and alpha components in a float
+ * color and alpha components of this {@code Color} in
+ * the specified {@code ColorSpace} and returns
+ * @return the color and alpha components in a {@code float}
* array.
*/
public float[] getComponents(ColorSpace cspace, float[] compArray) {
@@ -1136,19 +1136,19 @@
}
/**
- * Returns a float array containing only the color
- * components of the Color in the
- * ColorSpace specified by the cspace
- * parameter. If compArray is null, an array
+ * Returns a {@code float} array containing only the color
+ * components of the {@code Color} in the
+ * {@code ColorSpace} specified by the {@code cspace}
+ * parameter. If {@code compArray} is {@code null}, an array
* with length equal to the number of components in
- * cspace is created for the return value. Otherwise,
- * compArray must have at least this length, and it is
+ * {@code cspace} is created for the return value. Otherwise,
+ * {@code compArray} must have at least this length, and it is
* filled in with the components and returned.
- * @param cspace a specified ColorSpace
+ * @param cspace a specified {@code ColorSpace}
* @param compArray an array that this method fills with the color
- * components of this Color in the specified
- * ColorSpace
- * @return the color components in a float array.
+ * components of this {@code Color} in the specified
+ * {@code ColorSpace}
+ * @return the color components in a {@code float} array.
*/
public float[] getColorComponents(ColorSpace cspace, float[] compArray) {
if (cs == null) {
@@ -1175,8 +1175,8 @@
}
/**
- * Returns the ColorSpace of this Color.
- * @return this Color object's ColorSpace.
+ * Returns the {@code ColorSpace} of this {@code Color}.
+ * @return this {@code Color} object's {@code ColorSpace}.
*/
public ColorSpace getColorSpace() {
if (cs == null) {
@@ -1221,9 +1221,9 @@
}
/**
- * Returns the transparency mode for this Color. This is
- * required to implement the Paint interface.
- * @return this Color object's transparency mode.
+ * Returns the transparency mode for this {@code Color}. This is
+ * required to implement the {@code Paint} interface.
+ * @return this {@code Color} object's transparency mode.
* @see Paint
* @see Transparency
* @see #createContext
--- old/src/java.desktop/share/classes/java/awt/ColorPaintContext.java 2015-10-04 22:52:26.421274925 +0400
+++ new/src/java.desktop/share/classes/java/awt/ColorPaintContext.java 2015-10-04 22:52:26.229274933 +0400
@@ -50,7 +50,7 @@
* (Bits 24-31 are alpha, 16-23 are red, 8-15 are green, 0-7 are
* blue).
* @return the RGB value of the color in the default sRGB
- * ColorModel.
+ * {@code ColorModel}.
* @see java.awt.image.ColorModel#getRGBdefault
* @see #getRed
* @see #getGreen
--- old/src/java.desktop/share/classes/java/awt/Component.java 2015-10-04 22:52:26.961274900 +0400
+++ new/src/java.desktop/share/classes/java/awt/Component.java 2015-10-04 22:52:26.753274910 +0400
@@ -89,9 +89,9 @@
* that can be displayed on the screen and that can interact with the
* user. Examples of components are the buttons, checkboxes, and scrollbars
* of a typical graphical user interface. Component class is the abstract superclass of
+ * The {@code Component} class is the abstract superclass of
* the nonmenu-related Abstract Window Toolkit components. Class
- * Component can also be extended directly to create a
+ * {@code Component} can also be extended directly to create a
* lightweight component. A lightweight component is a component that is
* not associated with a native window. On the contrary, a heavyweight
* component is associated with a native window. The {@link #isLightweight()}
@@ -107,10 +107,10 @@
*
* Serialization
* It is important to note that only AWT listeners which conform
- * to the Serializable protocol will be saved when
+ * to the {@code Serializable} protocol will be saved when
* the object is stored. If an AWT object has listeners that
* aren't marked serializable, they will be dropped at
- * writeObject time. Developers will need, as always,
+ * {@code writeObject} time. Developers will need, as always,
* to consider the implications of making an object serializable.
* One situation to watch out for is this:
*
@@ -136,12 +136,12 @@
* }
* }
*
- * In this example, serializing aButton by itself
- * will cause MyApp and everything it refers to
+ * In this example, serializing {@code aButton} by itself
+ * will cause {@code MyApp} and everything it refers to
* to be serialized as well. The problem is that the listener
* is serializable by coincidence, not by design. To separate
- * the decisions about MyApp and the
- * ActionListener being serializable one can use a
+ * the decisions about {@code MyApp} and the
+ * {@code ActionListener} being serializable one can use a
* nested class, as in the following example:
*
* import java.awt.*;
@@ -194,7 +194,7 @@
/**
* The peer of the component. The peer implements the component's
- * behavior. The peer is set when the Component is
+ * behavior. The peer is set when the {@code Component} is
* added to a container that also is a peer.
* @see #addNotify
* @see #removeNotify
@@ -202,14 +202,14 @@
transient volatile ComponentPeer peer;
/**
- * The parent of the object. It may be null
+ * The parent of the object. It may be {@code null}
* for top-level components.
* @see #getParent
*/
transient Container parent;
/**
- * The AppContext of the component. Applets/Plugin may
+ * The {@code AppContext} of the component. Applets/Plugin may
* change the AppContext.
*/
transient AppContext appContext;
@@ -248,7 +248,7 @@
/**
* The foreground color for this component.
- * foreground can be null.
+ * {@code foreground} can be {@code null}.
*
* @serial
* @see #getForeground
@@ -258,7 +258,7 @@
/**
* The background color for this component.
- * background can be null.
+ * {@code background} can be {@code null}.
*
* @serial
* @see #getBackground
@@ -268,7 +268,7 @@
/**
* The font used by this component.
- * The font can be null.
+ * The {@code font} can be {@code null}.
*
* @serial
* @see #getFont
@@ -278,13 +278,13 @@
/**
* The font which the peer is currently using.
- * (null if no peer exists.)
+ * ({@code null} if no peer exists.)
*/
Font peerFont;
/**
* The cursor displayed when pointer is over this component.
- * This value can be null.
+ * This value can be {@code null}.
*
* @serial
* @see #getCursor
@@ -302,10 +302,10 @@
Locale locale;
/**
- * A reference to a GraphicsConfiguration object
+ * A reference to a {@code GraphicsConfiguration} object
* used to describe the characteristics of a graphics
* destination.
- * This value can be null.
+ * This value can be {@code null}.
*
* @since 1.3
* @serial
@@ -315,7 +315,7 @@
private transient GraphicsConfiguration graphicsConfig = null;
/**
- * A reference to a BufferStrategy object
+ * A reference to a {@code BufferStrategy} object
* used to manipulate the buffers on this component.
*
* @since 1.4
@@ -367,7 +367,7 @@
private volatile boolean valid = false;
/**
- * The DropTarget associated with this component.
+ * The {@code DropTarget} associated with this component.
*
* @since 1.2
* @serial
@@ -384,7 +384,7 @@
/**
* A component's name.
- * This field can be null.
+ * This field can be {@code null}.
*
* @serial
* @see #getName
@@ -394,7 +394,7 @@
/**
* A bool to determine whether the name has
- * been set explicitly. nameExplicitlySet will
+ * been set explicitly. {@code nameExplicitlySet} will
* be false if the name has not been set and
* true if it has.
*
@@ -523,7 +523,7 @@
= ComponentOrientation.UNKNOWN;
/**
- * newEventsOnly will be true if the event is
+ * {@code newEventsOnly} will be true if the event is
* one of the event types enabled for the component.
* It will then allow for normal processing to
* continue. If it is false the event is passed
@@ -565,13 +565,13 @@
static final String windowFocusListenerK = "windowFocusL";
/**
- * The eventMask is ONLY set by subclasses via
- * enableEvents.
+ * The {@code eventMask} is ONLY set by subclasses via
+ * {@code enableEvents}.
* The mask should NOT be set when listeners are registered
* so that we can distinguish the difference between when
* listeners request events and subclasses request them.
* One bit is used to indicate whether input methods are
- * enabled; this bit is set by enableInputMethods and is
+ * enabled; this bit is set by {@code enableInputMethods} and is
* on by default.
*
* @serial
@@ -604,15 +604,15 @@
}
/**
- * Ease-of-use constant for getAlignmentY().
+ * Ease-of-use constant for {@code getAlignmentY()}.
* Specifies an alignment to the top of the component.
* @see #getAlignmentY
*/
public static final float TOP_ALIGNMENT = 0.0f;
/**
- * Ease-of-use constant for getAlignmentY and
- * getAlignmentX. Specifies an alignment to
+ * Ease-of-use constant for {@code getAlignmentY} and
+ * {@code getAlignmentX}. Specifies an alignment to
* the center of the component
* @see #getAlignmentX
* @see #getAlignmentY
@@ -620,21 +620,21 @@
public static final float CENTER_ALIGNMENT = 0.5f;
/**
- * Ease-of-use constant for getAlignmentY.
+ * Ease-of-use constant for {@code getAlignmentY}.
* Specifies an alignment to the bottom of the component.
* @see #getAlignmentY
*/
public static final float BOTTOM_ALIGNMENT = 1.0f;
/**
- * Ease-of-use constant for getAlignmentX.
+ * Ease-of-use constant for {@code getAlignmentX}.
* Specifies an alignment to the left side of the component.
* @see #getAlignmentX
*/
public static final float LEFT_ALIGNMENT = 0.0f;
/**
- * Ease-of-use constant for getAlignmentX.
+ * Ease-of-use constant for {@code getAlignmentX}.
* Specifies an alignment to the right side of the component.
* @see #getAlignmentX
*/
@@ -646,8 +646,8 @@
private static final long serialVersionUID = -7644114512714619750L;
/**
- * If any PropertyChangeListeners have been registered,
- * the changeSupport field describes them.
+ * If any {@code PropertyChangeListeners} have been registered,
+ * the {@code changeSupport} field describes them.
*
* @serial
* @since 1.2
@@ -705,8 +705,8 @@
* size; not a developer specified minimum size). For sizes
* smaller than the minimum size the baseline may change in a way
* other than the baseline resize behavior indicates. Similarly,
- * as the size approaches Integer.MAX_VALUE and/or
- * Short.MAX_VALUE the baseline may change in a way
+ * as the size approaches {@code Integer.MAX_VALUE} and/or
+ * {@code Short.MAX_VALUE} the baseline may change in a way
* other than the baseline resize behavior indicates.
*
* @see #getBaselineResizeBehavior
@@ -716,11 +716,11 @@
public enum BaselineResizeBehavior {
/**
* Indicates the baseline remains fixed relative to the
- * y-origin. That is, getBaseline returns
+ * y-origin. That is, {@code getBaseline} returns
* the same value regardless of the height or width. For example, a
- * JLabel containing non-empty text with a
- * vertical alignment of TOP should have a
- * baseline type of CONSTANT_ASCENT.
+ * {@code JLabel} containing non-empty text with a
+ * vertical alignment of {@code TOP} should have a
+ * baseline type of {@code CONSTANT_ASCENT}.
*/
CONSTANT_ASCENT,
@@ -728,18 +728,18 @@
* Indicates the baseline remains fixed relative to the height
* and does not change as the width is varied. That is, for
* any height H the difference between H and
- * getBaseline(w, H) is the same. For example, a
- * JLabel containing non-empty text with a
- * vertical alignment of BOTTOM should have a
- * baseline type of CONSTANT_DESCENT.
+ * {@code getBaseline(w, H)} is the same. For example, a
+ * {@code JLabel} containing non-empty text with a
+ * vertical alignment of {@code BOTTOM} should have a
+ * baseline type of {@code CONSTANT_DESCENT}.
*/
CONSTANT_DESCENT,
/**
* Indicates the baseline remains a fixed distance from
* the center of the component. That is, for any height H the
- * difference between getBaseline(w, H) and
- * H / 2 is the same (plus or minus one depending upon
+ * difference between {@code getBaseline(w, H)} and
+ * {@code H / 2} is the same (plus or minus one depending upon
* rounding error).
* Component can be
+ * Constructs a new component. Class {@code Component} can be
* extended directly to create a lightweight component that does not
* utilize an opaque native window. A lightweight component must be
* hosted by a native container somewhere higher up in the component
- * tree (for example, by a Frame object).
+ * tree (for example, by a {@code Frame} object).
*/
protected Component() {
appContext = AppContext.getAppContext();
@@ -1004,8 +1004,8 @@
}
/**
- * Constructs a name for this component. Called by getName
- * when the name is null.
+ * Constructs a name for this component. Called by {@code getName}
+ * when the name is {@code null}.
*/
String constructComponentName() {
return null; // For strict compliance with prior platform versions, a Component
@@ -1071,8 +1071,8 @@
}
/**
- * Associate a DropTarget with this component.
- * The Component will receive drops only if it
+ * Associate a {@code DropTarget} with this component.
+ * The {@code Component} will receive drops only if it
* is enabled.
*
* @see #isEnabled
@@ -1119,8 +1119,8 @@
}
/**
- * Gets the DropTarget associated with this
- * Component.
+ * Gets the {@code DropTarget} associated with this
+ * {@code Component}.
*
* @return the drop target
*/
@@ -1128,18 +1128,18 @@
public synchronized DropTarget getDropTarget() { return dropTarget; }
/**
- * Gets the GraphicsConfiguration associated with this
- * Component.
- * If the Component has not been assigned a specific
- * GraphicsConfiguration,
- * the GraphicsConfiguration of the
- * Component object's top-level container is
+ * Gets the {@code GraphicsConfiguration} associated with this
+ * {@code Component}.
+ * If the {@code Component} has not been assigned a specific
+ * {@code GraphicsConfiguration},
+ * the {@code GraphicsConfiguration} of the
+ * {@code Component} object's top-level container is
* returned.
- * If the Component has been created, but not yet added
- * to a Container, this method returns null.
+ * If the {@code Component} has been created, but not yet added
+ * to a {@code Container}, this method returns {@code null}.
*
- * @return the GraphicsConfiguration used by this
- * Component or null
+ * @return the {@code GraphicsConfiguration} used by this
+ * {@code Component} or {@code null}
* @since 1.3
*/
public GraphicsConfiguration getGraphicsConfiguration() {
@@ -1178,8 +1178,8 @@
}
/**
- * Checks that this component's GraphicsDevice
- * idString matches the string argument.
+ * Checks that this component's {@code GraphicsDevice}
+ * {@code idString} matches the string argument.
*/
void checkGD(String stringID) {
if (graphicsConfig != null) {
@@ -1245,7 +1245,7 @@
* In order to account for peers' size requirements, components are invalidated
* before they are first shown on the screen. By the time the parent container
* is fully realized, all its components will be valid.
- * @return true if the component is valid, false
+ * @return {@code true} if the component is valid, {@code false}
* otherwise
* @see #validate
* @see #invalidate
@@ -1270,8 +1270,8 @@
* is made undisplayable. A containment hierarchy is made
* undisplayable when its ancestor window is disposed.
*
- * @return true if the component is displayable,
- * false otherwise
+ * @return {@code true} if the component is displayable,
+ * {@code false} otherwise
* @see Container#add(Component)
* @see Window#pack
* @see Window#show
@@ -1287,9 +1287,9 @@
* Determines whether this component should be visible when its
* parent is visible. Components are
* initially visible, with the exception of top level components such
- * as Frame objects.
- * @return true if the component is visible,
- * false otherwise
+ * as {@code Frame} objects.
+ * @return {@code true} if the component is visible,
+ * {@code false} otherwise
* @see #setVisible
* @since 1.0
*/
@@ -1303,9 +1303,9 @@
/**
* Determines whether this component will be displayed on the screen.
- * @return true if the component and all of its ancestors
+ * @return {@code true} if the component and all of its ancestors
* until a toplevel window or null parent are visible,
- * false otherwise
+ * {@code false} otherwise
*/
boolean isRecursivelyVisible() {
return visible && (parent == null || parent.isRecursivelyVisible());
@@ -1370,30 +1370,30 @@
}
/**
- * Returns the position of the mouse pointer in this Component's
- * coordinate space if the Component is directly under the mouse
- * pointer, otherwise returns null.
- * If the Component is not showing on the screen, this method
- * returns null even if the mouse pointer is above the area
- * where the Component would be displayed.
- * If the Component is partially or fully obscured by other
- * Components or native windows, this method returns a non-null
+ * Returns the position of the mouse pointer in this {@code Component}'s
+ * coordinate space if the {@code Component} is directly under the mouse
+ * pointer, otherwise returns {@code null}.
+ * If the {@code Component} is not showing on the screen, this method
+ * returns {@code null} even if the mouse pointer is above the area
+ * where the {@code Component} would be displayed.
+ * If the {@code Component} is partially or fully obscured by other
+ * {@code Component}s or native windows, this method returns a non-null
* value only if the mouse pointer is located above the unobscured part of the
- * Component.
+ * {@code Component}.
* Containers it returns a non-null value if the mouse is
- * above the Container itself or above any of its descendants.
+ * For {@code Container}s it returns a non-null value if the mouse is
+ * above the {@code Container} itself or above any of its descendants.
* Use {@link Container#getMousePosition(boolean)} if you need to exclude children.
* Component is under the mouse
- * pointer. If the return value of this method is null, mouse
- * pointer is not directly above the Component.
+ * that matters is whether a specific {@code Component} is under the mouse
+ * pointer. If the return value of this method is {@code null}, mouse
+ * pointer is not directly above the {@code Component}.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
* @see #isShowing
* @see Container#getMousePosition
- * @return mouse coordinates relative to this Component, or null
+ * @return mouse coordinates relative to this {@code Component}, or null
* @since 1.5
*/
public Point getMousePosition() throws HeadlessException {
@@ -1438,8 +1438,8 @@
* true if the component is showing,
- * false otherwise
+ * @return {@code true} if the component is showing,
+ * {@code false} otherwise
* @see #setVisible
* @since 1.0
*/
@@ -1455,9 +1455,9 @@
* Determines whether this component is enabled. An enabled component
* can respond to user input and generate events. Components are
* enabled initially by default. A component may be enabled or disabled by
- * calling its setEnabled method.
- * @return true if the component is enabled,
- * false otherwise
+ * calling its {@code setEnabled} method.
+ * @return {@code true} if the component is enabled,
+ * {@code false} otherwise
* @see #setEnabled
* @since 1.0
*/
@@ -1475,7 +1475,7 @@
/**
* Enables or disables this component, depending on the value of the
- * parameter b. An enabled component can respond to user
+ * parameter {@code b}. An enabled component can respond to user
* input and generate events. Components are enabled initially by default.
*
* true, this component is
+ * @param b If {@code true}, this component is
* enabled; otherwise this component is disabled
* @see #isEnabled
* @see #isLightweight
@@ -1496,7 +1496,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public void enable() {
@@ -1526,7 +1526,7 @@
* otherwise {@code false}
*
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public void enable(boolean b) {
@@ -1539,7 +1539,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public void disable() {
@@ -1629,12 +1629,12 @@
/**
* Shows or hides this component depending on the value of parameter
- * b.
+ * {@code b}.
* true, shows this component;
+ * @param b if {@code true}, shows this component;
* otherwise, hides this component
* @see #isVisible
* @see #invalidate
@@ -1646,7 +1646,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setVisible(boolean).
+ * replaced by {@code setVisible(boolean)}.
*/
@Deprecated
public void show() {
@@ -1689,7 +1689,7 @@
* otherwise {@code false}
*
* @deprecated As of JDK version 1.1,
- * replaced by setVisible(boolean).
+ * replaced by {@code setVisible(boolean)}.
*/
@Deprecated
public void show(boolean b) {
@@ -1714,7 +1714,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setVisible(boolean).
+ * replaced by {@code setVisible(boolean)}.
*/
@Deprecated
public void hide() {
@@ -1779,7 +1779,7 @@
/**
* Sets the foreground color of this component.
* @param c the color to become this component's
- * foreground color; if this parameter is null
+ * foreground color; if this parameter is {@code null}
* then this component will inherit
* the foreground color of its parent
* @see #getForeground
@@ -1802,11 +1802,11 @@
/**
* Returns whether the foreground color has been explicitly set for this
- * Component. If this method returns false, this Component is
+ * Component. If this method returns {@code false}, this Component is
* inheriting its foreground color from an ancestor.
*
- * @return true if the foreground color has been explicitly
- * set for this Component; false otherwise.
+ * @return {@code true} if the foreground color has been explicitly
+ * set for this Component; {@code false} otherwise.
* @since 1.4
*/
public boolean isForegroundSet() {
@@ -1839,7 +1839,7 @@
* may differ between operating systems.
*
* @param c the color to become this component's color;
- * if this parameter is null, then this
+ * if this parameter is {@code null}, then this
* component will inherit the background color of its parent
* @see #getBackground
* @since 1.0
@@ -1863,11 +1863,11 @@
/**
* Returns whether the background color has been explicitly set for this
- * Component. If this method returns false, this Component is
+ * Component. If this method returns {@code false}, this Component is
* inheriting its background color from an ancestor.
*
- * @return true if the background color has been explicitly
- * set for this Component; false otherwise.
+ * @return {@code true} if the background color has been explicitly
+ * set for this Component; {@code false} otherwise.
* @since 1.4
*/
public boolean isBackgroundSet() {
@@ -1906,7 +1906,7 @@
* invalidates the component hierarchy.
*
* @param f the font to become this component's font;
- * if this parameter is null then this
+ * if this parameter is {@code null} then this
* component will inherit the font of its parent
* @see #getFont
* @see #invalidate
@@ -1943,11 +1943,11 @@
/**
* Returns whether the font has been explicitly set for this Component. If
- * this method returns false, this Component is inheriting its
+ * this method returns {@code false}, this Component is inheriting its
* font from an ancestor.
*
- * @return true if the font has been explicitly set for this
- * Component; false otherwise.
+ * @return {@code true} if the font has been explicitly set for this
+ * Component; {@code false} otherwise.
* @since 1.4
*/
public boolean isFontSet() {
@@ -1959,7 +1959,7 @@
* @return this component's locale; if this component does not
* have a locale, the locale of its parent is returned
* @see #setLocale
- * @exception IllegalComponentStateException if the Component
+ * @exception IllegalComponentStateException if the {@code Component}
* does not have its own locale and has not yet been added to
* a containment hierarchy such that the locale can be determined
* from the containing parent
@@ -2003,7 +2003,7 @@
}
/**
- * Gets the instance of ColorModel used to display
+ * Gets the instance of {@code ColorModel} used to display
* the component on the output device.
* @return the color model used by this component
* @see java.awt.image.ColorModel
@@ -2028,13 +2028,13 @@
* setLocation() in rapid succession). For this
+ * of {@code setLocation()} in rapid succession). For this
* reason, the recommended method of obtaining a component's position is
- * within java.awt.event.ComponentListener.componentMoved(),
+ * within {@code java.awt.event.ComponentListener.componentMoved()},
* which is called after the operating system has finished moving the
* component.
* Point representing
+ * @return an instance of {@code Point} representing
* the top-left corner of the component's bounds in
* the coordinate space of the component's parent
* @see #setLocation
@@ -2049,7 +2049,7 @@
* Gets the location of this component in the form of a point
* specifying the component's top-left corner in the screen's
* coordinate space.
- * @return an instance of Point representing
+ * @return an instance of {@code Point} representing
* the top-left corner of the component's bounds in the
* coordinate space of the screen
* @throws IllegalComponentStateException if the
@@ -2095,7 +2095,7 @@
*
* @return the location of this component's top left corner
* @deprecated As of JDK version 1.1,
- * replaced by getLocation().
+ * replaced by {@code getLocation()}.
*/
@Deprecated
public Point location() {
@@ -2108,7 +2108,7 @@
/**
* Moves this component to a new location. The top-left corner of
- * the new location is specified by the x and y
+ * the new location is specified by the {@code x} and {@code y}
* parameters in the coordinate space of this component's parent.
* setLocation(int, int).
+ * replaced by {@code setLocation(int, int)}.
*/
@Deprecated
public void move(int x, int y) {
@@ -2148,8 +2148,8 @@
/**
* Moves this component to a new location. The top-left corner of
- * the new location is specified by point p. Point
- * p is given in the parent's coordinate space.
+ * the new location is specified by point {@code p}. Point
+ * {@code p} is given in the parent's coordinate space.
* Dimension object. The height
- * field of the Dimension object contains
- * this component's height, and the width
- * field of the Dimension object contains
+ * {@code Dimension} object. The {@code height}
+ * field of the {@code Dimension} object contains
+ * this component's height, and the {@code width}
+ * field of the {@code Dimension} object contains
* this component's width.
- * @return a Dimension object that indicates the
+ * @return a {@code Dimension} object that indicates the
* size of this component
* @see #setSize
* @since 1.1
@@ -2189,7 +2189,7 @@
* @return the {@code Dimension} object that indicates the
* size of this component
* @deprecated As of JDK version 1.1,
- * replaced by getSize().
+ * replaced by {@code getSize()}.
*/
@Deprecated
public Dimension size() {
@@ -2197,8 +2197,8 @@
}
/**
- * Resizes this component so that it has width width
- * and height height.
+ * Resizes this component so that it has width {@code width}
+ * and height {@code height}.
* setSize(int, int).
+ * replaced by {@code setSize(int, int)}.
*/
@Deprecated
public void resize(int width, int height) {
@@ -2231,8 +2231,8 @@
}
/**
- * Resizes this component so that it has width d.width
- * and height d.height.
+ * Resizes this component so that it has width {@code d.width}
+ * and height {@code d.height}.
* setSize(Dimension).
+ * replaced by {@code setSize(Dimension)}.
*/
@Deprecated
public void resize(Dimension d) {
@@ -2264,7 +2264,7 @@
/**
* Gets the bounds of this component in the form of a
- * Rectangle object. The bounds specify this
+ * {@code Rectangle} object. The bounds specify this
* component's width, height, and location relative to
* its parent.
* @return a rectangle indicating this component's bounds
@@ -2281,7 +2281,7 @@
*
* @return the bounding rectangle for this component
* @deprecated As of JDK version 1.1,
- * replaced by getBounds().
+ * replaced by {@code getBounds()}.
*/
@Deprecated
public Rectangle bounds() {
@@ -2290,16 +2290,16 @@
/**
* Moves and resizes this component. The new location of the top-left
- * corner is specified by x and y, and the
- * new size is specified by width and height.
+ * corner is specified by {@code x} and {@code y}, and the
+ * new size is specified by {@code width} and {@code height}.
* width of this component
- * @param height the new height of this
+ * @param width the new {@code width} of this component
+ * @param height the new {@code height} of this
* component
* @see #getBounds
* @see #setLocation(int, int)
@@ -2322,7 +2322,7 @@
* @param height the height of the rectangle
*
* @deprecated As of JDK version 1.1,
- * replaced by setBounds(int, int, int, int).
+ * replaced by {@code setBounds(int, int, int, int)}.
*/
@Deprecated
public void reshape(int x, int y, int width, int height) {
@@ -2442,10 +2442,10 @@
/**
* Moves and resizes this component to conform to the new
- * bounding rectangle r. This component's new
- * position is specified by r.x and r.y,
- * and its new size is specified by r.width and
- * r.height
+ * bounding rectangle {@code r}. This component's new
+ * position is specified by {@code r.x} and {@code r.y},
+ * and its new size is specified by {@code r.width} and
+ * {@code r.height}
* component.getBounds().x,
- * or component.getLocation().x because it doesn't
+ * {@code component.getBounds().x},
+ * or {@code component.getLocation().x} because it doesn't
* cause any heap allocations.
*
* @return the current x coordinate of the components origin
@@ -2483,8 +2483,8 @@
/**
* Returns the current y coordinate of the components origin.
* This method is preferable to writing
- * component.getBounds().y,
- * or component.getLocation().y because it
+ * {@code component.getBounds().y},
+ * or {@code component.getLocation().y} because it
* doesn't cause any heap allocations.
*
* @return the current y coordinate of the components origin
@@ -2498,8 +2498,8 @@
/**
* Returns the current width of this component.
* This method is preferable to writing
- * component.getBounds().width,
- * or component.getSize().width because it
+ * {@code component.getBounds().width},
+ * or {@code component.getSize().width} because it
* doesn't cause any heap allocations.
*
* @return the current width of this component
@@ -2513,8 +2513,8 @@
/**
* Returns the current height of this component.
* This method is preferable to writing
- * component.getBounds().height,
- * or component.getSize().height because it
+ * {@code component.getBounds().height},
+ * or {@code component.getSize().height} because it
* doesn't cause any heap allocations.
*
* @return the current height of this component
@@ -2526,10 +2526,10 @@
/**
* Stores the bounds of this component into "return value" rv and
- * return rv. If rv is null a new
- * Rectangle is allocated.
- * This version of getBounds is useful if the caller
- * wants to avoid allocating a new Rectangle object
+ * return rv. If rv is {@code null} a new
+ * {@code Rectangle} is allocated.
+ * This version of {@code getBounds} is useful if the caller
+ * wants to avoid allocating a new {@code Rectangle} object
* on the heap.
*
* @param rv the return value, modified to the components bounds
@@ -2547,10 +2547,10 @@
/**
* Stores the width/height of this component into "return value" rv
- * and return rv. If rv is null a new
- * Dimension object is allocated. This version of
- * getSize is useful if the caller wants to avoid
- * allocating a new Dimension object on the heap.
+ * and return rv. If rv is {@code null} a new
+ * {@code Dimension} object is allocated. This version of
+ * {@code getSize} is useful if the caller wants to avoid
+ * allocating a new {@code Dimension} object on the heap.
*
* @param rv the return value, modified to the components size
* @return rv
@@ -2567,10 +2567,10 @@
/**
* Stores the x,y origin of this component into "return value" rv
- * and return rv. If rv is null a new
- * Point is allocated.
- * This version of getLocation is useful if the
- * caller wants to avoid allocating a new Point
+ * and return rv. If rv is {@code null} a new
+ * {@code Point} is allocated.
+ * This version of {@code getLocation} is useful if the
+ * caller wants to avoid allocating a new {@code Point}
* object on the heap.
*
* @param rv the return value, modified to the components location
@@ -2615,12 +2615,12 @@
/**
* A lightweight component doesn't have a native toolkit peer.
- * Subclasses of Component and Container,
- * other than the ones defined in this package like Button
- * or Scrollbar, are lightweight.
+ * Subclasses of {@code Component} and {@code Container},
+ * other than the ones defined in this package like {@code Button}
+ * or {@code Scrollbar}, are lightweight.
* All of the Swing components are lightweights.
* false if this component
+ * This method will always return {@code false} if this component
* is not displayable because it is impossible to determine the
* weight of an undisplayable component.
*
@@ -2636,8 +2636,8 @@
/**
* Sets the preferred size of this component to a constant
- * value. Subsequent calls to getPreferredSize will always
- * return this value. Setting the preferred size to null
+ * value. Subsequent calls to {@code getPreferredSize} will always
+ * return this value. Setting the preferred size to {@code null}
* restores the default behavior.
*
* @param preferredSize The new preferred size, or null
@@ -2664,9 +2664,9 @@
/**
* Returns true if the preferred size has been set to a
- * non-null value otherwise returns false.
+ * non-{@code null} value otherwise returns false.
*
- * @return true if setPreferredSize has been invoked
+ * @return true if {@code setPreferredSize} has been invoked
* with a non-null value.
* @since 1.5
*/
@@ -2691,7 +2691,7 @@
*
* @return the component's preferred size
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize().
+ * replaced by {@code getPreferredSize()}.
*/
@Deprecated
public Dimension preferredSize() {
@@ -2712,8 +2712,8 @@
/**
* Sets the minimum size of this component to a constant
- * value. Subsequent calls to getMinimumSize will always
- * return this value. Setting the minimum size to null
+ * value. Subsequent calls to {@code getMinimumSize} will always
+ * return this value. Setting the minimum size to {@code null}
* restores the default behavior.
*
* @param minimumSize the new minimum size of this component
@@ -2738,10 +2738,10 @@
}
/**
- * Returns whether or not setMinimumSize has been
+ * Returns whether or not {@code setMinimumSize} has been
* invoked with a non-null value.
*
- * @return true if setMinimumSize has been invoked with a
+ * @return true if {@code setMinimumSize} has been invoked with a
* non-null value.
* @since 1.5
*/
@@ -2764,7 +2764,7 @@
*
* @return the minimum size of this component
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize().
+ * replaced by {@code getMinimumSize()}.
*/
@Deprecated
public Dimension minimumSize() {
@@ -2785,11 +2785,11 @@
/**
* Sets the maximum size of this component to a constant
- * value. Subsequent calls to getMaximumSize will always
- * return this value. Setting the maximum size to null
+ * value. Subsequent calls to {@code getMaximumSize} will always
+ * return this value. Setting the maximum size to {@code null}
* restores the default behavior.
*
- * @param maximumSize a Dimension containing the
+ * @param maximumSize a {@code Dimension} containing the
* desired maximum allowable size
* @see #getMaximumSize
* @see #isMaximumSizeSet
@@ -2812,10 +2812,10 @@
}
/**
- * Returns true if the maximum size has been set to a non-null
+ * Returns true if the maximum size has been set to a non-{@code null}
* value otherwise returns false.
*
- * @return true if maximumSize is non-null,
+ * @return true if {@code maximumSize} is non-{@code null},
* false otherwise
* @since 1.5
*/
@@ -2866,16 +2866,16 @@
/**
* Returns the baseline. The baseline is measured from the top of
* the component. This method is primarily meant for
- * LayoutManagers to align components along their
+ * {@code LayoutManager}s to align components along their
* baseline. A return value less than 0 indicates this component
* does not have a reasonable baseline and that
- * LayoutManagers should not align this component on
+ * {@code LayoutManager}s should not align this component on
* its baseline.
* getBaselineResizeBehavior
+ * size >= the minimum size and {@code getBaselineResizeBehavior}
* can be used to determine how the baseline changes with size.
*
* @param width the width to get the baseline for
@@ -2901,15 +2901,15 @@
* layout managers and GUI builders.
* BaselineResizeBehavior.OTHER. Subclasses that have a
+ * {@code BaselineResizeBehavior.OTHER}. Subclasses that have a
* baseline should override appropriately. Subclasses should
- * never return null; if the baseline can not be
- * calculated return BaselineResizeBehavior.OTHER. Callers
+ * never return {@code null}; if the baseline can not be
+ * calculated return {@code BaselineResizeBehavior.OTHER}. Callers
* should first ask for the baseline using
- * getBaseline and if a value >= 0 is returned use
+ * {@code getBaseline} and if a value >= 0 is returned use
* this method. It is acceptable for this method to return a
- * value other than BaselineResizeBehavior.OTHER even if
- * getBaseline returns a value less than 0.
+ * value other than {@code BaselineResizeBehavior.OTHER} even if
+ * {@code getBaseline} returns a value less than 0.
*
* @return an enum indicating how the baseline changes as the component
* size changes
@@ -2933,7 +2933,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by doLayout().
+ * replaced by {@code doLayout()}.
*/
@Deprecated
public void layout() {
@@ -3082,9 +3082,9 @@
/**
* Creates a graphics context for this component. This method will
- * return null if this component is currently not
+ * return {@code null} if this component is currently not
* displayable.
- * @return a graphics context for this component, or null
+ * @return a graphics context for this component, or {@code null}
* if it has none
* @see #paint
* @since 1.0
@@ -3146,7 +3146,7 @@
* {@link Font Font} class.
* @param font the font for which font metrics is to be
* obtained
- * @return the font metrics for font
+ * @return the font metrics for {@code font}
* @see #getFont
* @see java.awt.peer.ComponentPeer#getFontMetrics(Font)
* @see Toolkit#getFontMetrics(Font)
@@ -3169,19 +3169,19 @@
/**
* Sets the cursor image to the specified cursor. This cursor
- * image is displayed when the contains method for
+ * image is displayed when the {@code contains} method for
* this component returns true for the current cursor location, and
* this Component is visible, displayable, and enabled. Setting the
- * cursor of a Container causes that cursor to be displayed
+ * cursor of a {@code Container} causes that cursor to be displayed
* within all of the container's subcomponents, except for those
- * that have a non-null cursor.
+ * that have a non-{@code null} cursor.
* Cursor class;
- * if this parameter is null
+ * by the {@code Cursor} class;
+ * if this parameter is {@code null}
* then this component will inherit
* the cursor of its parent
* @see #isEnabled
@@ -3221,7 +3221,7 @@
* Gets the cursor set in the component. If the component does
* not have a cursor set, the cursor of its parent is returned.
* If no cursor is set in the entire hierarchy,
- * Cursor.DEFAULT_CURSOR is returned.
+ * {@code Cursor.DEFAULT_CURSOR} is returned.
*
* @return the cursor for this component
* @see #setCursor
@@ -3246,11 +3246,11 @@
/**
* Returns whether the cursor has been explicitly set for this Component.
- * If this method returns false, this Component is inheriting
+ * If this method returns {@code false}, this Component is inheriting
* its cursor from an ancestor.
*
- * @return true if the cursor has been explicitly set for this
- * Component; false otherwise.
+ * @return {@code true} if the cursor has been explicitly set for this
+ * Component; {@code false} otherwise.
* @since 1.4
*/
public boolean isCursorSet() {
@@ -3263,12 +3263,12 @@
* This method is called when the contents of the component should
* be painted; such as when the component is first being shown or
* is damaged and in need of repair. The clip rectangle in the
- * Graphics parameter is set to the area
+ * {@code Graphics} parameter is set to the area
* which needs to be painted.
- * Subclasses of Component that override this
- * method need not call super.paint(g).
+ * Subclasses of {@code Component} that override this
+ * method need not call {@code super.paint(g)}.
* Components with zero width
+ * For performance reasons, {@code Component}s with zero width
* or height aren't considered to need painting when they are first shown,
* and also aren't considered to need repair.
* update method in response to
- * a call to repaint. You can assume that
+ * AWT calls the {@code update} method in response to
+ * a call to {@code repaint}. You can assume that
* the background is not cleared.
* update method of Component
- * calls this component's paint method to redraw
+ * The {@code update} method of {@code Component}
+ * calls this component's {@code paint} method to redraw
* this component. This method is commonly overridden by subclasses
* which need to do additional work in response to a call to
- * repaint.
+ * {@code repaint}.
* Subclasses of Component that override this method should either
- * call super.update(g), or call paint(g)
- * directly from their update method.
+ * call {@code super.update(g)}, or call {@code paint(g)}
+ * directly from their {@code update} method.
* 0, 0) coordinate point, is the
+ * ({@code 0}, {@code 0}) coordinate point, is the
* top-left corner of this component. The clipping region of the
* graphics context is the bounding rectangle of this component.
*
@@ -3325,7 +3325,7 @@
* Paints this component and all of its subcomponents.
* 0, 0) coordinate point, is the
+ * ({@code 0}, {@code 0}) coordinate point, is the
* top-left corner of this component. The clipping region of the
* graphics context is the bounding rectangle of this component.
*
@@ -3363,9 +3363,9 @@
* Repaints this component.
* paint
+ * causes a call to this component's {@code paint}
* method as soon as possible. Otherwise, this method causes
- * a call to this component's update method as soon
+ * a call to this component's {@code update} method as soon
* as possible.
* paint
- * within tm milliseconds.
+ * component, this results in a call to {@code paint}
+ * within {@code tm} milliseconds.
* paint method
+ * causes a call to this component's {@code paint} method
* as soon as possible. Otherwise, this method causes a call to
- * this component's update method as soon as possible.
+ * this component's {@code update} method as soon as possible.
* tm milliseconds.
+ * {@code tm} milliseconds.
* paint method.
+ * a call to this component's {@code paint} method.
* Otherwise, this method causes a call to this component's
- * update method.
+ * {@code update} method.
* paint method.
+ * {@code paint} method.
* 0, 0) coordinate point, is the
+ * ({@code 0}, {@code 0}) coordinate point, is the
* top-left corner of this component. The clipping region of the
* graphics context is the bounding rectangle of this component.
* @param g the graphics context to use for printing
@@ -3507,7 +3507,7 @@
* Prints this component and all of its subcomponents.
* 0, 0) coordinate point, is the
+ * ({@code 0}, {@code 0}) coordinate point, is the
* top-left corner of this component. The clipping region of the
* graphics context is the bounding rectangle of this component.
* @param g the graphics context to use for printing
@@ -3550,41 +3550,41 @@
/**
* Repaints the component when the image has changed.
- * This imageUpdate method of an ImageObserver
+ * This {@code imageUpdate} method of an {@code ImageObserver}
* is called when more information about an
* image which had been previously requested using an asynchronous
- * routine such as the drawImage method of
- * Graphics becomes available.
- * See the definition of imageUpdate for
+ * routine such as the {@code drawImage} method of
+ * {@code Graphics} becomes available.
+ * See the definition of {@code imageUpdate} for
* more information on this method and its arguments.
* imageUpdate method of Component
+ * The {@code imageUpdate} method of {@code Component}
* incrementally draws an image on the component as more of the bits
* of the image are available.
* awt.image.incrementaldraw
- * is missing or has the value true, the image is
+ * If the system property {@code awt.image.incrementaldraw}
+ * is missing or has the value {@code true}, the image is
* incrementally drawn. If the system property has any other value,
* then the image is not drawn until it has been completely loaded.
* awt.image.redrawrate is interpreted
+ * system property {@code awt.image.redrawrate} is interpreted
* as an integer to give the maximum redraw rate, in milliseconds. If
* the system property is missing or cannot be interpreted as an
* integer, the redraw rate is once every 100ms.
* x, y,
- * width, and height arguments depends on
- * the value of the infoflags argument.
+ * The interpretation of the {@code x}, {@code y},
+ * {@code width}, and {@code height} arguments depends on
+ * the value of the {@code infoflags} argument.
*
* @param img the image being observed
- * @param infoflags see imageUpdate for more information
+ * @param infoflags see {@code imageUpdate} for more information
* @param x the x coordinate
* @param y the y coordinate
* @param w the width
* @param h the height
- * @return false if the infoflags indicate that the
- * image is completely loaded; true otherwise.
+ * @return {@code false} if the infoflags indicate that the
+ * image is completely loaded; {@code true} otherwise.
*
* @see java.awt.image.ImageObserver
* @see Graphics#drawImage(Image, int, int, Color, java.awt.image.ImageObserver)
@@ -3633,10 +3633,10 @@
* @param width the specified width
* @param height the specified height
* @return an off-screen drawable image, which can be used for double
- * buffering. The return value may be null if the
+ * buffering. The return value may be {@code null} if the
* component is not displayable. This will always happen if
- * GraphicsEnvironment.isHeadless() returns
- * true.
+ * {@code GraphicsEnvironment.isHeadless()} returns
+ * {@code true}.
* @see #isDisplayable
* @see GraphicsEnvironment#isHeadless
* @since 1.0
@@ -3657,10 +3657,10 @@
* @param width the specified width.
* @param height the specified height.
* @return an off-screen drawable image, which can be used for double
- * buffering. The return value may be null if the
+ * buffering. The return value may be {@code null} if the
* component is not displayable. This will always happen if
- * GraphicsEnvironment.isHeadless() returns
- * true.
+ * {@code GraphicsEnvironment.isHeadless()} returns
+ * {@code true}.
* @see java.awt.image.VolatileImage
* @see #isDisplayable
* @see GraphicsEnvironment#isHeadless
@@ -3683,7 +3683,7 @@
* Creates a volatile off-screen drawable image, with the given capabilities.
* The contents of this image may be lost at any time due
* to operating system issues, so the image must be managed
- * via the VolatileImage interface.
+ * via the {@code VolatileImage} interface.
* @param width the specified width.
* @param height the specified height.
* @param caps the image capabilities
@@ -3704,12 +3704,12 @@
* Prepares an image for rendering on this component. The image
* data is downloaded asynchronously in another thread and the
* appropriate screen representation of the image is generated.
- * @param image the Image for which to
+ * @param image the {@code Image} for which to
* prepare a screen representation
- * @param observer the ImageObserver object
+ * @param observer the {@code ImageObserver} object
* to be notified as the image is being prepared
- * @return true if the image has already been fully
- * prepared; false otherwise
+ * @return {@code true} if the image has already been fully
+ * prepared; {@code false} otherwise
* @since 1.0
*/
public boolean prepareImage(Image image, ImageObserver observer) {
@@ -3723,14 +3723,14 @@
* The image data is downloaded asynchronously in another thread,
* and an appropriately scaled screen representation of the image is
* generated.
- * @param image the instance of Image
+ * @param image the instance of {@code Image}
* for which to prepare a screen representation
* @param width the width of the desired screen representation
* @param height the height of the desired screen representation
- * @param observer the ImageObserver object
+ * @param observer the {@code ImageObserver} object
* to be notified as the image is being prepared
- * @return true if the image has already been fully
- * prepared; false otherwise
+ * @return {@code true} if the image has already been fully
+ * prepared; {@code false} otherwise
* @see java.awt.image.ImageObserver
* @since 1.0
*/
@@ -3753,17 +3753,17 @@
* of the specified image.
* prepareImage method
+ * application must use the {@code prepareImage} method
* to force the loading of an image.
* ImageObserver interface.
- * @param image the Image object whose status
+ * with the discussion of the {@code ImageObserver} interface.
+ * @param image the {@code Image} object whose status
* is being checked
- * @param observer the ImageObserver
+ * @param observer the {@code ImageObserver}
* object to be notified as the image is being prepared
* @return the bitwise inclusive OR of
- * ImageObserver flags indicating what
+ * {@code ImageObserver} flags indicating what
* information about the image is currently available
* @see #prepareImage(Image, int, int, java.awt.image.ImageObserver)
* @see Toolkit#checkImage(Image, int, int, java.awt.image.ImageObserver)
@@ -3779,27 +3779,27 @@
* of the specified image.
* prepareImage method
+ * application must use the {@code prepareImage} method
* to force the loading of an image.
* checkImage method of Component
- * calls its peer's checkImage method to calculate
+ * The {@code checkImage} method of {@code Component}
+ * calls its peer's {@code checkImage} method to calculate
* the flags. If this component does not yet have a peer, the
- * component's toolkit's checkImage method is called
+ * component's toolkit's {@code checkImage} method is called
* instead.
* ImageObserver interface.
- * @param image the Image object whose status
+ * with the discussion of the {@code ImageObserver} interface.
+ * @param image the {@code Image} object whose status
* is being checked
* @param width the width of the scaled version
* whose status is to be checked
* @param height the height of the scaled version
* whose status is to be checked
- * @param observer the ImageObserver object
+ * @param observer the {@code ImageObserver} object
* to be notified as the image is being prepared
* @return the bitwise inclusive OR of
- * ImageObserver flags indicating what
+ * {@code ImageObserver} flags indicating what
* information about the image is currently available
* @see #prepareImage(Image, int, int, java.awt.image.ImageObserver)
* @see Toolkit#checkImage(Image, int, int, java.awt.image.ImageObserver)
@@ -3824,7 +3824,7 @@
* Creates a new strategy for multi-buffering on this component.
* Multi-buffering is useful for rendering performance. This method
* attempts to create the best strategy available with the number of
- * buffers supplied. It will always create a BufferStrategy
+ * buffers supplied. It will always create a {@code BufferStrategy}
* with that number of buffers.
* A page-flipping strategy is attempted first, then a blitting strategy
* using accelerated buffers. Finally, an unaccelerated blitting
@@ -3885,17 +3885,17 @@
* buffer capabilities).
* dispose will be invoked on the existing
- * BufferStrategy.
+ * is called, {@code dispose} will be invoked on the existing
+ * {@code BufferStrategy}.
* @param numBuffers number of buffers to create
* @param caps the required capabilities for creating the buffer strategy;
- * cannot be null
+ * cannot be {@code null}
* @exception AWTException if the capabilities supplied could not be
* supported or met; this may happen, for example, if there is not enough
* accelerated memory currently available, or if page flipping is specified
* but not possible.
* @exception IllegalArgumentException if numBuffers is less than 1, or if
- * caps is null
+ * caps is {@code null}
* @see Window#getBufferStrategy()
* @see Canvas#getBufferStrategy()
* @since 1.4
@@ -3980,7 +3980,7 @@
/**
* Inner class for flipping buffers on a component. That component must
- * be a Canvas or Window or Applet.
+ * be a {@code Canvas} or {@code Window} or {@code Applet}.
* @see Canvas
* @see Window
* @see Applet
@@ -4031,8 +4031,8 @@
/**
* Creates a new flipping buffer strategy for this component.
- * The component must be a Canvas or Window or
- * Applet.
+ * The component must be a {@code Canvas} or {@code Window} or
+ * {@code Applet}.
* @see Canvas
* @see Window
* @see Applet
@@ -4069,14 +4069,14 @@
* @param numBuffers number of buffers to create; must be greater than
* one
* @param caps the capabilities of the buffers.
- * BufferCapabilities.isPageFlipping must be
- * true.
+ * {@code BufferCapabilities.isPageFlipping} must be
+ * {@code true}.
* @exception AWTException if the capabilities supplied could not be
* supported or met
* @exception IllegalStateException if the component has no peer
* @exception IllegalArgumentException if numBuffers is less than two,
- * or if BufferCapabilities.isPageFlipping is not
- * true.
+ * or if {@code BufferCapabilities.isPageFlipping} is not
+ * {@code true}.
* @see java.awt.BufferCapabilities#isPageFlipping()
*/
protected void createBuffers(int numBuffers, BufferCapabilities caps)
@@ -4157,7 +4157,7 @@
* either by copying or by moving the video pointer.
* @param flipAction an integer value describing the flipping action
* for the contents of the back buffer. This should be one of the
- * values of the BufferCapabilities.FlipContents
+ * values of the {@code BufferCapabilities.FlipContents}
* property.
* @exception IllegalStateException if the buffers have not yet
* been created
@@ -4271,7 +4271,7 @@
/**
* @return whether the drawing buffer was lost since the last call to
- * getDrawGraphics
+ * {@code getDrawGraphics}
*/
public boolean contentsLost() {
if (drawVBuffer == null) {
@@ -4558,7 +4558,7 @@
/**
* @return whether the drawing buffer was lost since the last call to
- * getDrawGraphics
+ * {@code getDrawGraphics}
*/
public boolean contentsLost() {
if (backBuffers == null) {
@@ -4637,7 +4637,7 @@
/**
* Inner class for flipping buffers on a component. That component must
- * be a Canvas or Window.
+ * be a {@code Canvas} or {@code Window}.
* @see Canvas
* @see Window
* @see java.awt.image.BufferStrategy
@@ -4705,7 +4705,7 @@
/**
* Checks whether this component "contains" the specified point,
- * where x and y are defined to be
+ * where {@code x} and {@code y} are defined to be
* relative to the coordinate system of this component.
*
* @param x the x coordinate of the point
@@ -4758,15 +4758,15 @@
* inside a subcomponent that itself has subcomponents, it does not
* go looking down the subcomponent tree.
* locate method of Component simply
+ * The {@code locate} method of {@code Component} simply
* returns the component itself if the (x, y)
- * coordinate location is inside its bounding box, and null
+ * coordinate location is inside its bounding box, and {@code null}
* otherwise.
* @param x the x coordinate
* @param y the y coordinate
* @return the component or subcomponent that contains the
* (x, y) location;
- * null if the location
+ * {@code null} if the location
* is outside this component
* @see #contains(int, int)
* @since 1.0
@@ -4806,7 +4806,7 @@
/**
* @param e the event to deliver
* @deprecated As of JDK version 1.1,
- * replaced by dispatchEvent(AWTEvent e).
+ * replaced by {@code dispatchEvent(AWTEvent e)}.
*/
@Deprecated
public void deliverEvent(Event e) {
@@ -4815,8 +4815,8 @@
/**
* Dispatches an event to this component or one of its sub components.
- * Calls processEvent before returning for 1.1-style
- * events which have been enabled for the Component.
+ * Calls {@code processEvent} before returning for 1.1-style
+ * events which have been enabled for the {@code Component}.
* @param e the event
*/
public final void dispatchEvent(AWTEvent e) {
@@ -5284,7 +5284,7 @@
/**
* Adds the specified component listener to receive component events from
* this component.
- * If listener l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* ComponentListeners of this component
+ * @return all {@code ComponentListener}s of this component
* or an empty array if no component
* listeners are currently registered
*
@@ -5346,7 +5346,7 @@
/**
* Adds the specified focus listener to receive focus events from
* this component when this component gains input focus.
- * If listener l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* FocusListeners
+ * @return all of this component's {@code FocusListener}s
* or an empty array if no component
* listeners are currently registered
*
@@ -5416,7 +5416,7 @@
* Adds the specified hierarchy listener to receive hierarchy changed
* events from this component when the hierarchy to which this container
* belongs changes.
- * If listener l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* HierarchyListeners
+ * @return all of this component's {@code HierarchyListener}s
* or an empty array if no hierarchy
* listeners are currently registered
*
@@ -5507,7 +5507,7 @@
* Adds the specified hierarchy bounds listener to receive hierarchy
* bounds events from this component when the hierarchy to which this
* container belongs changes.
- * If listener l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* HierarchyBoundsListeners
+ * @return all of this component's {@code HierarchyBoundsListener}s
* or an empty array if no hierarchy bounds
* listeners are currently registered
*
@@ -5709,7 +5709,7 @@
* receives key events from this component. This method performs
* no function, nor does it throw an exception, if the listener
* specified by the argument was not previously added to this component.
- * If listener l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* KeyListeners
+ * @return all of this component's {@code KeyListener}s
* or an empty array if no key
* listeners are currently registered
*
@@ -5747,7 +5747,7 @@
/**
* Adds the specified mouse listener to receive mouse events from
* this component.
- * If listener l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* MouseListeners
+ * @return all of this component's {@code MouseListener}s
* or an empty array if no mouse
* listeners are currently registered
*
@@ -5816,7 +5816,7 @@
/**
* Adds the specified mouse motion listener to receive mouse motion
* events from this component.
- * If listener l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* MouseMotionListeners
+ * @return all of this component's {@code MouseMotionListener}s
* or an empty array if no mouse motion
* listeners are currently registered
*
@@ -5890,7 +5890,7 @@
* For information on how mouse wheel events are dispatched, see
* the class description for {@link MouseWheelEvent}.
* null, no exception is thrown and no
+ * If l is {@code null}, no exception is thrown and no
* action is performed.
* MouseWheelListeners
+ * @return all of this component's {@code MouseWheelListener}s
* or an empty array if no mouse wheel
* listeners are currently registered
*
@@ -5959,9 +5959,9 @@
* Adds the specified input method listener to receive
* input method events from this component. A component will
* only receive input method events from input methods
- * if it also overrides getInputMethodRequests to return an
- * InputMethodRequests instance.
- * If listener l is null,
+ * if it also overrides {@code getInputMethodRequests} to return an
+ * {@code InputMethodRequests} instance.
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* InputMethodListeners
+ * @return all of this component's {@code InputMethodListener}s
* or an empty array if no input method
* listeners are currently registered
*
@@ -6025,16 +6025,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this Component.
+ * upon this {@code Component}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * Component c
+ * {@code Component c}
* for its mouse listeners with the following code:
*
* MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));
@@ -6044,13 +6044,13 @@
* @param java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this component,
* or an empty array if no such listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @throws NullPointerException if {@code listenerType} is {@code null}
* @see #getComponentListeners
* @see #getFocusListeners
@@ -6096,11 +6096,11 @@
* Gets the input method request handler which supports
* requests from input methods for this component. A component
* that supports on-the-spot text input must override this
- * method to return an InputMethodRequests instance.
+ * method to return an {@code InputMethodRequests} instance.
* At the same time, it also has to handle input method events.
*
* @return the input method request handler for this component,
- * null by default
+ * {@code null} by default
* @see #addInputMethodListener
* @since 1.2
*/
@@ -6116,7 +6116,7 @@
* override this to return a private input context.
*
* @return the input context used by this component;
- * null if no context can be determined
+ * {@code null} if no context can be determined
* @since 1.2
*/
public InputContext getInputContext() {
@@ -6136,8 +6136,8 @@
* that event type is added to the component.
* Component which desire to have the specified event
- * types delivered to processEvent regardless of whether
+ * {@code Component} which desire to have the specified event
+ * types delivered to {@code processEvent} regardless of whether
* or not a listener is registered.
* @param eventsToEnable the event mask defining the event types
* @see #processEvent
@@ -6309,28 +6309,28 @@
/**
* Potentially coalesce an event being posted with an existing
- * event. This method is called by EventQueue.postEvent
+ * event. This method is called by {@code EventQueue.postEvent}
* if an event with the same ID as the event to be posted is found in
* the queue (both events must have this component as their source).
* This method either returns a coalesced event which replaces
* the existing event (and the new event is then discarded), or
- * null to indicate that no combining should be done
+ * {@code null} to indicate that no combining should be done
* (add the second event to the end of the queue). Either event
* parameter may be modified and returned, as the other one is discarded
- * unless null is returned.
+ * unless {@code null} is returned.
* coalesceEvents coalesces
+ * This implementation of {@code coalesceEvents} coalesces
* two event types: mouse move (and drag) events,
* and paint (and update) events.
* For mouse move events the last event is always returned, causing
* intermediate moves to be discarded. For paint events, the new
- * event is coalesced into a complex RepaintArea in the peer.
- * The new AWTEvent is always returned.
+ * event is coalesced into a complex {@code RepaintArea} in the peer.
+ * The new {@code AWTEvent} is always returned.
*
- * @param existingEvent the event already on the EventQueue
+ * @param existingEvent the event already on the {@code EventQueue}
* @param newEvent the event being posted to the
- * EventQueue
- * @return a coalesced event, or null indicating that no
+ * {@code EventQueue}
+ * @return a coalesced event, or {@code null} indicating that no
* coalescing was done
*/
protected AWTEvent coalesceEvents(AWTEvent existingEvent,
@@ -6343,7 +6343,7 @@
* method calls the appropriate
* process<event type>Event
* method for the given class of event.
- * null
+ * ComponentListener objects.
+ * {@code ComponentListener} objects.
*
- *
- * ComponentListener object is registered
- * via addComponentListener.
- * enableEvents.
+ * null
+ * FocusListener objects.
+ * {@code FocusListener} objects.
*
- *
* FocusListener object is registered
- * via addFocusListener.
- * enableEvents.
+ * Component,
- * the current KeyboardFocusManager determines
+ * If focus events are enabled for a {@code Component},
+ * the current {@code KeyboardFocusManager} determines
* whether or not a focus event should be dispatched to
- * registered FocusListener objects. If the
- * events are to be dispatched, the KeyboardFocusManager
- * calls the Component's dispatchEvent
- * method, which results in a call to the Component's
- * processFocusEvent method.
- * Component, calling
- * the Component's dispatchEvent method
- * with a FocusEvent as the argument will result in a
- * call to the Component's processFocusEvent
- * method regardless of the current KeyboardFocusManager.
+ * registered {@code FocusListener} objects. If the
+ * events are to be dispatched, the {@code KeyboardFocusManager}
+ * calls the {@code Component}'s {@code dispatchEvent}
+ * method, which results in a call to the {@code Component}'s
+ * {@code processFocusEvent} method.
+ * null
+ * KeyListener objects.
+ * {@code KeyListener} objects.
*
- *
*
* KeyListener object is registered
- * via addKeyListener.
- * enableEvents.
+ * Component,
- * the current KeyboardFocusManager determines
+ * If key events are enabled for a {@code Component},
+ * the current {@code KeyboardFocusManager} determines
* whether or not a key event should be dispatched to
- * registered KeyListener objects. The
- * DefaultKeyboardFocusManager will not dispatch
- * key events to a Component that is not the focus
+ * registered {@code KeyListener} objects. The
+ * {@code DefaultKeyboardFocusManager} will not dispatch
+ * key events to a {@code Component} that is not the focus
* owner or is not showing.
* KeyEvents are redirected to
+ * As of J2SE 1.4, {@code KeyEvent}s are redirected to
* the focus owner. Please see the
* Focus Specification
* for further information.
* Component's dispatchEvent
- * method with a KeyEvent as the argument will
- * result in a call to the Component's
- * processKeyEvent method regardless of the
- * current KeyboardFocusManager as long as the
+ * Calling a {@code Component}'s {@code dispatchEvent}
+ * method with a {@code KeyEvent} as the argument will
+ * result in a call to the {@code Component}'s
+ * {@code processKeyEvent} method regardless of the
+ * current {@code KeyboardFocusManager} as long as the
* component is showing, focused, and enabled, and key events
* are enabled on it.
- * null
+ * MouseListener objects.
+ * {@code MouseListener} objects.
*
- *
- * MouseListener object is registered
- * via addMouseListener.
- * enableEvents.
+ * null
+ * MouseMotionListener objects.
+ * {@code MouseMotionListener} objects.
*
- *
- * MouseMotionListener object is registered
- * via addMouseMotionListener.
- * enableEvents.
+ * null
+ * MouseWheelListener objects.
+ * {@code MouseWheelListener} objects.
*
- *
* MouseWheelListener object is registered
- * via addMouseWheelListener.
- * enableEvents.
+ * null
+ * Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -6705,17 +6705,17 @@
/**
* Processes input method events occurring on this component by
* dispatching them to any registered
- * InputMethodListener objects.
+ * {@code InputMethodListener} objects.
*
- *
- * InputMethodListener object is registered
- * via addInputMethodListener.
- * enableEvents.
+ * null
+ * HierarchyListener objects.
+ * {@code HierarchyListener} objects.
*
- *
- * HierarchyListener object is registered
- * via addHierarchyListener.
- * enableEvents.
+ * null
+ * HierarchyBoundsListener objects.
+ * {@code HierarchyBoundsListener} objects.
*
- *
- * HierarchyBoundsListener object is registered
- * via addHierarchyBoundsListener.
- * enableEvents.
+ * null
+ * Component displayable by connecting it to a
+ * Makes this {@code Component} displayable by connecting it to a
* native screen resource.
* This method is called internally by the toolkit and should
* not be called directly by programs.
@@ -7081,12 +7081,12 @@
}
/**
- * Makes this Component undisplayable by destroying it native
+ * Makes this {@code Component} undisplayable by destroying it native
* screen resource.
* super.removeNotify as
+ * this method should call {@code super.removeNotify} as
* the first line of the overriding method.
*
* @see #isDisplayable
@@ -7198,14 +7198,14 @@
}
/**
- * Returns whether this Component can become the focus
+ * Returns whether this {@code Component} can become the focus
* owner.
*
- * @return true if this Component is
- * focusable; false otherwise
+ * @return {@code true} if this {@code Component} is
+ * focusable; {@code false} otherwise
* @see #setFocusable
* @since 1.1
- * @deprecated As of 1.4, replaced by isFocusable().
+ * @deprecated As of 1.4, replaced by {@code isFocusable()}.
*/
@Deprecated
public boolean isFocusTraversable() {
@@ -7218,8 +7218,8 @@
/**
* Returns whether this Component can be focused.
*
- * @return true if this Component is focusable;
- * false otherwise.
+ * @return {@code true} if this Component is focusable;
+ * {@code false} otherwise.
* @see #setFocusable
* @since 1.4
*/
@@ -7343,7 +7343,7 @@
/**
* Returns the Set of focus traversal keys for a given traversal operation
* for this Component. (See
- * setFocusTraversalKeys for a full description of each key.)
+ * {@code setFocusTraversalKeys} for a full description of each key.)
* false, this Component is inheriting the
+ * this method returns {@code false}, this Component is inheriting the
* Set from an ancestor, or from the current KeyboardFocusManager.
*
* @param id one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or
* KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
- * @return true if the Set of focus traversal keys for the
+ * @return {@code true} if the Set of focus traversal keys for the
* given focus traversal operation has been explicitly defined for
- * this Component; false otherwise.
+ * this Component; {@code false} otherwise.
* @throws IllegalArgumentException if id is not one of
* KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or
@@ -7526,12 +7526,12 @@
* Window is later focused by the user.
* KeyboardFocusManager.clearGlobalFocusOwner()
+ * all. Use {@code KeyboardFocusManager.clearGlobalFocusOwner()}
* instead.
* requestFocusInWindow when possible.
+ * {@code requestFocusInWindow} when possible.
*
* Component get the input focus,
- * and that this Component's top-level ancestor
- * become the focused Window. This component must be
+ * Requests that this {@code Component} get the input focus,
+ * and that this {@code Component}'s top-level ancestor
+ * become the focused {@code Window}. This component must be
* displayable, focusable, visible and all of its ancestors (with
* the exception of the top-level Window) must be visible for the
* request to be granted. Every effort will be made to honor the
@@ -7568,29 +7568,29 @@
* will be remembered and will be granted when the window is later
* focused by the user.
* false is returned,
- * the request is guaranteed to fail. If true is
+ * This method returns a boolean value. If {@code false} is returned,
+ * the request is guaranteed to fail. If {@code true} is
* returned, the request will succeed unless it is vetoed, or an
* extraordinary event, such as disposal of the component's peer, occurs
* before the request can be granted by the native windowing system. Again,
- * while a return value of true indicates that the request is
+ * while a return value of {@code true} indicates that the request is
* likely to succeed, developers must never assume that this component is
* the focus owner until this component receives a FOCUS_GAINED event.
* KeyboardFocusManager.clearGlobalFocusOwner
+ * all. Use {@code KeyboardFocusManager.clearGlobalFocusOwner}
* instead.
* requestFocusInWindow when possible.
+ * {@code requestFocusInWindow} when possible.
* FocusEvents
+ * Every effort will be made to ensure that {@code FocusEvent}s
* generated as a
* result of this request will have the specified temporary value. However,
* because specifying an arbitrary temporary state may not be implementable
* on all native windowing systems, correct behavior for this method can be
- * guaranteed only for lightweight Components.
+ * guaranteed only for lightweight {@code Component}s.
* This method is not intended
* for general use, but exists instead as a hook for lightweight component
* libraries, such as Swing.
@@ -7603,8 +7603,8 @@
* such as when the window loses the focus; for
* more information on temporary focus changes see the
*Focus Specification
- * @return false if the focus change request is guaranteed to
- * fail; true if it is likely to succeed
+ * @return {@code false} if the focus change request is guaranteed to
+ * fail; {@code true} if it is likely to succeed
* @see java.awt.event.FocusEvent
* @see #addFocusListener
* @see #isFocusable
@@ -7630,31 +7630,31 @@
* assume that this Component is the focus owner until this
* Component receives a FOCUS_GAINED event.
* false is returned,
- * the request is guaranteed to fail. If true is
+ * This method returns a boolean value. If {@code false} is returned,
+ * the request is guaranteed to fail. If {@code true} is
* returned, the request will succeed unless it is vetoed, or an
* extraordinary event, such as disposal of the Component's peer, occurs
* before the request can be granted by the native windowing system. Again,
- * while a return value of true indicates that the request is
+ * while a return value of {@code true} indicates that the request is
* likely to succeed, developers must never assume that this Component is
* the focus owner until this Component receives a FOCUS_GAINED event.
* KeyboardFocusManager.clearGlobalFocusOwner()
+ * all. Use {@code KeyboardFocusManager.clearGlobalFocusOwner()}
* instead.
* requestFocus when possible. Code which relies
- * on requestFocus may exhibit different focus behavior on
+ * method over {@code requestFocus} when possible. Code which relies
+ * on {@code requestFocus} may exhibit different focus behavior on
* different platforms.
*
* false if the focus change request is guaranteed to
- * fail; true if it is likely to succeed
+ * @return {@code false} if the focus change request is guaranteed to
+ * fail; {@code true} if it is likely to succeed
* @see #requestFocus
* @see java.awt.event.FocusEvent
* @see #addFocusListener
@@ -7672,9 +7672,9 @@
}
/**
- * Requests that this Component get the input focus,
- * if this Component's top-level ancestor is already
- * the focused Window. This component must be
+ * Requests that this {@code Component} get the input focus,
+ * if this {@code Component}'s top-level ancestor is already
+ * the focused {@code Window}. This component must be
* displayable, focusable, visible and all of its ancestors (with
* the exception of the top-level Window) must be visible for the
* request to be granted. Every effort will be made to honor the
@@ -7682,26 +7682,26 @@
* so. Developers must never assume that this component is the
* focus owner until this component receives a FOCUS_GAINED event.
* false is returned,
- * the request is guaranteed to fail. If true is
+ * This method returns a boolean value. If {@code false} is returned,
+ * the request is guaranteed to fail. If {@code true} is
* returned, the request will succeed unless it is vetoed, or an
* extraordinary event, such as disposal of the component's peer, occurs
* before the request can be granted by the native windowing system. Again,
- * while a return value of true indicates that the request is
+ * while a return value of {@code true} indicates that the request is
* likely to succeed, developers must never assume that this component is
* the focus owner until this component receives a FOCUS_GAINED event.
* KeyboardFocusManager.clearGlobalFocusOwner
+ * all. Use {@code KeyboardFocusManager.clearGlobalFocusOwner}
* instead.
* requestFocus when possible. Code which relies
- * on requestFocus may exhibit different focus behavior on
+ * method over {@code requestFocus} when possible. Code which relies
+ * on {@code requestFocus} may exhibit different focus behavior on
* different platforms.
* FocusEvents
+ * Every effort will be made to ensure that {@code FocusEvent}s
* generated as a
* result of this request will have the specified temporary value. However,
* because specifying an arbitrary temporary state may not be implementable
@@ -7718,8 +7718,8 @@
* such as when the window loses the focus; for
* more information on temporary focus changes see the
*Focus Specification
- * @return false if the focus change request is guaranteed to
- * fail; true if it is likely to succeed
+ * @return {@code false} if the focus change request is guaranteed to
+ * fail; {@code true} if it is likely to succeed
* @see #requestFocus
* @see java.awt.event.FocusEvent
* @see #addFocusListener
@@ -7954,8 +7954,8 @@
* belongs to only a single focus traversal cycle.
*
* @param container the Container to be tested
- * @return true if the specified Container is a focus-cycle-
- * root of this Component; false otherwise
+ * @return {@code true} if the specified Container is a focus-cycle-
+ * root of this Component; {@code false} otherwise
* @see Container#isFocusCycleRoot()
* @since 1.4
*/
@@ -8136,12 +8136,12 @@
}
/**
- * Returns true if this Component is the
+ * Returns {@code true} if this {@code Component} is the
* focus owner. This method is obsolete, and has been replaced by
- * isFocusOwner().
+ * {@code isFocusOwner()}.
*
- * @return true if this Component is the
- * focus owner; false otherwise
+ * @return {@code true} if this {@code Component} is the
+ * focus owner; {@code false} otherwise
* @since 1.2
*/
public boolean hasFocus() {
@@ -8150,11 +8150,11 @@
}
/**
- * Returns true if this Component is the
+ * Returns {@code true} if this {@code Component} is the
* focus owner.
*
- * @return true if this Component is the
- * focus owner; false otherwise
+ * @return {@code true} if this {@code Component} is the
+ * focus owner; {@code false} otherwise
* @since 1.4
*/
public boolean isFocusOwner() {
@@ -8233,7 +8233,7 @@
* method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return a string representation of this component's state
* @since 1.0
@@ -8258,7 +8258,7 @@
/**
* Prints a listing of this component to the standard system output
- * stream System.out.
+ * stream {@code System.out}.
* @see java.lang.System#out
* @since 1.0
*/
@@ -8353,10 +8353,10 @@
* Component is inheriting a bound property, then no
+ * Note that if this {@code Component} is inheriting a bound property, then no
* event will be fired in response to a change in the inherited property.
* listener is null,
+ * If {@code listener} is {@code null},
* no exception is thrown and no action is performed.
*
* @param listener the property change listener to be added
@@ -8405,7 +8405,7 @@
* Returns an array of all the property change listeners
* registered on this component.
*
- * @return all of this component's PropertyChangeListeners
+ * @return all of this component's {@code PropertyChangeListener}s
* or an empty array if no property change
* listeners are currently registered
*
@@ -8442,10 +8442,10 @@
* Component is inheriting a bound property, then no
+ * Note that if this {@code Component} is inheriting a bound property, then no
* event will be fired in response to a change in the inherited property.
* propertyName or listener is null,
+ * If {@code propertyName} or {@code listener} is {@code null},
* no exception is thrown and no action is taken.
*
* @param propertyName one of the property names listed above
@@ -8470,12 +8470,12 @@
}
/**
- * Removes a PropertyChangeListener from the listener
+ * Removes a {@code PropertyChangeListener} from the listener
* list for a specific property. This method should be used to remove
- * PropertyChangeListeners
+ * {@code PropertyChangeListener}s
* that were registered for a specific bound property.
* propertyName or listener is null,
+ * If {@code propertyName} or {@code listener} is {@code null},
* no exception is thrown and no action is taken.
*
* @param propertyName a valid property name
@@ -8501,9 +8501,9 @@
* with the named property.
*
* @param propertyName the property name
- * @return all of the PropertyChangeListeners associated with
+ * @return all of the {@code PropertyChangeListener}s associated with
* the named property; if no such listeners have been added or
- * if propertyName is null, an empty
+ * if {@code propertyName} is {@code null}, an empty
* array is returned
*
* @see #addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)
@@ -8704,7 +8704,7 @@
/**
* This hack is for Swing serialization. It will invoke
- * the Swing package private method compWriteObjectNotify.
+ * the Swing package private method {@code compWriteObjectNotify}.
*/
private void doSwingSerialization() {
Package swingPackage = Package.getPackage("javax.swing");
@@ -8758,31 +8758,31 @@
* The non-serializable listeners are detected and
* no attempt is made to serialize them.
*
- * @param s the ObjectOutputStream to write
- * @serialData null terminated sequence of
- * 0 or more pairs; the pair consists of a String
- * and an Object; the String indicates
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData {@code null} terminated sequence of
+ * 0 or more pairs; the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String} indicates
* the type of object and is one of the following (as of 1.4):
- * componentListenerK indicating an
- * ComponentListener object;
- * focusListenerK indicating an
- * FocusListener object;
- * keyListenerK indicating an
- * KeyListener object;
- * mouseListenerK indicating an
- * MouseListener object;
- * mouseMotionListenerK indicating an
- * MouseMotionListener object;
- * inputMethodListenerK indicating an
- * InputMethodListener object;
- * hierarchyListenerK indicating an
- * HierarchyListener object;
- * hierarchyBoundsListenerK indicating an
- * HierarchyBoundsListener object;
- * mouseWheelListenerK indicating an
- * MouseWheelListener object
- * @serialData an optional ComponentOrientation
- * (after inputMethodListener, as of 1.2)
+ * {@code componentListenerK} indicating an
+ * {@code ComponentListener} object;
+ * {@code focusListenerK} indicating an
+ * {@code FocusListener} object;
+ * {@code keyListenerK} indicating an
+ * {@code KeyListener} object;
+ * {@code mouseListenerK} indicating an
+ * {@code MouseListener} object;
+ * {@code mouseMotionListenerK} indicating an
+ * {@code MouseMotionListener} object;
+ * {@code inputMethodListenerK} indicating an
+ * {@code InputMethodListener} object;
+ * {@code hierarchyListenerK} indicating an
+ * {@code HierarchyListener} object;
+ * {@code hierarchyBoundsListenerK} indicating an
+ * {@code HierarchyBoundsListener} object;
+ * {@code mouseWheelListenerK} indicating an
+ * {@code MouseWheelListener} object
+ * @serialData an optional {@code ComponentOrientation}
+ * (after {@code inputMethodListener}, as of 1.2)
*
* @see AWTEventMulticaster#save(java.io.ObjectOutputStream, java.lang.String, java.util.EventListener)
* @see #componentListenerK
@@ -8824,12 +8824,12 @@
}
/**
- * Reads the ObjectInputStream and if it isn't
- * null adds a listener to receive a variety
+ * Reads the {@code ObjectInputStream} and if it isn't
+ * {@code null} adds a listener to receive a variety
* of events fired by the component.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @see #writeObject(ObjectOutputStream)
*/
private void readObject(ObjectInputStream s)
@@ -8971,15 +8971,15 @@
/**
* Sets the language-sensitive orientation that is to be used to order
* the elements or text within this component. Language-sensitive
- * LayoutManager and Component
+ * {@code LayoutManager} and {@code Component}
* subclasses will use this property to
* determine how to lay out and draw components.
* ComponentOrientation.UNKNOWN,
+ * {@code ComponentOrientation.UNKNOWN},
* indicating that it has not been specified
* explicitly. The UNKNOWN orientation behaves the same as
- * ComponentOrientation.LEFT_TO_RIGHT.
+ * {@code ComponentOrientation.LEFT_TO_RIGHT}.
* LayoutManager
- * and Component
+ * the elements or text within this component. {@code LayoutManager}
+ * and {@code Component}
* subclasses that wish to respect orientation should call this method to
* get the component's orientation before performing layout or drawing.
*
@@ -9027,7 +9027,7 @@
}
/**
- * Sets the ComponentOrientation property of this component
+ * Sets the {@code ComponentOrientation} property of this component
* and all components contained within it.
* orientation is null.
+ * @exception NullPointerException if {@code orientation} is null.
* @see #setComponentOrientation
* @see #getComponentOrientation
* @see #invalidate
@@ -9104,7 +9104,7 @@
}
/**
- * Returns the Window ancestor of the component.
+ * Returns the {@code Window} ancestor of the component.
* @return Window ancestor of the component or component by itself if it is Window;
* null, if component is not a part of window hierarchy
*/
@@ -9131,16 +9131,16 @@
protected AccessibleContext accessibleContext = null;
/**
- * Gets the AccessibleContext associated
- * with this Component.
+ * Gets the {@code AccessibleContext} associated
+ * with this {@code Component}.
* The method implemented by this base
- * class returns null. Classes that extend Component
+ * class returns null. Classes that extend {@code Component}
* should implement this method to return the
- * AccessibleContext associated with the subclass.
+ * {@code AccessibleContext} associated with the subclass.
*
*
- * @return the AccessibleContext of this
- * Component
+ * @return the {@code AccessibleContext} of this
+ * {@code Component}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
@@ -9241,7 +9241,7 @@
/**
- * Adds a PropertyChangeListener to the listener list.
+ * Adds a {@code PropertyChangeListener} to the listener list.
*
* @param listener the property change listener to be added
*/
@@ -9278,7 +9278,7 @@
//
/**
* Gets the accessible name of this object. This should almost never
- * return java.awt.Component.getName(),
+ * return {@code java.awt.Component.getName()},
* as that generally isn't a localized name,
* and doesn't have meaning for the user. If the
* object is fundamentally a text object (e.g. a menu item), the
@@ -9287,7 +9287,7 @@
* appropriate String to return.
*
* @return the localized name of the object -- can be
- * null if this
+ * {@code null} if this
* object does not have a name
* @see javax.accessibility.AccessibleContext#setAccessibleName
*/
@@ -9307,7 +9307,7 @@
* text document" instead).
*
* @return the localized description of the object -- can be
- * null if this object does not have a description
+ * {@code null} if this object does not have a description
* @see javax.accessibility.AccessibleContext#setAccessibleDescription
*/
public String getAccessibleDescription() {
@@ -9317,7 +9317,7 @@
/**
* Gets the role of this object.
*
- * @return an instance of AccessibleRole
+ * @return an instance of {@code AccessibleRole}
* describing the role of the object
* @see javax.accessibility.AccessibleRole
*/
@@ -9328,7 +9328,7 @@
/**
* Gets the state of this object.
*
- * @return an instance of AccessibleStateSet
+ * @return an instance of {@code AccessibleStateSet}
* containing the current state set of the object
* @see javax.accessibility.AccessibleState
*/
@@ -9337,13 +9337,13 @@
}
/**
- * Gets the Accessible parent of this object.
- * If the parent of this object implements Accessible,
- * this method should simply return getParent.
+ * Gets the {@code Accessible} parent of this object.
+ * If the parent of this object implements {@code Accessible},
+ * this method should simply return {@code getParent}.
*
- * @return the Accessible parent of this
- * object -- can be null if this
- * object does not have an Accessible parent
+ * @return the {@code Accessible} parent of this
+ * object -- can be {@code null} if this
+ * object does not have an {@code Accessible} parent
*/
public Accessible getAccessibleParent() {
if (accessibleParent != null) {
@@ -9370,7 +9370,7 @@
/**
* Returns the number of accessible children in the object. If all
- * of the children of this object implement Accessible,
+ * of the children of this object implement {@code Accessible},
* then this method should return the number of children of this object.
*
* @return the number of accessible children in the object
@@ -9380,10 +9380,10 @@
}
/**
- * Returns the nth Accessible child of the object.
+ * Returns the nth {@code Accessible} child of the object.
*
* @param i zero-based index of child
- * @return the nth Accessible child of the object
+ * @return the nth {@code Accessible} child of the object
*/
public Accessible getAccessibleChild(int i) {
return null; // Components don't have children
@@ -9399,9 +9399,9 @@
}
/**
- * Gets the AccessibleComponent associated
+ * Gets the {@code AccessibleComponent} associated
* with this object if one exists.
- * Otherwise return null.
+ * Otherwise return {@code null}.
*
* @return the component
*/
@@ -9416,7 +9416,7 @@
* Gets the background color of this object.
*
* @return the background color, if supported, of the object;
- * otherwise, null
+ * otherwise, {@code null}
*/
public Color getBackground() {
return Component.this.getBackground();
@@ -9424,9 +9424,9 @@
/**
* Sets the background color of this object.
- * (For transparency, see isOpaque.)
+ * (For transparency, see {@code isOpaque}.)
*
- * @param c the new Color for the background
+ * @param c the new {@code Color} for the background
* @see Component#isOpaque
*/
public void setBackground(Color c) {
@@ -9437,7 +9437,7 @@
* Gets the foreground color of this object.
*
* @return the foreground color, if supported, of the object;
- * otherwise, null
+ * otherwise, {@code null}
*/
public Color getForeground() {
return Component.this.getForeground();
@@ -9446,59 +9446,59 @@
/**
* Sets the foreground color of this object.
*
- * @param c the new Color for the foreground
+ * @param c the new {@code Color} for the foreground
*/
public void setForeground(Color c) {
Component.this.setForeground(c);
}
/**
- * Gets the Cursor of this object.
+ * Gets the {@code Cursor} of this object.
*
- * @return the Cursor, if supported,
- * of the object; otherwise, null
+ * @return the {@code Cursor}, if supported,
+ * of the object; otherwise, {@code null}
*/
public Cursor getCursor() {
return Component.this.getCursor();
}
/**
- * Sets the Cursor of this object.
+ * Sets the {@code Cursor} of this object.
* Cursor for the object
+ * @param cursor the new {@code Cursor} for the object
*/
public void setCursor(Cursor cursor) {
Component.this.setCursor(cursor);
}
/**
- * Gets the Font of this object.
+ * Gets the {@code Font} of this object.
*
- * @return the Font, if supported,
- * for the object; otherwise, null
+ * @return the {@code Font}, if supported,
+ * for the object; otherwise, {@code null}
*/
public Font getFont() {
return Component.this.getFont();
}
/**
- * Sets the Font of this object.
+ * Sets the {@code Font} of this object.
*
- * @param f the new Font for the object
+ * @param f the new {@code Font} for the object
*/
public void setFont(Font f) {
Component.this.setFont(f);
}
/**
- * Gets the FontMetrics of this object.
+ * Gets the {@code FontMetrics} of this object.
*
- * @param f the Font
- * @return the FontMetrics, if supported,
- * the object; otherwise, null
+ * @param f the {@code Font}
+ * @return the {@code FontMetrics}, if supported,
+ * the object; otherwise, {@code null}
* @see #getFont
*/
public FontMetrics getFontMetrics(Font f) {
@@ -9546,7 +9546,7 @@
* object intends to be visible; however, it may not in fact be
* showing on the screen because one of the objects that this object
* is contained by is not visible. To determine if an object is
- * showing on the screen, use isShowing.
+ * showing on the screen, use {@code isShowing}.
*
* @return true if object is visible; otherwise, false
*/
@@ -9595,9 +9595,9 @@
* where the point's x and y coordinates are defined to be relative to
* the coordinate system of the object.
*
- * @param p the Point relative to the
+ * @param p the {@code Point} relative to the
* coordinate system of the object
- * @return true if object contains Point; otherwise false
+ * @return true if object contains {@code Point}; otherwise false
*/
public boolean contains(Point p) {
return Component.this.contains(p);
@@ -9607,7 +9607,7 @@
* Returns the location of the object on the screen.
*
* @return location of object on screen -- can be
- * null if this object is not on the screen
+ * {@code null} if this object is not on the screen
*/
public Point getLocationOnScreen() {
synchronized (Component.this.getTreeLock()) {
@@ -9626,7 +9626,7 @@
*
* @return an instance of Point representing the top-left corner of
* the object's bounds in the coordinate space of the screen;
- * null if this object or its parent are not on the screen
+ * {@code null} if this object or its parent are not on the screen
*/
public Point getLocation() {
return Component.this.getLocation();
@@ -9646,7 +9646,7 @@
* relative to its parent.
*
* @return a rectangle indicating this component's bounds;
- * null if this object is not on the screen
+ * {@code null} if this object is not on the screen
*/
public Rectangle getBounds() {
return Component.this.getBounds();
@@ -9654,7 +9654,7 @@
/**
* Sets the bounds of this object in the form of a
- * Rectangle object.
+ * {@code Rectangle} object.
* The bounds specify this object's width, height, and location
* relative to its parent.
*
@@ -9666,13 +9666,13 @@
/**
* Returns the size of this object in the form of a
- * Dimension object. The height field of the
- * Dimension object contains this object's
- * height, and the width field of the Dimension
+ * {@code Dimension} object. The height field of the
+ * {@code Dimension} object contains this object's
+ * height, and the width field of the {@code Dimension}
* object contains this object's width.
*
- * @return a Dimension object that indicates
- * the size of this component; null if
+ * @return a {@code Dimension} object that indicates
+ * the size of this component; {@code null} if
* this object is not on the screen
*/
public Dimension getSize() {
@@ -9689,16 +9689,16 @@
}
/**
- * Returns the Accessible child,
+ * Returns the {@code Accessible} child,
* if one exists, contained at the local
- * coordinate Point. Otherwise returns
- * null.
+ * coordinate {@code Point}. Otherwise returns
+ * {@code null}.
*
* @param p the point defining the top-left corner of
- * the Accessible, given in the
+ * the {@code Accessible}, given in the
* coordinate space of the object's parent
- * @return the Accessible, if it exists,
- * at the specified location; else null
+ * @return the {@code Accessible}, if it exists,
+ * at the specified location; else {@code null}
*/
public Accessible getAccessibleAt(Point p) {
return null; // Components don't have children
@@ -9772,7 +9772,7 @@
/**
* Gets the current state set of this object.
*
- * @return an instance of AccessibleStateSet
+ * @return an instance of {@code AccessibleStateSet}
* containing the current state set of the object
* @see AccessibleState
*/
--- old/src/java.desktop/share/classes/java/awt/ComponentOrientation.java 2015-10-04 22:52:27.977274855 +0400
+++ new/src/java.desktop/share/classes/java/awt/ComponentOrientation.java 2015-10-04 22:52:27.789274863 +0400
@@ -72,8 +72,8 @@
* isLeftToRight() and
- * isHorizontal() methods to
+ * should use the {@code isLeftToRight()} and
+ * {@code isHorizontal()} methods to
* determine their behavior. They should not include switch-like
* code that keys off of the constants, such as:
*
--- old/src/java.desktop/share/classes/java/awt/Composite.java 2015-10-04 22:52:28.501274831 +0400
+++ new/src/java.desktop/share/classes/java/awt/Composite.java 2015-10-04 22:52:28.313274840 +0400
@@ -28,39 +28,39 @@
import java.awt.image.ColorModel;
/**
- * The
Composite interface, along with
+ * The {@code Composite} interface, along with
* {@link CompositeContext}, defines the methods to compose a draw
* primitive with the underlying graphics area.
- * After the Composite is set in the
+ * After the {@code Composite} is set in the
* {@link Graphics2D} context, it combines a shape, text, or an image
* being rendered with the colors that have already been rendered
* according to pre-defined rules. The classes
* implementing this interface provide the rules and a method to create
* the context for a particular operation.
- * CompositeContext is an environment used by the
- * compositing operation, which is created by the Graphics2D
- * prior to the start of the operation. CompositeContext
+ * {@code CompositeContext} is an environment used by the
+ * compositing operation, which is created by the {@code Graphics2D}
+ * prior to the start of the operation. {@code CompositeContext}
* contains private information and resources needed for a compositing
- * operation. When the CompositeContext is no longer needed,
- * the Graphics2D object disposes of it in order to reclaim
+ * operation. When the {@code CompositeContext} is no longer needed,
+ * the {@code Graphics2D} object disposes of it in order to reclaim
* resources allocated for the operation.
* Composite must be
- * immutable because the Graphics2D does not clone
+ * Instances of classes implementing {@code Composite} must be
+ * immutable because the {@code Graphics2D} does not clone
* these objects when they are set as an attribute with the
- * setComposite method or when the Graphics2D
+ * {@code setComposite} method or when the {@code Graphics2D}
* object is cloned. This is to avoid undefined rendering behavior of
- * Graphics2D, resulting from the modification of
- * the Composite object after it has been set in the
- * Graphics2D context.
+ * {@code Graphics2D}, resulting from the modification of
+ * the {@code Composite} object after it has been set in the
+ * {@code Graphics2D} context.
* readDisplayPixels
+ * to a screen device is governed by the {@code readDisplayPixels}
* {@link AWTPermission}. The permission check will occur when such
- * a custom object is passed to the setComposite method
- * of a Graphics2D retrieved from a {@link Component}.
+ * a custom object is passed to the {@code setComposite} method
+ * of a {@code Graphics2D} retrieved from a {@link Component}.
* @see AlphaComposite
* @see CompositeContext
* @see Graphics2D#setComposite
@@ -71,12 +71,12 @@
* Creates a context containing state that is used to perform
* the compositing operation. In a multi-threaded environment,
* several contexts can exist simultaneously for a single
- * Composite object.
+ * {@code Composite} object.
* @param srcColorModel the {@link ColorModel} of the source
- * @param dstColorModel the ColorModel of the destination
+ * @param dstColorModel the {@code ColorModel} of the destination
* @param hints the hint that the context object uses to choose between
* rendering alternatives
- * @return the CompositeContext object used to perform the
+ * @return the {@code CompositeContext} object used to perform the
* compositing operation.
*/
public CompositeContext createContext(ColorModel srcColorModel,
--- old/src/java.desktop/share/classes/java/awt/CompositeContext.java 2015-10-04 22:52:29.025274808 +0400
+++ new/src/java.desktop/share/classes/java/awt/CompositeContext.java 2015-10-04 22:52:28.833274816 +0400
@@ -29,9 +29,9 @@
import java.awt.image.WritableRaster;
/**
- * The CompositeContext interface defines the encapsulated
+ * The {@code CompositeContext} interface defines the encapsulated
* and optimized environment for a compositing operation.
- * CompositeContext objects maintain state for
+ * {@code CompositeContext} objects maintain state for
* compositing operations. In a multi-threaded environment, several
* contexts can exist simultaneously for a single {@link Composite}
* object.
@@ -49,14 +49,14 @@
* places the result in the destination
* {@link WritableRaster}. Note that the destination
* can be the same object as either the first or second
- * source. Note that dstIn and
- * dstOut must be compatible with the
- * dstColorModel passed to the
+ * source. Note that {@code dstIn} and
+ * {@code dstOut} must be compatible with the
+ * {@code dstColorModel} passed to the
* {@link Composite#createContext(java.awt.image.ColorModel, java.awt.image.ColorModel, java.awt.RenderingHints) createContext}
- * method of the Composite interface.
+ * method of the {@code Composite} interface.
* @param src the first source for the compositing operation
* @param dstIn the second source for the compositing operation
- * @param dstOut the WritableRaster into which the
+ * @param dstOut the {@code WritableRaster} into which the
* result of the operation is stored
* @see Composite
*/
--- old/src/java.desktop/share/classes/java/awt/Container.java 2015-10-04 22:52:29.545274784 +0400
+++ new/src/java.desktop/share/classes/java/awt/Container.java 2015-10-04 22:52:29.353274793 +0400
@@ -183,7 +183,7 @@
/**
* A constant which toggles one of the controllable behaviors
- * of getMouseEventTarget. It is used to specify whether
+ * of {@code getMouseEventTarget}. It is used to specify whether
* 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.
*
@@ -193,7 +193,7 @@
/**
* A constant which toggles one of the controllable behaviors
- * of getMouseEventTarget. It is used to specify whether
+ * of {@code getMouseEventTarget}. It is used to specify whether
* the method should search only lightweight components.
*
* @see #getMouseEventTarget(int, int, boolean)
@@ -384,7 +384,7 @@
* Determines the insets of this container, which indicate the size
* of the container's border.
* Frame object, for example, has a top inset that
+ * A {@code Frame} object, for example, has a top inset that
* corresponds to the height of the frame's title bar.
* @return the insets of this container.
* @see Insets
@@ -399,7 +399,7 @@
* Returns the insets for this container.
*
* @deprecated As of JDK version 1.1,
- * replaced by getInsets().
+ * replaced by {@code getInsets()}.
* @return the insets for this container
*/
@Deprecated
@@ -439,7 +439,7 @@
* This is a convenience method for {@link #addImpl}.
* add(Component, Object) instead.
+ * method {@code add(Component, Object)} instead.
* -1 to append the component to the end
+ * or {@code -1} to append the component to the end
* @exception NullPointerException if {@code comp} is {@code null}
* @exception IllegalArgumentException if {@code index} is invalid (see
* {@link #addImpl} for details)
- * @return the component comp
+ * @return the component {@code comp}
* @see #addImpl
* @see #remove
* @see #invalidate
@@ -532,7 +532,7 @@
if (comp.parent == this) {
if (index == component.size()) {
throw new IllegalArgumentException("illegal component position " +
- index + " should be less then " + component.size());
+ index + " should be less than " + component.size());
}
}
checkAddToSelf(comp);
@@ -734,40 +734,40 @@
* If the component is a child of some other container, it is
* removed from that container before being added to this container.
* The important difference between this method and
- * java.awt.Container.add(Component, int) is that this method
- * doesn't call removeNotify on the component while
+ * {@code java.awt.Container.add(Component, int)} is that this method
+ * doesn't call {@code removeNotify} on the component while
* removing it from its previous container unless necessary and when
* allowed by the underlying native windowing system. This way, if the
* component has the keyboard focus, it maintains the focus when
* moved to the new position.
* Container components.
+ * non-{@code Container} components.
* removeNotify. There is no way to detect
+ * the call to {@code removeNotify}. There is no way to detect
* whether a platform supports this, so developers shouldn't make
* any assumptions.
*
* @param comp the component to be moved
* @param index the position in the container's list to
- * insert the component, where getComponentCount()
+ * insert the component, where {@code getComponentCount()}
* appends to the end
- * @exception NullPointerException if comp is
- * null
- * @exception IllegalArgumentException if comp is one of the
+ * @exception NullPointerException if {@code comp} is
+ * {@code null}
+ * @exception IllegalArgumentException if {@code comp} is one of the
* container's parents
- * @exception IllegalArgumentException if index is not in
- * the range [0, getComponentCount()] for moving
+ * @exception IllegalArgumentException if {@code index} is not in
+ * the range {@code [0, getComponentCount()]} for moving
* between containers, or not in the range
- * [0, getComponentCount()-1] for moving inside
+ * {@code [0, getComponentCount()-1]} for moving inside
* a container
* @exception IllegalArgumentException if adding a container to itself
- * @exception IllegalArgumentException if adding a Window
+ * @exception IllegalArgumentException if adding a {@code Window}
* to a container
* @see #getComponentZOrder(java.awt.Component)
* @see #invalidate
@@ -949,7 +949,7 @@
*
* @param comp the component being queried
* @return the z-order index of the component; otherwise
- * returns -1 if the component is null
+ * returns -1 if the component is {@code null}
* or doesn't belong to the container
* @see #setComponentZOrder(java.awt.Component, int)
* @since 1.5
@@ -1010,7 +1010,7 @@
* @param comp the component to be added
* @param constraints an object expressing layout constraints for this
* @param index the position in the container's list at which to insert
- * the component; -1 means insert at the end
+ * the component; {@code -1} means insert at the end
* component
* @exception NullPointerException if {@code comp} is {@code null}
* @exception IllegalArgumentException if {@code index} is invalid (see
@@ -1030,20 +1030,20 @@
* Adds the specified component to this container at the specified
* index. This method also notifies the layout manager to add
* the component to this container's layout using the specified
- * constraints object via the addLayoutComponent
+ * constraints object via the {@code addLayoutComponent}
* method.
* BorderLayout class defines five
- * constraints: BorderLayout.NORTH,
- * BorderLayout.SOUTH, BorderLayout.EAST,
- * BorderLayout.WEST, and BorderLayout.CENTER.
+ * example, the {@code BorderLayout} class defines five
+ * constraints: {@code BorderLayout.NORTH},
+ * {@code BorderLayout.SOUTH}, {@code BorderLayout.EAST},
+ * {@code BorderLayout.WEST}, and {@code BorderLayout.CENTER}.
* GridBagLayout class requires a
- * GridBagConstraints object. Failure to pass
+ * The {@code GridBagLayout} class requires a
+ * {@code GridBagConstraints} object. Failure to pass
* the correct type of constraints object results in an
- * IllegalArgumentException.
+ * {@code IllegalArgumentException}.
*
- *
* super.addImpl(comp, constraints, index)
+ * {@code super.addImpl(comp, constraints, index)}
* -1
+ * insert the component, where {@code -1}
* means append to the end
* @exception IllegalArgumentException if {@code index} is invalid;
* if {@code comp} is a child of this container, the valid
@@ -1196,11 +1196,11 @@
}
/**
- * Removes the component, specified by index,
+ * Removes the component, specified by {@code index},
* from this container.
* This method also notifies the layout manager to remove the
* component from this container's layout via the
- * removeLayoutComponent method.
+ * {@code removeLayoutComponent} method.
* removeLayoutComponent method.
+ * {@code removeLayoutComponent} method.
* removeLayoutComponent method.
+ * {@code removeLayoutComponent} method.
* validate method instead.
+ * the {@code validate} method instead.
* @see LayoutManager#layoutContainer
* @see #setLayout
* @see #validate
@@ -1524,7 +1524,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by doLayout().
+ * replaced by {@code doLayout()}.
*/
@Deprecated
public void layout() {
@@ -1703,7 +1703,7 @@
* Recursively descends the container tree and recomputes the
* layout for any subtrees marked as needing it (those marked as
* invalid). Synchronization should be provided by the method
- * that calls this one: validate.
+ * that calls this one: {@code validate}.
*
* @see #doLayout
* @see #validate
@@ -1791,7 +1791,7 @@
* this method is invoked, rather the {@code LayoutManager} will only
* be queried after the {@code Container} becomes invalid.
*
- * @return an instance of Dimension that represents
+ * @return an instance of {@code Dimension} that represents
* the preferred size of this container.
* @see #getMinimumSize
* @see #getMaximumSize
@@ -1805,7 +1805,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize().
+ * replaced by {@code getPreferredSize()}.
*/
@Deprecated
public Dimension preferredSize() {
@@ -1842,7 +1842,7 @@
* this method is invoked, rather the {@code LayoutManager} will only
* be queried after the {@code Container} becomes invalid.
*
- * @return an instance of Dimension that represents
+ * @return an instance of {@code Dimension} that represents
* the minimum size of this container.
* @see #getPreferredSize
* @see #getMaximumSize
@@ -1857,7 +1857,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize().
+ * replaced by {@code getMinimumSize()}.
*/
@Deprecated
public Dimension minimumSize() {
@@ -1895,7 +1895,7 @@
* this method is invoked, rather the {@code LayoutManager2} will only
* be queried after the {@code Container} becomes invalid.
*
- * @return an instance of Dimension that represents
+ * @return an instance of {@code Dimension} that represents
* the maximum size of this container.
* @see #getPreferredSize
* @see #getMinimumSize
@@ -2169,7 +2169,7 @@
* Returns an array of all the container listeners
* registered on this container.
*
- * @return all of this container's ContainerListeners
+ * @return all of this container's {@code ContainerListener}s
* or an empty array if no container
* listeners are currently registered
*
@@ -2184,16 +2184,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this Container.
+ * upon this {@code Container}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * Container c
+ * {@code Container c}
* for its container listeners with the following code:
*
* ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));
@@ -2202,13 +2202,13 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this container,
* or an empty array if no such listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @exception NullPointerException if {@code listenerType} is {@code null}
*
* @see #getContainerListeners
@@ -2242,10 +2242,10 @@
/**
* Processes events on this container. If the event is a
- * ContainerEvent, it invokes the
- * processContainerEvent method, else it invokes
- * its superclass's processEvent.
- * null
+ * {@code ContainerEvent}, it invokes the
+ * {@code processContainerEvent} method, else it invokes
+ * its superclass's {@code processEvent}.
+ *
*
- * addContainerListener
- * enableEvents
+ * {@code addContainerListener}
+ * null
+ * false.
+ * lightweight descendants if the last argument is {@code false}.
*
* @param filter EventTargetFilter instance to determine whether the
* given component is a valid target for this event.
- * @param searchHeavyweights if false, the method
+ * @param searchHeavyweights if {@code false}, the method
* will bypass heavyweight components during the search.
*/
private Component getMouseEventTarget(int x, int y, boolean includeSelf,
@@ -2399,17 +2399,17 @@
* descendants of only lightweight children or only heavyweight children
* of this container depending on searchHeavyweightChildren. The search will
* be constrained to only lightweight descendants of the searched children
- * of this container if searchHeavyweightDescendants is false.
+ * of this container if searchHeavyweightDescendants is {@code false}.
*
* @param filter EventTargetFilter instance to determine whether the
* selected component is a valid target for this event.
- * @param searchHeavyweightChildren if true, the method
+ * @param searchHeavyweightChildren if {@code true}, the method
* will bypass immediate lightweight children during the search.
- * If false, the methods will bypass immediate
+ * If {@code false}, the methods will bypass immediate
* heavyweight children during the search.
- * @param searchHeavyweightDescendants if false, the method
+ * @param searchHeavyweightDescendants if {@code false}, the method
* will bypass heavyweight descendants which are not immediate
- * children during the search. If true, the method
+ * children during the search. If {@code true}, the method
* will traverse both lightweight and heavyweight descendants during
* the search.
*/
@@ -2525,7 +2525,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by dispatchEvent(AWTEvent e)
+ * replaced by {@code dispatchEvent(AWTEvent e)}
*/
@Deprecated
public void deliverEvent(Event e) {
@@ -2562,7 +2562,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getComponentAt(int, int).
+ * replaced by {@code getComponentAt(int, int)}.
*/
@Deprecated
public Component locate(int x, int y) {
@@ -2593,7 +2593,7 @@
* Gets the component that contains the specified point.
* @param p the point.
* @return returns the component that contains the point,
- * or null if the component does
+ * or {@code null} if the component does
* not contain the point.
* @see Component#contains
* @since 1.1
@@ -2603,22 +2603,22 @@
}
/**
- * Returns the position of the mouse pointer in this Container's
- * coordinate space if the Container is under the mouse pointer,
- * otherwise returns null.
+ * Returns the position of the mouse pointer in this {@code Container}'s
+ * coordinate space if the {@code Container} is under the mouse pointer,
+ * otherwise returns {@code null}.
* This method is similar to {@link Component#getMousePosition()} with the exception
- * that it can take the Container's children into account.
- * If allowChildren is false, this method will return
- * a non-null value only if the mouse pointer is above the Container
+ * that it can take the {@code Container}'s children into account.
+ * If {@code allowChildren} is {@code false}, this method will return
+ * a non-null value only if the mouse pointer is above the {@code Container}
* directly, not above the part obscured by children.
- * If allowChildren is true, this method returns
- * a non-null value if the mouse pointer is above Container or any
+ * If {@code allowChildren} is {@code true}, this method returns
+ * a non-null value if the mouse pointer is above {@code Container} or any
* of its descendants.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
* @param allowChildren true if children should be taken into account
* @see Component#getMousePosition
- * @return mouse coordinates relative to this Component, or null
+ * @return mouse coordinates relative to this {@code Component}, or null
* @since 1.5
*/
public Point getMousePosition(boolean allowChildren) throws HeadlessException {
@@ -2848,8 +2848,8 @@
* Checks if the component is contained in the component hierarchy of
* this container.
* @param c the component
- * @return true if it is an ancestor;
- * false otherwise.
+ * @return {@code true} if it is an ancestor;
+ * {@code false} otherwise.
* @since 1.1
*/
public boolean isAncestorOf(Component c) {
@@ -2983,11 +2983,11 @@
/* End of JOptionPane support code */
/**
- * Returns a string representing the state of this Container.
+ * Returns a string representing the state of this {@code Container}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this container
*/
@@ -3005,8 +3005,8 @@
* stream. The listing starts at the specified indentation.
* indent+1. The children
- * of those children are printed at indent+2
+ * an indentation of {@code indent+1}. The children
+ * of those children are printed at {@code indent+2}
* and so on.
*
* @param out a print stream
@@ -3032,8 +3032,8 @@
* to the specified print writer.
* indent+1. The children
- * of those children are printed at indent+2
+ * an indentation of {@code indent+1}. The children
+ * of those children are printed at {@code indent+2}
* and so on.
*
* @param out a print writer
@@ -3149,7 +3149,7 @@
/**
* Returns the Set of focus traversal keys for a given traversal operation
* for this Container. (See
- * setFocusTraversalKeys for a full description of each key.)
+ * {@code setFocusTraversalKeys} for a full description of each key.)
* false, this Container is inheriting the
+ * this method returns {@code false}, this Container is inheriting the
* Set from an ancestor, or from the current KeyboardFocusManager.
*
* @param id one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
* KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
- * @return true if the Set of focus traversal keys for the
+ * @return {@code true} if the Set of focus traversal keys for the
* given focus traversal operation has been explicitly defined for
- * this Component; false otherwise.
+ * this Component; {@code false} otherwise.
* @throws IllegalArgumentException if id is not one of
* KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
@@ -3220,12 +3220,12 @@
* root belongs to only a single focus traversal cycle. Containers which
* are focus cycle roots belong to two cycles: one rooted at the Container
* itself, and one rooted at the Container's nearest focus-cycle-root
- * ancestor. This method will return true for both such
+ * ancestor. This method will return {@code true} for both such
* Containers in this case.
*
* @param container the Container to be tested
- * @return true if the specified Container is a focus-cycle-
- * root of this Container; false otherwise
+ * @return {@code true} if the specified Container is a focus-cycle-
+ * root of this Container; {@code false} otherwise
* @see #isFocusCycleRoot()
* @since 1.4
*/
@@ -3394,11 +3394,11 @@
/**
* Returns whether the focus traversal policy has been explicitly set for
- * this Container. If this method returns false, this
+ * this Container. If this method returns {@code false}, this
* Container will inherit its focus traversal policy from an ancestor.
*
- * @return true if the focus traversal policy has been
- * explicitly set for this Container; false otherwise.
+ * @return {@code true} if the focus traversal policy has been
+ * explicitly set for this Container; {@code false} otherwise.
* @since 1.4
*/
public boolean isFocusTraversalPolicySet() {
@@ -3464,7 +3464,7 @@
/**
* Sets whether this container will be used to provide focus
* traversal policy. Container with this property as
- * true will be used to acquire focus traversal policy
+ * {@code true} will be used to acquire focus traversal policy
* instead of closest focus cycle root ancestor.
* @param provider indicates whether this container will be used to
* provide focus traversal policy
@@ -3486,7 +3486,7 @@
/**
* Returns whether this container provides focus traversal
- * policy. If this property is set to true then when
+ * policy. If this property is set to {@code true} then when
* keyboard focus manager searches container hierarchy for focus
* traversal policy and encounters this container before any other
* container with this property as true or focus cycle roots then
@@ -3496,8 +3496,8 @@
* @see #getFocusTraversalPolicy
* @see #setFocusCycleRoot
* @see #setFocusTraversalPolicyProvider
- * @return true if this container provides focus traversal
- * policy, false otherwise
+ * @return {@code true} if this container provides focus traversal
+ * policy, {@code false} otherwise
* @since 1.5
* @beaninfo
* bound: true
@@ -3549,7 +3549,7 @@
}
/**
- * Sets the ComponentOrientation property of this container
+ * Sets the {@code ComponentOrientation} property of this container
* and all components contained within it.
* orientation is null.
+ * @exception NullPointerException if {@code orientation} is null.
* @see Component#setComponentOrientation
* @see Component#getComponentOrientation
* @see #invalidate
@@ -3660,26 +3660,26 @@
private int containerSerializedDataVersion = 1;
/**
- * Serializes this Container to the specified
- * ObjectOutputStream.
+ * Serializes this {@code Container} to the specified
+ * {@code ObjectOutputStream}.
*
*
null is written.ObjectOutputStream to write
- * @serialData null terminated sequence of 0 or more pairs;
- * the pair consists of a String and Object;
- * the String indicates the type of object and
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData {@code null} terminated sequence of 0 or more pairs;
+ * the pair consists of a {@code String} and {@code Object};
+ * the {@code String} indicates the type of object and
* is one of the following:
- * containerListenerK indicating an
- * ContainerListener object;
- * the Container's FocusTraversalPolicy,
- * or null
+ * {@code containerListenerK} indicating an
+ * {@code ContainerListener} object;
+ * the {@code Container}'s {@code FocusTraversalPolicy},
+ * or {@code null}
*
* @see AWTEventMulticaster#save(java.io.ObjectOutputStream, java.lang.String, java.util.EventListener)
* @see Container#containerListenerK
@@ -3708,8 +3708,8 @@
}
/**
- * Deserializes this Container from the specified
- * ObjectInputStream.
+ * Deserializes this {@code Container} from the specified
+ * {@code ObjectInputStream}.
*
*
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @serial
* @see #addContainerListener
* @see #writeObject(ObjectOutputStream)
@@ -3806,7 +3806,7 @@
/**
* Returns the number of accessible children in the object. If all
- * of the children of this object implement Accessible,
+ * of the children of this object implement {@code Accessible},
* then this method should return the number of children of this object.
*
* @return the number of accessible children in the object
@@ -3816,24 +3816,24 @@
}
/**
- * Returns the nth Accessible child of the object.
+ * Returns the nth {@code Accessible} child of the object.
*
* @param i zero-based index of child
- * @return the nth Accessible child of the object
+ * @return the nth {@code Accessible} child of the object
*/
public Accessible getAccessibleChild(int i) {
return Container.this.getAccessibleChild(i);
}
/**
- * Returns the Accessible child, if one exists,
- * contained at the local coordinate Point.
+ * Returns the {@code Accessible} child, if one exists,
+ * contained at the local coordinate {@code Point}.
*
* @param p the point defining the top-left corner of the
- * Accessible, given in the coordinate space
+ * {@code Accessible}, given in the coordinate space
* of the object's parent
- * @return the Accessible, if it exists,
- * at the specified location; else null
+ * @return the {@code Accessible}, if it exists,
+ * at the specified location; else {@code null}
*/
public Accessible getAccessibleAt(Point p) {
return Container.this.getAccessibleAt(p);
@@ -3852,7 +3852,7 @@
protected ContainerListener accessibleContainerHandler = null;
/**
- * Fire PropertyChange listener, if one is registered,
+ * Fire {@code PropertyChange} listener, if one is registered,
* when children are added or removed.
* @since 1.3
*/
@@ -3908,15 +3908,15 @@
} // inner class AccessibleAWTContainer
/**
- * Returns the Accessible child contained at the local
- * coordinate Point, if one exists. Otherwise
- * returns null.
+ * Returns the {@code Accessible} child contained at the local
+ * coordinate {@code Point}, if one exists. Otherwise
+ * returns {@code null}.
*
* @param p the point defining the top-left corner of the
- * Accessible, given in the coordinate space
+ * {@code Accessible}, given in the coordinate space
* of the object's parent
- * @return the Accessible at the specified location,
- * if it exists; otherwise null
+ * @return the {@code Accessible} at the specified location,
+ * if it exists; otherwise {@code null}
*/
Accessible getAccessibleAt(Point p) {
synchronized (getTreeLock()) {
@@ -3972,7 +3972,7 @@
/**
* Returns the number of accessible children in the object. If all
- * of the children of this object implement Accessible,
+ * of the children of this object implement {@code Accessible},
* then this method should return the number of children of this object.
*
* @return the number of accessible children in the object
@@ -3991,10 +3991,10 @@
}
/**
- * Returns the nth Accessible child of the object.
+ * Returns the nth {@code Accessible} child of the object.
*
* @param i zero-based index of child
- * @return the nth Accessible child of the object
+ * @return the nth {@code Accessible} child of the object
*/
Accessible getAccessibleChild(int i) {
synchronized (getTreeLock()) {
--- old/src/java.desktop/share/classes/java/awt/ContainerOrderFocusTraversalPolicy.java 2015-10-04 22:52:30.165274756 +0400
+++ new/src/java.desktop/share/classes/java/awt/ContainerOrderFocusTraversalPolicy.java 2015-10-04 22:52:29.977274765 +0400
@@ -33,18 +33,18 @@
* of child Components in a Container. From a particular focus cycle root, the
* policy makes a pre-order traversal of the Component hierarchy, and traverses
* a Container's children according to the ordering of the array returned by
- * Container.getComponents(). Portions of the hierarchy that are
+ * {@code Container.getComponents()}. Portions of the hierarchy that are
* not visible and displayable will not be searched.
* setImplicitDownCycleTraversal method.
+ * {@code setImplicitDownCycleTraversal} method.
* accept method.
+ * behavior by overriding the {@code accept} method.
* setImplicitDownCycleTraversal method.
+ * the {@code setImplicitDownCycleTraversal} method.
* getFirstComponent.
+ * returns the same Component as {@code getFirstComponent}.
*
* @param aContainer the focus cycle root or focus traversal policy provider whose default
* Component is to be returned
@@ -534,12 +534,12 @@
/**
* Sets whether this ContainerOrderFocusTraversalPolicy transfers focus
- * down-cycle implicitly. If true, during normal forward focus
+ * down-cycle implicitly. If {@code true}, during normal forward focus
* traversal, the Component traversed after a focus cycle root will be the
- * focus-cycle-root's default Component to focus. If false,
+ * focus-cycle-root's default Component to focus. If {@code false},
* the next Component in the focus traversal cycle rooted at the specified
* focus cycle root will be traversed instead. The default value for this
- * property is true.
+ * property is {@code true}.
*
* @param implicitDownCycleTraversal whether this
* ContainerOrderFocusTraversalPolicy transfers focus down-cycle
@@ -553,9 +553,9 @@
/**
* Returns whether this ContainerOrderFocusTraversalPolicy transfers focus
- * down-cycle implicitly. If true, during normal forward focus
+ * down-cycle implicitly. If {@code true}, during normal forward focus
* traversal, the Component traversed after a focus cycle root will be the
- * focus-cycle-root's default Component to focus. If false,
+ * focus-cycle-root's default Component to focus. If {@code false},
* the next Component in the focus traversal cycle rooted at the specified
* focus cycle root will be traversed instead.
*
@@ -575,8 +575,8 @@
*
* @param aComponent the Component whose fitness as a focus owner is to
* be tested
- * @return true if aComponent is visible, displayable,
- * enabled, and focusable; false otherwise
+ * @return {@code true} if aComponent is visible, displayable,
+ * enabled, and focusable; {@code false} otherwise
*/
protected boolean accept(Component aComponent) {
if (!aComponent.canBeFocusOwner()) {
--- old/src/java.desktop/share/classes/java/awt/Cursor.java 2015-10-04 22:52:30.697274733 +0400
+++ new/src/java.desktop/share/classes/java/awt/Cursor.java 2015-10-04 22:52:30.509274741 +0400
@@ -146,7 +146,7 @@
/**
* The chosen cursor type initially set to
- * the DEFAULT_CURSOR.
+ * the {@code DEFAULT_CURSOR}.
*
* @serial
* @see #getType()
@@ -283,7 +283,7 @@
* @param name a string describing the desired system-specific custom cursor
* @return the system specific custom cursor named
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns true
+ * {@code GraphicsEnvironment.isHeadless} returns true
* @exception AWTException in case of erroneous retrieving of the cursor
*/
public static Cursor getSystemCustomCursor(final String name)
--- old/src/java.desktop/share/classes/java/awt/DefaultFocusTraversalPolicy.java 2015-10-04 22:52:31.221274709 +0400
+++ new/src/java.desktop/share/classes/java/awt/DefaultFocusTraversalPolicy.java 2015-10-04 22:52:31.033274718 +0400
@@ -32,13 +32,13 @@
* of child Components in a Container. From a particular focus cycle root, the
* policy makes a pre-order traversal of the Component hierarchy, and traverses
* a Container's children according to the ordering of the array returned by
- * Container.getComponents(). Portions of the hierarchy that are
+ * {@code Container.getComponents()}. Portions of the hierarchy that are
* not visible and displayable will not be searched.
* Component.isFocusTraversable() or
- * Component.isFocusable(), or by calling
- * Component.setFocusable(), then a DefaultFocusTraversalPolicy
+ * overriding {@code Component.isFocusTraversable()} or
+ * {@code Component.isFocusable()}, or by calling
+ * {@code Component.setFocusable()}, then a DefaultFocusTraversalPolicy
* behaves exactly like a ContainerOrderFocusTraversalPolicy. If, however, the
* Component is relying on default focusability, then a
* DefaultFocusTraversalPolicy will reject all Components with non-focusable
@@ -80,9 +80,9 @@
* focus owner. The Component must be visible, displayable, and enabled
* to be accepted. If client code has explicitly set the focusability
* of the Component by either overriding
- * Component.isFocusTraversable() or
- * Component.isFocusable(), or by calling
- * Component.setFocusable(), then the Component will be
+ * {@code Component.isFocusTraversable()} or
+ * {@code Component.isFocusable()}, or by calling
+ * {@code Component.setFocusable()}, then the Component will be
* accepted if and only if it is focusable. If, however, the Component is
* relying on default focusability, then all Canvases, Labels, Panels,
* Scrollbars, ScrollPanes, Windows, and lightweight Components will be
@@ -90,8 +90,8 @@
*
* @param aComponent the Component whose fitness as a focus owner is to
* be tested
- * @return true if aComponent meets the above requirements;
- * false otherwise
+ * @return {@code true} if aComponent meets the above requirements;
+ * {@code false} otherwise
*/
protected boolean accept(Component aComponent) {
if (!(aComponent.isVisible() && aComponent.isDisplayable() &&
--- old/src/java.desktop/share/classes/java/awt/DefaultKeyboardFocusManager.java 2015-10-04 22:52:31.761274685 +0400
+++ new/src/java.desktop/share/classes/java/awt/DefaultKeyboardFocusManager.java 2015-10-04 22:52:31.553274694 +0400
@@ -309,12 +309,12 @@
* related to focus, and all KeyEvents. These events are dispatched based
* on the KeyboardFocusManager's notion of the focus owner and the focused
* and active Windows, sometimes overriding the source of the specified
- * AWTEvent. If this method returns false, then the AWT event
+ * AWTEvent. If this method returns {@code false}, then the AWT event
* dispatcher will attempt to dispatch the event itself.
*
* @param e the AWTEvent to be dispatched
- * @return true if this method dispatched the event;
- * false otherwise
+ * @return {@code true} if this method dispatched the event;
+ * {@code false} otherwise
*/
public boolean dispatchEvent(AWTEvent e) {
if (focusLog.isLoggable(PlatformLogger.Level.FINE) && (e instanceof WindowEvent || e instanceof FocusEvent)) {
@@ -778,7 +778,7 @@
}
/**
- * Called by dispatchEvent if no other
+ * Called by {@code dispatchEvent} if no other
* KeyEventDispatcher in the dispatcher chain dispatched the KeyEvent, or
* if no other KeyEventDispatchers are registered. If the event has not
* been consumed, its target is enabled, and the focus owner is not null,
@@ -787,13 +787,13 @@
* KeyEventPostProcessors. After all this operations are finished,
* the event is passed to peers for processing.
* true, since
+ * In all cases, this method returns {@code true}, since
* DefaultKeyboardFocusManager is designed so that neither
- * dispatchEvent, nor the AWT event dispatcher, should take
+ * {@code dispatchEvent}, nor the AWT event dispatcher, should take
* further action on the event in any situation.
*
* @param e the KeyEvent to be dispatched
- * @return true
+ * @return {@code true}
* @see Component#dispatchEvent
*/
public boolean dispatchKeyEvent(KeyEvent e) {
@@ -841,13 +841,13 @@
}
/**
- * This method will be called by dispatchKeyEvent. It will
+ * This method will be called by {@code dispatchKeyEvent}. It will
* handle any unconsumed KeyEvents that map to an AWT
- * MenuShortcut by consuming the event and activating the
+ * {@code MenuShortcut} by consuming the event and activating the
* shortcut.
*
* @param e the KeyEvent to post-process
- * @return true
+ * @return {@code true}
* @see #dispatchKeyEvent
* @see MenuShortcut
*/
@@ -998,7 +998,7 @@
}
/**
- * Returns true if there are some marker associated with component comp
+ * Returns true if there are some marker associated with component {@code comp}
* in a markers' queue
* @since 1.5
*/
@@ -1201,7 +1201,7 @@
* the focus owner. KeyEvents with timestamps later than the specified
* timestamp will be enqueued until the specified Component receives a
* FOCUS_GAINED event, or the AWT cancels the delay request by invoking
- * dequeueKeyEvents or discardKeyEvents.
+ * {@code dequeueKeyEvents} or {@code discardKeyEvents}.
*
* @param after timestamp of current event, or the current, system time if
* the current event has no timestamp, or the AWT cannot determine
@@ -1241,15 +1241,15 @@
/**
* Releases for normal dispatching to the current focus owner all
* KeyEvents which were enqueued because of a call to
- * enqueueKeyEvents with the same timestamp and Component.
+ * {@code enqueueKeyEvents} with the same timestamp and Component.
* If the given timestamp is less than zero, the outstanding enqueue
* request for the given Component with the oldest timestamp (if
* any) should be cancelled.
*
* @param after the timestamp specified in the call to
- * enqueueKeyEvents, or any value < 0
+ * {@code enqueueKeyEvents}, or any value < 0
* @param untilFocused the Component specified in the call to
- * enqueueKeyEvents
+ * {@code enqueueKeyEvents}
* @see #enqueueKeyEvents
* @see #discardKeyEvents
*/
@@ -1292,11 +1292,11 @@
/**
* Discards all KeyEvents which were enqueued because of one or more calls
- * to enqueueKeyEvents with the specified Component, or one of
+ * to {@code enqueueKeyEvents} with the specified Component, or one of
* its descendants.
*
* @param comp the Component specified in one or more calls to
- * enqueueKeyEvents, or a parent of such a Component
+ * {@code enqueueKeyEvents}, or a parent of such a Component
* @see #enqueueKeyEvents
* @see #dequeueKeyEvents
*/
--- old/src/java.desktop/share/classes/java/awt/Desktop.java 2015-10-04 22:52:32.297274661 +0400
+++ new/src/java.desktop/share/classes/java/awt/Desktop.java 2015-10-04 22:52:32.109274669 +0400
@@ -127,7 +127,7 @@
}
/**
- * Returns the Desktop instance of the current
+ * Returns the {@code Desktop} instance of the current
* browser context. On some platforms the Desktop API may not be
* supported; use the {@link #isDesktopSupported} method to
* determine if the current desktop is supported.
@@ -162,8 +162,8 @@
* If it's supported, use {@link #getDesktop()} to retrieve an
* instance.
*
- * @return true if this class is supported on the
- * current platform; false otherwise
+ * @return {@code true} if this class is supported on the
+ * current platform; {@code false} otherwise
* @see #getDesktop()
*/
public static boolean isDesktopSupported(){
@@ -186,8 +186,8 @@
* action method will throw an {@link IOException}.
*
* @param action the specified {@link Action}
- * @return true if the specified action is supported on
- * the current platform; false otherwise
+ * @return {@code true} if the specified action is supported on
+ * the current platform; {@code false} otherwise
* @see Desktop.Action
*/
public boolean isSupported(Action action) {
@@ -230,8 +230,8 @@
/**
- * Calls to the security manager's checkPermission method with
- * an AWTPermission("showWindowWithoutWarningBanner")
+ * Calls to the security manager's {@code checkPermission} method with
+ * an {@code AWTPermission("showWindowWithoutWarningBanner")}
* permission.
*/
private void checkAWTPermission(){
@@ -259,7 +259,7 @@
* @throws SecurityException if a security manager exists and its
* {@link java.lang.SecurityManager#checkRead(java.lang.String)}
* method denies read access to the file, or it denies the
- * AWTPermission("showWindowWithoutWarningBanner")
+ * {@code AWTPermission("showWindowWithoutWarningBanner")}
* permission, or the calling thread is not allowed to create a
* subprocess
* @see java.awt.AWTPermission
@@ -290,7 +290,7 @@
* method denies read access to the file, or {@link
* java.lang.SecurityManager#checkWrite(java.lang.String)} method
* denies write access to the file, or it denies the
- * AWTPermission("showWindowWithoutWarningBanner")
+ * {@code AWTPermission("showWindowWithoutWarningBanner")}
* permission, or the calling thread is not allowed to create a
* subprocess
* @see java.awt.AWTPermission
@@ -361,7 +361,7 @@
* failed to be launched
* @throws SecurityException if a security manager exists and it
* denies the
- * AWTPermission("showWindowWithoutWarningBanner")
+ * {@code AWTPermission("showWindowWithoutWarningBanner")}
* permission, or the calling thread is not allowed to create a
* subprocess; and not invoked from within an applet or Java Web Started
* application
@@ -415,7 +415,7 @@
* found, or it fails to be launched
* @throws SecurityException if a security manager exists and it
* denies the
- * AWTPermission("showWindowWithoutWarningBanner")
+ * {@code AWTPermission("showWindowWithoutWarningBanner")}
* permission, or the calling thread is not allowed to create a
* subprocess
* @see java.awt.AWTPermission
@@ -438,7 +438,7 @@
* client, filling the message fields specified by a {@code
* mailto:} URI.
*
- * mailto: URI can specify message fields
+ * java.awt.AWTEvent,
+ * @param event an instance of {@code java.awt.AWTEvent},
* or a subclass of it
- * @throws NullPointerException if event is null
+ * @throws NullPointerException if {@code event} is {@code null}
* @since 1.2
*/
protected void dispatchEvent(final AWTEvent event) {
@@ -777,23 +777,23 @@
/**
* Returns the timestamp of the most recent event that had a timestamp, and
- * that was dispatched from the EventQueue associated with the
+ * that was dispatched from the {@code EventQueue} associated with the
* calling thread. If an event with a timestamp is currently being
* dispatched, its timestamp will be returned. If no events have yet
* been dispatched, the EventQueue's initialization time will be
* returned instead.In the current version of
- * the JDK, only InputEvents,
- * ActionEvents, and InvocationEvents have
+ * the JDK, only {@code InputEvent}s,
+ * {@code ActionEvent}s, and {@code InvocationEvent}s have
* timestamps; however, future versions of the JDK may add timestamps to
* additional event types. Note that this method should only be invoked
* from an application's {@link #isDispatchThread event dispatching thread}.
* If this method is
* invoked from another thread, the current system time (as reported by
- * System.currentTimeMillis()) will be returned instead.
+ * {@code System.currentTimeMillis()}) will be returned instead.
*
- * @return the timestamp of the last InputEvent,
- * ActionEvent, or InvocationEvent to be
- * dispatched, or System.currentTimeMillis() if this
+ * @return the timestamp of the last {@code InputEvent},
+ * {@code ActionEvent}, or {@code InvocationEvent} to be
+ * dispatched, or {@code System.currentTimeMillis()} if this
* method is invoked on a thread other than an event dispatching
* thread
* @see java.awt.event.InputEvent#getWhen
@@ -831,7 +831,7 @@
/**
* Returns the event currently being dispatched by the
- * EventQueue associated with the calling thread. This is
+ * {@code EventQueue} associated with the calling thread. This is
* useful if a method needs access to the event, but was not designed to
* receive a reference to it as an argument. Note that this method should
* only be invoked from an application's event dispatching thread. If this
@@ -856,14 +856,14 @@
}
/**
- * Replaces the existing EventQueue with the specified one.
- * Any pending events are transferred to the new EventQueue
+ * Replaces the existing {@code EventQueue} with the specified one.
+ * Any pending events are transferred to the new {@code EventQueue}
* for processing by it.
*
- * @param newEventQueue an EventQueue
+ * @param newEventQueue an {@code EventQueue}
* (or subclass thereof) instance to be use
* @see java.awt.EventQueue#pop
- * @throws NullPointerException if newEventQueue is null
+ * @throws NullPointerException if {@code newEventQueue} is {@code null}
* @since 1.2
*/
public void push(EventQueue newEventQueue) {
@@ -921,15 +921,15 @@
}
/**
- * Stops dispatching events using this EventQueue.
+ * Stops dispatching events using this {@code EventQueue}.
* Any pending events are transferred to the previous
- * EventQueue for processing.
+ * {@code EventQueue} for processing.
* EventQueue
+ * on this {@code EventQueue}
* @see java.awt.EventQueue#push
* @since 1.2
*/
@@ -1122,10 +1122,10 @@
}
/*
- * Gets the EventDispatchThread for this
- * EventQueue.
+ * Gets the {@code EventDispatchThread} for this
+ * {@code EventQueue}.
* @return the event dispatch thread associated with this event queue
- * or null if this event queue doesn't have a
+ * or {@code null} if this event queue doesn't have a
* working thread associated with it
* @see java.awt.EventQueue#initDispatchThread
* @see java.awt.EventQueue#detachDispatchThread
@@ -1141,15 +1141,15 @@
/*
* Removes any pending events for the specified source object.
- * If removeAllEvents parameter is true then all
+ * If removeAllEvents parameter is {@code true} then all
* events for the specified source object are removed, if it
- * is false then SequencedEvent, SentEvent,
- * FocusEvent, WindowEvent, KeyEvent,
- * and InputMethodEvent are kept in the queue, but all other
+ * is {@code false} then {@code SequencedEvent}, {@code SentEvent},
+ * {@code FocusEvent}, {@code WindowEvent}, {@code KeyEvent},
+ * and {@code InputMethodEvent} are kept in the queue, but all other
* events are removed.
*
* This method is normally called by the source's
- * removeNotify method.
+ * {@code removeNotify} method.
*/
final void removeSourceEvents(Object source, boolean removeAllEvents) {
SunToolkit.flushPendingEvents(appContext);
@@ -1249,12 +1249,12 @@
}
/**
- * Causes runnable to have its run
+ * Causes {@code runnable} to have its {@code run}
* method called in the {@link #isDispatchThread dispatch thread} of
* {@link Toolkit#getSystemEventQueue the system EventQueue}.
* This will happen after all pending events are processed.
*
- * @param runnable the Runnable whose run
+ * @param runnable the {@code Runnable} whose {@code run}
* method should be executed
* asynchronously in the
* {@link #isDispatchThread event dispatch thread}
@@ -1270,7 +1270,7 @@
}
/**
- * Causes runnable to have its run
+ * Causes {@code runnable} to have its {@code run}
* method called in the {@link #isDispatchThread dispatch thread} of
* {@link Toolkit#getSystemEventQueue the system EventQueue}.
* This will happen after all pending events are processed.
@@ -1278,7 +1278,7 @@
* will throw an Error if called from the
* {@link #isDispatchThread event dispatcher thread}.
*
- * @param runnable the Runnable whose run
+ * @param runnable the {@code Runnable} whose {@code run}
* method should be executed
* synchronously in the
* {@link #isDispatchThread event dispatch thread}
@@ -1286,7 +1286,7 @@
* @exception InterruptedException if any thread has
* interrupted this thread
* @exception InvocationTargetException if an throwable is thrown
- * when running runnable
+ * when running {@code runnable}
* @see #invokeLater
* @see Toolkit#getSystemEventQueue
* @see #isDispatchThread
--- old/src/java.desktop/share/classes/java/awt/FileDialog.java 2015-10-04 22:52:36.057274492 +0400
+++ new/src/java.desktop/share/classes/java/awt/FileDialog.java 2015-10-04 22:52:35.865274501 +0400
@@ -32,11 +32,11 @@
import sun.awt.AWTAccessor;
/**
- * The FileDialog class displays a dialog window
+ * The {@code FileDialog} class displays a dialog window
* from which the user can select a file.
* show method to display the dialog,
+ * its {@code show} method to display the dialog,
* it blocks the rest of the application until the user has
* chosen a file.
*
@@ -61,10 +61,10 @@
public static final int SAVE = 1;
/*
- * There are two FileDialog modes: LOAD and
- * SAVE.
+ * There are two {@code FileDialog} modes: {@code LOAD} and
+ * {@code SAVE}.
* This integer will represent one or the other.
- * If the mode is not specified it will default to LOAD.
+ * If the mode is not specified it will default to {@code LOAD}.
*
* @serial
* @see getMode()
@@ -76,7 +76,7 @@
/*
* The string specifying the directory to display
- * in the file dialog. This variable may be null.
+ * in the file dialog. This variable may be {@code null}.
*
* @serial
* @see getDirectory()
@@ -87,7 +87,7 @@
/*
* The string specifying the initial value of the
* filename text field in the file dialog.
- * This variable may be null.
+ * This variable may be {@code null}.
*
* @serial
* @see getFile()
@@ -118,7 +118,7 @@
* The filter used as the file dialog's filename filter.
* The file dialog will only be displaying files whose
* names are accepted by this filter.
- * This variable may be null.
+ * This variable may be {@code null}.
*
* @serial
* @see #getFilenameFilter()
@@ -173,7 +173,7 @@
/**
* Creates a file dialog for loading a file. The title of the
* file dialog is initially empty. This is a convenience method for
- * FileDialog(parent, "", LOAD).
+ * {@code FileDialog(parent, "", LOAD)}.
* FileDialog(parent, title, LOAD).
+ * {@code FileDialog(parent, title, LOAD)}.
* mode is LOAD, then the
+ * If the value of {@code mode} is {@code LOAD}, then the
* file dialog is finding a file to read, and the files shown are those
* in the current directory. If the value of
- * mode is SAVE, the file dialog is finding
+ * {@code mode} is {@code SAVE}, the file dialog is finding
* a place to write a file.
* FileDialog.LOAD or FileDialog.SAVE
+ * {@code FileDialog.LOAD} or {@code FileDialog.SAVE}
* @exception IllegalArgumentException if an illegal file
* dialog mode is supplied
* @see java.awt.FileDialog#LOAD
@@ -241,7 +241,7 @@
/**
* Creates a file dialog for loading a file. The title of the
* file dialog is initially empty. This is a convenience method for
- * FileDialog(parent, "", LOAD).
+ * {@code FileDialog(parent, "", LOAD)}.
* parent's
- * GraphicsConfiguration
+ * @exception java.lang.IllegalArgumentException if the {@code parent}'s
+ * {@code GraphicsConfiguration}
* is not from a screen device;
- * @exception java.lang.IllegalArgumentException if parent
- * is null; this exception is always thrown when
- * GraphicsEnvironment.isHeadless
- * returns true
+ * @exception java.lang.IllegalArgumentException if {@code parent}
+ * is {@code null}; this exception is always thrown when
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.5
*/
@@ -268,7 +268,7 @@
* Creates a file dialog window with the specified title for loading
* a file. The files shown are those in the current directory.
* This is a convenience method for
- * FileDialog(parent, title, LOAD).
+ * {@code FileDialog(parent, title, LOAD)}.
* null value
+ * @param title the title of the dialog; a {@code null} value
* will be accepted without causing a
- * NullPointerException to be thrown
- * @exception java.lang.IllegalArgumentException if the parent's
- * GraphicsConfiguration
+ * {@code NullPointerException} to be thrown
+ * @exception java.lang.IllegalArgumentException if the {@code parent}'s
+ * {@code GraphicsConfiguration}
* is not from a screen device;
- * @exception java.lang.IllegalArgumentException if parent
- * is null; this exception is always thrown when
- * GraphicsEnvironment.isHeadless
- * returns true
+ * @exception java.lang.IllegalArgumentException if {@code parent}
+ * is {@code null}; this exception is always thrown when
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.5
*/
@@ -298,10 +298,10 @@
* Creates a file dialog window with the specified title for loading
* or saving a file.
* mode is LOAD, then the
+ * If the value of {@code mode} is {@code LOAD}, then the
* file dialog is finding a file to read, and the files shown are those
* in the current directory. If the value of
- * mode is SAVE, the file dialog is finding
+ * {@code mode} is {@code SAVE}, the file dialog is finding
* a place to write a file.
* null value
+ * @param title the title of the dialog; a {@code null} value
* will be accepted without causing a
- * NullPointerException to be thrown
+ * {@code NullPointerException} to be thrown
* @param mode the mode of the dialog; either
- * FileDialog.LOAD or FileDialog.SAVE
+ * {@code FileDialog.LOAD} or {@code FileDialog.SAVE}
* @exception java.lang.IllegalArgumentException if an illegal
* file dialog mode is supplied;
- * @exception java.lang.IllegalArgumentException if the parent's
- * GraphicsConfiguration
+ * @exception java.lang.IllegalArgumentException if the {@code parent}'s
+ * {@code GraphicsConfiguration}
* is not from a screen device;
- * @exception java.lang.IllegalArgumentException if parent
- * is null; this exception is always thrown when
- * GraphicsEnvironment.isHeadless
- * returns true
+ * @exception java.lang.IllegalArgumentException if {@code parent}
+ * is {@code null}; this exception is always thrown when
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @see java.awt.FileDialog#LOAD
* @see java.awt.FileDialog#SAVE
@@ -353,8 +353,8 @@
/**
- * Constructs a name for this component. Called by getName()
- * when the name is null.
+ * Constructs a name for this component. Called by {@code getName()}
+ * when the name is {@code null}.
*/
String constructComponentName() {
synchronized (FileDialog.class) {
@@ -382,8 +382,8 @@
* or for saving to a file.
*
* @return the mode of this file dialog window, either
- * FileDialog.LOAD or
- * FileDialog.SAVE
+ * {@code FileDialog.LOAD} or
+ * {@code FileDialog.SAVE}
* @see java.awt.FileDialog#LOAD
* @see java.awt.FileDialog#SAVE
* @see java.awt.FileDialog#setMode
@@ -393,13 +393,13 @@
}
/**
- * Sets the mode of the file dialog. If mode is not
- * a legal value, an exception will be thrown and mode
+ * Sets the mode of the file dialog. If {@code mode} is not
+ * a legal value, an exception will be thrown and {@code mode}
* will not be set.
*
* @param mode the mode for this file dialog, either
- * FileDialog.LOAD or
- * FileDialog.SAVE
+ * {@code FileDialog.LOAD} or
+ * {@code FileDialog.SAVE}
* @see java.awt.FileDialog#LOAD
* @see java.awt.FileDialog#SAVE
* @see java.awt.FileDialog#getMode
@@ -421,8 +421,8 @@
/**
* Gets the directory of this file dialog.
*
- * @return the (potentially null or invalid)
- * directory of this FileDialog
+ * @return the (potentially {@code null} or invalid)
+ * directory of this {@code FileDialog}
* @see java.awt.FileDialog#setDirectory
*/
public String getDirectory() {
@@ -431,14 +431,14 @@
/**
* Sets the directory of this file dialog window to be the
- * specified directory. Specifying a null or an
+ * specified directory. Specifying a {@code null} or an
* invalid directory implies an implementation-defined default.
* This default will not be realized, however, until the user
- * has selected a file. Until this point, getDirectory()
+ * has selected a file. Until this point, {@code getDirectory()}
* will return the value passed into this method.
* null as the directory.
+ * specifying {@code null} as the directory.
*
* @param dir the specified directory
* @see java.awt.FileDialog#getDirectory
@@ -453,10 +453,10 @@
/**
* Gets the selected file of this file dialog. If the user
- * selected CANCEL, the returned file is null.
+ * selected {@code CANCEL}, the returned file is {@code null}.
*
* @return the currently selected file of this file dialog window,
- * or null if none is selected
+ * or {@code null} if none is selected
* @see java.awt.FileDialog#setFile
*/
public String getFile() {
@@ -592,12 +592,12 @@
}
/**
- * Reads the ObjectInputStream and performs
+ * Reads the {@code ObjectInputStream} and performs
* a backwards compatibility check by converting
- * either a dir or a file
- * equal to an empty string to null.
+ * either a {@code dir} or a {@code file}
+ * equal to an empty string to {@code null}.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
*/
private void readObject(ObjectInputStream s)
throws ClassNotFoundException, IOException
@@ -614,11 +614,11 @@
}
/**
- * Returns a string representing the state of this FileDialog
+ * Returns a string representing the state of this {@code FileDialog}
* window. This method is intended to be used only for debugging purposes,
* and the content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this file dialog window
*/
--- old/src/java.desktop/share/classes/java/awt/FlowLayout.java 2015-10-04 22:52:36.597274468 +0400
+++ new/src/java.desktop/share/classes/java/awt/FlowLayout.java 2015-10-04 22:52:36.409274476 +0400
@@ -30,16 +30,16 @@
/**
* A flow layout arranges components in a directional flow, much
* like lines of text in a paragraph. The flow direction is
- * determined by the container's componentOrientation
+ * determined by the container's {@code componentOrientation}
* property and may be one of two values:
*
- *
* Flow layouts are typically used
* to arrange buttons in a panel. It arranges buttons
* horizontally until no more buttons fit on the same line.
- * The line alignment is determined by the ComponentOrientation.LEFT_TO_RIGHT
- * ComponentOrientation.RIGHT_TO_LEFT
+ * align
+ * The line alignment is determined by the {@code align}
* property. The possible values are:
*
*
align is the property that determines
+ * {@code align} is the property that determines
* how each row distributes empty space.
* It can be one of the following values:
*
- *
*
* @serial
@@ -141,16 +141,16 @@
int align; // This is for 1.1 serialization compatibility
/**
- * LEFT
- * RIGHT
- * CENTER
+ * newAlign is the property that determines
+ * {@code newAlign} is the property that determines
* how each row distributes empty space for the Java 2 platform,
* v1.2 and greater.
* It can be one of the following three values:
*
- *
*
* @serial
@@ -165,7 +165,7 @@
* components with gaps. The horizontal gap will
* specify the space between components and between
* the components and the borders of the
- * LEFT
- * RIGHT
- * CENTER
- * LEADING
- * TRAILING
+ * Container.
+ * {@code Container}.
*
* @serial
* @see #getHgap()
@@ -177,7 +177,7 @@
* The flow layout manager allows a separation of
* components with gaps. The vertical gap will
* specify the space between rows and between the
- * the rows and the borders of the Container.
+ * the rows and the borders of the {@code Container}.
*
* @serial
* @see #getHgap()
@@ -196,7 +196,7 @@
private static final long serialVersionUID = -7262534875583282631L;
/**
- * Constructs a new FlowLayout with a centered alignment and a
+ * Constructs a new {@code FlowLayout} with a centered alignment and a
* default 5-unit horizontal and vertical gap.
*/
public FlowLayout() {
@@ -204,12 +204,12 @@
}
/**
- * Constructs a new FlowLayout with the specified
+ * Constructs a new {@code FlowLayout} with the specified
* alignment and a default 5-unit horizontal and vertical gap.
* The value of the alignment argument must be one of
- * FlowLayout.LEFT, FlowLayout.RIGHT,
- * FlowLayout.CENTER, FlowLayout.LEADING,
- * or FlowLayout.TRAILING.
+ * {@code FlowLayout.LEFT}, {@code FlowLayout.RIGHT},
+ * {@code FlowLayout.CENTER}, {@code FlowLayout.LEADING},
+ * or {@code FlowLayout.TRAILING}.
* @param align the alignment value
*/
public FlowLayout(int align) {
@@ -221,16 +221,16 @@
* and the indicated horizontal and vertical gaps.
* FlowLayout.LEFT, FlowLayout.RIGHT,
- * FlowLayout.CENTER, FlowLayout.LEADING,
- * or FlowLayout.TRAILING.
+ * {@code FlowLayout.LEFT}, {@code FlowLayout.RIGHT},
+ * {@code FlowLayout.CENTER}, {@code FlowLayout.LEADING},
+ * or {@code FlowLayout.TRAILING}.
* @param align the alignment value
* @param hgap the horizontal gap between components
* and between the components and the
- * borders of the Container
+ * borders of the {@code Container}
* @param vgap the vertical gap between components
* and between the components and the
- * borders of the Container
+ * borders of the {@code Container}
*/
public FlowLayout(int align, int hgap, int vgap) {
this.hgap = hgap;
@@ -240,10 +240,10 @@
/**
* Gets the alignment for this layout.
- * Possible values are FlowLayout.LEFT,
- * FlowLayout.RIGHT, FlowLayout.CENTER,
- * FlowLayout.LEADING,
- * or FlowLayout.TRAILING.
+ * Possible values are {@code FlowLayout.LEFT},
+ * {@code FlowLayout.RIGHT}, {@code FlowLayout.CENTER},
+ * {@code FlowLayout.LEADING},
+ * or {@code FlowLayout.TRAILING}.
* @return the alignment value for this layout
* @see java.awt.FlowLayout#setAlignment
* @since 1.1
@@ -256,11 +256,11 @@
* Sets the alignment for this layout.
* Possible values are
*
- *
* @param align one of the alignment values shown above
* @see #getAlignment()
@@ -289,11 +289,11 @@
/**
* Gets the horizontal gap between components
* and between the components and the borders
- * of the FlowLayout.LEFT
- * FlowLayout.RIGHT
- * FlowLayout.CENTER
- * FlowLayout.LEADING
- * FlowLayout.TRAILING
+ * Container
+ * of the {@code Container}
*
* @return the horizontal gap between components
* and between the components and the borders
- * of the Container
+ * of the {@code Container}
* @see java.awt.FlowLayout#setHgap
* @since 1.1
*/
@@ -304,11 +304,11 @@
/**
* Sets the horizontal gap between components and
* between the components and the borders of the
- * Container.
+ * {@code Container}.
*
* @param hgap the horizontal gap between components
* and between the components and the borders
- * of the Container
+ * of the {@code Container}
* @see java.awt.FlowLayout#getHgap
* @since 1.1
*/
@@ -319,11 +319,11 @@
/**
* Gets the vertical gap between components and
* between the components and the borders of the
- * Container.
+ * {@code Container}.
*
* @return the vertical gap between components
* and between the components and the borders
- * of the Container
+ * of the {@code Container}
* @see java.awt.FlowLayout#setVgap
* @since 1.1
*/
@@ -333,11 +333,11 @@
/**
* Sets the vertical gap between components and between
- * the components and the borders of the Container.
+ * the components and the borders of the {@code Container}.
*
* @param vgap the vertical gap between components
* and between the components and the borders
- * of the Container
+ * of the {@code Container}
* @see java.awt.FlowLayout#getVgap
* @since 1.1
*/
@@ -578,7 +578,7 @@
* visible component take
* its preferred size by reshaping the components in the
* target container in order to satisfy the alignment of
- * this FlowLayout object.
+ * this {@code FlowLayout} object.
*
* @param target the specified component being laid out
* @see Container
@@ -648,10 +648,10 @@
//
private static final int currentSerialVersion = 1;
/**
- * This represent the currentSerialVersion
- * which is bein used. It will be one of two values :
- * 0 versions before Java 2 platform v1.2..
- * 1 versions after Java 2 platform v1.2..
+ * This represent the {@code currentSerialVersion}
+ * which is bein used. It will be one of two values:
+ * {@code 0} versions before Java 2 platform v1.2,
+ * {@code 1} versions after Java 2 platform v1.2.
*
* @serial
* @since 1.2
@@ -676,7 +676,7 @@
}
/**
- * Returns a string representation of this FlowLayout
+ * Returns a string representation of this {@code FlowLayout}
* object and its values.
* @return a string representation of this layout
*/
--- old/src/java.desktop/share/classes/java/awt/FocusTraversalPolicy.java 2015-10-04 22:52:37.129274444 +0400
+++ new/src/java.desktop/share/classes/java/awt/FocusTraversalPolicy.java 2015-10-04 22:52:36.941274452 +0400
@@ -147,7 +147,7 @@
/**
* Returns the Component that should receive the focus when a Window is
* made visible for the first time. Once the Window has been made visible
- * by a call to show() or setVisible(true), the
+ * by a call to {@code show()} or {@code setVisible(true)}, the
* initial Component will not be used again. Instead, if the Window loses
* and subsequently regains focus, or is made invisible or undisplayable
* and subsequently made visible and displayable, the Window's most
--- old/src/java.desktop/share/classes/java/awt/Font.java 2015-10-04 22:52:37.717274417 +0400
+++ new/src/java.desktop/share/classes/java/awt/Font.java 2015-10-04 22:52:37.509274427 +0400
@@ -65,17 +65,17 @@
import static sun.font.EAttribute.*;
/**
- * The Font class represents fonts, which are used to
+ * The {@code Font} class represents fonts, which are used to
* render text in a visible way.
* A font provides the information needed to map sequences of
* characters to sequences of glyphs
- * and to render sequences of glyphs on Graphics and
- * Component objects.
+ * and to render sequences of glyphs on {@code Graphics} and
+ * {@code Component} objects.
*
* Characters and Glyphs
*
* A character is a symbol that represents an item such as a letter,
- * a digit, or punctuation in an abstract way. For example, 'g',
+ * a digit, or punctuation in an abstract way. For example, {@code 'g'},
* LATIN SMALL LETTER G, is a character.
* Font Faces and Names
*
- * A Font
+ * A {@code Font}
* can have many faces, such as heavy, medium, oblique, gothic and
* regular. All of these faces have similar typographic design.
* Font object. The logical font name is simply the
+ * {@code Font} object. The logical font name is simply the
* name that was used to construct the font.
* The font face name, or just font name for
* short, is the name of a particular font face, like Helvetica Bold. The
* family name is the name of the font family that determines the
* typographic design across several faces, like Helvetica.
* Font class represents an instance of a font face from
+ * The {@code Font} class represents an instance of a font face from
* a collection of font faces that are present in the system resources
* of the host system. As examples, Arial Bold and Courier Bold Italic
- * are font faces. There can be several Font objects
+ * are font faces. There can be several {@code Font} objects
* associated with a font face, each differing in size, style, transform
* and font features.
* GraphicsEnvironment class returns an
+ * of the {@code GraphicsEnvironment} class returns an
* array of all font faces available in the system. These font faces are
- * returned as Font objects with a size of 1, identity
+ * returned as {@code Font} objects with a size of 1, identity
* transform and default font features. These
- * base fonts can then be used to derive new Font objects
+ * base fonts can then be used to derive new {@code Font} objects
* with varying sizes, styles, transforms and font features via the
- * deriveFont methods in this class.
+ * {@code deriveFont} methods in this class.
*
* Font and TextAttribute
*
- * Font supports most
- * TextAttributes. This makes some operations, such as
+ * TextLayout object.
+ * necessary to explicitly construct a {@code TextLayout} object.
* Attributes can be set on a Font by constructing or deriving it
- * using a Map of TextAttribute values.
+ * using a {@code Map} of {@code TextAttribute} values.
*
- * TextAttributes are not
+ * Font that has such values will not serialize them.
+ * {@code Font} that has such values will not serialize them.
* This means a Font deserialized from such a stream will not compare
* equal to the original Font that contained the non-serializable
* attributes. This should very rarely pose a problem
@@ -182,34 +182,34 @@
* circumstances and are unlikely to be serialized.
*
*
- *
*
- * FOREGROUND and BACKGROUND use
- * Paint values. The subclass Color is
- * serializable, while GradientPaint and
- * TexturePaint are not.CHAR_REPLACEMENT uses
- * GraphicAttribute values. The subclasses
- * ShapeGraphicAttribute and
- * ImageGraphicAttribute are not serializable.INPUT_METHOD_HIGHLIGHT uses
- * InputMethodHighlight values, which are
+ * Paint and
- * GraphicAttribute can make them serializable and
+ * Map-based constructor and
- * deriveFont APIs ignore the FONT attribute, and it is
+ * Font has such
+ * and potentially invoke layout. If a {@code Font} has such
* attributes, the {@link #hasLayoutAttributes()} method
* will return true.Font, as passed to the
+ * The logical name of this {@code Font}, as passed to the
* constructor.
* @since 1.0
*
@@ -380,7 +380,7 @@
protected String name;
/**
- * The style of this Font, as passed to the constructor.
+ * The style of this {@code Font}, as passed to the constructor.
* This style can be PLAIN, BOLD, ITALIC, or BOLD+ITALIC.
* @since 1.0
*
@@ -390,7 +390,7 @@
protected int style;
/**
- * The point size of this Font, rounded to integer.
+ * The point size of this {@code Font}, rounded to integer.
* @since 1.0
*
* @serial
@@ -399,7 +399,7 @@
protected int size;
/**
- * The point size of this Font in float.
+ * The point size of this {@code Font} in {@code float}.
*
* @serial
* @see #getSize()
@@ -508,7 +508,7 @@
}
/**
- * Creates a new Font from the specified name, style and
+ * Creates a new {@code Font} from the specified name, style and
* point size.
* Font.ITALIC, the font system looks for a face in the
+ * {@code Font.ITALIC}, the font system looks for a face in the
* "Arial" family that is bold and italic, and may associate the font
* instance with the physical font face "Arial Bold Italic".
* The style argument is merged with the specified face's style, not
@@ -529,14 +529,14 @@
* ITALIC is requested, but no italic
+ * For example, if {@code ITALIC} is requested, but no italic
* face is available, glyphs from the plain face may be algorithmically
* obliqued (slanted).
* name parameter represents something other than a
+ * If the {@code name} parameter represents something other than a
* logical font, i.e. is interpreted as a physical font face or family, and
* this cannot be mapped by the implementation to a physical font or a
* compatible alternative, then the font system will map the Font
@@ -677,28 +677,28 @@
}
/**
- * Creates a new Font with the specified attributes.
+ * Creates a new {@code Font} with the specified attributes.
* Only keys defined in {@link java.awt.font.TextAttribute TextAttribute}
* are recognized. In addition the FONT attribute is
* not recognized by this constructor
* (see {@link #getAvailableAttributes}). Only attributes that have
- * values of valid types will affect the new Font.
+ * values of valid types will affect the new {@code Font}.
* attributes is null, a new
- * Font is initialized with default values.
+ * If {@code attributes} is {@code null}, a new
+ * {@code Font} is initialized with default values.
* @see java.awt.font.TextAttribute
* @param attributes the attributes to assign to the new
- * Font, or null
+ * {@code Font}, or {@code null}
*/
public Font(Map attributes) {
initFromValues(AttributeValues.fromMap(attributes, RECOGNIZED_MASK));
}
/**
- * Creates a new Font from the specified font.
+ * Creates a new {@code Font} from the specified {@code font}.
* This constructor is intended for use by subclasses.
- * @param font from which to create this Font.
- * @throws NullPointerException if font is null
+ * @param font from which to create this {@code Font}.
+ * @throws NullPointerException if {@code font} is null
* @since 1.6
*/
protected Font(Font font) {
@@ -765,18 +765,18 @@
}
/**
- * Returns a Font appropriate to the attributes.
- * If attributescontains a FONT attribute
- * with a valid Font as its value, it will be
+ * Returns a {@code Font} appropriate to the attributes.
+ * If {@code attributes} contains a {@code FONT} attribute
+ * with a valid {@code Font} as its value, it will be
* merged with any remaining attributes. See
* {@link java.awt.font.TextAttribute#FONT} for more
* information.
*
* @param attributes the attributes to assign to the new
- * Font
- * @return a new Font created with the specified
+ * {@code Font}
+ * @return a new {@code Font} created with the specified
* attributes
- * @throws NullPointerException if attributes is null.
+ * @throws NullPointerException if {@code attributes} is null.
* @since 1.2
* @see java.awt.font.TextAttribute
*/
@@ -842,29 +842,29 @@
}
/**
- * Returns a new Font using the specified font type
- * and input data. The new Font is
+ * Returns a new {@code Font} using the specified font type
+ * and input data. The new {@code Font} is
* created with a point size of 1 and style {@link #PLAIN PLAIN}.
- * This base font can then be used with the deriveFont
- * methods in this class to derive new Font objects with
+ * This base font can then be used with the {@code deriveFont}
+ * methods in this class to derive new {@code Font} objects with
* varying sizes, styles, transforms and font features. This
* method does not close the {@link InputStream}.
* Font available to Font constructors the
- * returned Font must be registered in the
- * GraphicsEnvironment by calling
+ * To make the {@code Font} available to Font constructors the
+ * returned {@code Font} must be registered in the
+ * {@code GraphicsEnvironment} by calling
* {@link GraphicsEnvironment#registerFont(Font) registerFont(Font)}.
- * @param fontFormat the type of the Font, which is
+ * @param fontFormat the type of the {@code Font}, which is
* {@link #TRUETYPE_FONT TRUETYPE_FONT} if a TrueType resource is specified.
* or {@link #TYPE1_FONT TYPE1_FONT} if a Type 1 resource is specified.
- * @param fontStream an InputStream object representing the
+ * @param fontStream an {@code InputStream} object representing the
* input data for the font.
- * @return a new Font created with the specified font type.
- * @throws IllegalArgumentException if fontFormat is not
- * TRUETYPE_FONTorTYPE1_FONT.
- * @throws FontFormatException if the fontStream data does
+ * @return a new {@code Font} created with the specified font type.
+ * @throws IllegalArgumentException if {@code fontFormat} is not
+ * {@code TRUETYPE_FONT} or {@code TYPE1_FONT}.
+ * @throws FontFormatException if the {@code fontStream} data does
* not contain the required font tables for the specified format.
- * @throws IOException if the fontStream
+ * @throws IOException if the {@code fontStream}
* cannot be completely read.
* @see GraphicsEnvironment#registerFont(Font)
* @since 1.3
@@ -1001,33 +1001,33 @@
}
/**
- * Returns a new Font using the specified font type
- * and the specified font file. The new Font is
+ * Returns a new {@code Font} using the specified font type
+ * and the specified font file. The new {@code Font} is
* created with a point size of 1 and style {@link #PLAIN PLAIN}.
- * This base font can then be used with the deriveFont
- * methods in this class to derive new Font objects with
+ * This base font can then be used with the {@code deriveFont}
+ * methods in this class to derive new {@code Font} objects with
* varying sizes, styles, transforms and font features.
- * @param fontFormat the type of the Font, which is
+ * @param fontFormat the type of the {@code Font}, which is
* {@link #TRUETYPE_FONT TRUETYPE_FONT} if a TrueType resource is
* specified or {@link #TYPE1_FONT TYPE1_FONT} if a Type 1 resource is
* specified.
* So long as the returned font, or its derived fonts are referenced
- * the implementation may continue to access fontFile
+ * the implementation may continue to access {@code fontFile}
* to retrieve font data. Thus the results are undefined if the file
* is changed, or becomes inaccessible.
* Font available to Font constructors the
- * returned Font must be registered in the
- * GraphicsEnvironment by calling
+ * To make the {@code Font} available to Font constructors the
+ * returned {@code Font} must be registered in the
+ * {@code GraphicsEnvironment} by calling
* {@link GraphicsEnvironment#registerFont(Font) registerFont(Font)}.
- * @param fontFile a File object representing the
+ * @param fontFile a {@code File} object representing the
* input data for the font.
- * @return a new Font created with the specified font type.
- * @throws IllegalArgumentException if fontFormat is not
- * TRUETYPE_FONTorTYPE1_FONT.
- * @throws NullPointerException if fontFile is null.
- * @throws IOException if the fontFile cannot be read.
- * @throws FontFormatException if fontFile does
+ * @return a new {@code Font} created with the specified font type.
+ * @throws IllegalArgumentException if {@code fontFormat} is not
+ * {@code TRUETYPE_FONT} or {@code TYPE1_FONT}.
+ * @throws NullPointerException if {@code fontFile} is null.
+ * @throws IOException if the {@code fontFile} cannot be read.
+ * @throws FontFormatException if {@code fontFile} does
* not contain the required font tables for the specified format.
* @throws SecurityException if the executing code does not have
* permission to read from the file.
@@ -1057,17 +1057,17 @@
/**
* Returns a copy of the transform associated with this
- * Font. This transform is not necessarily the one
+ * {@code Font}. This transform is not necessarily the one
* used to construct the font. If the font has algorithmic
* superscripting or width adjustment, this will be incorporated
- * into the returned AffineTransform.
+ * into the returned {@code AffineTransform}.
* isTransformed returns true.
+ * method if {@code isTransformed} returns true.
*
* @return an {@link AffineTransform} object representing the
- * transform attribute of this Font object.
+ * transform attribute of this {@code Font} object.
*/
public AffineTransform getTransform() {
/* The most common case is the identity transform. Most callers
@@ -1163,7 +1163,7 @@
};
/**
- * Returns the family name of this Font.
+ * Returns the family name of this {@code Font}.
*
* getName to get the logical name of the font.
- * Use getFontName to get the font face name of the font.
- * @return a String that is the family name of this
- * Font.
+ * Font, localized for
+ * Returns the family name of this {@code Font}, localized for
* the specified locale.
*
* getFontName to get the font face name of the font.
+ * String representing the family name of the
+ * @return a {@code String} representing the family name of the
* font, localized for the specified locale.
* @see #getFontName
* @see java.util.Locale
@@ -1220,11 +1220,11 @@
}
/**
- * Returns the postscript name of this Font.
- * Use getFamily to get the family name of the font.
- * Use getFontName to get the font face name of the font.
- * @return a String representing the postscript name of
- * this Font.
+ * Returns the postscript name of this {@code Font}.
+ * Use {@code getFamily} to get the family name of the font.
+ * Use {@code getFontName} to get the font face name of the font.
+ * @return a {@code String} representing the postscript name of
+ * this {@code Font}.
* @since 1.2
*/
public String getPSName() {
@@ -1232,11 +1232,11 @@
}
/**
- * Returns the logical name of this Font.
- * Use getFamily to get the family name of the font.
- * Use getFontName to get the font face name of the font.
- * @return a String representing the logical name of
- * this Font.
+ * Returns the logical name of this {@code Font}.
+ * Use {@code getFamily} to get the family name of the font.
+ * Use {@code getFontName} to get the font face name of the font.
+ * @return a {@code String} representing the logical name of
+ * this {@code Font}.
* @see #getFamily
* @see #getFontName
* @since 1.0
@@ -1246,12 +1246,12 @@
}
/**
- * Returns the font face name of this Font. For example,
+ * Returns the font face name of this {@code Font}. For example,
* Helvetica Bold could be returned as a font face name.
- * Use getFamily to get the family name of the font.
- * Use getName to get the logical name of the font.
- * @return a String representing the font face name of
- * this Font.
+ * Use {@code getFamily} to get the family name of the font.
+ * Use {@code getName} to get the logical name of the font.
+ * @return a {@code String} representing the font face name of
+ * this {@code Font}.
* @see #getFamily
* @see #getName
* @since 1.2
@@ -1261,12 +1261,12 @@
}
/**
- * Returns the font face name of the Font, localized
+ * Returns the font face name of the {@code Font}, localized
* for the specified locale. For example, Helvetica Fett could be
* returned as the font face name.
- * Use getFamily to get the family name of the font.
+ * Use {@code getFamily} to get the family name of the font.
* @param l a locale for which to get the font face name
- * @return a String representing the font face name,
+ * @return a {@code String} representing the font face name,
* localized for the specified locale.
* @see #getFamily
* @see java.util.Locale
@@ -1279,9 +1279,9 @@
}
/**
- * Returns the style of this Font. The style can be
+ * Returns the style of this {@code Font}. The style can be
* PLAIN, BOLD, ITALIC, or BOLD+ITALIC.
- * @return the style of this Font
+ * @return the style of this {@code Font}
* @see #isPlain
* @see #isBold
* @see #isItalic
@@ -1292,7 +1292,7 @@
}
/**
- * Returns the point size of this Font, rounded to
+ * Returns the point size of this {@code Font}, rounded to
* an integer.
* Most users are familiar with the idea of using point size to
* specify the size of glyphs in a font. This point size defines a
@@ -1306,7 +1306,7 @@
* device space coordinates 72 user
* space units equal 1 inch in device space. In this case one point
* is 1/72 of an inch.
- * @return the point size of this Font in 1/72 of an
+ * @return the point size of this {@code Font} in 1/72 of an
* inch units.
* @see #getSize2D
* @see GraphicsConfiguration#getDefaultTransform
@@ -1318,10 +1318,10 @@
}
/**
- * Returns the point size of this Font in
- * float value.
- * @return the point size of this Font as a
- * float value.
+ * Returns the point size of this {@code Font} in
+ * {@code float} value.
+ * @return the point size of this {@code Font} as a
+ * {@code float} value.
* @see #getSize
* @since 1.2
*/
@@ -1330,11 +1330,11 @@
}
/**
- * Indicates whether or not this Font object's style is
+ * Indicates whether or not this {@code Font} object's style is
* PLAIN.
- * @return true if this Font has a
+ * @return {@code true} if this {@code Font} has a
* PLAIN style;
- * false otherwise.
+ * {@code false} otherwise.
* @see java.awt.Font#getStyle
* @since 1.0
*/
@@ -1343,11 +1343,11 @@
}
/**
- * Indicates whether or not this Font object's style is
+ * Indicates whether or not this {@code Font} object's style is
* BOLD.
- * @return true if this Font object's
+ * @return {@code true} if this {@code Font} object's
* style is BOLD;
- * false otherwise.
+ * {@code false} otherwise.
* @see java.awt.Font#getStyle
* @since 1.0
*/
@@ -1356,11 +1356,11 @@
}
/**
- * Indicates whether or not this Font object's style is
+ * Indicates whether or not this {@code Font} object's style is
* ITALIC.
- * @return true if this Font object's
+ * @return {@code true} if this {@code Font} object's
* style is ITALIC;
- * false otherwise.
+ * {@code false} otherwise.
* @see java.awt.Font#getStyle
* @since 1.0
*/
@@ -1369,12 +1369,12 @@
}
/**
- * Indicates whether or not this Font object has a
+ * Indicates whether or not this {@code Font} object has a
* transform that affects its size in addition to the Size
* attribute.
- * @return true if this Font object
+ * @return {@code true} if this {@code Font} object
* has a non-identity AffineTransform attribute.
- * false otherwise.
+ * {@code false} otherwise.
* @see java.awt.Font#getTransform
* @since 1.4
*/
@@ -1393,16 +1393,16 @@
}
/**
- * Returns a Font object from the system properties list.
- * nm is treated as the name of a system property to be
- * obtained. The String value of this property is then
- * interpreted as a Font object according to the
- * specification of Font.decode(String)
+ * Returns a {@code Font} object from the system properties list.
+ * {@code nm} is treated as the name of a system property to be
+ * obtained. The {@code String} value of this property is then
+ * interpreted as a {@code Font} object according to the
+ * specification of {@code Font.decode(String)}
* If the specified property is not found, or the executing code does
* not have permission to read the property, null is returned instead.
*
* @param nm the property name
- * @return a Font object that the property name
+ * @return a {@code Font} object that the property name
* describes, or null if no such property exists.
* @throws NullPointerException if nm is null.
* @since 1.2
@@ -1413,10 +1413,10 @@
}
/**
- * Returns the Font that the str
+ * Returns the {@code Font} that the {@code str}
* argument describes.
* To ensure that this method returns the desired Font,
- * format the str parameter in
+ * format the {@code str} parameter in
* one of these ways
*
*
@@ -1431,14 +1431,14 @@
*
* in which style is one of the four
* case-insensitive strings:
- * "PLAIN", "BOLD", "BOLDITALIC", or
- * "ITALIC", and pointsize is a positive decimal integer
+ * {@code "PLAIN"}, {@code "BOLD"}, {@code "BOLDITALIC"}, or
+ * {@code "ITALIC"}, and pointsize is a positive decimal integer
* representation of the point size.
* For example, if you want a font that is Arial, bold, with
* a point size of 18, you would call this method with:
* "Arial-BOLD-18".
* This is equivalent to calling the Font constructor :
- * new Font("Arial", Font.BOLD, 18);
+ * {@code new Font("Arial", Font.BOLD, 18);}
* and the values are interpreted as specified by that constructor.
* str is not formed with 3 components, e.g. such that
- * style or pointsize fields are not present in
- * str, and fontname also contains a
+ * If {@code str} is not formed with 3 components, e.g. such that
+ * {@code style} or {@code pointsize} fields are not present in
+ * {@code str}, and {@code fontname} also contains a
* character determined to be the separator character
* then these characters where they appear as intended to be part of
- * fontname may instead be interpreted as separators
+ * {@code fontname} may instead be interpreted as separators
* so the font name may not be properly recognised.
*
* str does not specify a valid size, the returned
- * Font has a size of 12. If str does not
+ * If {@code str} does not specify a valid size, the returned
+ * {@code Font} has a size of 12. If {@code str} does not
* specify a valid style, the returned Font has a style of PLAIN.
* If you do not specify a valid font name in
- * the str argument, this method will return
+ * the {@code str} argument, this method will return
* a font with the family name "Dialog".
* To determine what font family names are available on
* your system, use the
* {@link GraphicsEnvironment#getAvailableFontFamilyNames()} method.
- * If str is null, a new Font
+ * If {@code str} is {@code null}, a new {@code Font}
* is returned with the family name "Dialog", a size of 12 and a
* PLAIN style.
- * @param str the name of the font, or null
- * @return the Font object that str
- * describes, or a new default Font if
- * str is null.
+ * @param str the name of the font, or {@code null}
+ * @return the {@code Font} object that {@code str}
+ * describes, or a new default {@code Font} if
+ * {@code str} is {@code null}.
* @see #getFamily
* @since 1.1
*/
@@ -1559,22 +1559,22 @@
}
/**
- * Gets the specified Font from the system properties
- * list. As in the getProperty method of
- * System, the first
+ * Gets the specified {@code Font} from the system properties
+ * list. As in the {@code getProperty} method of
+ * {@code System}, the first
* argument is treated as the name of a system property to be
- * obtained. The String value of this property is then
- * interpreted as a Font object.
+ * obtained. The {@code String} value of this property is then
+ * interpreted as a {@code Font} object.
* Font.decode(String)
+ * {@code Font.decode(String)}
* If the specified property is not found, or the executing code does not
- * have permission to read the property, the font
+ * have permission to read the property, the {@code font}
* argument is returned instead.
* @param nm the case-insensitive property name
- * @param font a default Font to return if property
- * nm is not defined
- * @return the Font value of the property.
+ * @param font a default {@code Font} to return if property
+ * {@code nm} is not defined
+ * @return the {@code Font} value of the property.
* @throws NullPointerException if nm is null.
* @see #decode(String)
*/
@@ -1592,8 +1592,8 @@
transient int hash;
/**
- * Returns a hashcode for this Font.
- * @return a hashcode value for this Font.
+ * Returns a hashcode for this {@code Font}.
+ * @return a hashcode value for this {@code Font}.
* @since 1.0
*/
public int hashCode() {
@@ -1614,13 +1614,13 @@
}
/**
- * Compares this Font object to the specified
- * Object.
- * @param obj the Object to compare
- * @return true if the objects are the same
- * or if the argument is a Font object
+ * Compares this {@code Font} object to the specified
+ * {@code Object}.
+ * @param obj the {@code Object} to compare
+ * @return {@code true} if the objects are the same
+ * or if the argument is a {@code Font} object
* describing the same font as this object;
- * false otherwise.
+ * {@code false} otherwise.
* @since 1.0
*/
public boolean equals(Object obj) {
@@ -1662,10 +1662,10 @@
}
/**
- * Converts this Font object to a String
+ * Converts this {@code Font} object to a {@code String}
* representation.
- * @return a String representation of this
- * Font object.
+ * @return a {@code String} representation of this
+ * {@code Font} object.
* @since 1.0
*/
// NOTE: This method may be called by privileged threads.
@@ -1684,17 +1684,17 @@
} // toString()
- /** Serialization support. A readObject
+ /** Serialization support. A {@code readObject}
* method is necessary because the constructor creates
* the font's peer, and we can't serialize the peer.
* Similarly the computed font "family" may be different
- * at readObject time than at
- * writeObject time. An integer version is
+ * at {@code readObject} time than at
+ * {@code writeObject} time. An integer version is
* written so that future versions of this class will be
* able to recognize serialized output from this one.
*/
/**
- * The Font Serializable Data Form.
+ * The {@code Font} Serializable Data Form.
*
* @serial
*/
@@ -1703,7 +1703,7 @@
/**
* Writes default serializable fields to a stream.
*
- * @param s the ObjectOutputStream to write
+ * @param s the {@code ObjectOutputStream} to write
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see #readObject(java.io.ObjectInputStream)
*/
@@ -1724,10 +1724,10 @@
}
/**
- * Reads the ObjectInputStream.
+ * Reads the {@code ObjectInputStream}.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @serial
* @see #writeObject(java.io.ObjectOutputStream)
*/
@@ -1764,10 +1764,10 @@
}
/**
- * Returns the number of glyphs in this Font. Glyph codes
- * for this Font range from 0 to
- * getNumGlyphs() - 1.
- * @return the number of glyphs in this Font.
+ * Returns the number of glyphs in this {@code Font}. Glyph codes
+ * for this {@code Font} range from 0 to
+ * {@code getNumGlyphs()} - 1.
+ * @return the number of glyphs in this {@code Font}.
* @since 1.2
*/
public int getNumGlyphs() {
@@ -1775,9 +1775,9 @@
}
/**
- * Returns the glyphCode which is used when this Font
+ * Returns the glyphCode which is used when this {@code Font}
* does not have a glyph for a specified unicode code point.
- * @return the glyphCode of this Font.
+ * @return the glyphCode of this {@code Font}.
* @since 1.2
*/
public int getMissingGlyphCode() {
@@ -1806,9 +1806,9 @@
/**
* Returns a map of font attributes available in this
- * Font. Attributes include things like ligatures and
+ * {@code Font}. Attributes include things like ligatures and
* glyph substitution.
- * @return the attributes map of this Font.
+ * @return the attributes map of this {@code Font}.
*/
public MapFont. These attributes can be used to derive other
+ * {@code Font}. These attributes can be used to derive other
* fonts.
* @return an array containing the keys of all the attributes
- * supported by this Font.
+ * supported by this {@code Font}.
* @since 1.2
*/
public Attribute[] getAvailableAttributes() {
@@ -1854,11 +1854,11 @@
}
/**
- * Creates a new Font object by replicating this
- * Font object and applying a new style and size.
- * @param style the style for the new Font
- * @param size the size for the new Font
- * @return a new Font object.
+ * Creates a new {@code Font} object by replicating this
+ * {@code Font} object and applying a new style and size.
+ * @param style the style for the new {@code Font}
+ * @param size the size for the new {@code Font}
+ * @return a new {@code Font} object.
* @since 1.2
*/
public Font deriveFont(int style, float size){
@@ -1873,14 +1873,14 @@
}
/**
- * Creates a new Font object by replicating this
- * Font object and applying a new style and transform.
- * @param style the style for the new Font
- * @param trans the AffineTransform associated with the
- * new Font
- * @return a new Font object.
- * @throws IllegalArgumentException if trans is
- * null
+ * Creates a new {@code Font} object by replicating this
+ * {@code Font} object and applying a new style and transform.
+ * @param style the style for the new {@code Font}
+ * @param trans the {@code AffineTransform} associated with the
+ * new {@code Font}
+ * @return a new {@code Font} object.
+ * @throws IllegalArgumentException if {@code trans} is
+ * {@code null}
* @since 1.2
*/
public Font deriveFont(int style, AffineTransform trans){
@@ -1892,10 +1892,10 @@
}
/**
- * Creates a new Font object by replicating the current
- * Font object and applying a new size to it.
- * @param size the size for the new Font.
- * @return a new Font object.
+ * Creates a new {@code Font} object by replicating the current
+ * {@code Font} object and applying a new size to it.
+ * @param size the size for the new {@code Font}.
+ * @return a new {@code Font} object.
* @since 1.2
*/
public Font deriveFont(float size){
@@ -1908,13 +1908,13 @@
}
/**
- * Creates a new Font object by replicating the current
- * Font object and applying a new transform to it.
- * @param trans the AffineTransform associated with the
- * new Font
- * @return a new Font object.
- * @throws IllegalArgumentException if trans is
- * null
+ * Creates a new {@code Font} object by replicating the current
+ * {@code Font} object and applying a new transform to it.
+ * @param trans the {@code AffineTransform} associated with the
+ * new {@code Font}
+ * @return a new {@code Font} object.
+ * @throws IllegalArgumentException if {@code trans} is
+ * {@code null}
* @since 1.2
*/
public Font deriveFont(AffineTransform trans){
@@ -1924,10 +1924,10 @@
}
/**
- * Creates a new Font object by replicating the current
- * Font object and applying a new style to it.
- * @param style the style for the new Font
- * @return a new Font object.
+ * Creates a new {@code Font} object by replicating the current
+ * {@code Font} object and applying a new style to it.
+ * @param style the style for the new {@code Font}
+ * @return a new {@code Font} object.
* @since 1.2
*/
public Font deriveFont(int style){
@@ -1941,13 +1941,13 @@
}
/**
- * Creates a new Font object by replicating the current
- * Font object and applying a new set of font attributes
+ * Creates a new {@code Font} object by replicating the current
+ * {@code Font} object and applying a new set of font attributes
* to it.
*
* @param attributes a map of attributes enabled for the new
- * Font
- * @return a new Font object.
+ * {@code Font}
+ * @return a new {@code Font} object.
* @since 1.2
*/
public Font deriveFont(Map attributes) {
@@ -1961,18 +1961,18 @@
}
/**
- * Checks if this Font has a glyph for the specified
+ * Checks if this {@code Font} has a glyph for the specified
* character.
*
* canDisplayUpTo methods.
+ * method or {@code canDisplayUpTo} methods.
*
* @param c the character for which a glyph is needed
- * @return true if this Font has a glyph for this
- * character; false otherwise.
+ * @return {@code true} if this {@code Font} has a glyph for this
+ * character; {@code false} otherwise.
* @since 1.2
*/
public boolean canDisplay(char c){
@@ -1980,13 +1980,13 @@
}
/**
- * Checks if this Font has a glyph for the specified
+ * Checks if this {@code Font} has a glyph for the specified
* character.
*
* @param codePoint the character (Unicode code point) for which a glyph
* is needed.
- * @return true if this Font has a glyph for the
- * character; false otherwise.
+ * @return {@code true} if this {@code Font} has a glyph for the
+ * character; {@code false} otherwise.
* @throws IllegalArgumentException if the code point is not a valid Unicode
* code point.
* @see Character#isValidCodePoint(int)
@@ -2001,20 +2001,20 @@
}
/**
- * Indicates whether or not this Font can display a
- * specified String. For strings with Unicode encoding,
+ * Indicates whether or not this {@code Font} can display a
+ * specified {@code String}. For strings with Unicode encoding,
* it is important to know if a particular font can display the
- * string. This method returns an offset into the String
- * str which is the first character this
- * Font cannot display without using the missing glyph
- * code. If the Font can display all characters, -1 is
+ * string. This method returns an offset into the {@code String}
+ * {@code str} which is the first character this
+ * {@code Font} cannot display without using the missing glyph
+ * code. If the {@code Font} can display all characters, -1 is
* returned.
- * @param str a String object
- * @return an offset into str that points
- * to the first character in str that this
- * Font cannot display; or -1 if
- * this Font can display all characters in
- * str.
+ * @param str a {@code String} object
+ * @return an offset into {@code str} that points
+ * to the first character in {@code str} that this
+ * {@code Font} cannot display; or {@code -1} if
+ * this {@code Font} can display all characters in
+ * {@code str}.
* @since 1.2
*/
public int canDisplayUpTo(String str) {
@@ -2037,22 +2037,22 @@
}
/**
- * Indicates whether or not this Font can display
- * the characters in the specified text
- * starting at start and ending at
- * limit. This method is a convenience overload.
- * @param text the specified array of char values
+ * Indicates whether or not this {@code Font} can display
+ * the characters in the specified {@code text}
+ * starting at {@code start} and ending at
+ * {@code limit}. This method is a convenience overload.
+ * @param text the specified array of {@code char} values
* @param start the specified starting offset (in
- * chars) into the specified array of
- * char values
+ * {@code char}s) into the specified array of
+ * {@code char} values
* @param limit the specified ending offset (in
- * chars) into the specified array of
- * char values
- * @return an offset into text that points
- * to the first character in text that this
- * Font cannot display; or -1 if
- * this Font can display all characters in
- * text.
+ * {@code char}s) into the specified array of
+ * {@code char} values
+ * @return an offset into {@code text} that points
+ * to the first character in {@code text} that this
+ * {@code Font} cannot display; or {@code -1} if
+ * this {@code Font} can display all characters in
+ * {@code text}.
* @since 1.2
*/
public int canDisplayUpTo(char[] text, int start, int limit) {
@@ -2074,20 +2074,20 @@
}
/**
- * Indicates whether or not this Font can display the
- * text specified by the iter starting at
- * start and ending at limit.
+ * Indicates whether or not this {@code Font} can display the
+ * text specified by the {@code iter} starting at
+ * {@code start} and ending at {@code limit}.
*
* @param iter a {@link CharacterIterator} object
* @param start the specified starting offset into the specified
- * CharacterIterator.
+ * {@code CharacterIterator}.
* @param limit the specified ending offset into the specified
- * CharacterIterator.
- * @return an offset into iter that points
- * to the first character in iter that this
- * Font cannot display; or -1 if
- * this Font can display all characters in
- * iter.
+ * {@code CharacterIterator}.
+ * @return an offset into {@code iter} that points
+ * to the first character in {@code iter} that this
+ * {@code Font} cannot display; or {@code -1} if
+ * this {@code Font} can display all characters in
+ * {@code iter}.
* @since 1.2
*/
public int canDisplayUpTo(CharacterIterator iter, int start, int limit) {
@@ -2114,11 +2114,11 @@
}
/**
- * Returns the italic angle of this Font. The italic angle
+ * Returns the italic angle of this {@code Font}. The italic angle
* is the inverse slope of the caret which best matches the posture of this
- * Font.
+ * {@code Font}.
* @see TextAttribute#POSTURE
- * @return the angle of the ITALIC style of this Font.
+ * @return the angle of the ITALIC style of this {@code Font}.
*/
public float getItalicAngle() {
return getItalicAngle(null);
@@ -2145,15 +2145,15 @@
}
/**
- * Checks whether or not this Font has uniform
- * line metrics. A logical Font might be a
+ * Checks whether or not this {@code Font} has uniform
+ * line metrics. A logical {@code Font} might be a
* composite font, which means that it is composed of different
* physical fonts to cover different code ranges. Each of these
- * fonts might have different LineMetrics. If the
- * logical Font is a single
+ * fonts might have different {@code LineMetrics}. If the
+ * logical {@code Font} is a single
* font then the metrics would be uniform.
- * @return true if this Font has
- * uniform line metrics; false otherwise.
+ * @return {@code true} if this {@code Font} has
+ * uniform line metrics; {@code false} otherwise.
*/
public boolean hasUniformLineMetrics() {
return false; // REMIND always safe, but prevents caller optimize
@@ -2235,11 +2235,11 @@
/**
* Returns a {@link LineMetrics} object created with the specified
- * String and {@link FontRenderContext}.
- * @param str the specified String
- * @param frc the specified FontRenderContext
- * @return a LineMetrics object created with the
- * specified String and {@link FontRenderContext}.
+ * {@code String} and {@link FontRenderContext}.
+ * @param str the specified {@code String}
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code LineMetrics} object created with the
+ * specified {@code String} and {@link FontRenderContext}.
*/
public LineMetrics getLineMetrics( String str, FontRenderContext frc) {
FontLineMetrics flm = defaultLineMetrics(frc);
@@ -2248,13 +2248,13 @@
}
/**
- * Returns a LineMetrics object created with the
+ * Returns a {@code LineMetrics} object created with the
* specified arguments.
- * @param str the specified String
- * @param beginIndex the initial offset of str
- * @param limit the end offset of str
- * @param frc the specified FontRenderContext
- * @return a LineMetrics object created with the
+ * @param str the specified {@code String}
+ * @param beginIndex the initial offset of {@code str}
+ * @param limit the end offset of {@code str}
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code LineMetrics} object created with the
* specified arguments.
*/
public LineMetrics getLineMetrics( String str,
@@ -2267,13 +2267,13 @@
}
/**
- * Returns a LineMetrics object created with the
+ * Returns a {@code LineMetrics} object created with the
* specified arguments.
* @param chars an array of characters
- * @param beginIndex the initial offset of chars
- * @param limit the end offset of chars
- * @param frc the specified FontRenderContext
- * @return a LineMetrics object created with the
+ * @param beginIndex the initial offset of {@code chars}
+ * @param limit the end offset of {@code chars}
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code LineMetrics} object created with the
* specified arguments.
*/
public LineMetrics getLineMetrics(char [] chars,
@@ -2286,13 +2286,13 @@
}
/**
- * Returns a LineMetrics object created with the
+ * Returns a {@code LineMetrics} object created with the
* specified arguments.
- * @param ci the specified CharacterIterator
- * @param beginIndex the initial offset in ci
- * @param limit the end offset of ci
- * @param frc the specified FontRenderContext
- * @return a LineMetrics object created with the
+ * @param ci the specified {@code CharacterIterator}
+ * @param beginIndex the initial offset in {@code ci}
+ * @param limit the end offset of {@code ci}
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code LineMetrics} object created with the
* specified arguments.
*/
public LineMetrics getLineMetrics(CharacterIterator ci,
@@ -2305,22 +2305,22 @@
}
/**
- * Returns the logical bounds of the specified String in
- * the specified FontRenderContext. The logical bounds
+ * Returns the logical bounds of the specified {@code String} in
+ * the specified {@code FontRenderContext}. The logical bounds
* contains the origin, ascent, advance, and height, which includes
* the leading. The logical bounds does not always enclose all the
* text. For example, in some languages and in some fonts, accent
* marks can be positioned above the ascent or below the descent.
* To obtain a visual bounding box, which encloses all the text,
* use the {@link TextLayout#getBounds() getBounds} method of
- * TextLayout.
+ * {@code TextLayout}.
* String
- * @param frc the specified FontRenderContext
+ * @param str the specified {@code String}
+ * @param frc the specified {@code FontRenderContext}
* @return a {@link Rectangle2D} that is the bounding box of the
- * specified String in the specified
- * FontRenderContext.
+ * specified {@code String} in the specified
+ * {@code FontRenderContext}.
* @see FontRenderContext
* @see Font#createGlyphVector
* @since 1.2
@@ -2331,28 +2331,28 @@
}
/**
- * Returns the logical bounds of the specified String in
- * the specified FontRenderContext. The logical bounds
+ * Returns the logical bounds of the specified {@code String} in
+ * the specified {@code FontRenderContext}. The logical bounds
* contains the origin, ascent, advance, and height, which includes
* the leading. The logical bounds does not always enclose all the
* text. For example, in some languages and in some fonts, accent
* marks can be positioned above the ascent or below the descent.
* To obtain a visual bounding box, which encloses all the text,
* use the {@link TextLayout#getBounds() getBounds} method of
- * TextLayout.
+ * {@code TextLayout}.
* String
- * @param beginIndex the initial offset of str
- * @param limit the end offset of str
- * @param frc the specified FontRenderContext
- * @return a Rectangle2D that is the bounding box of the
- * specified String in the specified
- * FontRenderContext.
- * @throws IndexOutOfBoundsException if beginIndex is
- * less than zero, or limit is greater than the
- * length of str, or beginIndex
- * is greater than limit.
+ * @param str the specified {@code String}
+ * @param beginIndex the initial offset of {@code str}
+ * @param limit the end offset of {@code str}
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code Rectangle2D} that is the bounding box of the
+ * specified {@code String} in the specified
+ * {@code FontRenderContext}.
+ * @throws IndexOutOfBoundsException if {@code beginIndex} is
+ * less than zero, or {@code limit} is greater than the
+ * length of {@code str}, or {@code beginIndex}
+ * is greater than {@code limit}.
* @see FontRenderContext
* @see Font#createGlyphVector
* @since 1.2
@@ -2366,28 +2366,28 @@
/**
* Returns the logical bounds of the specified array of characters
- * in the specified FontRenderContext. The logical
+ * in the specified {@code FontRenderContext}. The logical
* bounds contains the origin, ascent, advance, and height, which
* includes the leading. The logical bounds does not always enclose
* all the text. For example, in some languages and in some fonts,
* accent marks can be positioned above the ascent or below the
* descent. To obtain a visual bounding box, which encloses all the
* text, use the {@link TextLayout#getBounds() getBounds} method of
- * TextLayout.
+ * {@code TextLayout}.
* FontRenderContext
- * @return a Rectangle2D that is the bounding box of the
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code Rectangle2D} that is the bounding box of the
* specified array of characters in the specified
- * FontRenderContext.
- * @throws IndexOutOfBoundsException if beginIndex is
- * less than zero, or limit is greater than the
- * length of chars, or beginIndex
- * is greater than limit.
+ * {@code FontRenderContext}.
+ * @throws IndexOutOfBoundsException if {@code beginIndex} is
+ * less than zero, or {@code limit} is greater than the
+ * length of {@code chars}, or {@code beginIndex}
+ * is greater than {@code limit}.
* @see FontRenderContext
* @see Font#createGlyphVector
* @since 1.2
@@ -2433,31 +2433,31 @@
/**
* Returns the logical bounds of the characters indexed in the
* specified {@link CharacterIterator} in the
- * specified FontRenderContext. The logical bounds
+ * specified {@code FontRenderContext}. The logical bounds
* contains the origin, ascent, advance, and height, which includes
* the leading. The logical bounds does not always enclose all the
* text. For example, in some languages and in some fonts, accent
* marks can be positioned above the ascent or below the descent.
* To obtain a visual bounding box, which encloses all the text,
* use the {@link TextLayout#getBounds() getBounds} method of
- * TextLayout.
+ * {@code TextLayout}.
* CharacterIterator
- * @param beginIndex the initial offset in ci
- * @param limit the end offset in ci
- * @param frc the specified FontRenderContext
- * @return a Rectangle2D that is the bounding box of the
- * characters indexed in the specified CharacterIterator
- * in the specified FontRenderContext.
+ * @param ci the specified {@code CharacterIterator}
+ * @param beginIndex the initial offset in {@code ci}
+ * @param limit the end offset in {@code ci}
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code Rectangle2D} that is the bounding box of the
+ * characters indexed in the specified {@code CharacterIterator}
+ * in the specified {@code FontRenderContext}.
* @see FontRenderContext
* @see Font#createGlyphVector
* @since 1.2
- * @throws IndexOutOfBoundsException if beginIndex is
- * less than the start index of ci, or
- * limit is greater than the end index of
- * ci, or beginIndex is greater
- * than limit
+ * @throws IndexOutOfBoundsException if {@code beginIndex} is
+ * less than the start index of {@code ci}, or
+ * {@code limit} is greater than the end index of
+ * {@code ci}, or {@code beginIndex} is greater
+ * than {@code limit}
*/
public Rectangle2D getStringBounds(CharacterIterator ci,
int beginIndex, int limit,
@@ -2489,11 +2489,11 @@
/**
* Returns the bounds for the character with the maximum
- * bounds as defined in the specified FontRenderContext.
+ * bounds as defined in the specified {@code FontRenderContext}.
* FontRenderContext
- * @return a Rectangle2D that is the bounding box
+ * @param frc the specified {@code FontRenderContext}
+ * @return a {@code Rectangle2D} that is the bounding box
* for the character with the maximum bounds.
*/
public Rectangle2D getMaxCharBounds(FontRenderContext frc) {
@@ -2509,16 +2509,16 @@
/**
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by
* mapping characters to glyphs one-to-one based on the
- * Unicode cmap in this Font. This method does no other
+ * Unicode cmap in this {@code Font}. This method does no other
* processing besides the mapping of glyphs to characters. This
* means that this method is not useful for some scripts, such
* as Arabic, Hebrew, Thai, and Indic, that require reordering,
* shaping, or ligature substitution.
- * @param frc the specified FontRenderContext
- * @param str the specified String
- * @return a new GlyphVector created with the
- * specified String and the specified
- * FontRenderContext.
+ * @param frc the specified {@code FontRenderContext}
+ * @param str the specified {@code String}
+ * @return a new {@code GlyphVector} created with the
+ * specified {@code String} and the specified
+ * {@code FontRenderContext}.
*/
public GlyphVector createGlyphVector(FontRenderContext frc, String str)
{
@@ -2528,16 +2528,16 @@
/**
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by
* mapping characters to glyphs one-to-one based on the
- * Unicode cmap in this Font. This method does no other
+ * Unicode cmap in this {@code Font}. This method does no other
* processing besides the mapping of glyphs to characters. This
* means that this method is not useful for some scripts, such
* as Arabic, Hebrew, Thai, and Indic, that require reordering,
* shaping, or ligature substitution.
- * @param frc the specified FontRenderContext
+ * @param frc the specified {@code FontRenderContext}
* @param chars the specified array of characters
- * @return a new GlyphVector created with the
+ * @return a new {@code GlyphVector} created with the
* specified array of characters and the specified
- * FontRenderContext.
+ * {@code FontRenderContext}.
*/
public GlyphVector createGlyphVector(FontRenderContext frc, char[] chars)
{
@@ -2547,16 +2547,16 @@
/**
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by
* mapping the specified characters to glyphs one-to-one based on the
- * Unicode cmap in this Font. This method does no other
+ * Unicode cmap in this {@code Font}. This method does no other
* processing besides the mapping of glyphs to characters. This
* means that this method is not useful for some scripts, such
* as Arabic, Hebrew, Thai, and Indic, that require reordering,
* shaping, or ligature substitution.
- * @param frc the specified FontRenderContext
- * @param ci the specified CharacterIterator
- * @return a new GlyphVector created with the
- * specified CharacterIterator and the specified
- * FontRenderContext.
+ * @param frc the specified {@code FontRenderContext}
+ * @param ci the specified {@code CharacterIterator}
+ * @return a new {@code GlyphVector} created with the
+ * specified {@code CharacterIterator} and the specified
+ * {@code FontRenderContext}.
*/
public GlyphVector createGlyphVector( FontRenderContext frc,
CharacterIterator ci)
@@ -2567,16 +2567,16 @@
/**
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by
* mapping characters to glyphs one-to-one based on the
- * Unicode cmap in this Font. This method does no other
+ * Unicode cmap in this {@code Font}. This method does no other
* processing besides the mapping of glyphs to characters. This
* means that this method is not useful for some scripts, such
* as Arabic, Hebrew, Thai, and Indic, that require reordering,
* shaping, or ligature substitution.
- * @param frc the specified FontRenderContext
+ * @param frc the specified {@code FontRenderContext}
* @param glyphCodes the specified integer array
- * @return a new GlyphVector created with the
+ * @return a new {@code GlyphVector} created with the
* specified integer array and the specified
- * FontRenderContext.
+ * {@code FontRenderContext}.
*/
public GlyphVector createGlyphVector( FontRenderContext frc,
int [] glyphCodes)
@@ -2585,13 +2585,13 @@
}
/**
- * Returns a new GlyphVector object, performing full
+ * Returns a new {@code GlyphVector} object, performing full
* layout of the text if possible. Full layout is required for
* complex text, such as Arabic or Hindi. Support for different
* scripts depends on the font and implementation.
* Bidi, and should only be performed on text that
+ * {@code Bidi}, and should only be performed on text that
* has a uniform direction. The direction is indicated in the
* flags parameter,by using LAYOUT_RIGHT_TO_LEFT to indicate a
* right-to-left (Arabic and Hebrew) run direction, or
@@ -2609,12 +2609,12 @@
* FontRenderContext
+ * @param frc the specified {@code FontRenderContext}
* @param text the text to layout
- * @param start the start of the text to use for the GlyphVector
- * @param limit the limit of the text to use for the GlyphVector
+ * @param start the start of the text to use for the {@code GlyphVector}
+ * @param limit the limit of the text to use for the {@code GlyphVector}
* @param flags control flags as described above
- * @return a new GlyphVector representing the text between
+ * @return a new {@code GlyphVector} representing the text between
* start and limit, with glyphs chosen and positioned so as to best represent
* the text
* @throws ArrayIndexOutOfBoundsException if start or limit is
--- old/src/java.desktop/share/classes/java/awt/FontFormatException.java 2015-10-04 22:52:38.341274389 +0400
+++ new/src/java.desktop/share/classes/java/awt/FontFormatException.java 2015-10-04 22:52:38.129274399 +0400
@@ -26,7 +26,7 @@
package java.awt;
/**
- * Thrown by method createFont in the Font class to indicate
+ * Thrown by method createFont in the {@code Font} class to indicate
* that the specified font is bad.
*
* @author Parry Kejriwal
@@ -42,7 +42,7 @@
/**
* Report a FontFormatException for the reason specified.
- * @param reason a String message indicating why
+ * @param reason a {@code String} message indicating why
* the font is not accepted.
*/
public FontFormatException(String reason) {
--- old/src/java.desktop/share/classes/java/awt/FontMetrics.java 2015-10-04 22:52:38.861274366 +0400
+++ new/src/java.desktop/share/classes/java/awt/FontMetrics.java 2015-10-04 22:52:38.673274374 +0400
@@ -32,7 +32,7 @@
import java.text.CharacterIterator;
/**
- * The FontMetrics class defines a font metrics object, which
+ * The {@code FontMetrics} class defines a font metrics object, which
* encapsulates information about the rendering of a particular font on a
* particular screen.
* String is the
- * distance along the baseline of the String. This
+ * character array. The advance of a {@code String} is the
+ * distance along the baseline of the {@code String}. This
* distance is the width that should be used for centering or
- * right-aligning the String.
- * String is not necessarily
+ * right-aligning the {@code String}.
+ * FontMetrics object for finding out
- * height and width information about the specified Font
- * and specific character glyphs in that Font.
- * @param font the Font
+ * Creates a new {@code FontMetrics} object for finding out
+ * height and width information about the specified {@code Font}
+ * and specific character glyphs in that {@code Font}.
+ * @param font the {@code Font}
* @see java.awt.Font
*/
protected FontMetrics(Font font) {
@@ -136,25 +136,25 @@
}
/**
- * Gets the Font described by this
- * FontMetrics object.
- * @return the Font described by this
- * FontMetrics object.
+ * Gets the {@code Font} described by this
+ * {@code FontMetrics} object.
+ * @return the {@code Font} described by this
+ * {@code FontMetrics} object.
*/
public Font getFont() {
return font;
}
/**
- * Gets the FontRenderContext used by this
- * FontMetrics object to measure text.
+ * Gets the {@code FontRenderContext} used by this
+ * {@code FontMetrics} object to measure text.
* Graphics
- * parameter measure text using the FontRenderContext
- * of that Graphics object, and not this
- * FontRenderContext
- * @return the FontRenderContext used by this
- * FontMetrics object.
+ * Note that methods in this class which take a {@code Graphics}
+ * parameter measure text using the {@code FontRenderContext}
+ * of that {@code Graphics} object, and not this
+ * {@code FontRenderContext}
+ * @return the {@code FontRenderContext} used by this
+ * {@code FontMetrics} object.
* @since 1.6
*/
public FontRenderContext getFontRenderContext() {
@@ -163,12 +163,12 @@
/**
* Determines the standard leading of the
- * Font described by this FontMetrics
+ * {@code Font} described by this {@code FontMetrics}
* object. The standard leading, or
* interline spacing, is the logical amount of space to be reserved
* between the descent of one line of text and the ascent of the next
* line. The height metric is calculated to include this extra space.
- * @return the standard leading of the Font.
+ * @return the standard leading of the {@code Font}.
* @see #getHeight()
* @see #getAscent()
* @see #getDescent()
@@ -178,12 +178,12 @@
}
/**
- * Determines the font ascent of the Font
- * described by this FontMetrics object. The font ascent
+ * Determines the font ascent of the {@code Font}
+ * described by this {@code FontMetrics} object. The font ascent
* is the distance from the font's baseline to the top of most
- * alphanumeric characters. Some characters in the Font
+ * alphanumeric characters. Some characters in the {@code Font}
* might extend above the font ascent line.
- * @return the font ascent of the Font.
+ * @return the font ascent of the {@code Font}.
* @see #getMaxAscent()
*/
public int getAscent() {
@@ -191,14 +191,14 @@
}
/**
- * Determines the font descent of the Font
+ * Determines the font descent of the {@code Font}
* described by this
- * FontMetrics object. The font descent is the distance
+ * {@code FontMetrics} object. The font descent is the distance
* from the font's baseline to the bottom of most alphanumeric
* characters with descenders. Some characters in the
- * Font might extend
+ * {@code Font} might extend
* below the font descent line.
- * @return the font descent of the Font.
+ * @return the font descent of the {@code Font}.
* @see #getMaxDescent()
*/
public int getDescent() {
@@ -223,11 +223,11 @@
}
/**
- * Determines the maximum ascent of the Font
- * described by this FontMetrics object. No character
+ * Determines the maximum ascent of the {@code Font}
+ * described by this {@code FontMetrics} object. No character
* extends further above the font's baseline than this height.
* @return the maximum ascent of any character in the
- * Font.
+ * {@code Font}.
* @see #getAscent()
*/
public int getMaxAscent() {
@@ -235,11 +235,11 @@
}
/**
- * Determines the maximum descent of the Font
- * described by this FontMetrics object. No character
+ * Determines the maximum descent of the {@code Font}
+ * described by this {@code FontMetrics} object. No character
* extends further below the font's baseline than this height.
* @return the maximum descent of any character in the
- * Font.
+ * {@code Font}.
* @see #getDescent()
*/
public int getMaxDescent() {
@@ -249,10 +249,10 @@
/**
* For backward compatibility only.
* @return the maximum descent of any character in the
- * Font.
+ * {@code Font}.
* @see #getMaxDescent()
* @deprecated As of JDK version 1.1.1,
- * replaced by getMaxDescent().
+ * replaced by {@code getMaxDescent()}.
*/
@Deprecated
public int getMaxDecent() {
@@ -261,12 +261,12 @@
/**
* Gets the maximum advance width of any character in this
- * Font. The advance is the
+ * {@code Font}. The advance is the
* distance from the leftmost point to the rightmost point on the
- * string's baseline. The advance of a String is
+ * string's baseline. The advance of a {@code String} is
* not necessarily the sum of the advances of its characters.
* @return the maximum advance width of any character
- * in the Font, or -1 if the
+ * in the {@code Font}, or {@code -1} if the
* maximum advance width is not known.
*/
public int getMaxAdvance() {
@@ -275,10 +275,10 @@
/**
* Returns the advance width of the specified character in this
- * Font. The advance is the
+ * {@code Font}. The advance is the
* distance from the leftmost point to the rightmost point on the
* character's baseline. Note that the advance of a
- * String is not necessarily the sum of the advances
+ * {@code String} is not necessarily the sum of the advances
* of its characters.
*
* Font described by this
- * FontMetrics object.
+ * in the {@code Font} described by this
+ * {@code FontMetrics} object.
* @see #charsWidth(char[], int, int)
* @see #stringWidth(String)
*/
@@ -310,10 +310,10 @@
/**
* Returns the advance width of the specified character in this
- * Font. The advance is the
+ * {@code Font}. The advance is the
* distance from the leftmost point to the rightmost point on the
* character's baseline. Note that the advance of a
- * String is not necessarily the sum of the advances
+ * {@code String} is not necessarily the sum of the advances
* of its characters.
*
* FontMetrics object.
+ * in the {@code Font} described by this
+ * {@code FontMetrics} object.
* @see #charsWidth(char[], int, int)
* @see #stringWidth(String)
*/
@@ -338,16 +338,16 @@
/**
* Returns the total advance width for showing the specified
- * String in this Font. The advance
+ * {@code String} in this {@code Font}. The advance
* is the distance from the leftmost point to the rightmost point
* on the string's baseline.
* String is
+ * Note that the advance of a {@code String} is
* not necessarily the sum of the advances of its characters.
- * @param str the String to be measured
- * @return the advance width of the specified String
- * in the Font described by this
- * FontMetrics.
+ * @param str the {@code String} to be measured
+ * @return the advance width of the specified {@code String}
+ * in the {@code Font} described by this
+ * {@code FontMetrics}.
* @throws NullPointerException if str is null.
* @see #bytesWidth(byte[], int, int)
* @see #charsWidth(char[], int, int)
@@ -362,22 +362,22 @@
/**
* Returns the total advance width for showing the specified array
- * of characters in this Font. The advance is the
+ * of characters in this {@code Font}. The advance is the
* distance from the leftmost point to the rightmost point on the
- * string's baseline. The advance of a String
+ * string's baseline. The advance of a {@code String}
* is not necessarily the sum of the advances of its characters.
- * This is equivalent to measuring a String of the
+ * This is equivalent to measuring a {@code String} of the
* characters in the specified range.
* @param data the array of characters to be measured
* @param off the start offset of the characters in the array
* @param len the number of characters to be measured from the array
* @return the advance width of the subarray of the specified
- * char array in the font described by
- * this FontMetrics object.
- * @throws NullPointerException if data is null.
- * @throws IndexOutOfBoundsException if the off
- * and len arguments index characters outside
- * the bounds of the data array.
+ * {@code char} array in the font described by
+ * this {@code FontMetrics} object.
+ * @throws NullPointerException if {@code data} is null.
+ * @throws IndexOutOfBoundsException if the {@code off}
+ * and {@code len} arguments index characters outside
+ * the bounds of the {@code data} array.
* @see #charWidth(int)
* @see #charWidth(char)
* @see #bytesWidth(byte[], int, int)
@@ -389,23 +389,23 @@
/**
* Returns the total advance width for showing the specified array
- * of bytes in this Font. The advance is the
+ * of bytes in this {@code Font}. The advance is the
* distance from the leftmost point to the rightmost point on the
- * string's baseline. The advance of a String
+ * string's baseline. The advance of a {@code String}
* is not necessarily the sum of the advances of its characters.
- * This is equivalent to measuring a String of the
+ * This is equivalent to measuring a {@code String} of the
* characters in the specified range.
* @param data the array of bytes to be measured
* @param off the start offset of the bytes in the array
* @param len the number of bytes to be measured from the array
* @return the advance width of the subarray of the specified
- * byte array in the Font
+ * {@code byte} array in the {@code Font}
* described by
- * this FontMetrics object.
- * @throws NullPointerException if data is null.
- * @throws IndexOutOfBoundsException if the off
- * and len arguments index bytes outside
- * the bounds of the data array.
+ * this {@code FontMetrics} object.
+ * @throws NullPointerException if {@code data} is null.
+ * @throws IndexOutOfBoundsException if the {@code off}
+ * and {@code len} arguments index bytes outside
+ * the bounds of the {@code data} array.
* @see #charsWidth(char[], int, int)
* @see #stringWidth(String)
*/
@@ -416,14 +416,14 @@
/**
* Gets the advance widths of the first 256 characters in the
- * Font. The advance is the
+ * {@code Font}. The advance is the
* distance from the leftmost point to the rightmost point on the
* character's baseline. Note that the advance of a
- * String is not necessarily the sum of the advances
+ * {@code String} is not necessarily the sum of the advances
* of its characters.
* @return an array storing the advance widths of the
- * characters in the Font
- * described by this FontMetrics object.
+ * characters in the {@code Font}
+ * described by this {@code FontMetrics} object.
*/
public int[] getWidths() {
int widths[] = new int[256];
@@ -434,15 +434,15 @@
}
/**
- * Checks to see if the Font has uniform line metrics. A
+ * Checks to see if the {@code Font} has uniform line metrics. A
* composite font may consist of several different fonts to cover
* various character sets. In such cases, the
- * FontLineMetrics objects are not uniform.
+ * {@code FontLineMetrics} objects are not uniform.
* Different fonts may have a different ascent, descent, metrics and
* so on. This information is sometimes necessary for line
* measuring and line breaking.
- * @return true if the font has uniform line metrics;
- * false otherwise.
+ * @return {@code true} if the font has uniform line metrics;
+ * {@code false} otherwise.
* @see java.awt.Font#hasUniformLineMetrics()
*/
public boolean hasUniformLineMetrics() {
@@ -451,11 +451,11 @@
/**
* Returns the {@link LineMetrics} object for the specified
- * String in the specified {@link Graphics} context.
- * @param str the specified String
- * @param context the specified Graphics context
- * @return a LineMetrics object created with the
- * specified String and Graphics context.
+ * {@code String} in the specified {@link Graphics} context.
+ * @param str the specified {@code String}
+ * @param context the specified {@code Graphics} context
+ * @return a {@code LineMetrics} object created with the
+ * specified {@code String} and {@code Graphics} context.
* @see java.awt.Font#getLineMetrics(String, FontRenderContext)
*/
public LineMetrics getLineMetrics( String str, Graphics context) {
@@ -464,13 +464,13 @@
/**
* Returns the {@link LineMetrics} object for the specified
- * String in the specified {@link Graphics} context.
- * @param str the specified String
- * @param beginIndex the initial offset of str
- * @param limit the end offset of str
- * @param context the specified Graphics context
- * @return a LineMetrics object created with the
- * specified String and Graphics context.
+ * {@code String} in the specified {@link Graphics} context.
+ * @param str the specified {@code String}
+ * @param beginIndex the initial offset of {@code str}
+ * @param limit the end offset of {@code str}
+ * @param context the specified {@code Graphics} context
+ * @return a {@code LineMetrics} object created with the
+ * specified {@code String} and {@code Graphics} context.
* @see java.awt.Font#getLineMetrics(String, int, int, FontRenderContext)
*/
public LineMetrics getLineMetrics( String str,
@@ -483,11 +483,11 @@
* Returns the {@link LineMetrics} object for the specified
* character array in the specified {@link Graphics} context.
* @param chars the specified character array
- * @param beginIndex the initial offset of chars
- * @param limit the end offset of chars
- * @param context the specified Graphics context
- * @return a LineMetrics object created with the
- * specified character array and Graphics context.
+ * @param beginIndex the initial offset of {@code chars}
+ * @param limit the end offset of {@code chars}
+ * @param context the specified {@code Graphics} context
+ * @return a {@code LineMetrics} object created with the
+ * specified character array and {@code Graphics} context.
* @see java.awt.Font#getLineMetrics(char[], int, int, FontRenderContext)
*/
public LineMetrics getLineMetrics(char [] chars,
@@ -501,11 +501,11 @@
* Returns the {@link LineMetrics} object for the specified
* {@link CharacterIterator} in the specified {@link Graphics}
* context.
- * @param ci the specified CharacterIterator
- * @param beginIndex the initial offset in ci
- * @param limit the end index of ci
- * @param context the specified Graphics context
- * @return a LineMetrics object created with the
+ * @param ci the specified {@code CharacterIterator}
+ * @param beginIndex the initial offset in {@code ci}
+ * @param limit the end index of {@code ci}
+ * @param context the specified {@code Graphics} context
+ * @return a {@code LineMetrics} object created with the
* specified arguments.
* @see java.awt.Font#getLineMetrics(CharacterIterator, int, int, FontRenderContext)
*/
@@ -516,16 +516,16 @@
}
/**
- * Returns the bounds of the specified String in the
- * specified Graphics context. The bounds is used
- * to layout the String.
+ * Returns the bounds of the specified {@code String} in the
+ * specified {@code Graphics} context. The bounds is used
+ * to layout the {@code String}.
* String
- * @param context the specified Graphics context
+ * @param str the specified {@code String}
+ * @param context the specified {@code Graphics} context
* @return a {@link Rectangle2D} that is the bounding box of the
- * specified String in the specified
- * Graphics context.
+ * specified {@code String} in the specified
+ * {@code Graphics} context.
* @see java.awt.Font#getStringBounds(String, FontRenderContext)
*/
public Rectangle2D getStringBounds( String str, Graphics context) {
@@ -533,18 +533,18 @@
}
/**
- * Returns the bounds of the specified String in the
- * specified Graphics context. The bounds is used
- * to layout the String.
+ * Returns the bounds of the specified {@code String} in the
+ * specified {@code Graphics} context. The bounds is used
+ * to layout the {@code String}.
* String
- * @param beginIndex the offset of the beginning of str
- * @param limit the end offset of str
- * @param context the specified Graphics context
- * @return a Rectangle2D that is the bounding box of the
- * specified String in the specified
- * Graphics context.
+ * @param str the specified {@code String}
+ * @param beginIndex the offset of the beginning of {@code str}
+ * @param limit the end offset of {@code str}
+ * @param context the specified {@code Graphics} context
+ * @return a {@code Rectangle2D} that is the bounding box of the
+ * specified {@code String} in the specified
+ * {@code Graphics} context.
* @see java.awt.Font#getStringBounds(String, int, int, FontRenderContext)
*/
public Rectangle2D getStringBounds( String str,
@@ -556,20 +556,20 @@
/**
* Returns the bounds of the specified array of characters
- * in the specified Graphics context.
- * The bounds is used to layout the String
+ * in the specified {@code Graphics} context.
+ * The bounds is used to layout the {@code String}
* created with the specified array of characters,
- * beginIndex and limit.
+ * {@code beginIndex} and {@code limit}.
* Graphics context
- * @return a Rectangle2D that is the bounding box of the
+ * @param context the specified {@code Graphics} context
+ * @return a {@code Rectangle2D} that is the bounding box of the
* specified character array in the specified
- * Graphics context.
+ * {@code Graphics} context.
* @see java.awt.Font#getStringBounds(char[], int, int, FontRenderContext)
*/
public Rectangle2D getStringBounds( char [] chars,
@@ -581,17 +581,17 @@
/**
* Returns the bounds of the characters indexed in the specified
- * CharacterIterator in the
- * specified Graphics context.
+ * {@code CharacterIterator} in the
+ * specified {@code Graphics} context.
* CharacterIterator
- * @param beginIndex the initial offset in ci
- * @param limit the end index of ci
- * @param context the specified Graphics context
- * @return a Rectangle2D that is the bounding box of the
- * characters indexed in the specified CharacterIterator
- * in the specified Graphics context.
+ * @param ci the specified {@code CharacterIterator}
+ * @param beginIndex the initial offset in {@code ci}
+ * @param limit the end index of {@code ci}
+ * @param context the specified {@code Graphics} context
+ * @return a {@code Rectangle2D} that is the bounding box of the
+ * characters indexed in the specified {@code CharacterIterator}
+ * in the specified {@code Graphics} context.
* @see java.awt.Font#getStringBounds(CharacterIterator, int, int, FontRenderContext)
*/
public Rectangle2D getStringBounds(CharacterIterator ci,
@@ -603,9 +603,9 @@
/**
* Returns the bounds for the character with the maximum bounds
- * in the specified Graphics context.
- * @param context the specified Graphics context
- * @return a Rectangle2D that is the
+ * in the specified {@code Graphics} context.
+ * @param context the specified {@code Graphics} context
+ * @return a {@code Rectangle2D} that is the
* bounding box for the character with the maximum bounds.
* @see java.awt.Font#getMaxCharBounds(FontRenderContext)
*/
@@ -622,10 +622,10 @@
/**
- * Returns a representation of this FontMetrics
- * object's values as a String.
- * @return a String representation of this
- * FontMetrics object.
+ * Returns a representation of this {@code FontMetrics}
+ * object's values as a {@code String}.
+ * @return a {@code String} representation of this
+ * {@code FontMetrics} object.
*/
public String toString() {
return getClass().getName() +
--- old/src/java.desktop/share/classes/java/awt/Frame.java 2015-10-04 22:52:39.397274342 +0400
+++ new/src/java.desktop/share/classes/java/awt/Frame.java 2015-10-04 22:52:39.209274350 +0400
@@ -43,35 +43,35 @@
import sun.awt.SunToolkit;
/**
- * A Frame is a top-level window with a title and a border.
+ * A {@code Frame} is a top-level window with a title and a border.
* getInsets method, however, since
+ * using the {@code getInsets} method, however, since
* these dimensions are platform-dependent, a valid insets
* value cannot be obtained until the frame is made displayable
- * by either calling pack or show.
+ * by either calling {@code pack} or {@code show}.
* Since the border area is included in the overall size of the
* frame, the border effectively obscures a portion of the frame,
* constraining the area available for rendering and/or displaying
* subcomponents to the rectangle which has an upper-left corner
- * location of (insets.left, insets.top), and has a size of
- * width - (insets.left + insets.right) by
- * height - (insets.top + insets.bottom).
+ * location of {@code (insets.left, insets.top)}, and has a size of
+ * {@code width - (insets.left + insets.right)} by
+ * {@code height - (insets.top + insets.bottom)}.
* BorderLayout.
+ * The default layout for a frame is {@code BorderLayout}.
* Frame
- * and Titlebar) turned off
- * with setUndecorated. This can only be done while the frame
+ * A frame may have its native decorations (i.e. {@code Frame}
+ * and {@code Titlebar}) turned off
+ * with {@code setUndecorated}. This can only be done while the frame
* is not {@link Component#isDisplayable() displayable}.
* Frame
- * on a different screen device by constructing the Frame
+ * In a multi-screen environment, you can create a {@code Frame}
+ * on a different screen device by constructing the {@code Frame}
* with {@link #Frame(GraphicsConfiguration)} or
* {@link #Frame(String title, GraphicsConfiguration)}. The
- * GraphicsConfiguration object is one of the
- * GraphicsConfiguration objects of the target screen
+ * {@code GraphicsConfiguration} object is one of the
+ * {@code GraphicsConfiguration} objects of the target screen
* device.
* setLocation,
+ * In such an environment, when calling {@code setLocation},
* you must pass a virtual coordinate to this method. Similarly,
- * calling getLocationOnScreen on a Frame
- * returns virtual device coordinates. Call the getBounds
- * method of a GraphicsConfiguration to find its origin in
+ * calling {@code getLocationOnScreen} on a {@code Frame}
+ * returns virtual device coordinates. Call the {@code getBounds}
+ * method of a {@code GraphicsConfiguration} to find its origin in
* the virtual coordinate system.
* Frame at (10, 10) relative
+ * location of the {@code Frame} at (10, 10) relative
* to the origin of the physical screen of the corresponding
- * GraphicsConfiguration. If the bounds of the
- * GraphicsConfiguration is not taken into account, the
- * Frame location would be set at (10, 10) relative to the
+ * {@code GraphicsConfiguration}. If the bounds of the
+ * {@code GraphicsConfiguration} is not taken into account, the
+ * {@code Frame} location would be set at (10, 10) relative to the
* virtual-coordinate system and would appear on the primary physical
* screen, which might be different from the physical screen of the
- * specified GraphicsConfiguration.
+ * specified {@code GraphicsConfiguration}.
*
*
* Frame f = new Frame(GraphicsConfiguration gc);
@@ -112,21 +112,21 @@
*
*
WindowEvents:
+ * {@code WindowEvent}s:
*
- *
*
* @author Sami Shaio
@@ -141,86 +141,86 @@
*/
/**
- * @deprecated replaced by WINDOW_OPENED
- * WINDOW_CLOSING:
+ *
If the program doesn't
* explicitly hide or dispose the window while processing
* this event, the window close operation is canceled.
- * WINDOW_CLOSED
- * WINDOW_ICONIFIED
- * WINDOW_DEICONIFIED
- * WINDOW_ACTIVATED
- * WINDOW_DEACTIVATED
- * WINDOW_GAINED_FOCUS
- * WINDOW_LOST_FOCUS
- * WINDOW_STATE_CHANGED
+ * Cursor.DEFAULT_CURSOR.
+ * @deprecated replaced by {@code Cursor.DEFAULT_CURSOR}.
*/
@Deprecated
public static final int DEFAULT_CURSOR = Cursor.DEFAULT_CURSOR;
/**
- * @deprecated replaced by Cursor.CROSSHAIR_CURSOR.
+ * @deprecated replaced by {@code Cursor.CROSSHAIR_CURSOR}.
*/
@Deprecated
public static final int CROSSHAIR_CURSOR = Cursor.CROSSHAIR_CURSOR;
/**
- * @deprecated replaced by Cursor.TEXT_CURSOR.
+ * @deprecated replaced by {@code Cursor.TEXT_CURSOR}.
*/
@Deprecated
public static final int TEXT_CURSOR = Cursor.TEXT_CURSOR;
/**
- * @deprecated replaced by Cursor.WAIT_CURSOR.
+ * @deprecated replaced by {@code Cursor.WAIT_CURSOR}.
*/
@Deprecated
public static final int WAIT_CURSOR = Cursor.WAIT_CURSOR;
/**
- * @deprecated replaced by Cursor.SW_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.SW_RESIZE_CURSOR}.
*/
@Deprecated
public static final int SW_RESIZE_CURSOR = Cursor.SW_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.SE_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.SE_RESIZE_CURSOR}.
*/
@Deprecated
public static final int SE_RESIZE_CURSOR = Cursor.SE_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.NW_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.NW_RESIZE_CURSOR}.
*/
@Deprecated
public static final int NW_RESIZE_CURSOR = Cursor.NW_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.NE_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.NE_RESIZE_CURSOR}.
*/
@Deprecated
public static final int NE_RESIZE_CURSOR = Cursor.NE_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.N_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.N_RESIZE_CURSOR}.
*/
@Deprecated
public static final int N_RESIZE_CURSOR = Cursor.N_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.S_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.S_RESIZE_CURSOR}.
*/
@Deprecated
public static final int S_RESIZE_CURSOR = Cursor.S_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.W_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.W_RESIZE_CURSOR}.
*/
@Deprecated
public static final int W_RESIZE_CURSOR = Cursor.W_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.E_RESIZE_CURSOR.
+ * @deprecated replaced by {@code Cursor.E_RESIZE_CURSOR}.
*/
@Deprecated
public static final int E_RESIZE_CURSOR = Cursor.E_RESIZE_CURSOR;
/**
- * @deprecated replaced by Cursor.HAND_CURSOR.
+ * @deprecated replaced by {@code Cursor.HAND_CURSOR}.
*/
@Deprecated
public static final int HAND_CURSOR = Cursor.HAND_CURSOR;
/**
- * @deprecated replaced by Cursor.MOVE_CURSOR.
+ * @deprecated replaced by {@code Cursor.MOVE_CURSOR}.
*/
@Deprecated
public static final int MOVE_CURSOR = Cursor.MOVE_CURSOR;
@@ -293,8 +293,8 @@
/**
* This is the title of the frame. It can be changed
- * at any time. title can be null and if
- * this is the case the title = "".
+ * at any time. {@code title} can be null and if
+ * this is the case the {@code title} = "".
*
* @serial
* @see #getTitle
@@ -303,7 +303,7 @@
String title = "Untitled";
/**
- * The frames menubar. If menuBar = null
+ * The frames menubar. If {@code menuBar} = null
* the frame will not have a menubar.
*
* @serial
@@ -315,7 +315,7 @@
/**
* This field indicates whether the frame is resizable.
* This property can be changed at any time.
- * resizable will be true if the frame is
+ * {@code resizable} will be true if the frame is
* resizable, otherwise it will be false.
*
* @serial
@@ -326,7 +326,7 @@
/**
* This field indicates whether the frame is undecorated.
* This property can only be changed while the frame is not displayable.
- * undecorated will be true if the frame is
+ * {@code undecorated} will be true if the frame is
* undecorated, otherwise it will be false.
*
* @serial
@@ -338,7 +338,7 @@
boolean undecorated = false;
/**
- * mbManagement is only used by the Motif implementation.
+ * {@code mbManagement} is only used by the Motif implementation.
*
* @serial
*/
@@ -374,11 +374,11 @@
}
/**
- * Constructs a new instance of Frame that is
- * initially invisible. The title of the Frame
+ * Constructs a new instance of {@code Frame} that is
+ * initially invisible. The title of the {@code Frame}
* is empty.
* @exception HeadlessException when
- * GraphicsEnvironment.isHeadless() returns true
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless()
* @see Component#setSize
* @see Component#setVisible(boolean)
@@ -391,14 +391,14 @@
* Constructs a new, initially invisible {@code Frame} with the
* specified {@code GraphicsConfiguration}.
*
- * @param gc the GraphicsConfiguration
- * of the target screen device. If gc
- * is null, the system default
- * GraphicsConfiguration is assumed.
+ * @param gc the {@code GraphicsConfiguration}
+ * of the target screen device. If {@code gc}
+ * is {@code null}, the system default
+ * {@code GraphicsConfiguration} is assumed.
* @exception IllegalArgumentException if
- * gc is not from a screen device.
+ * {@code gc} is not from a screen device.
* @exception HeadlessException when
- * GraphicsEnvironment.isHeadless() returns true
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless()
* @since 1.3
*/
@@ -407,13 +407,13 @@
}
/**
- * Constructs a new, initially invisible Frame object
+ * Constructs a new, initially invisible {@code Frame} object
* with the specified title.
* @param title the title to be displayed in the frame's border.
- * A null value
+ * A {@code null} value
* is treated as an empty string, "".
* @exception HeadlessException when
- * GraphicsEnvironment.isHeadless() returns true
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless()
* @see java.awt.Component#setSize
* @see java.awt.Component#setVisible(boolean)
@@ -424,20 +424,20 @@
}
/**
- * Constructs a new, initially invisible Frame object
+ * Constructs a new, initially invisible {@code Frame} object
* with the specified title and a
- * GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
* @param title the title to be displayed in the frame's border.
- * A null value
+ * A {@code null} value
* is treated as an empty string, "".
- * @param gc the GraphicsConfiguration
- * of the target screen device. If gc is
- * null, the system default
- * GraphicsConfiguration is assumed.
- * @exception IllegalArgumentException if gc
+ * @param gc the {@code GraphicsConfiguration}
+ * of the target screen device. If {@code gc} is
+ * {@code null}, the system default
+ * {@code GraphicsConfiguration} is assumed.
+ * @exception IllegalArgumentException if {@code gc}
* is not from a screen device.
* @exception HeadlessException when
- * GraphicsEnvironment.isHeadless() returns true
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless()
* @see java.awt.Component#setSize
* @see java.awt.Component#setVisible(boolean)
@@ -504,7 +504,7 @@
/**
* Sets the title for this frame to the specified string.
* @param title the title to be displayed in the frame's border.
- * A null value
+ * A {@code null} value
* is treated as an empty string, "".
* @see #getTitle
*/
@@ -534,7 +534,7 @@
* If a list of several images was specified as a Window's icon,
* this method will return the first item of the list.
*
- * @return the icon image for this frame, or null
+ * @return the icon image for this frame, or {@code null}
* if this frame doesn't have an icon image.
* @see #setIconImage(Image)
* @see Window#getIconImages()
@@ -559,7 +559,7 @@
/**
* Gets the menu bar for this frame.
- * @return the menu bar for this frame, or null
+ * @return the menu bar for this frame, or {@code null}
* if this frame doesn't have a menu bar.
* @see #setMenuBar(MenuBar)
*/
@@ -570,7 +570,7 @@
/**
* Sets the menu bar for this frame to the specified menu bar.
* @param mb the menu bar being set.
- * If this parameter is null then any
+ * If this parameter is {@code null} then any
* existing menu bar on this frame is removed.
* @see #getMenuBar
*/
@@ -603,8 +603,8 @@
/**
* Indicates whether this frame is resizable by the user.
* By default, all frames are initially resizable.
- * @return true if the user can resize this frame;
- * false otherwise.
+ * @return {@code true} if the user can resize this frame;
+ * {@code false} otherwise.
* @see java.awt.Frame#setResizable(boolean)
*/
public boolean isResizable() {
@@ -613,8 +613,8 @@
/**
* Sets whether this frame is resizable by the user.
- * @param resizable true if this frame is resizable;
- * false otherwise.
+ * @param resizable {@code true} if this frame is resizable;
+ * {@code false} otherwise.
* @see java.awt.Frame#isResizable
*/
public void setResizable(boolean resizable) {
@@ -683,8 +683,8 @@
* java.awt.event.WindowEvent#WINDOW_STATE_CHANGED}
* events is not guaranteed in this case also.
*
- * @param state either Frame.NORMAL or
- * Frame.ICONIFIED.
+ * @param state either {@code Frame.NORMAL} or
+ * {@code Frame.ICONIFIED}.
* @see #setExtendedState(int)
* @see java.awt.Window#addWindowStateListener
*/
@@ -702,14 +702,14 @@
* Sets the state of this frame. The state is
* represented as a bitwise mask.
*
- *
* NORMAL
+ *
Indicates that no state bits are set.
- * ICONIFIED
- * MAXIMIZED_HORIZ
- * MAXIMIZED_VERT
- * MAXIMIZED_BOTH
- *
Concatenates MAXIMIZED_HORIZ
- * and MAXIMIZED_VERT.
+ *
Concatenates {@code MAXIMIZED_HORIZ}
+ * and {@code MAXIMIZED_VERT}.
* Frame.NORMAL and Frame.ICONIFIED but
+ * {@code Frame.NORMAL} and {@code Frame.ICONIFIED} but
* it only reports the iconic state of the frame, other aspects of
* frame state are not reported by this method.
*
- * @return Frame.NORMAL or Frame.ICONIFIED.
+ * @return {@code Frame.NORMAL} or {@code Frame.ICONIFIED}.
* @see #setState(int)
* @see #getExtendedState
*/
@@ -797,14 +797,14 @@
* Gets the state of this frame. The state is
* represented as a bitwise mask.
*
- *
*
* @return a bitwise mask of frame state constants
@@ -846,11 +846,11 @@
* defaults bounds. This method allows some or all of those
* system supplied values to be overridden.
* NORMAL
+ *
Indicates that no state bits are set.
- * ICONIFIED
- * MAXIMIZED_HORIZ
- * MAXIMIZED_VERT
- * MAXIMIZED_BOTH
- *
Concatenates MAXIMIZED_HORIZ
- * and MAXIMIZED_VERT.
+ *
Concatenates {@code MAXIMIZED_HORIZ}
+ * and {@code MAXIMIZED_VERT}.
* bounds is null, accept bounds
- * supplied by the system. If non-null you can
+ * If {@code bounds} is {@code null}, accept bounds
+ * supplied by the system. If non-{@code null} you can
* override some of the system supplied values while accepting
* others by setting those fields you want to accept from system
- * to Integer.MAX_VALUE.
+ * to {@code Integer.MAX_VALUE}.
* Integer.MAX_VALUE to indicate
+ * Some fields may contain {@code Integer.MAX_VALUE} to indicate
* that system supplied values for this field must be used.
*
- * @return maximized bounds for this frame; may be null
+ * @return maximized bounds for this frame; may be {@code null}
* @see #setMaximizedBounds(Rectangle)
* @since 1.4
*/
@@ -943,8 +943,8 @@
/**
* Indicates whether this frame is undecorated.
* By default, all frames are initially decorated.
- * @return true if frame is undecorated;
- * false otherwise.
+ * @return {@code true} if frame is undecorated;
+ * {@code false} otherwise.
* @see java.awt.Frame#setUndecorated(boolean)
* @since 1.4
*/
@@ -994,7 +994,7 @@
/**
* Removes the specified menu bar from this frame.
* @param m the menu component to remove.
- * If m is null, then
+ * If {@code m} is {@code null}, then
* no action is taken
*/
public void remove(MenuComponent m) {
@@ -1053,11 +1053,11 @@
}
/**
- * Returns a string representing the state of this Frame.
+ * Returns a string representing the state of this {@code Frame}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this frame
*/
@@ -1095,7 +1095,7 @@
*
* @param cursorType the cursor type
* @deprecated As of JDK version 1.1,
- * replaced by Component.setCursor(Cursor).
+ * replaced by {@code Component.setCursor(Cursor)}.
*/
@Deprecated
public void setCursor(int cursorType) {
@@ -1107,7 +1107,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by Component.getCursor().
+ * replaced by {@code Component.getCursor()}.
* @return the cursor type for this frame
*/
@Deprecated
@@ -1124,7 +1124,7 @@
* as a shared, hidden frame which is used by Swing. Applications
* should not assume the existence of these frames, nor should an
* application assume anything about these frames such as component
- * positions, LayoutManagers or serialization.
+ * positions, {@code LayoutManager}s or serialization.
* Frame's Serialized Data Version.
+ * {@code Frame}'s Serialized Data Version.
*
* @serial
*/
@@ -1172,11 +1172,11 @@
/**
* Writes default serializable fields to stream. Writes
- * an optional serializable icon Image, which is
+ * an optional serializable icon {@code Image}, which is
* available as of 1.4.
*
- * @param s the ObjectOutputStream to write
- * @serialData an optional icon Image
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData an optional icon {@code Image}
* @see java.awt.Image
* @see #getIconImage
* @see #setIconImage(Image)
@@ -1197,21 +1197,21 @@
}
/**
- * Reads the ObjectInputStream. Tries
- * to read an icon Image, which is optional
- * data available as of 1.4. If an icon Image
+ * Reads the {@code ObjectInputStream}. Tries
+ * to read an icon {@code Image}, which is optional
+ * data available as of 1.4. If an icon {@code Image}
* is not available, but anything other than an EOF
- * is detected, an OptionalDataException
+ * is detected, an {@code OptionalDataException}
* will be thrown.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
- * @exception java.io.OptionalDataException if an icon Image
+ * @param s the {@code ObjectInputStream} to read
+ * @exception java.io.OptionalDataException if an icon {@code Image}
* is not available, but anything other than an EOF
* is detected
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless()
* @see java.awt.Image
* @see #getIconImage
@@ -1285,7 +1285,7 @@
/**
* This class implements accessibility support for the
- * Frame class. It provides an implementation of the
+ * {@code Frame} class. It provides an implementation of the
* Java Accessibility API appropriate to frame user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/GradientPaint.java 2015-10-04 22:52:39.945274317 +0400
+++ new/src/java.desktop/share/classes/java/awt/GradientPaint.java 2015-10-04 22:52:39.757274326 +0400
@@ -32,11 +32,11 @@
import java.beans.ConstructorProperties;
/**
- * The GradientPaint class provides a way to fill
+ * The {@code GradientPaint} class provides a way to fill
* a {@link Shape} with a linear color gradient pattern.
- * If {@link Point} P1 with {@link Color} C1 and Point P2 with
- * Color C2 are specified in user space, the
- * Color on the P1, P2 connecting line is proportionally
+ * If {@link Point} P1 with {@link Color} C1 and {@code Point} P2 with
+ * {@code Color} C2 are specified in user space, the
+ * {@code Color} on the P1, P2 connecting line is proportionally
* changed from C1 to C2. Any point P not on the extended P1, P2
* connecting line has the color of the point P' that is the perpendicular
* projection of P on the extended P1, P2 connecting line.
@@ -48,8 +48,8 @@
* connecting line cycle back and forth between the colors C1 and C2.
* Color C1 while points on the P2 side
- * have the constant Color C2.
+ * have the constant {@code Color} C1 while points on the P2 side
+ * have the constant {@code Color} C2.
*
*
* @see Paint
@@ -65,19 +65,19 @@
boolean cyclic;
/**
- * Constructs a simple acyclic GradientPaint object.
+ * Constructs a simple acyclic {@code GradientPaint} object.
* @param x1 x coordinate of the first specified
- * Point in user space
+ * {@code Point} in user space
* @param y1 y coordinate of the first specified
- * Point in user space
- * @param color1 Color at the first specified
- * Point
+ * {@code Point} in user space
+ * @param color1 {@code Color} at the first specified
+ * {@code Point}
* @param x2 x coordinate of the second specified
- * Point in user space
+ * {@code Point} in user space
* @param y2 y coordinate of the second specified
- * Point in user space
- * @param color2 Color at the second specified
- * Point
+ * {@code Point} in user space
+ * @param color2 {@code Color} at the second specified
+ * {@code Point}
* @throws NullPointerException if either one of colors is null
*/
public GradientPaint(float x1,
@@ -97,13 +97,13 @@
}
/**
- * Constructs a simple acyclic GradientPaint object.
- * @param pt1 the first specified Point in user space
- * @param color1 Color at the first specified
- * Point
- * @param pt2 the second specified Point in user space
- * @param color2 Color at the second specified
- * Point
+ * Constructs a simple acyclic {@code GradientPaint} object.
+ * @param pt1 the first specified {@code Point} in user space
+ * @param color1 {@code Color} at the first specified
+ * {@code Point}
+ * @param pt2 the second specified {@code Point} in user space
+ * @param color2 {@code Color} at the second specified
+ * {@code Point}
* @throws NullPointerException if either one of colors or points
* is null
*/
@@ -123,22 +123,22 @@
}
/**
- * Constructs either a cyclic or acyclic GradientPaint
- * object depending on the boolean parameter.
+ * Constructs either a cyclic or acyclic {@code GradientPaint}
+ * object depending on the {@code boolean} parameter.
* @param x1 x coordinate of the first specified
- * Point in user space
+ * {@code Point} in user space
* @param y1 y coordinate of the first specified
- * Point in user space
- * @param color1 Color at the first specified
- * Point
+ * {@code Point} in user space
+ * @param color1 {@code Color} at the first specified
+ * {@code Point}
* @param x2 x coordinate of the second specified
- * Point in user space
+ * {@code Point} in user space
* @param y2 y coordinate of the second specified
- * Point in user space
- * @param color2 Color at the second specified
- * Point
- * @param cyclic true if the gradient pattern should cycle
- * repeatedly between the two colors; false otherwise
+ * {@code Point} in user space
+ * @param color2 {@code Color} at the second specified
+ * {@code Point}
+ * @param cyclic {@code true} if the gradient pattern should cycle
+ * repeatedly between the two colors; {@code false} otherwise
*/
public GradientPaint(float x1,
float y1,
@@ -152,18 +152,18 @@
}
/**
- * Constructs either a cyclic or acyclic GradientPaint
- * object depending on the boolean parameter.
- * @param pt1 the first specified Point
+ * Constructs either a cyclic or acyclic {@code GradientPaint}
+ * object depending on the {@code boolean} parameter.
+ * @param pt1 the first specified {@code Point}
* in user space
- * @param color1 Color at the first specified
- * Point
- * @param pt2 the second specified Point
+ * @param color1 {@code Color} at the first specified
+ * {@code Point}
+ * @param pt2 the second specified {@code Point}
* in user space
- * @param color2 Color at the second specified
- * Point
- * @param cyclic true if the gradient pattern should cycle
- * repeatedly between the two colors; false otherwise
+ * @param color2 {@code Color} at the second specified
+ * {@code Point}
+ * @param cyclic {@code true} if the gradient pattern should cycle
+ * repeatedly between the two colors; {@code false} otherwise
* @throws NullPointerException if either one of colors or points
* is null
*/
@@ -181,7 +181,7 @@
* Returns a copy of the point P1 that anchors the first color.
* @return a {@link Point2D} object that is a copy of the point
* that anchors the first color of this
- * GradientPaint.
+ * {@code GradientPaint}.
*/
public Point2D getPoint1() {
return new Point2D.Float(p1.x, p1.y);
@@ -189,7 +189,7 @@
/**
* Returns the color C1 anchored by the point P1.
- * @return a Color object that is the color
+ * @return a {@code Color} object that is the color
* anchored by P1.
*/
public Color getColor1() {
@@ -200,7 +200,7 @@
* Returns a copy of the point P2 which anchors the second color.
* @return a {@link Point2D} object that is a copy of the point
* that anchors the second color of this
- * GradientPaint.
+ * {@code GradientPaint}.
*/
public Point2D getPoint2() {
return new Point2D.Float(p2.x, p2.y);
@@ -208,7 +208,7 @@
/**
* Returns the color C2 anchored by the point P2.
- * @return a Color object that is the color
+ * @return a {@code Color} object that is the color
* anchored by P2.
*/
public Color getColor2() {
@@ -216,10 +216,10 @@
}
/**
- * Returns true if the gradient cycles repeatedly
+ * Returns {@code true} if the gradient cycles repeatedly
* between the two colors C1 and C2.
- * @return true if the gradient cycles repeatedly
- * between the two colors; false otherwise.
+ * @return {@code true} if the gradient cycles repeatedly
+ * between the two colors; {@code false} otherwise.
*/
public boolean isCyclic() {
return cyclic;
@@ -264,8 +264,8 @@
}
/**
- * Returns the transparency mode for this GradientPaint.
- * @return an integer value representing this GradientPaint
+ * Returns the transparency mode for this {@code GradientPaint}.
+ * @return an integer value representing this {@code GradientPaint}
* object's transparency mode.
* @see Transparency
*/
--- old/src/java.desktop/share/classes/java/awt/Graphics.java 2015-10-04 22:52:40.469274294 +0400
+++ new/src/java.desktop/share/classes/java/awt/Graphics.java 2015-10-04 22:52:40.277274302 +0400
@@ -31,17 +31,17 @@
import java.text.AttributedCharacterIterator;
/**
- * The Graphics class is the abstract base class for
+ * The {@code Graphics} class is the abstract base class for
* all graphics contexts that allow an application to draw onto
* components that are realized on various devices, as well as
* onto off-screen images.
* Graphics object encapsulates state information needed
+ * A {@code Graphics} object encapsulates state information needed
* for the basic rendering operations that Java supports. This
* state information includes the following properties:
*
*
- *
Component object on which to draw.
+ * Graphics object are considered relative to the
- * translation origin of this Graphics object prior to
+ * {@code Graphics} object are considered relative to the
+ * translation origin of this {@code Graphics} object prior to
* the invocation of the method.
* Graphics object. This user clip
+ * {@code Graphics} object. This user clip
* is transformed into device space and combined with the
* device clip, which is defined by the visibility of windows and
* device extents. The combination of the user clip and device clip
* defines the composite clip, which determines the final clipping
* region. The user clip cannot be modified by the rendering
* system to reflect the resulting composite clip. The user clip can only
- * be changed through the setClip or clipRect
+ * be changed through the {@code setClip} or {@code clipRect}
* methods.
* All drawing or writing is done in the current color,
* using the current paint mode, and in the current font.
@@ -104,14 +104,14 @@
public abstract class Graphics {
/**
- * Constructs a new Graphics object.
+ * Constructs a new {@code Graphics} object.
* This constructor is the default constructor for a graphics
* context.
* Graphics is an abstract class, applications
+ * Since {@code Graphics} is an abstract class, applications
* cannot call this constructor directly. Graphics contexts are
* obtained from other graphics contexts or are created by calling
- * getGraphics on a component.
+ * {@code getGraphics} on a component.
* @see java.awt.Graphics#create()
* @see java.awt.Component#getGraphics
*/
@@ -119,36 +119,36 @@
}
/**
- * Creates a new Graphics object that is
- * a copy of this Graphics object.
+ * Creates a new {@code Graphics} object that is
+ * a copy of this {@code Graphics} object.
* @return a new graphics context that is a copy of
* this graphics context.
*/
public abstract Graphics create();
/**
- * Creates a new Graphics object based on this
- * Graphics object, but with a new translation and clip area.
- * The new Graphics object has its origin
+ * Creates a new {@code Graphics} object based on this
+ * {@code Graphics} object, but with a new translation and clip area.
+ * The new {@code Graphics} object has its origin
* translated to the specified point (x, y).
* Its clip area is determined by the intersection of the original
* clip area with the specified rectangle. The arguments are all
* interpreted in the coordinate system of the original
- * Graphics object. The new graphics context is
+ * {@code Graphics} object. The new graphics context is
* identical to the original, except in two respects:
*
*
*
*
@@ -273,12 +273,12 @@
* This method refers to the user clip, which is independent of the
* clipping associated with device bounds and window visibility.
* If no clip has previously been set, or if the clip has been
- * cleared using 0, 0) in the
+ * That is to say, the point ({@code 0}, {@code 0}) in the
* new graphics context is the same as (x, y) in
* the original graphics context.
* 0, 0), and its size
- * is specified by the width and height
+ * rectangle is at ({@code 0}, {@code 0}), and its size
+ * is specified by the {@code width} and {@code height}
* arguments.
* setClip(null), this method returns
- * null.
+ * cleared using {@code setClip(null)}, this method returns
+ * {@code null}.
* The coordinates in the rectangle are relative to the coordinate
* system origin of this graphics context.
* @return the bounding rectangle of the current clipping area,
- * or null if no clip is set.
+ * or {@code null} if no clip is set.
* @see java.awt.Graphics#getClip
* @see java.awt.Graphics#clipRect
* @see java.awt.Graphics#setClip(int, int, int, int)
@@ -292,7 +292,7 @@
* The resulting clipping area is the intersection of the current
* clipping area and the specified rectangle. If there is no
* current clipping area, either because the clip has never been
- * set, or the clip has been cleared using setClip(null),
+ * set, or the clip has been cleared using {@code setClip(null)},
* the specified rectangle becomes the new clip.
* This method sets the user clip, which is independent of the
* clipping associated with device bounds and window visibility.
@@ -330,10 +330,10 @@
* This method returns the user clip, which is independent of the
* clipping associated with device bounds and window visibility.
* If no clip has previously been set, or if the clip has been
- * cleared using setClip(null), this method returns
- * null.
- * @return a Shape object representing the
- * current clipping area, or null if
+ * cleared using {@code setClip(null)}, this method returns
+ * {@code null}.
+ * @return a {@code Shape} object representing the
+ * current clipping area, or {@code null} if
* no clip is set.
* @see java.awt.Graphics#getClipBounds
* @see java.awt.Graphics#clipRect
@@ -345,15 +345,15 @@
/**
* Sets the current clipping area to an arbitrary clip shape.
- * Not all objects that implement the Shape
+ * Not all objects that implement the {@code Shape}
* interface can be used to set the clip. The only
- * Shape objects that are guaranteed to be
- * supported are Shape objects that are
- * obtained via the getClip method and via
- * Rectangle objects. This method sets the
+ * {@code Shape} objects that are guaranteed to be
+ * supported are {@code Shape} objects that are
+ * obtained via the {@code getClip} method and via
+ * {@code Rectangle} objects. This method sets the
* user clip, which is independent of the clipping associated
* with device bounds and window visibility.
- * @param clip the Shape to use to set the clip
+ * @param clip the {@code Shape} to use to set the clip
* @see java.awt.Graphics#getClip()
* @see java.awt.Graphics#clipRect
* @see java.awt.Graphics#setClip(int, int, int, int)
@@ -363,16 +363,16 @@
/**
* Copies an area of the component by a distance specified by
- * dx and dy. From the point specified
- * by x and y, this method
+ * {@code dx} and {@code dy}. From the point specified
+ * by {@code x} and {@code y}, this method
* copies downwards and to the right. To copy an area of the
* component to the left or upwards, specify a negative value for
- * dx or dy.
+ * {@code dx} or {@code dy}.
* If a portion of the source rectangle lies outside the bounds
* of the component, or is obscured by another window or component,
- * copyArea will be unable to copy the associated
+ * {@code copyArea} will be unable to copy the associated
* pixels. The area that is omitted can be refreshed by calling
- * the component's paint method.
+ * the component's {@code paint} method.
* @param x the x coordinate of the source rectangle.
* @param y the y coordinate of the source rectangle.
* @param width the width of the source rectangle.
@@ -397,12 +397,12 @@
/**
* Fills the specified rectangle.
* The left and right edges of the rectangle are at
- * x and x + width - 1.
+ * {@code x} and x + width - 1.
* The top and bottom edges are at
- * y and y + height - 1.
+ * {@code y} and y + height - 1.
* The resulting rectangle covers an area
- * width pixels wide by
- * height pixels tall.
+ * {@code width} pixels wide by
+ * {@code height} pixels tall.
* The rectangle is filled using the graphics context's current color.
* @param x the x coordinate
* of the rectangle to be filled.
@@ -418,9 +418,9 @@
/**
* Draws the outline of the specified rectangle.
* The left and right edges of the rectangle are at
- * x and x + width.
+ * {@code x} and x + width.
* The top and bottom edges are at
- * y and y + height.
+ * {@code y} and y + height.
* The rectangle is drawn using the graphics context's current color.
* @param x the x coordinate
* of the rectangle to be drawn.
@@ -453,7 +453,7 @@
* setColor followed by fillRect to
+ * use {@code setColor} followed by {@code fillRect} to
* ensure that an offscreen image is cleared to a specific color.
* @param x the x coordinate of the rectangle to clear.
* @param y the y coordinate of the rectangle to clear.
@@ -470,9 +470,9 @@
/**
* Draws an outlined round-cornered rectangle using this graphics
* context's current color. The left and right edges of the rectangle
- * are at x and x + width,
+ * are at {@code x} and x + width,
* respectively. The top and bottom edges of the rectangle are at
- * y and y + height.
+ * {@code y} and y + height.
* @param x the x coordinate of the rectangle to be drawn.
* @param y the y coordinate of the rectangle to be drawn.
* @param width the width of the rectangle to be drawn.
@@ -489,9 +489,9 @@
/**
* Fills the specified rounded corner rectangle with the current color.
* The left and right edges of the rectangle
- * are at x and x + width - 1,
+ * are at {@code x} and x + width - 1,
* respectively. The top and bottom edges of the rectangle are at
- * y and y + height - 1.
+ * {@code y} and y + height - 1.
* @param x the x coordinate of the rectangle to be filled.
* @param y the y coordinate of the rectangle to be filled.
* @param width the width of the rectangle to be filled.
@@ -576,8 +576,8 @@
/**
* Draws the outline of an oval.
* The result is a circle or ellipse that fits within the
- * rectangle specified by the x, y,
- * width, and height arguments.
+ * rectangle specified by the {@code x}, {@code y},
+ * {@code width}, and {@code height} arguments.
* width + 1 pixels wide
@@ -609,8 +609,8 @@
* Draws the outline of a circular or elliptical arc
* covering the specified rectangle.
* startAngle and extends
- * for arcAngle degrees, using the current color.
+ * The resulting arc begins at {@code startAngle} and extends
+ * for {@code arcAngle} degrees, using the current color.
* Angles are interpreted such that 0 degrees
* is at the 3 o'clock position.
* A positive value indicates a counter-clockwise rotation
@@ -618,7 +618,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -648,8 +648,8 @@
/**
* Fills a circular or elliptical arc covering the specified rectangle.
* startAngle and extends
- * for arcAngle degrees.
+ * The resulting arc begins at {@code startAngle} and extends
+ * for {@code arcAngle} degrees.
* Angles are interpreted such that 0 degrees
* is at the 3 o'clock position.
* A positive value indicates a counter-clockwise rotation
@@ -657,7 +657,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -704,16 +704,16 @@
* arrays of x and y coordinates.
* Each pair of (x, y) coordinates defines a point.
* nPoint line
+ * This method draws the polygon defined by {@code nPoint} line
* segments, where the first nPoint - 1
* line segments are line segments from
* (xPoints[i - 1], yPoints[i - 1])
* to (xPoints[i], yPoints[i]), for
- * 1 ≤ i ≤ nPoints.
+ * 1 ≤ i ≤ {@code nPoints}.
* The figure is automatically closed by drawing a line connecting
* the final point to the first point, if those points are different.
- * @param xPoints a an array of x coordinates.
- * @param yPoints a an array of y coordinates.
+ * @param xPoints a an array of {@code x} coordinates.
+ * @param yPoints a an array of {@code y} coordinates.
* @param nPoints a the total number of points.
* @see java.awt.Graphics#fillPolygon
* @see java.awt.Graphics#drawPolyline
@@ -723,7 +723,7 @@
/**
* Draws the outline of a polygon defined by the specified
- * Polygon object.
+ * {@code Polygon} object.
* @param p the polygon to draw.
* @see java.awt.Graphics#fillPolygon
* @see java.awt.Graphics#drawPolyline
@@ -736,19 +736,19 @@
* Fills a closed polygon defined by
* arrays of x and y coordinates.
* nPoint line
+ * This method draws the polygon defined by {@code nPoint} line
* segments, where the first nPoint - 1
* line segments are line segments from
* (xPoints[i - 1], yPoints[i - 1])
* to (xPoints[i], yPoints[i]), for
- * 1 ≤ i ≤ nPoints.
+ * 1 ≤ i ≤ {@code nPoints}.
* The figure is automatically closed by drawing a line connecting
* the final point to the first point, if those points are different.
* x coordinates.
- * @param yPoints a an array of y coordinates.
+ * @param xPoints a an array of {@code x} coordinates.
+ * @param yPoints a an array of {@code y} coordinates.
* @param nPoints a the total number of points.
* @see java.awt.Graphics#drawPolygon(int[], int[], int)
*/
@@ -776,7 +776,7 @@
* @param str the string to be drawn.
* @param x the x coordinate.
* @param y the y coordinate.
- * @throws NullPointerException if str is null.
+ * @throws NullPointerException if {@code str} is {@code null}.
* @see java.awt.Graphics#drawBytes
* @see java.awt.Graphics#drawChars
*/
@@ -792,8 +792,8 @@
* @param iterator the iterator whose text is to be drawn
* @param x the x coordinate.
* @param y the y coordinate.
- * @throws NullPointerException if iterator is
- * null.
+ * @throws NullPointerException if {@code iterator} is
+ * {@code null}.
* @see java.awt.Graphics#drawBytes
* @see java.awt.Graphics#drawChars
*/
@@ -810,11 +810,11 @@
* @param length the number of characters to be drawn
* @param x the x coordinate of the baseline of the text
* @param y the y coordinate of the baseline of the text
- * @throws NullPointerException if data is null.
- * @throws IndexOutOfBoundsException if offset or
- * lengthis less than zero, or
- * offset+length is greater than the length of the
- * data array.
+ * @throws NullPointerException if {@code data} is {@code null}.
+ * @throws IndexOutOfBoundsException if {@code offset} or
+ * {@code length} is less than zero, or
+ * {@code offset+length} is greater than the length of the
+ * {@code data} array.
* @see java.awt.Graphics#drawBytes
* @see java.awt.Graphics#drawString
*/
@@ -836,10 +836,10 @@
* @param length the number of bytes that are drawn
* @param x the x coordinate of the baseline of the text
* @param y the y coordinate of the baseline of the text
- * @throws NullPointerException if data is null.
- * @throws IndexOutOfBoundsException if offset or
- * lengthis less than zero, or offset+length
- * is greater than the length of the data array.
+ * @throws NullPointerException if {@code data} is {@code null}.
+ * @throws IndexOutOfBoundsException if {@code offset} or
+ * {@code length} is less than zero, or {@code offset+length}
+ * is greater than the length of the {@code data} array.
* @see java.awt.Graphics#drawChars
* @see java.awt.Graphics#drawString
*/
@@ -861,21 +861,21 @@
* drawImage returns true.
- * Otherwise, drawImage returns false
+ * {@code drawImage} returns {@code true}.
+ * Otherwise, {@code drawImage} returns {@code false}
* and as more of
* the image becomes available
* or it is time to draw another frame of animation,
* the process that loads the image notifies
* the specified image observer.
* @param img the specified image to be drawn. This method does
- * nothing if img is null.
+ * nothing if {@code img} is null.
* @param x the x coordinate.
* @param y the y coordinate.
* @param observer object to be notified as more of
* the image is converted.
- * @return false if the image pixels are still changing;
- * true otherwise.
+ * @return {@code false} if the image pixels are still changing;
+ * {@code true} otherwise.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
@@ -896,9 +896,9 @@
* entire image has not yet been scaled, dithered, and converted
* for the current output device.
* If the current output representation is not yet complete, then
- * drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that loads the image notifies
- * the image observer by calling its imageUpdate method.
+ * the image observer by calling its {@code imageUpdate} method.
* img is null.
+ * nothing if {@code img} is null.
* @param x the x coordinate.
* @param y the y coordinate.
* @param width the width of the rectangle.
* @param height the height of the rectangle.
* @param observer object to be notified as more of
* the image is converted.
- * @return false if the image pixels are still changing;
- * true otherwise.
+ * @return {@code false} if the image pixels are still changing;
+ * {@code true} otherwise.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
@@ -940,23 +940,23 @@
* drawImage returns true.
- * Otherwise, drawImage returns false
+ * {@code drawImage} returns {@code true}.
+ * Otherwise, {@code drawImage} returns {@code false}
* and as more of
* the image becomes available
* or it is time to draw another frame of animation,
* the process that loads the image notifies
* the specified image observer.
* @param img the specified image to be drawn. This method does
- * nothing if img is null.
+ * nothing if {@code img} is null.
* @param x the x coordinate.
* @param y the y coordinate.
* @param bgcolor the background color to paint under the
* non-opaque portions of the image.
* @param observer object to be notified as more of
* the image is converted.
- * @return false if the image pixels are still changing;
- * true otherwise.
+ * @return {@code false} if the image pixels are still changing;
+ * {@code true} otherwise.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
@@ -981,7 +981,7 @@
* entire image has not yet been scaled, dithered, and converted
* for the current output device.
* If the current output representation is not yet complete then
- * drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that loads the image notifies
* the specified image observer.
* img is null.
+ * nothing if {@code img} is null.
* @param x the x coordinate.
* @param y the y coordinate.
* @param width the width of the rectangle.
@@ -1000,8 +1000,8 @@
* non-opaque portions of the image.
* @param observer object to be notified as more of
* the image is converted.
- * @return false if the image pixels are still changing;
- * true otherwise.
+ * @return {@code false} if the image pixels are still changing;
+ * {@code true} otherwise.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
@@ -1021,7 +1021,7 @@
* image area to be drawn has not yet been scaled, dithered, and converted
* for the current output device.
* If the current output representation is not yet complete then
- * drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that loads the image notifies
* the specified image observer.
* img is null.
+ * nothing if {@code img} is null.
* @param dx1 the x coordinate of the first corner of the
* destination rectangle.
* @param dy1 the y coordinate of the first corner of the
@@ -1054,8 +1054,8 @@
* source rectangle.
* @param observer object to be notified as more of the image is
* scaled and converted.
- * @return false if the image pixels are still changing;
- * true otherwise.
+ * @return {@code false} if the image pixels are still changing;
+ * {@code true} otherwise.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
@@ -1080,7 +1080,7 @@
* image area to be drawn has not yet been scaled, dithered, and converted
* for the current output device.
* If the current output representation is not yet complete then
- * drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that loads the image notifies
* the specified image observer.
* img is null.
+ * nothing if {@code img} is null.
* @param dx1 the x coordinate of the first corner of the
* destination rectangle.
* @param dy1 the y coordinate of the first corner of the
@@ -1115,8 +1115,8 @@
* non-opaque portions of the image.
* @param observer object to be notified as more of the image is
* scaled and converted.
- * @return false if the image pixels are still changing;
- * true otherwise.
+ * @return {@code false} if the image pixels are still changing;
+ * {@code true} otherwise.
* @see java.awt.Image
* @see java.awt.image.ImageObserver
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
@@ -1131,10 +1131,10 @@
/**
* Disposes of this graphics context and releases
* any system resources that it is using.
- * A Graphics object cannot be used after
- * disposehas been called.
+ * A {@code Graphics} object cannot be used after
+ * {@code dispose} has been called.
* Graphics
+ * When a Java program runs, a large number of {@code Graphics}
* objects can be created within a short time frame.
* Although the finalization process of the garbage collector
* also disposes of the same system resources, it is preferable
@@ -1143,12 +1143,12 @@
* may not run to completion for a long period of time.
* paint and update methods
+ * {@code paint} and {@code update} methods
* of components are automatically released by the system when
* those methods return. For efficiency, programmers should
- * call dispose when finished using
- * a Graphics object only if it was created
- * directly from a component or another Graphics object.
+ * call {@code dispose} when finished using
+ * a {@code Graphics} object only if it was created
+ * directly from a component or another {@code Graphics} object.
* @see java.awt.Graphics#finalize
* @see java.awt.Component#paint
* @see java.awt.Component#update
@@ -1166,8 +1166,8 @@
}
/**
- * Returns a String object representing this
- * Graphics object's value.
+ * Returns a {@code String} object representing this
+ * {@code Graphics} object's value.
* @return a string representation of this graphics context.
*/
public String toString() {
@@ -1177,9 +1177,9 @@
/**
* Returns the bounding rectangle of the current clipping area.
* @return the bounding rectangle of the current clipping area
- * or null if no clip is set.
+ * or {@code null} if no clip is set.
* @deprecated As of JDK version 1.1,
- * replaced by getClipBounds().
+ * replaced by {@code getClipBounds()}.
*/
@Deprecated
public Rectangle getClipRect() {
@@ -1208,8 +1208,8 @@
* @param y the y coordinate of the rectangle to test against the clip
* @param width the width of the rectangle to test against the clip
* @param height the height of the rectangle to test against the clip
- * @return true if the specified rectangle intersects
- * the bounds of the current clip; false
+ * @return {@code true} if the specified rectangle intersects
+ * the bounds of the current clip; {@code false}
* otherwise.
*/
public boolean hitClip(int x, int y, int width, int height) {
@@ -1232,8 +1232,8 @@
* This method refers to the user clip, which is independent of the
* clipping associated with device bounds and window visibility.
* If no clip has previously been set, or if the clip has been
- * cleared using setClip(null), this method returns the
- * specified Rectangle.
+ * cleared using {@code setClip(null)}, this method returns the
+ * specified {@code Rectangle}.
* @param r the rectangle where the current clipping area is
* copied to. Any current values in this rectangle are
* overwritten.
--- old/src/java.desktop/share/classes/java/awt/Graphics2D.java 2015-10-04 22:52:41.021274269 +0400
+++ new/src/java.desktop/share/classes/java/awt/Graphics2D.java 2015-10-04 22:52:40.833274277 +0400
@@ -39,47 +39,47 @@
import java.util.Map;
/**
- * This Graphics2D class extends the
+ * This {@code Graphics2D} class extends the
* {@link Graphics} class to provide more sophisticated
* control over geometry, coordinate transformations, color management,
* and text layout. This is the fundamental class for rendering
* 2-dimensional shapes, text and images on the Java(tm) platform.
*
* Coordinate Spaces
- * All coordinates passed to a Graphics2D object are specified
+ * All coordinates passed to a {@code Graphics2D} object are specified
* in a device-independent coordinate system called User Space, which is
- * used by applications. The Graphics2D object contains
+ * used by applications. The {@code Graphics2D} object contains
* an {@link AffineTransform} object as part of its rendering state
* that defines how to convert coordinates from user space to
* device-dependent coordinates in Device Space.
* Graphics2D objects can be used to capture rendering
+ * Some {@code Graphics2D} objects can be used to capture rendering
* operations for storage into a graphics metafile for playback on a
* concrete device of unknown physical resolution at a later time. Since
* the resolution might not be known when the rendering operations are
- * captured, the Graphics2D Transform is set up
+ * captured, the {@code Graphics2D Transform} is set up
* to transform user coordinates to a virtual device space that
* approximates the expected resolution of the target device. Further
* transformations might need to be applied at playback time if the
* estimate is incorrect.
* Graphics2D methods take
+ * occur in the device space, but all {@code Graphics2D} methods take
* user space coordinates.
* Graphics2D object is associated with a target that
+ * Every {@code Graphics2D} object is associated with a target that
* defines where rendering takes place. A
* {@link GraphicsConfiguration} object defines the characteristics
* of the rendering target, such as pixel format and resolution.
* The same rendering target is used throughout the life of a
- * Graphics2D object.
+ * {@code Graphics2D} object.
* Graphics2D object, the
- * GraphicsConfiguration
+ * When creating a {@code Graphics2D} object, the
+ * {@code GraphicsConfiguration}
* specifies the default transform for
- * the target of the Graphics2D (a
+ * the target of the {@code Graphics2D} (a
* {@link Component} or {@link Image}). This default transform maps the
* user space coordinate system to screen and printer device coordinates
* such that the origin maps to the upper left hand corner of the
@@ -90,11 +90,11 @@
* The scaling of the default transform is set to approximately 72 user
* space coordinates per square inch for high resolution devices, such as
* printers. For image buffers, the default transform is the
- * Identity transform.
+ * {@code Identity} transform.
*
* Rendering Process
* The Rendering Process can be broken down into four phases that are
- * controlled by the Graphics2D rendering attributes.
+ * controlled by the {@code Graphics2D} rendering attributes.
* The renderer can optimize many of these steps, either by caching the
* results for future calls, by collapsing multiple virtual steps into
* a single operation, or by recognizing various attributes as common
@@ -106,13 +106,13 @@
* Clip.
- * The Clip is specified by a {@link Shape} in user
+ * Constrain the rendering operation to the current {@code Clip}.
+ * The {@code Clip} is specified by a {@link Shape} in user
* space and is controlled by the program using the various clip
- * manipulation methods of Graphics and
- * Graphics2D. This user clip
+ * manipulation methods of {@code Graphics} and
+ * {@code Graphics2D}. This user clip
* is transformed into device space by the current
- * Transform and combined with the
+ * {@code Transform} and combined with the
* device clip, which is defined by the visibility of windows and
* device extents. The combination of the user clip and device clip
* defines the composite clip, which determines the final clipping
@@ -122,40 +122,40 @@
* Determine what colors to render.
* Graphics2D context.
+ * {@link Composite} attribute in the {@code Graphics2D} context.
*
*
* The three types of rendering operations, along with details of each
* of their particular rendering processes are:
*
*
*
* Shape operations
+ * {@code Shape} operations
*
*
@@ -164,12 +164,12 @@
* draw(Shape) operation, then
+ * If the operation is a {@code draw(Shape)} operation, then
* the {@link Stroke#createStrokedShape(Shape) createStrokedShape}
* method on the current {@link Stroke} attribute in the
- * Graphics2D context is used to construct a new
- * Shape object that contains the outline of the specified
- * Shape.
- * Shape is transformed from user space to device space
- * using the current Transform
- * in the Graphics2D context.
+ * {@code Graphics2D} context is used to construct a new
+ * {@code Shape} object that contains the outline of the specified
+ * {@code Shape}.
+ * Shape is extracted using the
+ * The outline of the {@code Shape} is extracted using the
* {@link Shape#getPathIterator(AffineTransform) getPathIterator} method of
- * Shape, which returns a
+ * {@code Shape}, which returns a
* {@link java.awt.geom.PathIterator PathIterator}
- * object that iterates along the boundary of the Shape.
+ * object that iterates along the boundary of the {@code Shape}.
* Graphics2D object cannot handle the curved segments
- * that the PathIterator object returns then it can call the
+ * If the {@code Graphics2D} object cannot handle the curved segments
+ * that the {@code PathIterator} object returns then it can call the
* alternate
* {@link Shape#getPathIterator(AffineTransform, double) getPathIterator}
- * method of Shape, which flattens the Shape.
+ * method of {@code Shape}, which flattens the {@code Shape}.
* Graphics2D context
+ * The current {@link Paint} in the {@code Graphics2D} context
* is queried for a {@link PaintContext}, which specifies the
* colors to render in device space.
*
*
* String:
+ * to render the indicated {@code String}:
*
*
* String, then the current
- * Font in the Graphics2D context is asked to
- * convert the Unicode characters in the String into a set of
+ * If the argument is a {@code String}, then the current
+ * {@code Font} in the {@code Graphics2D} context is asked to
+ * convert the Unicode characters in the {@code String} into a set of
* glyphs for presentation with whatever basic layout and shaping
* algorithms the font implements.
* TextLayout
+ * using its embedded font attributes. The {@code TextLayout}
* implements more sophisticated glyph layout algorithms that
* perform Unicode bi-directional layout adjustments automatically
* for multiple fonts of differing writing directions.
* GlyphVector object already contains the appropriate
+ * {@code GlyphVector} object already contains the appropriate
* font-specific glyph codes with explicit coordinates for the position of
* each glyph.
* Font is queried to obtain outlines for the
+ * The current {@code Font} is queried to obtain outlines for the
* indicated glyphs. These outlines are treated as shapes in user space
* relative to the position of each glyph that was determined in step 1.
* Shape operations.
+ * under {@code Shape} operations.
* Paint is queried for a
- * PaintContext, which specifies
+ * The current {@code Paint} is queried for a
+ * {@code PaintContext}, which specifies
* the colors to render in device space.
* Image Operations
+ * {@code Image} Operations
*
*
* Image.
+ * {@code Image}.
* This bounding box is specified in Image Space, which is the
- * Image object's local coordinate system.
+ * {@code Image} object's local coordinate system.
* AffineTransform is passed to
+ * If an {@code AffineTransform} is passed to
* {@link #drawImage(java.awt.Image, java.awt.geom.AffineTransform, java.awt.image.ImageObserver) drawImage(Image, AffineTransform, ImageObserver)},
- * the AffineTransform is used to transform the bounding
- * box from image space to user space. If no AffineTransform
+ * the {@code AffineTransform} is used to transform the bounding
+ * box from image space to user space. If no {@code AffineTransform}
* is supplied, the bounding box is treated as if it is already in user space.
* Image is transformed from user
- * space into device space using the current Transform.
+ * The bounding box of the source {@code Image} is transformed from user
+ * space into device space using the current {@code Transform}.
* Note that the result of transforming the bounding box does not
* necessarily result in a rectangular region in device space.
* Image object determines what colors to render,
+ * The {@code Image} object determines what colors to render,
* sampled according to the source to destination
- * coordinate mapping specified by the current Transform and the
+ * coordinate mapping specified by the current {@code Transform} and the
* optional image transform.
* Default Rendering Attributes
- * The default values for the Graphics2D rendering attributes are:
+ * The default values for the {@code Graphics2D} rendering attributes are:
*
- *
*
* Paint
- * Component.
- * Font
- * Font of the Component.
- * Stroke
+ * Transform
+ * GraphicsConfiguration of the Component.
- * Composite
+ * for the {@code GraphicsConfiguration} of the {@code Component}.
+ * Clip
- * Clip, the output is clipped to the
- * Component.
+ * Rendering Compatibility Issues
@@ -291,14 +291,14 @@
* Java 2D API maintains compatibility with JDK 1.1 rendering
* behavior, such that legacy operations and existing renderer
* behavior is unchanged under Java 2D API. Legacy
- * methods that map onto general draw and
- * fill methods are defined, which clearly indicates
- * how Graphics2D extends Graphics based
- * on settings of Stroke and Transform
+ * methods that map onto general {@code draw} and
+ * {@code fill} methods are defined, which clearly indicates
+ * how {@code Graphics2D} extends {@code Graphics} based
+ * on settings of {@code Stroke} and {@code Transform}
* attributes and rendering hints. The definition
* performs identically under default attribute settings.
- * For example, the default Stroke is a
- * BasicStroke with a width of 1 and no dashing and the
+ * For example, the default {@code Stroke} is a
+ * {@code BasicStroke} with a width of 1 and no dashing and the
* default Transform for screen drawing is an Identity transform.
* BasicStroke
+ *
*
- * The fill operations, including fillRect,
- * fillRoundRect, fillOval,
- * fillArc, fillPolygon, and
- * clearRect, {@link #fill(Shape) fill} can now be called
- * with the desired Shape. For example, when filling a
+ * For {@code fill} operations, including {@code fillRect},
+ * {@code fillRoundRect}, {@code fillOval},
+ * {@code fillArc}, {@code fillPolygon}, and
+ * {@code clearRect}, {@link #fill(Shape) fill} can now be called
+ * with the desired {@code Shape}. For example, when filling a
* rectangle:
*
* fill(new Rectangle(x, y, w, h));
@@ -353,11 +353,11 @@
* is called.
*
*
drawLine,
- * drawRect, drawRoundRect,
- * drawOval, drawArc, drawPolyline,
- * and drawPolygon, {@link #draw(Shape) draw} can now be
- * called with the desired Shape. For example, when drawing a
+ * Similarly, for draw operations, including {@code drawLine},
+ * {@code drawRect}, {@code drawRoundRect},
+ * {@code drawOval}, {@code drawArc}, {@code drawPolyline},
+ * and {@code drawPolygon}, {@link #draw(Shape) draw} can now be
+ * called with the desired {@code Shape}. For example, when drawing a
* rectangle:
*
* draw(new Rectangle(x, y, w, h));
@@ -365,36 +365,36 @@
* is called.
*
*
draw3DRect and fill3DRect methods were
- * implemented in terms of the drawLine and
- * fillRect methods in the Graphics class which
- * would predicate their behavior upon the current Stroke
- * and Paint objects in a Graphics2D context.
+ * The {@code draw3DRect} and {@code fill3DRect} methods were
+ * implemented in terms of the {@code drawLine} and
+ * {@code fillRect} methods in the {@code Graphics} class which
+ * would predicate their behavior upon the current {@code Stroke}
+ * and {@code Paint} objects in a {@code Graphics2D} context.
* This class overrides those implementations with versions that use
- * the current Color exclusively, overriding the current
- * Paint and which uses fillRect to describe
+ * the current {@code Color} exclusively, overriding the current
+ * {@code Paint} and which uses {@code fillRect} to describe
* the exact same behavior as the preexisting methods regardless of the
- * setting of the current Stroke.
+ * setting of the current {@code Stroke}.
* Graphics class defines only the setColor
+ * The {@code Graphics} class defines only the {@code setColor}
* method to control the color to be painted. Since the Java 2D API extends
- * the Color object to implement the new Paint
+ * the {@code Color} object to implement the new {@code Paint}
* interface, the existing
- * setColor method is now a convenience method for setting the
- * current Paint attribute to a Color object.
- * setColor(c) is equivalent to setPaint(c).
+ * {@code setColor} method is now a convenience method for setting the
+ * current {@code Paint} attribute to a {@code Color} object.
+ * {@code setColor(c)} is equivalent to {@code setPaint(c)}.
* Graphics class defines two methods for controlling
+ * The {@code Graphics} class defines two methods for controlling
* how colors are applied to the destination.
*
*
setPaintMode method is implemented as a convenience
- * method to set the default Composite, equivalent to
- * setComposite(new AlphaComposite.SrcOver).
- * setXORMode(Color xorcolor) method is implemented
- * as a convenience method to set a special Composite object that
- * ignores the Alpha components of source colors and sets the
+ * The {@code setPaintMode} method is implemented as a convenience
+ * method to set the default {@code Composite}, equivalent to
+ * {@code setComposite(new AlphaComposite.SrcOver)}.
+ *
* dstpixel = (PixelOf(srccolor) ^ PixelOf(xorcolor) ^ dstpixel);
@@ -407,13 +407,13 @@
public abstract class Graphics2D extends Graphics {
/**
- * Constructs a new Graphics2D object. Since
- * Graphics2D is an abstract class, and since it must be
+ * Constructs a new {@code Graphics2D} object. Since
+ * {@code Graphics2D} is an abstract class, and since it must be
* customized by subclasses for different output devices,
- * Graphics2D objects cannot be created directly.
- * Instead, Graphics2D objects must be obtained from another
- * Graphics2D object, created by a
- * Component, or obtained from images such as
+ * {@code Graphics2D} objects cannot be created directly.
+ * Instead, {@code Graphics2D} objects must be obtained from another
+ * {@code Graphics2D} object, created by a
+ * {@code Component}, or obtained from images such as
* {@link BufferedImage} objects.
* @see java.awt.Component#getGraphics
* @see java.awt.Graphics#create
@@ -431,8 +431,8 @@
* The resulting rectangle covers an area that is
* width + 1 pixels wide
* by height + 1 pixels tall. This method
- * uses the current Color exclusively and ignores
- * the current Paint.
+ * uses the current {@code Color} exclusively and ignores
+ * the current {@code Paint}.
* @param x the x coordinate of the rectangle to be drawn.
* @param y the y coordinate of the rectangle to be drawn.
* @param width the width of the rectangle to be drawn.
@@ -467,9 +467,9 @@
* The edges of the rectangle are highlighted so that it appears
* as if the edges were beveled and lit from the upper left corner.
* The colors used for the highlighting effect and for filling are
- * determined from the current Color. This method uses
- * the current Color exclusively and ignores the current
- * Paint.
+ * determined from the current {@code Color}. This method uses
+ * the current {@code Color} exclusively and ignores the current
+ * {@code Paint}.
* @param x the x coordinate of the rectangle to be filled.
* @param y the y coordinate of the rectangle to be filled.
* @param width the width of the rectangle to be filled.
@@ -506,12 +506,12 @@
}
/**
- * Strokes the outline of a Shape using the settings of the
- * current Graphics2D context. The rendering attributes
- * applied include the Clip, Transform,
- * Paint, Composite and
- * Stroke attributes.
- * @param s the Shape to be rendered
+ * Strokes the outline of a {@code Shape} using the settings of the
+ * current {@code Graphics2D} context. The rendering attributes
+ * applied include the {@code Clip}, {@code Transform},
+ * {@code Paint}, {@code Composite} and
+ * {@code Stroke} attributes.
+ * @param s the {@code Shape} to be rendered
* @see #setStroke
* @see #setPaint
* @see java.awt.Graphics#setColor
@@ -527,22 +527,22 @@
* Renders an image, applying a transform from image space into user space
* before drawing.
* The transformation from user space into device space is done with
- * the current Transform in the Graphics2D.
+ * the current {@code Transform} in the {@code Graphics2D}.
* The specified transformation is applied to the image before the
- * transform attribute in the Graphics2D context is applied.
- * The rendering attributes applied include the Clip,
- * Transform, and Composite attributes.
+ * transform attribute in the {@code Graphics2D} context is applied.
+ * The rendering attributes applied include the {@code Clip},
+ * {@code Transform}, and {@code Composite} attributes.
* Note that no rendering is done if the specified transform is
* noninvertible.
* @param img the specified image to be rendered.
- * This method does nothing if img is null.
+ * This method does nothing if {@code img} is null.
* @param xform the transformation from image space into user space
* @param obs the {@link ImageObserver}
- * to be notified as more of the Image
+ * to be notified as more of the {@code Image}
* is converted
- * @return true if the Image is
+ * @return {@code true} if the {@code Image} is
* fully loaded and completely rendered, or if it's null;
- * false if the Image is still being loaded.
+ * {@code false} if the {@code Image} is still being loaded.
* @see #transform
* @see #setTransform
* @see #setComposite
@@ -554,19 +554,19 @@
ImageObserver obs);
/**
- * Renders a BufferedImage that is
+ * Renders a {@code BufferedImage} that is
* filtered with a
* {@link BufferedImageOp}.
- * The rendering attributes applied include the Clip,
- * Transform
- * and Composite attributes. This is equivalent to:
+ * The rendering attributes applied include the {@code Clip},
+ * {@code Transform}
+ * and {@code Composite} attributes. This is equivalent to:
*
* img1 = op.filter(img, null);
* drawImage(img1, new AffineTransform(1f,0f,0f,1f,x,y), null);
*
* @param op the filter to be applied to the image before rendering
- * @param img the specified BufferedImage to be rendered.
- * This method does nothing if img is null.
+ * @param img the specified {@code BufferedImage} to be rendered.
+ * This method does nothing if {@code img} is null.
* @param x the x coordinate of the location in user space where
* the upper left corner of the image is rendered
* @param y the y coordinate of the location in user space where
@@ -588,15 +588,15 @@
* applying a transform from image
* space into user space before drawing.
* The transformation from user space into device space is done with
- * the current Transform in the Graphics2D.
+ * the current {@code Transform} in the {@code Graphics2D}.
* The specified transformation is applied to the image before the
- * transform attribute in the Graphics2D context is applied.
- * The rendering attributes applied include the Clip,
- * Transform, and Composite attributes. Note
+ * transform attribute in the {@code Graphics2D} context is applied.
+ * The rendering attributes applied include the {@code Clip},
+ * {@code Transform}, and {@code Composite} attributes. Note
* that no rendering is done if the specified transform is
* noninvertible.
* @param img the image to be rendered. This method does
- * nothing if img is null.
+ * nothing if {@code img} is null.
* @param xform the transformation from image space into user space
* @see #transform
* @see #setTransform
@@ -612,24 +612,24 @@
* {@link RenderableImage},
* applying a transform from image space into user space before drawing.
* The transformation from user space into device space is done with
- * the current Transform in the Graphics2D.
+ * the current {@code Transform} in the {@code Graphics2D}.
* The specified transformation is applied to the image before the
- * transform attribute in the Graphics2D context is applied.
- * The rendering attributes applied include the Clip,
- * Transform, and Composite attributes. Note
+ * transform attribute in the {@code Graphics2D} context is applied.
+ * The rendering attributes applied include the {@code Clip},
+ * {@code Transform}, and {@code Composite} attributes. Note
* that no rendering is done if the specified transform is
* noninvertible.
*Graphics2D object might
- * be used in rendering the RenderableImage.
+ * Rendering hints set on the {@code Graphics2D} object might
+ * be used in rendering the {@code RenderableImage}.
* If explicit control is required over specific hints recognized by a
- * specific RenderableImage, or if knowledge of which hints
- * are used is required, then a RenderedImage should be
- * obtained directly from the RenderableImage
+ * specific {@code RenderableImage}, or if knowledge of which hints
+ * are used is required, then a {@code RenderedImage} should be
+ * obtained directly from the {@code RenderableImage}
* and rendered using
*{@link #drawRenderedImage(RenderedImage, AffineTransform) drawRenderedImage}.
* @param img the image to be rendered. This method does
- * nothing if img is null.
+ * nothing if {@code img} is null.
* @param xform the transformation from image space into user space
* @see #transform
* @see #setTransform
@@ -642,24 +642,24 @@
AffineTransform xform);
/**
- * Renders the text of the specified String, using the
- * current text attribute state in the Graphics2D context.
+ * Renders the text of the specified {@code String}, using the
+ * current text attribute state in the {@code Graphics2D} context.
* The baseline of the
* first character is at position (x, y) in
* the User Space.
- * The rendering attributes applied include the Clip,
- * Transform, Paint, Font and
- * Composite attributes. For characters in script
+ * The rendering attributes applied include the {@code Clip},
+ * {@code Transform}, {@code Paint}, {@code Font} and
+ * {@code Composite} attributes. For characters in script
* systems such as Hebrew and Arabic, the glyphs can be rendered from
* right to left, in which case the coordinate supplied is the
* location of the leftmost character on the baseline.
* @param str the string to be rendered
* @param x the x coordinate of the location where the
- * String should be rendered
+ * {@code String} should be rendered
* @param y the y coordinate of the location where the
- * String should be rendered
- * @throws NullPointerException if str is
- * null
+ * {@code String} should be rendered
+ * @throws NullPointerException if {@code str} is
+ * {@code null}
* @see java.awt.Graphics#drawBytes
* @see java.awt.Graphics#drawChars
* @since 1.0
@@ -667,23 +667,23 @@
public abstract void drawString(String str, int x, int y);
/**
- * Renders the text specified by the specified String,
- * using the current text attribute state in the Graphics2D context.
+ * Renders the text specified by the specified {@code String},
+ * using the current text attribute state in the {@code Graphics2D} context.
* The baseline of the first character is at position
* (x, y) in the User Space.
- * The rendering attributes applied include the Clip,
- * Transform, Paint, Font and
- * Composite attributes. For characters in script systems
+ * The rendering attributes applied include the {@code Clip},
+ * {@code Transform}, {@code Paint}, {@code Font} and
+ * {@code Composite} attributes. For characters in script systems
* such as Hebrew and Arabic, the glyphs can be rendered from right to
* left, in which case the coordinate supplied is the location of the
* leftmost character on the baseline.
- * @param str the String to be rendered
+ * @param str the {@code String} to be rendered
* @param x the x coordinate of the location where the
- * String should be rendered
+ * {@code String} should be rendered
* @param y the y coordinate of the location where the
- * String should be rendered
- * @throws NullPointerException if str is
- * null
+ * {@code String} should be rendered
+ * @throws NullPointerException if {@code str} is
+ * {@code null}
* @see #setPaint
* @see java.awt.Graphics#setColor
* @see java.awt.Graphics#setFont
@@ -708,8 +708,8 @@
* rendered
* @param y the y coordinate where the iterator's text is to be
* rendered
- * @throws NullPointerException if iterator is
- * null
+ * @throws NullPointerException if {@code iterator} is
+ * {@code null}
* @see #setPaint
* @see java.awt.Graphics#setColor
* @see #setTransform
@@ -734,8 +734,8 @@
* rendered
* @param y the y coordinate where the iterator's text is to be
* rendered
- * @throws NullPointerException if iterator is
- * null
+ * @throws NullPointerException if {@code iterator} is
+ * {@code null}
* @see #setPaint
* @see java.awt.Graphics#setColor
* @see #setTransform
@@ -748,20 +748,20 @@
/**
* Renders the text of the specified
* {@link GlyphVector} using
- * the Graphics2D context's rendering attributes.
- * The rendering attributes applied include the Clip,
- * Transform, Paint, and
- * Composite attributes. The GlyphVector
+ * the {@code Graphics2D} context's rendering attributes.
+ * The rendering attributes applied include the {@code Clip},
+ * {@code Transform}, {@code Paint}, and
+ * {@code Composite} attributes. The {@code GlyphVector}
* specifies individual glyphs from a {@link Font}.
- * The GlyphVector can also contain the glyph positions.
+ * The {@code GlyphVector} can also contain the glyph positions.
* This is the fastest way to render a set of characters to the
* screen.
- * @param g the GlyphVector to be rendered
+ * @param g the {@code GlyphVector} to be rendered
* @param x the x position in User Space where the glyphs should
* be rendered
* @param y the y position in User Space where the glyphs should
* be rendered
- * @throws NullPointerException if g is null.
+ * @throws NullPointerException if {@code g} is {@code null}.
*
* @see java.awt.Font#createGlyphVector
* @see java.awt.font.GlyphVector
@@ -774,11 +774,11 @@
public abstract void drawGlyphVector(GlyphVector g, float x, float y);
/**
- * Fills the interior of a Shape using the settings of the
- * Graphics2D context. The rendering attributes applied
- * include the Clip, Transform,
- * Paint, and Composite.
- * @param s the Shape to be filled
+ * Fills the interior of a {@code Shape} using the settings of the
+ * {@code Graphics2D} context. The rendering attributes applied
+ * include the {@code Clip}, {@code Transform},
+ * {@code Paint}, and {@code Composite}.
+ * @param s the {@code Shape} to be filled
* @see #setPaint
* @see java.awt.Graphics#setColor
* @see #transform
@@ -790,25 +790,25 @@
public abstract void fill(Shape s);
/**
- * Checks whether or not the specified Shape intersects
+ * Checks whether or not the specified {@code Shape} intersects
* the specified {@link Rectangle}, which is in device
- * space. If onStroke is false, this method checks
- * whether or not the interior of the specified Shape
- * intersects the specified Rectangle. If
- * onStroke is true, this method checks
- * whether or not the Stroke of the specified
- * Shape outline intersects the specified
- * Rectangle.
+ * space. If {@code onStroke} is false, this method checks
+ * whether or not the interior of the specified {@code Shape}
+ * intersects the specified {@code Rectangle}. If
+ * {@code onStroke} is {@code true}, this method checks
+ * whether or not the {@code Stroke} of the specified
+ * {@code Shape} outline intersects the specified
+ * {@code Rectangle}.
* The rendering attributes taken into account include the
- * Clip, Transform, and Stroke
+ * {@code Clip}, {@code Transform}, and {@code Stroke}
* attributes.
* @param rect the area in device space to check for a hit
- * @param s the Shape to check for a hit
+ * @param s the {@code Shape} to check for a hit
* @param onStroke flag used to choose between testing the
- * stroked or the filled shape. If the flag is true, the
- * Stroke outline is tested. If the flag is
- * false, the filled Shape is tested.
- * @return true if there is a hit; false
+ * stroked or the filled shape. If the flag is {@code true}, the
+ * {@code Stroke} outline is tested. If the flag is
+ * {@code false}, the filled {@code Shape} is tested.
+ * @return {@code true} if there is a hit; {@code false}
* otherwise.
* @see #setStroke
* @see #fill
@@ -824,31 +824,31 @@
/**
* Returns the device configuration associated with this
- * Graphics2D.
- * @return the device configuration of this Graphics2D.
+ * {@code Graphics2D}.
+ * @return the device configuration of this {@code Graphics2D}.
*/
public abstract GraphicsConfiguration getDeviceConfiguration();
/**
- * Sets the Composite for the Graphics2D context.
- * The Composite is used in all drawing methods such as
- * drawImage, drawString, draw,
- * and fill. It specifies how new pixels are to be combined
+ * Sets the {@code Composite} for the {@code Graphics2D} context.
+ * The {@code Composite} is used in all drawing methods such as
+ * {@code drawImage}, {@code drawString}, {@code draw},
+ * and {@code fill}. It specifies how new pixels are to be combined
* with the existing pixels on the graphics device during the rendering
* process.
- * Graphics2D context is drawing to a
- * Component on the display screen and the
- * Composite is a custom object rather than an
- * instance of the AlphaComposite class, and if
- * there is a security manager, its checkPermission
- * method is called with an AWTPermission("readDisplayPixels")
+ * Composite object is being
+ * if a custom {@code Composite} object is being
* used to render to the screen and a security manager
- * is set and its checkPermission method
+ * is set and its {@code checkPermission} method
* does not allow the operation.
- * @param comp the Composite object to be used for rendering
+ * @param comp the {@code Composite} object to be used for rendering
* @see java.awt.Graphics#setXORMode
* @see java.awt.Graphics#setPaintMode
* @see #getComposite
@@ -859,13 +859,13 @@
public abstract void setComposite(Composite comp);
/**
- * Sets the Paint attribute for the
- * Graphics2D context. Calling this method
- * with a null Paint object does
- * not have any effect on the current Paint attribute
- * of this Graphics2D.
- * @param paint the Paint object to be used to generate
- * color during the rendering process, or null
+ * Sets the {@code Paint} attribute for the
+ * {@code Graphics2D} context. Calling this method
+ * with a {@code null Paint} object does
+ * not have any effect on the current {@code Paint} attribute
+ * of this {@code Graphics2D}.
+ * @param paint the {@code Paint} object to be used to generate
+ * color during the rendering process, or {@code null}
* @see java.awt.Graphics#setColor
* @see #getPaint
* @see GradientPaint
@@ -874,9 +874,9 @@
public abstract void setPaint( Paint paint );
/**
- * Sets the Stroke for the Graphics2D context.
- * @param s the Stroke object to be used to stroke a
- * Shape during the rendering process
+ * Sets the {@code Stroke} for the {@code Graphics2D} context.
+ * @param s the {@code Stroke} object to be used to stroke a
+ * {@code Shape} during the rendering process
* @see BasicStroke
* @see #getStroke
*/
@@ -886,7 +886,7 @@
* Sets the value of a single preference for the rendering algorithms.
* Hint categories include controls for rendering quality and overall
* time/quality trade-off in the rendering process. Refer to the
- * RenderingHints class for definitions of some common
+ * {@code RenderingHints} class for definitions of some common
* keys and values.
* @param hintKey the key of the hint to be set.
* @param hintValue the value indicating preferences for the specified
@@ -900,12 +900,12 @@
* Returns the value of a single preference for the rendering algorithms.
* Hint categories include controls for rendering quality and overall
* time/quality trade-off in the rendering process. Refer to the
- * RenderingHints class for definitions of some common
+ * {@code RenderingHints} class for definitions of some common
* keys and values.
* @param hintKey the key corresponding to the hint to get.
* @return an object representing the value for the specified hint key.
* Some of the keys and their associated values are defined in the
- * RenderingHints class.
+ * {@code RenderingHints} class.
* @see RenderingHints
* @see #setRenderingHint(RenderingHints.Key, Object)
*/
@@ -913,13 +913,13 @@
/**
* Replaces the values of all preferences for the rendering
- * algorithms with the specified hints.
+ * algorithms with the specified {@code hints}.
* The existing values for all rendering hints are discarded and
* the new set of known hints and values are initialized from the
* specified {@link Map} object.
* Hint categories include controls for rendering quality and
* overall time/quality trade-off in the rendering process.
- * Refer to the RenderingHints class for definitions of
+ * Refer to the {@code RenderingHints} class for definitions of
* some common keys and values.
* @param hints the rendering hints to be set
* @see #getRenderingHints
@@ -931,12 +931,12 @@
* Sets the values of an arbitrary number of preferences for the
* rendering algorithms.
* Only values for the rendering hints that are present in the
- * specified Map object are modified.
+ * specified {@code Map} object are modified.
* All other preferences not present in the specified
* object are left unmodified.
* Hint categories include controls for rendering quality and
* overall time/quality trade-off in the rendering process.
- * Refer to the RenderingHints class for definitions of
+ * Refer to the {@code RenderingHints} class for definitions of
* some common keys and values.
* @param hints the rendering hints to be set
* @see RenderingHints
@@ -949,9 +949,9 @@
* trade-off in the rendering process.
* Returns all of the hint key/value pairs that were ever specified in
* one operation. Refer to the
- * RenderingHints class for definitions of some common
+ * {@code RenderingHints} class for definitions of some common
* keys and values.
- * @return a reference to an instance of RenderingHints
+ * @return a reference to an instance of {@code RenderingHints}
* that contains the current preferences.
* @see RenderingHints
* @see #setRenderingHints(Map)
@@ -959,11 +959,11 @@
public abstract RenderingHints getRenderingHints();
/**
- * Translates the origin of the Graphics2D context to the
+ * Translates the origin of the {@code Graphics2D} context to the
* point (x, y) in the current coordinate system.
- * Modifies the Graphics2D context so that its new origin
+ * Modifies the {@code Graphics2D} context so that its new origin
* corresponds to the point (x, y) in the
- * Graphics2D context's former coordinate system. All
+ * {@code Graphics2D} context's former coordinate system. All
* coordinates used in subsequent rendering operations on this graphics
* context are relative to this new origin.
* @param x the specified x coordinate
@@ -974,12 +974,12 @@
/**
* Concatenates the current
- * Graphics2D Transform
+ * {@code Graphics2D Transform}
* with a translation transform.
* Subsequent rendering is translated by the specified
* distance relative to the previous position.
* This is equivalent to calling transform(T), where T is an
- * AffineTransform represented by the following matrix:
+ * {@code AffineTransform} represented by the following matrix:
*
* [ 1 0 tx ]
* [ 0 1 ty ]
@@ -991,12 +991,12 @@
public abstract void translate(double tx, double ty);
/**
- * Concatenates the current Graphics2D
- * Transform with a rotation transform.
+ * Concatenates the current {@code Graphics2D}
+ * {@code Transform} with a rotation transform.
* Subsequent rendering is rotated by the specified radians relative
* to the previous origin.
- * This is equivalent to calling transform(R), where R is an
- * AffineTransform represented by the following matrix:
+ * This is equivalent to calling {@code transform(R)}, where R is an
+ * {@code AffineTransform} represented by the following matrix:
*
* [ cos(theta) -sin(theta) 0 ]
* [ sin(theta) cos(theta) 0 ]
@@ -1009,8 +1009,8 @@
public abstract void rotate(double theta);
/**
- * Concatenates the current Graphics2D
- * Transform with a translated rotation
+ * Concatenates the current {@code Graphics2D}
+ * {@code Transform} with a translated rotation
* transform. Subsequent rendering is transformed by a transform
* which is constructed by translating to the specified location,
* rotating by the specified radians, and translating back by the same
@@ -1030,12 +1030,12 @@
public abstract void rotate(double theta, double x, double y);
/**
- * Concatenates the current Graphics2D
- * Transform with a scaling transformation
+ * Concatenates the current {@code Graphics2D}
+ * {@code Transform} with a scaling transformation
* Subsequent rendering is resized according to the specified scaling
* factors relative to the previous scaling.
- * This is equivalent to calling transform(S), where S is an
- * AffineTransform represented by the following matrix:
+ * This is equivalent to calling {@code transform(S)}, where S is an
+ * {@code AffineTransform} represented by the following matrix:
*
* [ sx 0 0 ]
* [ 0 sy 0 ]
@@ -1051,12 +1051,12 @@
public abstract void scale(double sx, double sy);
/**
- * Concatenates the current Graphics2D
- * Transform with a shearing transform.
+ * Concatenates the current {@code Graphics2D}
+ * {@code Transform} with a shearing transform.
* Subsequent renderings are sheared by the specified
* multiplier relative to the previous position.
- * This is equivalent to calling transform(SH), where SH
- * is an AffineTransform represented by the following
+ * This is equivalent to calling {@code transform(SH)}, where SH
+ * is an {@code AffineTransform} represented by the following
* matrix:
*
* [ 1 shx 0 ]
@@ -1071,37 +1071,37 @@
public abstract void shear(double shx, double shy);
/**
- * Composes an
- * Note that sometimes this AffineTransform object with the
- * Transform in this Graphics2D according
+ * Composes an {@code AffineTransform} object with the
+ * {@code Transform} in this {@code Graphics2D} according
* to the rule last-specified-first-applied. If the current
- * Transform is Cx, the result of composition
- * with Tx is a new Transform Cx'. Cx' becomes the
- * current Transform for this Graphics2D.
- * Transforming a point p by the updated Transform Cx' is
+ * {@code Transform} is Cx, the result of composition
+ * with Tx is a new {@code Transform} Cx'. Cx' becomes the
+ * current {@code Transform} for this {@code Graphics2D}.
+ * Transforming a point p by the updated {@code Transform} Cx' is
* equivalent to first transforming p by Tx and then transforming
- * the result by the original Transform Cx. In other
+ * the result by the original {@code Transform} Cx. In other
* words, Cx'(p) = Cx(Tx(p)). A copy of the Tx is made, if necessary,
* so further modifications to Tx do not affect rendering.
- * @param Tx the AffineTransform object to be composed with
- * the current Transform
+ * @param Tx the {@code AffineTransform} object to be composed with
+ * the current {@code Transform}
* @see #setTransform
* @see AffineTransform
*/
public abstract void transform(AffineTransform Tx);
/**
- * Overwrites the Transform in the Graphics2D context.
+ * Overwrites the Transform in the {@code Graphics2D} context.
* WARNING: This method should never be used to apply a new
* coordinate transform on top of an existing transform because the
- * Graphics2D might already have a transform that is
+ * {@code Graphics2D} might already have a transform that is
* needed for other purposes, such as rendering Swing
* components or applying a scaling transformation to adjust for the
* resolution of a printer.
* transform, rotate, scale,
- * or shear methods. The setTransform
+ * {@code transform}, {@code rotate}, {@code scale},
+ * or {@code shear} methods. The {@code setTransform}
* method is intended only for restoring the original
- * Graphics2D transform after rendering, as shown in this
+ * {@code Graphics2D} transform after rendering, as shown in this
* example:
*
* // Get the current transform
@@ -1114,8 +1114,8 @@
* g2d.setTransform(saveAT);
*
*
- * @param Tx the AffineTransform that was retrieved
- * from the getTransform method
+ * @param Tx the {@code AffineTransform} that was retrieved
+ * from the {@code getTransform} method
* @see #transform
* @see #getTransform
* @see AffineTransform
@@ -1123,19 +1123,19 @@
public abstract void setTransform(AffineTransform Tx);
/**
- * Returns a copy of the current Transform in the
- * Graphics2D context.
- * @return the current AffineTransform in the
- * Graphics2D context.
+ * Returns a copy of the current {@code Transform} in the
+ * {@code Graphics2D} context.
+ * @return the current {@code AffineTransform} in the
+ * {@code Graphics2D} context.
* @see #transform
* @see #setTransform
*/
public abstract AffineTransform getTransform();
/**
- * Returns the current Paint of the
- * Graphics2D context.
- * @return the current Graphics2D Paint,
+ * Returns the current {@code Paint} of the
+ * {@code Graphics2D} context.
+ * @return the current {@code Graphics2D Paint},
* which defines a color or pattern.
* @see #setPaint
* @see java.awt.Graphics#setColor
@@ -1143,27 +1143,27 @@
public abstract Paint getPaint();
/**
- * Returns the current Composite in the
- * Graphics2D context.
- * @return the current Graphics2D Composite,
+ * Returns the current {@code Composite} in the
+ * {@code Graphics2D} context.
+ * @return the current {@code Graphics2D Composite},
* which defines a compositing style.
* @see #setComposite
*/
public abstract Composite getComposite();
/**
- * Sets the background color for the Graphics2D context.
+ * Sets the background color for the {@code Graphics2D} context.
* The background color is used for clearing a region.
- * When a Graphics2D is constructed for a
- * Component, the background color is
- * inherited from the Component. Setting the background color
- * in the Graphics2D context only affects the subsequent
- * clearRect calls and not the background color of the
- * Component. To change the background
- * of the Component, use appropriate methods of
- * the Component.
+ * When a {@code Graphics2D} is constructed for a
+ * {@code Component}, the background color is
+ * inherited from the {@code Component}. Setting the background color
+ * in the {@code Graphics2D} context only affects the subsequent
+ * {@code clearRect} calls and not the background color of the
+ * {@code Component}. To change the background
+ * of the {@code Component}, use appropriate methods of
+ * the {@code Component}.
* @param color the background color that is used in
- * subsequent calls to clearRect
+ * subsequent calls to {@code clearRect}
* @see #getBackground
* @see java.awt.Graphics#clearRect
*/
@@ -1171,52 +1171,52 @@
/**
* Returns the background color used for clearing a region.
- * @return the current Graphics2D Color,
+ * @return the current {@code Graphics2D Color},
* which defines the background color.
* @see #setBackground
*/
public abstract Color getBackground();
/**
- * Returns the current Stroke in the
- * Graphics2D context.
- * @return the current Graphics2D Stroke,
+ * Returns the current {@code Stroke} in the
+ * {@code Graphics2D} context.
+ * @return the current {@code Graphics2D Stroke},
* which defines the line style.
* @see #setStroke
*/
public abstract Stroke getStroke();
/**
- * Intersects the current Clip with the interior of the
- * specified Shape and sets the Clip to the
- * resulting intersection. The specified Shape is
- * transformed with the current Graphics2D
- * Transform before being intersected with the current
- * Clip. This method is used to make the current
- * Clip smaller.
- * To make the Clip larger, use setClip.
+ * Intersects the current {@code Clip} with the interior of the
+ * specified {@code Shape} and sets the {@code Clip} to the
+ * resulting intersection. The specified {@code Shape} is
+ * transformed with the current {@code Graphics2D}
+ * {@code Transform} before being intersected with the current
+ * {@code Clip}. This method is used to make the current
+ * {@code Clip} smaller.
+ * To make the {@code Clip} larger, use {@code setClip}.
* The user clip modified by this method is independent of the
* clipping associated with device bounds and visibility. If no clip has
* previously been set, or if the clip has been cleared using
- * {@link Graphics#setClip(Shape) setClip} with a null
- * argument, the specified Shape becomes the new
+ * {@link Graphics#setClip(Shape) setClip} with a {@code null}
+ * argument, the specified {@code Shape} becomes the new
* user clip.
- * @param s the Shape to be intersected with the current
- * Clip. If s is null,
- * this method clears the current Clip.
+ * @param s the {@code Shape} to be intersected with the current
+ * {@code Clip}. If {@code s} is {@code null},
+ * this method clears the current {@code Clip}.
*/
public abstract void clip(Shape s);
/**
- * Get the rendering context of the Font within this
- * Graphics2D context.
+ * Get the rendering context of the {@code Font} within this
+ * {@code Graphics2D} context.
* The {@link FontRenderContext}
* encapsulates application hints such as anti-aliasing and
* fractional metrics, as well as target device specific information
* such as dots-per-inch. This information should be provided by the
* application when using objects that perform typographical
- * formatting, such as Font and
- * TextLayout. This information should also be provided
+ * formatting, such as {@code Font} and
+ * {@code TextLayout}. This information should also be provided
* by applications that perform their own layout and need accurate
* measurements of various characteristics of glyphs such as advance
* and line height when various rendering hints have been applied to
--- old/src/java.desktop/share/classes/java/awt/GraphicsConfigTemplate.java 2015-10-04 22:52:41.581274244 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsConfigTemplate.java 2015-10-04 22:52:41.393274252 +0400
@@ -28,14 +28,14 @@
import java.io.*;
/**
- * The GraphicsConfigTemplate class is used to obtain a valid
+ * The {@code GraphicsConfigTemplate} class is used to obtain a valid
* {@link GraphicsConfiguration}. A user instantiates one of these
* objects and then sets all non-default attributes as desired. The
* {@link GraphicsDevice#getBestConfiguration} method found in the
* {@link GraphicsDevice} class is then called with this
- * GraphicsConfigTemplate. A valid
- * GraphicsConfiguration is returned that meets or exceeds
- * what was requested in the GraphicsConfigTemplate.
+ * {@code GraphicsConfigTemplate}. A valid
+ * {@code GraphicsConfiguration} is returned that meets or exceeds
+ * what was requested in the {@code GraphicsConfigTemplate}.
* @see GraphicsDevice
* @see GraphicsConfiguration
*
@@ -56,15 +56,15 @@
/**
* Value used for "Enum" (Integer) type. States that this
- * feature is required for the GraphicsConfiguration
+ * feature is required for the {@code GraphicsConfiguration}
* object. If this feature is not available, do not select the
- * GraphicsConfiguration object.
+ * {@code GraphicsConfiguration} object.
*/
public static final int REQUIRED = 1;
/**
* Value used for "Enum" (Integer) type. States that this
- * feature is desired for the GraphicsConfiguration
+ * feature is desired for the {@code GraphicsConfiguration}
* object. A selection with this feature is preferred over a
* selection that does not include this feature, although both
* selections can be considered valid matches.
@@ -74,7 +74,7 @@
/**
* Value used for "Enum" (Integer) type. States that this
* feature is not necessary for the selection of the
- * GraphicsConfiguration object. A selection
+ * {@code GraphicsConfiguration} object. A selection
* without this feature is preferred over a selection that
* includes this feature since it is not used.
*/
@@ -82,10 +82,10 @@
/**
* Returns the "best" configuration possible that passes the
- * criteria defined in the GraphicsConfigTemplate.
- * @param gc the array of GraphicsConfiguration
+ * criteria defined in the {@code GraphicsConfigTemplate}.
+ * @param gc the array of {@code GraphicsConfiguration}
* objects to choose from.
- * @return a GraphicsConfiguration object that is
+ * @return a {@code GraphicsConfiguration} object that is
* the best configuration possible.
* @see GraphicsConfiguration
*/
@@ -93,15 +93,15 @@
getBestConfiguration(GraphicsConfiguration[] gc);
/**
- * Returns a boolean indicating whether or
- * not the specified GraphicsConfiguration can be
+ * Returns a {@code boolean} indicating whether or
+ * not the specified {@code GraphicsConfiguration} can be
* used to create a drawing surface that supports the indicated
* features.
- * @param gc the GraphicsConfiguration object to test
- * @return true if this
- * GraphicsConfiguration object can be used to create
+ * @param gc the {@code GraphicsConfiguration} object to test
+ * @return {@code true} if this
+ * {@code GraphicsConfiguration} object can be used to create
* surfaces that support the indicated features;
- * false if the GraphicsConfiguration can
+ * {@code false} if the {@code GraphicsConfiguration} can
* not be used to create a drawing surface usable by this Java(tm)
* API.
*/
--- old/src/java.desktop/share/classes/java/awt/GraphicsConfiguration.java 2015-10-04 22:52:42.105274220 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsConfiguration.java 2015-10-04 22:52:41.917274229 +0400
@@ -34,23 +34,23 @@
import sun.awt.image.SunVolatileImage;
/**
- * The GraphicsConfiguration class describes the
+ * The {@code GraphicsConfiguration} class describes the
* characteristics of a graphics destination such as a printer or monitor.
- * There can be many GraphicsConfiguration objects associated
+ * There can be many {@code GraphicsConfiguration} objects associated
* with a single graphics device, representing different drawing modes or
* capabilities. The corresponding native structure will vary from platform
* to platform. For example, on X11 windowing systems,
- * each visual is a different GraphicsConfiguration.
- * On Microsoft Windows, GraphicsConfigurations represent
+ * each visual is a different {@code GraphicsConfiguration}.
+ * On Microsoft Windows, {@code GraphicsConfiguration}s represent
* PixelFormats available in the current resolution and color depth.
* GraphicsConfiguration objects are relative to the
+ * {@code GraphicsConfiguration} objects are relative to the
* virtual coordinate system. When setting the location of a
* component, use {@link #getBounds() getBounds} to get the bounds of
- * the desired GraphicsConfiguration and offset the location
- * with the coordinates of the GraphicsConfiguration,
+ * the desired {@code GraphicsConfiguration} and offset the location
+ * with the coordinates of the {@code GraphicsConfiguration},
* as the following code sample illustrates:
* getBounds on all of the
- * GraphicsConfiguration objects in your system. If
+ * environment, call {@code getBounds} on all of the
+ * {@code GraphicsConfiguration} objects in your system. If
* any of the origins of the returned bounds is not (0, 0),
* your environment is a virtual device environment.
*
* getBounds to determine the bounds
- * of the virtual device. To do this, first call getBounds on all
- * of the GraphicsConfiguration objects in your
+ * You can also use {@code getBounds} to determine the bounds
+ * of the virtual device. To do this, first call {@code getBounds} on all
+ * of the {@code GraphicsConfiguration} objects in your
* system. Then calculate the union of all of the bounds returned
- * from the calls to getBounds. The union is the
+ * from the calls to {@code getBounds}. The union is the
* bounds of the virtual device. The following code sample
* calculates the bounds of the virtual device.
*
@@ -125,24 +125,24 @@
/**
* Returns the {@link GraphicsDevice} associated with this
- * GraphicsConfiguration.
- * @return a GraphicsDevice object that is
- * associated with this GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
+ * @return a {@code GraphicsDevice} object that is
+ * associated with this {@code GraphicsConfiguration}.
*/
public abstract GraphicsDevice getDevice();
/**
* Returns a {@link BufferedImage} with a data layout and color model
- * compatible with this GraphicsConfiguration. This
+ * compatible with this {@code GraphicsConfiguration}. This
* method has nothing to do with memory-mapping
- * a device. The returned BufferedImage has
+ * a device. The returned {@code BufferedImage} has
* a layout and color model that is closest to this native device
* configuration and can therefore be optimally blitted to this
* device.
- * @param width the width of the returned BufferedImage
- * @param height the height of the returned BufferedImage
- * @return a BufferedImage whose data layout and color
- * model is compatible with this GraphicsConfiguration.
+ * @param width the width of the returned {@code BufferedImage}
+ * @param height the height of the returned {@code BufferedImage}
+ * @return a {@code BufferedImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}.
*/
public BufferedImage createCompatibleImage(int width, int height) {
ColorModel model = getColorModel();
@@ -153,18 +153,18 @@
}
/**
- * Returns a BufferedImage that supports the specified
+ * Returns a {@code BufferedImage} that supports the specified
* transparency and has a data layout and color model
- * compatible with this GraphicsConfiguration. This
+ * compatible with this {@code GraphicsConfiguration}. This
* method has nothing to do with memory-mapping
- * a device. The returned BufferedImage has a layout and
+ * a device. The returned {@code BufferedImage} has a layout and
* color model that can be optimally blitted to a device
- * with this GraphicsConfiguration.
- * @param width the width of the returned BufferedImage
- * @param height the height of the returned BufferedImage
+ * with this {@code GraphicsConfiguration}.
+ * @param width the width of the returned {@code BufferedImage}
+ * @param height the height of the returned {@code BufferedImage}
* @param transparency the specified transparency mode
- * @return a BufferedImage whose data layout and color
- * model is compatible with this GraphicsConfiguration
+ * @return a {@code BufferedImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}
* and also supports the specified transparency.
* @throws IllegalArgumentException if the transparency is not a valid value
* @see Transparency#OPAQUE
@@ -190,15 +190,15 @@
/**
* Returns a {@link VolatileImage} with a data layout and color model
- * compatible with this GraphicsConfiguration.
- * The returned VolatileImage
+ * compatible with this {@code GraphicsConfiguration}.
+ * The returned {@code VolatileImage}
* may have data that is stored optimally for the underlying graphics
* device and may therefore benefit from platform-specific rendering
* acceleration.
- * @param width the width of the returned VolatileImage
- * @param height the height of the returned VolatileImage
- * @return a VolatileImage whose data layout and color
- * model is compatible with this GraphicsConfiguration.
+ * @param width the width of the returned {@code VolatileImage}
+ * @param height the height of the returned {@code VolatileImage}
+ * @return a {@code VolatileImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}.
* @see Component#createVolatileImage(int, int)
* @since 1.4
*/
@@ -216,16 +216,16 @@
/**
* Returns a {@link VolatileImage} with a data layout and color model
- * compatible with this GraphicsConfiguration.
- * The returned VolatileImage
+ * compatible with this {@code GraphicsConfiguration}.
+ * The returned {@code VolatileImage}
* may have data that is stored optimally for the underlying graphics
* device and may therefore benefit from platform-specific rendering
* acceleration.
- * @param width the width of the returned VolatileImage
- * @param height the height of the returned VolatileImage
+ * @param width the width of the returned {@code VolatileImage}
+ * @param height the height of the returned {@code VolatileImage}
* @param transparency the specified transparency mode
- * @return a VolatileImage whose data layout and color
- * model is compatible with this GraphicsConfiguration.
+ * @return a {@code VolatileImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}.
* @throws IllegalArgumentException if the transparency is not a valid value
* @see Transparency#OPAQUE
* @see Transparency#BITMASK
@@ -248,20 +248,20 @@
/**
* Returns a {@link VolatileImage} with a data layout and color model
- * compatible with this GraphicsConfiguration, using
+ * compatible with this {@code GraphicsConfiguration}, using
* the specified image capabilities.
- * If the caps parameter is null, it is effectively ignored
+ * If the {@code caps} parameter is null, it is effectively ignored
* and this method will create a VolatileImage without regard to
- * ImageCapabilities constraints.
+ * {@code ImageCapabilities} constraints.
*
- * The returned VolatileImage has
+ * The returned {@code VolatileImage} has
* a layout and color model that is closest to this native device
* configuration and can therefore be optimally blitted to this
* device.
- * @return a VolatileImage whose data layout and color
- * model is compatible with this GraphicsConfiguration.
- * @param width the width of the returned VolatileImage
- * @param height the height of the returned VolatileImage
+ * @return a {@code VolatileImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}.
+ * @param width the width of the returned {@code VolatileImage}
+ * @param height the height of the returned {@code VolatileImage}
* @param caps the image capabilities
* @exception AWTException if the supplied image capabilities could not
* be met by this graphics configuration
@@ -276,22 +276,22 @@
/**
* Returns a {@link VolatileImage} with a data layout and color model
- * compatible with this GraphicsConfiguration, using
+ * compatible with this {@code GraphicsConfiguration}, using
* the specified image capabilities and transparency value.
- * If the caps parameter is null, it is effectively ignored
+ * If the {@code caps} parameter is null, it is effectively ignored
* and this method will create a VolatileImage without regard to
- * ImageCapabilities constraints.
+ * {@code ImageCapabilities} constraints.
*
- * The returned VolatileImage has
+ * The returned {@code VolatileImage} has
* a layout and color model that is closest to this native device
* configuration and can therefore be optimally blitted to this
* device.
- * @param width the width of the returned VolatileImage
- * @param height the height of the returned VolatileImage
+ * @param width the width of the returned {@code VolatileImage}
+ * @param height the height of the returned {@code VolatileImage}
* @param caps the image capabilities
* @param transparency the specified transparency mode
- * @return a VolatileImage whose data layout and color
- * model is compatible with this GraphicsConfiguration.
+ * @return a {@code VolatileImage} whose data layout and color
+ * model is compatible with this {@code GraphicsConfiguration}.
* @see Transparency#OPAQUE
* @see Transparency#BITMASK
* @see Transparency#TRANSLUCENT
@@ -317,19 +317,19 @@
/**
* Returns the {@link ColorModel} associated with this
- * GraphicsConfiguration.
- * @return a ColorModel object that is associated with
- * this GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
+ * @return a {@code ColorModel} object that is associated with
+ * this {@code GraphicsConfiguration}.
*/
public abstract ColorModel getColorModel();
/**
- * Returns the ColorModel associated with this
- * GraphicsConfiguration that supports the specified
+ * Returns the {@code ColorModel} associated with this
+ * {@code GraphicsConfiguration} that supports the specified
* transparency.
* @param transparency the specified transparency mode
- * @return a ColorModel object that is associated with
- * this GraphicsConfiguration and supports the
+ * @return a {@code ColorModel} object that is associated with
+ * this {@code GraphicsConfiguration} and supports the
* specified transparency or null if the transparency is not a valid
* value.
* @see Transparency#OPAQUE
@@ -340,30 +340,30 @@
/**
* Returns the default {@link AffineTransform} for this
- * GraphicsConfiguration. This
- * AffineTransform is typically the Identity transform
- * for most normal screens. The default AffineTransform
+ * {@code GraphicsConfiguration}. This
+ * {@code AffineTransform} is typically the Identity transform
+ * for most normal screens. The default {@code AffineTransform}
* maps coordinates onto the device such that 72 user space
* coordinate units measure approximately 1 inch in device
* space. The normalizing transform can be used to make
* this mapping more exact. Coordinates in the coordinate space
- * defined by the default AffineTransform for screen and
+ * defined by the default {@code AffineTransform} for screen and
* printer devices have the origin in the upper left-hand corner of
* the target region of the device, with X coordinates
* increasing to the right and Y coordinates increasing downwards.
* For image buffers not associated with a device, such as those not
- * created by createCompatibleImage,
- * this AffineTransform is the Identity transform.
- * @return the default AffineTransform for this
- * GraphicsConfiguration.
+ * created by {@code createCompatibleImage},
+ * this {@code AffineTransform} is the Identity transform.
+ * @return the default {@code AffineTransform} for this
+ * {@code GraphicsConfiguration}.
*/
public abstract AffineTransform getDefaultTransform();
/**
*
- * Returns a AffineTransform that can be concatenated
- * with the default AffineTransform
- * of a GraphicsConfiguration so that 72 units in user
+ * Returns a {@code AffineTransform} that can be concatenated
+ * with the default {@code AffineTransform}
+ * of a {@code GraphicsConfiguration} so that 72 units in user
* space equals 1 inch in device space.
* AffineTransform is identity,
+ * Note that sometimes this {@code AffineTransform} is identity,
* such as for printers or metafile output, and that this
- * AffineTransform is only as accurate as the information
+ * {@code AffineTransform} is only as accurate as the information
* supplied by the underlying system. For image buffers not
* associated with a device, such as those not created by
- * createCompatibleImage, this
- * AffineTransform is the Identity transform
+ * {@code createCompatibleImage}, this
+ * {@code AffineTransform} is the Identity transform
* since there is no valid distance measurement.
- * @return an AffineTransform to concatenate to the
- * default AffineTransform so that 72 units in user
+ * @return an {@code AffineTransform} to concatenate to the
+ * default {@code AffineTransform} so that 72 units in user
* space is mapped to 1 inch in device space.
*/
public abstract AffineTransform getNormalizingTransform();
/**
- * Returns the bounds of the GraphicsConfiguration
+ * Returns the bounds of the {@code GraphicsConfiguration}
* in the device coordinates. In a multi-screen environment
* with a virtual device, the bounds can have negative X
* or Y origins.
* @return the bounds of the area covered by this
- * GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
* @since 1.3
*/
public abstract Rectangle getBounds();
@@ -408,7 +408,7 @@
/**
* Returns the buffering capabilities of this
- * GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
* @return the buffering capabilities of this graphics
* configuration object
* @since 1.4
@@ -423,7 +423,7 @@
/**
* Returns the image capabilities of this
- * GraphicsConfiguration.
+ * {@code GraphicsConfiguration}.
* @return the image capabilities of this graphics
* configuration object
* @since 1.4
--- old/src/java.desktop/share/classes/java/awt/GraphicsDevice.java 2015-10-04 22:52:42.637274196 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsDevice.java 2015-10-04 22:52:42.449274205 +0400
@@ -33,19 +33,19 @@
import sun.awt.SunToolkit;
/**
- * The GraphicsDevice class describes the graphics devices
+ * The {@code GraphicsDevice} class describes the graphics devices
* that might be available in a particular graphics environment. These
* include screen and printer devices. Note that there can be many screens
* and many printers in an instance of {@link GraphicsEnvironment}. Each
* graphics device has one or more {@link GraphicsConfiguration} objects
* associated with it. These objects specify the different configurations
- * in which the GraphicsDevice can be used.
+ * in which the {@code GraphicsDevice} can be used.
* GraphicsConfiguration
+ * In a multi-screen environment, the {@code GraphicsConfiguration}
* objects can be used to render components on multiple screens. The
- * following code sample demonstrates how to create a JFrame
- * object for each GraphicsConfiguration on each screen
- * device in the GraphicsEnvironment:
+ * following code sample demonstrates how to create a {@code JFrame}
+ * object for each {@code GraphicsConfiguration} on each screen
+ * device in the {@code GraphicsEnvironment}:
* {@code
* GraphicsEnvironment ge = GraphicsEnvironment.
* getLocalGraphicsEnvironment();
@@ -142,8 +142,8 @@
}
/**
- * Returns the type of this GraphicsDevice.
- * @return the type of this GraphicsDevice, which can
+ * Returns the type of this {@code GraphicsDevice}.
+ * @return the type of this {@code GraphicsDevice}, which can
* either be TYPE_RASTER_SCREEN, TYPE_PRINTER or TYPE_IMAGE_BUFFER.
* @see #TYPE_RASTER_SCREEN
* @see #TYPE_PRINTER
@@ -153,52 +153,52 @@
/**
* Returns the identification string associated with this
- * GraphicsDevice.
+ * {@code GraphicsDevice}.
* GraphicsDevice in a GraphicsEnvironment.
- * This method returns a String identifying a
- * particular GraphicsDevice in the local
- * GraphicsEnvironment. Although there is
- * no public method to set this String, a programmer can
- * use the String for debugging purposes. Vendors of
+ * {@code GraphicsDevice} in a {@code GraphicsEnvironment}.
+ * This method returns a {@code String} identifying a
+ * particular {@code GraphicsDevice} in the local
+ * {@code GraphicsEnvironment}. Although there is
+ * no public method to set this {@code String}, a programmer can
+ * use the {@code String} for debugging purposes. Vendors of
* the Java™ Runtime Environment can
- * format the return value of the String. To determine
- * how to interpret the value of the String, contact the
+ * format the return value of the {@code String}. To determine
+ * how to interpret the value of the {@code String}, contact the
* vendor of your Java Runtime. To find out who the vendor is, from
* your program, call the
* {@link System#getProperty(String) getProperty} method of the
* System class with "java.vendor".
- * @return a String that is the identification
- * of this GraphicsDevice.
+ * @return a {@code String} that is the identification
+ * of this {@code GraphicsDevice}.
*/
public abstract String getIDstring();
/**
- * Returns all of the GraphicsConfiguration
- * objects associated with this GraphicsDevice.
- * @return an array of GraphicsConfiguration
+ * Returns all of the {@code GraphicsConfiguration}
+ * objects associated with this {@code GraphicsDevice}.
+ * @return an array of {@code GraphicsConfiguration}
* objects that are associated with this
- * GraphicsDevice.
+ * {@code GraphicsDevice}.
*/
public abstract GraphicsConfiguration[] getConfigurations();
/**
- * Returns the default GraphicsConfiguration
- * associated with this GraphicsDevice.
- * @return the default GraphicsConfiguration
- * of this GraphicsDevice.
+ * Returns the default {@code GraphicsConfiguration}
+ * associated with this {@code GraphicsDevice}.
+ * @return the default {@code GraphicsConfiguration}
+ * of this {@code GraphicsDevice}.
*/
public abstract GraphicsConfiguration getDefaultConfiguration();
/**
* Returns the "best" configuration possible that passes the
* criteria defined in the {@link GraphicsConfigTemplate}.
- * @param gct the GraphicsConfigTemplate object
- * used to obtain a valid GraphicsConfiguration
- * @return a GraphicsConfiguration that passes
+ * @param gct the {@code GraphicsConfigTemplate} object
+ * used to obtain a valid {@code GraphicsConfiguration}
+ * @return a {@code GraphicsConfiguration} that passes
* the criteria defined in the specified
- * GraphicsConfigTemplate.
+ * {@code GraphicsConfigTemplate}.
* @see GraphicsConfigTemplate
*/
public GraphicsConfiguration
@@ -208,12 +208,12 @@
}
/**
- * Returns true if this GraphicsDevice
+ * Returns {@code true} if this {@code GraphicsDevice}
* supports full-screen exclusive mode.
* If a SecurityManager is installed, its
- * checkPermission method will be called
- * with AWTPermission("fullScreenExclusive").
- * isFullScreenSupported returns true only if
+ * {@code checkPermission} method will be called
+ * with {@code AWTPermission("fullScreenExclusive")}.
+ * {@code isFullScreenSupported} returns true only if
* that permission is granted.
* @return whether full-screen exclusive mode is available for
* this graphics device
@@ -227,8 +227,8 @@
/**
* Enter full-screen mode, or return to windowed mode. The entered
* full-screen mode may be either exclusive or simulated. Exclusive
- * mode is only available if isFullScreenSupported
- * returns true.
+ * mode is only available if {@code isFullScreenSupported}
+ * returns {@code true}.
*
@@ -239,7 +239,7 @@
* will cause the existing full-screen window to
* return to windowed mode.
*
* Component.enableInputMethods(false) to make a component
+ * {@code Component.enableInputMethods(false)} to make a component
* a non-client of the input method framework.
* Window object representing the
+ * Returns the {@code Window} object representing the
* full-screen window if the device is in full-screen mode.
*
- * @return the full-screen window, or null if the device is
+ * @return the full-screen window, or {@code null} if the device is
* not in full-screen mode.
* @see #setFullScreenWindow(Window)
* @since 1.4
@@ -362,7 +362,7 @@
}
/**
- * Returns true if this GraphicsDevice
+ * Returns {@code true} if this {@code GraphicsDevice}
* supports low-level display changes.
* On some platforms low-level display changes may only be allowed in
* full-screen exclusive mode (i.e., if {@link #isFullScreenSupported()}
@@ -420,11 +420,11 @@
* DisplayMode
- * supplied is null, or is not available in the array returned
- * by getDisplayModes
+ * @exception IllegalArgumentException if the {@code DisplayMode}
+ * supplied is {@code null}, or is not available in the array returned
+ * by {@code getDisplayModes}
* @exception UnsupportedOperationException if
- * isDisplayChangeSupported returns false
+ * {@code isDisplayChangeSupported} returns {@code false}
* @see #getDisplayMode
* @see #getDisplayModes
* @see #isDisplayChangeSupported
@@ -436,7 +436,7 @@
/**
* Returns the current display mode of this
- * GraphicsDevice.
+ * {@code GraphicsDevice}.
* The returned display mode is allowed to have a refresh rate
* {@link DisplayMode#REFRESH_RATE_UNKNOWN} if it is indeterminate.
* Likewise, the returned display mode is allowed to have a bit depth
@@ -455,7 +455,7 @@
/**
* Returns all display modes available for this
- * GraphicsDevice.
+ * {@code GraphicsDevice}.
* The returned display modes are allowed to have a refresh rate
* {@link DisplayMode#REFRESH_RATE_UNKNOWN} if it is indeterminate.
* Likewise, the returned display modes are allowed to have a bit depth
--- old/src/java.desktop/share/classes/java/awt/GraphicsEnvironment.java 2015-10-04 22:52:43.165274173 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsEnvironment.java 2015-10-04 22:52:42.977274181 +0400
@@ -39,16 +39,16 @@
/**
*
- * The GraphicsEnvironment class describes the collection
+ * The {@code GraphicsEnvironment} class describes the collection
* of {@link GraphicsDevice} objects and {@link java.awt.Font} objects
* available to a Java(tm) application on a particular platform.
- * The resources in this GraphicsEnvironment might be local
- * or on a remote machine. GraphicsDevice objects can be
+ * The resources in this {@code GraphicsEnvironment} might be local
+ * or on a remote machine. {@code GraphicsDevice} objects can be
* screens, printers or image buffers and are the destination of
- * {@link Graphics2D} drawing methods. Each GraphicsDevice
+ * {@link Graphics2D} drawing methods. Each {@code GraphicsDevice}
* has a number of {@link GraphicsConfiguration} objects associated with
* it. These objects specify the different configurations in which the
- * GraphicsDevice can be used.
+ * {@code GraphicsDevice} can be used.
* @see GraphicsDevice
* @see GraphicsConfiguration
*/
@@ -74,8 +74,8 @@
}
/**
- * Returns the local GraphicsEnvironment.
- * @return the local GraphicsEnvironment
+ * Returns the local {@code GraphicsEnvironment}.
+ * @return the local {@code GraphicsEnvironment}
*/
public static synchronized GraphicsEnvironment getLocalGraphicsEnvironment() {
if (localEnv == null) {
@@ -132,8 +132,8 @@
* a HeadlessException is thrown from areas of the Toolkit
* and GraphicsEnvironment that are dependent on a display,
* keyboard, or mouse.
- * @return true if this environment cannot support
- * a display, keyboard, and mouse; false
+ * @return {@code true} if this environment cannot support
+ * a display, keyboard, and mouse; {@code false}
* otherwise
* @see java.awt.HeadlessException
* @since 1.4
@@ -209,11 +209,11 @@
/**
* Returns whether or not a display, keyboard, and mouse can be
* supported in this graphics environment. If this returns true,
- * HeadlessException will be thrown from areas of the
+ * {@code HeadlessException} will be thrown from areas of the
* graphics environment that are dependent on a display, keyboard, or
* mouse.
- * @return true if a display, keyboard, and mouse
- * can be supported in this environment; false
+ * @return {@code true} if a display, keyboard, and mouse
+ * can be supported in this environment; {@code false}
* otherwise
* @see java.awt.HeadlessException
* @see #isHeadless
@@ -226,9 +226,9 @@
}
/**
- * Returns an array of all of the screen GraphicsDevice
+ * Returns an array of all of the screen {@code GraphicsDevice}
* objects.
- * @return an array containing all the GraphicsDevice
+ * @return an array containing all the {@code GraphicsDevice}
* objects that represent screen devices
* @exception HeadlessException if isHeadless() returns true
* @see #isHeadless()
@@ -237,8 +237,8 @@
throws HeadlessException;
/**
- * Returns the default screen GraphicsDevice.
- * @return the GraphicsDevice that represents the
+ * Returns the default screen {@code GraphicsDevice}.
+ * @return the {@code GraphicsDevice} that represents the
* default screen device
* @exception HeadlessException if isHeadless() returns true
* @see #isHeadless()
@@ -247,35 +247,35 @@
throws HeadlessException;
/**
- * Returns a Graphics2D object for rendering into the
+ * Returns a {@code Graphics2D} object for rendering into the
* specified {@link BufferedImage}.
- * @param img the specified BufferedImage
- * @return a Graphics2D to be used for rendering into
- * the specified BufferedImage
- * @throws NullPointerException if img is null
+ * @param img the specified {@code BufferedImage}
+ * @return a {@code Graphics2D} to be used for rendering into
+ * the specified {@code BufferedImage}
+ * @throws NullPointerException if {@code img} is null
*/
public abstract Graphics2D createGraphics(BufferedImage img);
/**
* Returns an array containing a one-point size instance of all fonts
- * available in this GraphicsEnvironment. Typical usage
+ * available in this {@code GraphicsEnvironment}. Typical usage
* would be to allow a user to select a particular font. Then, the
* application can size the font and set various font attributes by
- * calling the deriveFont method on the chosen instance.
+ * calling the {@code deriveFont} method on the chosen instance.
* Font instance is used to render text.
- * If a font in this GraphicsEnvironment has multiple
+ * over which {@code Font} instance is used to render text.
+ * If a font in this {@code GraphicsEnvironment} has multiple
* programmable variations, only one
- * instance of that Font is returned in the array, and
+ * instance of that {@code Font} is returned in the array, and
* other variations must be derived by the application.
* Font array. The other variations
+ * returned in the {@code Font} array. The other variations
* must be derived by the application.
*
- * @return an array of Font objects
+ * @return an array of {@code Font} objects
* @see #getAvailableFontFamilyNames
* @see java.awt.Font
* @see java.awt.Font#deriveFont
@@ -286,8 +286,8 @@
/**
* Returns an array containing the names of all font families in this
- * GraphicsEnvironment localized for the default locale,
- * as returned by Locale.getDefault().
+ * {@code GraphicsEnvironment} localized for the default locale,
+ * as returned by {@code Locale.getDefault()}.
* String containing font family names
+ * @return an array of {@code String} containing font family names
* localized for the default locale, or a suitable alternative
* name if no name exists for this locale.
* @see #getAllFonts
@@ -307,7 +307,7 @@
/**
* Returns an array containing the names of all font families in this
- * GraphicsEnvironment localized for the specified locale.
+ * {@code GraphicsEnvironment} localized for the specified locale.
* null is equivalent to
- * specifying Locale.getDefault().
- * @return an array of String containing font family names
- * localized for the specified Locale, or a
+ * Specifying {@code null} is equivalent to
+ * specifying {@code Locale.getDefault()}.
+ * @return an array of {@code String} containing font family names
+ * localized for the specified {@code Locale}, or a
* suitable alternative name if no name exists for the specified locale.
* @see #getAllFonts
* @see java.awt.Font
@@ -330,24 +330,24 @@
public abstract String[] getAvailableFontFamilyNames(Locale l);
/**
- * Registers a created Fontin this
- * GraphicsEnvironment.
+ * Registers a created {@code Font} in this
+ * {@code GraphicsEnvironment}.
* A created font is one that was returned from calling
* {@link Font#createFont}, or derived from a created font by
* calling {@link Font#deriveFont}.
* After calling this method for such a font, it is available to
- * be used in constructing new Fonts by name or family name,
+ * be used in constructing new {@code Font}s by name or family name,
* and is enumerated by {@link #getAvailableFontFamilyNames} and
* {@link #getAllFonts} within the execution context of this
* application or applet. This means applets cannot register fonts in
* a way that they are visible to other applets.
* false are:
+ * return {@code false} are:
*
- *
*
* @param font the font to be registered
- * @return true if the Font.
- * Font already
- * in this GraphicsEnvironment. For example if the name
+ * font is successfully
- * registered in this GraphicsEnvironment.
- * @throws NullPointerException if font is null
+ * @return true if the {@code font} is successfully
+ * registered in this {@code GraphicsEnvironment}.
+ * @throws NullPointerException if {@code font} is null
* @since 1.6
*/
public boolean registerFont(Font font) {
@@ -444,8 +444,8 @@
* entire display area.
* GraphicsConfiguration.getBounds() and
- * Toolkit.getScreenInsets().
+ * {@code GraphicsConfiguration.getBounds()} and
+ * {@code Toolkit.getScreenInsets()}.
* @return the maximum bounds for centered Windows
*
* @exception HeadlessException if isHeadless() returns true
--- old/src/java.desktop/share/classes/java/awt/GridBagConstraints.java 2015-10-04 22:52:44.221274125 +0400
+++ new/src/java.desktop/share/classes/java/awt/GridBagConstraints.java 2015-10-04 22:52:43.961274137 +0400
@@ -25,9 +25,9 @@
package java.awt;
/**
- * The GridBagConstraints class specifies constraints
+ * The {@code GridBagConstraints} class specifies constraints
* for components that are laid out using the
- * GridBagLayout class.
+ * {@code GridBagLayout} class.
*
* @author Doug Stein
* @author Bill Spitzak (orignial NeWS & OLIT implementation)
@@ -38,9 +38,9 @@
/**
* Specifies that this component is the next-to-last component in its
- * column or row (gridwidth, gridheight),
+ * column or row ({@code gridwidth}, {@code gridheight}),
* or that this component be placed next to the previously added
- * component (gridx, gridy).
+ * component ({@code gridx}, {@code gridy}).
* @see java.awt.GridBagConstraints#gridwidth
* @see java.awt.GridBagConstraints#gridheight
* @see java.awt.GridBagConstraints#gridx
@@ -194,7 +194,7 @@
public static final int LAST_LINE_END = 26;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally centered and
* vertically aligned along the baseline of the prevailing row.
* If the component does not have a baseline it will be vertically
@@ -205,7 +205,7 @@
public static final int BASELINE = 0x100;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally placed along the
* leading edge. For components with a left-to-right orientation,
* the leading edge is the left edge. Vertically the component is
@@ -218,7 +218,7 @@
public static final int BASELINE_LEADING = 0x200;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally placed along the
* trailing edge. For components with a left-to-right
* orientation, the trailing edge is the right edge. Vertically
@@ -231,7 +231,7 @@
public static final int BASELINE_TRAILING = 0x300;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally centered. Vertically
* the component is positioned so that its bottom edge touches
* the baseline of the starting row. If the starting row does not
@@ -242,7 +242,7 @@
public static final int ABOVE_BASELINE = 0x400;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally placed along the
* leading edge. For components with a left-to-right orientation,
* the leading edge is the left edge. Vertically the component is
@@ -255,7 +255,7 @@
public static final int ABOVE_BASELINE_LEADING = 0x500;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally placed along the
* trailing edge. For components with a left-to-right
* orientation, the trailing edge is the right edge. Vertically
@@ -268,7 +268,7 @@
public static final int ABOVE_BASELINE_TRAILING = 0x600;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally centered. Vertically
* the component is positioned so that its top edge touches the
* baseline of the starting row. If the starting row does not
@@ -279,7 +279,7 @@
public static final int BELOW_BASELINE = 0x700;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally placed along the
* leading edge. For components with a left-to-right orientation,
* the leading edge is the left edge. Vertically the component is
@@ -292,7 +292,7 @@
public static final int BELOW_BASELINE_LEADING = 0x800;
/**
- * Possible value for the anchor field. Specifies
+ * Possible value for the {@code anchor} field. Specifies
* that the component should be horizontally placed along the
* trailing edge. For components with a left-to-right
* orientation, the trailing edge is the right edge. Vertically
@@ -306,17 +306,17 @@
/**
* Specifies the cell containing the leading edge of the component's
- * display area, where the first cell in a row has gridx=0.
+ * display area, where the first cell in a row has {@code gridx=0}.
* The leading edge of a component's display area is its left edge for
* a horizontal, left-to-right container and its right edge for a
* horizontal, right-to-left container.
* The value
- * RELATIVE specifies that the component be placed
+ * {@code RELATIVE} specifies that the component be placed
* immediately following the component that was added to the container
* just before this component was added.
* RELATIVE.
- * gridx should be a non-negative value.
+ * The default value is {@code RELATIVE}.
+ * {@code gridx} should be a non-negative value.
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#gridy
@@ -326,13 +326,13 @@
/**
* Specifies the cell at the top of the component's display area,
- * where the topmost cell has gridy=0. The value
- * RELATIVE specifies that the component be placed just
+ * where the topmost cell has {@code gridy=0}. The value
+ * {@code RELATIVE} specifies that the component be placed just
* below the component that was added to the container just before
* this component was added.
* RELATIVE.
- * gridy should be a non-negative value.
+ * The default value is {@code RELATIVE}.
+ * {@code gridy} should be a non-negative value.
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#gridx
@@ -343,14 +343,14 @@
* Specifies the number of cells in a row for the component's
* display area.
* REMAINDER to specify that the component's
- * display area will be from gridx to the last
+ * Use {@code REMAINDER} to specify that the component's
+ * display area will be from {@code gridx} to the last
* cell in the row.
- * Use RELATIVE to specify that the component's
- * display area will be from gridx to the next
+ * Use {@code RELATIVE} to specify that the component's
+ * display area will be from {@code gridx} to the next
* to the last one in its row.
* gridwidth should be non-negative and the default
+ * {@code gridwidth} should be non-negative and the default
* value is 1.
* @serial
* @see #clone()
@@ -362,14 +362,14 @@
* Specifies the number of cells in a column for the component's
* display area.
* REMAINDER to specify that the component's
- * display area will be from gridy to the last
+ * Use {@code REMAINDER} to specify that the component's
+ * display area will be from {@code gridy} to the last
* cell in the column.
- * Use RELATIVE to specify that the component's
- * display area will be from gridy to the next
+ * Use {@code RELATIVE} to specify that the component's
+ * display area will be from {@code gridy} to the next
* to the last one in its column.
* gridheight should be a non-negative value and the
+ * {@code gridheight} should be a non-negative value and the
* default value is 1.
* @serial
* @see #clone()
@@ -381,7 +381,7 @@
* Specifies how to distribute extra horizontal space.
* weightx of all the components in a
+ * be the maximum {@code weightx} of all the components in a
* column. If the resulting layout is smaller horizontally than the area
* it needs to fill, the extra space is distributed to each column in
* proportion to its weight. A column that has a weight of zero receives
@@ -390,8 +390,8 @@
* If all the weights are zero, all the extra space appears between
* the grids of the cell and the left and right edges.
* 0.
- * weightx should be a non-negative value.
+ * The default value of this field is {@code 0}.
+ * {@code weightx} should be a non-negative value.
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#weighty
@@ -402,7 +402,7 @@
* Specifies how to distribute extra vertical space.
* weighty of all the components in a row.
+ * the maximum {@code weighty} of all the components in a row.
* If the resulting layout is smaller vertically than the area it
* needs to fill, the extra space is distributed to each row in
* proportion to its weight. A row that has a weight of zero receives no
@@ -411,8 +411,8 @@
* If all the weights are zero, all the extra space appears between
* the grids of the cell and the top and bottom edges.
* 0.
- * weighty should be a non-negative value.
+ * The default value of this field is {@code 0}.
+ * {@code weighty} should be a non-negative value.
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#weightx
@@ -429,22 +429,22 @@
* orientation property, baseline relative values are interpreted
* relative to the baseline and absolute values are not. The
* absolute values are:
- * CENTER, NORTH, NORTHEAST,
- * EAST, SOUTHEAST, SOUTH,
- * SOUTHWEST, WEST, and NORTHWEST.
- * The orientation relative values are: PAGE_START,
- * PAGE_END,
- * LINE_START, LINE_END,
- * FIRST_LINE_START, FIRST_LINE_END,
- * LAST_LINE_START and LAST_LINE_END. The
+ * {@code CENTER}, {@code NORTH}, {@code NORTHEAST},
+ * {@code EAST}, {@code SOUTHEAST}, {@code SOUTH},
+ * {@code SOUTHWEST}, {@code WEST}, and {@code NORTHWEST}.
+ * The orientation relative values are: {@code PAGE_START},
+ * {@code PAGE_END},
+ * {@code LINE_START}, {@code LINE_END},
+ * {@code FIRST_LINE_START}, {@code FIRST_LINE_END},
+ * {@code LAST_LINE_START} and {@code LAST_LINE_END}. The
* baseline relative values are:
- * BASELINE, BASELINE_LEADING,
- * BASELINE_TRAILING,
- * ABOVE_BASELINE, ABOVE_BASELINE_LEADING,
- * ABOVE_BASELINE_TRAILING,
- * BELOW_BASELINE, BELOW_BASELINE_LEADING,
- * and BELOW_BASELINE_TRAILING.
- * The default value is CENTER.
+ * {@code BASELINE}, {@code BASELINE_LEADING},
+ * {@code BASELINE_TRAILING},
+ * {@code ABOVE_BASELINE}, {@code ABOVE_BASELINE_LEADING},
+ * {@code ABOVE_BASELINE_TRAILING},
+ * {@code BELOW_BASELINE}, {@code BELOW_BASELINE_LEADING},
+ * and {@code BELOW_BASELINE_TRAILING}.
+ * The default value is {@code CENTER}.
* @serial
* @see #clone()
* @see java.awt.ComponentOrientation
@@ -456,23 +456,23 @@
* than the component's requested size. It determines whether to
* resize the component, and if so, how.
* fill:
+ * The following values are valid for {@code fill}:
*
*
*
* NONE: Do not resize the component.
+ * {@code NONE}: Do not resize the component.
* HORIZONTAL: Make the component wide enough to fill
+ * {@code HORIZONTAL}: Make the component wide enough to fill
* its display area horizontally, but do not change its height.
* VERTICAL: Make the component tall enough to fill its
+ * {@code VERTICAL}: Make the component tall enough to fill its
* display area vertically, but do not change its width.
* BOTH: Make the component fill its display area
+ * {@code BOTH}: Make the component fill its display area
* entirely.
* NONE.
+ * The default value is {@code NONE}.
* @serial
* @see #clone()
*/
@@ -483,7 +483,7 @@
* minimum amount of space between the component and the edges of its
* display area.
* new Insets(0, 0, 0, 0).
+ * The default value is {@code new Insets(0, 0, 0, 0)}.
* @serial
* @see #clone()
*/
@@ -493,9 +493,9 @@
* This field specifies the internal padding of the component, how much
* space to add to the minimum width of the component. The width of
* the component is at least its minimum width plus
- * ipadx pixels.
+ * {@code ipadx} pixels.
* 0.
+ * The default value is {@code 0}.
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#ipady
@@ -506,7 +506,7 @@
* This field specifies the internal padding, that is, how much
* space to add to the minimum height of the component. The height of
* the component is at least its minimum height plus
- * ipady pixels.
+ * {@code ipady} pixels.
* ipady, where the default will be 0.
+ * {@code ipady}, where the default will be 0.
* @serial
* @see #ipady
*/
int minWidth;
/**
* The minimum height of the component. It is used to calculate
- * ipadx, where the default will be 0.
+ * {@code ipadx}, where the default will be 0.
* @serial
* @see #ipadx
*/
@@ -571,7 +571,7 @@
private static final long serialVersionUID = -1000070633030801713L;
/**
- * Creates a GridBagConstraint object with
+ * Creates a {@code GridBagConstraint} object with
* all of its fields set to their default value.
*/
public GridBagConstraints () {
@@ -591,7 +591,7 @@
}
/**
- * Creates a GridBagConstraints object with
+ * Creates a {@code GridBagConstraints} object with
* all of its fields set to the passed-in arguments.
*
* Note: Because the use of this constructor hinders readability
--- old/src/java.desktop/share/classes/java/awt/GridBagLayout.java 2015-10-04 22:52:44.773274100 +0400
+++ new/src/java.desktop/share/classes/java/awt/GridBagLayout.java 2015-10-04 22:52:44.581274109 +0400
@@ -28,18 +28,18 @@
import java.util.Arrays;
/**
- * The GridBagLayout class is a flexible layout
+ * The {@code GridBagLayout} class is a flexible layout
* manager that aligns components vertically, horizontally or along their
* baseline without requiring that the components be of the same size.
- * Each GridBagLayout object maintains a dynamic,
+ * Each {@code GridBagLayout} object maintains a dynamic,
* rectangular grid of cells, with each component occupying
* one or more cells, called its display area.
* GridBagLayout is associated with
+ * Each component managed by a {@code GridBagLayout} is associated with
* an instance of {@link GridBagConstraints}. The constraints object
* specifies where a component's display area should be located on the grid
* and how the component should be positioned within its display area. In
- * addition to its constraints object, the GridBagLayout also
+ * addition to its constraints object, the {@code GridBagLayout} also
* considers each component's minimum and preferred sizes in order to
* determine a component's size.
* GridBagConstraints objects that are associated
- * with its components. You customize a GridBagConstraints
+ * of the {@code GridBagConstraints} objects that are associated
+ * with its components. You customize a {@code GridBagConstraints}
* object by setting one or more of its instance variables:
*
*
@@ -65,51 +65,51 @@
*
* gridy = 0. For horizontal left-to-right layout,
* a component's leading corner is its upper left. For horizontal
* right-to-left layout, a component's leading corner is its upper right.
- * Use GridBagConstraints.RELATIVE (the default value)
+ * Use {@code GridBagConstraints.RELATIVE} (the default value)
* to specify that the component be placed immediately following
- * (along the x axis for gridx or the y axis for
- * gridy) the component that was added to the container
+ * (along the x axis for {@code gridx} or the y axis for
+ * {@code gridy}) the component that was added to the container
* just before this component was added.
* gridwidth)
- * or column (for gridheight)
+ * GridBagConstraints.REMAINDER to specify
- * that the component's display area will be from gridx
- * to the last cell in the row (for gridwidth)
- * or from gridy to the last cell in the column
- * (for gridheight).
- *
- * Use GridBagConstraints.RELATIVE to specify
- * that the component's display area will be from gridx
- * to the next to the last cell in its row (for gridwidth
- * or from gridy to the next to the last cell in its
- * column (for gridheight).
+ * Use {@code GridBagConstraints.REMAINDER} to specify
+ * that the component's display area will be from {@code gridx}
+ * to the last cell in the row (for {@code gridwidth})
+ * or from {@code gridy} to the last cell in the column
+ * (for {@code gridheight}).
+ *
+ * Use {@code GridBagConstraints.RELATIVE} to specify
+ * that the component's display area will be from {@code gridx}
+ * to the next to the last cell in its row (for {@code gridwidth}
+ * or from {@code gridy} to the next to the last cell in its
+ * column (for {@code gridheight}).
*
* GridBagConstraints.NONE (the default),
- * GridBagConstraints.HORIZONTAL
+ * {@code GridBagConstraints.NONE} (the default),
+ * {@code GridBagConstraints.HORIZONTAL}
* (make the component wide enough to fill its display area
* horizontally, but don't change its height),
- * GridBagConstraints.VERTICAL
+ * {@code GridBagConstraints.VERTICAL}
* (make the component tall enough to fill its display area
* vertically, but don't change its width), and
- * GridBagConstraints.BOTH
+ * {@code GridBagConstraints.BOTH}
* (make the component fill its display area entirely).
* ipadx pixels. Similarly, the height of
+ * plus {@code ipadx} pixels. Similarly, the height of
* the component will be at least the minimum height plus
- * ipady pixels.
+ * {@code ipady} pixels.
* ComponentOrientation property while absolute values
+ * {@code ComponentOrientation} property while absolute values
* are not. Baseline relative values are calculated relative to the
* baseline. Valid values are:
*
@@ -132,40 +132,40 @@
*
*
@@ -175,10 +175,10 @@
*
*
*
- *
* GridBagConstraints.NORTHGridBagConstraints.SOUTHGridBagConstraints.WESTGridBagConstraints.EASTGridBagConstraints.NORTHWESTGridBagConstraints.NORTHEASTGridBagConstraints.SOUTHWESTGridBagConstraints.SOUTHEASTGridBagConstraints.CENTER (the default)
*
*
- *
* GridBagConstraints.PAGE_STARTGridBagConstraints.PAGE_ENDGridBagConstraints.LINE_STARTGridBagConstraints.LINE_ENDGridBagConstraints.FIRST_LINE_STARTGridBagConstraints.FIRST_LINE_ENDGridBagConstraints.LAST_LINE_STARTGridBagConstraints.LAST_LINE_END
*
*
- *
* GridBagConstraints.BASELINEGridBagConstraints.BASELINE_LEADINGGridBagConstraints.BASELINE_TRAILINGGridBagConstraints.ABOVE_BASELINEGridBagConstraints.ABOVE_BASELINE_LEADINGGridBagConstraints.ABOVE_BASELINE_TRAILINGGridBagConstraints.BELOW_BASELINEGridBagConstraints.BELOW_BASELINE_LEADINGGridBagConstraints.BELOW_BASELINE_TRAILINGweightx) and column (weighty),
+ * in a row ({@code weightx}) and column ({@code weighty}),
* all the components clump together in the center of their container.
* This is because when the weight is zero (the default),
- * the GridBagLayout object puts any extra space
+ * the {@code GridBagLayout} object puts any extra space
* between its grid of cells and the edges of the container.
*
* Because the second button and the panel share the same prevailing row,
* they are both aligned along their baseline.
@@ -221,7 +221,7 @@
* value. How components change is dictated by how the baseline of the
* prevailing row changes. The baseline is anchored to the
* bottom of the display area if any components with the same prevailing row
- * have a baseline-resize behavior of CONSTANT_DESCENT and has
- * an anchor of BASELINE. As the baseline-resize behavior
- * is CONSTANT_DESCENT the prevailing row for the panel is
+ * has a baseline-resize behavior of {@code CONSTANT_DESCENT} and has
+ * an anchor of {@code BASELINE}. As the baseline-resize behavior
+ * is {@code CONSTANT_DESCENT} the prevailing row for the panel is
* row 1.
* CENTER_OFFSET and an anchor of BASELINE.
+ * {@code CENTER_OFFSET} and an anchor of {@code BASELINE}.
* CONSTANT_DESCENT,
+ * have a baseline-resize behavior of {@code CONSTANT_DESCENT},
* otherwise the baseline is anchored to the top of the display area.
* The following rules dictate the resize behavior:
*
@@ -233,12 +233,12 @@
* only grow as high as the difference between the display height and the
* baseline.
*
* If you position a component along the baseline, but the
@@ -266,9 +266,9 @@
*
*
* OTHER are only resized if
+ * baseline-resize behavior of {@code OTHER} are only resized if
* the baseline at the resized size fits within the display area. If
* the baseline is such that it does not fit within the display area
* the component is not resized.
* OTHER
+ * baseline-resize behavior of {@code OTHER}
* can only grow as tall as {@code display height - baseline + baseline of component}.
* fill field
- * of its associated GridBagConstraints object
- * set to GridBagConstraints.BOTH.
+ * Each of the ten components has the {@code fill} field
+ * of its associated {@code GridBagConstraints} object
+ * set to {@code GridBagConstraints.BOTH}.
* In addition, the components have the following non-default constraints:
*
*
@@ -387,8 +387,8 @@
/**
* This hashtable maintains the association between
* a component and its gridbag constraints.
- * The Keys in
comptable are the components and the
- * values are the instances of GridBagConstraints.
+ * The Keys in {@code comptable} are the components and the
+ * values are the instances of {@code GridBagConstraints}.
*
* @serial
* @see java.awt.GridBagConstraints
@@ -400,7 +400,7 @@
* containing the default values, so if a component
* does not have gridbag constraints associated with
* it, then the component will be assigned a
- * copy of the defaultConstraints.
+ * copy of the {@code defaultConstraints}.
*
* @serial
* @see #getConstraints(Component)
@@ -414,7 +414,7 @@
* for the gridbag. The information in this field
* is based on the most recent validation of the
* gridbag.
- * If layoutInfo is null
+ * If {@code layoutInfo} is {@code null}
* this indicates that there are no components in
* the gridbag or if there are components, they have
* not yet been validated.
@@ -426,7 +426,7 @@
/**
* This field holds the overrides to the column minimum
- * width. If this field is non-null the values are
+ * width. If this field is non-{@code null} the values are
* applied to the gridbag after all of the minimum columns
* widths have been calculated.
* If columnWidths has more elements than the number of
@@ -440,12 +440,12 @@
/**
* This field holds the overrides to the row minimum
- * heights. If this field is non-null the values are
+ * heights. If this field is non-{@code null} the values are
* applied to the gridbag after all of the minimum row
* heights have been calculated.
- * If rowHeights has more elements than the number of
+ * If {@code rowHeights} has more elements than the number of
* rows, rows are added to the gridbag to match
- * the number of elements in rowHeights.
+ * the number of elements in {@code rowHeights}.
*
* @serial
* @see #getLayoutDimensions()
@@ -454,12 +454,12 @@
/**
* This field holds the overrides to the column weights.
- * If this field is non-null the values are
+ * If this field is non-{@code null} the values are
* applied to the gridbag after all of the columns
* weights have been calculated.
- * If columnWeights[i] > weight for column i, then
- * column i is assigned the weight in columnWeights[i].
- * If columnWeights has more elements than the number
+ * If {@code columnWeights[i] >} weight for column i, then
+ * column i is assigned the weight in {@code columnWeights[i]}.
+ * If {@code columnWeights} has more elements than the number
* of columns, the excess elements are ignored - they do
* not cause more columns to be created.
*
@@ -469,12 +469,12 @@
/**
* This field holds the overrides to the row weights.
- * If this field is non-null the values are
+ * If this field is non-{@code null} the values are
* applied to the gridbag after all of the rows
* weights have been calculated.
- * If rowWeights[i] > weight for row i, then
- * row i is assigned the weight in rowWeights[i].
- * If rowWeights has more elements than the number
+ * If {@code rowWeights[i] > } weight for row i, then
+ * row i is assigned the weight in {@code rowWeights[i]}.
+ * If {@code rowWeights} has more elements than the number
* of rows, the excess elements are ignored - they do
* not cause more rows to be created.
*
@@ -484,7 +484,7 @@
/**
* The component being positioned. This is set before calling into
- * adjustForGravity.
+ * {@code adjustForGravity}.
*/
private Component componentAdjusting;
@@ -507,7 +507,7 @@
/**
* Gets the constraints for the specified component. A copy of
- * the actual GridBagConstraints object is returned.
+ * the actual {@code GridBagConstraints} object is returned.
* @param comp the component to be queried
* @return the constraint for the specified component in this
* grid bag layout; a copy of the actual constraint
@@ -525,12 +525,12 @@
/**
* Retrieves the constraints for the specified component.
* The return value is not a copy, but is the actual
- * GridBagConstraints object used by the layout mechanism.
+ * {@code GridBagConstraints} object used by the layout mechanism.
* comp is not in the GridBagLayout,
- * a set of default GridBagConstraints are returned.
- * A comp value of null is invalid
- * and returns null.
+ * If {@code comp} is not in the {@code GridBagLayout},
+ * a set of default {@code GridBagConstraints} are returned.
+ * A {@code comp} value of {@code null} is invalid
+ * and returns {@code null}.
*
* @param comp the component to be queried
* @return the constraints for the specified component
@@ -556,7 +556,7 @@
* Determines the origin of the layout area, in the graphics coordinate
* space of the target container. This value represents the pixel
* coordinates of the top-left corner of the layout area regardless of
- * the ComponentOrientation value of the container. This
+ * the {@code ComponentOrientation} value of the container. This
* is distinct from the grid origin given by the cell coordinates (0,0).
* Most applications do not call this method directly.
* @return the graphics origin of the cell in the top-left
@@ -631,16 +631,16 @@
* (x, y) point lies
* outside the grid, the following rules are used.
- * The column index is returned as zero if x lies to the
+ * The column index is returned as zero if {@code x} lies to the
* left of the layout for a left-to-right container or to the right of
* the layout for a right-to-left container. The column index is returned
- * as the number of columns if x lies
+ * as the number of columns if {@code x} lies
* to the right of the layout in a left-to-right container or to the left
* in a right-to-left container.
- * The row index is returned as zero if y lies above the
- * layout, and as the number of rows if y lies
+ * The row index is returned as zero if {@code y} lies above the
+ * layout, and as the number of rows if {@code y} lies
* below the layout. The orientation of a container is determined by its
- * ComponentOrientation property.
+ * {@code ComponentOrientation} property.
* @param x the x coordinate of a point
* @param y the y coordinate of a point
* @return an ordered pair of indexes that indicate which cell
@@ -692,14 +692,14 @@
/**
* Adds the specified component to the layout, using the specified
- * constraints object. Note that constraints
+ * {@code constraints} object. Note that constraints
* are mutable and are, therefore, cloned when cached.
*
* @param comp the component to be added
* @param constraints an object that determines how
* the component is added to the layout
- * @exception IllegalArgumentException if constraints
- * is not a GridBagConstraint
+ * @exception IllegalArgumentException if {@code constraints}
+ * is not a {@code GridBagConstraint}
*/
public void addLayoutComponent(Component comp, Object constraints) {
if (constraints instanceof GridBagConstraints) {
@@ -722,14 +722,14 @@
}
/**
- * Determines the preferred size of the parent
+ * Determines the preferred size of the {@code parent}
* container using this grid bag layout.
* parent
+ * @return the preferred size of the {@code parent}
* container
*/
public Dimension preferredLayoutSize(Container parent) {
@@ -738,13 +738,13 @@
}
/**
- * Determines the minimum size of the parent container
+ * Determines the minimum size of the {@code parent} container
* using this grid bag layout.
* parent container
+ * @return the minimum size of the {@code parent} container
*/
public Dimension minimumLayoutSize(Container parent) {
GridBagLayoutInfo info = getLayoutInfo(parent, MINSIZE);
@@ -771,7 +771,7 @@
* where 0 represents alignment along the origin, 1 is aligned
* the furthest away from the origin, 0.5 is centered, etc.
*
- * @return the value 0.5f to indicate centered
+ * @return the value {@code 0.5f} to indicate centered
*/
public float getLayoutAlignmentX(Container parent) {
return 0.5f;
@@ -784,7 +784,7 @@
* where 0 represents alignment along the origin, 1 is aligned
* the furthest away from the origin, 0.5 is centered, etc.
*
- * @return the value 0.5f to indicate centered
+ * @return the value {@code 0.5f} to indicate centered
*/
public float getLayoutAlignmentY(Container parent) {
return 0.5f;
@@ -800,7 +800,7 @@
/**
* Lays out the specified container using this grid bag layout.
* This method reshapes components in the specified container in
- * order to satisfy the constraints of this GridBagLayout
+ * order to satisfy the constraints of this {@code GridBagLayout}
* object.
* GridBagLayoutInfo for the
+ * Fills in an instance of {@code GridBagLayoutInfo} for the
* current set of managed children. This requires three passes through the
* set of children:
*
@@ -904,12 +904,12 @@
* first encountered (so subsequent loops don't need to ask again).
* GridBagLayout.
+ * {@code GridBagLayout}.
*
* @param parent the layout container
- * @param sizeflag either PREFERREDSIZE or
- * MINSIZE
- * @return the GridBagLayoutInfo for the set of children
+ * @param sizeflag either {@code PREFERREDSIZE} or
+ * {@code MINSIZE}
+ * @return the {@code GridBagLayoutInfo} for the set of children
* @since 1.4
*/
protected GridBagLayoutInfo getLayoutInfo(Container parent, int sizeflag) {
@@ -1605,10 +1605,10 @@
* Adjusts the x, y, width, and height fields to the correct
* values depending on the constraint geometry and pads.
* This method should only be used internally by
- * GridBagLayout.
+ * {@code GridBagLayout}.
*
* @param constraints the constraints to be applied
- * @param r the Rectangle to be adjusted
+ * @param r the {@code Rectangle} to be adjusted
* @since 1.4
*/
protected void adjustForGravity(GridBagConstraints constraints,
@@ -1624,7 +1624,7 @@
* compatibility only; new code should call {@link
* #adjustForGravity(java.awt.GridBagConstraints, java.awt.Rectangle)
* adjustForGravity} instead.
- * This method is the same as adjustForGravity
+ * This method is the same as {@code adjustForGravity}
*
* @param constraints the constraints to be applied
* @param r the {@code Rectangle} to be adjusted
@@ -1987,13 +1987,13 @@
/**
* Figures out the minimum size of the
- * master based on the information from getLayoutInfo.
+ * master based on the information from {@code getLayoutInfo}.
* This method should only be used internally by
- * GridBagLayout.
+ * {@code GridBagLayout}.
*
* @param parent the layout container
* @param info the layout info for this parent
- * @return a Dimension object containing the
+ * @return a {@code Dimension} object containing the
* minimum size
* @since 1.4
*/
@@ -2005,11 +2005,11 @@
* This method is obsolete and supplied for backwards
* compatibility only; new code should call {@link
* #getMinSize(java.awt.Container, GridBagLayoutInfo) getMinSize} instead.
- * This method is the same as getMinSize
+ * This method is the same as {@code getMinSize}
*
* @param parent the layout container
* @param info the layout info for this parent
- * @return a Dimension object containing the
+ * @return a {@code Dimension} object containing the
* minimum size
*/
protected Dimension GetMinSize(Container parent, GridBagLayoutInfo info) {
@@ -2035,7 +2035,7 @@
/**
* Lays out the grid.
* This method should only be used internally by
- * GridBagLayout.
+ * {@code GridBagLayout}.
*
* @param parent the layout container
* @since 1.4
@@ -2048,7 +2048,7 @@
* This method is obsolete and supplied for backwards
* compatibility only; new code should call {@link
* #arrangeGrid(Container) arrangeGrid} instead.
- * This method is the same as arrangeGrid
+ * This method is the same as {@code arrangeGrid}
*
* @param parent the layout container
*/
--- old/src/java.desktop/share/classes/java/awt/Image.java 2015-10-04 22:52:45.333274075 +0400
+++ new/src/java.desktop/share/classes/java/awt/Image.java 2015-10-04 22:52:45.145274084 +0400
@@ -35,7 +35,7 @@
/**
- * The abstract class Image is the superclass of all
+ * The abstract class {@code Image} is the superclass of all
* classes that represent graphical images. The image must be
* obtained in a platform-specific manner.
*
@@ -57,17 +57,17 @@
* Priority for accelerating this image. Subclasses are free to
* set different default priorities and applications are free to
* set the priority for specific images via the
- * setAccelerationPriority(float) method.
+ * {@code setAccelerationPriority(float)} method.
* @since 1.5
*/
protected float accelerationPriority = .5f;
/**
* Determines the width of the image. If the width is not yet known,
- * this method returns -1 and the specified
- * ImageObserver object is notified later.
+ * this method returns {@code -1} and the specified
+ * {@code ImageObserver} object is notified later.
* @param observer an object waiting for the image to be loaded.
- * @return the width of this image, or -1
+ * @return the width of this image, or {@code -1}
* if the width is not yet known.
* @see java.awt.Image#getHeight
* @see java.awt.image.ImageObserver
@@ -76,10 +76,10 @@
/**
* Determines the height of the image. If the height is not yet known,
- * this method returns -1 and the specified
- * ImageObserver object is notified later.
+ * this method returns {@code -1} and the specified
+ * {@code ImageObserver} object is notified later.
* @param observer an object waiting for the image to be loaded.
- * @return the height of this image, or -1
+ * @return the height of this image, or {@code -1}
* if the height is not yet known.
* @see java.awt.Image#getWidth
* @see java.awt.image.ImageObserver
@@ -112,13 +112,13 @@
* UndefinedProperty object.
+ * method returns the {@code UndefinedProperty} object.
* null, and the ImageObserver
+ * returns {@code null}, and the {@code ImageObserver}
* object is notified later.
* "comment" should be used to store
+ * The property name {@code "comment"} should be used to store
* an optional comment which can be presented to the application as a
* description of the image, its source, or its author.
* @param name a property name.
@@ -131,25 +131,25 @@
public abstract Object getProperty(String name, ImageObserver observer);
/**
- * The UndefinedProperty object should be returned whenever a
+ * The {@code UndefinedProperty} object should be returned whenever a
* property which was not defined for a particular image is fetched.
*/
public static final Object UndefinedProperty = new Object();
/**
* Creates a scaled version of this image.
- * A new Image object is returned which will render
- * the image at the specified width and
- * height by default. The new Image object
+ * A new {@code Image} object is returned which will render
+ * the image at the specified {@code width} and
+ * {@code height} by default. The new {@code Image} object
* may be loaded asynchronously even if the original source image
* has already been loaded completely.
*
* width
- * or height is a negative number then a value is
+ * If either {@code width}
+ * or {@code height} is a negative number then a value is
* substituted to maintain the aspect ratio of the original image
- * dimensions. If both width and height
+ * dimensions. If both {@code width} and {@code height}
* are negative, then the original image dimensions are used.
*
* @param width the width to which to scale the image.
@@ -157,8 +157,8 @@
* @param hints flags to indicate the type of algorithm to use
* for image resampling.
* @return a scaled version of the image.
- * @exception IllegalArgumentException if width
- * or height is zero.
+ * @exception IllegalArgumentException if {@code width}
+ * or {@code height} is zero.
* @see java.awt.Image#SCALE_DEFAULT
* @see java.awt.Image#SCALE_FAST
* @see java.awt.Image#SCALE_SMOOTH
@@ -200,8 +200,8 @@
/**
* Use the image scaling algorithm embodied in the
- * ReplicateScaleFilter class.
- * The Image object is free to substitute a different filter
+ * {@code ReplicateScaleFilter} class.
+ * The {@code Image} object is free to substitute a different filter
* that performs the same algorithm yet integrates more efficiently
* into the imaging infrastructure supplied by the toolkit.
* @see java.awt.image.ReplicateScaleFilter
@@ -274,11 +274,11 @@
* size on the given GraphicsConfiguration, so although the object
* may be acceleratable in general, it
* does not have that capability on this GraphicsConfiguration.
- * @param gc a GraphicsConfiguration object. A value of null
+ * @param gc a {@code GraphicsConfiguration} object. A value of null
* for this parameter will result in getting the image capabilities
- * for the default GraphicsConfiguration.
- * @return an ImageCapabilities object that contains
- * the capabilities of this Image on the specified
+ * for the default {@code GraphicsConfiguration}.
+ * @return an {@code ImageCapabilities} object that contains
+ * the capabilities of this {@code Image} on the specified
* GraphicsConfiguration.
* @see java.awt.image.VolatileImage#getCapabilities()
* VolatileImage.getCapabilities()
@@ -313,7 +313,7 @@
* means that this Image should never be accelerated. Other values
* are used simply to determine acceleration priority relative to other
* Images.
- * @throws IllegalArgumentException if priority is less
+ * @throws IllegalArgumentException if {@code priority} is less
* than zero or greater than 1.
* @since 1.5
*/
--- old/src/java.desktop/share/classes/java/awt/ImageCapabilities.java 2015-10-04 22:52:45.861274052 +0400
+++ new/src/java.desktop/share/classes/java/awt/ImageCapabilities.java 2015-10-04 22:52:45.673274060 +0400
@@ -43,8 +43,8 @@
}
/**
- * Returns true if the object whose capabilities are
- * encapsulated in this ImageCapabilities can be or is
+ * Returns {@code true} if the object whose capabilities are
+ * encapsulated in this {@code ImageCapabilities} can be or is
* accelerated.
* @return whether or not an image can be, or is, accelerated. There are
* various platform-specific ways to accelerate an image, including
@@ -56,8 +56,8 @@
}
/**
- * Returns true if the VolatileImage
- * described by this ImageCapabilities can lose
+ * Returns {@code true} if the {@code VolatileImage}
+ * described by this {@code ImageCapabilities} can lose
* its surfaces.
* @return whether or not a volatile image is subject to losing its surfaces
* at the whim of the operating system.
--- old/src/java.desktop/share/classes/java/awt/Insets.java 2015-10-04 22:52:46.381274028 +0400
+++ new/src/java.desktop/share/classes/java/awt/Insets.java 2015-10-04 22:52:46.189274037 +0400
@@ -26,7 +26,7 @@
package java.awt;
/**
- * An Insets object is a representation of the borders
+ * An {@code Insets} object is a representation of the borders
* of a container. It specifies the space that a container must leave
* at each of its edges. The space can be a border, a blank space, or
* a title.
@@ -93,7 +93,7 @@
}
/**
- * Creates and initializes a new Insets object with the
+ * Creates and initializes a new {@code Insets} object with the
* specified top, left, bottom, and right insets.
* @param top the inset from the top.
* @param left the inset from the left.
@@ -125,11 +125,11 @@
/**
* Checks whether two insets objects are equal. Two instances
- * of Insets are equal if the four integer values
- * of the fields top, left,
- * bottom, and right are all equal.
- * @return true if the two insets are equal;
- * otherwise false.
+ * of {@code Insets} are equal if the four integer values
+ * of the fields {@code top}, {@code left},
+ * {@code bottom}, and {@code right} are all equal.
+ * @return {@code true} if the two insets are equal;
+ * otherwise {@code false}.
* @since 1.1
*/
public boolean equals(Object obj) {
@@ -156,13 +156,13 @@
}
/**
- * Returns a string representation of this Insets object.
+ * Returns a string representation of this {@code Insets} object.
* This method is intended to be used only for debugging purposes, and
* the content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
- * @return a string representation of this Insets object.
+ * @return a string representation of this {@code Insets} object.
*/
public String toString() {
return getClass().getName() + "[top=" + top + ",left=" + left + ",bottom=" + bottom + ",right=" + right + "]";
@@ -170,7 +170,7 @@
/**
* Create a copy of this object.
- * @return a copy of this Insets object.
+ * @return a copy of this {@code Insets} object.
*/
public Object clone() {
try {
--- old/src/java.desktop/share/classes/java/awt/ItemSelectable.java 2015-10-04 22:52:46.901274005 +0400
+++ new/src/java.desktop/share/classes/java/awt/ItemSelectable.java 2015-10-04 22:52:46.713274013 +0400
@@ -37,7 +37,7 @@
public interface ItemSelectable {
/**
- * Returns the selected items or null if no
+ * Returns the selected items or {@code null} if no
* items are selected.
*
* @return the list of selected objects, or {@code null}
@@ -47,8 +47,8 @@
/**
* Adds a listener to receive item events when the state of an item is
* changed by the user. Item events are not sent when an item's
- * state is set programmatically. If l is
- * null, no exception is thrown and no action is performed.
+ * state is set programmatically. If {@code l} is
+ * {@code null}, no exception is thrown and no action is performed.
*
* @param l the listener to receive events
* @see ItemEvent
@@ -57,7 +57,7 @@
/**
* Removes an item listener.
- * If l is null,
+ * If {@code l} is {@code null},
* no exception is thrown and no action is performed.
*
* @param l the listener being removed
--- old/src/java.desktop/share/classes/java/awt/JobAttributes.java 2015-10-04 22:52:47.421273982 +0400
+++ new/src/java.desktop/share/classes/java/awt/JobAttributes.java 2015-10-04 22:52:47.233273990 +0400
@@ -72,19 +72,19 @@
};
/**
- * The DefaultSelectionType instance to use for
+ * The {@code DefaultSelectionType} instance to use for
* specifying that all pages of the job should be printed.
*/
public static final DefaultSelectionType ALL =
new DefaultSelectionType(I_ALL);
/**
- * The DefaultSelectionType instance to use for
+ * The {@code DefaultSelectionType} instance to use for
* specifying that a range of pages of the job should be printed.
*/
public static final DefaultSelectionType RANGE =
new DefaultSelectionType(I_RANGE);
/**
- * The DefaultSelectionType instance to use for
+ * The {@code DefaultSelectionType} instance to use for
* specifying that the current selection should be printed.
*/
public static final DefaultSelectionType SELECTION =
@@ -108,13 +108,13 @@
};
/**
- * The DestinationType instance to use for
+ * The {@code DestinationType} instance to use for
* specifying print to file.
*/
public static final DestinationType FILE =
new DestinationType(I_FILE);
/**
- * The DestinationType instance to use for
+ * The {@code DestinationType} instance to use for
* specifying print to printer.
*/
public static final DestinationType PRINTER =
@@ -139,17 +139,17 @@
};
/**
- * The DialogType instance to use for
+ * The {@code DialogType} instance to use for
* specifying the cross-platform, pure Java print dialog.
*/
public static final DialogType COMMON = new DialogType(I_COMMON);
/**
- * The DialogType instance to use for
+ * The {@code DialogType} instance to use for
* specifying the platform's native print dialog.
*/
public static final DialogType NATIVE = new DialogType(I_NATIVE);
/**
- * The DialogType instance to use for
+ * The {@code DialogType} instance to use for
* specifying no print dialog.
*/
public static final DialogType NONE = new DialogType(I_NONE);
@@ -176,7 +176,7 @@
};
/**
- * The MultipleDocumentHandlingType instance to use for specifying
+ * The {@code MultipleDocumentHandlingType} instance to use for specifying
* that the job should be divided into separate, collated copies.
*/
public static final MultipleDocumentHandlingType
@@ -184,7 +184,7 @@
new MultipleDocumentHandlingType(
I_SEPARATE_DOCUMENTS_COLLATED_COPIES);
/**
- * The MultipleDocumentHandlingType instance to use for specifying
+ * The {@code MultipleDocumentHandlingType} instance to use for specifying
* that the job should be divided into separate, uncollated copies.
*/
public static final MultipleDocumentHandlingType
@@ -212,13 +212,13 @@
};
/**
- * The SidesType instance to use for specifying that
+ * The {@code SidesType} instance to use for specifying that
* consecutive job pages should be printed upon the same side of
* consecutive media sheets.
*/
public static final SidesType ONE_SIDED = new SidesType(I_ONE_SIDED);
/**
- * The SidesType instance to use for specifying that
+ * The {@code SidesType} instance to use for specifying that
* consecutive job pages should be printed upon front and back sides
* of consecutive media sheets, such that the orientation of each pair
* of pages on the medium would be correct for the reader as if for
@@ -227,7 +227,7 @@
public static final SidesType TWO_SIDED_LONG_EDGE =
new SidesType(I_TWO_SIDED_LONG_EDGE);
/**
- * The SidesType instance to use for specifying that
+ * The {@code SidesType} instance to use for specifying that
* consecutive job pages should be printed upon front and back sides
* of consecutive media sheets, such that the orientation of each pair
* of pages on the medium would be correct for the reader as if for
@@ -258,16 +258,16 @@
private int toPage;
/**
- * Constructs a JobAttributes instance with default
+ * Constructs a {@code JobAttributes} instance with default
* values for every attribute. The dialog defaults to
- * DialogType.NATIVE. Min page defaults to
- * 1. Max page defaults to Integer.MAX_VALUE.
- * Destination defaults to DestinationType.PRINTER.
- * Selection defaults to DefaultSelectionType.ALL.
- * Number of copies defaults to 1. Multiple document handling defaults
- * to MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.
- * Sides defaults to SidesType.ONE_SIDED. File name defaults
- * to null.
+ * {@code DialogType.NATIVE}. Min page defaults to
+ * {@code 1}. Max page defaults to {@code Integer.MAX_VALUE}.
+ * Destination defaults to {@code DestinationType.PRINTER}.
+ * Selection defaults to {@code DefaultSelectionType.ALL}.
+ * Number of copies defaults to {@code 1}. Multiple document handling defaults
+ * to {@code MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES}.
+ * Sides defaults to {@code SidesType.ONE_SIDED}. File name defaults
+ * to {@code null}.
*/
public JobAttributes() {
setCopiesToDefault();
@@ -281,36 +281,36 @@
}
/**
- * Constructs a JobAttributes instance which is a copy
- * of the supplied JobAttributes.
+ * Constructs a {@code JobAttributes} instance which is a copy
+ * of the supplied {@code JobAttributes}.
*
- * @param obj the JobAttributes to copy
+ * @param obj the {@code JobAttributes} to copy
*/
public JobAttributes(JobAttributes obj) {
set(obj);
}
/**
- * Constructs a JobAttributes instance with the
+ * Constructs a {@code JobAttributes} instance with the
* specified values for every attribute.
*
* @param copies an integer greater than 0
- * @param defaultSelection DefaultSelectionType.ALL,
- * DefaultSelectionType.RANGE, or
- * DefaultSelectionType.SELECTION
- * @param destination DestinationType.FILE or
- * DestinationType.PRINTER
- * @param dialog DialogType.COMMON,
- * DialogType.NATIVE, or
- * DialogType.NONE
- * @param fileName the possibly null file name
+ * @param defaultSelection {@code DefaultSelectionType.ALL},
+ * {@code DefaultSelectionType.RANGE}, or
+ * {@code DefaultSelectionType.SELECTION}
+ * @param destination {@code DestinationType.FILE} or
+ * {@code DestinationType.PRINTER}
+ * @param dialog {@code DialogType.COMMON},
+ * {@code DialogType.NATIVE}, or
+ * {@code DialogType.NONE}
+ * @param fileName the possibly {@code null} file name
* @param maxPage an integer greater than zero and greater than or equal
* to minPage
* @param minPage an integer greater than zero and less than or equal
* to maxPage
* @param multipleDocumentHandling
- * MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES or
- * MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES
+ * {@code MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES} or
+ * {@code MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES}
* @param pageRanges an array of integer arrays of two elements; an array
* is interpreted as a range spanning all pages including and
* between the specified pages; ranges must be in ascending
@@ -322,13 +322,13 @@
* new int[] { 15, 19 } }),
*
* specifies pages 1, 2, 3, 5, 15, 16, 17, 18, and 19. Note that
- * (new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }),
+ * ({@code new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }}),
* is an invalid set of page ranges because the two ranges
* overlap
- * @param printer the possibly null printer name
- * @param sides SidesType.ONE_SIDED,
- * SidesType.TWO_SIDED_LONG_EDGE, or
- * SidesType.TWO_SIDED_SHORT_EDGE
+ * @param printer the possibly {@code null} printer name
+ * @param sides {@code SidesType.ONE_SIDED},
+ * {@code SidesType.TWO_SIDED_LONG_EDGE}, or
+ * {@code SidesType.TWO_SIDED_SHORT_EDGE}
* @throws IllegalArgumentException if one or more of the above
* conditions is violated
*/
@@ -351,10 +351,10 @@
}
/**
- * Creates and returns a copy of this JobAttributes.
+ * Creates and returns a copy of this {@code JobAttributes}.
*
* @return the newly created copy; it is safe to cast this Object into
- * a JobAttributes
+ * a {@code JobAttributes}
*/
public Object clone() {
try {
@@ -366,10 +366,10 @@
}
/**
- * Sets all of the attributes of this JobAttributes to
+ * Sets all of the attributes of this {@code JobAttributes} to
* the same values as the attributes of obj.
*
- * @param obj the JobAttributes to copy
+ * @param obj the {@code JobAttributes} to copy
*/
public void set(JobAttributes obj) {
copies = obj.copies;
@@ -404,10 +404,10 @@
/**
* Specifies the number of copies the application should render for jobs
* using these attributes. Not specifying this attribute is equivalent to
- * specifying 1.
+ * specifying {@code 1}.
*
* @param copies an integer greater than 0
- * @throws IllegalArgumentException if copies is less than
+ * @throws IllegalArgumentException if {@code copies} is less than
* or equal to 0
*/
public void setCopies(int copies) {
@@ -429,7 +429,7 @@
/**
* Specifies whether, for jobs using these attributes, the application
* should print all pages, the range specified by the return value of
- * getPageRanges, or the current selection. This attribute
+ * {@code getPageRanges}, or the current selection. This attribute
* is updated to the value chosen by the user.
*
* @return DefaultSelectionType.ALL, DefaultSelectionType.RANGE, or
@@ -442,12 +442,12 @@
/**
* Specifies whether, for jobs using these attributes, the application
* should print all pages, the range specified by the return value of
- * getPageRanges, or the current selection. Not specifying
+ * {@code getPageRanges}, or the current selection. Not specifying
* this attribute is equivalent to specifying DefaultSelectionType.ALL.
*
* @param defaultSelection DefaultSelectionType.ALL,
* DefaultSelectionType.RANGE, or DefaultSelectionType.SELECTION.
- * @throws IllegalArgumentException if defaultSelection is null
+ * @throws IllegalArgumentException if defaultSelection is {@code null}
*/
public void setDefaultSelection(DefaultSelectionType defaultSelection) {
if (defaultSelection == null) {
@@ -495,8 +495,8 @@
* This attribute cannot be modified by, and is not subject to any
* limitations of, the implementation or the target printer.
*
- * @return DialogType.COMMON, DialogType.NATIVE, or
- * DialogType.NONE
+ * @return {@code DialogType.COMMON}, {@code DialogType.NATIVE}, or
+ * {@code DialogType.NONE}
*/
public DialogType getDialog() {
return dialog;
@@ -529,7 +529,7 @@
* Specifies the file name for the output file for jobs using these
* attributes. This attribute is updated to the value chosen by the user.
*
- * @return the possibly null file name
+ * @return the possibly {@code null} file name
*/
public String getFileName() {
return fileName;
@@ -549,9 +549,9 @@
* Returns, for jobs using these attributes, the first page to be
* printed, if a range of pages is to be printed. This attribute is
* updated to the value chosen by the user. An application should ignore
- * this attribute on output, unless the return value of the
- * getDefaultSelection method is DefaultSelectionType.RANGE. An
- * application should honor the return value of getPageRanges
+ * this attribute on output, unless the return value of the
+ * {@code getDefaultSelection} method is DefaultSelectionType.RANGE. An
+ * application should honor the return value of {@code getPageRanges}
* over the return value of this method, if possible.
*
* @return an integer greater than zero and less than or equal to
@@ -612,7 +612,7 @@
/**
* Specifies the maximum value the user can specify as the last page to
* be printed for jobs using these attributes. Not specifying this
- * attribute is equivalent to specifying Integer.MAX_VALUE.
+ * attribute is equivalent to specifying {@code Integer.MAX_VALUE}.
*
* @param maxPage an integer greater than zero and greater than or equal
* to minPage
@@ -643,7 +643,7 @@
/**
* Specifies the minimum value the user can specify as the first page to
* be printed for jobs using these attributes. Not specifying this
- * attribute is equivalent to specifying 1.
+ * attribute is equivalent to specifying {@code 1}.
*
* @param minPage an integer greater than zero and less than or equal
* to maxPage.
@@ -706,7 +706,7 @@
* printed, if a range of pages is to be printed. All range numbers are
* inclusive. This attribute is updated to the value chosen by the user.
* An application should ignore this attribute on output, unless the
- * return value of the getDefaultSelection method is
+ * return value of the {@code getDefaultSelection} method is
* DefaultSelectionType.RANGE.
*
* @return an array of integer arrays of 2 elements. An array
@@ -888,9 +888,9 @@
* Returns, for jobs using these attributes, the last page (inclusive)
* to be printed, if a range of pages is to be printed. This attribute is
* updated to the value chosen by the user. An application should ignore
- * this attribute on output, unless the return value of the
- * getDefaultSelection method is DefaultSelectionType.RANGE. An
- * application should honor the return value of getPageRanges
+ * this attribute on output, unless the return value of the
+ * {@code getDefaultSelection} method is DefaultSelectionType.RANGE. An
+ * application should honor the return value of {@code getPageRanges}
* over the return value of this method, if possible.
*
* @return an integer greater than zero and greater than or equal
--- old/src/java.desktop/share/classes/java/awt/KeyEventDispatcher.java 2015-10-04 22:52:47.957273957 +0400
+++ new/src/java.desktop/share/classes/java/awt/KeyEventDispatcher.java 2015-10-04 22:52:47.769273966 +0400
@@ -62,28 +62,28 @@
* used to deliver KeyEvents to Components other than the focus owner. This
* can be useful when navigating children of non-focusable Windows in an
* accessible environment, for example. Note that if a KeyEventDispatcher
- * dispatches the KeyEvent itself, it must use redispatchEvent
+ * dispatches the KeyEvent itself, it must use {@code redispatchEvent}
* to prevent the current KeyboardFocusManager from recursively requesting
* that this KeyEventDispatcher dispatch the event again.
* false, then
+ * If an implementation of this method returns {@code false}, then
* the KeyEvent is passed to the next KeyEventDispatcher in the chain,
* ending with the current KeyboardFocusManager. If an implementation
- * returns true, the KeyEvent is assumed to have been
+ * returns {@code true}, the KeyEvent is assumed to have been
* dispatched (although this need not be the case), and the current
* KeyboardFocusManager will take no further action with regard to the
* KeyEvent. In such a case,
- * KeyboardFocusManager.dispatchEvent should return
- * true as well. If an implementation consumes the KeyEvent,
- * but returns false, the consumed event will still be passed
+ * {@code KeyboardFocusManager.dispatchEvent} should return
+ * {@code true} as well. If an implementation consumes the KeyEvent,
+ * but returns {@code false}, the consumed event will still be passed
* to the next KeyEventDispatcher in the chain. It is important for
* developers to check whether the KeyEvent has been consumed before
* dispatching it to a target. By default, the current KeyboardFocusManager
* will not dispatch a consumed KeyEvent.
*
* @param e the KeyEvent to dispatch
- * @return true if the KeyboardFocusManager should take no
- * further action with regard to the KeyEvent; false
+ * @return {@code true} if the KeyboardFocusManager should take no
+ * further action with regard to the KeyEvent; {@code false}
* otherwise
* @see KeyboardFocusManager#redispatchEvent
*/
--- old/src/java.desktop/share/classes/java/awt/KeyEventPostProcessor.java 2015-10-04 22:52:48.477273934 +0400
+++ new/src/java.desktop/share/classes/java/awt/KeyEventPostProcessor.java 2015-10-04 22:52:48.289273943 +0400
@@ -68,17 +68,17 @@
* will be used to implement features which require global KeyEvent
* post-handling, such as menu shortcuts. Note that if a
* KeyEventPostProcessor wishes to dispatch the KeyEvent, it must use
- * redispatchEvent to prevent the AWT from recursively
+ * {@code redispatchEvent} to prevent the AWT from recursively
* requesting that this KeyEventPostProcessor perform post-processing
* of the event again.
* false, then the
+ * If an implementation of this method returns {@code false}, then the
* KeyEvent is passed to the next KeyEventPostProcessor in the chain,
* ending with the current KeyboardFocusManager. If an implementation
- * returns true, the KeyEvent is assumed to have been fully
+ * returns {@code true}, the KeyEvent is assumed to have been fully
* handled (although this need not be the case), and the AWT will take no
* further action with regard to the KeyEvent. If an implementation
- * consumes the KeyEvent but returns false, the consumed
+ * consumes the KeyEvent but returns {@code false}, the consumed
* event will still be passed to the next KeyEventPostProcessor in the
* chain. It is important for developers to check whether the KeyEvent has
* been consumed before performing any post-processing of the KeyEvent. By
@@ -86,8 +86,8 @@
* processing in response to a consumed KeyEvent.
*
* @param e the KeyEvent to post-process
- * @return true if the AWT should take no further action with
- * regard to the KeyEvent; false otherwise
+ * @return {@code true} if the AWT should take no further action with
+ * regard to the KeyEvent; {@code false} otherwise
* @see KeyboardFocusManager#redispatchEvent
*/
boolean postProcessKeyEvent(KeyEvent e);
--- old/src/java.desktop/share/classes/java/awt/KeyboardFocusManager.java 2015-10-04 22:52:48.997273911 +0400
+++ new/src/java.desktop/share/classes/java/awt/KeyboardFocusManager.java 2015-10-04 22:52:48.805273919 +0400
@@ -373,7 +373,7 @@
/**
* This KeyboardFocusManager's KeyEventDispatcher chain. The List does not
* include this KeyboardFocusManager unless it was explicitly re-registered
- * via a call to addKeyEventDispatcher. If no other
+ * via a call to {@code addKeyEventDispatcher}. If no other
* KeyEventDispatchers are registered, this field may be null or refer to
* a List of length 0.
*/
@@ -382,7 +382,7 @@
/**
* This KeyboardFocusManager's KeyEventPostProcessor chain. The List does
* not include this KeyboardFocusManager unless it was explicitly
- * re-registered via a call to addKeyEventPostProcessor.
+ * re-registered via a call to {@code addKeyEventPostProcessor}.
* If no other KeyEventPostProcessors are registered, this field may be
* null or refer to a List of length 0.
*/
@@ -514,8 +514,8 @@
* getFocusOwner(). Use Component.requestFocus()
- * or Component.requestFocusInWindow() to change the focus
+ * {@code getFocusOwner()}. Use {@code Component.requestFocus()}
+ * or {@code Component.requestFocusInWindow()} to change the focus
* owner, subject to platform limitations.
*
* @param focusOwner the focus owner
@@ -605,7 +605,7 @@
* FOCUS_LOST event. After this operation completes, the native windowing
* system will discard all user-generated KeyEvents until the user selects
* a new Component to receive focus, or a Component is given focus
- * explicitly via a call to requestFocus(). This operation
+ * explicitly via a call to {@code requestFocus()}. This operation
* does not change the focused or active Windows.
* getPermanentFocusOwner(). Use
- * Component.requestFocus() or
- * Component.requestFocusInWindow() to change the focus owner,
+ * {@code getPermanentFocusOwner()}. Use
+ * {@code Component.requestFocus()} or
+ * {@code Component.requestFocusInWindow()} to change the focus owner,
* subject to platform limitations.
*
* @param permanentFocusOwner the permanent focus owner
@@ -832,9 +832,9 @@
* getFocusedWindow(). Use
- * Component.requestFocus() or
- * Component.requestFocusInWindow() to change the focused
+ * subsequently returned by {@code getFocusedWindow()}. Use
+ * {@code Component.requestFocus()} or
+ * {@code Component.requestFocusInWindow()} to change the focused
* Window, subject to platform limitations.
*
* @param focusedWindow the focused Window
@@ -938,9 +938,9 @@
* getActiveWindow(). Use
- * Component.requestFocus() or
- * Component.requestFocusInWindow()to change the active
+ * subsequently returned by {@code getActiveWindow()}. Use
+ * {@code Component.requestFocus()} or
+ * {@code Component.requestFocusInWindow()} to change the active
* Window, subject to platform limitations.
*
* @param activeWindow the active Window
@@ -1168,16 +1168,16 @@
* have no such Set of their own explicitly defined. This Set will also be
* inherited, recursively, by any child Component of those Windows that has
* no such Set of its own explicitly defined. (See
- * setDefaultFocusTraversalKeys for a full description of each
+ * {@code setDefaultFocusTraversalKeys} for a full description of each
* operation.)
*
* @param id one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
* KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
- * @return the Set of AWTKeyStrokes
- * for the specified operation; the Set
- * will be unmodifiable, and may be empty; null
+ * @return the {@code Set} of {@code AWTKeyStroke}s
+ * for the specified operation; the {@code Set}
+ * will be unmodifiable, and may be empty; {@code null}
* will never be returned
* @see #setDefaultFocusTraversalKeys
* @see Component#setFocusTraversalKeys
@@ -1369,7 +1369,7 @@
* registered on this keyboard focus manager.
*
* @return all of this keyboard focus manager's
- * PropertyChangeListeners
+ * {@code PropertyChangeListener}s
* or an empty array if no property change
* listeners are currently registered
*
@@ -1456,11 +1456,11 @@
}
/**
- * Returns an array of all the PropertyChangeListeners
+ * Returns an array of all the {@code PropertyChangeListener}s
* associated with the named property.
*
* @param propertyName the property name
- * @return all of the PropertyChangeListeners associated with
+ * @return all of the {@code PropertyChangeListener}s associated with
* the named property or an empty array if no such listeners have
* been added.
*
@@ -1552,7 +1552,7 @@
* registered on this keyboard focus manager.
*
* @return all of this keyboard focus manager's
- * VetoableChangeListeners
+ * {@code VetoableChangeListener}s
* or an empty array if no vetoable change
* listeners are currently registered
*
@@ -1626,11 +1626,11 @@
}
/**
- * Returns an array of all the VetoableChangeListeners
+ * Returns an array of all the {@code VetoableChangeListener}s
* associated with the named property.
*
* @param propertyName the property name
- * @return all of the VetoableChangeListeners associated with
+ * @return all of the {@code VetoableChangeListener}s associated with
* the named property or an empty array if no such listeners have
* been added.
*
@@ -1659,8 +1659,8 @@
* @param oldValue the property's previous value
* @param newValue the property's new value
* @throws java.beans.PropertyVetoException if a
- * VetoableChangeListener threw
- * PropertyVetoException
+ * {@code VetoableChangeListener} threw
+ * {@code PropertyVetoException}
*/
protected void fireVetoableChange(String propertyName, Object oldValue,
Object newValue)
@@ -1683,8 +1683,8 @@
* KeyEventDispatcher dispatch KeyEvents generated by the user before
* finally dispatching the KeyEvent itself. KeyEventDispatchers will be
* notified in the order in which they were added. Notifications will halt
- * as soon as one KeyEventDispatcher returns true from its
- * dispatchKeyEvent method. There is no limit to the total
+ * as soon as one KeyEventDispatcher returns {@code true} from its
+ * {@code dispatchKeyEvent} method. There is no limit to the total
* number of KeyEventDispatchers which can be added, nor to the number of
* times which a particular KeyEventDispatcher instance can be added.
* addKeyEventDispatcher.
+ * call to {@code addKeyEventDispatcher}.
* addKeyEventDispatcher. If no other KeyEventDispatchers are
+ * {@code addKeyEventDispatcher}. If no other KeyEventDispatchers are
* registered, implementations are free to return null or a List of length
* 0. Client code should not assume one behavior over another, nor should
* it assume that the behavior, once established, will not change.
@@ -1770,8 +1770,8 @@
* of the KeyEvent's final resolution. KeyEventPostProcessors
* will be notified in the order in which they were added; the current
* KeyboardFocusManager will be notified last. Notifications will halt
- * as soon as one KeyEventPostProcessor returns true from its
- * postProcessKeyEvent method. There is no limit to the
+ * as soon as one KeyEventPostProcessor returns {@code true} from its
+ * {@code postProcessKeyEvent} method. There is no limit to the
* total number of KeyEventPostProcessors that can be added, nor to the
* number of times that a particular KeyEventPostProcessor instance can be
* added.
@@ -1804,7 +1804,7 @@
* Removes a previously added KeyEventPostProcessor from this
* KeyboardFocusManager's post-processor chain. This KeyboardFocusManager
* cannot itself be entirely removed from the chain. Only additional
- * references added via addKeyEventPostProcessor can be
+ * references added via {@code addKeyEventPostProcessor} can be
* removed.
* addKeyEventPostProcessor. If
+ * explicitly added via a call to {@code addKeyEventPostProcessor}. If
* no KeyEventPostProcessors are registered, implementations are free to
* return null or a List of length 0. Client code should not assume one
* behavior over another, nor should it assume that the behavior, once
@@ -1924,14 +1924,14 @@
* These events should be dispatched based on the KeyboardFocusManager's
* notion of the focus owner and the focused and active Windows, sometimes
* overriding the source of the specified AWTEvent. Dispatching must be
- * done using redispatchEvent to prevent the AWT event
+ * done using {@code redispatchEvent} to prevent the AWT event
* dispatcher from recursively requesting that the KeyboardFocusManager
- * dispatch the event again. If this method returns false,
+ * dispatch the event again. If this method returns {@code false},
* then the AWT event dispatcher will attempt to dispatch the event itself.
*
* @param e the AWTEvent to be dispatched
- * @return true if this method dispatched the event;
- * false otherwise
+ * @return {@code true} if this method dispatched the event;
+ * {@code false} otherwise
* @see #redispatchEvent
* @see #dispatchKeyEvent
*/
@@ -1941,9 +1941,9 @@
* Redispatches an AWTEvent in such a way that the AWT event dispatcher
* will not recursively request that the KeyboardFocusManager, or any
* installed KeyEventDispatchers, dispatch the event again. Client
- * implementations of dispatchEvent and client-defined
- * KeyEventDispatchers must call redispatchEvent(target, e)
- * instead of target.dispatchEvent(e) to dispatch an event.
+ * implementations of {@code dispatchEvent} and client-defined
+ * KeyEventDispatchers must call {@code redispatchEvent(target, e)}
+ * instead of {@code target.dispatchEvent(e)} to dispatch an event.
* dispatchEvent if no
+ * Typically this method will be called by {@code dispatchEvent} if no
* other KeyEventDispatcher in the dispatcher chain dispatched the
* KeyEvent, or if no other KeyEventDispatchers are registered. If an
- * implementation of this method returns false,
- * dispatchEvent may try to dispatch the KeyEvent itself, or
- * may simply return false. If true is returned,
- * dispatchEvent should return true as well.
+ * implementation of this method returns {@code false},
+ * {@code dispatchEvent} may try to dispatch the KeyEvent itself, or
+ * may simply return {@code false}. If {@code true} is returned,
+ * {@code dispatchEvent} should return {@code true} as well.
*
* @param e the KeyEvent which the current KeyboardFocusManager has
* requested that this KeyEventDispatcher dispatch
- * @return true if the KeyEvent was dispatched;
- * false otherwise
+ * @return {@code true} if the KeyEvent was dispatched;
+ * {@code false} otherwise
* @see #dispatchEvent
*/
public abstract boolean dispatchKeyEvent(KeyEvent e);
/**
- * This method will be called by dispatchKeyEvent.
+ * This method will be called by {@code dispatchKeyEvent}.
* By default, this method will handle any unconsumed KeyEvents that
- * map to an AWT MenuShortcut by consuming the event
+ * map to an AWT {@code MenuShortcut} by consuming the event
* and activating the shortcut.
*
* @param e the KeyEvent to post-process
- * @return true to indicate that no other
+ * @return {@code true} to indicate that no other
* KeyEventPostProcessor will be notified of the KeyEvent.
* @see #dispatchKeyEvent
* @see MenuShortcut
@@ -2015,8 +2015,8 @@
* the KeyboardFocusManager to delay dispatching of KeyEvents with
* timestamps later than the specified time stamp until the specified
* Component receives a FOCUS_GAINED event, or the AWT cancels the delay
- * request by invoking dequeueKeyEvents or
- * discardKeyEvents.
+ * request by invoking {@code dequeueKeyEvents} or
+ * {@code discardKeyEvents}.
*
* @param after timestamp of current event, or the current, system time if
* the current event has no timestamp, or the AWT cannot determine
@@ -2032,16 +2032,16 @@
/**
* Called by the AWT to notify the KeyboardFocusManager that it should
* cancel delayed dispatching of KeyEvents. All KeyEvents which were
- * enqueued because of a call to enqueueKeyEvents with the
+ * enqueued because of a call to {@code enqueueKeyEvents} with the
* same timestamp and Component should be released for normal dispatching
* to the current focus owner. If the given timestamp is less than zero,
* the outstanding enqueue request for the given Component with the
* oldest timestamp (if any) should be cancelled.
*
* @param after the timestamp specified in the call to
- * enqueueKeyEvents, or any value < 0
+ * {@code enqueueKeyEvents}, or any value < 0
* @param untilFocused the Component specified in the call to
- * enqueueKeyEvents
+ * {@code enqueueKeyEvents}
* @see #enqueueKeyEvents
* @see #discardKeyEvents
*/
@@ -2051,11 +2051,11 @@
/**
* Called by the AWT to notify the KeyboardFocusManager that it should
* cancel delayed dispatching of KeyEvents. All KeyEvents which were
- * enqueued because of one or more calls to enqueueKeyEvents
+ * enqueued because of one or more calls to {@code enqueueKeyEvents}
* with the same Component should be discarded.
*
* @param comp the Component specified in one or more calls to
- * enqueueKeyEvents
+ * {@code enqueueKeyEvents}
* @see #enqueueKeyEvents
* @see #dequeueKeyEvents
*/
--- old/src/java.desktop/share/classes/java/awt/Label.java 2015-10-04 22:52:49.561273885 +0400
+++ new/src/java.desktop/share/classes/java/awt/Label.java 2015-10-04 22:52:49.373273894 +0400
@@ -30,7 +30,7 @@
import javax.accessibility.*;
/**
- * A Label object is a component for placing text in a
+ * A {@code Label} object is a component for placing text in a
* container. A label displays a single line of read-only text.
* The text can be changed by the application, but a user cannot edit it
* directly.
@@ -107,7 +107,7 @@
/**
* Constructs an empty label.
- * The text of the label is the empty string "".
+ * The text of the label is the empty string {@code ""}.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -120,7 +120,7 @@
* Constructs a new label with the specified string of text,
* left justified.
* @param text the string that the label presents.
- * A null value
+ * A {@code null} value
* will be accepted without causing a NullPointerException
* to be thrown.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
@@ -134,10 +134,10 @@
/**
* Constructs a new label that presents the specified string of
* text with the specified alignment.
- * Possible values for alignment are Label.LEFT,
- * Label.RIGHT, and Label.CENTER.
+ * Possible values for {@code alignment} are {@code Label.LEFT},
+ * {@code Label.RIGHT}, and {@code Label.CENTER}.
* @param text the string that the label presents.
- * A null value
+ * A {@code null} value
* will be accepted without causing a NullPointerException
* to be thrown.
* @param alignment the alignment value.
@@ -154,8 +154,8 @@
/**
* Read a label from an object input stream.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless() returns
- * true
+ * {@code GraphicsEnvironment.isHeadless()} returns
+ * {@code true}
* @serial
* @since 1.4
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -168,7 +168,7 @@
/**
* Construct a name for this component. Called by getName() when the
- * name is null.
+ * name is {@code null}.
*/
String constructComponentName() {
synchronized (Label.class) {
@@ -191,8 +191,8 @@
/**
* Gets the current alignment of this label. Possible values are
- * Label.LEFT, Label.RIGHT, and
- * Label.CENTER.
+ * {@code Label.LEFT}, {@code Label.RIGHT}, and
+ * {@code Label.CENTER}.
* @return the alignment of this label
* @see java.awt.Label#setAlignment
*/
@@ -202,11 +202,11 @@
/**
* Sets the alignment for this label to the specified alignment.
- * Possible values are Label.LEFT,
- * Label.RIGHT, and Label.CENTER.
+ * Possible values are {@code Label.LEFT},
+ * {@code Label.RIGHT}, and {@code Label.CENTER}.
* @param alignment the alignment to be set.
* @exception IllegalArgumentException if an improper value for
- * alignment is given.
+ * {@code alignment} is given.
* @see java.awt.Label#getAlignment
*/
public synchronized void setAlignment(int alignment) {
@@ -226,8 +226,8 @@
/**
* Gets the text of this label.
- * @return the text of this label, or null if
- * the text has been set to null.
+ * @return the text of this label, or {@code null} if
+ * the text has been set to {@code null}.
* @see java.awt.Label#setText
*/
public String getText() {
@@ -237,9 +237,9 @@
/**
* Sets the text for this label to the specified text.
* @param text the text that this label displays. If
- * text is null, it is
+ * {@code text} is {@code null}, it is
* treated for display purposes like an empty
- * string "".
+ * string {@code ""}.
* @see java.awt.Label#getText
*/
public void setText(String text) {
@@ -263,11 +263,11 @@
}
/**
- * Returns a string representing the state of this Label.
+ * Returns a string representing the state of this {@code Label}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this label
*/
@@ -311,7 +311,7 @@
/**
* This class implements accessibility support for the
- * Label class. It provides an implementation of the
+ * {@code Label} class. It provides an implementation of the
* Java Accessibility API appropriate to label user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/LayoutManager.java 2015-10-04 22:52:50.089273862 +0400
+++ new/src/java.desktop/share/classes/java/awt/LayoutManager.java 2015-10-04 22:52:49.897273870 +0400
@@ -26,13 +26,13 @@
/**
* Defines the interface for classes that know how to lay out
- * Containers.
+ * {@code Container}s.
* JComponent do not overlap. If a
- * JComponent's LayoutManager allows
- * children to overlap, the JComponent must override
- * isOptimizedDrawingEnabled to return false.
+ * {@code JComponent} do not overlap. If a
+ * {@code JComponent}'s {@code LayoutManager} allows
+ * children to overlap, the {@code JComponent} must override
+ * {@code isOptimizedDrawingEnabled} to return false.
*
* @see Container
* @see javax.swing.JComponent#isOptimizedDrawingEnabled
@@ -43,9 +43,9 @@
public interface LayoutManager {
/**
* If the layout manager uses a per-component string,
- * adds the component comp to the layout,
+ * adds the component {@code comp} to the layout,
* associating it
- * with the string specified by name.
+ * with the string specified by {@code name}.
*
* @param name the string to be associated with the component
* @param comp the component to be added
--- old/src/java.desktop/share/classes/java/awt/LinearGradientPaintContext.java 2015-10-04 22:52:50.629273837 +0400
+++ new/src/java.desktop/share/classes/java/awt/LinearGradientPaintContext.java 2015-10-04 22:52:50.437273846 +0400
@@ -56,7 +56,7 @@
* @param paint the {@code LinearGradientPaint} from which this context
* is created
* @param cm {@code ColorModel} that receives
- * the Paint data. This is used only as a hint.
+ * the {@code Paint} data. This is used only as a hint.
* @param deviceBounds the device space bounding box of the
* graphics primitive being rendered
* @param userBounds the user space bounding box of the
--- old/src/java.desktop/share/classes/java/awt/List.java 2015-10-04 22:52:51.149273814 +0400
+++ new/src/java.desktop/share/classes/java/awt/List.java 2015-10-04 22:52:50.961273823 +0400
@@ -36,7 +36,7 @@
/**
- * The List component presents the user with a
+ * The {@code List} component presents the user with a
* scrolling list of text items. The list can be set up so that
* the user can choose either one item or multiple items.
*
* cnt is a container, produces the following
+ * where {@code cnt} is a container, produces the following
* scrolling list:
* 
false. If the List does not allow multiple
+ * list is {@code false}. If the List does not allow multiple
* selections, selecting an item causes any other selected item
* to be deselected.
* List is created with
- * four rows, so that lst = new List() is equivalent to
- * list = new List(4, false).
+ * cannot be changed. A default {@code List} is created with
+ * four rows, so that {@code lst = new List()} is equivalent to
+ * {@code list = new List(4, false)}.
* List object all mouse, keyboard, and focus events
+ * sends the {@code List} object all mouse, keyboard, and focus events
* that occur over it. (The old AWT event model is being maintained
* only for backwards compatibility, and its use is discouraged.)
* ItemEvent to the list.
+ * of {@code ItemEvent} to the list.
* When the user double-clicks on an item in a scrolling list,
- * AWT sends an instance of ActionEvent to the
+ * AWT sends an instance of {@code ActionEvent} to the
* list following the item event. AWT also generates an action event
* when the user presses the return key while an item in the
* list is selected.
* ItemListener or ActionListener
+ * {@code ItemListener} or {@code ActionListener}
* as appropriate and register the new listener to receive
* events from this list.
* List Component. It is specified only once, and
+ * {@code List} Component. It is specified only once, and
* that is when the list component is actually
* created. It will never change.
*
@@ -129,11 +129,11 @@
int rows = 0;
/**
- * multipleMode is a variable that will
- * be set to true if a list component is to be set to
+ * {@code multipleMode} is a variable that will
+ * be set to {@code true} if a list component is to be set to
* multiple selection mode, that is where the user can
* select more than one item in a list at one time.
- * multipleMode will be set to false if the
+ * {@code multipleMode} will be set to false if the
* list component is set to single selection, that is where
* the user can only select one item on the list at any
* one time.
@@ -145,7 +145,7 @@
boolean multipleMode = false;
/**
- * selected is an array that will contain
+ * {@code selected} is an array that will contain
* the indices of items that have been selected.
*
* @serial
@@ -178,7 +178,7 @@
* Creates a new scrolling list.
* By default, there are four visible lines and multiple selections are
* not allowed. Note that this is a convenience method for
- * List(0, false). Also note that the number of visible
+ * {@code List(0, false)}. Also note that the number of visible
* lines in the list cannot be changed after it has been created.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
@@ -192,7 +192,7 @@
* Creates a new scrolling list initialized with the specified
* number of visible lines. By default, multiple selections are
* not allowed. Note that this is a convenience method for
- * List(rows, false). Also note that the number
+ * {@code List(rows, false)}. Also note that the number
* of visible rows in the list cannot be changed after it has
* been created.
* @param rows the number of items to show.
@@ -217,12 +217,12 @@
* the list will be created with a default of four rows.
* Also note that the number of visible rows in the list cannot
* be changed after it has been created.
- * If the value of multipleMode is
- * true, then the user can select multiple items from
- * the list. If it is false, only one item at a time
+ * If the value of {@code multipleMode} is
+ * {@code true}, then the user can select multiple items from
+ * the list. If it is {@code false}, only one item at a time
* can be selected.
* @param rows the number of items to show.
- * @param multipleMode if true,
+ * @param multipleMode if {@code true},
* then multiple selections are allowed;
* otherwise, only one item can be selected at a time.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
@@ -237,7 +237,7 @@
/**
* Construct a name for this component. Called by
- * getName when the name is null.
+ * {@code getName} when the name is {@code null}.
*/
String constructComponentName() {
synchronized (List.class) {
@@ -286,7 +286,7 @@
*
* @return the number of items in the list
* @deprecated As of JDK version 1.1,
- * replaced by getItemCount().
+ * replaced by {@code getItemCount()}.
*/
@Deprecated
public int countItems() {
@@ -339,7 +339,7 @@
* Adds the specified item to the end of the list.
*
* @param item the item to be added
- * @deprecated replaced by add(String).
+ * @deprecated replaced by {@code add(String)}.
*/
@Deprecated
public void addItem(String item) {
@@ -354,8 +354,8 @@
* the number of items in the list, then the item is added
* to the end of the list.
* @param item the item to be added;
- * if this parameter is null then the item is
- * treated as an empty string, ""
+ * if this parameter is {@code null} then the item is
+ * treated as an empty string, {@code ""}
* @param index the position at which to add the item
* @since 1.1
*/
@@ -369,7 +369,7 @@
*
* @param item the item to be added
* @param index the position at which to add the item
- * @deprecated replaced by add(String, int).
+ * @deprecated replaced by {@code add(String, int)}.
*/
@Deprecated
public synchronized void addItem(String item, int index) {
@@ -398,7 +398,7 @@
* with the new string.
* @param newValue a new string to replace an existing item
* @param index the position of the item to replace
- * @exception ArrayIndexOutOfBoundsException if index
+ * @exception ArrayIndexOutOfBoundsException if {@code index}
* is out of range
*/
public synchronized void replaceItem(String newValue, int index) {
@@ -418,7 +418,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by removeAll().
+ * replaced by {@code removeAll()}.
*/
@Deprecated
public synchronized void clear() {
@@ -458,8 +458,8 @@
* @see #add(String, int)
* @since 1.1
* @exception ArrayIndexOutOfBoundsException
- * if the position is less than 0 or
- * greater than getItemCount()-1
+ * if the {@code position} is less than 0 or
+ * greater than {@code getItemCount()-1}
*/
public void remove(int position) {
delItem(position);
@@ -469,8 +469,8 @@
* Removes the item at the specified position.
*
* @param position the index of the item to delete
- * @deprecated replaced by remove(String)
- * and remove(int).
+ * @deprecated replaced by {@code remove(String)}
+ * and {@code remove(int)}.
*/
@Deprecated
public void delItem(int position) {
@@ -482,7 +482,7 @@
*
* @return the index of the selected item;
* if no item is selected, or if multiple items are
- * selected, -1 is returned.
+ * selected, {@code -1} is returned.
* @see #select
* @see #deselect
* @see #isIndexSelected
@@ -514,7 +514,7 @@
*
* @return the selected item on the list;
* if no item is selected, or if multiple items are
- * selected, null is returned.
+ * selected, {@code null} is returned.
* @see #select
* @see #deselect
* @see #isIndexSelected
@@ -544,7 +544,7 @@
/**
* Gets the selected items on this scrolling list in an array of Objects.
- * @return an array of Objects representing the
+ * @return an array of {@code Object}s representing the
* selected items on this scrolling list;
* if no item is selected, a zero-length array is returned.
* @see #getSelectedItems
@@ -563,8 +563,8 @@
* ItemEvent. The only way to trigger an
- * ItemEvent is by user interaction.
+ * an {@code ItemEvent}. The only way to trigger an
+ * {@code ItemEvent} is by user interaction.
*
* @param index the position of the item to select
* @see #getSelectedItem
@@ -649,8 +649,8 @@
* Determines if the specified item in this scrolling list is
* selected.
* @param index the item to be checked
- * @return true if the specified item has been
- * selected; false otherwise
+ * @return {@code true} if the specified item has been
+ * selected; {@code false} otherwise
* @see #select
* @see #deselect
* @since 1.1
@@ -665,7 +665,7 @@
* @param index specifies the item to be checked
* @return {@code true} if the item is selected; otherwise {@code false}
* @deprecated As of JDK version 1.1,
- * replaced by isIndexSelected(int).
+ * replaced by {@code isIndexSelected(int)}.
*/
@Deprecated
public boolean isSelected(int index) {
@@ -680,7 +680,7 @@
/**
* Gets the number of visible lines in this list. Note that
- * once the List has been created, this number
+ * once the {@code List} has been created, this number
* will never change.
* @return the number of visible lines in this scrolling list
*/
@@ -691,8 +691,8 @@
/**
* Determines whether this list allows multiple selections.
*
- * @return true if this list allows multiple
- * selections; otherwise, false
+ * @return {@code true} if this list allows multiple
+ * selections; otherwise, {@code false}
* @see #setMultipleMode
* @since 1.1
*/
@@ -706,7 +706,7 @@
* @return {@code true} if this list allows multiple
* selections; otherwise {@code false}
* @deprecated As of JDK version 1.1,
- * replaced by isMultipleMode().
+ * replaced by {@code isMultipleMode()}.
*/
@Deprecated
public boolean allowsMultipleSelections() {
@@ -721,7 +721,7 @@
* If a selected item has the location cursor, only that
* item will remain selected. If no selected item has the
* location cursor, all items will be deselected.
- * @param b if true then multiple selections
+ * @param b if {@code true} then multiple selections
* are allowed; otherwise, only one item from
* the list can be selected at once
* @see #isMultipleMode
@@ -736,7 +736,7 @@
*
* @param b {@code true} to enable multiple mode, {@code false} otherwise
* @deprecated As of JDK version 1.1,
- * replaced by setMultipleMode(boolean).
+ * replaced by {@code setMultipleMode(boolean)}.
*/
@Deprecated
public synchronized void setMultipleSelections(boolean b) {
@@ -751,7 +751,7 @@
/**
* Gets the index of the item that was last made visible by
- * the method makeVisible.
+ * the method {@code makeVisible}.
* @return the index of the item that was last made visible
* @see #makeVisible
*/
@@ -792,7 +792,7 @@
* @param rows the number of rows
* @return the preferred dimensions for displaying this list
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize(int).
+ * replaced by {@code getPreferredSize(int)}.
*/
@Deprecated
public Dimension preferredSize(int rows) {
@@ -816,7 +816,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize().
+ * replaced by {@code getPreferredSize()}.
*/
@Deprecated
public Dimension preferredSize() {
@@ -847,7 +847,7 @@
* @param rows the number of rows in the list
* @return the minimum dimensions for displaying this list
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize(int).
+ * replaced by {@code getMinimumSize(int)}.
*/
@Deprecated
public Dimension minimumSize(int rows) {
@@ -872,7 +872,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize().
+ * replaced by {@code getMinimumSize()}.
*/
@Deprecated
public Dimension minimumSize() {
@@ -884,8 +884,8 @@
/**
* Adds the specified item listener to receive item events from
* this list. Item events are sent in response to user input, but not
- * in response to calls to select or deselect.
- * If listener l is null,
+ * in response to calls to {@code select} or {@code deselect}.
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* ItemListeners
+ * @return all of this list's {@code ItemListener}s
* or an empty array if no item
* listeners are currently registered
*
@@ -953,7 +953,7 @@
* on a list item or types Enter when the list has the keyboard
* focus.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* l is null,
+ * If listener {@code l} is {@code null},
* no exception is thrown and no action is performed.
* ActionListeners
+ * @return all of this list's {@code ActionListener}s
* or an empty array if no action
* listeners are currently registered
*
@@ -1017,16 +1017,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this List.
+ * upon this {@code List}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * List l
+ * {@code List l}
* for its item listeners with the following code:
*
* ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));
@@ -1035,14 +1035,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this list,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getItemListeners
* @since 1.3
@@ -1082,13 +1082,13 @@
/**
* Processes events on this scrolling list. If an event is
- * an instance of ItemEvent, it invokes the
- * processItemEvent method. Else, if the
- * event is an instance of ActionEvent,
- * it invokes processActionEvent.
+ * an instance of {@code ItemEvent}, it invokes the
+ * {@code processItemEvent} method. Else, if the
+ * event is an instance of {@code ActionEvent},
+ * it invokes {@code processActionEvent}.
* If the event is not an item event or an action event,
- * it invokes processEvent on the superclass.
- * null
+ * it invokes {@code processEvent} on the superclass.
+ * ItemListener objects.
+ * {@code ItemListener} objects.
*
- *
- * ItemListener object is registered
- * via addItemListener.
- * enableEvents.
+ * null
+ * ActionListener objects.
+ * {@code ActionListener} objects.
*
- *
- * ActionListener object is registered
- * via addActionListener.
- * enableEvents.
+ * null
+ * List component's
+ * The {@code List} component's
* Serialized Data Version.
*
* @serial
@@ -1218,22 +1218,22 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable ItemListeners
- * and ActionListeners as optional data.
+ * a list of serializable {@code ItemListeners}
+ * and {@code ActionListeners} as optional data.
* The non-serializable listeners are detected and
* no attempt is made to serialize them.
*
- * @serialData null terminated sequence of 0
- * or more pairs; the pair consists of a String
- * and an Object; the String
+ * @serialData {@code null} terminated sequence of 0
+ * or more pairs; the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String}
* indicates the type of object and is one of the
* following:
- * itemListenerK indicating an
- * ItemListener object;
- * actionListenerK indicating an
- * ActionListener object
+ * {@code itemListenerK} indicating an
+ * {@code ItemListener} object;
+ * {@code actionListenerK} indicating an
+ * {@code ActionListener} object
*
- * @param s the ObjectOutputStream to write
+ * @param s the {@code ObjectOutputStream} to write
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see java.awt.Component#itemListenerK
* @see java.awt.Component#actionListenerK
@@ -1256,17 +1256,17 @@
}
/**
- * Reads the ObjectInputStream and if it
- * isn't null adds a listener to receive
+ * Reads the {@code ObjectInputStream} and if it
+ * isn't {@code null} adds a listener to receive
* both item events and action events (as specified
* by the key stored in the stream) fired by the
- * List.
+ * {@code List}.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to write
+ * @param s the {@code ObjectInputStream} to write
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @see #removeItemListener(ItemListener)
* @see #addItemListener(ItemListener)
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -1300,13 +1300,13 @@
/**
- * Gets the AccessibleContext associated with this
- * List. For lists, the AccessibleContext
- * takes the form of an AccessibleAWTList.
- * A new AccessibleAWTList instance is created, if necessary.
+ * Gets the {@code AccessibleContext} associated with this
+ * {@code List}. For lists, the {@code AccessibleContext}
+ * takes the form of an {@code AccessibleAWTList}.
+ * A new {@code AccessibleAWTList} instance is created, if necessary.
*
- * @return an AccessibleAWTList that serves as the
- * AccessibleContext of this List
+ * @return an {@code AccessibleAWTList} that serves as the
+ * {@code AccessibleContext} of this {@code List}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
@@ -1318,7 +1318,7 @@
/**
* This class implements accessibility support for the
- * List class. It provides an implementation of the
+ * {@code List} class. It provides an implementation of the
* Java Accessibility API appropriate to list user-interface elements.
* @since 1.3
*/
@@ -1930,13 +1930,13 @@
}
/**
- * Returns the Accessible child, if one exists,
- * contained at the local coordinate Point.
+ * Returns the {@code Accessible} child, if one exists,
+ * contained at the local coordinate {@code Point}.
*
* @param p the point relative to the coordinate system of this
* object
- * @return the Accessible, if it exists,
- * at the specified location; otherwise null
+ * @return the {@code Accessible}, if it exists,
+ * at the specified location; otherwise {@code null}
*/
public Accessible getAccessibleAt(Point p) {
return null; // object cannot have children!
@@ -1945,8 +1945,8 @@
/**
* Returns whether this object can accept focus or not. Objects
* that can accept focus will also have the
- * AccessibleState.FOCUSABLE state set in their
- * AccessibleStateSet.
+ * {@code AccessibleState.FOCUSABLE} state set in their
+ * {@code AccessibleStateSet}.
*
* @return true if object can accept focus; otherwise false
* @see AccessibleContext#getAccessibleStateSet
--- old/src/java.desktop/share/classes/java/awt/MediaTracker.java 2015-10-04 22:52:51.709273789 +0400
+++ new/src/java.desktop/share/classes/java/awt/MediaTracker.java 2015-10-04 22:52:51.517273798 +0400
@@ -31,13 +31,13 @@
import sun.awt.image.MultiResolutionToolkitImage;
/**
- * The MediaTracker class is a utility class to track
+ * The {@code MediaTracker} class is a utility class to track
* the status of a number of media objects. Media objects could
* include audio clips as well as images, though currently only
* images are supported.
* MediaTracker and call its addImage
+ * {@code MediaTracker} and call its {@code addImage}
* method for each image to be tracked. In addition, each image can
* be assigned a unique identifier. This identifier controls the
* priority order in which the images are fetched. It can also be used
@@ -52,20 +52,20 @@
* due to the multi-part nature of animated image
* loading and painting,
* but it is supported.
- * MediaTracker treats an animated image
+ * {@code MediaTracker} treats an animated image
* as completely loaded
* when the first frame is completely loaded.
- * At that point, the MediaTracker
+ * At that point, the {@code MediaTracker}
* signals any waiters
* that the image is completely loaded.
- * If no ImageObservers are observing the image
+ * If no {@code ImageObserver}s are observing the image
* when the first frame has finished loading,
* the image might flush itself
* to conserve resources
* (see {@link Image#flush()}).
*
* MediaTracker:
+ * Here is an example of using {@code MediaTracker}:
*
* {@code
* import java.applet.Applet;
@@ -169,7 +169,7 @@
public class MediaTracker implements java.io.Serializable {
/**
- * A given Component that will be
+ * A given {@code Component} that will be
* tracked by a media tracker where the image will
* eventually be drawn.
*
@@ -178,8 +178,8 @@
*/
Component target;
/**
- * The head of the list of Images that is being
- * tracked by the MediaTracker.
+ * The head of the list of {@code Images} that is being
+ * tracked by the {@code MediaTracker}.
*
* @serial
* @see #addImage(Image, int)
@@ -277,11 +277,11 @@
* isErrorAny or isErrorID methods to
+ * {@code isErrorAny} or {@code isErrorID} methods to
* check for errors.
- * @return true if all images have finished loading,
+ * @return {@code true} if all images have finished loading,
* have been aborted, or have encountered
- * an error; false otherwise
+ * an error; {@code false} otherwise
* @see java.awt.MediaTracker#checkAll(boolean)
* @see java.awt.MediaTracker#checkID
* @see java.awt.MediaTracker#isErrorAny
@@ -295,19 +295,19 @@
* Checks to see if all images being tracked by this media tracker
* have finished loading.
* load flag is true,
+ * If the value of the {@code load} flag is {@code true},
* then this method starts loading any images that are not yet
* being loaded.
* isErrorAny and isErrorID methods to
+ * {@code isErrorAny} and {@code isErrorID} methods to
* check for errors.
- * @param load if true, start loading any
+ * @param load if {@code true}, start loading any
* images that are not yet being loaded
- * @return true if all images have finished loading,
+ * @return {@code true} if all images have finished loading,
* have been aborted, or have encountered
- * an error; false otherwise
+ * an error; {@code false} otherwise
* @see java.awt.MediaTracker#checkID
* @see java.awt.MediaTracker#checkAll()
* @see java.awt.MediaTracker#isErrorAny()
@@ -331,9 +331,9 @@
/**
* Checks the error status of all of the images.
- * @return true if any of the images tracked
+ * @return {@code true} if any of the images tracked
* by this media tracker had an error during
- * loading; false otherwise
+ * loading; {@code false} otherwise
* @see java.awt.MediaTracker#isErrorID
* @see java.awt.MediaTracker#getErrorsAny
*/
@@ -352,7 +352,7 @@
* Returns a list of all media that have encountered an error.
* @return an array of media objects tracked by this
* media tracker that have encountered
- * an error, or null if
+ * an error, or {@code null} if
* there are none with errors
* @see java.awt.MediaTracker#isErrorAny
* @see java.awt.MediaTracker#getErrorsID
@@ -388,7 +388,7 @@
* isErrorAny or isErrorID methods to
+ * {@code isErrorAny} or {@code isErrorID} methods to
* check for errors.
* @see java.awt.MediaTracker#waitForID(int)
* @see java.awt.MediaTracker#waitForAll(long)
@@ -405,16 +405,16 @@
* Starts loading all images tracked by this media tracker. This
* method waits until all the images being tracked have finished
* loading, or until the length of time specified in milliseconds
- * by the ms argument has passed.
+ * by the {@code ms} argument has passed.
* isErrorAny or isErrorID methods to
+ * {@code isErrorAny} or {@code isErrorID} methods to
* check for errors.
* @param ms the number of milliseconds to wait
* for the loading to complete
- * @return true if all images were successfully
- * loaded; false otherwise
+ * @return {@code true} if all images were successfully
+ * loaded; {@code false} otherwise
* @see java.awt.MediaTracker#waitForID(int)
* @see java.awt.MediaTracker#waitForAll(long)
* @see java.awt.MediaTracker#isErrorAny
@@ -451,15 +451,15 @@
* status of all media that are tracked by this media tracker.
* MediaTracker class are LOADING,
- * ABORTED, ERRORED, and
- * COMPLETE. An image that hasn't started
+ * {@code MediaTracker} class are {@code LOADING},
+ * {@code ABORTED}, {@code ERRORED}, and
+ * {@code COMPLETE}. An image that hasn't started
* loading has zero as its status.
* load is true, then
+ * If the value of {@code load} is {@code true}, then
* this method starts loading any images that are not yet being loaded.
*
- * @param load if true, start loading
+ * @param load if {@code true}, start loading
* any images that are not yet being loaded
* @return the bitwise inclusive OR of the status of
* all of the media being tracked
@@ -492,12 +492,12 @@
* isErrorAny or isErrorID methods to
+ * {@code isErrorAny} or {@code isErrorID} methods to
* check for errors.
* @param id the identifier of the images to check
- * @return true if all images have finished loading,
+ * @return {@code true} if all images have finished loading,
* have been aborted, or have encountered
- * an error; false otherwise
+ * an error; {@code false} otherwise
* @see java.awt.MediaTracker#checkID(int, boolean)
* @see java.awt.MediaTracker#checkAll()
* @see java.awt.MediaTracker#isErrorAny()
@@ -511,20 +511,20 @@
* Checks to see if all images tracked by this media tracker that
* are tagged with the specified identifier have finished loading.
* load flag is true,
+ * If the value of the {@code load} flag is {@code true},
* then this method starts loading any images that are not yet
* being loaded.
* isErrorAny or isErrorID methods to
+ * {@code isErrorAny} or {@code isErrorID} methods to
* check for errors.
* @param id the identifier of the images to check
- * @param load if true, start loading any
+ * @param load if {@code true}, start loading any
* images that are not yet being loaded
- * @return true if all images have finished loading,
+ * @return {@code true} if all images have finished loading,
* have been aborted, or have encountered
- * an error; false otherwise
+ * an error; {@code false} otherwise
* @see java.awt.MediaTracker#checkID(int, boolean)
* @see java.awt.MediaTracker#checkAll()
* @see java.awt.MediaTracker#isErrorAny()
@@ -553,9 +553,9 @@
* Checks the error status of all of the images tracked by this
* media tracker with the specified identifier.
* @param id the identifier of the images to check
- * @return true if any of the images with the
+ * @return {@code true} if any of the images with the
* specified identifier had an error during
- * loading; false otherwise
+ * loading; {@code false} otherwise
* @see java.awt.MediaTracker#isErrorAny
* @see java.awt.MediaTracker#getErrorsID
*/
@@ -579,7 +579,7 @@
* @return an array of media objects tracked by this media
* tracker with the specified identifier
* that have encountered an error, or
- * null if there are none with errors
+ * {@code null} if there are none with errors
* @see java.awt.MediaTracker#isErrorID
* @see java.awt.MediaTracker#isErrorAny
* @see java.awt.MediaTracker#getErrorsAny
@@ -619,7 +619,7 @@
* isErrorAny and isErrorID methods to
+ * {@code isErrorAny} and {@code isErrorID} methods to
* check for errors.
* @param id the identifier of the images to check
* @see java.awt.MediaTracker#waitForAll
@@ -636,13 +636,13 @@
* Starts loading all images tracked by this media tracker with the
* specified identifier. This method waits until all the images with
* the specified identifier have finished loading, or until the
- * length of time specified in milliseconds by the ms
+ * length of time specified in milliseconds by the {@code ms}
* argument has passed.
* statusID, isErrorID, and
- * isErrorAny methods to check for errors.
+ * {@code statusID}, {@code isErrorID}, and
+ * {@code isErrorAny} methods to check for errors.
* @param id the identifier of the images to check
* @param ms the length of time, in milliseconds, to wait
* for the loading to complete
@@ -686,15 +686,15 @@
* tracked by this media tracker.
* MediaTracker class are LOADING,
- * ABORTED, ERRORED, and
- * COMPLETE. An image that hasn't started
+ * {@code MediaTracker} class are {@code LOADING},
+ * {@code ABORTED}, {@code ERRORED}, and
+ * {@code COMPLETE}. An image that hasn't started
* loading has zero as its status.
* load is true, then
+ * If the value of {@code load} is {@code true}, then
* this method starts loading any images that are not yet being loaded.
* @param id the identifier of the images to check
- * @param load if true, start loading
+ * @param load if {@code true}, start loading
* any images that are not yet being loaded
* @return the bitwise inclusive OR of the status of
* all of the media with the specified
@@ -761,7 +761,7 @@
/**
* Removes the specified image from the specified tracking
* ID of this media tracker.
- * All instances of Image being tracked
+ * All instances of {@code Image} being tracked
* under the specified ID are removed regardless of scale.
* @param image the image to be removed
* @param id the tracking ID from which to remove the image
--- old/src/java.desktop/share/classes/java/awt/Menu.java 2015-10-04 22:52:52.241273765 +0400
+++ new/src/java.desktop/share/classes/java/awt/Menu.java 2015-10-04 22:52:52.053273774 +0400
@@ -34,7 +34,7 @@
import sun.awt.AWTAccessor;
/**
- * A Menu object is a pull-down menu component
+ * A {@code Menu} object is a pull-down menu component
* that is deployed from a menu bar.
* MenuItem
- * class. It can be an instance of MenuItem, a submenu
- * (an instance of Menu), or a check box (an instance of
- * CheckboxMenuItem).
+ * Each item in a menu must belong to the {@code MenuItem}
+ * class. It can be an instance of {@code MenuItem}, a submenu
+ * (an instance of {@code Menu}), or a check box (an instance of
+ * {@code CheckboxMenuItem}).
*
* @author Sami Shaio
* @see java.awt.MenuItem
@@ -83,8 +83,8 @@
/**
* This field indicates whether the menu has the
* tear of property or not. It will be set to
- * true if the menu has the tear off
- * property and it will be set to false
+ * {@code true} if the menu has the tear off
+ * property and it will be set to {@code false}
* if it does not.
* A torn off menu can be deleted by a user when
* it is no longer needed.
@@ -95,10 +95,10 @@
boolean tearOff;
/**
- * This field will be set to true
+ * This field will be set to {@code true}
* if the Menu in question is actually a help
- * menu. Otherwise it will be set to
- * false.
+ * menu. Otherwise it will be set to
+ * {@code false}.
*
* @serial
*/
@@ -146,7 +146,7 @@
* support tear-off menus, this value is silently ignored.
* @param label the menu's label in the menu bar, or in
* another menu of which this menu is a submenu.
- * @param tearOff if true, the menu
+ * @param tearOff if {@code true}, the menu
* is a tear-off menu.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
@@ -204,8 +204,8 @@
* Tear-off functionality may not be supported by all
* implementations of AWT. If a particular implementation doesn't
* support tear-off menus, this value is silently ignored.
- * @return true if this is a tear-off menu;
- * false otherwise.
+ * @return {@code true} if this is a tear-off menu;
+ * {@code false} otherwise.
*/
public boolean isTearOff() {
return tearOff;
@@ -225,7 +225,7 @@
*
* @return the number of items in this menu
* @deprecated As of JDK version 1.1,
- * replaced by getItemCount().
+ * replaced by {@code getItemCount()}.
*/
@Deprecated
public int countItems() {
@@ -304,7 +304,7 @@
* @see java.awt.Menu#add(java.lang.String)
* @see java.awt.Menu#add(java.awt.MenuItem)
* @exception IllegalArgumentException if the value of
- * index is less than zero
+ * {@code index} is less than zero
* @since 1.1
*/
@@ -340,7 +340,7 @@
/**
* Inserts a menu item with the specified label into this menu
* at the specified position. This is a convenience method for
- * insert(menuItem, index).
+ * {@code insert(menuItem, index)}.
*
* @param label the text on the item
* @param index the position at which the menu item
@@ -348,7 +348,7 @@
* @see java.awt.Menu#add(java.lang.String)
* @see java.awt.Menu#add(java.awt.MenuItem)
* @exception IllegalArgumentException if the value of
- * index is less than zero
+ * {@code index} is less than zero
* @since 1.1
*/
@@ -369,7 +369,7 @@
* @param index the position at which the
* menu separator should be inserted.
* @exception IllegalArgumentException if the value of
- * index is less than 0.
+ * {@code index} is less than 0.
* @see java.awt.Menu#addSeparator
* @since 1.1
*/
@@ -423,7 +423,7 @@
/**
* Removes the specified menu item from this menu.
* @param item the item to be removed from the menu.
- * If item is null
+ * If {@code item} is {@code null}
* or is not in this menu, this method does
* nothing.
*/
@@ -519,7 +519,7 @@
/**
* Writes default serializable fields to stream.
*
- * @param s the ObjectOutputStream to write
+ * @param s the {@code ObjectOutputStream} to write
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see #readObject(ObjectInputStream)
*/
@@ -530,13 +530,13 @@
}
/**
- * Reads the ObjectInputStream.
+ * Reads the {@code ObjectInputStream}.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #writeObject(ObjectOutputStream)
*/
@@ -552,11 +552,11 @@
}
/**
- * Returns a string representing the state of this Menu.
+ * Returns a string representing the state of this {@code Menu}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this menu
*/
@@ -606,7 +606,7 @@
* subclassed by menu component developers.
* Menu class. It provides an implementation of the
+ * {@code Menu} class. It provides an implementation of the
* Java Accessibility API appropriate to menu user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/MenuBar.java 2015-10-04 22:52:52.765273742 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuBar.java 2015-10-04 22:52:52.577273750 +0400
@@ -34,10 +34,10 @@
import javax.accessibility.*;
/**
- * The MenuBar class encapsulates the platform's
+ * The {@code MenuBar} class encapsulates the platform's
* concept of a menu bar bound to a frame. In order to associate
- * the menu bar with a Frame object, call the
- * frame's setMenuBar method.
+ * the menu bar with a {@code Frame} object, call the
+ * frame's {@code setMenuBar} method.
* MenuShortcut.
- * The MenuBar class defines several methods,
+ * Each menu item can maintain an instance of {@code MenuShortcut}.
+ * The {@code MenuBar} class defines several methods,
* {@link MenuBar#shortcuts} and
* {@link MenuBar#getShortcutMenuItem}
* that retrieve information about the shortcuts a given
@@ -289,7 +289,7 @@
*
* @return the number of menus on the menu bar.
* @deprecated As of JDK version 1.1,
- * replaced by getMenuCount().
+ * replaced by {@code getMenuCount()}.
*/
@Deprecated
public int countMenus() {
@@ -342,9 +342,9 @@
}
/**
- * Gets the instance of MenuItem associated
- * with the specified MenuShortcut object,
- * or null if none of the menu items being managed
+ * Gets the instance of {@code MenuItem} associated
+ * with the specified {@code MenuShortcut} object,
+ * or {@code null} if none of the menu items being managed
* by this menu bar is associated with the specified menu
* shortcut.
* @param s the specified menu shortcut.
@@ -420,7 +420,7 @@
/**
* Writes default serializable fields to stream.
*
- * @param s the ObjectOutputStream to write
+ * @param s the {@code ObjectOutputStream} to write
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see #readObject(java.io.ObjectInputStream)
*/
@@ -432,13 +432,13 @@
}
/**
- * Reads the ObjectInputStream.
+ * Reads the {@code ObjectInputStream}.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #writeObject(java.io.ObjectOutputStream)
*/
@@ -494,7 +494,7 @@
* subclassed by menu component developers.
* MenuBar class. It provides an implementation of the
+ * {@code MenuBar} class. It provides an implementation of the
* Java Accessibility API appropriate to menu bar user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/MenuComponent.java 2015-10-04 22:52:53.293273718 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuComponent.java 2015-10-04 22:52:53.105273726 +0400
@@ -38,13 +38,13 @@
import java.security.AccessController;
/**
- * The abstract class MenuComponent is the superclass
+ * The abstract class {@code MenuComponent} is the superclass
* of all menu-related components. In this respect, the class
- * MenuComponent is analogous to the abstract superclass
- * Component for AWT components.
+ * {@code MenuComponent} is analogous to the abstract superclass
+ * {@code Component} for AWT components.
* processEvent.
+ * through the method {@code processEvent}.
*
* @author Arthur van Hoff
* @since 1.0
@@ -63,15 +63,15 @@
transient MenuContainer parent;
/**
- * The AppContext of the MenuComponent.
+ * The {@code AppContext} of the {@code MenuComponent}.
* This is set in the constructor and never changes.
*/
transient AppContext appContext;
/**
* The menu component's font. This value can be
- * null at which point a default will be used.
- * This defaults to null.
+ * {@code null} at which point a default will be used.
+ * This defaults to {@code null}.
*
* @serial
* @see #setFont(Font)
@@ -80,7 +80,7 @@
volatile Font font;
/**
- * The menu component's name, which defaults to null.
+ * The menu component's name, which defaults to {@code null}.
* @serial
* @see #getName()
* @see #setName(String)
@@ -89,15 +89,15 @@
/**
* A variable to indicate whether a name is explicitly set.
- * If true the name will be set explicitly.
- * This defaults to false.
+ * If {@code true} the name will be set explicitly.
+ * This defaults to {@code false}.
* @serial
* @see #setName(String)
*/
private boolean nameExplicitlySet = false;
/**
- * Defaults to false.
+ * Defaults to {@code false}.
* @serial
* @see #dispatchEvent(AWTEvent)
*/
@@ -164,10 +164,10 @@
}
/**
- * Creates a MenuComponent.
+ * Creates a {@code MenuComponent}.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless
- * returns true
+ * {@code GraphicsEnvironment.isHeadless}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public MenuComponent() throws HeadlessException {
@@ -176,9 +176,9 @@
}
/**
- * Constructs a name for this MenuComponent.
- * Called by getName when the name is null.
- * @return a name for this MenuComponent
+ * Constructs a name for this {@code MenuComponent}.
+ * Called by {@code getName} when the name is {@code null}.
+ * @return a name for this {@code MenuComponent}
*/
String constructComponentName() {
return null; // For strict compliance with prior platform versions, a MenuComponent
@@ -226,7 +226,7 @@
/**
* Returns the parent container for this menu component.
* @return the menu component containing this menu component,
- * or null if this menu component
+ * or {@code null} if this menu component
* is the outermost component, the menu bar itself
*/
public MenuContainer getParent() {
@@ -243,7 +243,7 @@
/**
* Gets the font used for this menu component.
* @return the font used in this menu component, if there is one;
- * null otherwise
+ * {@code null} otherwise
* @see java.awt.MenuComponent#setFont
*/
public Font getFont() {
@@ -290,7 +290,7 @@
* component, unless those subcomponents specify a different font.
* setFont
+ * of a menu component; in such cases, calling {@code setFont}
* will have no effect on the unsupported font attributes of this
* menu component. Unless subcomponents of this menu component
* specify a different font, this font will be used by those
@@ -385,7 +385,7 @@
}
/**
* Processes events occurring on this menu component.
- * null
+ * MenuComponent. This method is intended to be used
+ * {@code MenuComponent}. This method is intended to be used
* only for debugging purposes, and the content and format of the
* returned string may vary between implementations. The returned
- * string may be empty but may not be null.
+ * string may be empty but may not be {@code null}.
*
* @return the parameter string of this menu component
*/
@@ -430,10 +430,10 @@
/**
* Reads the menu component from an object input stream.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @serial
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -466,16 +466,16 @@
AccessibleContext accessibleContext = null;
/**
- * Gets the AccessibleContext associated with
- * this MenuComponent.
+ * Gets the {@code AccessibleContext} associated with
+ * this {@code MenuComponent}.
*
- * The method implemented by this base class returns null.
- * Classes that extend MenuComponent
+ * The method implemented by this base class returns {@code null}.
+ * Classes that extend {@code MenuComponent}
* should implement this method to return the
- * AccessibleContext associated with the subclass.
+ * {@code AccessibleContext} associated with the subclass.
*
- * @return the AccessibleContext of this
- * MenuComponent
+ * @return the {@code AccessibleContext} of this
+ * {@code MenuComponent}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
@@ -483,7 +483,7 @@
}
/**
- * Inner class of MenuComponent used to provide
+ * Inner class of {@code MenuComponent} used to provide
* default support for accessibility. This class is not meant
* to be used directly by application developers, but is instead
* meant only to be subclassed by menu component developers.
@@ -512,11 +512,11 @@
//
/**
- * Gets the AccessibleSelection associated with this
- * object which allows its Accessible children to be selected.
+ * Gets the {@code AccessibleSelection} associated with this
+ * object which allows its {@code Accessible} children to be selected.
*
- * @return AccessibleSelection if supported by object;
- * else return null
+ * @return {@code AccessibleSelection} if supported by object;
+ * else return {@code null}
* @see AccessibleSelection
*/
public AccessibleSelection getAccessibleSelection() {
@@ -525,14 +525,14 @@
/**
* Gets the accessible name of this object. This should almost never
- * return java.awt.MenuComponent.getName, as that
+ * return {@code java.awt.MenuComponent.getName}, as that
* generally isn't a localized name, and doesn't have meaning for the
* user. If the object is fundamentally a text object (e.g. a menu item), the
* accessible name should be the text of the object (e.g. "save").
* If the object has a tooltip, the tooltip text may also be an
* appropriate String to return.
*
- * @return the localized name of the object -- can be null
+ * @return the localized name of the object -- can be {@code null}
* if this object does not have a name
* @see AccessibleContext#setAccessibleName
*/
@@ -552,7 +552,7 @@
* text document" instead).
*
* @return the localized description of the object -- can be
- * null if this object does not have a description
+ * {@code null} if this object does not have a description
* @see AccessibleContext#setAccessibleDescription
*/
public String getAccessibleDescription() {
@@ -562,7 +562,7 @@
/**
* Gets the role of this object.
*
- * @return an instance of AccessibleRole
+ * @return an instance of {@code AccessibleRole}
* describing the role of the object
* @see AccessibleRole
*/
@@ -573,7 +573,7 @@
/**
* Gets the state of this object.
*
- * @return an instance of AccessibleStateSet
+ * @return an instance of {@code AccessibleStateSet}
* containing the current state set of the object
* @see AccessibleState
*/
@@ -582,13 +582,13 @@
}
/**
- * Gets the Accessible parent of this object.
- * If the parent of this object implements Accessible,
- * this method should simply return getParent.
- *
- * @return the Accessible parent of this object -- can
- * be null if this object does not have an
- * Accessible parent
+ * Gets the {@code Accessible} parent of this object.
+ * If the parent of this object implements {@code Accessible},
+ * this method should simply return {@code getParent}.
+ *
+ * @return the {@code Accessible} parent of this object -- can
+ * be {@code null} if this object does not have an
+ * {@code Accessible} parent
*/
public Accessible getAccessibleParent() {
if (accessibleParent != null) {
@@ -615,7 +615,7 @@
/**
* Returns the number of accessible children in the object. If all
- * of the children of this object implement Accessible,
+ * of the children of this object implement {@code Accessible},
* then this method should return the number of children of this object.
*
* @return the number of accessible children in the object
@@ -625,7 +625,7 @@
}
/**
- * Returns the nth Accessible child of the object.
+ * Returns the nth {@code Accessible} child of the object.
*
* @param i zero-based index of child
* @return the nth Accessible child of the object
@@ -648,8 +648,8 @@
}
/**
- * Gets the AccessibleComponent associated with
- * this object if one exists. Otherwise return null.
+ * Gets the {@code AccessibleComponent} associated with
+ * this object if one exists. Otherwise return {@code null}.
*
* @return the component
*/
@@ -664,7 +664,7 @@
* Gets the background color of this object.
*
* @return the background color, if supported, of the object;
- * otherwise, null
+ * otherwise, {@code null}
*/
public Color getBackground() {
return null; // Not supported for MenuComponents
@@ -672,9 +672,9 @@
/**
* Sets the background color of this object.
- * (For transparency, see isOpaque.)
+ * (For transparency, see {@code isOpaque}.)
*
- * @param c the new Color for the background
+ * @param c the new {@code Color} for the background
* @see Component#isOpaque
*/
public void setBackground(Color c) {
@@ -685,7 +685,7 @@
* Gets the foreground color of this object.
*
* @return the foreground color, if supported, of the object;
- * otherwise, null
+ * otherwise, {@code null}
*/
public Color getForeground() {
return null; // Not supported for MenuComponents
@@ -694,59 +694,59 @@
/**
* Sets the foreground color of this object.
*
- * @param c the new Color for the foreground
+ * @param c the new {@code Color} for the foreground
*/
public void setForeground(Color c) {
// Not supported for MenuComponents
}
/**
- * Gets the Cursor of this object.
+ * Gets the {@code Cursor} of this object.
*
- * @return the Cursor, if supported, of the object;
- * otherwise, null
+ * @return the {@code Cursor}, if supported, of the object;
+ * otherwise, {@code null}
*/
public Cursor getCursor() {
return null; // Not supported for MenuComponents
}
/**
- * Sets the Cursor of this object.
+ * Sets the {@code Cursor} of this object.
* Cursor for the object
+ * @param cursor the new {@code Cursor} for the object
*/
public void setCursor(Cursor cursor) {
// Not supported for MenuComponents
}
/**
- * Gets the Font of this object.
+ * Gets the {@code Font} of this object.
*
- * @return the Font,if supported, for the object;
- * otherwise, null
+ * @return the {@code Font},if supported, for the object;
+ * otherwise, {@code null}
*/
public Font getFont() {
return MenuComponent.this.getFont();
}
/**
- * Sets the Font of this object.
+ * Sets the {@code Font} of this object.
*
- * @param f the new Font for the object
+ * @param f the new {@code Font} for the object
*/
public void setFont(Font f) {
MenuComponent.this.setFont(f);
}
/**
- * Gets the FontMetrics of this object.
+ * Gets the {@code FontMetrics} of this object.
*
- * @param f the Font
+ * @param f the {@code Font}
* @return the FontMetrics, if supported, the object;
- * otherwise, null
+ * otherwise, {@code null}
* @see #getFont
*/
public FontMetrics getFontMetrics(Font f) {
@@ -776,7 +776,7 @@
* object intends to be visible; however, it may not in fact be
* showing on the screen because one of the objects that this object
* is contained by is not visible. To determine if an object is
- * showing on the screen, use isShowing.
+ * showing on the screen, use {@code isShowing}.
*
* @return true if object is visible; otherwise, false
*/
@@ -811,9 +811,9 @@
* where the point's x and y coordinates are defined to be relative to
* the coordinate system of the object.
*
- * @param p the Point relative to the coordinate
+ * @param p the {@code Point} relative to the coordinate
* system of the object
- * @return true if object contains Point; otherwise false
+ * @return true if object contains {@code Point}; otherwise false
*/
public boolean contains(Point p) {
return false; // Not supported for MenuComponents
@@ -822,7 +822,7 @@
/**
* Returns the location of the object on the screen.
*
- * @return location of object on screen -- can be null
+ * @return location of object on screen -- can be {@code null}
* if this object is not on the screen
*/
public Point getLocationOnScreen() {
@@ -834,9 +834,9 @@
* of a point specifying the object's top-left corner in the screen's
* coordinate space.
*
- * @return an instance of Point representing the
+ * @return an instance of {@code Point} representing the
* top-left corner of the object's bounds in the coordinate
- * space of the screen; null if
+ * space of the screen; {@code null} if
* this object or its parent are not on the screen
*/
public Point getLocation() {
@@ -852,12 +852,12 @@
/**
* Gets the bounds of this object in the form of a
- * Rectangle object.
+ * {@code Rectangle} object.
* The bounds specify this object's width, height, and location
* relative to its parent.
*
* @return a rectangle indicating this component's bounds;
- * null if this object is not on the screen
+ * {@code null} if this object is not on the screen
*/
public Rectangle getBounds() {
return null; // Not supported for MenuComponents
@@ -865,7 +865,7 @@
/**
* Sets the bounds of this object in the form of a
- * Rectangle object.
+ * {@code Rectangle} object.
* The bounds specify this object's width, height, and location
* relative to its parent.
*
@@ -877,13 +877,13 @@
/**
* Returns the size of this object in the form of a
- * Dimension object. The height field of
- * the Dimension object contains this object's
- * height, and the width field of the Dimension
+ * {@code Dimension} object. The height field of
+ * the {@code Dimension} object contains this object's
+ * height, and the width field of the {@code Dimension}
* object contains this object's width.
*
- * @return a Dimension object that indicates the
- * size of this component; null
+ * @return a {@code Dimension} object that indicates the
+ * size of this component; {@code null}
* if this object is not on the screen
*/
public Dimension getSize() {
@@ -893,7 +893,7 @@
/**
* Resizes this object.
*
- * @param d - the Dimension specifying the
+ * @param d - the {@code Dimension} specifying the
* new size of the object
*/
public void setSize(Dimension d) {
@@ -901,16 +901,16 @@
}
/**
- * Returns the Accessible child, if one exists,
- * contained at the local coordinate Point.
- * If there is no Accessible child, null
+ * Returns the {@code Accessible} child, if one exists,
+ * contained at the local coordinate {@code Point}.
+ * If there is no {@code Accessible} child, {@code null}
* is returned.
*
* @param p the point defining the top-left corner of the
- * Accessible, given in the coordinate space
+ * {@code Accessible}, given in the coordinate space
* of the object's parent
- * @return the Accessible, if it exists,
- * at the specified location; else null
+ * @return the {@code Accessible}, if it exists,
+ * at the specified location; else {@code null}
*/
public Accessible getAccessibleAt(Point p) {
return null; // MenuComponents don't have children
@@ -956,7 +956,7 @@
//
/**
- * Returns the number of Accessible children currently selected.
+ * Returns the number of {@code Accessible} children currently selected.
* If no children are selected, the return value will be 0.
*
* @return the number of items currently selected
@@ -966,10 +966,10 @@
}
/**
- * Returns an Accessible representing the specified
+ * Returns an {@code Accessible} representing the specified
* selected child in the object. If there isn't a selection, or there are
* fewer children selected than the integer passed in, the return
- * value will be null.
+ * value will be {@code null}.
* Accessible object
+ * {@code Accessible} object
* @see AccessibleContext#getAccessibleChild
*/
public boolean isAccessibleChildSelected(int i) {
@@ -995,7 +995,7 @@
}
/**
- * Adds the specified Accessible child of the object
+ * Adds the specified {@code Accessible} child of the object
* to the object's selection. If the object supports multiple selections,
* the specified child is added to any existing selection, otherwise
* it replaces any existing selection in the object. If the
@@ -1068,7 +1068,7 @@
/**
* Gets the state of this object.
*
- * @return an instance of AccessibleStateSet
+ * @return an instance of {@code AccessibleStateSet}
* containing the current state set of the object
* @see AccessibleState
*/
--- old/src/java.desktop/share/classes/java/awt/MenuItem.java 2015-10-04 22:52:53.837273693 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuItem.java 2015-10-04 22:52:53.645273702 +0400
@@ -35,9 +35,9 @@
/**
* All items in a menu must belong to the class
- * MenuItem, or one of its subclasses.
+ * {@code MenuItem}, or one of its subclasses.
* MenuItem object embodies
+ * The default {@code MenuItem} object embodies
* a simple labeled menu item.
*
* The first two items are simple menu items, labeled
- * "Basic" and "Simple".
+ * {@code "Basic"} and {@code "Simple"}.
* Following these two items is a separator, which is itself
- * a menu item, created with the label "-".
- * Next is an instance of CheckboxMenuItem
- * labeled "Check". The final menu item is a
+ * a menu item, created with the label {@code "-"}.
+ * Next is an instance of {@code CheckboxMenuItem}
+ * labeled {@code "Check"}. The final menu item is a
* submenu labeled "More Examples",
- * and this submenu is an instance of Menu.
+ * and this submenu is an instance of {@code Menu}.
* ActionEvent, the processEvent
+ * instance of {@code ActionEvent}, the {@code processEvent}
* method examines the event and passes it along to
- * processActionEvent. The latter method redirects the
- * event to any ActionListener objects that have
+ * {@code processActionEvent}. The latter method redirects the
+ * event to any {@code ActionListener} objects that have
* registered an interest in action events generated by this
* menu item.
* Menu overrides this behavior and
+ * Note that the subclass {@code Menu} overrides this behavior and
* does not send any event to the frame until one of its subitems is
* selected.
*
@@ -103,8 +103,8 @@
/**
* A value to indicate whether a menu item is enabled
- * or not. If it is enabled, enabled will
- * be set to true. Else enabled will
+ * or not. If it is enabled, {@code enabled} will
+ * be set to true. Else {@code enabled} will
* be set to false.
*
* @serial
@@ -114,7 +114,7 @@
boolean enabled = true;
/**
- * label is the label of a menu item.
+ * {@code label} is the label of a menu item.
* It can be any string.
*
* @serial
@@ -126,7 +126,7 @@
/**
* This field indicates the command tha has been issued
* by a particular menu item.
- * By default the actionCommand
+ * By default the {@code actionCommand}
* is the label of the menu item, unless it has been
* set using setActionCommand.
*
@@ -204,7 +204,7 @@
* a separator between menu items. By default, all menu
* items except for separators are enabled.
* @param label the label for this menu item.
- * @param s the instance of MenuShortcut
+ * @param s the instance of {@code MenuShortcut}
* associated with this menu item.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
@@ -239,7 +239,7 @@
/**
* Gets the label for this menu item.
- * @return the label of this menu item, or null
+ * @return the label of this menu item, or {@code null}
if this menu item has no label.
* @see java.awt.MenuItem#setLabel
* @since 1.0
@@ -250,7 +250,7 @@
/**
* Sets the label for this menu item to the specified label.
- * @param label the new label, or null for no label.
+ * @param label the new label, or {@code null} for no label.
* @see java.awt.MenuItem#getLabel
* @since 1.0
*/
@@ -276,8 +276,8 @@
/**
* Sets whether or not this menu item can be chosen.
- * @param b if true, enables this menu item;
- * if false, disables it.
+ * @param b if {@code true}, enables this menu item;
+ * if {@code false}, disables it.
* @see java.awt.MenuItem#isEnabled
* @since 1.1
*/
@@ -287,7 +287,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public synchronized void enable() {
@@ -304,7 +304,7 @@
* @param b if {@code true}, enables this menu item;
* otherwise disables
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public void enable(boolean b) {
@@ -317,7 +317,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public synchronized void disable() {
@@ -329,10 +329,10 @@
}
/**
- * Get the MenuShortcut object associated with this
+ * Get the {@code MenuShortcut} object associated with this
* menu item,
* @return the menu shortcut associated with this menu item,
- * or null if none has been specified.
+ * or {@code null} if none has been specified.
* @see java.awt.MenuItem#setShortcut
* @since 1.1
*/
@@ -341,7 +341,7 @@
}
/**
- * Set the MenuShortcut object associated with this
+ * Set the {@code MenuShortcut} object associated with this
* menu item. If a menu shortcut is already associated with
* this menu item, it is replaced.
* @param s the menu shortcut to associate
@@ -358,7 +358,7 @@
}
/**
- * Delete any MenuShortcut object associated
+ * Delete any {@code MenuShortcut} object associated
* with this menu item.
* @since 1.1
*/
@@ -454,8 +454,8 @@
* MenuItem which desire to
- * have the specified event types delivered to processEvent
+ * to be invoked by subclasses of {@code MenuItem} which desire to
+ * have the specified event types delivered to {@code processEvent}
* regardless of whether a listener is registered.
*
* @param eventsToEnable the event mask defining the event types
@@ -562,7 +562,7 @@
* Returns an array of all the action listeners
* registered on this menu item.
*
- * @return all of this menu item's ActionListeners
+ * @return all of this menu item's {@code ActionListener}s
* or an empty array if no action
* listeners are currently registered
*
@@ -579,16 +579,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this MenuItem.
+ * upon this {@code MenuItem}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * MenuItem m
+ * {@code MenuItem m}
* for its action listeners with the following code:
*
* ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));
@@ -598,14 +598,14 @@
* @param java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this menu item,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getActionListeners
* @since 1.3
@@ -620,12 +620,12 @@
/**
* Processes events on this menu item. If the event is an
- * instance of ActionEvent, it invokes
- * processActionEvent, another method
- * defined by MenuItem.
+ * instance of {@code ActionEvent}, it invokes
+ * {@code processActionEvent}, another method
+ * defined by {@code MenuItem}.
* null
+ * ActionListener objects.
+ * {@code ActionListener} objects.
* This method is not called unless action events are
* enabled for this component. Action events are enabled
* when one of the following occurs:
*
- *
- * ActionListener object is registered
- * via addActionListener.
- * enableEvents.
+ * null
+ * MenuItem.
+ * Returns a string representing the state of this {@code MenuItem}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this menu item
*/
@@ -710,17 +710,17 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable ActionListeners
+ * a list of serializable {@code ActionListeners}
* as optional data. The non-serializable listeners are
* detected and no attempt is made to serialize them.
*
- * @param s the ObjectOutputStream to write
- * @serialData null terminated sequence of 0
- * or more pairs; the pair consists of a String
- * and an Object; the String
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData {@code null} terminated sequence of 0
+ * or more pairs; the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String}
* indicates the type of object and is one of the following:
- * actionListenerK indicating an
- * ActionListener object
+ * {@code actionListenerK} indicating an
+ * {@code ActionListener} object
*
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see #readObject(ObjectInputStream)
@@ -735,15 +735,15 @@
}
/**
- * Reads the ObjectInputStream and if it
- * isn't null adds a listener to receive
- * action events fired by the Menu Item.
+ * Reads the {@code ObjectInputStream} and if it
+ * isn't {@code null} adds a listener to receive
+ * action events fired by the {@code Menu} Item.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @see #removeActionListener(ActionListener)
* @see #addActionListener(ActionListener)
* @see #writeObject(ObjectOutputStream)
@@ -800,7 +800,7 @@
* subclassed by menu component developers.
* MenuItem class. It provides an implementation of the
+ * {@code MenuItem} class. It provides an implementation of the
* Java Accessibility API appropriate to menu item user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/MenuShortcut.java 2015-10-04 22:52:54.393273668 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuShortcut.java 2015-10-04 22:52:54.185273678 +0400
@@ -27,27 +27,27 @@
import java.awt.event.KeyEvent;
/**
- * The MenuShortcutclass represents a keyboard accelerator
+ * The {@code MenuShortcut} class represents a keyboard accelerator
* for a MenuItem.
* MenuShortcut ms = new MenuShortcut(KeyEvent.VK_A, false);
+ * {@code MenuShortcut ms = new MenuShortcut(KeyEvent.VK_A, false);}
* MenuShortcut ms = new MenuShortcut(KeyEvent.getExtendedKeyCodeForChar('A'), false);
+ * {@code MenuShortcut ms = new MenuShortcut(KeyEvent.getExtendedKeyCodeForChar('A'), false);}
* java.awt.event.KeyEvent.getExtendedKeyCodeForChar call.
+ * using the {@code java.awt.event.KeyEvent.getExtendedKeyCodeForChar} call.
* For example, a menu shortcut for "Ctrl+cyrillic ef" is created by
* MenuShortcut ms = new MenuShortcut(KeyEvent.getExtendedKeyCodeForChar('\u0444'), false);
* KeyEvent
+ * Note that shortcuts created with a keycode or an extended keycode defined as a constant in {@code KeyEvent}
* work regardless of the current keyboard layout. However, a shortcut made of
- * an extended keycode not listed in KeyEvent
+ * an extended keycode not listed in {@code KeyEvent}
* only work if the current keyboard layout produces a corresponding letter.
* true if this MenuShortcut must be invoked using the
- * SHIFT key, false otherwise.
+ * @return {@code true} if this MenuShortcut must be invoked using the
+ * SHIFT key, {@code false} otherwise.
* @since 1.1
*/
public boolean usesShiftModifier() {
@@ -141,8 +141,8 @@
* equality is defined to mean that both MenuShortcuts use the same key
* and both either use or don't use the SHIFT key.
* @param s the MenuShortcut to compare with this.
- * @return true if this MenuShortcut is the same as another,
- * false otherwise.
+ * @return {@code true} if this MenuShortcut is the same as another,
+ * {@code false} otherwise.
* @since 1.1
*/
public boolean equals(MenuShortcut s) {
@@ -155,8 +155,8 @@
* equality is defined to mean that both MenuShortcuts use the same key
* and both either use or don't use the SHIFT key.
* @param obj the Object to compare with this.
- * @return true if this MenuShortcut is the same as another,
- * false otherwise.
+ * @return {@code true} if this MenuShortcut is the same as another,
+ * {@code false} otherwise.
* @since 1.2
*/
public boolean equals(Object obj) {
--- old/src/java.desktop/share/classes/java/awt/MouseInfo.java 2015-10-04 22:52:54.917273645 +0400
+++ new/src/java.desktop/share/classes/java/awt/MouseInfo.java 2015-10-04 22:52:54.729273653 +0400
@@ -29,7 +29,7 @@
import sun.awt.ComponentFactory;
/**
- * MouseInfo provides methods for getting information about the mouse,
+ * {@code MouseInfo} provides methods for getting information about the mouse,
* such as mouse pointer location and the number of mouse buttons.
*
* @author Roman Poborchiy
@@ -45,26 +45,26 @@
}
/**
- * Returns a PointerInfo instance that represents the current
+ * Returns a {@code PointerInfo} instance that represents the current
* location of the mouse pointer.
- * The GraphicsDevice stored in this PointerInfo
+ * The {@code GraphicsDevice} stored in this {@code PointerInfo}
* contains the mouse pointer. The coordinate system used for the mouse position
- * depends on whether or not the GraphicsDevice is part of a virtual
+ * depends on whether or not the {@code GraphicsDevice} is part of a virtual
* screen device.
* For virtual screen devices, the coordinates are given in the virtual
* coordinate system, otherwise they are returned in the coordinate system
- * of the GraphicsDevice. See {@link GraphicsConfiguration}
+ * of the {@code GraphicsDevice}. See {@link GraphicsConfiguration}
* for more information about the virtual screen devices.
- * On systems without a mouse, returns null.
+ * On systems without a mouse, returns {@code null}.
* checkPermission method
- * is called with an AWTPermission("watchMousePointer")
- * permission before creating and returning a PointerInfo
- * object. This may result in a SecurityException.
+ * If there is a security manager, its {@code checkPermission} method
+ * is called with an {@code AWTPermission("watchMousePointer")}
+ * permission before creating and returning a {@code PointerInfo}
+ * object. This may result in a {@code SecurityException}.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless() returns true
* @exception SecurityException if a security manager exists and its
- * checkPermission method doesn't allow the operation
+ * {@code checkPermission} method doesn't allow the operation
* @see GraphicsConfiguration
* @see SecurityManager#checkPermission
* @see java.awt.AWTPermission
@@ -118,7 +118,7 @@
/**
* Returns the number of buttons on the mouse.
- * On systems without a mouse, returns -1.
+ * On systems without a mouse, returns {@code -1}.
* The number of buttons is obtained from the AWT Toolkit
* by requesting the {@code "awt.mouse.numButtons"} desktop property
* which is set by the underlying native platform.
--- old/src/java.desktop/share/classes/java/awt/PageAttributes.java 2015-10-04 22:52:55.437273622 +0400
+++ new/src/java.desktop/share/classes/java/awt/PageAttributes.java 2015-10-04 22:52:55.249273630 +0400
@@ -942,7 +942,7 @@
* @param printerResolution an integer array of 3 elements. The first
* element must be greater than 0. The second element must be
* must be greater than 0. The third element must be either
- * 3 or 4.
+ * {@code 3} or {@code 4}.
* @throws IllegalArgumentException if one or more of the above
* conditions is violated.
*/
@@ -1095,14 +1095,14 @@
/**
* Specifies the print orientation for pages using these attributes.
- * Specifying 3 denotes portrait. Specifying 4
+ * Specifying {@code 3} denotes portrait. Specifying {@code 4}
* denotes landscape. Specifying any other value will generate an
* IllegalArgumentException. Not specifying the property is equivalent
* to calling setOrientationRequested(OrientationRequestedType.PORTRAIT).
*
- * @param orientationRequested 3 or 4
+ * @param orientationRequested {@code 3} or {@code 4}
* @throws IllegalArgumentException if orientationRequested is not
- * 3 or 4
+ * {@code 3} or {@code 4}
*/
public void setOrientationRequested(int orientationRequested) {
switch (orientationRequested) {
@@ -1189,15 +1189,15 @@
/**
* Specifies the print quality for pages using these attributes.
- * Specifying 3 denotes draft. Specifying 4
- * denotes normal. Specifying 5 denotes high. Specifying
+ * Specifying {@code 3} denotes draft. Specifying {@code 4}
+ * denotes normal. Specifying {@code 5} denotes high. Specifying
* any other value will generate an IllegalArgumentException. Not
* specifying the property is equivalent to calling
* setPrintQuality(PrintQualityType.NORMAL).
*
- * @param printQuality 3, 4, or 5
- * @throws IllegalArgumentException if printQuality is not 3
- * , 4, or 5
+ * @param printQuality {@code 3}, {@code 4}, or {@code 5}
+ * @throws IllegalArgumentException if printQuality is not
+ * {@code 3}, {@code 4}, or {@code 5}
*/
public void setPrintQuality(int printQuality) {
switch (printQuality) {
@@ -1231,13 +1231,13 @@
* (typically the horizontal resolution). Index 1 of the array specifies
* the feed direction resolution (typically the vertical resolution).
* Index 2 of the array specifies whether the resolutions are in dots per
- * inch or dots per centimeter. 3 denotes dots per inch.
- * 4 denotes dots per centimeter.
+ * inch or dots per centimeter. {@code 3} denotes dots per inch.
+ * {@code 4} denotes dots per centimeter.
*
* @return an integer array of 3 elements. The first
* element must be greater than 0. The second element must be
* must be greater than 0. The third element must be either
- * 3 or 4.
+ * {@code 3} or {@code 4}.
*/
public int[] getPrinterResolution() {
// Return a copy because otherwise client code could circumvent the
@@ -1258,7 +1258,7 @@
* resolution). Index 1 of the array specifies the feed direction
* resolution (typically the vertical resolution). Index 2 of the array
* specifies whether the resolutions are in dots per inch or dots per
- * centimeter. 3 denotes dots per inch. 4
+ * centimeter. {@code 3} denotes dots per inch. {@code 4}
* denotes dots per centimeter. Note that the 1.1 printing implementation
* (Toolkit.getPrintJob) requires that the feed and cross feed resolutions
* be the same. Not specifying the property is equivalent to calling
@@ -1267,7 +1267,7 @@
* @param printerResolution an integer array of 3 elements. The first
* element must be greater than 0. The second element must be
* must be greater than 0. The third element must be either
- * 3 or 4.
+ * {@code 3} or {@code 4}.
* @throws IllegalArgumentException if one or more of the above
* conditions is violated.
*/
@@ -1295,7 +1295,7 @@
* inch for pages using these attributes. The same value is used for both
* resolutions. The actual resolutions will be determined by the
* limitations of the implementation and the target printer. Not
- * specifying the property is equivalent to specifying 72.
+ * specifying the property is equivalent to specifying {@code 72}.
*
* @param printerResolution an integer greater than 0.
* @throws IllegalArgumentException if printerResolution is less than or
--- old/src/java.desktop/share/classes/java/awt/Paint.java 2015-10-04 22:52:55.977273597 +0400
+++ new/src/java.desktop/share/classes/java/awt/Paint.java 2015-10-04 22:52:55.789273606 +0400
@@ -30,16 +30,16 @@
import java.awt.geom.Rectangle2D;
/**
- * This Paint interface defines how color patterns
+ * This {@code Paint} interface defines how color patterns
* can be generated for {@link Graphics2D} operations. A class
- * implementing the Paint interface is added to the
- * Graphics2D context in order to define the color
- * pattern used by the draw and fill methods.
+ * implementing the {@code Paint} interface is added to the
+ * {@code Graphics2D} context in order to define the color
+ * pattern used by the {@code draw} and {@code fill} methods.
* Paint must be
- * read-only because the Graphics2D does not clone
+ * Instances of classes implementing {@code Paint} must be
+ * read-only because the {@code Graphics2D} does not clone
* these objects when they are set as an attribute with the
- * setPaint method or when the Graphics2D
+ * {@code setPaint} method or when the {@code Graphics2D}
* object is itself cloned.
* @see PaintContext
* @see Color
@@ -74,22 +74,22 @@
* of the graphics primitive being rendered.
* Implementations of the {@code Paint} interface
* are allowed to throw {@code NullPointerException}
- * for a {@code null} {@code deviceBounds}.
+ * for a {@code null deviceBounds}.
* @param userBounds the user space bounding box
* of the graphics primitive being rendered.
* Implementations of the {@code Paint} interface
* are allowed to throw {@code NullPointerException}
- * for a {@code null} {@code userBounds}.
+ * for a {@code null userBounds}.
* @param xform the {@link AffineTransform} from user
* space into device space.
* Implementations of the {@code Paint} interface
* are allowed to throw {@code NullPointerException}
- * for a {@code null} {@code xform}.
+ * for a {@code null xform}.
* @param hints the set of hints that the context object can use to
* choose between rendering alternatives.
* Implementations of the {@code Paint} interface
* are allowed to throw {@code NullPointerException}
- * for a {@code null} {@code hints}.
+ * for a {@code null hints}.
* @return the {@code PaintContext} for
* generating color patterns.
* @see PaintContext
--- old/src/java.desktop/share/classes/java/awt/PaintContext.java 2015-10-04 22:52:56.501273574 +0400
+++ new/src/java.desktop/share/classes/java/awt/PaintContext.java 2015-10-04 22:52:56.309273582 +0400
@@ -29,13 +29,13 @@
import java.awt.image.ColorModel;
/**
- * The PaintContext interface defines the encapsulated
+ * The {@code PaintContext} interface defines the encapsulated
* and optimized environment to generate color patterns in device
* space for fill or stroke operations on a
- * {@link Graphics2D}. The PaintContext provides
- * the necessary colors for Graphics2D operations in the
+ * {@link Graphics2D}. The {@code PaintContext} provides
+ * the necessary colors for {@code Graphics2D} operations in the
* form of a {@link Raster} associated with a {@link ColorModel}.
- * The PaintContext maintains state for a particular paint
+ * The {@code PaintContext} maintains state for a particular paint
* operation. In a multi-threaded environment, several
* contexts can exist simultaneously for a single {@link Paint} object.
* @see Paint
@@ -48,20 +48,20 @@
public void dispose();
/**
- * Returns the ColorModel of the output. Note that
- * this ColorModel might be different from the hint
+ * Returns the {@code ColorModel} of the output. Note that
+ * this {@code ColorModel} might be different from the hint
* specified in the
* {@link Paint#createContext(ColorModel, Rectangle, Rectangle2D,
AffineTransform, RenderingHints) createContext} method of
- * Paint. Not all PaintContext objects are
+ * {@code Paint}. Not all {@code PaintContext} objects are
* capable of generating color patterns in an arbitrary
- * ColorModel.
- * @return the ColorModel of the output.
+ * {@code ColorModel}.
+ * @return the {@code ColorModel} of the output.
*/
ColorModel getColorModel();
/**
- * Returns a Raster containing the colors generated for
+ * Returns a {@code Raster} containing the colors generated for
* the graphics operation.
* @param x the x coordinate of the area in device space
* for which colors are generated.
@@ -69,7 +69,7 @@
* for which colors are generated.
* @param w the width of the area in device space
* @param h the height of the area in device space
- * @return a Raster representing the specified
+ * @return a {@code Raster} representing the specified
* rectangular area and containing the colors generated for
* the graphics operation.
*/
--- old/src/java.desktop/share/classes/java/awt/Panel.java 2015-10-04 22:52:57.021273550 +0400
+++ new/src/java.desktop/share/classes/java/awt/Panel.java 2015-10-04 22:52:56.833273559 +0400
@@ -27,12 +27,12 @@
import javax.accessibility.*;
/**
- * Panel is the simplest container class. A panel
+ * {@code Panel} is the simplest container class. A panel
* provides space in which an application can attach any other
* component, including other panels.
* FlowLayout layout manager.
+ * {@code FlowLayout} layout manager.
*
* @author Sami Shaio
* @see java.awt.FlowLayout
@@ -50,7 +50,7 @@
/**
* Creates a new panel using the default layout manager.
* The default layout manager for all panels is the
- * FlowLayout class.
+ * {@code FlowLayout} class.
*/
public Panel() {
this(new FlowLayout());
@@ -111,7 +111,7 @@
/**
* This class implements accessibility support for the
- * Panel class. It provides an implementation of the
+ * {@code Panel} class. It provides an implementation of the
* Java Accessibility API appropriate to panel user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/Point.java 2015-10-04 22:52:57.545273527 +0400
+++ new/src/java.desktop/share/classes/java/awt/Point.java 2015-10-04 22:52:57.353273536 +0400
@@ -37,7 +37,7 @@
*/
public class Point extends Point2D implements java.io.Serializable {
/**
- * The X coordinate of this Point.
+ * The X coordinate of this {@code Point}.
* If no X coordinate is set it will default to 0.
*
* @serial
@@ -48,7 +48,7 @@
public int x;
/**
- * The Y coordinate of this Point.
+ * The Y coordinate of this {@code Point}.
* If no Y coordinate is set it will default to 0.
*
* @serial
@@ -74,7 +74,7 @@
/**
* Constructs and initializes a point with the same location as
- * the specified Point object.
+ * the specified {@code Point} object.
* @param p a point
* @since 1.1
*/
@@ -85,8 +85,8 @@
/**
* Constructs and initializes a point at the specified
* {@code (x,y)} location in the coordinate space.
- * @param x the X coordinate of the newly constructed Point
- * @param y the Y coordinate of the newly constructed Point
+ * @param x the X coordinate of the newly constructed {@code Point}
+ * @param y the Y coordinate of the newly constructed {@code Point}
* @since 1.0
*/
public Point(int x, int y) {
@@ -113,7 +113,7 @@
/**
* Returns the location of this point.
* This method is included for completeness, to parallel the
- * getLocation method of Component.
+ * {@code getLocation} method of {@code Component}.
* @return a copy of this point, at the same location
* @see java.awt.Component#getLocation
* @see java.awt.Point#setLocation(java.awt.Point)
@@ -128,7 +128,7 @@
/**
* Sets the location of the point to the specified location.
* This method is included for completeness, to parallel the
- * setLocation method of Component.
+ * {@code setLocation} method of {@code Component}.
* @param p a point, the new location for this point
* @see java.awt.Component#setLocation(java.awt.Point)
* @see java.awt.Point#getLocation
@@ -142,7 +142,7 @@
* Changes the point to have the specified location.
* setLocation method of Component.
+ * {@code setLocation} method of {@code Component}.
* Its behavior is identical with move(int, int).
* @param x the X coordinate of the new location
* @param y the Y coordinate of the new location
@@ -158,10 +158,10 @@
/**
* Sets the location of this point to the specified double coordinates.
* The double values will be rounded to integer values.
- * Any number smaller than Integer.MIN_VALUE
- * will be reset to MIN_VALUE, and any number
- * larger than Integer.MAX_VALUE will be
- * reset to MAX_VALUE.
+ * Any number smaller than {@code Integer.MIN_VALUE}
+ * will be reset to {@code MIN_VALUE}, and any number
+ * larger than {@code Integer.MAX_VALUE} will be
+ * reset to {@code MAX_VALUE}.
*
* @param x the X coordinate of the new location
* @param y the Y coordinate of the new location
@@ -203,13 +203,13 @@
/**
* Determines whether or not two points are equal. Two instances of
- * Point2D are equal if the values of their
- * x and y member fields, representing
+ * {@code Point2D} are equal if the values of their
+ * {@code x} and {@code y} member fields, representing
* their position in the coordinate space, are the same.
- * @param obj an object to be compared with this Point2D
- * @return true if the object to be compared is
- * an instance of Point2D and has
- * the same values; false otherwise.
+ * @param obj an object to be compared with this {@code Point2D}
+ * @return {@code true} if the object to be compared is
+ * an instance of {@code Point2D} and has
+ * the same values; {@code false} otherwise.
*/
public boolean equals(Object obj) {
if (obj instanceof Point) {
@@ -224,7 +224,7 @@
* in the {@code (x,y)} coordinate space. This method is
* intended to be used only for debugging purposes, and the content
* and format of the returned string may vary between implementations.
- * The returned string may be empty but may not be null.
+ * The returned string may be empty but may not be {@code null}.
*
* @return a string representation of this point
*/
--- old/src/java.desktop/share/classes/java/awt/Polygon.java 2015-10-04 22:52:58.069273503 +0400
+++ new/src/java.desktop/share/classes/java/awt/Polygon.java 2015-10-04 22:52:57.881273512 +0400
@@ -32,7 +32,7 @@
import java.util.Arrays;
/**
- * The Polygon class encapsulates a description of a
+ * The {@code Polygon} class encapsulates a description of a
* closed, two-dimensional region within a coordinate space. This
* region is bounded by an arbitrary number of line segments, each of
* which is one side of the polygon. Internally, a polygon
@@ -41,12 +41,12 @@
* polygon, and two successive pairs are the endpoints of a
* line that is a side of the polygon. The first and final
* pairs of {@code (x,y)} points are joined by a line segment
- * that closes the polygon. This Polygon is defined with
+ * that closes the polygon. This {@code Polygon} is defined with
* an even-odd winding rule. See
* {@link java.awt.geom.PathIterator#WIND_EVEN_ODD WIND_EVEN_ODD}
* for a definition of the even-odd winding rule.
* This class's hit-testing methods, which include the
- * contains, intersects and inside
+ * {@code contains}, {@code intersects} and {@code inside}
* methods, use the insideness definition described in the
* {@link Shape} class comments.
*
@@ -58,8 +58,8 @@
public class Polygon implements Shape, java.io.Serializable {
/**
- * The total number of points. The value of npoints
- * represents the number of valid points in this Polygon
+ * The total number of points. The value of {@code npoints}
+ * represents the number of valid points in this {@code Polygon}
* and might be less than the number of elements in
* {@link #xpoints xpoints} or {@link #ypoints ypoints}.
* This value can be NULL.
@@ -73,10 +73,10 @@
/**
* The array of X coordinates. The number of elements in
* this array might be more than the number of X coordinates
- * in this Polygon. The extra elements allow new points
- * to be added to this Polygon without re-creating this
+ * in this {@code Polygon}. The extra elements allow new points
+ * to be added to this {@code Polygon} without re-creating this
* array. The value of {@link #npoints npoints} is equal to the
- * number of valid points in this Polygon.
+ * number of valid points in this {@code Polygon}.
*
* @serial
* @see #addPoint(int, int)
@@ -87,10 +87,10 @@
/**
* The array of Y coordinates. The number of elements in
* this array might be more than the number of Y coordinates
- * in this Polygon. The extra elements allow new points
- * to be added to this Polygon without re-creating this
- * array. The value of npoints is equal to the
- * number of valid points in this Polygon.
+ * in this {@code Polygon}. The extra elements allow new points
+ * to be added to this {@code Polygon} without re-creating this
+ * array. The value of {@code npoints} is equal to the
+ * number of valid points in this {@code Polygon}.
*
* @serial
* @see #addPoint(int, int)
@@ -129,19 +129,19 @@
}
/**
- * Constructs and initializes a Polygon from the specified
+ * Constructs and initializes a {@code Polygon} from the specified
* parameters.
* @param xpoints an array of X coordinates
* @param ypoints an array of Y coordinates
* @param npoints the total number of points in the
- * Polygon
+ * {@code Polygon}
* @exception NegativeArraySizeException if the value of
- * npoints is negative.
- * @exception IndexOutOfBoundsException if npoints is
- * greater than the length of xpoints
- * or the length of ypoints.
- * @exception NullPointerException if xpoints or
- * ypoints is null.
+ * {@code npoints} is negative.
+ * @exception IndexOutOfBoundsException if {@code npoints} is
+ * greater than the length of {@code xpoints}
+ * or the length of {@code ypoints}.
+ * @exception NullPointerException if {@code xpoints} or
+ * {@code ypoints} is {@code null}.
* @since 1.0
*/
public Polygon(int xpoints[], int ypoints[], int npoints) {
@@ -164,7 +164,7 @@
}
/**
- * Resets this Polygon object to an empty polygon.
+ * Resets this {@code Polygon} object to an empty polygon.
* The coordinate arrays and the data in them are left untouched
* but the number of points is reset to zero to mark the old
* vertex data as invalid and to start accumulating new vertex
@@ -172,7 +172,7 @@
* All internally-cached data relating to the old vertices
* are discarded.
* Note that since the coordinate arrays from before the reset
- * are reused, creating a new empty Polygon might
+ * are reused, creating a new empty {@code Polygon} might
* be more memory efficient than resetting the current one if
* the number of vertices in the new polygon data is significantly
* smaller than the number of vertices in the data from before the
@@ -187,11 +187,11 @@
/**
* Invalidates or flushes any internally-cached data that depends
- * on the vertex coordinates of this Polygon.
+ * on the vertex coordinates of this {@code Polygon}.
* This method should be called after any direct manipulation
- * of the coordinates in the xpoints or
- * ypoints arrays to avoid inconsistent results
- * from methods such as getBounds or contains
+ * of the coordinates in the {@code xpoints} or
+ * {@code ypoints} arrays to avoid inconsistent results
+ * from methods such as {@code getBounds} or {@code contains}
* that might cache data from earlier computations relating to
* the vertex coordinates.
* @see java.awt.Polygon#getBounds
@@ -202,9 +202,9 @@
}
/**
- * Translates the vertices of the Polygon by
- * deltaX along the x axis and by
- * deltaY along the y axis.
+ * Translates the vertices of the {@code Polygon} by
+ * {@code deltaX} along the x axis and by
+ * {@code deltaY} along the y axis.
* @param deltaX the amount to translate along the X axis
* @param deltaY the amount to translate along the Y axis
* @since 1.1
@@ -221,7 +221,7 @@
/*
* Calculates the bounding box of the points passed to the constructor.
- * Sets bounds to the result.
+ * Sets {@code bounds} to the result.
* @param xpoints[] array of x coordinates
* @param ypoints[] array of y coordinates
* @param npoints the total number of points
@@ -270,11 +270,11 @@
}
/**
- * Appends the specified coordinates to this Polygon.
+ * Appends the specified coordinates to this {@code Polygon}.
* Polygon has already been performed, such as
- * getBounds or contains, then this
+ * {@code Polygon} has already been performed, such as
+ * {@code getBounds} or {@code contains}, then this
* method updates the bounding box.
* @param x the specified X coordinate
* @param y the specified Y coordinate
@@ -305,12 +305,12 @@
}
/**
- * Gets the bounding box of this Polygon.
+ * Gets the bounding box of this {@code Polygon}.
* The bounding box is the smallest {@link Rectangle} whose
* sides are parallel to the x and y axes of the
- * coordinate space, and can completely contain the Polygon.
- * @return a Rectangle that defines the bounds of this
- * Polygon.
+ * coordinate space, and can completely contain the {@code Polygon}.
+ * @return a {@code Rectangle} that defines the bounds of this
+ * {@code Polygon}.
* @since 1.1
*/
public Rectangle getBounds() {
@@ -318,10 +318,10 @@
}
/**
- * Returns the bounds of this Polygon.
- * @return the bounds of this Polygon.
+ * Returns the bounds of this {@code Polygon}.
+ * @return the bounds of this {@code Polygon}.
* @deprecated As of JDK version 1.1,
- * replaced by getBounds().
+ * replaced by {@code getBounds()}.
* @since 1.0
*/
@Deprecated
@@ -337,10 +337,10 @@
/**
* Determines whether the specified {@link Point} is inside this
- * Polygon.
- * @param p the specified Point to be tested
- * @return true if the Polygon contains the
- * Point; false otherwise.
+ * {@code Polygon}.
+ * @param p the specified {@code Point} to be tested
+ * @return {@code true} if the {@code Polygon} contains the
+ * {@code Point}; {@code false} otherwise.
* @see #contains(double, double)
* @since 1.0
*/
@@ -350,7 +350,7 @@
/**
* Determines whether the specified coordinates are inside this
- * Polygon.
+ * {@code Polygon}.
*
* @param x the specified X coordinate to be tested
* @param y the specified Y coordinate to be tested
@@ -366,7 +366,7 @@
/**
* Determines whether the specified coordinates are contained in this
- * Polygon.
+ * {@code Polygon}.
* @param x the specified X coordinate to be tested
* @param y the specified Y coordinate to be tested
* @return {@code true} if this {@code Polygon} contains
@@ -374,7 +374,7 @@
* {@code false} otherwise.
* @see #contains(double, double)
* @deprecated As of JDK version 1.1,
- * replaced by contains(int, int).
+ * replaced by {@code contains(int, int)}.
* @since 1.0
*/
@Deprecated
@@ -531,15 +531,15 @@
/**
* Returns an iterator object that iterates along the boundary of this
- * Polygon and provides access to the geometry
- * of the outline of this Polygon. An optional
+ * {@code Polygon} and provides access to the geometry
+ * of the outline of this {@code Polygon}. An optional
* {@link AffineTransform} can be specified so that the coordinates
* returned in the iteration are transformed accordingly.
- * @param at an optional AffineTransform to be applied to the
+ * @param at an optional {@code AffineTransform} to be applied to the
* coordinates as they are returned in the iteration, or
- * null if untransformed coordinates are desired
+ * {@code null} if untransformed coordinates are desired
* @return a {@link PathIterator} object that provides access to the
- * geometry of this Polygon.
+ * geometry of this {@code Polygon}.
* @since 1.2
*/
public PathIterator getPathIterator(AffineTransform at) {
@@ -548,23 +548,23 @@
/**
* Returns an iterator object that iterates along the boundary of
- * the Shape and provides access to the geometry of the
- * outline of the Shape. Only SEG_MOVETO, SEG_LINETO, and
+ * the {@code Shape} and provides access to the geometry of the
+ * outline of the {@code Shape}. Only SEG_MOVETO, SEG_LINETO, and
* SEG_CLOSE point types are returned by the iterator.
- * Since polygons are already flat, the flatness parameter
- * is ignored. An optional AffineTransform can be specified
+ * Since polygons are already flat, the {@code flatness} parameter
+ * is ignored. An optional {@code AffineTransform} can be specified
* in which case the coordinates returned in the iteration are transformed
* accordingly.
- * @param at an optional AffineTransform to be applied to the
+ * @param at an optional {@code AffineTransform} to be applied to the
* coordinates as they are returned in the iteration, or
- * null if untransformed coordinates are desired
+ * {@code null} if untransformed coordinates are desired
* @param flatness the maximum amount that the control points
* for a given curve can vary from collinear before a subdivided
* curve is replaced by a straight line connecting the
* endpoints. Since polygons are already flat the
- * flatness parameter is ignored.
- * @return a PathIterator object that provides access to the
- * Shape object's geometry.
+ * {@code flatness} parameter is ignored.
+ * @return a {@code PathIterator} object that provides access to the
+ * {@code Shape} object's geometry.
* @since 1.2
*/
public PathIterator getPathIterator(AffineTransform at, double flatness) {
@@ -597,8 +597,8 @@
/**
* Tests if there are more points to read.
- * @return true if there are more points to read;
- * false otherwise.
+ * @return {@code true} if there are more points to read;
+ * {@code false} otherwise.
*/
public boolean isDone() {
return index > poly.npoints;
@@ -618,12 +618,12 @@
* the iteration.
* The return value is the path segment type:
* SEG_MOVETO, SEG_LINETO, or SEG_CLOSE.
- * A float array of length 2 must be passed in and
+ * A {@code float} array of length 2 must be passed in and
* can be used to store the coordinates of the point(s).
- * Each point is stored as a pair of float x, y
+ * Each point is stored as a pair of {@code float} x, y
* coordinates. SEG_MOVETO and SEG_LINETO types return one
* point, and SEG_CLOSE does not return any points.
- * @param coords a float array that specifies the
+ * @param coords a {@code float} array that specifies the
* coordinates of the point(s)
* @return an integer representing the type and coordinates of the
* current path segment.
@@ -648,13 +648,13 @@
* the iteration.
* The return value is the path segment type:
* SEG_MOVETO, SEG_LINETO, or SEG_CLOSE.
- * A double array of length 2 must be passed in and
+ * A {@code double} array of length 2 must be passed in and
* can be used to store the coordinates of the point(s).
- * Each point is stored as a pair of double x, y
+ * Each point is stored as a pair of {@code double} x, y
* coordinates.
* SEG_MOVETO and SEG_LINETO types return one point,
* and SEG_CLOSE does not return any points.
- * @param coords a double array that specifies the
+ * @param coords a {@code double} array that specifies the
* coordinates of the point(s)
* @return an integer representing the type and coordinates of the
* current path segment.
--- old/src/java.desktop/share/classes/java/awt/PopupMenu.java 2015-10-04 22:52:58.605273479 +0400
+++ new/src/java.desktop/share/classes/java/awt/PopupMenu.java 2015-10-04 22:52:58.413273488 +0400
@@ -35,11 +35,11 @@
* A class that implements a menu which can be dynamically popped up
* at a specified position within a component.
* PopupMenu
- * can be used anywhere a Menu can be used.
- * However, if you use a PopupMenu like a Menu
- * (e.g., you add it to a MenuBar), then you cannot
- * call show on that PopupMenu.
+ * As the inheritance hierarchy implies, a {@code PopupMenu}
+ * can be used anywhere a {@code Menu} can be used.
+ * However, if you use a {@code PopupMenu} like a {@code Menu}
+ * (e.g., you add it to a {@code MenuBar}), then you cannot
+ * call {@code show} on that {@code PopupMenu}.
*
* @author Amy Fowler
*/
@@ -77,7 +77,7 @@
/**
* Creates a new popup menu with the specified name.
*
- * @param label a non-null string specifying
+ * @param label a non-{@code null} string specifying
* the popup menu's label
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
@@ -98,8 +98,8 @@
}
/**
- * Constructs a name for this MenuComponent.
- * Called by getName when the name is null.
+ * Constructs a name for this {@code MenuComponent}.
+ * Called by {@code getName} when the name is {@code null}.
*/
String constructComponentName() {
synchronized (PopupMenu.class) {
@@ -139,16 +139,16 @@
* hierarchy of the popup menu's parent. Both the origin and the parent
* must be showing on the screen for this method to be valid.
* PopupMenu is being used as a Menu
- * (i.e., it has a non-Component parent),
- * then you cannot call this method on the PopupMenu.
+ * If this {@code PopupMenu} is being used as a {@code Menu}
+ * (i.e., it has a non-{@code Component} parent),
+ * then you cannot call this method on the {@code PopupMenu}.
*
* @param origin the component which defines the coordinate space
* @param x the x coordinate position to popup the menu
* @param y the y coordinate position to popup the menu
- * @exception NullPointerException if the parent is null
- * @exception IllegalArgumentException if this PopupMenu
- * has a non-Component parent
+ * @exception NullPointerException if the parent is {@code null}
+ * @exception IllegalArgumentException if this {@code PopupMenu}
+ * has a non-{@code Component} parent
* @exception IllegalArgumentException if the origin is not in the
* parent's hierarchy
* @exception RuntimeException if the parent is not showing on screen
@@ -196,11 +196,11 @@
////////////////
/**
- * Gets the AccessibleContext associated with this
- * PopupMenu.
+ * Gets the {@code AccessibleContext} associated with this
+ * {@code PopupMenu}.
*
- * @return the AccessibleContext of this
- * PopupMenu
+ * @return the {@code AccessibleContext} of this
+ * {@code PopupMenu}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
--- old/src/java.desktop/share/classes/java/awt/Rectangle.java 2015-10-04 22:52:59.129273456 +0400
+++ new/src/java.desktop/share/classes/java/awt/Rectangle.java 2015-10-04 22:52:58.937273464 +0400
@@ -29,14 +29,14 @@
import java.beans.Transient;
/**
- * A Rectangle specifies an area in a coordinate space that is
- * enclosed by the Rectangle object's upper-left point
+ * A {@code Rectangle} specifies an area in a coordinate space that is
+ * enclosed by the {@code Rectangle} object's upper-left point
* {@code (x,y)}
* in the coordinate space, its width, and its height.
* Rectangle object's width and
- * height are public fields. The constructors
- * that create a Rectangle, and the methods that can modify
+ * A {@code Rectangle} object's {@code width} and
+ * {@code height} are {@code public} fields. The constructors
+ * that create a {@code Rectangle}, and the methods that can modify
* one, do not prevent setting a negative value for width or height.
*
* maximum minus the visible amount.
- * In the previous example, because the maximum is
- * 300 and the visible amount is 60, the actual maximum
+ * {@code maximum} minus the {@code visible amount}.
+ * In the previous example, because the {@code maximum} is
+ * 300 and the {@code visible amount} is 60, the actual maximum
* value is 240. The range of the scrollbar track is 0 - 300.
* The left side of the bubble indicates the value of the
* scroll bar.
@@ -89,39 +89,39 @@
* increment and block decrement areas.
* AdjustmentEvent.
+ * receives an instance of {@code AdjustmentEvent}.
* The scroll bar processes this event, passing it along to
* any registered listeners.
* AdjustmentListener, an interface defined in
- * the package java.awt.event.
+ * {@code AdjustmentListener}, an interface defined in
+ * the package {@code java.awt.event}.
* Listeners can be added and removed dynamically by calling
- * the methods addAdjustmentListener and
- * removeAdjustmentListener.
+ * the methods {@code addAdjustmentListener} and
+ * {@code removeAdjustmentListener}.
* AdjustmentEvent class defines five types
+ * The {@code AdjustmentEvent} class defines five types
* of adjustment event, listed here:
*
*
- *
AdjustmentEvent.TRACK is sent out when the
+ * AdjustmentEvent.UNIT_INCREMENT is sent out
+ * AdjustmentEvent.UNIT_DECREMENT is sent out
+ * AdjustmentEvent.BLOCK_INCREMENT is sent out
+ * AdjustmentEvent.BLOCK_DECREMENT is sent out
+ *
- *
* AdjustmentEvent.TRACK replaces
- * Event.SCROLL_ABSOLUTE
- * AdjustmentEvent.UNIT_INCREMENT replaces
- * Event.SCROLL_LINE_UP
- * AdjustmentEvent.UNIT_DECREMENT replaces
- * Event.SCROLL_LINE_DOWN
- * AdjustmentEvent.BLOCK_INCREMENT replaces
- * Event.SCROLL_PAGE_UP
- * AdjustmentEvent.BLOCK_DECREMENT replaces
- * Event.SCROLL_PAGE_DOWN
+ * Scrollbar
+ * Note: We recommend using a {@code Scrollbar}
* for value selection only. If you want to implement
* a scrollable component inside a container, we recommend you use
* a {@link ScrollPane ScrollPane}. If you use a
- * Scrollbar for this purpose, you are likely to
+ * {@code Scrollbar} for this purpose, you are likely to
* encounter issues with painting, key handling, sizing and
* positioning.
*
@@ -176,10 +176,10 @@
public static final int VERTICAL = 1;
/**
- * The value of the Scrollbar.
- * This property must be greater than or equal to minimum
+ * The value of the {@code Scrollbar}.
+ * This property must be greater than or equal to {@code minimum}
* and less than or equal to
- * maximum - visibleAmount
+ * {@code maximum - visibleAmount}
*
* @serial
* @see #getValue
@@ -188,8 +188,8 @@
int value;
/**
- * The maximum value of the Scrollbar.
- * This value must be greater than the minimum
+ * The maximum value of the {@code Scrollbar}.
+ * This value must be greater than the {@code minimum}
* value.
*
* @serial
@@ -199,8 +199,8 @@
int maximum;
/**
- * The minimum value of the Scrollbar.
- * This value must be less than the maximum
+ * The minimum value of the {@code Scrollbar}.
+ * This value must be less than the {@code maximum}
* value.
*
* @serial
@@ -210,7 +210,7 @@
int minimum;
/**
- * The size of the Scrollbar's bubble.
+ * The size of the {@code Scrollbar}'s bubble.
* When a scroll bar is used to select a range of values,
* the visibleAmount represents the size of this range.
* Depending on platform, this may be visually indicated
@@ -223,11 +223,11 @@
int visibleAmount;
/**
- * The Scrollbar's orientation--being either horizontal
+ * The {@code Scrollbar}'s orientation--being either horizontal
* or vertical.
* This value should be specified when the scrollbar is created.
- * orientation can be either : VERTICAL or
- * HORIZONTAL only.
+ * orientation can be either : {@code VERTICAL} or
+ * {@code HORIZONTAL} only.
*
* @serial
* @see #getOrientation
@@ -258,7 +258,7 @@
int pageIncrement = 10;
/**
- * The adjusting status of the Scrollbar.
+ * The adjusting status of the {@code Scrollbar}.
* True if the value is in the process of changing as a result of
* actions being taken by the user.
*
@@ -306,7 +306,7 @@
* orientation
* indicates whether the scroll bar is vertical
*
- *
or horizontalScrollbar.VERTICAL{@code Scrollbar.VERTICAL}
*
*
*
*value
@@ -360,14 +360,14 @@
/**
* Constructs a new scroll bar with the specified orientation.
* orientation argument must take one of the two
- * values Scrollbar.HORIZONTAL,
- * or Scrollbar.VERTICAL,
+ * The {@code orientation} argument must take one of the two
+ * values {@code Scrollbar.HORIZONTAL},
+ * or {@code Scrollbar.VERTICAL},
* indicating a horizontal or vertical scroll bar, respectively.
*
* @param orientation indicates the orientation of the scroll bar
* @exception IllegalArgumentException when an illegal value for
- * the orientation argument is supplied
+ * the {@code orientation} argument is supplied
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -380,9 +380,9 @@
* Constructs a new scroll bar with the specified orientation,
* initial value, visible amount, and minimum and maximum values.
* orientation argument must take one of the two
- * values Scrollbar.HORIZONTAL,
- * or Scrollbar.VERTICAL,
+ * The {@code orientation} argument must take one of the two
+ * values {@code Scrollbar.HORIZONTAL},
+ * or {@code Scrollbar.VERTICAL},
* indicating a horizontal or vertical scroll bar, respectively.
* orientation argument is supplied
+ * the {@code orientation} argument is supplied
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see #setValues
@@ -416,8 +416,8 @@
}
/**
- * Constructs a name for this component. Called by getName
- * when the name is null.
+ * Constructs a name for this component. Called by {@code getName}
+ * when the name is {@code null}.
*/
String constructComponentName() {
synchronized (Scrollbar.class) {
@@ -426,8 +426,8 @@
}
/**
- * Creates the Scrollbar's peer. The peer allows you to modify
- * the appearance of the Scrollbar without changing any of its
+ * Creates the {@code Scrollbar}'s peer. The peer allows you to modify
+ * the appearance of the {@code Scrollbar} without changing any of its
* functionality.
*/
public void addNotify() {
@@ -442,8 +442,8 @@
* Returns the orientation of this scroll bar.
*
* @return the orientation of this scroll bar, either
- * Scrollbar.HORIZONTAL or
- * Scrollbar.VERTICAL
+ * {@code Scrollbar.HORIZONTAL} or
+ * {@code Scrollbar.VERTICAL}
* @see java.awt.Scrollbar#setOrientation
*/
public int getOrientation() {
@@ -454,11 +454,11 @@
* Sets the orientation for this scroll bar.
*
* @param orientation the orientation of this scroll bar, either
- * Scrollbar.HORIZONTAL or
- * Scrollbar.VERTICAL
+ * {@code Scrollbar.HORIZONTAL} or
+ * {@code Scrollbar.VERTICAL}
* @see java.awt.Scrollbar#getOrientation
* @exception IllegalArgumentException if the value supplied
- * for orientation is not a
+ * for {@code orientation} is not a
* legal value
* @since 1.1
*/
@@ -506,20 +506,20 @@
/**
* Sets the value of this scroll bar to the specified value.
* minimum
- * or greater than the current maximum - visibleAmount,
- * then either minimum or maximum - visibleAmount
+ * If the value supplied is less than the current {@code minimum}
+ * or greater than the current {@code maximum - visibleAmount},
+ * then either {@code minimum} or {@code maximum - visibleAmount}
* is substituted, as appropriate.
* setValues.
- * The setValues method simultaneously
+ * value only by calling {@code setValues}.
+ * The {@code setValues} method simultaneously
* and synchronously sets the minimum, maximum, visible amount,
* and value properties of a scroll bar, so that they are
* mutually consistent.
* AdjustmentEvent.
+ * {@code AdjustmentEvent}.
*
* @param newValue the new value of the scroll bar
* @see java.awt.Scrollbar#setValues
@@ -547,21 +547,21 @@
/**
* Sets the minimum value of this scroll bar.
* setMinimum is called, the minimum value
+ * When {@code setMinimum} is called, the minimum value
* is changed, and other values (including the maximum, the
* visible amount, and the current scroll bar value)
* are changed to be consistent with the new minimum.
* setValues.
- * The setValues method simultaneously
+ * value only by calling {@code setValues}.
+ * The {@code setValues} method simultaneously
* and synchronously sets the minimum, maximum, visible amount,
* and value properties of a scroll bar, so that they are
* mutually consistent.
* Integer.MAX_VALUE
+ * Note that setting the minimum value to {@code Integer.MAX_VALUE}
* will result in the new minimum value being set to
- * Integer.MAX_VALUE - 1.
+ * {@code Integer.MAX_VALUE - 1}.
*
* @param newMinimum the new minimum value for this scroll bar
* @see java.awt.Scrollbar#setValues
@@ -591,21 +591,21 @@
/**
* Sets the maximum value of this scroll bar.
* setMaximum is called, the maximum value
+ * When {@code setMaximum} is called, the maximum value
* is changed, and other values (including the minimum, the
* visible amount, and the current scroll bar value)
* are changed to be consistent with the new maximum.
* setValues.
- * The setValues method simultaneously
+ * value only by calling {@code setValues}.
+ * The {@code setValues} method simultaneously
* and synchronously sets the minimum, maximum, visible amount,
* and value properties of a scroll bar, so that they are
* mutually consistent.
* Integer.MIN_VALUE
+ * Note that setting the maximum value to {@code Integer.MIN_VALUE}
* will result in the new maximum value being set to
- * Integer.MIN_VALUE + 1.
+ * {@code Integer.MIN_VALUE + 1}.
*
* @param newMaximum the new maximum value
* for this scroll bar
@@ -645,7 +645,7 @@
* moveable (e.g. when it takes up the entire length of the
* scroll bar's track, or when the scroll bar is disabled).
* Whether the bubble is displayed or not will not affect
- * the value returned by getVisibleAmount.
+ * the value returned by {@code getVisibleAmount}.
*
* @return the visible amount of this scroll bar
* @see java.awt.Scrollbar#setVisibleAmount
@@ -660,7 +660,7 @@
*
* @return the visible amount of this scroll bar
* @deprecated As of JDK version 1.1,
- * replaced by getVisibleAmount().
+ * replaced by {@code getVisibleAmount()}.
*/
@Deprecated
public int getVisible() {
@@ -683,16 +683,16 @@
* moveable (e.g. when it takes up the entire length of the
* scroll bar's track, or when the scroll bar is disabled).
* Whether the bubble is displayed or not will not affect
- * the value returned by getVisibleAmount.
+ * the value returned by {@code getVisibleAmount}.
* one
- * or greater than the current maximum - minimum,
- * then either one or maximum - minimum
+ * If the visible amount supplied is less than {@code one}
+ * or greater than the current {@code maximum - minimum},
+ * then either {@code one} or {@code maximum - minimum}
* is substituted, as appropriate.
* setValues.
- * The setValues method simultaneously
+ * value only by calling {@code setValues}.
+ * The {@code setValues} method simultaneously
* and synchronously sets the minimum, maximum, visible amount,
* and value properties of a scroll bar, so that they are
* mutually consistent.
@@ -737,7 +737,7 @@
* @param v the increment value
*
* @deprecated As of JDK version 1.1,
- * replaced by setUnitIncrement(int).
+ * replaced by {@code setUnitIncrement(int)}.
*/
@Deprecated
public synchronized void setLineIncrement(int v) {
@@ -779,7 +779,7 @@
*
* @return the unit increment for this scrollbar
* @deprecated As of JDK version 1.1,
- * replaced by getUnitIncrement().
+ * replaced by {@code getUnitIncrement()}.
*/
@Deprecated
public int getLineIncrement() {
@@ -811,7 +811,7 @@
*
* @param v the block increment
* @deprecated As of JDK version 1.1,
- * replaced by setBlockIncrement().
+ * replaced by {@code setBlockIncrement()}.
*/
@Deprecated
public synchronized void setPageIncrement(int v) {
@@ -851,7 +851,7 @@
* @return the block increment of this scroll bar
*
* @deprecated As of JDK version 1.1,
- * replaced by getBlockIncrement().
+ * replaced by {@code getBlockIncrement()}.
*/
@Deprecated
public int getPageIncrement() {
@@ -860,8 +860,8 @@
/**
* Sets the values of four properties for this scroll bar:
- * value, visibleAmount,
- * minimum, and maximum.
+ * {@code value}, {@code visibleAmount},
+ * {@code minimum}, and {@code maximum}.
* If the values supplied for these properties are inconsistent
* or incorrect, they will be changed to ensure consistency.
* maximum must be greater than minimum,
- * maximum - minimum must not be greater
- * than Integer.MAX_VALUE,
- * visibleAmount must be greater than zero.
- * visibleAmount must not be greater than
- * maximum - minimum,
- * value must not be less than minimum,
- * and value must not be greater than
- * maximum - visibleAmount
+ * {@code maximum} must be greater than {@code minimum},
+ * {@code maximum - minimum} must not be greater
+ * than {@code Integer.MAX_VALUE},
+ * {@code visibleAmount} must be greater than zero.
+ * {@code visibleAmount} must not be greater than
+ * {@code maximum - minimum},
+ * {@code value} must not be less than {@code minimum},
+ * and {@code value} must not be greater than
+ * {@code maximum - visibleAmount}
* AdjustmentEvent.
+ * {@code AdjustmentEvent}.
*
* @param value is the position in the current window
* @param visible is the visible amount of the scroll bar
@@ -943,7 +943,7 @@
* Returns true if the value is in the process of changing as a
* result of actions being taken by the user.
*
- * @return the value of the valueIsAdjusting property
+ * @return the value of the {@code valueIsAdjusting} property
* @see #setValueIsAdjusting
* @since 1.4
*/
@@ -952,7 +952,7 @@
}
/**
- * Sets the valueIsAdjusting property.
+ * Sets the {@code valueIsAdjusting} property.
*
* @param b new adjustment-in-progress status
* @see #getValueIsAdjusting
@@ -978,8 +978,8 @@
/**
* Adds the specified adjustment listener to receive instances of
- * AdjustmentEvent from this scroll bar.
- * If l is null, no exception is thrown and no
+ * {@code AdjustmentEvent} from this scroll bar.
+ * If l is {@code null}, no exception is thrown and no
* action is performed.
* AdjustmentEvent from this scroll bar.
- * If l is null, no exception is thrown and no action
+ * receives instances of {@code AdjustmentEvent} from this scroll bar.
+ * If l is {@code null}, no exception is thrown and no action
* is performed.
* AdjustmentListeners
+ * @return all of this scrollbar's {@code AdjustmentListener}s
* or an empty array if no adjustment
* listeners are currently registered
* @see #addAdjustmentListener
@@ -1041,15 +1041,15 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this Scrollbar.
+ * upon this {@code Scrollbar}.
* FooListeners are registered using the
* addFooListener method.
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * Scrollbar c
+ * {@code Scrollbar c}
* for its mouse listeners with the following code:
*
* MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));
@@ -1058,13 +1058,13 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this component,
* or an empty array if no such listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @since 1.3
*/
@@ -1092,11 +1092,11 @@
/**
* Processes events on this scroll bar. If the event is an
- * instance of AdjustmentEvent, it invokes the
- * processAdjustmentEvent method.
+ * instance of {@code AdjustmentEvent}, it invokes the
+ * {@code processAdjustmentEvent} method.
* Otherwise, it invokes its superclass's
- * processEvent method.
- * null
+ * {@code processEvent} method.
+ * AdjustmentListener objects.
+ * {@code AdjustmentListener} objects.
*
- *
- * AdjustmentListener object is registered
- * via addAdjustmentListener.
- * enableEvents.
+ * null
+ * Scrollbar.
+ * Returns a string representing the state of this {@code Scrollbar}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this scroll bar
*/
@@ -1176,17 +1176,17 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable AdjustmentListeners
+ * a list of serializable {@code AdjustmentListeners}
* as optional data. The non-serializable listeners are
* detected and no attempt is made to serialize them.
*
- * @param s the ObjectOutputStream to write
- * @serialData null terminated sequence of 0
- * or more pairs; the pair consists of a String
- * and an Object; the String indicates
+ * @param s the {@code ObjectOutputStream} to write
+ * @serialData {@code null} terminated sequence of 0
+ * or more pairs; the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String} indicates
* the type of object and is one of the following:
- * adjustmentListenerK indicating an
- * AdjustmentListener object
+ * {@code adjustmentListenerK} indicating an
+ * {@code AdjustmentListener} object
*
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see java.awt.Component#adjustmentListenerK
@@ -1202,16 +1202,16 @@
}
/**
- * Reads the ObjectInputStream and if
- * it isn't null adds a listener to
+ * Reads the {@code ObjectInputStream} and if
+ * it isn't {@code null} adds a listener to
* receive adjustment events fired by the
- * Scrollbar.
+ * {@code Scrollbar}.
* Unrecognized keys or values will be ignored.
*
- * @param s the ObjectInputStream to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns
- * true
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #writeObject(ObjectOutputStream)
*/
@@ -1239,14 +1239,14 @@
////////////////
/**
- * Gets the AccessibleContext associated with this
- * Scrollbar. For scrollbars, the
- * AccessibleContext takes the form of an
- * AccessibleAWTScrollBar. A new
- * AccessibleAWTScrollBar instance is created if necessary.
+ * Gets the {@code AccessibleContext} associated with this
+ * {@code Scrollbar}. For scrollbars, the
+ * {@code AccessibleContext} takes the form of an
+ * {@code AccessibleAWTScrollBar}. A new
+ * {@code AccessibleAWTScrollBar} instance is created if necessary.
*
- * @return an AccessibleAWTScrollBar that serves as the
- * AccessibleContext of this ScrollBar
+ * @return an {@code AccessibleAWTScrollBar} that serves as the
+ * {@code AccessibleContext} of this {@code ScrollBar}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
@@ -1258,7 +1258,7 @@
/**
* This class implements accessibility support for the
- * Scrollbar class. It provides an implementation of
+ * {@code Scrollbar} class. It provides an implementation of
* the Java Accessibility API appropriate to scrollbar
* user-interface elements.
* @since 1.3
@@ -1274,7 +1274,7 @@
/**
* Get the state set of this object.
*
- * @return an instance of AccessibleState
+ * @return an instance of {@code AccessibleState}
* containing the current state of the object
* @see AccessibleState
*/
@@ -1294,7 +1294,7 @@
/**
* Get the role of this object.
*
- * @return an instance of AccessibleRole
+ * @return an instance of {@code AccessibleRole}
* describing the role of the object
*/
public AccessibleRole getAccessibleRole() {
@@ -1302,11 +1302,11 @@
}
/**
- * Get the AccessibleValue associated with this
+ * Get the {@code AccessibleValue} associated with this
* object. In the implementation of the Java Accessibility
* API for this class, return this object, which is
* responsible for implementing the
- * AccessibleValue interface on behalf of itself.
+ * {@code AccessibleValue} interface on behalf of itself.
*
* @return this object
*/
--- old/src/java.desktop/share/classes/java/awt/Shape.java 2015-10-04 22:53:02.409273308 +0400
+++ new/src/java.desktop/share/classes/java/awt/Shape.java 2015-10-04 22:53:02.221273317 +0400
@@ -31,36 +31,36 @@
import java.awt.geom.Rectangle2D;
/**
- * The Shape interface provides definitions for objects
- * that represent some form of geometric shape. The Shape
+ * The {@code Shape} interface provides definitions for objects
+ * that represent some form of geometric shape. The {@code Shape}
* is described by a {@link PathIterator} object, which can express the
- * outline of the Shape as well as a rule for determining
+ * outline of the {@code Shape} as well as a rule for determining
* how the outline divides the 2D plane into interior and exterior
- * points. Each Shape object provides callbacks to get the
+ * points. Each {@code Shape} object provides callbacks to get the
* bounding box of the geometry, determine whether points or
* rectangles lie partly or entirely within the interior
- * of the Shape, and retrieve a PathIterator
- * object that describes the trajectory path of the Shape
+ * of the {@code Shape}, and retrieve a {@code PathIterator}
+ * object that describes the trajectory path of the {@code Shape}
* outline.
* Shape if and only if:
+ * {@code Shape} if and only if:
*
*
- * Shape boundary or
+ * inside the {@code Shape} boundary or
* Shape boundary and the
+ * it lies exactly on the {@code Shape} boundary and the
* space immediately adjacent to the
- * point in the increasing X direction is
+ * point in the increasing {@code X} direction is
* entirely inside the boundary or
* Y direction is inside the boundary.
+ * increasing {@code Y} direction is inside the boundary.
* contains and intersects methods
- * consider the interior of a Shape to be the area it
+ * Shape. Note that there is no guarantee that the
- * returned Rectangle is the smallest bounding box that
- * encloses the Shape, only that the Shape
- * lies entirely within the indicated Rectangle. The
- * returned Rectangle might also fail to completely
- * enclose the Shape if the Shape overflows
+ * {@code Shape}. Note that there is no guarantee that the
+ * returned {@code Rectangle} is the smallest bounding box that
+ * encloses the {@code Shape}, only that the {@code Shape}
+ * lies entirely within the indicated {@code Rectangle}. The
+ * returned {@code Rectangle} might also fail to completely
+ * enclose the {@code Shape} if the {@code Shape} overflows
* the limited range of the integer data type. The
- * getBounds2D method generally returns a
+ * {@code getBounds2D} method generally returns a
* tighter bounding box due to its greater flexibility in
* representation.
*
@@ -114,8 +114,8 @@
* Rectangle that completely encloses
- * the Shape.
+ * @return an integer {@code Rectangle} that completely encloses
+ * the {@code Shape}.
* @see #getBounds2D
* @since 1.2
*/
@@ -123,15 +123,15 @@
/**
* Returns a high precision and more accurate bounding box of
- * the Shape than the getBounds method.
+ * the {@code Shape} than the {@code getBounds} method.
* Note that there is no guarantee that the returned
* {@link Rectangle2D} is the smallest bounding box that encloses
- * the Shape, only that the Shape lies
- * entirely within the indicated Rectangle2D. The
+ * the {@code Shape}, only that the {@code Shape} lies
+ * entirely within the indicated {@code Rectangle2D}. The
* bounding box returned by this method is usually tighter than that
- * returned by the getBounds method and never fails due
+ * returned by the {@code getBounds} method and never fails due
* to overflow problems since the return value can be an instance of
- * the Rectangle2D that uses double precision values to
+ * the {@code Rectangle2D} that uses double precision values to
* store the dimensions.
*
* Rectangle2D that is a
- * high-precision bounding box of the Shape.
+ * @return an instance of {@code Rectangle2D} that is a
+ * high-precision bounding box of the {@code Shape}.
* @see #getBounds
* @since 1.2
*/
@@ -168,13 +168,13 @@
/**
* Tests if the specified coordinates are inside the boundary of the
- * Shape, as described by the
+ * {@code Shape}, as described by the
*
* definition of insideness.
* @param x the specified X coordinate to be tested
* @param y the specified Y coordinate to be tested
- * @return true if the specified coordinates are inside
- * the Shape boundary; false
+ * @return {@code true} if the specified coordinates are inside
+ * the {@code Shape} boundary; {@code false}
* otherwise.
* @since 1.2
*/
@@ -182,30 +182,30 @@
/**
* Tests if a specified {@link Point2D} is inside the boundary
- * of the Shape, as described by the
+ * of the {@code Shape}, as described by the
*
* definition of insideness.
- * @param p the specified Point2D to be tested
- * @return true if the specified Point2D is
- * inside the boundary of the Shape;
- * false otherwise.
+ * @param p the specified {@code Point2D} to be tested
+ * @return {@code true} if the specified {@code Point2D} is
+ * inside the boundary of the {@code Shape};
+ * {@code false} otherwise.
* @since 1.2
*/
public boolean contains(Point2D p);
/**
- * Tests if the interior of the Shape intersects the
+ * Tests if the interior of the {@code Shape} intersects the
* interior of a specified rectangular area.
- * The rectangular area is considered to intersect the Shape
+ * The rectangular area is considered to intersect the {@code Shape}
* if any point is contained in both the interior of the
- * Shape and the specified rectangular area.
+ * {@code Shape} and the specified rectangular area.
*
*
*
- * @param dsde the Shape intersect, but
+ * {@code Shape} intersect, but
* true if the interior of the Shape and
+ * @return {@code true} if the interior of the {@code Shape} and
* the interior of the rectangular area intersect, or are
* both highly likely to intersect and intersection calculations
- * would be too expensive to perform; false otherwise.
+ * would be too expensive to perform; {@code false} otherwise.
* @see java.awt.geom.Area
* @since 1.2
*/
public boolean intersects(double x, double y, double w, double h);
/**
- * Tests if the interior of the Shape intersects the
- * interior of a specified Rectangle2D.
+ * Tests if the interior of the {@code Shape} intersects the
+ * interior of a specified {@code Rectangle2D}.
* The {@code Shape.intersects()} method allows a {@code Shape}
* implementation to conservatively return {@code true} when:
*
*
*
* @param state one of named frame state constants.
- * @return Rectangle2D and the
- * Shape intersect, but
+ * there is a high probability that the {@code Rectangle2D} and the
+ * {@code Shape} intersect, but
* Rectangle2D
- * @return true if the interior of the Shape and
- * the interior of the specified Rectangle2D
+ * @param r the specified {@code Rectangle2D}
+ * @return {@code true} if the interior of the {@code Shape} and
+ * the interior of the specified {@code Rectangle2D}
* intersect, or are both highly likely to intersect and intersection
- * calculations would be too expensive to perform; false
+ * calculations would be too expensive to perform; {@code false}
* otherwise.
* @see #intersects(double, double, double, double)
* @since 1.2
@@ -266,20 +266,20 @@
public boolean intersects(Rectangle2D r);
/**
- * Tests if the interior of the Shape entirely contains
+ * Tests if the interior of the {@code Shape} entirely contains
* the specified rectangular area. All coordinates that lie inside
- * the rectangular area must lie within the Shape for the
+ * the rectangular area must lie within the {@code Shape} for the
* entire rectangular area to be considered contained within the
- * Shape.
+ * {@code Shape}.
*
*
* This means that for some {@code Shapes} this method might
@@ -296,11 +296,11 @@
* of the specified rectangular area
* @param w the width of the specified rectangular area
* @param h the height of the specified rectangular area
- * @return intersect method returns true and
+ * the {@code intersect} method returns {@code true} and
* Shape entirely contains the rectangular area are
+ * {@code Shape} entirely contains the rectangular area are
* prohibitively expensive.
* true if the interior of the Shape
+ * @return {@code true} if the interior of the {@code Shape}
* entirely contains the specified rectangular area;
- * false otherwise or, if the Shape
+ * {@code false} otherwise or, if the {@code Shape}
* contains the rectangular area and the
- * intersects method returns true
+ * {@code intersects} method returns {@code true}
* and the containment calculations would be too expensive to
* perform.
* @see java.awt.geom.Area
@@ -310,16 +310,16 @@
public boolean contains(double x, double y, double w, double h);
/**
- * Tests if the interior of the Shape entirely contains the
- * specified Rectangle2D.
+ * Tests if the interior of the {@code Shape} entirely contains the
+ * specified {@code Rectangle2D}.
* The {@code Shape.contains()} method allows a {@code Shape}
* implementation to conservatively return {@code false} when:
*
*
* This means that for some {@code Shapes} this method might
@@ -330,12 +330,12 @@
* {@code Shape} objects and therefore can be used if a more precise
* answer is required.
*
- * @param r The specified intersect method returns true and
+ * the {@code intersect} method returns {@code true} and
* Shape entirely contains the Rectangle2D
+ * {@code Shape} entirely contains the {@code Rectangle2D}
* are prohibitively expensive.
* Rectangle2D
- * @return true if the interior of the Shape
- * entirely contains the Rectangle2D;
- * false otherwise or, if the Shape
- * contains the Rectangle2D and the
- * intersects method returns true
+ * @param r The specified {@code Rectangle2D}
+ * @return {@code true} if the interior of the {@code Shape}
+ * entirely contains the {@code Rectangle2D};
+ * {@code false} otherwise or, if the {@code Shape}
+ * contains the {@code Rectangle2D} and the
+ * {@code intersects} method returns {@code true}
* and the containment calculations would be too expensive to
* perform.
* @see #contains(double, double, double, double)
@@ -345,44 +345,44 @@
/**
* Returns an iterator object that iterates along the
- * Shape boundary and provides access to the geometry of the
- * Shape outline. If an optional {@link AffineTransform}
+ * {@code Shape} boundary and provides access to the geometry of the
+ * {@code Shape} outline. If an optional {@link AffineTransform}
* is specified, the coordinates returned in the iteration are
* transformed accordingly.
* PathIterator
- * object that traverses the geometry of the Shape object
- * independently from any other PathIterator objects in use
+ * Each call to this method returns a fresh {@code PathIterator}
+ * object that traverses the geometry of the {@code Shape} object
+ * independently from any other {@code PathIterator} objects in use
* at the same time.
* Shape interface isolate iterations
+ * implementing the {@code Shape} interface isolate iterations
* that are in process from any changes that might occur to the original
* object's geometry during such iterations.
*
- * @param at an optional AffineTransform to be applied to the
+ * @param at an optional {@code AffineTransform} to be applied to the
* coordinates as they are returned in the iteration, or
- * null if untransformed coordinates are desired
- * @return a new PathIterator object, which independently
- * traverses the geometry of the Shape.
+ * {@code null} if untransformed coordinates are desired
+ * @return a new {@code PathIterator} object, which independently
+ * traverses the geometry of the {@code Shape}.
* @since 1.2
*/
public PathIterator getPathIterator(AffineTransform at);
/**
- * Returns an iterator object that iterates along the Shape
+ * Returns an iterator object that iterates along the {@code Shape}
* boundary and provides access to a flattened view of the
- * Shape outline geometry.
+ * {@code Shape} outline geometry.
* AffineTransform is specified,
+ * If an optional {@code AffineTransform} is specified,
* the coordinates returned in the iteration are transformed
* accordingly.
* flatness parameter, which specifies the
+ * by the {@code flatness} parameter, which specifies the
* maximum distance that any point on the unflattened transformed
* curve can deviate from the returned flattened path segments.
* Note that a limit on the accuracy of the flattened path might be
@@ -390,24 +390,24 @@
* treated as larger values. This limit, if there is one, is
* defined by the particular implementation that is used.
* PathIterator
- * object that traverses the Shape object geometry
- * independently from any other PathIterator objects in use at
+ * Each call to this method returns a fresh {@code PathIterator}
+ * object that traverses the {@code Shape} object geometry
+ * independently from any other {@code PathIterator} objects in use at
* the same time.
* Shape interface isolate iterations
+ * implementing the {@code Shape} interface isolate iterations
* that are in process from any changes that might occur to the original
* object's geometry during such iterations.
*
- * @param at an optional AffineTransform to be applied to the
+ * @param at an optional {@code AffineTransform} to be applied to the
* coordinates as they are returned in the iteration, or
- * null if untransformed coordinates are desired
+ * {@code null} if untransformed coordinates are desired
* @param flatness the maximum distance that the line segments used to
* approximate the curved segments are allowed to deviate
* from any point on the original curve
- * @return a new PathIterator that independently traverses
- * a flattened view of the geometry of the Shape.
+ * @return a new {@code PathIterator} that independently traverses
+ * a flattened view of the geometry of the {@code Shape}.
* @since 1.2
*/
public PathIterator getPathIterator(AffineTransform at, double flatness);
--- old/src/java.desktop/share/classes/java/awt/SplashScreen.java 2015-10-04 22:53:02.941273285 +0400
+++ new/src/java.desktop/share/classes/java/awt/SplashScreen.java 2015-10-04 22:53:02.753273293 +0400
@@ -48,7 +48,7 @@
* Place the image in the jar archive and specify the path in the option.
* The path should not have a leading slash.
*
- * For example, in the manifest.mf file:
+ * For example, in the {@code manifest.mf} file:
*
* Manifest-Version: 1.0
* Main-Class: Test
@@ -89,7 +89,7 @@
* can exist, and it may be obtained by using the {@link #getSplashScreen()}
* static method. In case the splash screen has not been created at
* application startup via the command line or manifest file option,
- * the getSplashScreen method returns null.
+ * the {@code getSplashScreen} method returns {@code null}.
*
* @author Oleg Semenov
* @since 1.6
@@ -108,7 +108,7 @@
* supported by the current toolkit
* @throws HeadlessException if {@code GraphicsEnvironment.isHeadless()}
* returns true
- * @return the {@link SplashScreen} instance, or null if there is
+ * @return the {@link SplashScreen} instance, or {@code null} if there is
* none or it has already been closed
*/
public static SplashScreen getSplashScreen() {
@@ -142,9 +142,9 @@
* The splash screen window is resized according to the size of
* the image and is centered on the screen.
*
- * @param imageURL the non-null URL for the new
+ * @param imageURL the non-{@code null} URL for the new
* splash screen image
- * @throws NullPointerException if {@code imageURL} is null
+ * @throws NullPointerException if {@code imageURL} is {@code null}
* @throws IOException if there was an error while loading the image
* @throws IllegalStateException if the splash screen has already been
* closed
@@ -282,7 +282,7 @@
* displayed over the main image using alpha blending. Also note that drawing
* on the overlay image does not necessarily update the contents of splash
* screen window. You should call {@code update()} on the
- * SplashScreen when you want the splash screen to be
+ * {@code SplashScreen} when you want the splash screen to be
* updated immediately.
* null if no instance exists yet.)
+ * ({@code null} if no instance exists yet.)
*
* @see #getSplashScreen
* @see #close
--- old/src/java.desktop/share/classes/java/awt/Stroke.java 2015-10-04 22:53:03.465273261 +0400
+++ new/src/java.desktop/share/classes/java/awt/Stroke.java 2015-10-04 22:53:03.277273269 +0400
@@ -26,43 +26,43 @@
package java.awt;
/**
- * The Stroke interface allows a
+ * The {@code Stroke} interface allows a
* {@link Graphics2D} object to obtain a {@link Shape} that is the
* decorated outline, or stylistic representation of the outline,
- * of the specified Shape.
- * Stroking a Shape is like tracing its outline with a
+ * of the specified {@code Shape}.
+ * Stroking a {@code Shape} is like tracing its outline with a
* marking pen of the appropriate size and shape.
* The area where the pen would place ink is the area enclosed by the
- * outline Shape.
+ * outline {@code Shape}.
* Graphics2D interface that use the
- * outline Shape returned by a Stroke object
- * include draw and any other methods that are
+ * The methods of the {@code Graphics2D} interface that use the
+ * outline {@code Shape} returned by a {@code Stroke} object
+ * include {@code draw} and any other methods that are
* implemented in terms of that method, such as
- * drawLine, drawRect,
- * drawRoundRect, drawOval,
- * drawArc, drawPolyline,
- * and drawPolygon.
+ * {@code drawLine}, {@code drawRect},
+ * {@code drawRoundRect}, {@code drawOval},
+ * {@code drawArc}, {@code drawPolyline},
+ * and {@code drawPolygon}.
* Stroke
- * must be read-only because Graphics2D does not
+ * The objects of the classes implementing {@code Stroke}
+ * must be read-only because {@code Graphics2D} does not
* clone these objects either when they are set as an attribute
- * with the setStroke method or when the
- * Graphics2D object is itself cloned.
- * If a Stroke object is modified after it is set in
- * the Graphics2D context then the behavior
+ * with the {@code setStroke} method or when the
+ * {@code Graphics2D} object is itself cloned.
+ * If a {@code Stroke} object is modified after it is set in
+ * the {@code Graphics2D} context then the behavior
* of subsequent rendering would be undefined.
* @see BasicStroke
* @see Graphics2D#setStroke
*/
public interface Stroke {
/**
- * Returns an outline Shape which encloses the area that
- * should be painted when the Shape is stroked according
+ * Returns an outline {@code Shape} which encloses the area that
+ * should be painted when the {@code Shape} is stroked according
* to the rules defined by the
- * object implementing the Stroke interface.
- * @param p a Shape to be stroked
- * @return the stroked outline Shape.
+ * object implementing the {@code Stroke} interface.
+ * @param p a {@code Shape} to be stroked
+ * @return the stroked outline {@code Shape}.
*/
Shape createStrokedShape (Shape p);
}
--- old/src/java.desktop/share/classes/java/awt/SystemColor.java 2015-10-04 22:53:03.989273237 +0400
+++ new/src/java.desktop/share/classes/java/awt/SystemColor.java 2015-10-04 22:53:03.797273246 +0400
@@ -36,15 +36,15 @@
* update of the system colors (when the user changes the colors)
* the actual RGB values of these symbolic colors will also change
* dynamically. In order to compare the "current" RGB value of a
- * SystemColor object with a non-symbolic Color object,
- * getRGB should be used rather than equals.
+ * {@code SystemColor} object with a non-symbolic Color object,
+ * {@code getRGB} should be used rather than {@code equals}.
* getDesktopProperty
- * method on java.awt.Toolkit.
+ * System color values may also be available through the {@code getDesktopProperty}
+ * method on {@code java.awt.Toolkit}.
*
* @see Toolkit#getDesktopProperty
*
@@ -380,28 +380,28 @@
/**
* The color rendered for light areas of 3D control objects, such as pushbuttons.
- * This color is typically derived from the control background color
+ * This color is typically derived from the {@code control} background color
* to provide a 3D effect.
*/
public static final SystemColor controlHighlight = new SystemColor((byte)CONTROL_HIGHLIGHT);
/**
* The color rendered for highlight areas of 3D control objects, such as pushbuttons.
- * This color is typically derived from the control background color
+ * This color is typically derived from the {@code control} background color
* to provide a 3D effect.
*/
public static final SystemColor controlLtHighlight = new SystemColor((byte)CONTROL_LT_HIGHLIGHT);
/**
* The color rendered for shadow areas of 3D control objects, such as pushbuttons.
- * This color is typically derived from the control background color
+ * This color is typically derived from the {@code control} background color
* to provide a 3D effect.
*/
public static final SystemColor controlShadow = new SystemColor((byte)CONTROL_SHADOW);
/**
* The color rendered for dark shadow areas on 3D control objects, such as pushbuttons.
- * This color is typically derived from the control background color
+ * This color is typically derived from the {@code control} background color
* to provide a 3D effect.
*/
public static final SystemColor controlDkShadow = new SystemColor((byte)CONTROL_DK_SHADOW);
@@ -487,13 +487,13 @@
}
/**
- * Returns a string representation of this Color's values.
+ * Returns a string representation of this {@code Color}'s values.
* This method is intended to be used only for debugging purposes,
* and the content and format of the returned string may vary between
* implementations.
- * The returned string may be empty but may not be null.
+ * The returned string may be empty but may not be {@code null}.
*
- * @return a string representation of this Color
+ * @return a string representation of this {@code Color}
*/
public String toString() {
return getClass().getName() + "[i=" + (index) + "]";
--- old/src/java.desktop/share/classes/java/awt/SystemTray.java 2015-10-04 22:53:04.513273214 +0400
+++ new/src/java.desktop/share/classes/java/awt/SystemTray.java 2015-10-04 22:53:04.325273222 +0400
@@ -36,7 +36,7 @@
import sun.awt.AWTPermissions;
/**
- * The SystemTray class represents the system tray for a
+ * The {@code SystemTray} class represents the system tray for a
* desktop. On Microsoft Windows it is referred to as the "Taskbar
* Status Area", on Gnome it is referred to as the "Notification
* Area", on KDE it is referred to as the "System Tray". The system
@@ -47,19 +47,19 @@
* throws {@link UnsupportedOperationException}. To detect whether the
* system tray is supported, use {@link SystemTray#isSupported}.
*
- * SystemTray may contain one or more {@link
+ * TrayIcon consists of an
+ * {@link #remove}. {@code TrayIcon} consists of an
* image, a popup menu and a set of associated listeners. Please see
* the {@link TrayIcon} class for details.
*
- * SystemTray
+ * SystemTray
+ * the desktop while the app is running. The {@code SystemTray}
* instance can be obtained from the {@link #getSystemTray} method.
* An application may not create its own instance of
- * SystemTray.
+ * {@code SystemTray}.
*
* SystemTray constructor.
+ * Private {@code SystemTray} constructor.
*
*/
private SystemTray() {
@@ -149,7 +149,7 @@
}
/**
- * Gets the SystemTray instance that represents the
+ * Gets the {@code SystemTray} instance that represents the
* desktop's tray area. This always returns the same instance per
* application. On some platforms the system tray may not be
* supported. You may use the {@link #isSupported} method to
@@ -160,12 +160,12 @@
* {@code SystemTray} instance. Otherwise this method will throw a
* SecurityException.
*
- * @return the SystemTray instance that represents
+ * @return the {@code SystemTray} instance that represents
* the desktop's tray area
* @throws UnsupportedOperationException if the system tray isn't
* supported by the current platform
* @throws HeadlessException if
- * GraphicsEnvironment.isHeadless() returns true
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}
* @throws SecurityException if {@code accessSystemTray} permission
* is not granted
* @see #add(TrayIcon)
@@ -203,15 +203,15 @@
* both the action listener and the popup menu. See the {@link
* SystemTray example} for an example of how to do this.
*
- * SystemTray and
- * TrayIcon it is strongly recommended that
+ * false if no system tray access is supported; this
- * method returns true if the minimal system tray access is
+ * @return {@code false} if no system tray access is supported; this
+ * method returns {@code true} if the minimal system tray access is
* supported but does not guarantee that all system tray
* functionality is supported for the current platform
*/
@@ -231,20 +231,20 @@
}
/**
- * Adds a TrayIcon to the SystemTray.
+ * Adds a {@code TrayIcon} to the {@code SystemTray}.
* The tray icon becomes visible in the system tray once it is
* added. The order in which icons are displayed in a tray is not
* specified - it is platform and implementation-dependent.
*
* SystemTray upon application exit
+ * removed from the {@code SystemTray} upon application exit
* and also when the desktop system tray becomes unavailable.
*
- * @param trayIcon the TrayIcon to be added
- * @throws NullPointerException if trayIcon is
- * null
+ * @param trayIcon the {@code TrayIcon} to be added
+ * @throws NullPointerException if {@code trayIcon} is
+ * {@code null}
* @throws IllegalArgumentException if the same instance of
- * a TrayIcon is added more than once
+ * a {@code TrayIcon} is added more than once
* @throws AWTException if the desktop system tray is missing
* @see #remove(TrayIcon)
* @see #getSystemTray
@@ -284,18 +284,18 @@
}
/**
- * Removes the specified TrayIcon from the
- * SystemTray.
+ * Removes the specified {@code TrayIcon} from the
+ * {@code SystemTray}.
*
* SystemTray upon application exit
+ * removed from the {@code SystemTray} upon application exit
* and also when the desktop system tray becomes unavailable.
*
- * trayIcon is null or was not
+ * TrayIcon to be removed
+ * @param trayIcon the {@code TrayIcon} to be removed
* @see #add(TrayIcon)
* @see TrayIcon
*/
@@ -328,8 +328,8 @@
*
* TrayIcon from the
- * SystemTray, use the {@link
+ * remove a {@code TrayIcon} from the
+ * {@code SystemTray}, use the {@link
* #remove(TrayIcon)} method.
*
* @return an array of all tray icons added to this tray, or an
@@ -351,7 +351,7 @@
* occupy in the system tray. Developers may use this methods to
* acquire the preferred size for the image property of a tray icon
* before it is created. For convenience, there is a similar
- * method {@link TrayIcon#getSize} in the TrayIcon class.
+ * method {@link TrayIcon#getSize} in the {@code TrayIcon} class.
*
* @return the default size of a tray icon, in pixels
* @see TrayIcon#setImageAutoSize(boolean)
@@ -383,7 +383,7 @@
*
*
--- old/src/java.desktop/share/classes/java/awt/TextArea.java 2015-10-04 22:53:05.041273190 +0400
+++ new/src/java.desktop/share/classes/java/awt/TextArea.java 2015-10-04 22:53:04.853273199 +0400
@@ -35,7 +35,7 @@
import javax.accessibility.AccessibleStateSet;
/**
- * A {@code systemTray}
* This property contains {@code SystemTray} instance when the system tray
- * is available or
* null otherwise.
This property is changed
+ * is available or {@code null} otherwise.
This property is changed
* when the system tray becomes available or unavailable on the desktop.
* The property is accessed by the {@link #getSystemTray} method.TextArea object is a multi-line region
+ * A {@code TextArea} object is a multi-line region
* that displays text. It can be set to allow editing or
* to be read-only.
* TextArea.
+ * The number of rows in the {@code TextArea}.
* This parameter will determine the text area's height.
* Guaranteed to be non-negative.
*
@@ -67,7 +67,7 @@
int rows;
/**
- * The number of columns in the TextArea.
+ * The number of columns in the {@code TextArea}.
* A column is an approximate average character
* width that is platform-dependent.
* This parameter will determine the text area's width.
@@ -109,10 +109,10 @@
/**
* Determines which scrollbars are created for the
* text area. It can be one of four values :
- * SCROLLBARS_BOTH = both scrollbars.
- * SCROLLBARS_HORIZONTAL_ONLY = Horizontal bar only.
- * SCROLLBARS_VERTICAL_ONLY = Vertical bar only.
- * SCROLLBARS_NONE = No scrollbars.
+ * {@code SCROLLBARS_BOTH} = both scrollbars.
+ * {@code SCROLLBARS_HORIZONTAL_ONLY} = Horizontal bar only.
+ * {@code SCROLLBARS_VERTICAL_ONLY} = Vertical bar only.
+ * {@code SCROLLBARS_NONE} = No scrollbars.
*
* @serial
* @see #getScrollbarVisibility()
@@ -155,7 +155,7 @@
* {@link #SCROLLBARS_BOTH}, so both vertical and horizontal
* scrollbars will be visible for this text area.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns true
+ * {@code GraphicsEnvironment.isHeadless} returns true
* @see java.awt.GraphicsEnvironment#isHeadless()
*/
public TextArea() throws HeadlessException {
@@ -168,10 +168,10 @@
* {@link #SCROLLBARS_BOTH}, so both vertical and horizontal
* scrollbars will be visible for this text area.
* @param text the text to be displayed; if
- * text is null, the empty
- * string "" will be displayed
+ * {@code text} is {@code null}, the empty
+ * string {@code ""} will be displayed
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns true
+ * {@code GraphicsEnvironment.isHeadless} returns true
* @see java.awt.GraphicsEnvironment#isHeadless()
*/
public TextArea(String text) throws HeadlessException {
@@ -189,7 +189,7 @@
* @param rows the number of rows
* @param columns the number of columns
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns true
+ * {@code GraphicsEnvironment.isHeadless} returns true
* @see java.awt.GraphicsEnvironment#isHeadless()
*/
public TextArea(int rows, int columns) throws HeadlessException {
@@ -205,12 +205,12 @@
* vertical and horizontal scrollbars will be visible for this
* text area.
* @param text the text to be displayed; if
- * text is null, the empty
- * string "" will be displayed
+ * {@code text} is {@code null}, the empty
+ * string {@code ""} will be displayed
* @param rows the number of rows
* @param columns the number of columns
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns true
+ * {@code GraphicsEnvironment.isHeadless} returns true
* @see java.awt.GraphicsEnvironment#isHeadless()
*/
public TextArea(String text, int rows, int columns)
@@ -221,36 +221,36 @@
/**
* Constructs a new text area with the specified text,
* and with the rows, columns, and scroll bar visibility
- * as specified. All TextArea constructors defer to
+ * as specified. All {@code TextArea} constructors defer to
* this one.
* TextArea class defines several constants
+ * The {@code TextArea} class defines several constants
* that can be supplied as values for the
- * scrollbars argument:
+ * {@code scrollbars} argument:
*
- *
* Any other value for the
- * SCROLLBARS_BOTH,
- * SCROLLBARS_VERTICAL_ONLY,
- * SCROLLBARS_HORIZONTAL_ONLY,
- * SCROLLBARS_NONE.
+ * scrollbars argument is invalid and will result in
+ * {@code scrollbars} argument is invalid and will result in
* this text area being created with scrollbar visibility equal to
* the default value of {@link #SCROLLBARS_BOTH}.
* @param text the text to be displayed; if
- * text is null, the empty
- * string "" will be displayed
+ * {@code text} is {@code null}, the empty
+ * string {@code ""} will be displayed
* @param rows the number of rows; if
- * rows is less than 0,
- * rows is set to 0
+ * {@code rows} is less than {@code 0},
+ * {@code rows} is set to {@code 0}
* @param columns the number of columns; if
- * columns is less than 0,
- * columns is set to 0
+ * {@code columns} is less than {@code 0},
+ * {@code columns} is set to {@code 0}
* @param scrollbars a constant that determines what
* scrollbars are created to view the text area
* @since 1.1
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns true
+ * {@code GraphicsEnvironment.isHeadless} returns true
* @see java.awt.GraphicsEnvironment#isHeadless()
*/
public TextArea(String text, int rows, int columns, int scrollbars)
@@ -273,8 +273,8 @@
}
/**
- * Construct a name for this component. Called by getName
- * when the name is null.
+ * Construct a name for this component. Called by {@code getName}
+ * when the name is {@code null}.
*/
String constructComponentName() {
synchronized (TextArea.class) {
@@ -283,8 +283,8 @@
}
/**
- * Creates the TextArea's peer. The peer allows us to modify
- * the appearance of the TextArea without changing any of its
+ * Creates the {@code TextArea}'s peer. The peer allows us to modify
+ * the appearance of the {@code TextArea} without changing any of its
* functionality.
*/
public void addNotify() {
@@ -298,11 +298,11 @@
/**
* Inserts the specified text at the specified position
* in this text area.
- * null or inconsistent
+ * null text to insert
+ * @param str the non-{@code null} text to insert
* @param pos the position at which to insert
* @see java.awt.TextComponent#setText
* @see java.awt.TextArea#replaceRange
@@ -320,7 +320,7 @@
* @param str the non-{@code null} text to insert
* @param pos the position at which to insert
* @deprecated As of JDK version 1.1,
- * replaced by insert(String, int).
+ * replaced by {@code insert(String, int)}.
*/
@Deprecated
public synchronized void insertText(String str, int pos) {
@@ -333,11 +333,11 @@
/**
* Appends the given text to the text area's current text.
- * null or inconsistent
+ * null text to append
+ * @param str the non-{@code null} text to append
* @see java.awt.TextArea#insert
* @since 1.1
*/
@@ -350,7 +350,7 @@
*
* @param str the text to append
* @deprecated As of JDK version 1.1,
- * replaced by append(String).
+ * replaced by {@code append(String)}.
*/
@Deprecated
public synchronized void appendText(String str) {
@@ -365,11 +365,11 @@
* same as the end position).
* The text position is zero-based. The inserted substring may be
* of a different length than the text it replaces.
- * null or inconsistent
+ * null text to use as
+ * @param str the non-{@code null} text to use as
* the replacement
* @param start the start position
* @param end the end position
@@ -391,7 +391,7 @@
* @param start the start position
* @param end the end position
* @deprecated As of JDK version 1.1,
- * replaced by replaceRange(String, int, int).
+ * replaced by {@code replaceRange(String, int, int)}.
*/
@Deprecated
public synchronized void replaceText(String str, int start, int end) {
@@ -419,8 +419,8 @@
* @see #getRows()
* @see #setColumns(int)
* @exception IllegalArgumentException if the value
- * supplied for rows
- * is less than 0
+ * supplied for {@code rows}
+ * is less than {@code 0}
* @since 1.1
*/
public void setRows(int rows) {
@@ -450,8 +450,8 @@
* @see #getColumns()
* @see #setRows(int)
* @exception IllegalArgumentException if the value
- * supplied for columns
- * is less than 0
+ * supplied for {@code columns}
+ * is less than {@code 0}
* @since 1.1
*/
public void setColumns(int columns) {
@@ -469,9 +469,9 @@
* Returns an enumerated value that indicates which scroll bars
* the text area uses.
* TextArea class defines four integer constants
+ * The {@code TextArea} class defines four integer constants
* that are used to specify which scroll bars are available.
- * TextArea has one constructor that gives the
+ * {@code TextArea} has one constructor that gives the
* application discretion over scroll bars.
*
* @return an integer that indicates which scroll bars are used
@@ -510,7 +510,7 @@
* @param columns the number of columns
* @return the preferred dimensions needed for the text area
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize(int, int).
+ * replaced by {@code getPreferredSize(int, int)}.
*/
@Deprecated
public Dimension preferredSize(int rows, int columns) {
@@ -534,7 +534,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize().
+ * replaced by {@code getPreferredSize()}.
*/
@Deprecated
public Dimension preferredSize() {
@@ -568,7 +568,7 @@
* @param columns the number of columns
* @return the minimum size for the text area
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize(int, int).
+ * replaced by {@code getMinimumSize(int, int)}.
*/
@Deprecated
public Dimension minimumSize(int rows, int columns) {
@@ -592,7 +592,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize().
+ * replaced by {@code getMinimumSize()}.
*/
@Deprecated
public Dimension minimumSize() {
@@ -604,11 +604,11 @@
}
/**
- * Returns a string representing the state of this TextArea.
+ * Returns a string representing the state of this {@code TextArea}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this text area
*/
@@ -650,8 +650,8 @@
/**
* Read the ObjectInputStream.
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless() returns
- * true
+ * {@code GraphicsEnvironment.isHeadless()} returns
+ * {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
*/
private void readObject(ObjectInputStream s)
@@ -689,14 +689,14 @@
/**
- * Returns the AccessibleContext associated with
- * this TextArea. For text areas, the
- * AccessibleContext takes the form of an
- * AccessibleAWTTextArea.
- * A new AccessibleAWTTextArea instance is created if necessary.
+ * Returns the {@code AccessibleContext} associated with
+ * this {@code TextArea}. For text areas, the
+ * {@code AccessibleContext} takes the form of an
+ * {@code AccessibleAWTTextArea}.
+ * A new {@code AccessibleAWTTextArea} instance is created if necessary.
*
- * @return an AccessibleAWTTextArea that serves as the
- * AccessibleContext of this TextArea
+ * @return an {@code AccessibleAWTTextArea} that serves as the
+ * {@code AccessibleContext} of this {@code TextArea}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
@@ -708,7 +708,7 @@
/**
* This class implements accessibility support for the
- * TextArea class. It provides an implementation of the
+ * {@code TextArea} class. It provides an implementation of the
* Java Accessibility API appropriate to text area user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/TextComponent.java 2015-10-04 22:53:05.577273166 +0400
+++ new/src/java.desktop/share/classes/java/awt/TextComponent.java 2015-10-04 22:53:05.389273175 +0400
@@ -38,11 +38,11 @@
import sun.awt.InputMethodSupport;
/**
- * The TextComponent class is the superclass of
+ * The {@code TextComponent} class is the superclass of
* any component that allows the editing of some text.
* TextComponent class defines a set of methods
+ * {@code TextComponent} class defines a set of methods
* that determine whether or not this text is editable. If the
* component is editable, it defines another set of methods
* that supports a text insertion caret.
@@ -61,7 +61,7 @@
/**
* The value of the text.
- * A null value is the same as "".
+ * A {@code null} value is the same as "".
*
* @serial
* @see #setText(String)
@@ -71,9 +71,9 @@
/**
* A boolean indicating whether or not this
- * TextComponent is editable.
- * It will be true if the text component
- * is editable and false if not.
+ * {@code TextComponent} is editable.
+ * It will be {@code true} if the text component
+ * is editable and {@code false} if not.
*
* @serial
* @see #isEditable()
@@ -82,7 +82,7 @@
/**
* The selection refers to the selected text, and the
- * selectionStart is the start position
+ * {@code selectionStart} is the start position
* of the selected text.
*
* @serial
@@ -93,7 +93,7 @@
/**
* The selection refers to the selected text, and the
- * selectionEnd
+ * {@code selectionEnd}
* is the end position of the selected text.
*
* @serial
@@ -120,12 +120,12 @@
/**
* Constructs a new text component initialized with the
* specified text. Sets the value of the cursor to
- * Cursor.TEXT_CURSOR.
+ * {@code Cursor.TEXT_CURSOR}.
* @param text the text to be displayed; if
- * text is null, the empty
- * string "" will be displayed
+ * {@code text} is {@code null}, the empty
+ * string {@code ""} will be displayed
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless
+ * {@code GraphicsEnvironment.isHeadless}
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
* @see java.awt.Cursor
@@ -203,9 +203,9 @@
}
/**
- * Removes the TextComponent's peer.
+ * Removes the {@code TextComponent}'s peer.
* The peer allows us to modify the appearance of the
- * TextComponent without changing its
+ * {@code TextComponent} without changing its
* functionality.
*/
public void removeNotify() {
@@ -224,7 +224,7 @@
* Sets the text that is presented by this
* text component to be the specified text.
* @param t the new text;
- * if this parameter is null then
+ * if this parameter is {@code null} then
* the text is set to the empty string ""
* @see java.awt.TextComponent#getText
*/
@@ -245,7 +245,7 @@
* Returns the text that is presented by this text component.
* By default, this is an empty string.
*
- * @return the value of this TextComponent
+ * @return the value of this {@code TextComponent}
* @see java.awt.TextComponent#setText
*/
public synchronized String getText() {
@@ -268,8 +268,8 @@
/**
* Indicates whether or not this text component is editable.
- * @return true if this text component is
- * editable; false otherwise.
+ * @return {@code true} if this text component is
+ * editable; {@code false} otherwise.
* @see java.awt.TextComponent#setEditable
* @since 1.0
*/
@@ -281,8 +281,8 @@
* Sets the flag that determines whether or not this
* text component is editable.
* true, this text component
- * becomes user editable. If the flag is set to false,
+ * If the flag is set to {@code true}, this text component
+ * becomes user editable. If the flag is set to {@code false},
* the user cannot change the text of this text component.
* By default, non-editable text components have a background color
* of SystemColor.control. This default can be overridden by
@@ -361,7 +361,7 @@
* to be at or before the current selection end. It also
* cannot be set to less than zero, the beginning of the
* component's text.
- * If the caller supplies a value for selectionStart
+ * If the caller supplies a value for {@code selectionStart}
* that is out of bounds, the method enforces these constraints
* silently, and without failure.
* @param selectionStart the start position of the
@@ -397,7 +397,7 @@
* the specified position. The new end point is constrained
* to be at or after the current selection start. It also
* cannot be set beyond the end of the component's text.
- * If the caller supplies a value for selectionEnd
+ * If the caller supplies a value for {@code selectionEnd}
* that is out of bounds, the method enforces these constraints
* silently, and without failure.
* @param selectionEnd the end position of the
@@ -423,8 +423,8 @@
* equal to the length of the text component's text. The
* character positions are indexed starting with zero.
* The length of the selection is
- * endPosition - startPosition, so the
- * character at endPosition is not selected.
+ * {@code endPosition} - {@code startPosition}, so the
+ * character at {@code endPosition} is not selected.
* If the start and end positions of the selected text are equal,
* all text is deselected.
* char value) to be selected
+ * character ({@code char} value) to be selected
* @param selectionEnd the zero-based end position of the
- text to be selected; the character (char value) at
- selectionEnd is not selected
+ * text to be selected; the character ({@code char} value) at
+ * {@code selectionEnd} is not selected
* @see java.awt.TextComponent#setSelectionStart
* @see java.awt.TextComponent#setSelectionEnd
* @see java.awt.TextComponent#selectAll
@@ -489,13 +489,13 @@
* and the last character of the text, inclusive.
* If the passed-in value is greater than this range,
* the value is set to the last character (or 0 if
- * the TextComponent contains no text)
+ * the {@code TextComponent} contains no text)
* and no error is returned. If the passed-in value is
- * less than 0, an IllegalArgumentException
+ * less than 0, an {@code IllegalArgumentException}
* is thrown.
*
* @param position the position of the text insertion caret
- * @exception IllegalArgumentException if position
+ * @exception IllegalArgumentException if {@code position}
* is less than zero
* @since 1.1
*/
@@ -547,7 +547,7 @@
/**
* Adds the specified text event listener to receive text events
* from this text component.
- * If l is null, no exception is
+ * If {@code l} is {@code null}, no exception is
* thrown and no action is performed.
* l is null, no exception is
+ * If {@code l} is {@code null}, no exception is
* thrown and no action is performed.
* TextListeners
+ * @return all of this text component's {@code TextListener}s
* or an empty array if no text
* listeners are currently registered
*
@@ -606,16 +606,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this TextComponent.
+ * upon this {@code TextComponent}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * TextComponent t
+ * {@code TextComponent t}
* for its text listeners with the following code:
*
* TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));
@@ -624,14 +624,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this text component,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getTextListeners
* @since 1.3
@@ -660,9 +660,9 @@
/**
* Processes events on this text component. If the event is a
- * TextEvent, it invokes the processTextEvent
- * method else it invokes its superclass's processEvent.
- * null
+ * {@code TextEvent}, it invokes the {@code processTextEvent}
+ * method else it invokes its superclass's {@code processEvent}.
+ * TextListener objects.
+ * dispatching them to any registered {@code TextListener} objects.
*
- *
- * TextListener object is registered
- * via addTextListener
- * enableEvents
+ * null
+ * TextComponent. This
+ * {@code TextComponent}. This
* method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this text component
*/
@@ -789,8 +789,8 @@
* ignored.
*
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless() returns
- * true
+ * {@code GraphicsEnvironment.isHeadless()} returns
+ * {@code true}
* @see #removeTextListener
* @see #addTextListener
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -844,7 +844,7 @@
/**
* This class implements accessibility support for the
- * TextComponent class. It provides an implementation of the
+ * {@code TextComponent} class. It provides an implementation of the
* Java Accessibility API appropriate to text component user-interface
* elements.
* @since 1.3
--- old/src/java.desktop/share/classes/java/awt/TextField.java 2015-10-04 22:53:06.133273141 +0400
+++ new/src/java.desktop/share/classes/java/awt/TextField.java 2015-10-04 22:53:05.929273150 +0400
@@ -34,12 +34,12 @@
/**
- * A TextField object is a text component
+ * A {@code TextField} object is a text component
* that allows for the editing of a single line of text.
* "Hello".
+ * display the predefined text {@code "Hello"}.
* 
@@ -59,27 +59,27 @@
*
* KeyEvent
+ * more key events are sent to the text field. A {@code KeyEvent}
* may be one of three types: keyPressed, keyReleased, or keyTyped.
* The properties of a key event indicate which of these types
* it is, as well as additional information about the event,
* such as what modifiers are applied to the key event and the
* time at which the event occurred.
* KeyListener
- * or KeyAdapter object which registered to receive such
- * events using the component's addKeyListener method.
- * (KeyAdapter objects implement the
- * KeyListener interface.)
+ * The key event is passed to every {@code KeyListener}
+ * or {@code KeyAdapter} object which registered to receive such
+ * events using the component's {@code addKeyListener} method.
+ * ({@code KeyAdapter} objects implement the
+ * {@code KeyListener} interface.)
* ActionEvent.
+ * It is also possible to fire an {@code ActionEvent}.
* If action events are enabled for the text field, they may
- * be fired by pressing the Return key.
+ * be fired by pressing the {@code Return} key.
* TextField class's processEvent
+ * The {@code TextField} class's {@code processEvent}
* method examines the action event and passes it along to
- * processActionEvent. The latter method redirects the
- * event to any ActionListener objects that have
+ * {@code processActionEvent}. The latter method redirects the
+ * event to any {@code ActionListener} objects that have
* registered to receive action events generated by this
* text field.
*
@@ -112,7 +112,7 @@
* The echo character, which is used when
* the user wishes to disguise the characters
* typed into the text field.
- * The disguises are removed if echoChar = 0.
+ * The disguises are removed if echoChar = {@code 0}.
*
* @serial
* @see #getEchoChar()
@@ -157,8 +157,8 @@
/**
* Constructs a new text field initialized with the specified text.
* @param text the text to be displayed. If
- * text is null, the empty
- * string "" will be displayed.
+ * {@code text} is {@code null}, the empty
+ * string {@code ""} will be displayed.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -172,8 +172,8 @@
* of columns. A column is an approximate average character
* width that is platform-dependent.
* @param columns the number of columns. If
- * columns is less than 0,
- * columns is set to 0.
+ * {@code columns} is less than {@code 0},
+ * {@code columns} is set to {@code 0}.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -188,11 +188,11 @@
* number of columns. A column is an approximate average character
* width that is platform-dependent.
* @param text the text to be displayed. If
- * text is null, the empty
- * string "" will be displayed.
+ * {@code text} is {@code null}, the empty
+ * string {@code ""} will be displayed.
* @param columns the number of columns. If
- * columns is less than 0,
- * columns is set to 0.
+ * {@code columns} is less than {@code 0},
+ * {@code columns} is set to {@code 0}.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -230,7 +230,7 @@
* An echo character is useful for text fields where
* user input should not be echoed to the screen, as in
* the case of a text field for entering a password.
- * If echoChar = 0, user
+ * If {@code echoChar} = {@code 0}, user
* input is echoed to the screen unchanged.
* echoChar = 0 allows
+ * Setting {@code echoChar} = {@code 0} allows
* user input to be echoed to the screen again.
* setEchoChar(char).
+ * replaced by {@code setEchoChar(char)}.
*/
@Deprecated
public synchronized void setEchoCharacter(char c) {
@@ -310,9 +310,9 @@
* An echo character is useful for text fields where
* user input should not be echoed to the screen, as in
* the case of a text field for entering a password.
- * @return true if this text field has
+ * @return {@code true} if this text field has
* a character set for echoing;
- * false otherwise.
+ * {@code false} otherwise.
* @see java.awt.TextField#setEchoChar
* @see java.awt.TextField#getEchoChar
*/
@@ -337,8 +337,8 @@
* @param columns the number of columns.
* @see java.awt.TextField#getColumns
* @exception IllegalArgumentException if the value
- * supplied for columns
- * is less than 0.
+ * supplied for {@code columns}
+ * is less than {@code 0}.
* @since 1.1
*/
public void setColumns(int columns) {
@@ -379,7 +379,7 @@
* @return the preferred size for the text field
*
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize(int).
+ * replaced by {@code getPreferredSize(int)}.
*/
@Deprecated
public Dimension preferredSize(int columns) {
@@ -403,7 +403,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getPreferredSize().
+ * replaced by {@code getPreferredSize()}.
*/
@Deprecated
public Dimension preferredSize() {
@@ -433,7 +433,7 @@
* @param columns the number of columns
* @return the minimum size for this text field
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize(int).
+ * replaced by {@code getMinimumSize(int)}.
*/
@Deprecated
public Dimension minimumSize(int columns) {
@@ -457,7 +457,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getMinimumSize().
+ * replaced by {@code getMinimumSize()}.
*/
@Deprecated
public Dimension minimumSize() {
@@ -513,7 +513,7 @@
* Returns an array of all the action listeners
* registered on this textfield.
*
- * @return all of this textfield's ActionListeners
+ * @return all of this textfield's {@code ActionListener}s
* or an empty array if no action
* listeners are currently registered
*
@@ -529,16 +529,16 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this TextField.
+ * upon this {@code TextField}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * TextField t
+ * {@code TextField t}
* for its action listeners with the following code:
*
* ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));
@@ -547,14 +547,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this textfield,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getActionListeners
* @since 1.3
@@ -583,11 +583,11 @@
/**
* Processes events on this text field. If the event
- * is an instance of ActionEvent,
- * it invokes the processActionEvent
- * method. Otherwise, it invokes processEvent
+ * is an instance of {@code ActionEvent},
+ * it invokes the {@code processActionEvent}
+ * method. Otherwise, it invokes {@code processEvent}
* on the superclass.
- * null
+ * ActionListener objects.
+ * {@code ActionListener} objects.
*
- *
- * ActionListener object is registered
- * via addActionListener.
- * enableEvents.
+ * null
+ * TextField.
+ * Returns a string representing the state of this {@code TextField}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * null.
+ * {@code null}.
*
* @return the parameter string of this text field
*/
@@ -693,8 +693,8 @@
* ignored.
*
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless() returns
- * true
+ * {@code GraphicsEnvironment.isHeadless()} returns
+ * {@code true}
* @see #removeActionListener(ActionListener)
* @see #addActionListener(ActionListener)
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -749,7 +749,7 @@
/**
* This class implements accessibility support for the
- * TextField class. It provides an implementation of the
+ * {@code TextField} class. It provides an implementation of the
* Java Accessibility API appropriate to text field user-interface elements.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/TexturePaint.java 2015-10-04 22:53:06.665273117 +0400
+++ new/src/java.desktop/share/classes/java/awt/TexturePaint.java 2015-10-04 22:53:06.473273126 +0400
@@ -31,18 +31,18 @@
import java.awt.image.ColorModel;
/**
- * The TexturePaint class provides a way to fill a
+ * The {@code TexturePaint} class provides a way to fill a
* {@link Shape} with a texture that is specified as
- * a {@link BufferedImage}. The size of the BufferedImage
- * object should be small because the BufferedImage data
- * is copied by the TexturePaint object.
+ * a {@link BufferedImage}. The size of the {@code BufferedImage}
+ * object should be small because the {@code BufferedImage} data
+ * is copied by the {@code TexturePaint} object.
* At construction time, the texture is anchored to the upper
* left corner of a {@link Rectangle2D} that is
* specified in user space. Texture is computed for
* locations in the device space by conceptually replicating the
- * specified Rectangle2D infinitely in all directions
- * in user space and mapping the BufferedImage to each
- * replicated Rectangle2D.
+ * specified {@code Rectangle2D} infinitely in all directions
+ * in user space and mapping the {@code BufferedImage} to each
+ * replicated {@code Rectangle2D}.
* @see Paint
* @see Graphics2D#setPaint
* @version 1.48, 06/05/07
@@ -57,10 +57,10 @@
double sy;
/**
- * Constructs a TexturePaint object.
- * @param txtr the BufferedImage object with the texture
+ * Constructs a {@code TexturePaint} object.
+ * @param txtr the {@code BufferedImage} object with the texture
* used for painting
- * @param anchor the Rectangle2D in user space used to
+ * @param anchor the {@code Rectangle2D} in user space used to
* anchor and replicate the texture
*/
public TexturePaint(BufferedImage txtr,
@@ -73,9 +73,9 @@
}
/**
- * Returns the BufferedImage texture used to
+ * Returns the {@code BufferedImage} texture used to
* fill the shapes.
- * @return a BufferedImage.
+ * @return a {@code BufferedImage}.
*/
public BufferedImage getImage() {
return bufImg;
@@ -84,8 +84,8 @@
/**
* Returns a copy of the anchor rectangle which positions and
* sizes the textured image.
- * @return the Rectangle2D used to anchor and
- * size this TexturePaint.
+ * @return the {@code Rectangle2D} used to anchor and
+ * size this {@code TexturePaint}.
*/
public Rectangle2D getAnchorRect() {
return new Rectangle2D.Double(tx, ty,
@@ -139,8 +139,8 @@
}
/**
- * Returns the transparency mode for this TexturePaint.
- * @return the transparency mode for this TexturePaint
+ * Returns the transparency mode for this {@code TexturePaint}.
+ * @return the transparency mode for this {@code TexturePaint}
* as an integer value.
* @see Transparency
*/
--- old/src/java.desktop/share/classes/java/awt/Toolkit.java 2015-10-04 22:53:07.201273093 +0400
+++ new/src/java.desktop/share/classes/java/awt/Toolkit.java 2015-10-04 22:53:06.997273102 +0400
@@ -69,7 +69,7 @@
/**
* This class is the abstract superclass of all actual
* implementations of the Abstract Window Toolkit. Subclasses of
- * the Toolkit class are used to bind the various components
+ * the {@code Toolkit} class are used to bind the various components
* to particular native toolkit implementations.
*
*
*
For example, calling ScrollPane.setScrollPosition
- * and then getScrollPosition may return an incorrect
+ *
For example, calling {@code ScrollPane.setScrollPosition}
+ * and then {@code getScrollPosition} may return an incorrect
* value if the original request has not yet been processed.
*
*
Calling setVisible(true) on a Window,
- * Frame or Dialog may occur
+ *
Calling {@code setVisible(true)} on a {@code Window},
+ * {@code Frame} or {@code Dialog} may occur
* asynchronously.
*
*
Calls to setSize, setBounds or
- * setLocation on a Window,
- * Frame or Dialog are forwarded
+ *
Calls to {@code setSize}, {@code setBounds} or
+ * {@code setLocation} on a {@code Window},
+ * {@code Frame} or {@code Dialog} are forwarded
* to the underlying window management system and may be
* ignored or modified. See {@link java.awt.Window} for
* more information.
* Toolkit are
+ * class directly. The methods defined by {@code Toolkit} are
* the "glue" that joins the platform-independent classes in the
- * java.awt package with their counterparts in
- * java.awt.peer. Some methods defined by
- * Toolkit query the native operating system directly.
+ * {@code java.awt} package with their counterparts in
+ * {@code java.awt.peer}. Some methods defined by
+ * {@code Toolkit} query the native operating system directly.
*
* @author Sami Shaio
* @author Arthur van Hoff
@@ -247,8 +247,8 @@
/**
* Gets the size of the screen. On systems with multiple displays, the
* primary display is used. Multi-screen aware display dimensions are
- * available from GraphicsConfiguration and
- * GraphicsDevice.
+ * available from {@code GraphicsConfiguration} and
+ * {@code GraphicsDevice}.
* @return the size of this toolkit's screen, in pixels.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
@@ -271,7 +271,7 @@
/**
* Gets the insets of the screen.
- * @param gc a GraphicsConfiguration
+ * @param gc a {@code GraphicsConfiguration}
* @return the insets of this toolkit's screen, in pixels.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
@@ -291,14 +291,14 @@
/**
* Determines the color model of this toolkit's screen.
* ColorModel is an abstract class that
+ * {@code ColorModel} is an abstract class that
* encapsulates the ability to translate between the
* pixel values of an image and its red, green, blue,
* and alpha components.
* getColorModel method
- * of the Component class.
+ * {@code getColorModel} method
+ * of the {@code Component} class.
* @return the color model of this toolkit's screen.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
@@ -332,8 +332,8 @@
* Gets the screen device metrics for rendering of the font.
* @param font a font
* @return the screen metrics of the specified font in this toolkit
- * @deprecated As of JDK version 1.2, replaced by the Font
- * method getLineMetrics.
+ * @deprecated As of JDK version 1.2, replaced by the {@code Font}
+ * method {@code getLineMetrics}.
* @see java.awt.font.LineMetrics
* @see java.awt.Font#getLineMetrics
* @see java.awt.GraphicsEnvironment#getScreenDevices
@@ -606,22 +606,22 @@
* with the same filename to the same returned Image.
* Image objects may continue to hold onto images
+ * {@code Image} objects may continue to hold onto images
* that are no longer in use for an indefinite period of time,
* developers are encouraged to implement their own caching of
* images by using the {@link #createImage(java.lang.String) createImage}
* variant wherever available.
* If the image data contained in the specified file changes,
- * the Image object returned from this method may
+ * the {@code Image} object returned from this method may
* still contain stale information which was loaded from the
* file after a prior call.
* Previously loaded image data can be manually discarded by
* calling the {@link Image#flush flush} method on the
- * returned Image.
+ * returned {@code Image}.
* checkRead method with the file specified to ensure
+ * {@code checkRead} method with the file specified to ensure
* that the access to the image is allowed.
* @param filename the name of a file containing pixel data
* in a recognized file format.
@@ -641,27 +641,27 @@
* with the same URL to the same returned Image.
* Image objects may continue to hold onto images
+ * {@code Image} objects may continue to hold onto images
* that are no longer in use for an indefinite period of time,
* developers are encouraged to implement their own caching of
* images by using the {@link #createImage(java.net.URL) createImage}
* variant wherever available.
* If the image data stored at the specified URL changes,
- * the Image object returned from this method may
+ * the {@code Image} object returned from this method may
* still contain stale information which was fetched from the
* URL after a prior call.
* Previously loaded image data can be manually discarded by
* calling the {@link Image#flush flush} method on the
- * returned Image.
+ * returned {@code Image}.
* checkPermission method with the
+ * {@code checkPermission} method with the
* url.openConnection().getPermission() permission to ensure
* that the access to the image is allowed. For compatibility
* with pre-1.2 security managers, if the access is denied with
- * FilePermission or SocketPermission,
- * the method throws the SecurityException
+ * {@code FilePermission} or {@code SocketPermission},
+ * the method throws the {@code SecurityException}
* if the corresponding 1.1-style SecurityManager.checkXXX method
* also denies permission.
* @param url the URL to use in fetching the pixel data.
@@ -681,7 +681,7 @@
* checkRead method with the specified file to ensure
+ * {@code checkRead} method with the specified file to ensure
* that the image creation is allowed.
* @param filename the name of a file containing pixel data
* in a recognized file format.
@@ -700,12 +700,12 @@
* checkPermission method with the
+ * {@code checkPermission} method with the
* url.openConnection().getPermission() permission to ensure
* that the image creation is allowed. For compatibility
* with pre-1.2 security managers, if the access is denied with
- * FilePermission or SocketPermission,
- * the method throws SecurityException
+ * {@code FilePermission} or {@code SocketPermission},
+ * the method throws {@code SecurityException}
* if the corresponding 1.1-style SecurityManager.checkXXX method
* also denies permission.
* @param url the URL to use in fetching the pixel data.
@@ -722,7 +722,7 @@
* Prepares an image for rendering.
* -1, this method prepares the image for rendering
+ * {@code -1}, this method prepares the image for rendering
* on the default screen; otherwise, this method prepares an image
* for rendering on the default screen at the specified width and height.
* prepareImage
+ * This method is called by components {@code prepareImage}
* methods.
* ImageObserver interface.
+ * with the definition of the {@code ImageObserver} interface.
* @param image the image for which to prepare a
* screen representation.
* @param width the width of the desired screen
- * representation, or -1.
+ * representation, or {@code -1}.
* @param height the height of the desired screen
- * representation, or -1.
- * @param observer the ImageObserver
+ * representation, or {@code -1}.
+ * @param observer the {@code ImageObserver}
* object to be notified as the
* image is being prepared.
- * @return true if the image has already been
- * fully prepared; false otherwise.
+ * @return {@code true} if the image has already been
+ * fully prepared; {@code false} otherwise.
* @see java.awt.Component#prepareImage(java.awt.Image,
* java.awt.image.ImageObserver)
* @see java.awt.Component#prepareImage(java.awt.Image,
@@ -761,30 +761,30 @@
* being prepared for display.
* -1, this method returns the construction status of
+ * {@code -1}, this method returns the construction status of
* a screen representation of the specified image in this toolkit.
* Otherwise, this method returns the construction status of a
* scaled representation of the image at the specified width
* and height.
* prepareImage to force
+ * An application must call {@code prepareImage} to force
* the loading of an image.
* checkImage
+ * This method is called by the component's {@code checkImage}
* methods.
* ImageObserver interface.
+ * with the definition of the {@code ImageObserver} interface.
* @param image the image whose status is being checked.
* @param width the width of the scaled version whose status is
- * being checked, or -1.
+ * being checked, or {@code -1}.
* @param height the height of the scaled version whose status
- * is being checked, or -1.
- * @param observer the ImageObserver object to be
+ * is being checked, or {@code -1}.
+ * @param observer the {@code ImageObserver} object to be
* notified as the image is being prepared.
* @return the bitwise inclusive OR of the
- * ImageObserver flags for the
+ * {@code ImageObserver} flags for the
* image data that is currently available.
* @see java.awt.Toolkit#prepareImage(java.awt.Image,
* int, int, java.awt.image.ImageObserver)
@@ -840,17 +840,17 @@
int imagelength);
/**
- * Gets a PrintJob object which is the result of initiating
+ * Gets a {@code PrintJob} object which is the result of initiating
* a print operation on the toolkit's platform.
* checkPrintJobAccess method to
+ * the security manager's {@code checkPrintJobAccess} method to
* ensure initiation of a print operation is allowed. If the default
- * implementation of checkPrintJobAccess is used (that is,
+ * implementation of {@code checkPrintJobAccess} is used (that is,
* that method is not overriden), then this results in a call to the
- * security manager's checkPermission method with a
- * RuntimePermission("queuePrintJob") permission.
+ * security manager's {@code checkPermission} method with a
+ * {@code RuntimePermission("queuePrintJob")} permission.
*
* @param frame the parent of the print dialog. May not be null.
* @param jobtitle the title of the PrintJob. A null title is equivalent
@@ -862,7 +862,7 @@
* takes JobAttributes and PageAttributes objects. This object
* may be updated to reflect the user's job choices on exit. May
* be null.
- * @return a PrintJob object, or null if the
+ * @return a {@code PrintJob} object, or {@code null} if the
* user cancelled the print job.
* @throws NullPointerException if frame is null
* @throws SecurityException if this thread is not allowed to initiate a
@@ -876,17 +876,17 @@
Properties props);
/**
- * Gets a PrintJob object which is the result of initiating
+ * Gets a {@code PrintJob} object which is the result of initiating
* a print operation on the toolkit's platform.
* checkPrintJobAccess method to
+ * the security manager's {@code checkPrintJobAccess} method to
* ensure initiation of a print operation is allowed. If the default
- * implementation of checkPrintJobAccess is used (that is,
+ * implementation of {@code checkPrintJobAccess} is used (that is,
* that method is not overriden), then this results in a call to the
- * security manager's checkPermission method with a
- * RuntimePermission("queuePrintJob") permission.
+ * security manager's {@code checkPermission} method with a
+ * {@code RuntimePermission("queuePrintJob")} permission.
*
* @param frame the parent of the print dialog. May not be null.
* @param jobtitle the title of the PrintJob. A null title is equivalent
@@ -900,7 +900,7 @@
* job. The attributes will be updated to reflect the user's
* choices as outlined in the PageAttributes documentation. May be
* null.
- * @return a PrintJob object, or null if the
+ * @return a {@code PrintJob} object, or {@code null} if the
* user cancelled the print job.
* @throws NullPointerException if frame is null
* @throws IllegalArgumentException if pageAttributes specifies differing
@@ -952,20 +952,20 @@
* applications which use native clipboard facilities.
* getTransferData() method is available in the
+ * Clipboard's {@code getTransferData()} method is available in the
* following flavors:
*
*
- * As with java.awt.datatransfer.StringSelection, if the
- * requested flavor is DataFlavor.plainTextFlavor, or an
+ * As with {@code java.awt.datatransfer.StringSelection}, if the
+ * requested flavor is {@code DataFlavor.plainTextFlavor}, or an
* equivalent flavor, a Reader is returned. Note: The behavior of
- * the system Clipboard's getTransferData() method for
- * DataFlavor.plainTextFlavor, and equivalent DataFlavors, is
- * inconsistent with the definition of DataFlavor.plainTextFlavor
- * . Because of this, support for
- * DataFlavor.plainTextFlavor, and equivalent flavors, is
+ * the system Clipboard's {@code getTransferData()} method for
+ * {@code DataFlavor.plainTextFlavor}, and equivalent DataFlavors, is
+ * inconsistent with the definition of {@code DataFlavor.plainTextFlavor}.
+ * Because of this, support for
+ * {@code DataFlavor.plainTextFlavor}, and equivalent flavors, is
* deprecated.
* Clipboard object. This allows an application to read and
+ * {@code Clipboard} object. This allows an application to read and
* modify the current, system-wide selection.
* FocusListener on all Components which support
- * text selection, and, between FOCUS_GAINED and
- * FOCUS_LOST events delivered to that Component,
- * updating the system selection Clipboard when the selection
- * changes inside the Component. Properly updating the system
+ * {@code FocusListener} on all {@code Component}s which support
+ * text selection, and, between {@code FOCUS_GAINED} and
+ * {@code FOCUS_LOST} events delivered to that {@code Component},
+ * updating the system selection {@code Clipboard} when the selection
+ * changes inside the {@code Component}. Properly updating the system
* selection ensures that a Java application will interact correctly with
* native applications and other Java applications running simultaneously
- * on the system. Note that java.awt.TextComponent and
- * javax.swing.text.JTextComponent already adhere to this
+ * on the system. Note that {@code java.awt.TextComponent} and
+ * {@code javax.swing.text.JTextComponent} already adhere to this
* policy. When using these classes, and their subclasses, developers need
* not write any additional code.
* Clipboard.
- * On those platforms, this method will return null. In such a
+ * Some platforms do not support a system selection {@code Clipboard}.
+ * On those platforms, this method will return {@code null}. In such a
* case, an application is absolved from its responsibility to update the
- * system selection Clipboard as described above.
+ * system selection {@code Clipboard} as described above.
* Clipboard, or
- * null if the native platform does not support a
- * system selection Clipboard
+ * @return the system selection as a {@code Clipboard}, or
+ * {@code null} if the native platform does not support a
+ * system selection {@code Clipboard}
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
*
@@ -1050,13 +1050,13 @@
* key for menu shortcuts.
* MenuShortcut class, are handled by the
- * MenuBar class.
+ * {@code MenuShortcut} class, are handled by the
+ * {@code MenuBar} class.
* Event.CTRL_MASK.
+ * By default, this method returns {@code Event.CTRL_MASK}.
* Toolkit implementations should override this method if the
* Control key isn't the correct key for accelerators.
- * @return the modifier mask on the Event class
+ * @return the modifier mask on the {@code Event} class
* that is used for menu shortcuts on this toolkit.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
@@ -1083,7 +1083,7 @@
* @param keyCode the key code
* @return {@code true} if the given key is currently in its "on" state;
* otherwise {@code false}
- * @exception java.lang.IllegalArgumentException if keyCode
+ * @exception java.lang.IllegalArgumentException if {@code keyCode}
* is not one of the valid key codes
* @exception java.lang.UnsupportedOperationException if the host system doesn't
* allow getting the state of this key programmatically, or if the keyboard
@@ -1119,7 +1119,7 @@
*
* @param keyCode the key code
* @param on the state of the key
- * @exception java.lang.IllegalArgumentException if keyCode
+ * @exception java.lang.IllegalArgumentException if {@code keyCode}
* is not one of the valid key codes
* @exception java.lang.UnsupportedOperationException if the host system doesn't
* allow setting the state of this key programmatically, or if the keyboard
@@ -1163,7 +1163,7 @@
* @param cursor the image to display when the cursor is activated
* @param hotSpot the X and Y of the large cursor's hot spot; the
* hotSpot values must be less than the Dimension returned by
- * getBestCursorSize
+ * {@code getBestCursorSize}
* @param name a localized description of the cursor, for Java Accessibility use
* @exception IndexOutOfBoundsException if the hotSpot values are outside
* the bounds of the cursor
@@ -1252,10 +1252,10 @@
/**
* Returns whether Toolkit supports this state for
- * Frames. This method tells whether the UI
+ * {@code Frame}s. This method tells whether the UI
* concept of, say, maximization or iconification is
* supported. It will always return false for "compound" states
- * like Frame.ICONIFIED|Frame.MAXIMIZED_VERT.
+ * like {@code Frame.ICONIFIED|Frame.MAXIMIZED_VERT}.
* In other words, the rule of thumb is that only queries with a
* single frame state constant as an argument are meaningful.
* true is this frame state is supported by
- * this Toolkit implementation, false otherwise.
+ * @return {@code true} is this frame state is supported by
+ * this Toolkit implementation, {@code false} otherwise.
* @exception HeadlessException
- * if GraphicsEnvironment.isHeadless()
- * returns true.
+ * if {@code GraphicsEnvironment.isHeadless()}
+ * returns {@code true}.
* @see java.awt.Window#addWindowStateListener
* @since 1.4
*/
@@ -1431,7 +1431,7 @@
* {@link SecurityManager#checkPermission checkPermission} method
* is called to check {@code AWTPermission("accessEventQueue")}.
*
- * @return the EventQueue object
+ * @return the {@code EventQueue} object
* @throws SecurityException
* if a security manager is set and it denies access to
* the {@code EventQueue}
@@ -1446,10 +1446,10 @@
}
/**
- * Gets the application's or applet's EventQueue
+ * Gets the application's or applet's {@code EventQueue}
* instance, without checking access. For security reasons,
- * this can only be called from a Toolkit subclass.
- * @return the EventQueue object
+ * this can only be called from a {@code Toolkit} subclass.
+ * @return the {@code EventQueue} object
*/
protected abstract EventQueue getSystemEventQueueImpl();
@@ -1664,8 +1664,8 @@
* Returns whether the always-on-top mode is supported by this toolkit.
* To detect whether the always-on-top mode is supported for a
* particular Window, use {@link Window#isAlwaysOnTopSupported}.
- * @return true, if current toolkit supports the always-on-top mode,
- * otherwise returns false
+ * @return {@code true}, if current toolkit supports the always-on-top mode,
+ * otherwise returns {@code false}
* @see Window#isAlwaysOnTopSupported
* @see Window#setAlwaysOnTop(boolean)
* @since 1.6
@@ -1677,12 +1677,12 @@
/**
* Returns whether the given modality type is supported by this toolkit. If
* a dialog with unsupported modality type is created, then
- * Dialog.ModalityType.MODELESS is used instead.
+ * {@code Dialog.ModalityType.MODELESS} is used instead.
*
* @param modalityType modality type to be checked for support by this toolkit
*
- * @return true, if current toolkit supports given modality
- * type, false otherwise
+ * @return {@code true}, if current toolkit supports given modality
+ * type, {@code false} otherwise
*
* @see java.awt.Dialog.ModalityType
* @see java.awt.Dialog#getModalityType
@@ -1695,12 +1695,12 @@
/**
* Returns whether the given modal exclusion type is supported by this
* toolkit. If an unsupported modal exclusion type property is set on a window,
- * then Dialog.ModalExclusionType.NO_EXCLUDE is used instead.
+ * then {@code Dialog.ModalExclusionType.NO_EXCLUDE} is used instead.
*
* @param modalExclusionType modal exclusion type to be checked for support by this toolkit
*
- * @return true, if current toolkit supports given modal exclusion
- * type, false otherwise
+ * @return {@code true}, if current toolkit supports given modal exclusion
+ * type, {@code false} otherwise
*
* @see java.awt.Dialog.ModalExclusionType
* @see java.awt.Window#getModalExclusionType
@@ -1739,16 +1739,16 @@
/**
* Adds an AWTEventListener to receive all AWTEvents dispatched
- * system-wide that conform to the given eventMask.
+ * system-wide that conform to the given {@code eventMask}.
* checkPermission
+ * First, if there is a security manager, its {@code checkPermission}
* method is called with an
- * AWTPermission("listenToAllAWTEvents") permission.
+ * {@code AWTPermission("listenToAllAWTEvents")} permission.
* This may result in a SecurityException.
* eventMask is a bitmask of event types to receive.
+ * {@code eventMask} is a bitmask of event types to receive.
* It is constructed by bitwise OR-ing together the event masks
- * defined in AWTEvent.
+ * defined in {@code AWTEvent}.
* checkPermission method doesn't allow the operation.
+ * {@code checkPermission} method doesn't allow the operation.
* @see #removeAWTEventListener
* @see #getAWTEventListeners
* @see SecurityManager#checkPermission
@@ -1815,9 +1815,9 @@
/**
* Removes an AWTEventListener from receiving dispatched AWTEvents.
* checkPermission
+ * First, if there is a security manager, its {@code checkPermission}
* method is called with an
- * AWTPermission("listenToAllAWTEvents") permission.
+ * {@code AWTPermission("listenToAllAWTEvents")} permission.
* This may result in a SecurityException.
* checkPermission method doesn't allow the operation.
+ * {@code checkPermission} method doesn't allow the operation.
* @see #addAWTEventListener
* @see #getAWTEventListeners
* @see SecurityManager#checkPermission
@@ -1884,23 +1884,23 @@
return calls[ci];
}
/**
- * Returns an array of all the AWTEventListeners
+ * Returns an array of all the {@code AWTEventListener}s
* registered on this toolkit.
* If there is a security manager, its {@code checkPermission}
* method is called with an
* {@code AWTPermission("listenToAllAWTEvents")} permission.
* This may result in a SecurityException.
* Listeners can be returned
- * within AWTEventListenerProxy objects, which also contain
+ * within {@code AWTEventListenerProxy} objects, which also contain
* the event mask for the given listener.
* Note that listener objects
* added multiple times appear only once in the returned array.
*
- * @return all of the AWTEventListeners or an empty
+ * @return all of the {@code AWTEventListener}s or an empty
* array if no listeners are currently registered
* @throws SecurityException
* if a security manager exists and its
- * checkPermission method doesn't allow the operation.
+ * {@code checkPermission} method doesn't allow the operation.
* @see #addAWTEventListener
* @see #removeAWTEventListener
* @see SecurityManager#checkPermission
@@ -1932,7 +1932,7 @@
}
/**
- * Returns an array of all the AWTEventListeners
+ * Returns an array of all the {@code AWTEventListener}s
* registered on this toolkit which listen to all of the event
* types specified in the {@code eventMask} argument.
* If there is a security manager, its {@code checkPermission}
@@ -1940,19 +1940,19 @@
* {@code AWTPermission("listenToAllAWTEvents")} permission.
* This may result in a SecurityException.
* Listeners can be returned
- * within AWTEventListenerProxy objects, which also contain
+ * within {@code AWTEventListenerProxy} objects, which also contain
* the event mask for the given listener.
* Note that listener objects
* added multiple times appear only once in the returned array.
*
* @param eventMask the bitmask of event types to listen for
- * @return all of the AWTEventListeners registered
+ * @return all of the {@code AWTEventListener}s registered
* on this toolkit for the specified
* event types, or an empty array if no such listeners
* are currently registered
* @throws SecurityException
* if a security manager exists and its
- * checkPermission method doesn't allow the operation.
+ * {@code checkPermission} method doesn't allow the operation.
* @see #addAWTEventListener
* @see #removeAWTEventListener
* @see SecurityManager#checkPermission
@@ -2167,9 +2167,9 @@
* The style field of the input method highlight is ignored. The map
* returned is unmodifiable.
* @param highlight input method highlight
- * @return style attribute map, or null
+ * @return style attribute map, or {@code null}
* @exception HeadlessException if
- * GraphicsEnvironment.isHeadless returns true
+ * {@code GraphicsEnvironment.isHeadless} returns true
* @see java.awt.GraphicsEnvironment#isHeadless
* @since 1.3
*/
--- old/src/java.desktop/share/classes/java/awt/Transparency.java 2015-10-04 22:53:07.769273068 +0400
+++ new/src/java.desktop/share/classes/java/awt/Transparency.java 2015-10-04 22:53:07.581273076 +0400
@@ -28,7 +28,7 @@
import java.lang.annotation.Native;
/**
- * The Transparency interface defines the common transparency
+ * The {@code Transparency} interface defines the common transparency
* modes for implementing classes.
*/
public interface Transparency {
@@ -53,8 +53,8 @@
@Native public static final int TRANSLUCENT = 3;
/**
- * Returns the type of this Transparency.
- * @return the field type of this Transparency, which is
+ * Returns the type of this {@code Transparency}.
+ * @return the field type of this {@code Transparency}, which is
* either OPAQUE, BITMASK or TRANSLUCENT.
*/
public int getTransparency();
--- old/src/java.desktop/share/classes/java/awt/TrayIcon.java 2015-10-04 22:53:08.293273044 +0400
+++ new/src/java.desktop/share/classes/java/awt/TrayIcon.java 2015-10-04 22:53:08.101273053 +0400
@@ -36,32 +36,32 @@
import java.security.AccessController;
/**
- * A TrayIcon object represents a tray icon that can be
+ * A {@code TrayIcon} object represents a tray icon that can be
* added to the {@link SystemTray system tray}. A
- * TrayIcon can have a tooltip (text), an image, a popup
+ * {@code TrayIcon} can have a tooltip (text), an image, a popup
* menu, and a set of listeners associated with it.
*
- * TrayIcon can generate various {@link MouseEvent
+ * TrayIcon processes some
+ * notification of these events. {@code TrayIcon} processes some
* of the events by itself. For example, by default, when the
- * right-mouse click is performed on the TrayIcon it
+ * right-mouse click is performed on the {@code TrayIcon} it
* displays the specified popup menu. When the mouse hovers
- * over the TrayIcon the tooltip is displayed.
+ * over the {@code TrayIcon} the tooltip is displayed.
*
- * MouseEvent is
- * dispatched to its registered listeners its component
- * property will be set to null. (See {@link
+ * source property will be set to this
- * TrayIcon. (See {@link
+ * {@code source} property will be set to this
+ * {@code TrayIcon}. (See {@link
* java.util.EventObject#getSource})
*
* TrayIcon can generate an {@link ActionEvent
+ * TrayIcon API.
+ * to use the {@code TrayIcon} API.
*
* @since 1.6
* @see SystemTray#add
@@ -147,11 +147,11 @@
}
/**
- * Creates a TrayIcon with the specified image.
+ * Creates a {@code TrayIcon} with the specified image.
*
- * @param image the Image to be used
- * @throws IllegalArgumentException if image is
- * null
+ * @param image the {@code Image} to be used
+ * @throws IllegalArgumentException if {@code image} is
+ * {@code null}
* @throws UnsupportedOperationException if the system tray isn't
* supported by the current platform
* @throws HeadlessException if
@@ -173,14 +173,14 @@
}
/**
- * Creates a TrayIcon with the specified image and
+ * Creates a {@code TrayIcon} with the specified image and
* tooltip text.
*
- * @param image the Image to be used
+ * @param image the {@code Image} to be used
* @param tooltip the string to be used as tooltip text; if the
- * value is null no tooltip is shown
- * @throws IllegalArgumentException if image is
- * null
+ * value is {@code null} no tooltip is shown
+ * @throws IllegalArgumentException if {@code image} is
+ * {@code null}
* @throws UnsupportedOperationException if the system tray isn't
* supported by the current platform
* @throws HeadlessException if
@@ -199,15 +199,15 @@
}
/**
- * Creates a TrayIcon with the specified image,
+ * Creates a {@code TrayIcon} with the specified image,
* tooltip and popup menu.
*
- * @param image the Image to be used
+ * @param image the {@code Image} to be used
* @param tooltip the string to be used as tooltip text; if the
- * value is null no tooltip is shown
+ * value is {@code null} no tooltip is shown
* @param popup the menu to be used for the tray icon's popup
- * menu; if the value is null no popup menu is shown
- * @throws IllegalArgumentException if image is null
+ * menu; if the value is {@code null} no popup menu is shown
+ * @throws IllegalArgumentException if {@code image} is {@code null}
* @throws UnsupportedOperationException if the system tray isn't
* supported by the current platform
* @throws HeadlessException if
@@ -229,7 +229,7 @@
}
/**
- * Sets the image for this TrayIcon. The previous
+ * Sets the image for this {@code TrayIcon}. The previous
* tray icon image is discarded without calling the {@link
* java.awt.Image#flush} method — you will need to call it
* manually.
@@ -243,8 +243,8 @@
* image is null
- * @param image the non-null Image to be used
+ * @throws NullPointerException if {@code image} is {@code null}
+ * @param image the non-null {@code Image} to be used
* @see #getImage
* @see Image
* @see SystemTray#add(TrayIcon)
@@ -263,7 +263,7 @@
}
/**
- * Returns the current image used for this TrayIcon.
+ * Returns the current image used for this {@code TrayIcon}.
*
* @return the image
* @see #setImage(Image)
@@ -274,13 +274,13 @@
}
/**
- * Sets the popup menu for this TrayIcon. If
- * popup is null, no popup menu will be
- * associated with this TrayIcon.
+ * Sets the popup menu for this {@code TrayIcon}. If
+ * {@code popup} is {@code null}, no popup menu will be
+ * associated with this {@code TrayIcon}.
*
- * popup must not be added to any
+ * popup may be removed from
+ * it to some parent, the {@code popup} may be removed from
* that parent.
*
* PopupMenu or null to
+ * @param popup a {@code PopupMenu} or {@code null} to
* remove any popup menu
* @see #getPopupMenu
*/
@@ -318,9 +318,9 @@
}
/**
- * Returns the popup menu associated with this TrayIcon.
+ * Returns the popup menu associated with this {@code TrayIcon}.
*
- * @return the popup menu or null if none exists
+ * @return the popup menu or {@code null} if none exists
* @see #setPopupMenu(PopupMenu)
*/
public PopupMenu getPopupMenu() {
@@ -328,16 +328,16 @@
}
/**
- * Sets the tooltip string for this TrayIcon. The
+ * Sets the tooltip string for this {@code TrayIcon}. The
* tooltip is displayed automatically when the mouse hovers over
- * the icon. Setting the tooltip to null removes any
+ * the icon. Setting the tooltip to {@code null} removes any
* tooltip text.
*
* When displayed, the tooltip string may be truncated on some platforms;
* the number of characters that may be displayed is platform-dependent.
*
* @param tooltip the string for the tooltip; if the value is
- * null no tooltip is shown
+ * {@code null} no tooltip is shown
* @see #getToolTip
*/
public void setToolTip(String tooltip) {
@@ -351,9 +351,9 @@
/**
* Returns the tooltip string associated with this
- * TrayIcon.
+ * {@code TrayIcon}.
*
- * @return the tooltip string or null if none exists
+ * @return the tooltip string or {@code null} if none exists
* @see #setToolTip(String)
*/
public String getToolTip() {
@@ -364,18 +364,18 @@
* Sets the auto-size property. Auto-size determines whether the
* tray image is automatically sized to fit the space allocated
* for the image on the tray. By default, the auto-size property
- * is set to false.
+ * is set to {@code false}.
*
- * false, and the image size
+ * true, the image is stretched or shrunk to
+ * true to auto-size the image,
- * false otherwise
+ * @param autosize {@code true} to auto-size the image,
+ * {@code false} otherwise
* @see #isImageAutoSize
*/
public void setImageAutoSize(boolean autosize) {
@@ -390,8 +390,8 @@
/**
* Returns the value of the auto-size property.
*
- * @return true if the image will be auto-sized,
- * false otherwise
+ * @return {@code true} if the image will be auto-sized,
+ * {@code false} otherwise
* @see #setImageAutoSize(boolean)
*/
public boolean isImageAutoSize() {
@@ -400,15 +400,15 @@
/**
* Adds the specified mouse listener to receive mouse events from
- * this TrayIcon. Calling this method with a
- * null value has no effect.
+ * this {@code TrayIcon}. Calling this method with a
+ * {@code null} value has no effect.
*
* MOUSE_ENTERED and
- * MOUSE_EXITED mouse events are not supported.
+ * null or an invalid value has no effect.
+ * {@code null} or an invalid value has no effect.
* TrayIcon.
+ * registered on this {@code TrayIcon}.
*
- * @return all of the MouseListeners registered on
- * this TrayIcon or an empty array if no mouse
+ * @return all of the {@code MouseListeners} registered on
+ * this {@code TrayIcon} or an empty array if no mouse
* listeners are currently registered
*
* @see #addMouseListener(MouseListener)
@@ -462,14 +462,14 @@
/**
* Adds the specified mouse listener to receive mouse-motion
- * events from this TrayIcon. Calling this method
- * with a null value has no effect.
+ * events from this {@code TrayIcon}. Calling this method
+ * with a {@code null} value has no effect.
*
* MOUSE_DRAGGED mouse event is not supported.
+ * null or an invalid value has no effect.
+ * {@code null} or an invalid value has no effect.
* TrayIcon.
+ * registered on this {@code TrayIcon}.
*
- * @return all of the MouseInputListeners registered on
- * this TrayIcon or an empty array if no mouse
+ * @return all of the {@code MouseInputListeners} registered on
+ * this {@code TrayIcon} or an empty array if no mouse
* listeners are currently registered
*
* @see #addMouseMotionListener(MouseMotionListener)
@@ -524,7 +524,7 @@
/**
* Returns the command name of the action event fired by this tray icon.
*
- * @return the action command name, or null if none exists
+ * @return the action command name, or {@code null} if none exists
* @see #addActionListener(ActionListener)
* @see #setActionCommand(String)
*/
@@ -535,7 +535,7 @@
/**
* Sets the command name for the action event fired by this tray
* icon. By default, this action command is set to
- * null.
+ * {@code null}.
*
* @param command a string used to set the tray icon's
* action command.
@@ -549,12 +549,12 @@
/**
* Adds the specified action listener to receive
- * ActionEvents from this TrayIcon.
+ * {@code ActionEvent}s from this {@code TrayIcon}.
* Action events usually occur when a user selects the tray icon,
* using either the mouse or keyboard. The conditions in which
* action events are generated are platform-dependent.
*
- * null value has no
+ * null or an invalid value has no effect.
+ * {@code null} or an invalid value has no effect.
* TrayIcon.
+ * registered on this {@code TrayIcon}.
*
- * @return all of the ActionListeners registered on
- * this TrayIcon or an empty array if no action
+ * @return all of the {@code ActionListeners} registered on
+ * this {@code TrayIcon} or an empty array if no action
* listeners are currently registered
*
* @see #addActionListener(ActionListener)
@@ -633,9 +633,9 @@
* disappear after a time or if the user clicks on it. Clicking
* on the message may trigger an {@code ActionEvent}.
*
- * null, but an
- * NullPointerException is thrown if both are
- * null.
+ * null
+ * bold; may be {@code null}
* @param text the text displayed for the particular message; may be
- * null
+ * {@code null}
* @param messageType an enum indicating the message type
- * @throws NullPointerException if both caption
- * and text are null
+ * @throws NullPointerException if both {@code caption}
+ * and {@code text} are {@code null}
*/
public void displayMessage(String caption, String text, MessageType messageType) {
if (caption == null && text == null) {
--- old/src/java.desktop/share/classes/java/awt/Window.java 2015-10-04 22:53:08.849273019 +0400
+++ new/src/java.desktop/share/classes/java/awt/Window.java 2015-10-04 22:53:08.657273028 +0400
@@ -1930,7 +1930,7 @@
* with a class literal, such as
* FooListener.class.
* For example, you can query a
- * {@code Window} {@code w}
+ * {@code Window w}
* for its window listeners with the following code:
*
* WindowListener[] wls = (WindowListener[])(w.getListeners(WindowListener.class));
--- old/src/java.desktop/share/classes/java/awt/color/ColorSpace.java 2015-10-04 22:53:09.429272993 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ColorSpace.java 2015-10-04 22:53:09.229273002 +0400
@@ -268,7 +268,7 @@
/**
* Constructs a ColorSpace object given a color space type
* and the number of components.
- * @param type one of the ColorSpace type constants
+ * @param type one of the {@code ColorSpace} type constants
* @param numcomponents the number of components in the color space
*/
protected ColorSpace (int type, int numcomponents) {
@@ -283,7 +283,7 @@
* @param colorspace a specific color space identified by one of
* the predefined class constants (e.g. CS_sRGB, CS_LINEAR_RGB,
* CS_CIEXYZ, CS_GRAY, or CS_PYCC)
- * @return the requested ColorSpace object
+ * @return the requested {@code ColorSpace} object
*/
// NOTE: This method may be called by privileged threads.
// DO NOT INVOKE CLIENT CODE ON THIS THREAD!
@@ -366,8 +366,8 @@
/**
* Returns true if the ColorSpace is CS_sRGB.
- * @return true if this is a CS_sRGB color
- * space, false if it is not
+ * @return {@code true} if this is a {@code CS_sRGB} color
+ * space, {@code false} if it is not
*/
public boolean isCS_sRGB () {
/* REMIND - make sure we know sRGBspace exists already */
@@ -381,10 +381,10 @@
* This method transforms color values using algorithms designed
* to produce the best perceptual match between input and output
* colors. In order to do colorimetric conversion of color values,
- * you should use the toCIEXYZ
+ * you should use the {@code toCIEXYZ}
* method of this color space to first convert from the input
* color space to the CS_CIEXYZ color space, and then use the
- * fromCIEXYZ method of the CS_sRGB color space to
+ * {@code fromCIEXYZ} method of the CS_sRGB color space to
* convert from CS_CIEXYZ to the output color space.
* See {@link #toCIEXYZ(float[]) toCIEXYZ} and
* {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information.
@@ -405,10 +405,10 @@
* This method transforms color values using algorithms designed
* to produce the best perceptual match between input and output
* colors. In order to do colorimetric conversion of color values,
- * you should use the toCIEXYZ
+ * you should use the {@code toCIEXYZ}
* method of the CS_sRGB color space to first convert from the input
* color space to the CS_CIEXYZ color space, and then use the
- * fromCIEXYZ method of this color space to
+ * {@code fromCIEXYZ} method of this color space to
* convert from CS_CIEXYZ to the output color space.
* See {@link #toCIEXYZ(float[]) toCIEXYZ} and
* {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information.
@@ -438,7 +438,7 @@
* A further transformation is necessary to compute the XYZ values
* that would be measured using current CIE recommended practices.
* See the {@link ICC_ColorSpace#toCIEXYZ(float[]) toCIEXYZ} method of
- * ICC_ColorSpace for further information.
+ * {@code ICC_ColorSpace} for further information.
*
* @param colorvalue a float array with length of at least the number
* of components in this ColorSpace
@@ -466,7 +466,7 @@
* current CIE recommended practices, they must be converted to D50
* relative values before being passed to this method.
* See the {@link ICC_ColorSpace#fromCIEXYZ(float[]) fromCIEXYZ} method of
- * ICC_ColorSpace for further information.
+ * {@code ICC_ColorSpace} for further information.
*
* @param colorvalue a float array with length of at least 3
* @return a float array with length equal to the number of
@@ -486,7 +486,7 @@
* primaries.
*
* @return the type constant that represents the type of this
- * ColorSpace
+ * {@code ColorSpace}
*/
public int getType() {
return type;
@@ -494,7 +494,7 @@
/**
* Returns the number of components of this ColorSpace.
- * @return The number of components in this ColorSpace.
+ * @return The number of components in this {@code ColorSpace}.
*/
public int getNumComponents() {
return numComponents;
@@ -505,7 +505,7 @@
*
* @param idx the component index
* @return the name of the component at the specified index
- * @throws IllegalArgumentException if idx is
+ * @throws IllegalArgumentException if {@code idx} is
* less than 0 or greater than numComponents - 1
*/
public String getName (int idx) {
--- old/src/java.desktop/share/classes/java/awt/color/ICC_ColorSpace.java 2015-10-04 22:53:09.957272969 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ICC_ColorSpace.java 2015-10-04 22:53:09.769272978 +0400
@@ -142,10 +142,10 @@
* This method transforms color values using algorithms designed
* to produce the best perceptual match between input and output
* colors. In order to do colorimetric conversion of color values,
- * you should use the toCIEXYZ
+ * you should use the {@code toCIEXYZ}
* method of this color space to first convert from the input
* color space to the CS_CIEXYZ color space, and then use the
- * fromCIEXYZ method of the CS_sRGB color space to
+ * {@code fromCIEXYZ} method of the CS_sRGB color space to
* convert from CS_CIEXYZ to the output color space.
* See {@link #toCIEXYZ(float[]) toCIEXYZ} and
* {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information.
@@ -194,10 +194,10 @@
* This method transforms color values using algorithms designed
* to produce the best perceptual match between input and output
* colors. In order to do colorimetric conversion of color values,
- * you should use the toCIEXYZ
+ * you should use the {@code toCIEXYZ}
* method of the CS_sRGB color space to first convert from the input
* color space to the CS_CIEXYZ color space, and then use the
- * fromCIEXYZ method of this color space to
+ * {@code fromCIEXYZ} method of this color space to
* convert from CS_CIEXYZ to the output color space.
* See {@link #toCIEXYZ(float[]) toCIEXYZ} and
* {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information.
--- old/src/java.desktop/share/classes/java/awt/color/ICC_Profile.java 2015-10-04 22:53:10.501272945 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ICC_Profile.java 2015-10-04 22:53:10.309272954 +0400
@@ -766,8 +766,8 @@
* a byte array. Throws an IllegalArgumentException if the data
* does not correspond to a valid ICC Profile.
* @param data the specified ICC Profile data
- * @return an ICC_Profile object corresponding to
- * the data in the specified data array.
+ * @return an {@code ICC_Profile} object corresponding to
+ * the data in the specified {@code data} array.
*/
public static ICC_Profile getInstance(byte[] data) {
ICC_Profile thisProfile;
@@ -821,11 +821,11 @@
*
* @param cspace the type of color space to create a profile for.
* The specified type is one of the color
- * space constants defined in the ColorSpace class.
+ * space constants defined in the {@code ColorSpace} class.
*
- * @return an ICC_Profile object corresponding to
- * the specified ColorSpace type.
- * @exception IllegalArgumentException If cspace is not
+ * @return an {@code ICC_Profile} object corresponding to
+ * the specified {@code ColorSpace} type.
+ * @exception IllegalArgumentException If {@code cspace} is not
* one of the predefined color space types.
*/
public static ICC_Profile getInstance (int cspace) {
@@ -956,7 +956,7 @@
* Profile data.
* @param fileName The file that contains the data for the profile.
*
- * @return an ICC_Profile object corresponding to
+ * @return an {@code ICC_Profile} object corresponding to
* the data in the specified file.
* @exception IOException If the specified file cannot be opened or
* an I/O error occurs while reading the file.
@@ -997,8 +997,8 @@
* error occurs while reading the stream.
* @param s The input stream from which to read the profile data.
*
- * @return an ICC_Profile object corresponding to the
- * data in the specified InputStream.
+ * @return an {@code ICC_Profile} object corresponding to the
+ * data in the specified {@code InputStream}.
*
* @exception IOException If an I/O error occurs while reading the stream.
*
@@ -1213,7 +1213,7 @@
* characteristics of the space, e.g. the chromaticities of the
* primaries.
* @return One of the color space type constants defined in the
- * ColorSpace class.
+ * {@code ColorSpace} class.
*/
public int getColorSpaceType() {
if (deferralInfo != null) {
@@ -1245,7 +1245,7 @@
* color space defined in the ICC specification. For a device
* link profile, this could be any of the color space type constants.
* @return One of the color space type constants defined in the
- * ColorSpace class.
+ * {@code ColorSpace} class.
*/
public int getPCSType() {
if (ProfileDeferralMgr.deferring) {
@@ -1342,7 +1342,7 @@
* want to get.
*
* @return A byte array that contains the tagged data element. Returns
- * null if the specified tag doesn't exist.
+ * {@code null} if the specified tag doesn't exist.
* @see #setData(int, byte[])
*/
public byte[] getData(int tagSignature) {
@@ -1929,7 +1929,7 @@
/**
* Version of the format of additional serialized data in the
- * stream. Version 1 corresponds to Java 2
+ * stream. Version {@code 1} corresponds to Java 2
* Platform, v1.3.
* @since 1.3
* @serial
@@ -1943,17 +1943,17 @@
*
* @param s stream used for serialization.
* @throws IOException
- * thrown by ObjectInputStream.
+ * thrown by {@code ObjectInputStream}.
* @serialData
- * The String is the name of one of
+ * The {@code String} is the name of one of
* CS_* constants defined in the
* {@link ColorSpace} class if the profile object is a profile
* for a predefined color space (for example
- * "CS_sRGB"). The string is null
+ * {@code "CS_sRGB"}). The string is {@code null}
* otherwise.
* byte[] array is the profile data for the
- * profile. For predefined color spaces null is
+ * The {@code byte[]} array is the profile data for the
+ * profile. For predefined color spaces {@code null} is
* written instead of the profile data. If in the future
* versions of Java API new predefined color spaces will be
* added, future versions of this class may choose to write
@@ -2003,19 +2003,19 @@
*
* @param s stream used for deserialization.
* @throws IOException
- * thrown by ObjectInputStream.
+ * thrown by {@code ObjectInputStream}.
* @throws ClassNotFoundException
- * thrown by ObjectInputStream.
+ * thrown by {@code ObjectInputStream}.
* @serialData
- * The String is the name of one of
+ * The {@code String} is the name of one of
* CS_* constants defined in the
* {@link ColorSpace} class if the profile object is a profile
* for a predefined color space (for example
- * "CS_sRGB"). The string is null
+ * {@code "CS_sRGB"}). The string is {@code null}
* otherwise.
* byte[] array is the profile data for the
- * profile. It will usually be null for the
+ * The {@code byte[]} array is the profile data for the
+ * profile. It will usually be {@code null} for the
* predefined profiles.
*
*
- * The redColorantTag,
- * greenColorantTag, blueColorantTag,
- * redTRCTag, greenTRCTag,
- * blueTRCTag, and mediaWhitePointTag tags.ICC_Profile getInstance method will
- * return an ICC_ProfileRGB object when these conditions are met.
+ * The {@code ICC_Profile getInstance} method will
+ * return an {@code ICC_ProfileRGB} object when these conditions are met.
* Three-component, matrix-based input profiles and RGB display profiles are
* examples of this type of profile.
* ICC_ProfileRGB from a CMM ID.
+ * Constructs an new {@code ICC_ProfileRGB} from a CMM ID.
*
* @param p The CMM ID for the profile.
*
@@ -119,7 +119,7 @@
}
/**
- * Constructs a new ICC_ProfileRGB from a
+ * Constructs a new {@code ICC_ProfileRGB} from a
* ProfileDeferralInfo object.
*
* @param pdi
@@ -131,10 +131,10 @@
/**
* Returns an array that contains the components of the profile's
- * mediaWhitePointTag.
+ * {@code mediaWhitePointTag}.
*
- * @return A 3-element float array containing the x, y,
- * and z components of the profile's mediaWhitePointTag.
+ * @return A 3-element {@code float} array containing the x, y,
+ * and z components of the profile's {@code mediaWhitePointTag}.
*/
public float[] getMediaWhitePoint() {
return super.getMediaWhitePoint();
@@ -142,17 +142,17 @@
/**
- * Returns a 3x3 float matrix constructed from the
- * X, Y, and Z components of the profile's redColorantTag,
- * greenColorantTag, and blueColorantTag.
+ * Returns a 3x3 {@code float} matrix constructed from the
+ * X, Y, and Z components of the profile's {@code redColorantTag},
+ * {@code greenColorantTag}, and {@code blueColorantTag}.
* float array that contains the x, y, and z
- * components of the profile's redColorantTag,
- * greenColorantTag, and blueColorantTag.
+ * @return A 3x3 {@code float} array that contains the x, y, and z
+ * components of the profile's {@code redColorantTag},
+ * {@code greenColorantTag}, and {@code blueColorantTag}.
*/
public float[][] getMatrix() {
float[][] theMatrix = new float[3][3];
@@ -191,7 +191,7 @@
* linearComponent = deviceComponent
*
*
- * @param component The ICC_ProfileRGB constant that
+ * @param component The {@code ICC_ProfileRGB} constant that
* represents the component whose TRC you want to retrieve
* @return the gamma value as a float.
* @exception ProfileDataException if the profile does not specify
@@ -225,8 +225,8 @@
/**
* Returns the TRC for a particular component as an array.
- * Component must be REDCOMPONENT,
- * GREENCOMPONENT, or BLUECOMPONENT.
+ * Component must be {@code REDCOMPONENT},
+ * {@code GREENCOMPONENT}, or {@code BLUECOMPONENT}.
* Otherwise the returned array
* represents a lookup table where the input component value
* is conceptually in the range [0.0, 1.0]. Value 0.0 maps
@@ -236,18 +236,18 @@
* array. Output values also map linearly to the range [0.0, 1.0].
* Value 0.0 is represented by an array value of 0x0000 and
* value 1.0 by 0xFFFF. In other words, the values are really unsigned
- * short values even though they are returned in a
- * short array.
+ * {@code short} values even though they are returned in a
+ * {@code short} array.
*
* If the profile has specified the corresponding TRC
* as linear (gamma = 1.0) or as a simple gamma value, this method
* throws an exception. In this case, the {@link #getGamma(int)}
* method should be used to get the gamma value.
*
- * @param component The ICC_ProfileRGB constant that
+ * @param component The {@code ICC_ProfileRGB} constant that
* represents the component whose TRC you want to retrieve:
- * REDCOMPONENT, GREENCOMPONENT, or
- * BLUECOMPONENT.
+ * {@code REDCOMPONENT}, {@code GREENCOMPONENT}, or
+ * {@code BLUECOMPONENT}.
*
* @return a short array representing the TRC.
* @exception ProfileDataException if the profile does not specify
--- old/src/java.desktop/share/classes/java/awt/dnd/Autoscroll.java 2015-10-04 22:53:11.585272896 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/Autoscroll.java 2015-10-04 22:53:11.397272905 +0400
@@ -37,17 +37,17 @@
* and institute a scroll operation in order to make obscured region(s)
* visible to the user. This feature is known as autoscrolling.
* DropTarget
+ * If a GUI control is both an active {@code DropTarget}
* and is also scrollable, it
* can receive notifications of autoscrolling gestures by the user from
* the DnD system by implementing this interface.
* Component,
+ * cursor motionless with a border region of the {@code Component},
* referred to as
* the "autoscrolling region", for a predefined period of time, this will
- * result in repeated scroll requests to the Component
- * until the drag Cursor resumes its motion.
+ * result in repeated scroll requests to the {@code Component}
+ * until the drag {@code Cursor} resumes its motion.
*
* @since 1.2
*/
@@ -55,13 +55,13 @@
public interface Autoscroll {
/**
- * This method returns the Insets describing
+ * This method returns the {@code Insets} describing
* the autoscrolling region or border relative
* to the geometry of the implementing Component.
* DropTarget
- * upon entry of the drag Cursor
- * into the associated Component.
+ * This value is read once by the {@code DropTarget}
+ * upon entry of the drag {@code Cursor}
+ * into the associated {@code Component}.
*
* @return the Insets
*/
@@ -69,9 +69,9 @@
public Insets getAutoscrollInsets();
/**
- * notify the Component to autoscroll
+ * notify the {@code Component} to autoscroll
*
- * @param cursorLocn A Point indicating the
+ * @param cursorLocn A {@code Point} indicating the
* location of the cursor that triggered this operation.
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DnDConstants.java 2015-10-04 22:53:12.105272873 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DnDConstants.java 2015-10-04 22:53:11.917272881 +0400
@@ -37,28 +37,28 @@
private DnDConstants() {} // define null private constructor.
/**
- * An int representing no action.
+ * An {@code int} representing no action.
*/
@Native public static final int ACTION_NONE = 0x0;
/**
- * An int representing a "copy" action.
+ * An {@code int} representing a "copy" action.
*/
@Native public static final int ACTION_COPY = 0x1;
/**
- * An int representing a "move" action.
+ * An {@code int} representing a "move" action.
*/
@Native public static final int ACTION_MOVE = 0x2;
/**
- * An int representing a "copy" or
- * "move" action.
+ * An {@code int} representing a "copy" or
+ * "move" action.
*/
@Native public static final int ACTION_COPY_OR_MOVE = ACTION_COPY | ACTION_MOVE;
/**
- * An int representing a "link" action.
+ * An {@code int} representing a "link" action.
*
* The link verb is found in many, if not all native DnD platforms, and the
* actual interpretation of LINK semantics is both platform
@@ -76,7 +76,7 @@
@Native public static final int ACTION_LINK = 0x40000000;
/**
- * An int representing a "reference"
+ * An {@code int} representing a "reference"
* action (synonym for ACTION_LINK).
*/
@Native public static final int ACTION_REFERENCE = ACTION_LINK;
--- old/src/java.desktop/share/classes/java/awt/dnd/DnDEventMulticaster.java 2015-10-04 22:53:12.645272849 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DnDEventMulticaster.java 2015-10-04 22:53:12.457272857 +0400
@@ -31,7 +31,7 @@
/**
- * A class extends AWTEventMulticaster to implement efficient and
+ * A class extends {@code AWTEventMulticaster} to implement efficient and
* thread-safe multi-cast event dispatching for the drag-and-drop events defined
* in the java.awt.dnd package.
*
@@ -44,9 +44,9 @@
/**
* Creates an event multicaster instance which chains listener-a
- * with listener-b. Input parameters a and b
- * should not be null, though implementations may vary in
- * choosing whether or not to throw NullPointerException
+ * with listener-b. Input parameters {@code a} and {@code b}
+ * should not be {@code null}, though implementations may vary in
+ * choosing whether or not to throw {@code NullPointerException}
* in that case.
*
* @param a listener-a
@@ -57,10 +57,10 @@
}
/**
- * Handles the DragSourceDragEvent by invoking
- * dragEnter on listener-a and listener-b.
+ * Handles the {@code DragSourceDragEvent} by invoking
+ * {@code dragEnter} on listener-a and listener-b.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragEnter(DragSourceDragEvent dsde) {
((DragSourceListener)a).dragEnter(dsde);
@@ -68,10 +68,10 @@
}
/**
- * Handles the DragSourceDragEvent by invoking
- * dragOver on listener-a and listener-b.
+ * Handles the {@code DragSourceDragEvent} by invoking
+ * {@code dragOver} on listener-a and listener-b.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragOver(DragSourceDragEvent dsde) {
((DragSourceListener)a).dragOver(dsde);
@@ -79,10 +79,10 @@
}
/**
- * Handles the DragSourceDragEvent by invoking
- * dropActionChanged on listener-a and listener-b.
+ * Handles the {@code DragSourceDragEvent} by invoking
+ * {@code dropActionChanged} on listener-a and listener-b.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dropActionChanged(DragSourceDragEvent dsde) {
((DragSourceListener)a).dropActionChanged(dsde);
@@ -90,10 +90,10 @@
}
/**
- * Handles the DragSourceEvent by invoking
- * dragExit on listener-a and listener-b.
+ * Handles the {@code DragSourceEvent} by invoking
+ * {@code dragExit} on listener-a and listener-b.
*
- * @param dse the DragSourceEvent
+ * @param dse the {@code DragSourceEvent}
*/
public void dragExit(DragSourceEvent dse) {
((DragSourceListener)a).dragExit(dse);
@@ -101,10 +101,10 @@
}
/**
- * Handles the DragSourceDropEvent by invoking
- * dragDropEnd on listener-a and listener-b.
+ * Handles the {@code DragSourceDropEvent} by invoking
+ * {@code dragDropEnd} on listener-a and listener-b.
*
- * @param dsde the DragSourceDropEvent
+ * @param dsde the {@code DragSourceDropEvent}
*/
public void dragDropEnd(DragSourceDropEvent dsde) {
((DragSourceListener)a).dragDropEnd(dsde);
@@ -112,10 +112,10 @@
}
/**
- * Handles the DragSourceDragEvent by invoking
- * dragMouseMoved on listener-a and listener-b.
+ * Handles the {@code DragSourceDragEvent} by invoking
+ * {@code dragMouseMoved} on listener-a and listener-b.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragMouseMoved(DragSourceDragEvent dsde) {
((DragSourceMotionListener)a).dragMouseMoved(dsde);
--- old/src/java.desktop/share/classes/java/awt/dnd/DragGestureEvent.java 2015-10-04 22:53:13.173272825 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragGestureEvent.java 2015-10-04 22:53:12.981272834 +0400
@@ -49,12 +49,12 @@
/**
- * A DragGestureEvent is passed
- * to DragGestureListener's
+ * A {@code DragGestureEvent} is passed
+ * to {@code DragGestureListener}'s
* dragGestureRecognized() method
- * when a particular DragGestureRecognizer detects that a
+ * when a particular {@code DragGestureRecognizer} detects that a
* platform dependent drag initiating gesture has occurred
- * on the Component that it is tracking.
+ * on the {@code Component} that it is tracking.
*
* The {@code action} field of any {@code DragGestureEvent} instance should take one of the following
* values:
@@ -76,19 +76,19 @@
private static final long serialVersionUID = 9080172649166731306L;
/**
- * Constructs a DragGestureEvent object given by the
- * DragGestureRecognizer instance firing this event,
+ * Constructs a {@code DragGestureEvent} object given by the
+ * {@code DragGestureRecognizer} instance firing this event,
* an {@code act} parameter representing
* the user's preferred action, an {@code ori} parameter
* indicating the origin of the drag, and a {@code List} of
* events that comprise the gesture({@code evs} parameter).
*
- * @param dgr The DragGestureRecognizer firing this event
+ * @param dgr The {@code DragGestureRecognizer} firing this event
* @param act The user's preferred action.
* For information on allowable values, see
* the class description for {@link DragGestureEvent}
* @param ori The origin of the drag
- * @param evs The List of events that comprise the gesture
+ * @param evs The {@code List} of events that comprise the gesture
*
* @throws IllegalArgumentException if any parameter equals {@code null}
* @throws IllegalArgumentException if the act parameter does not comply with
@@ -123,9 +123,9 @@
}
/**
- * Returns the source as a DragGestureRecognizer.
+ * Returns the source as a {@code DragGestureRecognizer}.
*
- * @return the source as a DragGestureRecognizer
+ * @return the source as a {@code DragGestureRecognizer}
*/
public DragGestureRecognizer getSourceAsDragGestureRecognizer() {
@@ -133,8 +133,8 @@
}
/**
- * Returns the Component associated
- * with this DragGestureEvent.
+ * Returns the {@code Component} associated
+ * with this {@code DragGestureEvent}.
*
* @return the Component
*/
@@ -142,16 +142,16 @@
public Component getComponent() { return component; }
/**
- * Returns the DragSource.
+ * Returns the {@code DragSource}.
*
- * @return the DragSource
+ * @return the {@code DragSource}
*/
public DragSource getDragSource() { return dragSource; }
/**
- * Returns a Point in the coordinates
- * of the Component over which the drag originated.
+ * Returns a {@code Point} in the coordinates
+ * of the {@code Component} over which the drag originated.
*
* @return the Point where the drag originated in Component coords.
*/
@@ -161,7 +161,7 @@
}
/**
- * Returns an Iterator for the events
+ * Returns an {@code Iterator} for the events
* comprising the gesture.
*
* @return an Iterator for the events comprising the gesture
@@ -170,7 +170,7 @@
public IteratorObject array of the
+ * Returns an {@code Object} array of the
* events comprising the drag gesture.
*
* @return an array of the events comprising the gesture
@@ -181,7 +181,7 @@
/**
* Returns an array of the events comprising the drag gesture.
*
- * @param array the array of EventObject sub(types)
+ * @param array the array of {@code EventObject} sub(types)
*
* @return an array of the events comprising the gesture
*/
@@ -189,7 +189,7 @@
public Object[] toArray(Object[] array) { return events.toArray(array); }
/**
- * Returns an int representing the
+ * Returns an {@code int} representing the
* action selected by the user.
*
* @return the action selected by the user
@@ -208,22 +208,22 @@
}
/**
- * Starts the drag operation given the Cursor for this drag
- * operation and the Transferable representing the source data
+ * Starts the drag operation given the {@code Cursor} for this drag
+ * operation and the {@code Transferable} representing the source data
* for this drag operation.
*
- * If a null Cursor is specified no exception will
+ * If a {@code null Cursor} is specified no exception will
* be thrown and default drag cursors will be used instead.
*
- * If a null Transferable is specified
- * NullPointerException will be thrown.
+ * If a {@code null Transferable} is specified
+ * {@code NullPointerException} will be thrown.
* @param dragCursor The initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see
* DragSourceContext
* for more details on the cursor handling mechanism
* during drag and drop
- * @param transferable The Transferable representing the source
+ * @param transferable The {@code Transferable} representing the source
* data for this drag operation.
*
* @throws InvalidDnDOperationException if the Drag and Drop
@@ -239,9 +239,9 @@
}
/**
- * Starts the drag given the initial Cursor to display,
- * the Transferable object,
- * and the DragSourceListener to use.
+ * Starts the drag given the initial {@code Cursor} to display,
+ * the {@code Transferable} object,
+ * and the {@code DragSourceListener} to use.
*
* @param dragCursor The initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
@@ -264,11 +264,11 @@
}
/**
- * Start the drag given the initial Cursor to display,
- * a drag Image, the offset of
- * the Image,
- * the Transferable object, and
- * the DragSourceListener to use.
+ * Start the drag given the initial {@code Cursor} to display,
+ * a drag {@code Image}, the offset of
+ * the {@code Image},
+ * the {@code Transferable} object, and
+ * the {@code DragSourceListener} to use.
*
* @param dragCursor The initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
@@ -293,16 +293,16 @@
}
/**
- * Serializes this DragGestureEvent. Performs default
- * serialization and then writes out this object's List of
- * gesture events if and only if the List can be serialized.
- * If not, null is written instead. In this case, a
- * DragGestureEvent created from the resulting deserialized
- * stream will contain an empty List of gesture events.
+ * Serializes this {@code DragGestureEvent}. Performs default
+ * serialization and then writes out this object's {@code List} of
+ * gesture events if and only if the {@code List} can be serialized.
+ * If not, {@code null} is written instead. In this case, a
+ * {@code DragGestureEvent} created from the resulting deserialized
+ * stream will contain an empty {@code List} of gesture events.
*
* @serialData The default serializable fields, in alphabetical order,
- * followed by either a List instance, or
- * null.
+ * followed by either a {@code List} instance, or
+ * {@code null}.
* @since 1.4
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -312,16 +312,16 @@
}
/**
- * Deserializes this DragGestureEvent. This method first
- * performs default deserialization for all non-transient
+ * Deserializes this {@code DragGestureEvent}. This method first
+ * performs default deserialization for all non-{@code transient}
* fields. An attempt is then made to deserialize this object's
- * List of gesture events as well. This is first attempted
- * by deserializing the field events, because, in releases
- * prior to 1.4, a non-transient field of this name stored the
- * List of gesture events. If this fails, the next object in
- * the stream is used instead. If the resulting List is
- * null, this object's List of gesture events
- * is set to an empty List.
+ * {@code List} of gesture events as well. This is first attempted
+ * by deserializing the field {@code events}, because, in releases
+ * prior to 1.4, a non-{@code transient} field of this name stored the
+ * {@code List} of gesture events. If this fails, the next object in
+ * the stream is used instead. If the resulting {@code List} is
+ * {@code null}, this object's {@code List} of gesture events
+ * is set to an empty {@code List}.
*
* @since 1.4
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DragGestureListener.java 2015-10-04 22:53:13.701272801 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragGestureListener.java 2015-10-04 22:53:13.509272810 +0400
@@ -56,7 +56,7 @@
*
* @see java.awt.dnd.DragGestureRecognizer
* @see java.awt.dnd.DragGestureEvent
- * @param dge the DragGestureEvent describing
+ * @param dge the {@code DragGestureEvent} describing
* the gesture that has just occurred
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DragGestureRecognizer.java 2015-10-04 22:53:14.237272777 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragGestureRecognizer.java 2015-10-04 22:53:14.049272786 +0400
@@ -40,41 +40,41 @@
import java.io.Serializable;
/**
- * The DragGestureRecognizer is an
+ * The {@code DragGestureRecognizer} is an
* abstract base class for the specification
* of a platform-dependent listener that can be associated with a particular
- * Component in order to
+ * {@code Component} in order to
* identify platform-dependent drag initiating gestures.
* DragGestureRecognizer
+ * The appropriate {@code DragGestureRecognizer}
* subclass instance is obtained from the
* {@link DragSource} associated with
- * a particular Component, or from the Toolkit object via its
+ * a particular {@code Component}, or from the {@code Toolkit} object via its
* {@link java.awt.Toolkit#createDragGestureRecognizer createDragGestureRecognizer()}
* method.
* DragGestureRecognizer
- * is associated with a particular Component
+ * Once the {@code DragGestureRecognizer}
+ * is associated with a particular {@code Component}
* it will register the appropriate listener interfaces on that
- * Component
- * in order to track the input events delivered to the Component.
+ * {@code Component}
+ * in order to track the input events delivered to the {@code Component}.
* DragGestureRecognizer identifies a sequence of events
- * on the Component as a drag initiating gesture, it will notify
- * its unicast DragGestureListener by
+ * Once the {@code DragGestureRecognizer} identifies a sequence of events
+ * on the {@code Component} as a drag initiating gesture, it will notify
+ * its unicast {@code DragGestureListener} by
* invoking its
* {@link java.awt.dnd.DragGestureListener#dragGestureRecognized gestureRecognized()}
* method.
* DragGestureRecognizer
+ * When a concrete {@code DragGestureRecognizer}
* instance detects a drag initiating
- * gesture on the Component it is associated with,
+ * gesture on the {@code Component} it is associated with,
* it fires a {@link DragGestureEvent} to
- * the DragGestureListener registered on
- * its unicast event source for DragGestureListener
- * events. This DragGestureListener is responsible
+ * the {@code DragGestureListener} registered on
+ * its unicast event source for {@code DragGestureListener}
+ * events. This {@code DragGestureListener} is responsible
* for causing the associated
- * DragSource to start the Drag and Drop operation (if
+ * {@code DragSource} to start the Drag and Drop operation (if
* appropriate).
*
* @author Laurence P. G. Cable
@@ -88,36 +88,36 @@
private static final long serialVersionUID = 8996673345831063337L;
/**
- * Construct a new DragGestureRecognizer
- * given the DragSource to be used
- * in this Drag and Drop operation, the Component
- * this DragGestureRecognizer should "observe"
+ * Construct a new {@code DragGestureRecognizer}
+ * given the {@code DragSource} to be used
+ * in this Drag and Drop operation, the {@code Component}
+ * this {@code DragGestureRecognizer} should "observe"
* for drag initiating gestures, the action(s) supported
* for this Drag and Drop operation, and the
- * DragGestureListener to notify
+ * {@code DragGestureListener} to notify
* once a drag initiating gesture has been detected.
*
- * @param ds the DragSource this
- * DragGestureRecognizer
+ * @param ds the {@code DragSource} this
+ * {@code DragGestureRecognizer}
* will use to process the Drag and Drop operation
*
- * @param c the Component
- * this DragGestureRecognizer
+ * @param c the {@code Component}
+ * this {@code DragGestureRecognizer}
* should "observe" the event stream to,
* in order to detect a drag initiating gesture.
- * If this value is null, the
- * DragGestureRecognizer
- * is not associated with any Component.
+ * If this value is {@code null}, the
+ * {@code DragGestureRecognizer}
+ * is not associated with any {@code Component}.
*
* @param sa the set (logical OR) of the
- * DnDConstants
+ * {@code DnDConstants}
* that this Drag and Drop operation will support
*
- * @param dgl the DragGestureRecognizer
+ * @param dgl the {@code DragGestureRecognizer}
* to notify when a drag gesture is detected
*
* @throws IllegalArgumentException
- * if ds is null.
+ * if ds is {@code null}.
*/
protected DragGestureRecognizer(DragSource ds, Component c, int sa, DragGestureListener dgl) {
@@ -137,30 +137,30 @@
}
/**
- * Construct a new DragGestureRecognizer
- * given the DragSource to be used in this
+ * Construct a new {@code DragGestureRecognizer}
+ * given the {@code DragSource} to be used in this
* Drag and Drop
- * operation, the Component this
- * DragGestureRecognizer should "observe"
+ * operation, the {@code Component} this
+ * {@code DragGestureRecognizer} should "observe"
* for drag initiating gestures, and the action(s)
* supported for this Drag and Drop operation.
*
- * @param ds the DragSource this
- * DragGestureRecognizer will use to
+ * @param ds the {@code DragSource} this
+ * {@code DragGestureRecognizer} will use to
* process the Drag and Drop operation
*
- * @param c the Component this
- * DragGestureRecognizer should "observe" the event
+ * @param c the {@code Component} this
+ * {@code DragGestureRecognizer} should "observe" the event
* stream to, in order to detect a drag initiating gesture.
- * If this value is null, the
- * DragGestureRecognizer
- * is not associated with any Component.
+ * If this value is {@code null}, the
+ * {@code DragGestureRecognizer}
+ * is not associated with any {@code Component}.
*
- * @param sa the set (logical OR) of the DnDConstants
+ * @param sa the set (logical OR) of the {@code DnDConstants}
* that this Drag and Drop operation will support
*
* @throws IllegalArgumentException
- * if ds is null.
+ * if ds is {@code null}.
*/
protected DragGestureRecognizer(DragSource ds, Component c, int sa) {
@@ -168,27 +168,27 @@
}
/**
- * Construct a new DragGestureRecognizer
- * given the DragSource to be used
+ * Construct a new {@code DragGestureRecognizer}
+ * given the {@code DragSource} to be used
* in this Drag and Drop operation, and
- * the Component this
- * DragGestureRecognizer
+ * the {@code Component} this
+ * {@code DragGestureRecognizer}
* should "observe" for drag initiating gestures.
*
- * @param ds the DragSource this
- * DragGestureRecognizer
+ * @param ds the {@code DragSource} this
+ * {@code DragGestureRecognizer}
* will use to process the Drag and Drop operation
*
- * @param c the Component
- * this DragGestureRecognizer
+ * @param c the {@code Component}
+ * this {@code DragGestureRecognizer}
* should "observe" the event stream to,
* in order to detect a drag initiating gesture.
- * If this value is null,
- * the DragGestureRecognizer
- * is not associated with any Component.
+ * If this value is {@code null},
+ * the {@code DragGestureRecognizer}
+ * is not associated with any {@code Component}.
*
* @throws IllegalArgumentException
- * if ds is null.
+ * if ds is {@code null}.
*/
protected DragGestureRecognizer(DragSource ds, Component c) {
@@ -196,16 +196,16 @@
}
/**
- * Construct a new DragGestureRecognizer
- * given the DragSource to be used in this
+ * Construct a new {@code DragGestureRecognizer}
+ * given the {@code DragSource} to be used in this
* Drag and Drop operation.
*
- * @param ds the DragSource this
- * DragGestureRecognizer will
+ * @param ds the {@code DragSource} this
+ * {@code DragGestureRecognizer} will
* use to process the Drag and Drop operation
*
* @throws IllegalArgumentException
- * if ds is null.
+ * if ds is {@code null}.
*/
protected DragGestureRecognizer(DragSource ds) {
@@ -229,8 +229,8 @@
protected abstract void unregisterListeners();
/**
- * This method returns the DragSource
- * this DragGestureRecognizer
+ * This method returns the {@code DragSource}
+ * this {@code DragGestureRecognizer}
* will use in order to process the Drag and Drop
* operation.
*
@@ -240,9 +240,9 @@
public DragSource getDragSource() { return dragSource; }
/**
- * This method returns the Component
+ * This method returns the {@code Component}
* that is to be "observed" by the
- * DragGestureRecognizer
+ * {@code DragGestureRecognizer}
* for drag initiating gestures.
*
* @return The Component this DragGestureRecognizer
@@ -257,7 +257,7 @@
* registerListeners() and unregisterListeners() are called as a side
* effect as appropriate.
*
- * @param c The Component or null
+ * @param c The {@code Component} or {@code null}
*/
public synchronized void setComponent(Component c) {
@@ -309,13 +309,13 @@
public void resetRecognizer() { events.clear(); }
/**
- * Register a new DragGestureListener.
+ * Register a new {@code DragGestureListener}.
*
- * @param dgl the DragGestureListener to register
- * with this DragGestureRecognizer.
+ * @param dgl the {@code DragGestureListener} to register
+ * with this {@code DragGestureRecognizer}.
*
* @throws java.util.TooManyListenersException if a
- * DragGestureListener has already been added.
+ * {@code DragGestureListener} has already been added.
*/
public synchronized void addDragGestureListener(DragGestureListener dgl) throws TooManyListenersException {
@@ -331,11 +331,11 @@
/**
* unregister the current DragGestureListener
*
- * @param dgl the DragGestureListener to unregister
- * from this DragGestureRecognizer
+ * @param dgl the {@code DragGestureListener} to unregister
+ * from this {@code DragGestureRecognizer}
*
* @throws IllegalArgumentException if
- * dgl is not (equal to) the currently registered DragGestureListener.
+ * dgl is not (equal to) the currently registered {@code DragGestureListener}.
*/
public synchronized void removeDragGestureListener(DragGestureListener dgl) {
@@ -370,16 +370,16 @@
* all Events that are recognized as part of the series of Events that go
* to comprise a Drag and Drop initiating gesture via this API.
* DragGestureRecognizer
- * implementation to add an InputEvent
+ * This method is used by a {@code DragGestureRecognizer}
+ * implementation to add an {@code InputEvent}
* subclass (that it believes is one in a series
* of events that comprise a Drag and Drop operation)
* to the array of events that this
- * DragGestureRecognizer maintains internally.
+ * {@code DragGestureRecognizer} maintains internally.
*
- * @param awtie the InputEvent
- * to add to this DragGestureRecognizer's
- * internal array of events. Note that null
+ * @param awtie the {@code InputEvent}
+ * to add to this {@code DragGestureRecognizer}'s
+ * internal array of events. Note that {@code null}
* is not a valid value, and will be ignored.
*/
@@ -388,14 +388,14 @@
}
/**
- * Serializes this DragGestureRecognizer. This method first
+ * Serializes this {@code DragGestureRecognizer}. This method first
* performs default serialization. Then, this object's
- * DragGestureListener is written out if and only if it can be
- * serialized. If not, null is written instead.
+ * {@code DragGestureListener} is written out if and only if it can be
+ * serialized. If not, {@code null} is written instead.
*
* @serialData The default serializable fields, in alphabetical order,
- * followed by either a DragGestureListener, or
- * null.
+ * followed by either a {@code DragGestureListener}, or
+ * {@code null}.
* @since 1.4
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -406,9 +406,9 @@
}
/**
- * Deserializes this DragGestureRecognizer. This method first
- * performs default deserialization for all non-transient
- * fields. This object's DragGestureListener is then
+ * Deserializes this {@code DragGestureRecognizer}. This method first
+ * performs default deserialization for all non-{@code transient}
+ * fields. This object's {@code DragGestureListener} is then
* deserialized as well by using the next object in the stream.
*
* @since 1.4
@@ -437,30 +437,30 @@
*/
/**
- * The DragSource
+ * The {@code DragSource}
* associated with this
- * DragGestureRecognizer.
+ * {@code DragGestureRecognizer}.
*
* @serial
*/
protected DragSource dragSource;
/**
- * The Component
- * associated with this DragGestureRecognizer.
+ * The {@code Component}
+ * associated with this {@code DragGestureRecognizer}.
*
* @serial
*/
protected Component component;
/**
- * The DragGestureListener
- * associated with this DragGestureRecognizer.
+ * The {@code DragGestureListener}
+ * associated with this {@code DragGestureRecognizer}.
*/
protected transient DragGestureListener dragGestureListener;
/**
- * An int representing
+ * An {@code int} representing
* the type(s) of action(s) used
* in this Drag and Drop operation.
*
@@ -470,7 +470,7 @@
/**
* The list of events (in order) that
- * the DragGestureRecognizer
+ * the {@code DragGestureRecognizer}
* "recognized" as a "gesture" that triggers a drag.
*
* @serial
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSource.java 2015-10-04 22:53:14.773272753 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSource.java 2015-10-04 22:53:14.581272762 +0400
@@ -49,7 +49,7 @@
/**
- * The DragSource is the entity responsible
+ * The {@code DragSource} is the entity responsible
* for the initiation of the Drag
* and Drop operation, and may be used in a number of scenarios:
*
@@ -57,49 +57,49 @@
*
*
- * Once the Component, or application specific
- * object associated with a Component
+ * {@code Component}, or application specific
+ * object associated with a {@code Component}
* instance in the GUI. [implementation dependent]
* DragSource is
- * obtained, a DragGestureRecognizer should
- * also be obtained to associate the DragSource
+ * Once the {@code DragSource} is
+ * obtained, a {@code DragGestureRecognizer} should
+ * also be obtained to associate the {@code DragSource}
* with a particular
- * Component.
+ * {@code Component}.
* Component, which is usually
- * implemented by a DragGestureRecognizer.
+ * {@code Component}, which is usually
+ * implemented by a {@code DragGestureRecognizer}.
*DragSource's
+ * {@code DragSource}'s
* startDrag() method shall be
* invoked in order to cause processing
* of the user's navigational
* gestures and delivery of Drag and Drop
* protocol notifications. A
- * DragSource shall only
+ * {@code DragSource} shall only
* permit a single Drag and Drop operation to be
* current at any one time, and shall
* reject any further startDrag() requests
- * by throwing an IllegalDnDOperationException
+ * by throwing an {@code IllegalDnDOperationException}
* until such time as the extant operation is complete.
* DragSourceContext
- * and associate the DragSourceContextPeer
+ * {@code DragSourceContext}
+ * and associate the {@code DragSourceContextPeer}
* with that.
* java.awt.dnd.InvalidDnDOperationException
+ * a {@code java.awt.dnd.InvalidDnDOperationException}
* to signal such a condition. Typically this
* exception is thrown when the underlying platform
* system is either not in a state to
@@ -111,7 +111,7 @@
* until the operation is complete.
* The operation(s) are constant for the
* duration of the operation with respect to the
- * DragSource.
+ * {@code DragSource}.
*
* @since 1.2
*/
@@ -140,9 +140,9 @@
/**
- * The default Cursor to use with a copy operation indicating
- * that a drop is currently allowed. null if
- * GraphicsEnvironment.isHeadless() returns true.
+ * The default {@code Cursor} to use with a copy operation indicating
+ * that a drop is currently allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -150,9 +150,9 @@
load("DnD.Cursor.CopyDrop");
/**
- * The default Cursor to use with a move operation indicating
- * that a drop is currently allowed. null if
- * GraphicsEnvironment.isHeadless() returns true.
+ * The default {@code Cursor} to use with a move operation indicating
+ * that a drop is currently allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -160,9 +160,9 @@
load("DnD.Cursor.MoveDrop");
/**
- * The default Cursor to use with a link operation indicating
- * that a drop is currently allowed. null if
- * GraphicsEnvironment.isHeadless() returns true.
+ * The default {@code Cursor} to use with a link operation indicating
+ * that a drop is currently allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -170,9 +170,9 @@
load("DnD.Cursor.LinkDrop");
/**
- * The default Cursor to use with a copy operation indicating
- * that a drop is currently not allowed. null if
- * GraphicsEnvironment.isHeadless() returns true.
+ * The default {@code Cursor} to use with a copy operation indicating
+ * that a drop is currently not allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -180,9 +180,9 @@
load("DnD.Cursor.CopyNoDrop");
/**
- * The default Cursor to use with a move operation indicating
- * that a drop is currently not allowed. null if
- * GraphicsEnvironment.isHeadless() returns true.
+ * The default {@code Cursor} to use with a move operation indicating
+ * that a drop is currently not allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -190,9 +190,9 @@
load("DnD.Cursor.MoveNoDrop");
/**
- * The default Cursor to use with a link operation indicating
- * that a drop is currently not allowed. null if
- * GraphicsEnvironment.isHeadless() returns true.
+ * The default {@code Cursor} to use with a link operation indicating
+ * that a drop is currently not allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -209,7 +209,7 @@
static final String dragSourceMotionListenerK = "dragSourceMotionL";
/**
- * Gets the DragSource object associated with
+ * Gets the {@code DragSource} object associated with
* the underlying platform.
*
* @return the platform DragSource
@@ -228,7 +228,7 @@
/**
* Reports
* whether or not drag
- * Image support
+ * {@code Image} support
* is available on the underlying platform.
*
* @return if the Drag Image support is available on this platform
@@ -249,7 +249,7 @@
}
/**
- * Creates a new DragSource.
+ * Creates a new {@code DragSource}.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
@@ -262,28 +262,28 @@
}
/**
- * Start a drag, given the DragGestureEvent
+ * Start a drag, given the {@code DragGestureEvent}
* that initiated the drag, the initial
- * Cursor to use,
- * the Image to drag,
- * the offset of the Image origin
- * from the hotspot of the Cursor at
+ * {@code Cursor} to use,
+ * the {@code Image} to drag,
+ * the offset of the {@code Image} origin
+ * from the hotspot of the {@code Cursor} at
* the instant of the trigger,
- * the Transferable subject data
- * of the drag, the DragSourceListener,
- * and the FlavorMap.
+ * the {@code Transferable} subject data
+ * of the drag, the {@code DragSourceListener},
+ * and the {@code FlavorMap}.
*
- * @param trigger the DragGestureEvent that initiated the drag
+ * @param trigger the {@code DragGestureEvent} that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see DragSourceContext
* for more details on the cursor handling mechanism during drag and drop
* @param dragImage the image to drag or {@code null}
- * @param imageOffset the offset of the Image origin from the hotspot
- * of the Cursor at the instant of the trigger
+ * @param imageOffset the offset of the {@code Image} origin from the hotspot
+ * of the {@code Cursor} at the instant of the trigger
* @param transferable the subject data of the drag
- * @param dsl the DragSourceListener
- * @param flavorMap the FlavorMap to use, or null
+ * @param dsl the {@code DragSourceListener}
+ * @param flavorMap the {@code FlavorMap} to use, or {@code null}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
@@ -322,22 +322,22 @@
}
/**
- * Start a drag, given the DragGestureEvent
+ * Start a drag, given the {@code DragGestureEvent}
* that initiated the drag, the initial
- * Cursor to use,
- * the Transferable subject data
- * of the drag, the DragSourceListener,
- * and the FlavorMap.
+ * {@code Cursor} to use,
+ * the {@code Transferable} subject data
+ * of the drag, the {@code DragSourceListener},
+ * and the {@code FlavorMap}.
*
- * @param trigger the DragGestureEvent that
+ * @param trigger the {@code DragGestureEvent} that
* initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see DragSourceContext
* for more details on the cursor handling mechanism during drag and drop
* @param transferable the subject data of the drag
- * @param dsl the DragSourceListener
- * @param flavorMap the FlavorMap to use or null
+ * @param dsl the {@code DragSourceListener}
+ * @param flavorMap the {@code FlavorMap} to use or {@code null}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
@@ -355,26 +355,26 @@
}
/**
- * Start a drag, given the DragGestureEvent
- * that initiated the drag, the initial Cursor
+ * Start a drag, given the {@code DragGestureEvent}
+ * that initiated the drag, the initial {@code Cursor}
* to use,
- * the Image to drag,
- * the offset of the Image origin
- * from the hotspot of the Cursor
+ * the {@code Image} to drag,
+ * the offset of the {@code Image} origin
+ * from the hotspot of the {@code Cursor}
* at the instant of the trigger,
* the subject data of the drag, and
- * the DragSourceListener.
+ * the {@code DragSourceListener}.
*
- * @param trigger the DragGestureEvent that initiated the drag
+ * @param trigger the {@code DragGestureEvent} that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see DragSourceContext
* for more details on the cursor handling mechanism during drag and drop
- * @param dragImage the Image to drag or null
- * @param dragOffset the offset of the Image origin from the hotspot
- * of the Cursor at the instant of the trigger
+ * @param dragImage the {@code Image} to drag or {@code null}
+ * @param dragOffset the offset of the {@code Image} origin from the hotspot
+ * of the {@code Cursor} at the instant of the trigger
* @param transferable the subject data of the drag
- * @param dsl the DragSourceListener
+ * @param dsl the {@code DragSourceListener}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
@@ -393,20 +393,20 @@
}
/**
- * Start a drag, given the DragGestureEvent
+ * Start a drag, given the {@code DragGestureEvent}
* that initiated the drag, the initial
- * Cursor to
+ * {@code Cursor} to
* use,
- * the Transferable subject data
- * of the drag, and the DragSourceListener.
+ * the {@code Transferable} subject data
+ * of the drag, and the {@code DragSourceListener}.
*
- * @param trigger the DragGestureEvent that initiated the drag
+ * @param trigger the {@code DragGestureEvent} that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see DragSourceContext class
* for more details on the cursor handling mechanism during drag and drop
* @param transferable the subject data of the drag
- * @param dsl the DragSourceListener
+ * @param dsl the {@code DragSourceListener}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
@@ -426,46 +426,46 @@
* Creates the {@code DragSourceContext} to handle the current drag
* operation.
* DragSourceContext
- * subclass, subclass DragSource and
+ * To incorporate a new {@code DragSourceContext}
+ * subclass, subclass {@code DragSource} and
* override this method.
* dragImage is null, no image is used
+ * If {@code dragImage} is {@code null}, no image is used
* to represent the drag over feedback for this drag operation, but
- * NullPointerException is not thrown.
+ * {@code NullPointerException} is not thrown.
* dsl is null, no drag source listener
- * is registered with the created DragSourceContext,
- * but NullPointerException is not thrown.
+ * If {@code dsl} is {@code null}, no drag source listener
+ * is registered with the created {@code DragSourceContext},
+ * but {@code NullPointerException} is not thrown.
*
- * @param dgl The DragGestureEvent that triggered the
+ * @param dgl The {@code DragGestureEvent} that triggered the
* drag
* @param dragCursor The initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see DragSourceContext class
* for more details on the cursor handling mechanism during drag and drop
- * @param dragImage The Image to drag or null
- * @param imageOffset The offset of the Image origin from the
+ * @param dragImage The {@code Image} to drag or {@code null}
+ * @param imageOffset The offset of the {@code Image} origin from the
* hotspot of the cursor at the instant of the trigger
* @param t The subject data of the drag
- * @param dsl The DragSourceListener
+ * @param dsl The {@code DragSourceListener}
*
- * @return the DragSourceContext
+ * @return the {@code DragSourceContext}
*
- * @throws NullPointerException if dscp is null
- * @throws NullPointerException if dgl is null
- * @throws NullPointerException if dragImage is not
- * null and imageOffset is null
- * @throws NullPointerException if t is null
- * @throws IllegalArgumentException if the Component
- * associated with the trigger event is null.
- * @throws IllegalArgumentException if the DragSource for the
- * trigger event is null.
+ * @throws NullPointerException if {@code dscp} is {@code null}
+ * @throws NullPointerException if {@code dgl} is {@code null}
+ * @throws NullPointerException if {@code dragImage} is not
+ * {@code null} and {@code imageOffset} is {@code null}
+ * @throws NullPointerException if {@code t} is {@code null}
+ * @throws IllegalArgumentException if the {@code Component}
+ * associated with the trigger event is {@code null}.
+ * @throws IllegalArgumentException if the {@code DragSource} for the
+ * trigger event is {@code null}.
* @throws IllegalArgumentException if the drag action for the
- * trigger event is DnDConstants.ACTION_NONE.
+ * trigger event is {@code DnDConstants.ACTION_NONE}.
* @throws IllegalArgumentException if the source actions for the
- * DragGestureRecognizer associated with the trigger
- * event are equal to DnDConstants.ACTION_NONE.
+ * {@code DragGestureRecognizer} associated with the trigger
+ * event are equal to {@code DnDConstants.ACTION_NONE}.
*/
protected DragSourceContext createDragSourceContext(DragGestureEvent dgl,
@@ -479,33 +479,33 @@
/**
* This method returns the
- * FlavorMap for this DragSource.
+ * {@code FlavorMap} for this {@code DragSource}.
*
- * @return the FlavorMap for this DragSource
+ * @return the {@code FlavorMap} for this {@code DragSource}
*/
public FlavorMap getFlavorMap() { return flavorMap; }
/**
- * Creates a new DragGestureRecognizer
+ * Creates a new {@code DragGestureRecognizer}
* that implements the specified
* abstract subclass of
- * DragGestureRecognizer, and
- * sets the specified Component
- * and DragGestureListener on
+ * {@code DragGestureRecognizer}, and
+ * sets the specified {@code Component}
+ * and {@code DragGestureListener} on
* the newly created object.
*
* @param Component target
- * @param dgl the DragGestureListener to notify
+ * @param c the {@code Component} target
+ * @param dgl the {@code DragGestureListener} to notify
*
- * @return the new DragGestureRecognizer or null
- * if the Toolkit.createDragGestureRecognizer method
+ * @return the new {@code DragGestureRecognizer} or {@code null}
+ * if the {@code Toolkit.createDragGestureRecognizer} method
* has no implementation available for
- * the requested DragGestureRecognizer
- * subclass and returns null
+ * the requested {@code DragGestureRecognizer}
+ * subclass and returns {@code null}
*/
public DragGestureRecognizer
+ * Creates a new {@code DragGestureRecognizer}
* that implements the default
- * abstract subclass of DragGestureRecognizer
- * for this DragSource,
- * and sets the specified Component
- * and DragGestureListener on the
+ * abstract subclass of {@code DragGestureRecognizer}
+ * for this {@code DragSource},
+ * and sets the specified {@code Component}
+ * and {@code DragGestureListener} on the
* newly created object.
*
- * For this DragSource
- * the default is MouseDragGestureRecognizer.
+ * For this {@code DragSource}
+ * the default is {@code MouseDragGestureRecognizer}.
*
- * @param c the Component target for the recognizer
+ * @param c the {@code Component} target for the recognizer
* @param actions the permitted source actions
- * @param dgl the DragGestureListener to notify
+ * @param dgl the {@code DragGestureListener} to notify
*
- * @return the new DragGestureRecognizer or null
- * if the Toolkit.createDragGestureRecognizer method
+ * @return the new {@code DragGestureRecognizer} or {@code null}
+ * if the {@code Toolkit.createDragGestureRecognizer} method
* has no implementation available for
- * the requested DragGestureRecognizer
- * subclass and returns null
+ * the requested {@code DragGestureRecognizer}
+ * subclass and returns {@code null}
*/
public DragGestureRecognizer createDefaultDragGestureRecognizer(Component c, int actions, DragGestureListener dgl) {
@@ -545,13 +545,13 @@
}
/**
- * Adds the specified DragSourceListener to this
- * DragSource to receive drag source events during drag
- * operations initiated with this DragSource.
- * If a null listener is specified, no action is taken and no
+ * Adds the specified {@code DragSourceListener} to this
+ * {@code DragSource} to receive drag source events during drag
+ * operations initiated with this {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
*
- * @param dsl the DragSourceListener to add
+ * @param dsl the {@code DragSourceListener} to add
*
* @see #removeDragSourceListener
* @see #getDragSourceListeners
@@ -566,15 +566,15 @@
}
/**
- * Removes the specified DragSourceListener from this
- * DragSource.
- * If a null listener is specified, no action is taken and no
+ * Removes the specified {@code DragSourceListener} from this
+ * {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
* If the listener specified by the argument was not previously added to
- * this DragSource, no action is taken and no exception
+ * this {@code DragSource}, no action is taken and no exception
* is thrown.
*
- * @param dsl the DragSourceListener to remove
+ * @param dsl the {@code DragSourceListener} to remove
*
* @see #addDragSourceListener
* @see #getDragSourceListeners
@@ -589,11 +589,11 @@
}
/**
- * Gets all the DragSourceListeners
- * registered with this DragSource.
+ * Gets all the {@code DragSourceListener}s
+ * registered with this {@code DragSource}.
*
- * @return all of this DragSource's
- * DragSourceListeners or an empty array if no
+ * @return all of this {@code DragSource}'s
+ * {@code DragSourceListener}s or an empty array if no
* such listeners are currently registered
*
* @see #addDragSourceListener
@@ -605,13 +605,13 @@
}
/**
- * Adds the specified DragSourceMotionListener to this
- * DragSource to receive drag motion events during drag
- * operations initiated with this DragSource.
- * If a null listener is specified, no action is taken and no
+ * Adds the specified {@code DragSourceMotionListener} to this
+ * {@code DragSource} to receive drag motion events during drag
+ * operations initiated with this {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
*
- * @param dsml the DragSourceMotionListener to add
+ * @param dsml the {@code DragSourceMotionListener} to add
*
* @see #removeDragSourceMotionListener
* @see #getDragSourceMotionListeners
@@ -626,15 +626,15 @@
}
/**
- * Removes the specified DragSourceMotionListener from this
- * DragSource.
- * If a null listener is specified, no action is taken and no
+ * Removes the specified {@code DragSourceMotionListener} from this
+ * {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
* If the listener specified by the argument was not previously added to
- * this DragSource, no action is taken and no exception
+ * this {@code DragSource}, no action is taken and no exception
* is thrown.
*
- * @param dsml the DragSourceMotionListener to remove
+ * @param dsml the {@code DragSourceMotionListener} to remove
*
* @see #addDragSourceMotionListener
* @see #getDragSourceMotionListeners
@@ -649,11 +649,11 @@
}
/**
- * Gets all of the DragSourceMotionListeners
- * registered with this DragSource.
+ * Gets all of the {@code DragSourceMotionListener}s
+ * registered with this {@code DragSource}.
*
- * @return all of this DragSource's
- * DragSourceMotionListeners or an empty array if no
+ * @return all of this {@code DragSource}'s
+ * {@code DragSourceMotionListener}s or an empty array if no
* such listeners are currently registered
*
* @see #addDragSourceMotionListener
@@ -666,21 +666,21 @@
/**
* Gets all the objects currently registered as
- * FooListeners upon this DragSource.
+ * FooListeners upon this {@code DragSource}.
* FooListeners are registered using the
* addFooListener method.
*
* @param java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this
- * DragSource, or an empty array if no such listeners
+ * {@code DragSource}, or an empty array if no such listeners
* have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getDragSourceListeners
* @see #getDragSourceMotionListeners
@@ -697,12 +697,12 @@
}
/**
- * This method calls dragEnter on the
- * DragSourceListeners registered with this
- * DragSource, and passes them the specified
- * DragSourceDragEvent.
+ * This method calls {@code dragEnter} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
void processDragEnter(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
@@ -712,12 +712,12 @@
}
/**
- * This method calls dragOver on the
- * DragSourceListeners registered with this
- * DragSource, and passes them the specified
- * DragSourceDragEvent.
+ * This method calls {@code dragOver} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
void processDragOver(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
@@ -727,12 +727,12 @@
}
/**
- * This method calls dropActionChanged on the
- * DragSourceListeners registered with this
- * DragSource, and passes them the specified
- * DragSourceDragEvent.
+ * This method calls {@code dropActionChanged} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
void processDropActionChanged(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
@@ -742,12 +742,12 @@
}
/**
- * This method calls dragExit on the
- * DragSourceListeners registered with this
- * DragSource, and passes them the specified
- * DragSourceEvent.
+ * This method calls {@code dragExit} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceEvent}.
*
- * @param dse the DragSourceEvent
+ * @param dse the {@code DragSourceEvent}
*/
void processDragExit(DragSourceEvent dse) {
DragSourceListener dsl = listener;
@@ -757,12 +757,12 @@
}
/**
- * This method calls dragDropEnd on the
- * DragSourceListeners registered with this
- * DragSource, and passes them the specified
- * DragSourceDropEvent.
+ * This method calls {@code dragDropEnd} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDropEvent}.
*
- * @param dsde the DragSourceEvent
+ * @param dsde the {@code DragSourceEvent}
*/
void processDragDropEnd(DragSourceDropEvent dsde) {
DragSourceListener dsl = listener;
@@ -772,12 +772,12 @@
}
/**
- * This method calls dragMouseMoved on the
- * DragSourceMotionListeners registered with this
- * DragSource, and passes them the specified
- * DragSourceDragEvent.
+ * This method calls {@code dragMouseMoved} on the
+ * {@code DragSourceMotionListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceEvent
+ * @param dsde the {@code DragSourceEvent}
*/
void processDragMouseMoved(DragSourceDragEvent dsde) {
DragSourceMotionListener dsml = motionListener;
@@ -787,33 +787,33 @@
}
/**
- * Serializes this DragSource. This method first performs
+ * Serializes this {@code DragSource}. This method first performs
* default serialization. Next, it writes out this object's
- * FlavorMap if and only if it can be serialized. If not,
- * null is written instead. Next, it writes out
- * Serializable listeners registered with this
- * object. Listeners are written in a null-terminated sequence
- * of 0 or more pairs. The pair consists of a String and an
- * Object; the String indicates the type of the
- * Object and is one of the following:
+ * {@code FlavorMap} if and only if it can be serialized. If not,
+ * {@code null} is written instead. Next, it writes out
+ * {@code Serializable} listeners registered with this
+ * object. Listeners are written in a {@code null}-terminated sequence
+ * of 0 or more pairs. The pair consists of a {@code String} and an
+ * {@code Object}; the {@code String} indicates the type of the
+ * {@code Object} and is one of the following:
*
- *
*
- * @serialData Either a dragSourceListenerK indicating a
- * DragSourceListener object;
- * dragSourceMotionListenerK indicating a
- * DragSourceMotionListener object.
+ * FlavorMap instance, or
- * null, followed by a null-terminated
+ * @serialData Either a {@code FlavorMap} instance, or
+ * {@code null}, followed by a {@code null}-terminated
* sequence of 0 or more pairs; the pair consists of a
- * String and an Object; the
- * String indicates the type of the Object
+ * {@code String} and an {@code Object}; the
+ * {@code String} indicates the type of the {@code Object}
* and is one of the following:
*
- *
.
* @since 1.4
*/
@@ -828,24 +828,24 @@
}
/**
- * Deserializes this dragSourceListenerK indicating a
- * DragSourceListener object;
- * dragSourceMotionListenerK indicating a
- * DragSourceMotionListener object.
+ * DragSource. This method first performs
- * default deserialization. Next, this object's FlavorMap is
+ * Deserializes this {@code DragSource}. This method first performs
+ * default deserialization. Next, this object's {@code FlavorMap} is
* deserialized by using the next object in the stream.
- * If the resulting FlavorMap is null, this
- * object's FlavorMap is set to the default FlavorMap for
- * this thread's ClassLoader.
+ * If the resulting {@code FlavorMap} is {@code null}, this
+ * object's {@code FlavorMap} is set to the default FlavorMap for
+ * this thread's {@code ClassLoader}.
* Next, this object's listeners are deserialized by reading a
- * null-terminated sequence of 0 or more key/value pairs
+ * {@code null}-terminated sequence of 0 or more key/value pairs
* from the stream:
*
- *
*
@@ -884,13 +884,13 @@
* Returns the drag gesture motion threshold. The drag gesture motion threshold
* defines the recommended behavior for {@link MouseDragGestureRecognizer}s.
* String equal to
- * dragSourceListenerK, a DragSourceListener is
+ * DragSource.
- * String equal to
- * dragSourceMotionListenerK, a
- * DragSourceMotionListener is deserialized using the
- * corresponding value object and added to this DragSource.
+ * {@code DragSource}.
+ * awt.dnd.drag.threshold is set to
+ * If the system property {@code awt.dnd.drag.threshold} is set to
* a positive integer, this method returns the value of the system property;
* otherwise if a pertinent desktop property is available and supported by
* the implementation of the Java platform, this method returns the value of
* that property; otherwise this method returns some default value.
* The pertinent desktop property can be queried using
- * java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold").
+ * {@code java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold")}.
*
* @return the drag gesture motion threshold
* @see MouseDragGestureRecognizer
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSourceAdapter.java 2015-10-04 22:53:15.325272728 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceAdapter.java 2015-10-04 22:53:15.133272737 +0400
@@ -30,22 +30,22 @@
* this class are empty. This class exists only as a convenience for creating
* listener objects.
* DragSourceEvent listener
+ * Extend this class to create a {@code DragSourceEvent} listener
* and override the methods for the events of interest. (If you implement the
- * DragSourceListener interface, you have to define all of
+ * {@code DragSourceListener} interface, you have to define all of
* the methods in it. This abstract class defines null methods for them
* all, so you only have to define methods for events you care about.)
* DragSource. When the drag enters, moves over, or exits
+ * a {@code DragSource}. When the drag enters, moves over, or exits
* a drop site, when the drop action changes, and when the drag ends, the
* relevant method in the listener object is invoked, and the
- * DragSourceEvent is passed to it.
+ * {@code DragSourceEvent} is passed to it.
* dragEnter()
- * invocation if the latest invocation of dragEnter() on this
+ * The drop site is associated with the previous {@code dragEnter()}
+ * invocation if the latest invocation of {@code dragEnter()} on this
* adapter corresponds to that drop site and is not followed by a
- * dragExit() invocation on this adapter.
+ * {@code dragExit()} invocation on this adapter.
*
* @see DragSourceEvent
* @see DragSourceListener
@@ -67,7 +67,7 @@
* DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragEnter(DragSourceDragEvent dsde) {}
@@ -82,14 +82,14 @@
* DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragOver(DragSourceDragEvent dsde) {}
/**
* Called whenever the mouse is moved during a drag operation.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragMouseMoved(DragSourceDragEvent dsde) {}
@@ -100,7 +100,7 @@
* Such devices are typically the mouse buttons or keyboard
* modifiers that the user is interacting with.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dropActionChanged(DragSourceDragEvent dsde) {}
@@ -122,21 +122,21 @@
* has rejected the drag.
*
*
- * @param dse the DragSourceEvent
+ * @param dse the {@code DragSourceEvent}
*/
public void dragExit(DragSourceEvent dse) {}
/**
* This method is invoked to signify that the Drag and Drop
* operation is complete. The getDropSuccess() method of
- * the DragSourceDropEvent can be used to
+ * the {@code DragSourceDropEvent} can be used to
* determine the termination state. The getDropAction() method
* returns the operation that the drop site selected
* to apply to the Drop operation. Once this method is complete, the
- * current DragSourceContext and
+ * current {@code DragSourceContext} and
* associated resources become invalid.
*
- * @param dsde the DragSourceDropEvent
+ * @param dsde the {@code DragSourceDropEvent}
*/
public void dragDropEnd(DragSourceDropEvent dsde) {}
}
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSourceContext.java 2015-10-04 22:53:15.853272705 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceContext.java 2015-10-04 22:53:15.661272713 +0400
@@ -46,22 +46,22 @@
import sun.awt.ComponentFactory;
/**
- * The DragSourceContext class is responsible for managing the
+ * The {@code DragSourceContext} class is responsible for managing the
* initiator side of the Drag and Drop protocol. In particular, it is responsible
* for managing drag event notifications to the
* {@linkplain DragSourceListener DragSourceListeners}
* and {@linkplain DragSourceMotionListener DragSourceMotionListeners}, and providing the
* {@link Transferable} representing the source data for the drag operation.
* DragSourceContext itself
- * implements the DragSourceListener and
- * DragSourceMotionListener interfaces.
+ * Note that the {@code DragSourceContext} itself
+ * implements the {@code DragSourceListener} and
+ * {@code DragSourceMotionListener} interfaces.
* This is to allow the platform peer
* (the {@link DragSourceContextPeer} instance)
* created by the {@link DragSource} to notify
- * the DragSourceContext of
+ * the {@code DragSourceContext} of
* state changes in the ongoing operation. This allows the
- * DragSourceContext object to interpose
+ * {@code DragSourceContext} object to interpose
* itself between the platform and the
* listeners provided by the initiator of the drag operation.
* int used by updateCurrentCursor()
- * indicating that the Cursor should change
- * to the default (no drop) Cursor.
+ * An {@code int} used by updateCurrentCursor()
+ * indicating that the {@code Cursor} should change
+ * to the default (no drop) {@code Cursor}.
*/
protected static final int DEFAULT = 0;
/**
- * An int used by updateCurrentCursor()
- * indicating that the Cursor
- * has entered a DropTarget.
+ * An {@code int} used by updateCurrentCursor()
+ * indicating that the {@code Cursor}
+ * has entered a {@code DropTarget}.
*/
protected static final int ENTER = 1;
/**
- * An int used by updateCurrentCursor()
- * indicating that the Cursor is
- * over a DropTarget.
+ * An {@code int} used by updateCurrentCursor()
+ * indicating that the {@code Cursor} is
+ * over a {@code DropTarget}.
*/
protected static final int OVER = 2;
/**
- * An int used by updateCurrentCursor()
+ * An {@code int} used by updateCurrentCursor()
* indicating that the user operation has changed.
*/
@@ -129,35 +129,35 @@
}
/**
- * Called from DragSource, this constructor creates a new
- * DragSourceContext given the
- * DragSourceContextPeer for this Drag, the
- * DragGestureEvent that triggered the Drag, the initial
- * Cursor to use for the Drag, an (optional)
- * Image to display while the Drag is taking place, the offset
- * of the Image origin from the hotspot at the instant of the
- * triggering event, the Transferable subject data, and the
- * DragSourceListener to use during the Drag and Drop
+ * Called from {@code DragSource}, this constructor creates a new
+ * {@code DragSourceContext} given the
+ * {@code DragSourceContextPeer} for this Drag, the
+ * {@code DragGestureEvent} that triggered the Drag, the initial
+ * {@code Cursor} to use for the Drag, an (optional)
+ * {@code Image} to display while the Drag is taking place, the offset
+ * of the {@code Image} origin from the hotspot at the instant of the
+ * triggering event, the {@code Transferable} subject data, and the
+ * {@code DragSourceListener} to use during the Drag and Drop
* operation.
*
- * If DragSourceContextPeer is null
- * NullPointerException is thrown.
+ * If {@code DragSourceContextPeer} is {@code null}
+ * {@code NullPointerException} is thrown.
*
- * If DragGestureEvent is null
- * NullPointerException is thrown.
+ * If {@code DragGestureEvent} is {@code null}
+ * {@code NullPointerException} is thrown.
*
- * If Cursor is null no exception is thrown and
+ * If {@code Cursor} is {@code null} no exception is thrown and
* the default drag cursor behavior is activated for this drag operation.
*
- * If Image is null no exception is thrown.
+ * If {@code Image} is {@code null} no exception is thrown.
*
- * If Image is not null and the offset is
- * null NullPointerException is thrown.
+ * If {@code Image} is not {@code null} and the offset is
+ * {@code null NullPointerException} is thrown.
*
- * If Transferable is null
- * NullPointerException is thrown.
+ * If {@code Transferable} is {@code null}
+ * {@code NullPointerException} is thrown.
*
- * If DragSourceListener is null no exception
+ * If {@code DragSourceListener} is {@code null} no exception
* is thrown.
*
* @param trigger the triggering event
@@ -165,21 +165,21 @@
* or {@code null} for the default cursor handling;
* see class level documentation
* for more details on the cursor handling mechanism during drag and drop
- * @param dragImage the Image to drag (or null)
+ * @param dragImage the {@code Image} to drag (or {@code null})
* @param offset the offset of the image origin from the hotspot at the
* instant of the triggering event
- * @param t the Transferable
- * @param dsl the DragSourceListener
+ * @param t the {@code Transferable}
+ * @param dsl the {@code DragSourceListener}
*
- * @throws IllegalArgumentException if the Component associated
- * with the trigger event is null.
- * @throws IllegalArgumentException if the DragSource for the
- * trigger event is null.
+ * @throws IllegalArgumentException if the {@code Component} associated
+ * with the trigger event is {@code null}.
+ * @throws IllegalArgumentException if the {@code DragSource} for the
+ * trigger event is {@code null}.
* @throws IllegalArgumentException if the drag action for the
- * trigger event is DnDConstants.ACTION_NONE.
+ * trigger event is {@code DnDConstants.ACTION_NONE}.
* @throws IllegalArgumentException if the source actions for the
- * DragGestureRecognizer associated with the trigger
- * event are equal to DnDConstants.ACTION_NONE.
+ * {@code DragGestureRecognizer} associated with the trigger
+ * event are equal to {@code DnDConstants.ACTION_NONE}.
* @throws NullPointerException if dscp, trigger, or t are null, or
* if dragImage is non-null and offset is null
*/
@@ -240,26 +240,26 @@
}
/**
- * Returns the DragSource
- * that instantiated this DragSourceContext.
+ * Returns the {@code DragSource}
+ * that instantiated this {@code DragSourceContext}.
*
- * @return the DragSource that
- * instantiated this DragSourceContext
+ * @return the {@code DragSource} that
+ * instantiated this {@code DragSourceContext}
*/
public DragSource getDragSource() { return trigger.getDragSource(); }
/**
- * Returns the Component associated with this
- * DragSourceContext.
+ * Returns the {@code Component} associated with this
+ * {@code DragSourceContext}.
*
- * @return the Component that started the drag
+ * @return the {@code Component} that started the drag
*/
public Component getComponent() { return trigger.getComponent(); }
/**
- * Returns the DragGestureEvent
+ * Returns the {@code DragGestureEvent}
* that initially triggered the drag.
*
* @return the Event that triggered the drag
@@ -268,9 +268,9 @@
public DragGestureEvent getTrigger() { return trigger; }
/**
- * Returns a bitwise mask of DnDConstants that
+ * Returns a bitwise mask of {@code DnDConstants} that
* represent the set of drop actions supported by the drag source for the
- * drag operation associated with this DragSourceContext.
+ * drag operation associated with this {@code DragSourceContext}.
*
* @return the drop actions supported by the drag source
*/
@@ -280,8 +280,8 @@
/**
* Sets the cursor for this drag operation to the specified
- * Cursor. If the specified Cursor
- * is null, the default drag cursor behavior is
+ * {@code Cursor}. If the specified {@code Cursor}
+ * is {@code null}, the default drag cursor behavior is
* activated for this drag operation, otherwise it is deactivated.
*
* @param c the initial {@code Cursor} for this drag operation,
@@ -298,25 +298,25 @@
}
/**
- * Returns the current drag Cursor.
+ * Returns the current drag {@code Cursor}.
*
- * @return the current drag Cursor
+ * @return the current drag {@code Cursor}
*/
public Cursor getCursor() { return cursor; }
/**
- * Add a DragSourceListener to this
- * DragSourceContext if one has not already been added.
- * If a DragSourceListener already exists,
- * this method throws a TooManyListenersException.
+ * Add a {@code DragSourceListener} to this
+ * {@code DragSourceContext} if one has not already been added.
+ * If a {@code DragSourceListener} already exists,
+ * this method throws a {@code TooManyListenersException}.
*
- * @param dsl the DragSourceListener to add.
- * Note that while null is not prohibited,
+ * @param dsl the {@code DragSourceListener} to add.
+ * Note that while {@code null} is not prohibited,
* it is not acceptable as a parameter.
*
* @throws TooManyListenersException if
- * a DragSourceListener has already been added
+ * a {@code DragSourceListener} has already been added
*/
public synchronized void addDragSourceListener(DragSourceListener dsl) throws TooManyListenersException {
@@ -331,11 +331,11 @@
}
/**
- * Removes the specified DragSourceListener
- * from this DragSourceContext.
+ * Removes the specified {@code DragSourceListener}
+ * from this {@code DragSourceContext}.
*
- * @param dsl the DragSourceListener to remove;
- * note that while null is not prohibited,
+ * @param dsl the {@code DragSourceListener} to remove;
+ * note that while {@code null} is not prohibited,
* it is not acceptable as a parameter
*/
@@ -347,8 +347,8 @@
}
/**
- * Notifies the peer that the Transferable's
- * DataFlavors have changed.
+ * Notifies the peer that the {@code Transferable}'s
+ * {@code DataFlavor}s have changed.
*/
public void transferablesFlavorsChanged() {
@@ -356,13 +356,13 @@
}
/**
- * Calls dragEnter on the
- * DragSourceListeners registered with this
- * DragSourceContext and with the associated
- * DragSource, and passes them the specified
- * DragSourceDragEvent.
+ * Calls {@code dragEnter} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSourceContext} and with the associated
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragEnter(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
@@ -375,13 +375,13 @@
}
/**
- * Calls dragOver on the
- * DragSourceListeners registered with this
- * DragSourceContext and with the associated
- * DragSource, and passes them the specified
- * DragSourceDragEvent.
+ * Calls {@code dragOver} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSourceContext} and with the associated
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dragOver(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
@@ -394,13 +394,13 @@
}
/**
- * Calls dragExit on the
- * DragSourceListeners registered with this
- * DragSourceContext and with the associated
- * DragSource, and passes them the specified
- * DragSourceEvent.
+ * Calls {@code dragExit} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSourceContext} and with the associated
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceEvent}.
*
- * @param dse the DragSourceEvent
+ * @param dse the {@code DragSourceEvent}
*/
public void dragExit(DragSourceEvent dse) {
DragSourceListener dsl = listener;
@@ -413,13 +413,13 @@
}
/**
- * Calls dropActionChanged on the
- * DragSourceListeners registered with this
- * DragSourceContext and with the associated
- * DragSource, and passes them the specified
- * DragSourceDragEvent.
+ * Calls {@code dropActionChanged} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSourceContext} and with the associated
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
public void dropActionChanged(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
@@ -432,13 +432,13 @@
}
/**
- * Calls dragDropEnd on the
- * DragSourceListeners registered with this
- * DragSourceContext and with the associated
- * DragSource, and passes them the specified
- * DragSourceDropEvent.
+ * Calls {@code dragDropEnd} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSourceContext} and with the associated
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDropEvent}.
*
- * @param dsde the DragSourceDropEvent
+ * @param dsde the {@code DragSourceDropEvent}
*/
public void dragDropEnd(DragSourceDropEvent dsde) {
DragSourceListener dsl = listener;
@@ -449,13 +449,13 @@
}
/**
- * Calls dragMouseMoved on the
- * DragSourceMotionListeners registered with the
- * DragSource associated with this
- * DragSourceContext, and them passes the specified
- * DragSourceDragEvent.
+ * Calls {@code dragMouseMoved} on the
+ * {@code DragSourceMotionListener}s registered with the
+ * {@code DragSource} associated with this
+ * {@code DragSourceContext}, and them passes the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
* @since 1.4
*/
public void dragMouseMoved(DragSourceDragEvent dsde) {
@@ -463,10 +463,10 @@
}
/**
- * Returns the Transferable associated with
- * this DragSourceContext.
+ * Returns the {@code Transferable} associated with
+ * this {@code DragSourceContext}.
*
- * @return the Transferable
+ * @return the {@code Transferable}
*/
public Transferable getTransferable() { return transferable; }
@@ -478,9 +478,9 @@
*
* @param sourceAct the actions supported by the drag source
* @param targetAct the drop target action
- * @param status one of the fields DEFAULT,
- * ENTER, OVER,
- * CHANGED
+ * @param status one of the fields {@code DEFAULT},
+ * {@code ENTER}, {@code OVER},
+ * {@code CHANGED}
*/
@SuppressWarnings("fallthrough")
protected synchronized void updateCurrentCursor(int sourceAct, int targetAct, int status) {
@@ -532,21 +532,21 @@
}
/**
- * Serializes this DragSourceContext. This method first
+ * Serializes this {@code DragSourceContext}. This method first
* performs default serialization. Next, this object's
- * Transferable is written out if and only if it can be
- * serialized. If not, null is written instead. In this case,
- * a DragSourceContext created from the resulting deserialized
- * stream will contain a dummy Transferable which supports no
- * DataFlavors. Finally, this object's
- * DragSourceListener is written out if and only if it can be
- * serialized. If not, null is written instead.
+ * {@code Transferable} is written out if and only if it can be
+ * serialized. If not, {@code null} is written instead. In this case,
+ * a {@code DragSourceContext} created from the resulting deserialized
+ * stream will contain a dummy {@code Transferable} which supports no
+ * {@code DataFlavor}s. Finally, this object's
+ * {@code DragSourceListener} is written out if and only if it can be
+ * serialized. If not, {@code null} is written instead.
*
* @serialData The default serializable fields, in alphabetical order,
- * followed by either a Transferable instance, or
- * null, followed by either a
- * DragSourceListener instance, or
- * null.
+ * followed by either a {@code Transferable} instance, or
+ * {@code null}, followed by either a
+ * {@code DragSourceListener} instance, or
+ * {@code null}.
* @since 1.4
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -559,14 +559,14 @@
}
/**
- * Deserializes this DragSourceContext. This method first
- * performs default deserialization for all non-transient
- * fields. This object's Transferable and
- * DragSourceListener are then deserialized as well by using
+ * Deserializes this {@code DragSourceContext}. This method first
+ * performs default deserialization for all non-{@code transient}
+ * fields. This object's {@code Transferable} and
+ * {@code DragSourceListener} are then deserialized as well by using
* the next two objects in the stream. If the resulting
- * Transferable is null, this object's
- * Transferable is set to a dummy Transferable
- * which supports no DataFlavors.
+ * {@code Transferable} is {@code null}, this object's
+ * {@code Transferable} is set to a dummy {@code Transferable}
+ * which supports no {@code DataFlavor}s.
*
* @since 1.4
*/
@@ -654,7 +654,7 @@
private transient DragSourceListener listener;
/**
- * true if the custom drag cursor is used instead of the
+ * {@code true} if the custom drag cursor is used instead of the
* default one.
*
* @serial
@@ -662,9 +662,9 @@
private boolean useCustomCursor;
/**
- * A bitwise mask of DnDConstants that represents the set of
+ * A bitwise mask of {@code DnDConstants} that represents the set of
* drop actions supported by the drag source for the drag operation associated
- * with this DragSourceContext.
+ * with this {@code DragSourceContext.}
*
* @serial
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSourceDragEvent.java 2015-10-04 22:53:16.389272681 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceDragEvent.java 2015-10-04 22:53:16.201272689 +0400
@@ -28,19 +28,19 @@
import java.awt.event.InputEvent;
/**
- * The DragSourceDragEvent is
- * delivered from the DragSourceContextPeer,
- * via the DragSourceContext, to the DragSourceListener
- * registered with that DragSourceContext and with its associated
- * DragSource.
+ * The {@code DragSourceDragEvent} is
+ * delivered from the {@code DragSourceContextPeer},
+ * via the {@code DragSourceContext}, to the {@code DragSourceListener}
+ * registered with that {@code DragSourceContext} and with its associated
+ * {@code DragSource}.
* DragSourceDragEvent reports the target drop action
+ * The {@code DragSourceDragEvent} reports the target drop action
* and the user drop action that reflect the current state of
* the drag operation.
* DnDConstants that represents
+ * Target drop action is one of {@code DnDConstants} that represents
* the drop action selected by the current drop target if this drop action is
- * supported by the drag source or DnDConstants.ACTION_NONE if this
+ * supported by the drag source or {@code DnDConstants.ACTION_NONE} if this
* drop action is not supported by the drag source.
* DnDConstants that represents the selected drop action if this
+ * {@code DnDConstants} that represents the selected drop action if this
* drop action is supported by the drag source or
- * DnDConstants.ACTION_NONE if this drop action is not supported
+ * {@code DnDConstants.ACTION_NONE} if this drop action is not supported
* by the drag source.
* DnDConstants that represents the set of drop actions supported
- * by the drag source is searched for DnDConstants.ACTION_MOVE,
- * then for DnDConstants.ACTION_COPY, then for
- * DnDConstants.ACTION_LINK and the user drop action is the
+ * {@code DnDConstants} that represents the set of drop actions supported
+ * by the drag source is searched for {@code DnDConstants.ACTION_MOVE},
+ * then for {@code DnDConstants.ACTION_COPY}, then for
+ * {@code DnDConstants.ACTION_LINK} and the user drop action is the
* first constant found. If no constant is found the user drop action
- * is DnDConstants.ACTION_NONE.
+ * is {@code DnDConstants.ACTION_NONE}.
*
* @since 1.2
*
@@ -74,25 +74,25 @@
private static final long serialVersionUID = 481346297933902471L;
/**
- * Constructs a DragSourceDragEvent.
+ * Constructs a {@code DragSourceDragEvent}.
* This class is typically
- * instantiated by the DragSourceContextPeer
+ * instantiated by the {@code DragSourceContextPeer}
* rather than directly
* by client code.
- * The coordinates for this DragSourceDragEvent
- * are not specified, so getLocation will return
- * null for this event.
+ * The coordinates for this {@code DragSourceDragEvent}
+ * are not specified, so {@code getLocation} will return
+ * {@code null} for this event.
* dropAction and action should
- * be one of DnDConstants that represents a single action.
- * The argument modifiers should be either a bitwise mask
- * of old java.awt.event.InputEvent.*_MASK constants or a
- * bitwise mask of extended java.awt.event.InputEvent.*_DOWN_MASK
+ * The arguments {@code dropAction} and {@code action} should
+ * be one of {@code DnDConstants} that represents a single action.
+ * The argument {@code modifiers} should be either a bitwise mask
+ * of old {@code java.awt.event.InputEvent.*_MASK} constants or a
+ * bitwise mask of extended {@code java.awt.event.InputEvent.*_DOWN_MASK}
* constants.
- * This constructor does not throw any exception for invalid dropAction,
- * action and modifiers.
+ * This constructor does not throw any exception for invalid {@code dropAction},
+ * {@code action} and {@code modifiers}.
*
- * @param dsc the DragSourceContext that is to manage
+ * @param dsc the {@code DragSourceContext} that is to manage
* notifications for this event.
* @param dropAction the user drop action.
* @param action the target drop action.
@@ -103,7 +103,7 @@
* in one event. Use of the extended modifiers is
* preferred.
*
- * @throws IllegalArgumentException if dsc is null.
+ * @throws IllegalArgumentException if {@code dsc} is {@code null}.
*
* @see java.awt.event.InputEvent
* @see DragSourceEvent#getLocation
@@ -128,20 +128,20 @@
}
/**
- * Constructs a DragSourceDragEvent given the specified
- * DragSourceContext, user drop action, target drop action,
+ * Constructs a {@code DragSourceDragEvent} given the specified
+ * {@code DragSourceContext}, user drop action, target drop action,
* modifiers and coordinates.
* dropAction and action should
- * be one of DnDConstants that represents a single action.
- * The argument modifiers should be either a bitwise mask
- * of old java.awt.event.InputEvent.*_MASK constants or a
- * bitwise mask of extended java.awt.event.InputEvent.*_DOWN_MASK
+ * The arguments {@code dropAction} and {@code action} should
+ * be one of {@code DnDConstants} that represents a single action.
+ * The argument {@code modifiers} should be either a bitwise mask
+ * of old {@code java.awt.event.InputEvent.*_MASK} constants or a
+ * bitwise mask of extended {@code java.awt.event.InputEvent.*_DOWN_MASK}
* constants.
- * This constructor does not throw any exception for invalid dropAction,
- * action and modifiers.
+ * This constructor does not throw any exception for invalid {@code dropAction},
+ * {@code action} and {@code modifiers}.
*
- * @param dsc the DragSourceContext associated with this
+ * @param dsc the {@code DragSourceContext} associated with this
* event.
* @param dropAction the user drop action.
* @param action the target drop action.
@@ -154,7 +154,7 @@
* @param x the horizontal coordinate for the cursor location
* @param y the vertical coordinate for the cursor location
*
- * @throws IllegalArgumentException if dsc is null.
+ * @throws IllegalArgumentException if {@code dsc} is {@code null}.
*
* @see java.awt.event.InputEvent
* @since 1.4
@@ -192,12 +192,12 @@
((InputEvent.ALT_GRAPH_DOWN_MASK << 1) - 1) & ~JDK_1_3_MODIFIERS;
/**
- * This method returns an int representing
+ * This method returns an {@code int} representing
* the current state of the input device modifiers
* associated with the user's gesture. Typically these
* would be mouse buttons or keyboard modifiers.
* modifiers passed to the constructor
+ * If the {@code modifiers} passed to the constructor
* are invalid, this method returns them unchanged.
*
* @return the current state of the input device modifiers
@@ -208,12 +208,12 @@
}
/**
- * This method returns an int representing
+ * This method returns an {@code int} representing
* the current state of the input device extended modifiers
* associated with the user's gesture.
* See {@link InputEvent#getModifiersEx}
* modifiers passed to the constructor
+ * If the {@code modifiers} passed to the constructor
* are invalid, this method returns them unchanged.
*
* @return the current state of the input device extended modifiers
@@ -270,7 +270,7 @@
private int gestureModifiers = 0;
/**
- * Indicates whether the gestureModifiers are invalid.
+ * Indicates whether the {@code gestureModifiers} are invalid.
*
* @serial
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSourceDropEvent.java 2015-10-04 22:53:16.917272657 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceDropEvent.java 2015-10-04 22:53:16.729272665 +0400
@@ -26,12 +26,12 @@
package java.awt.dnd;
/**
- * The DragSourceDropEvent is delivered
- * from the DragSourceContextPeer,
- * via the DragSourceContext, to the dragDropEnd
- * method of DragSourceListeners registered with that
- * DragSourceContext and with its associated
- * DragSource.
+ * The {@code DragSourceDropEvent} is delivered
+ * from the {@code DragSourceContextPeer},
+ * via the {@code DragSourceContext}, to the {@code dragDropEnd}
+ * method of {@code DragSourceListener}s registered with that
+ * {@code DragSourceContext} and with its associated
+ * {@code DragSource}.
* It contains sufficient information for the
* originator of the operation
* to provide appropriate feedback to the end user
@@ -45,24 +45,24 @@
private static final long serialVersionUID = -5571321229470821891L;
/**
- * Construct a DragSourceDropEvent for a drop,
+ * Construct a {@code DragSourceDropEvent} for a drop,
* given the
- * DragSourceContext, the drop action,
- * and a boolean indicating if the drop was successful.
- * The coordinates for this DragSourceDropEvent
- * are not specified, so getLocation will return
- * null for this event.
+ * {@code DragSourceContext}, the drop action,
+ * and a {@code boolean} indicating if the drop was successful.
+ * The coordinates for this {@code DragSourceDropEvent}
+ * are not specified, so {@code getLocation} will return
+ * {@code null} for this event.
* action should be one of DnDConstants
+ * The argument {@code action} should be one of {@code DnDConstants}
* that represents a single action.
- * This constructor does not throw any exception for invalid action.
+ * This constructor does not throw any exception for invalid {@code action}.
*
- * @param dsc the DragSourceContext
- * associated with this DragSourceDropEvent
+ * @param dsc the {@code DragSourceContext}
+ * associated with this {@code DragSourceDropEvent}
* @param action the drop action
* @param success a boolean indicating if the drop was successful
*
- * @throws IllegalArgumentException if dsc is null.
+ * @throws IllegalArgumentException if {@code dsc} is {@code null}.
*
* @see DragSourceEvent#getLocation
*/
@@ -75,22 +75,22 @@
}
/**
- * Construct a DragSourceDropEvent for a drop, given the
- * DragSourceContext, the drop action, a boolean
+ * Construct a {@code DragSourceDropEvent} for a drop, given the
+ * {@code DragSourceContext}, the drop action, a {@code boolean}
* indicating if the drop was successful, and coordinates.
* action should be one of DnDConstants
+ * The argument {@code action} should be one of {@code DnDConstants}
* that represents a single action.
- * This constructor does not throw any exception for invalid action.
+ * This constructor does not throw any exception for invalid {@code action}.
*
- * @param dsc the DragSourceContext
- * associated with this DragSourceDropEvent
+ * @param dsc the {@code DragSourceContext}
+ * associated with this {@code DragSourceDropEvent}
* @param action the drop action
* @param success a boolean indicating if the drop was successful
* @param x the horizontal coordinate for the cursor location
* @param y the vertical coordinate for the cursor location
*
- * @throws IllegalArgumentException if dsc is null.
+ * @throws IllegalArgumentException if {@code dsc} is {@code null}.
*
* @since 1.4
*/
@@ -103,15 +103,15 @@
}
/**
- * Construct a DragSourceDropEvent
+ * Construct a {@code DragSourceDropEvent}
* for a drag that does not result in a drop.
- * The coordinates for this DragSourceDropEvent
- * are not specified, so getLocation will return
- * null for this event.
+ * The coordinates for this {@code DragSourceDropEvent}
+ * are not specified, so {@code getLocation} will return
+ * {@code null} for this event.
*
- * @param dsc the DragSourceContext
+ * @param dsc the {@code DragSourceContext}
*
- * @throws IllegalArgumentException if dsc is null.
+ * @throws IllegalArgumentException if {@code dsc} is {@code null}.
*
* @see DragSourceEvent#getLocation
*/
@@ -123,12 +123,12 @@
}
/**
- * This method returns a boolean indicating
+ * This method returns a {@code boolean} indicating
* if the drop was successful.
*
- * @return true if the drop target accepted the drop and
+ * @return {@code true} if the drop target accepted the drop and
* successfully performed a drop action;
- * false if the drop target rejected the drop or
+ * {@code false} if the drop target rejected the drop or
* if the drop target accepted the drop, but failed to perform
* a drop action.
*/
@@ -136,13 +136,13 @@
public boolean getDropSuccess() { return dropSuccess; }
/**
- * This method returns an int representing
+ * This method returns an {@code int} representing
* the action performed by the target on the subject of the drop.
*
* @return the action performed by the target on the subject of the drop
* if the drop target accepted the drop and the target drop action
* is supported by the drag source; otherwise,
- * DnDConstants.ACTION_NONE.
+ * {@code DnDConstants.ACTION_NONE}.
*/
public int getDropAction() { return dropAction; }
@@ -152,7 +152,7 @@
*/
/**
- * true if the drop was successful.
+ * {@code true} if the drop was successful.
*
* @serial
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSourceEvent.java 2015-10-04 22:53:17.481272632 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceEvent.java 2015-10-04 22:53:17.289272640 +0400
@@ -31,23 +31,23 @@
/**
* This class is the base class for
- * DragSourceDragEvent and
- * DragSourceDropEvent.
+ * {@code DragSourceDragEvent} and
+ * {@code DragSourceDropEvent}.
* DragSourceEvents are generated whenever the drag enters, moves
+ * {@code DragSourceEvent}s are generated whenever the drag enters, moves
* over, or exits a drop site, when the drop action changes, and when the drag
- * ends. The location for the generated DragSourceEvent specifies
+ * ends. The location for the generated {@code DragSourceEvent} specifies
* the mouse cursor location in screen coordinates at the moment this event
* occurred.
* GraphicsConfiguration. The initiator
- * GraphicsConfiguration is the GraphicsConfiguration
- * of the Component on which the drag gesture for the current drag
+ * {@code GraphicsConfiguration}. The initiator
+ * {@code GraphicsConfiguration} is the {@code GraphicsConfiguration}
+ * of the {@code Component} on which the drag gesture for the current drag
* operation was recognized. If the cursor location is outside the bounds of
- * the initiator GraphicsConfiguration, the reported coordinates are
- * clipped to fit within the bounds of that GraphicsConfiguration.
+ * the initiator {@code GraphicsConfiguration}, the reported coordinates are
+ * clipped to fit within the bounds of that {@code GraphicsConfiguration}.
* boolean indicating whether the cursor location
+ * The {@code boolean} indicating whether the cursor location
* is specified for this event.
*
* @serial
@@ -88,15 +88,15 @@
private final int y;
/**
- * Construct a DragSourceEvent
- * given a specified DragSourceContext.
- * The coordinates for this DragSourceEvent
- * are not specified, so getLocation will return
- * null for this event.
+ * Construct a {@code DragSourceEvent}
+ * given a specified {@code DragSourceContext}.
+ * The coordinates for this {@code DragSourceEvent}
+ * are not specified, so {@code getLocation} will return
+ * {@code null} for this event.
*
- * @param dsc the DragSourceContext
+ * @param dsc the {@code DragSourceContext}
*
- * @throws IllegalArgumentException if dsc is null.
+ * @throws IllegalArgumentException if {@code dsc} is {@code null}.
*
* @see #getLocation
*/
@@ -109,15 +109,15 @@
}
/**
- * Construct a DragSourceEvent given a specified
- * DragSourceContext, and coordinates of the cursor
+ * Construct a {@code DragSourceEvent} given a specified
+ * {@code DragSourceContext}, and coordinates of the cursor
* location.
*
- * @param dsc the DragSourceContext
+ * @param dsc the {@code DragSourceContext}
* @param x the horizontal coordinate for the cursor location
* @param y the vertical coordinate for the cursor location
*
- * @throws IllegalArgumentException if dsc is null.
+ * @throws IllegalArgumentException if {@code dsc} is {@code null}.
*
* @since 1.4
*/
@@ -129,10 +129,10 @@
}
/**
- * This method returns the DragSourceContext that
+ * This method returns the {@code DragSourceContext} that
* originated the event.
*
- * @return the DragSourceContext that originated the event
+ * @return the {@code DragSourceContext} that originated the event
*/
public DragSourceContext getDragSourceContext() {
@@ -140,13 +140,13 @@
}
/**
- * This method returns a Point indicating the cursor
+ * This method returns a {@code Point} indicating the cursor
* location in screen coordinates at the moment this event occurred, or
- * null if the cursor location is not specified for this
+ * {@code null} if the cursor location is not specified for this
* event.
*
- * @return the Point indicating the cursor location
- * or null if the cursor location is not specified
+ * @return the {@code Point} indicating the cursor location
+ * or {@code null} if the cursor location is not specified
* @since 1.4
*/
public Point getLocation() {
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSourceListener.java 2015-10-04 22:53:18.005272608 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceListener.java 2015-10-04 22:53:17.817272616 +0400
@@ -28,19 +28,19 @@
import java.util.EventListener;
/**
- * The DragSourceListener defines the
+ * The {@code DragSourceListener} defines the
* event interface for originators of
* Drag and Drop operations to track the state of the user's gesture, and to
* provide appropriate "drag over"
* feedback to the user throughout the
* Drag and Drop operation.
* dragEnter()
- * invocation if the latest invocation of dragEnter() on this
+ * The drop site is associated with the previous {@code dragEnter()}
+ * invocation if the latest invocation of {@code dragEnter()} on this
* listener:
*
*
*
* @since 1.2
@@ -58,7 +58,7 @@
* dragExit() invocation on this listener.
+ * DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
void dragEnter(DragSourceDragEvent dsde);
@@ -73,7 +73,7 @@
* DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
void dragOver(DragSourceDragEvent dsde);
@@ -84,7 +84,7 @@
* Such devices are typically the mouse buttons or keyboard
* modifiers that the user is interacting with.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
void dropActionChanged(DragSourceDragEvent dsde);
@@ -106,21 +106,21 @@
* has rejected the drag.
*
*
- * @param dse the DragSourceEvent
+ * @param dse the {@code DragSourceEvent}
*/
void dragExit(DragSourceEvent dse);
/**
* This method is invoked to signify that the Drag and Drop
* operation is complete. The getDropSuccess() method of
- * the DragSourceDropEvent can be used to
+ * the {@code DragSourceDropEvent} can be used to
* determine the termination state. The getDropAction() method
* returns the operation that the drop site selected
* to apply to the Drop operation. Once this method is complete, the
- * current DragSourceContext and
+ * current {@code DragSourceContext} and
* associated resources become invalid.
*
- * @param dsde the DragSourceDropEvent
+ * @param dsde the {@code DragSourceDropEvent}
*/
void dragDropEnd(DragSourceDropEvent dsde);
}
--- old/src/java.desktop/share/classes/java/awt/dnd/DragSourceMotionListener.java 2015-10-04 22:53:18.529272585 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceMotionListener.java 2015-10-04 22:53:18.341272593 +0400
@@ -33,14 +33,14 @@
* DragSourceAdapter class (overriding only the methods of
+ * {@code DragSourceAdapter} class (overriding only the methods of
* interest).
* DragSource. Whenever the mouse moves during a drag
- * operation initiated with this DragSource, that object's
- * dragMouseMoved method is invoked, and the
- * DragSourceDragEvent is passed to it.
+ * a {@code DragSource}. Whenever the mouse moves during a drag
+ * operation initiated with this {@code DragSource}, that object's
+ * {@code dragMouseMoved} method is invoked, and the
+ * {@code DragSourceDragEvent} is passed to it.
*
* @see DragSourceDragEvent
* @see DragSource
@@ -55,7 +55,7 @@
/**
* Called whenever the mouse is moved during a drag operation.
*
- * @param dsde the DragSourceDragEvent
+ * @param dsde the {@code DragSourceDragEvent}
*/
void dragMouseMoved(DragSourceDragEvent dsde);
}
--- old/src/java.desktop/share/classes/java/awt/dnd/DropTarget.java 2015-10-04 22:53:19.309272549 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTarget.java 2015-10-04 22:53:19.121272558 +0400
@@ -54,15 +54,15 @@
/**
- * The DropTarget is associated
- * with a Component when that Component
+ * The {@code DropTarget} is associated
+ * with a {@code Component} when that {@code Component}
* wishes
* to accept drops during Drag and Drop operations.
* DropTarget is associated with a FlavorMap.
- * The default FlavorMap hereafter designates the
- * FlavorMap returned by SystemFlavorMap.getDefaultFlavorMap().
+ * {@code DropTarget} is associated with a {@code FlavorMap}.
+ * The default {@code FlavorMap} hereafter designates the
+ * {@code FlavorMap} returned by {@code SystemFlavorMap.getDefaultFlavorMap()}.
*
* @since 1.2
*/
@@ -72,20 +72,20 @@
private static final long serialVersionUID = -6283860791671019047L;
/**
- * Creates a new DropTarget given the Component
- * to associate itself with, an int representing
+ * Creates a new DropTarget given the {@code Component}
+ * to associate itself with, an {@code int} representing
* the default acceptable action(s) to
- * support, a DropTargetListener
- * to handle event processing, a boolean indicating
- * if the DropTarget is currently accepting drops, and
- * a FlavorMap to use (or null for the default FlavorMap).
+ * support, a {@code DropTargetListener}
+ * to handle event processing, a {@code boolean} indicating
+ * if the {@code DropTarget} is currently accepting drops, and
+ * a {@code FlavorMap} to use (or null for the default {@code FlavorMap}).
* Component with which this DropTarget is associated
- * @param ops The default acceptable actions for this DropTarget
- * @param dtl The DropTargetListener for this DropTarget
- * @param act Is the DropTarget accepting drops.
- * @param fm The FlavorMap to use, or null for the default FlavorMap
+ * @param c The {@code Component} with which this {@code DropTarget} is associated
+ * @param ops The default acceptable actions for this {@code DropTarget}
+ * @param dtl The {@code DropTargetListener} for this {@code DropTarget}
+ * @param act Is the {@code DropTarget} accepting drops.
+ * @param fm The {@code FlavorMap} to use, or null for the default {@code FlavorMap}
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -121,18 +121,18 @@
}
/**
- * Creates a DropTarget given the Component
- * to associate itself with, an int representing
+ * Creates a {@code DropTarget} given the {@code Component}
+ * to associate itself with, an {@code int} representing
* the default acceptable action(s)
- * to support, a DropTargetListener
- * to handle event processing, and a boolean indicating
- * if the DropTarget is currently accepting drops.
+ * to support, a {@code DropTargetListener}
+ * to handle event processing, and a {@code boolean} indicating
+ * if the {@code DropTarget} is currently accepting drops.
* Component with which this DropTarget is associated
- * @param ops The default acceptable actions for this DropTarget
- * @param dtl The DropTargetListener for this DropTarget
- * @param act Is the DropTarget accepting drops.
+ * @param c The {@code Component} with which this {@code DropTarget} is associated
+ * @param ops The default acceptable actions for this {@code DropTarget}
+ * @param dtl The {@code DropTargetListener} for this {@code DropTarget}
+ * @param act Is the {@code DropTarget} accepting drops.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -145,7 +145,7 @@
}
/**
- * Creates a DropTarget.
+ * Creates a {@code DropTarget}.
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -155,13 +155,13 @@
}
/**
- * Creates a DropTarget given the Component
- * to associate itself with, and the DropTargetListener
+ * Creates a {@code DropTarget} given the {@code Component}
+ * to associate itself with, and the {@code DropTargetListener}
* to handle event processing.
* Component with which this DropTarget is associated
- * @param dtl The DropTargetListener for this DropTarget
+ * @param c The {@code Component} with which this {@code DropTarget} is associated
+ * @param dtl The {@code DropTargetListener} for this {@code DropTarget}
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -173,15 +173,15 @@
}
/**
- * Creates a DropTarget given the Component
- * to associate itself with, an int representing
+ * Creates a {@code DropTarget} given the {@code Component}
+ * to associate itself with, an {@code int} representing
* the default acceptable action(s) to support, and a
- * DropTargetListener to handle event processing.
+ * {@code DropTargetListener} to handle event processing.
* Component with which this DropTarget is associated
- * @param ops The default acceptable actions for this DropTarget
- * @param dtl The DropTargetListener for this DropTarget
+ * @param c The {@code Component} with which this {@code DropTarget} is associated
+ * @param ops The default acceptable actions for this {@code DropTarget}
+ * @param dtl The {@code DropTargetListener} for this {@code DropTarget}
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -195,11 +195,11 @@
/**
* Note: this interface is required to permit the safe association
* of a DropTarget with a Component in one of two ways, either:
- * component.setDropTarget(droptarget);
- * or droptarget.setComponent(component);
+ * {@code component.setDropTarget(droptarget);}
+ * or {@code droptarget.setComponent(component);}
* Component this DropTarget
+ * @param c The new {@code Component} this {@code DropTarget}
* is to be associated with.
*/
@@ -229,10 +229,10 @@
}
/**
- * Gets the Component associated
- * with this DropTarget.
+ * Gets the {@code Component} associated
+ * with this {@code DropTarget}.
*
- * @return the current Component
+ * @return the current {@code Component}
*/
public synchronized Component getComponent() {
@@ -240,7 +240,7 @@
}
/**
- * Sets the default acceptable actions for this DropTarget
+ * Sets the default acceptable actions for this {@code DropTarget}
*
* @param ops the default actions
* @see java.awt.dnd.DnDConstants
@@ -259,8 +259,8 @@
}
/**
- * Gets an int representing the
- * current action(s) supported by this DropTarget.
+ * Gets an {@code int} representing the
+ * current action(s) supported by this {@code DropTarget}.
*
* @return the current default actions
*/
@@ -270,10 +270,10 @@
}
/**
- * Sets the DropTarget active if true,
- * inactive if false.
+ * Sets the DropTarget active if {@code true},
+ * inactive if {@code false}.
*
- * @param isActive sets the DropTarget (in)active.
+ * @param isActive sets the {@code DropTarget} (in)active.
*/
public synchronized void setActive(boolean isActive) {
@@ -286,10 +286,10 @@
/**
* Reports whether or not
- * this DropTarget
+ * this {@code DropTarget}
* is currently active (ready to accept drops).
*
- * @return true if active, false if not
+ * @return {@code true} if active, {@code false} if not
*/
public boolean isActive() {
@@ -297,13 +297,13 @@
}
/**
- * Adds a new DropTargetListener (UNICAST SOURCE).
+ * Adds a new {@code DropTargetListener} (UNICAST SOURCE).
*
- * @param dtl The new DropTargetListener
+ * @param dtl The new {@code DropTargetListener}
*
* @throws TooManyListenersException if a
- * DropTargetListener is already added to this
- * DropTarget.
+ * {@code DropTargetListener} is already added to this
+ * {@code DropTarget}.
*/
public synchronized void addDropTargetListener(DropTargetListener dtl) throws TooManyListenersException {
@@ -318,7 +318,7 @@
}
/**
- * Removes the current DropTargetListener (UNICAST SOURCE).
+ * Removes the current {@code DropTargetListener} (UNICAST SOURCE).
*
* @param dtl the DropTargetListener to deregister.
*/
@@ -333,16 +333,16 @@
}
/**
- * Calls dragEnter on the registered
- * DropTargetListener and passes it
- * the specified DropTargetDragEvent.
- * Has no effect if this DropTarget
+ * Calls {@code dragEnter} on the registered
+ * {@code DropTargetListener} and passes it
+ * the specified {@code DropTargetDragEvent}.
+ * Has no effect if this {@code DropTarget}
* is not active.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*
- * @throws NullPointerException if this DropTarget
- * is active and dtde is null
+ * @throws NullPointerException if this {@code DropTarget}
+ * is active and {@code dtde} is {@code null}
*
* @see #isActive
*/
@@ -360,16 +360,16 @@
}
/**
- * Calls dragOver on the registered
- * DropTargetListener and passes it
- * the specified DropTargetDragEvent.
- * Has no effect if this DropTarget
+ * Calls {@code dragOver} on the registered
+ * {@code DropTargetListener} and passes it
+ * the specified {@code DropTargetDragEvent}.
+ * Has no effect if this {@code DropTarget}
* is not active.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*
- * @throws NullPointerException if this DropTarget
- * is active and dtde is null
+ * @throws NullPointerException if this {@code DropTarget}
+ * is active and {@code dtde} is {@code null}
*
* @see #isActive
*/
@@ -382,16 +382,16 @@
}
/**
- * Calls dropActionChanged on the registered
- * DropTargetListener and passes it
- * the specified DropTargetDragEvent.
- * Has no effect if this DropTarget
+ * Calls {@code dropActionChanged} on the registered
+ * {@code DropTargetListener} and passes it
+ * the specified {@code DropTargetDragEvent}.
+ * Has no effect if this {@code DropTarget}
* is not active.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*
- * @throws NullPointerException if this DropTarget
- * is active and dtde is null
+ * @throws NullPointerException if this {@code DropTarget}
+ * is active and {@code dtde} is {@code null}
*
* @see #isActive
*/
@@ -404,17 +404,17 @@
}
/**
- * Calls dragExit on the registered
- * DropTargetListener and passes it
- * the specified DropTargetEvent.
- * Has no effect if this DropTarget
+ * Calls {@code dragExit} on the registered
+ * {@code DropTargetListener} and passes it
+ * the specified {@code DropTargetEvent}.
+ * Has no effect if this {@code DropTarget}
* is not active.
* DropTargetEvent
+ * @param dte the {@code DropTargetEvent}
*
* @see #isActive
*/
@@ -429,17 +429,17 @@
}
/**
- * Calls drop on the registered
- * DropTargetListener and passes it
- * the specified DropTargetDropEvent
- * if this DropTarget is active.
+ * Calls {@code drop} on the registered
+ * {@code DropTargetListener} and passes it
+ * the specified {@code DropTargetDropEvent}
+ * if this {@code DropTarget} is active.
*
- * @param dtde the DropTargetDropEvent
+ * @param dtde the {@code DropTargetDropEvent}
*
- * @throws NullPointerException if dtde is null
+ * @throws NullPointerException if {@code dtde} is null
* and at least one of the following is true: this
- * DropTarget is not active, or there is
- * no a DropTargetListener registered.
+ * {@code DropTarget} is not active, or there is
+ * no a {@code DropTargetListener} registered.
*
* @see #isActive
*/
@@ -456,11 +456,11 @@
}
/**
- * Gets the FlavorMap
- * associated with this DropTarget.
- * If no FlavorMap has been set for this
- * DropTarget, it is associated with the default
- * FlavorMap.
+ * Gets the {@code FlavorMap}
+ * associated with this {@code DropTarget}.
+ * If no {@code FlavorMap} has been set for this
+ * {@code DropTarget}, it is associated with the default
+ * {@code FlavorMap}.
*
* @return the FlavorMap for this DropTarget
*/
@@ -468,10 +468,10 @@
public FlavorMap getFlavorMap() { return flavorMap; }
/**
- * Sets the FlavorMap associated
- * with this DropTarget.
+ * Sets the {@code FlavorMap} associated
+ * with this {@code DropTarget}.
*
- * @param fm the new FlavorMap, or null to
+ * @param fm the new {@code FlavorMap}, or null to
* associate the default FlavorMap with this DropTarget.
*/
@@ -544,10 +544,10 @@
}
/**
- * Gets the DropTargetContext associated
- * with this DropTarget.
+ * Gets the {@code DropTargetContext} associated
+ * with this {@code DropTarget}.
*
- * @return the DropTargetContext associated with this DropTarget.
+ * @return the {@code DropTargetContext} associated with this {@code DropTarget}.
*/
public DropTargetContext getDropTargetContext() {
@@ -571,14 +571,14 @@
}
/**
- * Serializes this DropTarget. Performs default serialization,
- * and then writes out this object's DropTargetListener if and
- * only if it can be serialized. If not, null is written
+ * Serializes this {@code DropTarget}. Performs default serialization,
+ * and then writes out this object's {@code DropTargetListener} if and
+ * only if it can be serialized. If not, {@code null} is written
* instead.
*
* @serialData The default serializable fields, in alphabetical order,
- * followed by either a DropTargetListener
- * instance, or null.
+ * followed by either a {@code DropTargetListener}
+ * instance, or {@code null}.
* @since 1.4
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -589,13 +589,13 @@
}
/**
- * Deserializes this DropTarget. This method first performs
- * default deserialization for all non-transient fields. An
+ * Deserializes this {@code DropTarget}. This method first performs
+ * default deserialization for all non-{@code transient} fields. An
* attempt is then made to deserialize this object's
- * DropTargetListener as well. This is first attempted by
- * deserializing the field dtListener, because, in releases
- * prior to 1.4, a non-transient field of this name stored the
- * DropTargetListener. If this fails, the next object in the
+ * {@code DropTargetListener} as well. This is first attempted by
+ * deserializing the field {@code dtListener}, because, in releases
+ * prior to 1.4, a non-{@code transient} field of this name stored the
+ * {@code DropTargetListener}. If this fails, the next object in the
* stream is used instead.
*
* @since 1.4
@@ -639,8 +639,8 @@
/**
* construct a DropTargetAutoScroller
*
- * @param c the Component
- * @param p the Point
+ * @param c the {@code Component}
+ * @param p the {@code Point}
*/
protected DropTargetAutoScroller(Component c, Point p) {
@@ -709,7 +709,7 @@
/**
* cause autoscroll to occur
*
- * @param newLocn the Point
+ * @param newLocn the {@code Point}
*/
protected synchronized void updateLocation(Point newLocn) {
@@ -733,7 +733,7 @@
/**
* cause autoscroll to occur
*
- * @param e the ActionEvent
+ * @param e the {@code ActionEvent}
*/
public synchronized void actionPerformed(ActionEvent e) {
@@ -766,8 +766,8 @@
/**
* create an embedded autoscroller
*
- * @param c the Component
- * @param p the Point
+ * @param c the {@code Component}
+ * @param p the {@code Point}
* @return an embedded autoscroller
*/
@@ -778,7 +778,7 @@
/**
* initialize autoscrolling
*
- * @param p the Point
+ * @param p the {@code Point}
*/
protected void initializeAutoscrolling(Point p) {
@@ -790,7 +790,7 @@
/**
* update autoscrolling with current cursor location
*
- * @param dragCursorLocn the Point
+ * @param dragCursorLocn the {@code Point}
*/
protected void updateAutoscroll(Point dragCursorLocn) {
@@ -843,7 +843,7 @@
int actions = DnDConstants.ACTION_COPY_OR_MOVE;
/**
- * true if the DropTarget is accepting Drag & Drop operations.
+ * {@code true} if the DropTarget is accepting Drag & Drop operations.
*
* @serial
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DropTargetAdapter.java 2015-10-04 22:53:19.853272525 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetAdapter.java 2015-10-04 22:53:19.661272534 +0400
@@ -30,39 +30,39 @@
* this class are empty. This class exists only as a convenience for creating
* listener objects.
* DropTargetEvent listener
+ * Extend this class to create a {@code DropTargetEvent} listener
* and override the methods for the events of interest. (If you implement the
- * DropTargetListener interface, you have to define all of
+ * {@code DropTargetListener} interface, you have to define all of
* the methods in it. This abstract class defines a null implementation for
- * every method except drop(DropTargetDropEvent), so you only have
+ * every method except {@code drop(DropTargetDropEvent)}, so you only have
* to define methods for events you care about.) You must provide an
- * implementation for at least drop(DropTargetDropEvent). This
+ * implementation for at least {@code drop(DropTargetDropEvent)}. This
* method cannot have a null implementation because its specification requires
* that you either accept or reject the drop, and, if accepted, indicate
* whether the drop was successful.
* DropTarget. When the drag enters, moves over, or exits
- * the operable part of the drop site for that DropTarget, when
+ * a {@code DropTarget}. When the drag enters, moves over, or exits
+ * the operable part of the drop site for that {@code DropTarget}, when
* the drop action changes, and when the drop occurs, the relevant method in
- * the listener object is invoked, and the DropTargetEvent is
+ * the listener object is invoked, and the {@code DropTargetEvent} is
* passed to it.
* DropTarget is
- * the part of the associated Component's geometry that is not
+ * The operable part of the drop site for the {@code DropTarget} is
+ * the part of the associated {@code Component}'s geometry that is not
* obscured by an overlapping top-level window or by another
- * Component higher in the Z-order that has an associated active
- * DropTarget.
+ * {@code Component} higher in the Z-order that has an associated active
+ * {@code DropTarget}.
* getTransferable() on
- * DropTargetDragEvent instances passed to the listener's
+ * retrieved by calling {@code getTransferable()} on
+ * {@code DropTargetDragEvent} instances passed to the listener's
* methods.
* getTransferable() on the
- * DropTargetDragEvent instance should only be called within the
+ * Note that {@code getTransferable()} on the
+ * {@code DropTargetDragEvent} instance should only be called within the
* respective listener's method and all the necessary data should be retrieved
- * from the returned Transferable before that method returns.
+ * from the returned {@code Transferable} before that method returns.
*
* @see DropTargetEvent
* @see DropTargetListener
@@ -74,19 +74,19 @@
/**
* Called while a drag operation is ongoing, when the mouse pointer enters
- * the operable part of the drop site for the DropTarget
+ * the operable part of the drop site for the {@code DropTarget}
* registered with this listener.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*/
public void dragEnter(DropTargetDragEvent dtde) {}
/**
* Called when a drag operation is ongoing, while the mouse pointer is still
- * over the operable part of the drop site for the DropTarget
+ * over the operable part of the drop site for the {@code DropTarget}
* registered with this listener.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*/
public void dragOver(DropTargetDragEvent dtde) {}
@@ -94,16 +94,16 @@
* Called if the user has modified
* the current drop gesture.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*/
public void dropActionChanged(DropTargetDragEvent dtde) {}
/**
* Called while a drag operation is ongoing, when the mouse pointer has
* exited the operable part of the drop site for the
- * DropTarget registered with this listener.
+ * {@code DropTarget} registered with this listener.
*
- * @param dte the DropTargetEvent
+ * @param dte the {@code DropTargetEvent}
*/
public void dragExit(DropTargetEvent dte) {}
}
--- old/src/java.desktop/share/classes/java/awt/dnd/DropTargetDragEvent.java 2015-10-04 22:53:20.373272502 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetDragEvent.java 2015-10-04 22:53:20.185272510 +0400
@@ -33,15 +33,15 @@
import java.util.List;
/**
- * The DropTargetDragEvent is delivered to a
- * DropTargetListener via its
+ * The {@code DropTargetDragEvent} is delivered to a
+ * {@code DropTargetListener} via its
* dragEnter() and dragOver() methods.
* DropTargetDragEvent reports the source drop actions
+ * The {@code DropTargetDragEvent} reports the source drop actions
* and the user drop action that reflect the current state of
* the drag operation.
* DnDConstants
+ * Source drop actions is a bitwise mask of {@code DnDConstants}
* that represents the set of drop actions supported by the drag source for
* this drag operation.
* DnDConstants that represents the selected drop action if this
+ * {@code DnDConstants} that represents the selected drop action if this
* drop action is supported by the drag source or
- * DnDConstants.ACTION_NONE if this drop action is not supported
+ * {@code DnDConstants.ACTION_NONE} if this drop action is not supported
* by the drag source.
* DnDConstants that represents the set of drop actions supported
- * by the drag source is searched for DnDConstants.ACTION_MOVE,
- * then for DnDConstants.ACTION_COPY, then for
- * DnDConstants.ACTION_LINK and the user drop action is the
+ * {@code DnDConstants} that represents the set of drop actions supported
+ * by the drag source is searched for {@code DnDConstants.ACTION_MOVE},
+ * then for {@code DnDConstants.ACTION_COPY}, then for
+ * {@code DnDConstants.ACTION_LINK} and the user drop action is the
* first constant found. If no constant is found the user drop action
- * is DnDConstants.ACTION_NONE.
+ * is {@code DnDConstants.ACTION_NONE}.
*
* @since 1.2
*/
@@ -75,10 +75,10 @@
private static final long serialVersionUID = -8422265619058953682L;
/**
- * Construct a DropTargetDragEvent given the
- * DropTargetContext for this operation,
- * the location of the "Drag" Cursor's hotspot
- * in the Component's coordinates, the
+ * Construct a {@code DropTargetDragEvent} given the
+ * {@code DropTargetContext} for this operation,
+ * the location of the "Drag" {@code Cursor}'s hotspot
+ * in the {@code Component}'s coordinates, the
* user drop action, and the source drop actions.
*
* @param dtc The DropTargetContext for this operation
@@ -89,10 +89,10 @@
*
* @throws NullPointerException if cursorLocn is null
* @throws IllegalArgumentException if dropAction is not one of
- * DnDConstants.
+ * {@code DnDConstants}.
* @throws IllegalArgumentException if srcActions is not
- * a bitwise mask of DnDConstants.
- * @throws IllegalArgumentException if dtc is null.
+ * a bitwise mask of {@code DnDConstants}.
+ * @throws IllegalArgumentException if dtc is {@code null}.
*/
public DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions) {
@@ -114,13 +114,13 @@
}
/**
- * This method returns a Point
- * indicating the Cursor's current
- * location within the Component's
+ * This method returns a {@code Point}
+ * indicating the {@code Cursor}'s current
+ * location within the {@code Component'}s
* coordinates.
*
* @return the current cursor location in
- * Component's coords.
+ * {@code Component}'s coords.
*/
public Point getLocation() {
@@ -129,8 +129,8 @@
/**
- * This method returns the current DataFlavors from the
- * DropTargetContext.
+ * This method returns the current {@code DataFlavor}s from the
+ * {@code DropTargetContext}.
*
* @return current DataFlavors from the DropTargetContext
*/
@@ -140,10 +140,10 @@
}
/**
- * This method returns the current DataFlavors
- * as a java.util.List
+ * This method returns the current {@code DataFlavor}s
+ * as a {@code java.util.List}
*
- * @return a java.util.List of the Current DataFlavors
+ * @return a {@code java.util.List} of the Current {@code DataFlavor}s
*/
public Listboolean indicating
- * if the specified DataFlavor is supported.
+ * This method returns a {@code boolean} indicating
+ * if the specified {@code DataFlavor} is supported.
*
- * @param df the DataFlavor to test
+ * @param df the {@code DataFlavor} to test
*
* @return if a particular DataFlavor is supported
*/
@@ -195,11 +195,11 @@
* Accepts the drag.
*
* This method should be called from a
- * DropTargetListeners dragEnter,
- * dragOver, and dropActionChanged
+ * {@code DropTargetListeners dragEnter},
+ * {@code dragOver}, and {@code dropActionChanged}
* methods if the implementation wishes to accept an operation
* from the srcActions other than the one selected by
- * the user as represented by the dropAction.
+ * the user as represented by the {@code dropAction}.
*
* @param dragOperation the operation accepted by the target
*/
@@ -209,7 +209,7 @@
/**
* Rejects the drag as a result of examining either the
- * dropAction or the available DataFlavor
+ * {@code dropAction} or the available {@code DataFlavor}
* types.
*/
public void rejectDrag() {
--- old/src/java.desktop/share/classes/java/awt/dnd/DropTargetDropEvent.java 2015-10-04 22:53:20.905272478 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetDropEvent.java 2015-10-04 22:53:20.713272486 +0400
@@ -33,14 +33,14 @@
import java.util.List;
/**
- * The DropTargetDropEvent is delivered
- * via the DropTargetListener drop() method.
+ * The {@code DropTargetDropEvent} is delivered
+ * via the {@code DropTargetListener} drop() method.
* DropTargetDropEvent reports the source drop actions
+ * The {@code DropTargetDropEvent} reports the source drop actions
* and the user drop action that reflect the current state of the
* drag-and-drop operation.
* DnDConstants
+ * Source drop actions is a bitwise mask of {@code DnDConstants}
* that represents the set of drop actions supported by the drag source for
* this drag-and-drop operation.
* DnDConstants that represents the selected drop action if this
+ * {@code DnDConstants} that represents the selected drop action if this
* drop action is supported by the drag source or
- * DnDConstants.ACTION_NONE if this drop action is not supported
+ * {@code DnDConstants.ACTION_NONE} if this drop action is not supported
* by the drag source.
* DnDConstants that represents the set of drop actions supported
- * by the drag source is searched for DnDConstants.ACTION_MOVE,
- * then for DnDConstants.ACTION_COPY, then for
- * DnDConstants.ACTION_LINK and the user drop action is the
+ * {@code DnDConstants} that represents the set of drop actions supported
+ * by the drag source is searched for {@code DnDConstants.ACTION_MOVE},
+ * then for {@code DnDConstants.ACTION_COPY}, then for
+ * {@code DnDConstants.ACTION_LINK} and the user drop action is the
* first constant found. If no constant is found the user drop action
- * is DnDConstants.ACTION_NONE.
+ * is {@code DnDConstants.ACTION_NONE}.
*
* @since 1.2
*/
@@ -74,31 +74,31 @@
private static final long serialVersionUID = -1721911170440459322L;
/**
- * Construct a DropTargetDropEvent given
- * the DropTargetContext for this operation,
- * the location of the drag Cursor's
- * hotspot in the Component's coordinates,
+ * Construct a {@code DropTargetDropEvent} given
+ * the {@code DropTargetContext} for this operation,
+ * the location of the drag {@code Cursor}'s
+ * hotspot in the {@code Component}'s coordinates,
* the currently
* selected user drop action, and the current set of
* actions supported by the source.
* By default, this constructor
* assumes that the target is not in the same virtual machine as
* the source; that is, {@link #isLocalTransfer()} will
- * return false.
+ * return {@code false}.
*
- * @param dtc The DropTargetContext for this operation
+ * @param dtc The {@code DropTargetContext} for this operation
* @param cursorLocn The location of the "Drag" Cursor's
- * hotspot in Component coordinates
+ * hotspot in {@code Component} coordinates
* @param dropAction the user drop action.
* @param srcActions the source drop actions.
*
* @throws NullPointerException
- * if cursorLocn is null
+ * if cursorLocn is {@code null}
* @throws IllegalArgumentException
- * if dropAction is not one of DnDConstants.
+ * if dropAction is not one of {@code DnDConstants}.
* @throws IllegalArgumentException
- * if srcActions is not a bitwise mask of DnDConstants.
- * @throws IllegalArgumentException if dtc is null.
+ * if srcActions is not a bitwise mask of {@code DnDConstants}.
+ * @throws IllegalArgumentException if dtc is {@code null}.
*/
public DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions) {
@@ -120,13 +120,13 @@
}
/**
- * Construct a DropTargetEvent given the
- * DropTargetContext for this operation,
- * the location of the drag Cursor's hotspot
- * in the Component's
+ * Construct a {@code DropTargetEvent} given the
+ * {@code DropTargetContext} for this operation,
+ * the location of the drag {@code Cursor}'s hotspot
+ * in the {@code Component}'s
* coordinates, the currently selected user drop action,
* the current set of actions supported by the source,
- * and a boolean indicating if the source is in the same JVM
+ * and a {@code boolean} indicating if the source is in the same JVM
* as the target.
*
* @param dtc The DropTargetContext for this operation
@@ -137,11 +137,11 @@
* @param isLocal True if the source is in the same JVM as the target
*
* @throws NullPointerException
- * if cursorLocn is null
+ * if cursorLocn is {@code null}
* @throws IllegalArgumentException
- * if dropAction is not one of DnDConstants.
- * @throws IllegalArgumentException if srcActions is not a bitwise mask of DnDConstants.
- * @throws IllegalArgumentException if dtc is null.
+ * if dropAction is not one of {@code DnDConstants}.
+ * @throws IllegalArgumentException if srcActions is not a bitwise mask of {@code DnDConstants}.
+ * @throws IllegalArgumentException if dtc is {@code null}.
*/
public DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal) {
@@ -151,11 +151,11 @@
}
/**
- * This method returns a Point
- * indicating the Cursor's current
- * location in the Component's coordinates.
+ * This method returns a {@code Point}
+ * indicating the {@code Cursor}'s current
+ * location in the {@code Component}'s coordinates.
*
- * @return the current Cursor location in Component's coords.
+ * @return the current {@code Cursor} location in Component's coords.
*/
public Point getLocation() {
@@ -175,7 +175,7 @@
/**
* This method returns the currently available
- * DataFlavors as a java.util.List.
+ * {@code DataFlavor}s as a {@code java.util.List}.
*
* @return the currently available DataFlavors as a java.util.List
*/
@@ -185,11 +185,11 @@
}
/**
- * This method returns a boolean indicating if the
- * specified DataFlavor is available
+ * This method returns a {@code boolean} indicating if the
+ * specified {@code DataFlavor} is available
* from the source.
*
- * @param df the DataFlavor to test
+ * @param df the {@code DataFlavor} to test
*
* @return if the DataFlavor specified is available from the source
*/
@@ -213,10 +213,10 @@
public int getDropAction() { return dropAction; }
/**
- * This method returns the Transferable object
+ * This method returns the {@code Transferable} object
* associated with the drop.
*
- * @return the Transferable associated with the drop
+ * @return the {@code Transferable} associated with the drop
*/
public Transferable getTransferable() {
@@ -242,10 +242,10 @@
}
/**
- * This method notifies the DragSource
+ * This method notifies the {@code DragSource}
* that the drop transfer(s) are completed.
*
- * @param success a boolean indicating that the drop transfer(s) are completed.
+ * @param success a {@code boolean} indicating that the drop transfer(s) are completed.
*/
public void dropComplete(boolean success) {
@@ -253,7 +253,7 @@
}
/**
- * This method returns an int indicating if
+ * This method returns an {@code int} indicating if
* the source is in the same JVM as the target.
*
* @return if the Source is in the same JVM
@@ -291,7 +291,7 @@
private int dropAction = DnDConstants.ACTION_NONE;
/**
- * true if the source is in the same JVM as the target.
+ * {@code true} if the source is in the same JVM as the target.
*
* @serial
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DropTargetEvent.java 2015-10-04 22:53:21.433272454 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetEvent.java 2015-10-04 22:53:21.241272463 +0400
@@ -29,12 +29,12 @@
import java.awt.dnd.DropTargetContext;
/**
- * The DropTargetEvent is the base
- * class for both the DropTargetDragEvent
- * and the DropTargetDropEvent.
+ * The {@code DropTargetEvent} is the base
+ * class for both the {@code DropTargetDragEvent}
+ * and the {@code DropTargetDropEvent}.
* It encapsulates the current state of the Drag and
* Drop operations, in particular the current
- * DropTargetContext.
+ * {@code DropTargetContext}.
*
* @since 1.2
*
@@ -45,10 +45,10 @@
private static final long serialVersionUID = 2821229066521922993L;
/**
- * Construct a DropTargetEvent object with
- * the specified DropTargetContext.
+ * Construct a {@code DropTargetEvent} object with
+ * the specified {@code DropTargetContext}.
*
- * @param dtc The DropTargetContext
+ * @param dtc The {@code DropTargetContext}
* @throws NullPointerException if {@code dtc} equals {@code null}.
* @see #getSource()
* @see #getDropTargetContext()
@@ -61,10 +61,10 @@
}
/**
- * This method returns the DropTargetContext
- * associated with this DropTargetEvent.
+ * This method returns the {@code DropTargetContext}
+ * associated with this {@code DropTargetEvent}.
*
- * @return the DropTargetContext
+ * @return the {@code DropTargetContext}
*/
public DropTargetContext getDropTargetContext() {
@@ -72,8 +72,8 @@
}
/**
- * The DropTargetContext associated with this
- * DropTargetEvent.
+ * The {@code DropTargetContext} associated with this
+ * {@code DropTargetEvent}.
*
* @serial
*/
--- old/src/java.desktop/share/classes/java/awt/dnd/DropTargetListener.java 2015-10-04 22:53:21.957272431 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetListener.java 2015-10-04 22:53:21.769272439 +0400
@@ -31,37 +31,37 @@
import java.awt.dnd.DropTargetDropEvent;
/**
- * The DropTargetListener interface
+ * The {@code DropTargetListener} interface
* is the callback interface used by the
- * DropTarget class to provide
+ * {@code DropTarget} class to provide
* notification of DnD operations that involve
- * the subject DropTarget. Methods of
+ * the subject {@code DropTarget}. Methods of
* this interface may be implemented to provide
* "drag under" visual feedback to the user throughout
* the Drag and Drop operation.
* DropTarget. When the drag enters, moves over, or exits
- * the operable part of the drop site for that DropTarget, when
+ * with a {@code DropTarget}. When the drag enters, moves over, or exits
+ * the operable part of the drop site for that {@code DropTarget}, when
* the drop action changes, and when the drop occurs, the relevant method in
- * the listener object is invoked, and the DropTargetEvent is
+ * the listener object is invoked, and the {@code DropTargetEvent} is
* passed to it.
* DropTarget is
- * the part of the associated Component's geometry that is not
+ * The operable part of the drop site for the {@code DropTarget} is
+ * the part of the associated {@code Component}'s geometry that is not
* obscured by an overlapping top-level window or by another
- * Component higher in the Z-order that has an associated active
- * DropTarget.
+ * {@code Component} higher in the Z-order that has an associated active
+ * {@code DropTarget}.
* getTransferable() on
- * DropTargetDragEvent instances passed to the listener's
+ * retrieved by calling {@code getTransferable()} on
+ * {@code DropTargetDragEvent} instances passed to the listener's
* methods.
* getTransferable() on the
- * DropTargetDragEvent instance should only be called within the
+ * Note that {@code getTransferable()} on the
+ * {@code DropTargetDragEvent} instance should only be called within the
* respective listener's method and all the necessary data should be retrieved
- * from the returned Transferable before that method returns.
+ * from the returned {@code Transferable} before that method returns.
*
* @since 1.2
*/
@@ -70,20 +70,20 @@
/**
* Called while a drag operation is ongoing, when the mouse pointer enters
- * the operable part of the drop site for the DropTarget
+ * the operable part of the drop site for the {@code DropTarget}
* registered with this listener.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*/
void dragEnter(DropTargetDragEvent dtde);
/**
* Called when a drag operation is ongoing, while the mouse pointer is still
- * over the operable part of the drop site for the DropTarget
+ * over the operable part of the drop site for the {@code DropTarget}
* registered with this listener.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*/
void dragOver(DropTargetDragEvent dtde);
@@ -92,7 +92,7 @@
* Called if the user has modified
* the current drop gesture.
*
- * @param dtde the DropTargetDragEvent
+ * @param dtde the {@code DropTargetDragEvent}
*/
void dropActionChanged(DropTargetDragEvent dtde);
@@ -100,52 +100,52 @@
/**
* Called while a drag operation is ongoing, when the mouse pointer has
* exited the operable part of the drop site for the
- * DropTarget registered with this listener.
+ * {@code DropTarget} registered with this listener.
*
- * @param dte the DropTargetEvent
+ * @param dte the {@code DropTargetEvent}
*/
void dragExit(DropTargetEvent dte);
/**
* Called when the drag operation has terminated with a drop on
- * the operable part of the drop site for the DropTarget
+ * the operable part of the drop site for the {@code DropTarget}
* registered with this listener.
* DropTargetDropEvent
- * provides a means to obtain a Transferable
+ * gesture. The {@code DropTargetDropEvent}
+ * provides a means to obtain a {@code Transferable}
* object that represents the data object(s) to
* be transferred.DropTargetListener
+ * From this method, the {@code DropTargetListener}
* shall accept or reject the drop via the
* acceptDrop(int dropAction) or rejectDrop() methods of the
- * DropTargetDropEvent parameter.
+ * {@code DropTargetDropEvent} parameter.
* DropTargetDropEvent's getTransferable()
+ * {@code DropTargetDropEvent}'s getTransferable()
* method may be invoked, and data transfer may be
- * performed via the returned Transferable's
+ * performed via the returned {@code Transferable}'s
* getTransferData() method.
* boolean to the DropTargetDropEvent's
+ * {@code boolean} to the {@code DropTargetDropEvent}'s
* dropComplete(boolean success) method.
* DropTargetDropEvent's dropComplete(boolean success) method.
+ * {@code DropTargetDropEvent}'s dropComplete(boolean success) method.
* After that, a call to the getTransferData() method of the
- * Transferable returned by
- * DropTargetDropEvent.getTransferable() is guaranteed to
+ * {@code Transferable} returned by
+ * {@code DropTargetDropEvent.getTransferable()} is guaranteed to
* succeed only if the data transfer is local; that is, only if
- * DropTargetDropEvent.isLocalTransfer() returns
- * true. Otherwise, the behavior of the call is
+ * {@code DropTargetDropEvent.isLocalTransfer()} returns
+ * {@code true}. Otherwise, the behavior of the call is
* implementation-dependent.
*
- * @param dtde the DropTargetDropEvent
+ * @param dtde the {@code DropTargetDropEvent}
*/
void drop(DropTargetDropEvent dtde);
--- old/src/java.desktop/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java 2015-10-04 22:53:22.485272407 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java 2015-10-04 22:53:22.297272415 +0400
@@ -32,8 +32,8 @@
import java.awt.event.MouseMotionListener;
/**
- * This abstract subclass of DragGestureRecognizer
- * defines a DragGestureRecognizer
+ * This abstract subclass of {@code DragGestureRecognizer}
+ * defines a {@code DragGestureRecognizer}
* for mouse-based gestures.
*
* Each platform implements its own concrete subclass of this class,
@@ -67,12 +67,12 @@
private static final long serialVersionUID = 6220099344182281120L;
/**
- * Construct a new MouseDragGestureRecognizer
- * given the DragSource for the
- * Component c, the Component
+ * Construct a new {@code MouseDragGestureRecognizer}
+ * given the {@code DragSource} for the
+ * {@code Component} c, the {@code Component}
* to observe, the action(s)
* permitted for this drag operation, and
- * the DragGestureListener to
+ * the {@code DragGestureListener} to
* notify when a drag gesture is detected.
*
* @param ds The DragSource for the Component c
@@ -87,10 +87,10 @@
}
/**
- * Construct a new MouseDragGestureRecognizer
- * given the DragSource for
- * the Component c,
- * the Component to observe, and the action(s)
+ * Construct a new {@code MouseDragGestureRecognizer}
+ * given the {@code DragSource} for
+ * the {@code Component} c,
+ * the {@code Component} to observe, and the action(s)
* permitted for this drag operation.
*
* @param ds The DragSource for the Component c
@@ -103,10 +103,10 @@
}
/**
- * Construct a new MouseDragGestureRecognizer
- * given the DragSource for the
- * Component c, and the
- * Component to observe.
+ * Construct a new {@code MouseDragGestureRecognizer}
+ * given the {@code DragSource} for the
+ * {@code Component} c, and the
+ * {@code Component} to observe.
*
* @param ds The DragSource for the Component c
* @param c The Component to observe
@@ -117,8 +117,8 @@
}
/**
- * Construct a new MouseDragGestureRecognizer
- * given the DragSource for the Component.
+ * Construct a new {@code MouseDragGestureRecognizer}
+ * given the {@code DragSource} for the {@code Component}.
*
* @param ds The DragSource for the Component
*/
@@ -151,16 +151,16 @@
/**
* Invoked when the mouse has been clicked on a component.
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
*/
public void mouseClicked(MouseEvent e) { }
/**
* Invoked when a mouse button has been
- * pressed on a Component.
+ * pressed on a {@code Component}.
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
*/
public void mousePressed(MouseEvent e) { }
@@ -168,7 +168,7 @@
/**
* Invoked when a mouse button has been released on a component.
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
*/
public void mouseReleased(MouseEvent e) { }
@@ -176,7 +176,7 @@
/**
* Invoked when the mouse enters a component.
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
*/
public void mouseEntered(MouseEvent e) { }
@@ -184,7 +184,7 @@
/**
* Invoked when the mouse exits a component.
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
*/
public void mouseExited(MouseEvent e) { }
@@ -192,7 +192,7 @@
/**
* Invoked when a mouse button is pressed on a component.
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
*/
public void mouseDragged(MouseEvent e) { }
@@ -201,7 +201,7 @@
* Invoked when the mouse button has been moved on a component
* (with no buttons no down).
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
*/
public void mouseMoved(MouseEvent e) { }
--- old/src/java.desktop/share/classes/java/awt/event/AWTEventListener.java 2015-10-04 22:53:23.009272383 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/AWTEventListener.java 2015-10-04 22:53:22.821272392 +0400
@@ -41,9 +41,9 @@
* The class that is interested in monitoring AWT events
* implements this interface, and the object created with that
* class is registered with the Toolkit, using the Toolkit's
- * addAWTEventListener method. When an event is
+ * {@code addAWTEventListener} method. When an event is
* dispatched anywhere in the AWT, that object's
- * eventDispatched method is invoked.
+ * {@code eventDispatched} method is invoked.
*
* @see java.awt.AWTEvent
* @see java.awt.Toolkit#addAWTEventListener
--- old/src/java.desktop/share/classes/java/awt/event/ActionEvent.java 2015-10-04 22:53:23.533272360 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ActionEvent.java 2015-10-04 22:53:23.345272368 +0400
@@ -32,17 +32,17 @@
/**
* A semantic event which indicates that a component-defined action occurred.
* This high-level event is generated by a component (such as a
- * Button) when
+ * {@code Button}) when
* the component-specific action occurs (such as being pressed).
- * The event is passed to every ActionListener object
+ * The event is passed to every {@code ActionListener} object
* that registered to receive such events using the component's
- * addActionListener method.
+ * {@code addActionListener} method.
* ActionEvent on a
- * Button using the keyboard, use the Space bar.
+ * Note: To invoke an {@code ActionEvent} on a
+ * {@code Button} using the keyboard, use the Space bar.
* ActionListener interface
- * gets this ActionEvent when the event occurs. The listener
+ * The object that implements the {@code ActionListener} interface
+ * gets this {@code ActionEvent} when the event occurs. The listener
* is therefore spared the details of processing individual mouse movements
* and mouse clicks, and can instead process a "meaningful" (semantic)
* event like "button pressed".
@@ -137,12 +137,12 @@
private static final long serialVersionUID = -7671078796273832149L;
/**
- * Constructs an ActionEvent object.
+ * Constructs an {@code ActionEvent} object.
* IllegalArgumentException if source
- * is null.
- * A null command string is legal,
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
+ * A {@code null command} string is legal,
* but not recommended.
*
* @param source The object that originated the event
@@ -151,7 +151,7 @@
* the class description for {@link ActionEvent}
* @param command A string that may specify a command (possibly one
* of several) associated with the event
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getActionCommand()
@@ -161,12 +161,12 @@
}
/**
- * Constructs an ActionEvent object with modifier keys.
+ * Constructs an {@code ActionEvent} object with modifier keys.
* IllegalArgumentException if source
- * is null.
- * A null command string is legal,
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
+ * A {@code null command} string is legal,
* but not recommended.
*
* @param source The object that originated the event
@@ -179,7 +179,7 @@
* (shift, ctrl, alt, meta).
* Passing negative parameter is not recommended.
* Zero value means that no modifiers were passed
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getActionCommand()
@@ -190,13 +190,13 @@
}
/**
- * Constructs an ActionEvent object with the specified
+ * Constructs an {@code ActionEvent} object with the specified
* modifier keys and timestamp.
* IllegalArgumentException if source
- * is null.
- * A null command string is legal,
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
+ * A {@code null command} string is legal,
* but not recommended.
*
* @param source The object that originated the event
@@ -212,7 +212,7 @@
* @param when A long that gives the time the event occurred.
* Passing negative or zero value
* is not recommended
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getActionCommand()
@@ -237,9 +237,9 @@
* and the event would be the same in each case, but the command string
* would identify the intended action.
* null command string was passed
- * to the constructor for this ActionEvent, this
- * this method returns null.
+ * Note that if a {@code null} command string was passed
+ * to the constructor for this {@code ActionEvent}, this
+ * this method returns {@code null}.
*
* @return the string identifying the command for this event
*/
--- old/src/java.desktop/share/classes/java/awt/event/ActionListener.java 2015-10-04 22:53:24.061272336 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ActionListener.java 2015-10-04 22:53:23.873272345 +0400
@@ -32,8 +32,8 @@
* The class that is interested in processing an action event
* implements this interface, and the object created with that
* class is registered with a component, using the component's
- * addActionListener method. When the action event
- * occurs, that object's actionPerformed method is
+ * {@code addActionListener} method. When the action event
+ * occurs, that object's {@code actionPerformed} method is
* invoked.
*
* @see ActionEvent
--- old/src/java.desktop/share/classes/java/awt/event/AdjustmentEvent.java 2015-10-04 22:53:24.585272313 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/AdjustmentEvent.java 2015-10-04 22:53:24.397272321 +0400
@@ -107,7 +107,7 @@
Adjustable adjustable;
/**
- * value will contain the new value of the
+ * {@code value} will contain the new value of the
* adjustable object. This value will always be in a
* range associated adjustable object.
*
@@ -117,7 +117,7 @@
int value;
/**
- * The adjustmentType describes how the adjustable
+ * The {@code adjustmentType} describes how the adjustable
* object value has changed.
* This value can be increased/decreased by a block or unit amount
* where the block is associated with page increments/decrements,
@@ -130,7 +130,7 @@
/**
- * The isAdjusting is true if the event is one
+ * The {@code isAdjusting} is true if the event is one
* of the series of multiple adjustment events.
*
* @since 1.4
@@ -147,14 +147,14 @@
/**
- * Constructs an AdjustmentEvent object with the
- * specified Adjustable source, event type,
+ * Constructs an {@code AdjustmentEvent} object with the
+ * specified {@code Adjustable} source, event type,
* adjustment type, and value.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Adjustable object where the
+ * @param source The {@code Adjustable} object where the
* event originated
* @param id An integer indicating the type of event.
* For information on allowable values, see
@@ -163,7 +163,7 @@
* For information on allowable values, see
* the class description for {@link AdjustmentEvent}
* @param value The current value of the adjustment
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getAdjustmentType()
@@ -174,13 +174,13 @@
}
/**
- * Constructs an AdjustmentEvent object with the
+ * Constructs an {@code AdjustmentEvent} object with the
* specified Adjustable source, event type, adjustment type, and value.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Adjustable object where the
+ * @param source The {@code Adjustable} object where the
* event originated
* @param id An integer indicating the type of event.
* For information on allowable values, see
@@ -189,10 +189,10 @@
* For information on allowable values, see
* the class description for {@link AdjustmentEvent}
* @param value The current value of the adjustment
- * @param isAdjusting A boolean that equals true if the event is one
+ * @param isAdjusting A boolean that equals {@code true} if the event is one
* of a series of multiple adjusting events,
- * otherwise false
- * @throws IllegalArgumentException if source is null
+ * otherwise {@code false}
+ * @throws IllegalArgumentException if {@code source} is null
* @since 1.4
* @see #getSource()
* @see #getID()
@@ -209,9 +209,9 @@
}
/**
- * Returns the Adjustable object where this event originated.
+ * Returns the {@code Adjustable} object where this event originated.
*
- * @return the Adjustable object where this event originated
+ * @return the {@code Adjustable} object where this event originated
*/
public Adjustable getAdjustable() {
return adjustable;
@@ -243,11 +243,11 @@
}
/**
- * Returns true if this is one of multiple
+ * Returns {@code true} if this is one of multiple
* adjustment events.
*
- * @return true if this is one of multiple
- * adjustment events, otherwise returns false
+ * @return {@code true} if this is one of multiple
+ * adjustment events, otherwise returns {@code false}
* @since 1.4
*/
public boolean getValueIsAdjusting() {
--- old/src/java.desktop/share/classes/java/awt/event/ComponentAdapter.java 2015-10-04 22:53:25.109272289 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ComponentAdapter.java 2015-10-04 22:53:24.921272297 +0400
@@ -30,17 +30,17 @@
* The methods in this class are empty. This class exists as
* convenience for creating listener objects.
* ComponentEvent listener
+ * Extend this class to create a {@code ComponentEvent} listener
* and override the methods for the events of interest. (If you implement the
- * ComponentListener interface, you have to define all of
+ * {@code ComponentListener} interface, you have to define all of
* the methods in it. This abstract class defines null methods for them
* all, so you can only have to define methods for events you care about.)
* addComponentListener
+ * component using the component's {@code addComponentListener}
* method. When the component's size, location, or visibility
* changes, the relevant method in the listener object is invoked,
- * and the ComponentEvent is passed to it.
+ * and the {@code ComponentEvent} is passed to it.
*
* @see ComponentEvent
* @see ComponentListener
--- old/src/java.desktop/share/classes/java/awt/event/ComponentEvent.java 2015-10-04 22:53:25.629272266 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ComponentEvent.java 2015-10-04 22:53:25.441272274 +0400
@@ -47,12 +47,12 @@
* ComponentListener
- * or ComponentAdapter object which registered to receive such
- * events using the component's addComponentListener method.
- * (ComponentAdapter objects implement the
- * ComponentListener interface.) Each such listener object
- * gets this ComponentEvent when the event occurs.
+ * visible again. The event is passed to every {@code ComponentListener}
+ * or {@code ComponentAdapter} object which registered to receive such
+ * events using the component's {@code addComponentListener} method.
+ * ({@code ComponentAdapter} objects implement the
+ * {@code ComponentListener} interface.) Each such listener object
+ * gets this {@code ComponentEvent} when the event occurs.
* ComponentEvent object.
+ * Constructs a {@code ComponentEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link ComponentEvent}
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getComponent()
* @see #getID()
*/
@@ -123,9 +123,9 @@
/**
* Returns the originator of the event.
*
- * @return the Component object that originated
- * the event, or null if the object is not a
- * Component.
+ * @return the {@code Component} object that originated
+ * the event, or {@code null} if the object is not a
+ * {@code Component}.
*/
public Component getComponent() {
return (source instanceof Component) ? (Component)source : null;
--- old/src/java.desktop/share/classes/java/awt/event/ComponentListener.java 2015-10-04 22:53:26.157272242 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ComponentListener.java 2015-10-04 22:53:25.969272250 +0400
@@ -31,18 +31,18 @@
* The listener interface for receiving component events.
* The class that is interested in processing a component event
* either implements this interface (and all the methods it
- * contains) or extends the abstract ComponentAdapter class
+ * contains) or extends the abstract {@code ComponentAdapter} class
* (overriding only the methods of interest).
* The listener object created from that class is then registered with a
- * component using the component's addComponentListener
+ * component using the component's {@code addComponentListener}
* method. When the component's size, location, or visibility
* changes, the relevant method in the listener object is invoked,
- * and the ComponentEvent is passed to it.
+ * and the {@code ComponentEvent} is passed to it.
* ComponentListener or not.
+ * whether a program registers a {@code ComponentListener} or not.
*
* @see ComponentAdapter
* @see ComponentEvent
--- old/src/java.desktop/share/classes/java/awt/event/ContainerAdapter.java 2015-10-04 22:53:26.681272218 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ContainerAdapter.java 2015-10-04 22:53:26.493272227 +0400
@@ -30,17 +30,17 @@
* The methods in this class are empty. This class exists as
* convenience for creating listener objects.
* ContainerEvent listener
+ * Extend this class to create a {@code ContainerEvent} listener
* and override the methods for the events of interest. (If you implement the
- * ContainerListener interface, you have to define all of
+ * {@code ContainerListener} interface, you have to define all of
* the methods in it. This abstract class defines null methods for them
* all, so you can only have to define methods for events you care about.)
* addContainerListener
+ * a component using the component's {@code addContainerListener}
* method. When the container's contents change because a component has
* been added or removed, the relevant method in the listener object is invoked,
- * and the ContainerEvent is passed to it.
+ * and the {@code ContainerEvent} is passed to it.
*
* @see ContainerEvent
* @see ContainerListener
--- old/src/java.desktop/share/classes/java/awt/event/ContainerEvent.java 2015-10-04 22:53:27.205272195 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ContainerEvent.java 2015-10-04 22:53:27.013272204 +0400
@@ -39,12 +39,12 @@
* ContainerListener
- * or ContainerAdapter object which registered to receive such
- * events using the component's addContainerListener method.
- * (ContainerAdapter objects implement the
- * ContainerListener interface.) Each such listener object
- * gets this ContainerEvent when the event occurs.
+ * The event is passed to every {@code ContainerListener}
+ * or {@code ContainerAdapter} object which registered to receive such
+ * events using the component's {@code addContainerListener} method.
+ * ({@code ContainerAdapter} objects implement the
+ * {@code ContainerListener} interface.) Each such listener object
+ * gets this {@code ContainerEvent} when the event occurs.
* ContainerEvent object.
+ * Constructs a {@code ContainerEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component object (container)
+ * @param source The {@code Component} object (container)
* that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link ContainerEvent}
* @param child the component that was added or removed
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getContainer()
* @see #getID()
* @see #getChild()
@@ -119,9 +119,9 @@
/**
* Returns the originator of the event.
*
- * @return the Container object that originated
- * the event, or null if the object is not a
- * Container.
+ * @return the {@code Container} object that originated
+ * the event, or {@code null} if the object is not a
+ * {@code Container}.
*/
public Container getContainer() {
return (source instanceof Container) ? (Container)source : null;
--- old/src/java.desktop/share/classes/java/awt/event/ContainerListener.java 2015-10-04 22:53:27.725272172 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ContainerListener.java 2015-10-04 22:53:27.537272180 +0400
@@ -31,13 +31,13 @@
* The listener interface for receiving container events.
* The class that is interested in processing a container event
* either implements this interface (and all the methods it
- * contains) or extends the abstract ContainerAdapter class
+ * contains) or extends the abstract {@code ContainerAdapter} class
* (overriding only the methods of interest).
* The listener object created from that class is then registered with a
- * component using the component's addContainerListener
+ * component using the component's {@code addContainerListener}
* method. When the container's contents change because a component
* has been added or removed, the relevant method in the listener object
- * is invoked, and the ContainerEvent is passed to it.
+ * is invoked, and the {@code ContainerEvent} is passed to it.
* FocusEvent listener
+ * Extend this class to create a {@code FocusEvent} listener
* and override the methods for the events of interest. (If you implement the
- * FocusListener interface, you have to define all of
+ * {@code FocusListener} interface, you have to define all of
* the methods in it. This abstract class defines null methods for them
* all, so you can only have to define methods for events you care about.)
* addFocusListener
+ * a component using the component's {@code addFocusListener}
* method. When the component gains or loses the keyboard focus,
* the relevant method in the listener object is invoked,
- * and the FocusEvent is passed to it.
+ * and the {@code FocusEvent} is passed to it.
*
* @see FocusEvent
* @see FocusListener
--- old/src/java.desktop/share/classes/java/awt/event/FocusEvent.java 2015-10-04 22:53:28.773272124 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/FocusEvent.java 2015-10-04 22:53:28.585272133 +0400
@@ -32,11 +32,11 @@
/**
* A low-level event which indicates that a Component has gained or lost the
* input focus. This low-level event is generated by a Component (such as a
- * TextField). The event is passed to every FocusListener or
- * FocusAdapter object which registered to receive such events
- * using the Component's addFocusListener method. (
- * FocusAdapter objects implement the FocusListener
- * interface.) Each such listener object gets this FocusEvent when
+ * TextField). The event is passed to every {@code FocusListener} or
+ * {@code FocusAdapter} object which registered to receive such events
+ * using the Component's {@code addFocusListener} method.
+ * ({@code FocusAdapter} objects implement the {@code FocusListener}
+ * interface.) Each such listener object gets this {@code FocusEvent} when
* the event occurs.
* FocusEvent object with the
- * specified temporary state and opposite Component.
- * The opposite Component is the other
- * Component involved in this focus change.
- * For a FOCUS_GAINED event, this is the
- * Component that lost focus. For a
- * FOCUS_LOST event, this is the Component
+ * Constructs a {@code FocusEvent} object with the
+ * specified temporary state and opposite {@code Component}.
+ * The opposite {@code Component} is the other
+ * {@code Component} involved in this focus change.
+ * For a {@code FOCUS_GAINED} event, this is the
+ * {@code Component} that lost focus. For a
+ * {@code FOCUS_LOST} event, this is the {@code Component}
* that gained focus. If this focus change occurs with a native
* application, with a Java application in a different VM,
- * or with no other Component, then the opposite
- * Component is null.
+ * or with no other {@code Component}, then the opposite
+ * {@code Component} is {@code null}.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link FocusEvent}
- * @param temporary Equals true if the focus change is temporary;
- * false otherwise
+ * @param temporary Equals {@code true} if the focus change is temporary;
+ * {@code false} otherwise
* @param opposite The other Component involved in the focus change,
- * or null
- * @throws IllegalArgumentException if source equals {@code null}
+ * or {@code null}
+ * @throws IllegalArgumentException if {@code source} equals {@code null}
* @see #getSource()
* @see #getID()
* @see #isTemporary()
@@ -152,19 +152,19 @@
}
/**
- * Constructs a FocusEvent object and identifies
+ * Constructs a {@code FocusEvent} object and identifies
* whether or not the change is temporary.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link FocusEvent}
- * @param temporary Equals true if the focus change is temporary;
- * false otherwise
- * @throws IllegalArgumentException if source equals {@code null}
+ * @param temporary Equals {@code true} if the focus change is temporary;
+ * {@code false} otherwise
+ * @throws IllegalArgumentException if {@code source} equals {@code null}
* @see #getSource()
* @see #getID()
* @see #isTemporary()
@@ -174,17 +174,17 @@
}
/**
- * Constructs a FocusEvent object and identifies it
+ * Constructs a {@code FocusEvent} object and identifies it
* as a permanent change in focus.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link FocusEvent}
- * @throws IllegalArgumentException if source equals {@code null}
+ * @throws IllegalArgumentException if {@code source} equals {@code null}
* @see #getSource()
* @see #getID()
*/
@@ -195,8 +195,8 @@
/**
* Identifies the focus change event as temporary or permanent.
*
- * @return true if the focus change is temporary;
- * false otherwise
+ * @return {@code true} if the focus change is temporary;
+ * {@code false} otherwise
*/
public boolean isTemporary() {
return temporary;
--- old/src/java.desktop/share/classes/java/awt/event/FocusListener.java 2015-10-04 22:53:29.301272101 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/FocusListener.java 2015-10-04 22:53:29.109272109 +0400
@@ -32,13 +32,13 @@
* a component.
* The class that is interested in processing a focus event
* either implements this interface (and all the methods it
- * contains) or extends the abstract FocusAdapter class
+ * contains) or extends the abstract {@code FocusAdapter} class
* (overriding only the methods of interest).
* The listener object created from that class is then registered with a
- * component using the component's addFocusListener
+ * component using the component's {@code addFocusListener}
* method. When the component gains or loses the keyboard focus,
* the relevant method in the listener object
- * is invoked, and the FocusEvent is passed to it.
+ * is invoked, and the {@code FocusEvent} is passed to it.
*
* @see FocusAdapter
* @see FocusEvent
--- old/src/java.desktop/share/classes/java/awt/event/HierarchyBoundsAdapter.java 2015-10-04 22:53:29.821272077 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyBoundsAdapter.java 2015-10-04 22:53:29.633272086 +0400
@@ -31,16 +31,16 @@
* convenience for creating listener objects.
* HierarchyBoundsListener interface, you have
+ * you implement the {@code HierarchyBoundsListener} interface, you have
* to define both methods in it. This abstract class defines null methods for
* them both, so you only have to define the method for the event you care
* about.)
* addHierarchyBoundsListener
+ * Component using the Component's {@code addHierarchyBoundsListener}
* method. When the hierarchy to which the Component belongs changes by
* resize or movement of an ancestor, the relevant method in the listener
- * object is invoked, and the HierarchyEvent is passed to it.
+ * object is invoked, and the {@code HierarchyEvent} is passed to it.
*
* @author David Mendenhall
* @see HierarchyBoundsListener
--- old/src/java.desktop/share/classes/java/awt/event/HierarchyBoundsListener.java 2015-10-04 22:53:30.345272054 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyBoundsListener.java 2015-10-04 22:53:30.157272062 +0400
@@ -31,18 +31,18 @@
* The listener interface for receiving ancestor moved and resized events.
* The class that is interested in processing these events either implements
* this interface (and all the methods it contains) or extends the abstract
- * HierarchyBoundsAdapter class (overriding only the method of
+ * {@code HierarchyBoundsAdapter} class (overriding only the method of
* interest).
* The listener object created from that class is then registered with a
- * Component using the Component's addHierarchyBoundsListener
+ * Component using the Component's {@code addHierarchyBoundsListener}
* method. When the hierarchy to which the Component belongs changes by
* the resizing or movement of an ancestor, the relevant method in the listener
- * object is invoked, and the HierarchyEvent is passed to it.
+ * object is invoked, and the {@code HierarchyEvent} is passed to it.
* HierarchyBoundsListener or not.
+ * program registers an {@code HierarchyBoundsListener} or not.
*
* @author David Mendenhall
* @see HierarchyBoundsAdapter
--- old/src/java.desktop/share/classes/java/awt/event/HierarchyEvent.java 2015-10-04 22:53:30.869272030 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyEvent.java 2015-10-04 22:53:30.677272039 +0400
@@ -30,8 +30,8 @@
import java.awt.Container;
/**
- * An event which indicates a change to the Component
- * hierarchy to which Component belongs.
+ * An event which indicates a change to the {@code Component}
+ * hierarchy to which {@code Component} belongs.
*
*
- * @throws IllegalArgumentException if {@code button} is less then zero
+ * @throws IllegalArgumentException if {@code button} is less than zero
* @throws IllegalArgumentException if {@code source} is null
- * @throws IllegalArgumentException if {@code button} is greater then BUTTON3 and the support for extended mouse buttons is
+ * @throws IllegalArgumentException if {@code button} is greater than BUTTON3 and the support for extended mouse buttons is
* {@link Toolkit#areExtraMouseButtonsEnabled() disabled} by Java
- * @throws IllegalArgumentException if {@code button} is greater then the
+ * @throws IllegalArgumentException if {@code button} is greater than the
* {@link java.awt.MouseInfo#getNumberOfButtons() current number of buttons} and the support
* for extended mouse buttons is {@link Toolkit#areExtraMouseButtonsEnabled() enabled}
* by Java
@@ -703,9 +703,9 @@
*
* @throws IllegalArgumentException if {@code button} is less then zero
* @throws IllegalArgumentException if {@code source} is null
- * @throws IllegalArgumentException if {@code button} is greater then BUTTON3 and the support for extended mouse buttons is
+ * @throws IllegalArgumentException if {@code button} is greater than BUTTON3 and the support for extended mouse buttons is
* {@link Toolkit#areExtraMouseButtonsEnabled() disabled} by Java
- * @throws IllegalArgumentException if {@code button} is greater then the
+ * @throws IllegalArgumentException if {@code button} is greater than the
* {@link java.awt.MouseInfo#getNumberOfButtons() current number of buttons} and the support
* for extended mouse buttons is {@link Toolkit#areExtraMouseButtonsEnabled() enabled}
* by Java
@@ -865,7 +865,7 @@
*
@@ -57,18 +57,18 @@
* This event is generated by a Container object (such as a Panel) when the
* Container is added, removed, moved, or resized, and passed down the
* hierarchy. It is also generated by a Component object when that object's
- *
addNotify, removeNotify, show, or
- * hide method is called. The {@code ANCESTOR_MOVED} and
+ * {@code addNotify}, {@code removeNotify}, {@code show}, or
+ * {@code hide} method is called. The {@code ANCESTOR_MOVED} and
* {@code ANCESTOR_RESIZED}
- * events are dispatched to every HierarchyBoundsListener or
- * HierarchyBoundsAdapter object which registered to receive
- * such events using the Component's addHierarchyBoundsListener
- * method. (HierarchyBoundsAdapter objects implement the
- * HierarchyBoundsListener interface.) The {@code HIERARCHY_CHANGED} events are
- * dispatched to every HierarchyListener object which registered
- * to receive such events using the Component's addHierarchyListener
- * method. Each such listener object gets this HierarchyEvent
- * when the event occurs.
+ * events are dispatched to every {@code HierarchyBoundsListener} or
+ * {@code HierarchyBoundsAdapter} object which registered to receive
+ * such events using the Component's {@code addHierarchyBoundsListener}
+ * method. ({@code HierarchyBoundsAdapter} objects implement the
+ * {@code HierarchyBoundsListener} interface.) The {@code HIERARCHY_CHANGED} events are
+ * dispatched to every {@code HierarchyListener} object which registered
+ * to receive such events using the Component's {@code addHierarchyListener}
+ * method. Each such listener object gets this {@code HierarchyEvent}
+ * when the event occurs.
* HIERARCHY_CHANGED event
+ * A change flag indicates that the {@code HIERARCHY_CHANGED} event
* was generated by a reparenting operation.
*/
public static final int PARENT_CHANGED = 0x1;
/**
- * A change flag indicates that the HIERARCHY_CHANGED event
+ * A change flag indicates that the {@code HIERARCHY_CHANGED} event
* was generated due to the changing of the hierarchy displayability.
* To discern the
* current displayability of the hierarchy, call the
- * Component.isDisplayable method. Displayability changes occur
+ * {@code Component.isDisplayable} method. Displayability changes occur
* in response to explicit or implicit calls of the
- * Component.addNotify and
- * Component.removeNotify methods.
+ * {@code Component.addNotify} and
+ * {@code Component.removeNotify} methods.
*
* @see java.awt.Component#isDisplayable()
* @see java.awt.Component#addNotify()
@@ -144,15 +144,15 @@
public static final int DISPLAYABILITY_CHANGED = 0x2;
/**
- * A change flag indicates that the HIERARCHY_CHANGED event
+ * A change flag indicates that the {@code HIERARCHY_CHANGED} event
* was generated due to the changing of the hierarchy showing state.
* To discern the
* current showing state of the hierarchy, call the
- * Component.isShowing method. Showing state changes occur
+ * {@code Component.isShowing} method. Showing state changes occur
* when either the displayability or visibility of the
* hierarchy occurs. Visibility changes occur in response to explicit
- * or implicit calls of the Component.show and
- * Component.hide methods.
+ * or implicit calls of the {@code Component.show} and
+ * {@code Component.hide} methods.
*
* @see java.awt.Component#isShowing()
* @see java.awt.Component#addNotify()
@@ -167,24 +167,24 @@
long changeFlags;
/**
- * Constructs an HierarchyEvent object to identify a
- * change in the Component hierarchy.
+ * Constructs an {@code HierarchyEvent} object to identify a
+ * change in the {@code Component} hierarchy.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component object that
+ * @param source The {@code Component} object that
* originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link HierarchyEvent}
- * @param changed The Component at the top of
+ * @param changed The {@code Component} at the top of
* the hierarchy which was changed
- * @param changedParent The parent of the changed component.
+ * @param changedParent The parent of the {@code changed} component.
* This
* may be the parent before or after the
* change, depending on the type of change
- * @throws IllegalArgumentException if source is {@code null}
+ * @throws IllegalArgumentException if {@code source} is {@code null}
* @see #getSource()
* @see #getID()
* @see #getChanged()
@@ -198,29 +198,29 @@
}
/**
- * Constructs an HierarchyEvent object to identify
- * a change in the Component hierarchy.
+ * Constructs an {@code HierarchyEvent} object to identify
+ * a change in the {@code Component} hierarchy.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component object that
+ * @param source The {@code Component} object that
* originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link HierarchyEvent}
- * @param changed The Component at the top
+ * @param changed The {@code Component} at the top
* of the hierarchy which was changed
- * @param changedParent The parent of the changed component.
+ * @param changedParent The parent of the {@code changed} component.
* This
* may be the parent before or after the
* change, depending on the type of change
* @param changeFlags A bitmask which indicates the type(s) of
- * the HIERARCHY_CHANGED events
+ * the {@code HIERARCHY_CHANGED} events
* represented in this event object.
* For information on allowable values, see
* the class description for {@link HierarchyEvent}
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getChanged()
@@ -238,9 +238,9 @@
/**
* Returns the originator of the event.
*
- * @return the Component object that originated
- * the event, or null if the object is not a
- * Component.
+ * @return the {@code Component} object that originated
+ * the event, or {@code null} if the object is not a
+ * {@code Component}.
*/
public Component getComponent() {
return (source instanceof Component) ? (Component)source : null;
@@ -257,13 +257,13 @@
}
/**
- * Returns the parent of the Component returned by
- * getChanged(). For a HIERARCHY_CHANGED event where the
- * change was of type PARENT_CHANGED via a call to
- * Container.add, the parent returned is the parent
+ * Returns the parent of the Component returned by
+ * {@code getChanged()}. For a HIERARCHY_CHANGED event where the
+ * change was of type PARENT_CHANGED via a call to
+ * {@code Container.add}, the parent returned is the parent
* after the add operation. For a HIERARCHY_CHANGED event where
- * the change was of type PARENT_CHANGED via a call to
- * Container.remove, the parent returned is the parent
+ * the change was of type PARENT_CHANGED via a call to
+ * {@code Container.remove}, the parent returned is the parent
* before the remove operation. For all other events and types,
* the parent returned is the parent during the operation.
*
--- old/src/java.desktop/share/classes/java/awt/event/HierarchyListener.java 2015-10-04 22:53:31.397272007 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyListener.java 2015-10-04 22:53:31.209272015 +0400
@@ -32,15 +32,15 @@
* The class that is interested in processing a hierarchy changed event
* should implement this interface.
* The listener object created from that class is then registered with a
- * Component using the Component's addHierarchyListener
+ * Component using the Component's {@code addHierarchyListener}
* method. When the hierarchy to which the Component belongs changes, the
- * hierarchyChanged method in the listener object is invoked,
- * and the HierarchyEvent is passed to it.
+ * {@code hierarchyChanged} method in the listener object is invoked,
+ * and the {@code HierarchyEvent} is passed to it.
* HierarchyListener or not.
+ * of whether a program registers a {@code HierarchyListener} or not.
*
* @author David Mendenhall
* @see HierarchyEvent
@@ -49,7 +49,7 @@
public interface HierarchyListener extends EventListener {
/**
* Called when the hierarchy has been changed. To discern the actual
- * type of change, call HierarchyEvent.getChangeFlags().
+ * type of change, call {@code HierarchyEvent.getChangeFlags()}.
*
* @param e the event to be processed
* @see HierarchyEvent#getChangeFlags()
--- old/src/java.desktop/share/classes/java/awt/event/InputEvent.java 2015-10-04 22:53:31.921271983 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/InputEvent.java 2015-10-04 22:53:31.729271992 +0400
@@ -315,8 +315,8 @@
* Constructs an InputEvent object with the specified source component,
* modifiers, and type.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
* @param source the object where the event originated
* @param id the integer that identifies the event type.
@@ -336,7 +336,7 @@
* Passing negative parameter
* is not recommended.
* Zero value means that no modifiers were passed
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getWhen()
@@ -442,16 +442,16 @@
* button 2, and then releases them in the same order,
* the following sequence of events is generated:
*
- *
* MOUSE_PRESSED: BUTTON1_DOWN_MASK
- * MOUSE_PRESSED: BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK
- * MOUSE_RELEASED: BUTTON2_DOWN_MASK
- * MOUSE_CLICKED: BUTTON2_DOWN_MASK
- * MOUSE_RELEASED:
- * MOUSE_CLICKED:
+ * {@code MOUSE_PRESSED}: {@code BUTTON1_DOWN_MASK}
+ * {@code MOUSE_PRESSED}: {@code BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK}
+ * {@code MOUSE_RELEASED}: {@code BUTTON2_DOWN_MASK}
+ * {@code MOUSE_CLICKED}: {@code BUTTON2_DOWN_MASK}
+ * {@code MOUSE_RELEASED}:
+ * {@code MOUSE_CLICKED}:
* == because new modifiers can be added in the future.
+ * using {@code ==} because new modifiers can be added in the future.
* For example, the appropriate way to check that SHIFT and BUTTON1 are
* down, but CTRL is up is demonstrated by the following code:
*
@@ -494,7 +494,7 @@
* Returns a String describing the extended modifier keys and
* mouse buttons, such as "Shift", "Button1", or "Ctrl+Shift".
* These strings can be localized by changing the
- * awt.properties file.
+ * {@code awt.properties} file.
* InputMethodEvent with the specified
+ * Constructs an {@code InputMethodEvent} with the specified
* source component, type, time, text, caret, and visiblePosition.
* text
- * if this is an INPUT_METHOD_TEXT_CHANGED event,
- * the composed text within the text of the
- * preceding INPUT_METHOD_TEXT_CHANGED event otherwise.
- * id results in
+ * composed text; that is, the composed text within {@code text}
+ * if this is an {@code INPUT_METHOD_TEXT_CHANGED} event,
+ * the composed text within the {@code text} of the
+ * preceding {@code INPUT_METHOD_TEXT_CHANGED} event otherwise.
+ * IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
* @param source the object where the event originated
* @param id the event type
* @param when a long integer that specifies the time the event occurred
* @param text the combined committed and composed text,
- * committed text first; must be null
- * when the event type is CARET_POSITION_CHANGED;
- * may be null for
- * INPUT_METHOD_TEXT_CHANGED if there's no
+ * committed text first; must be {@code null}
+ * when the event type is {@code CARET_POSITION_CHANGED};
+ * may be {@code null} for
+ * {@code INPUT_METHOD_TEXT_CHANGED} if there's no
* committed or composed text
* @param committedCharacterCount the number of committed
* characters in the text
* @param caret the caret (a.k.a. insertion point);
- * null if there's no caret within current
+ * {@code null} if there's no caret within current
* composed text
* @param visiblePosition the position that's most important
- * to be visible; null if there's no
+ * to be visible; {@code null} if there's no
* recommendation for a visible position within current
* composed text
- * @throws IllegalArgumentException if id is not
+ * @throws IllegalArgumentException if {@code id} is not
* in the range
- * INPUT_METHOD_FIRST..INPUT_METHOD_LAST;
- * or if id is CARET_POSITION_CHANGED and
- * text is not null;
- * or if committedCharacterCount is not in the range
- * 0..(text.getEndIndex() - text.getBeginIndex())
- * @throws IllegalArgumentException if source is null
+ * {@code INPUT_METHOD_FIRST}..{@code INPUT_METHOD_LAST};
+ * or if id is {@code CARET_POSITION_CHANGED} and
+ * {@code text} is not {@code null};
+ * or if {@code committedCharacterCount} is not in the range
+ * {@code 0}..{@code (text.getEndIndex() - text.getBeginIndex())}
+ * @throws IllegalArgumentException if {@code source} is null
*
* @since 1.4
*/
@@ -177,46 +177,46 @@
}
/**
- * Constructs an InputMethodEvent with the specified
+ * Constructs an {@code InputMethodEvent} with the specified
* source component, type, text, caret, and visiblePosition.
* text
- * if this is an INPUT_METHOD_TEXT_CHANGED event,
- * the composed text within the text of the
- * preceding INPUT_METHOD_TEXT_CHANGED event otherwise.
+ * composed text; that is, the composed text within {@code text}
+ * if this is an {@code INPUT_METHOD_TEXT_CHANGED} event,
+ * the composed text within the {@code text} of the
+ * preceding {@code INPUT_METHOD_TEXT_CHANGED} event otherwise.
* The time stamp for this event is initialized by invoking
* {@link java.awt.EventQueue#getMostRecentEventTime()}.
- * id results in
+ * IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
* @param source the object where the event originated
* @param id the event type
* @param text the combined committed and composed text,
- * committed text first; must be null
- * when the event type is CARET_POSITION_CHANGED;
- * may be null for
- * INPUT_METHOD_TEXT_CHANGED if there's no
+ * committed text first; must be {@code null}
+ * when the event type is {@code CARET_POSITION_CHANGED};
+ * may be {@code null} for
+ * {@code INPUT_METHOD_TEXT_CHANGED} if there's no
* committed or composed text
* @param committedCharacterCount the number of committed
* characters in the text
* @param caret the caret (a.k.a. insertion point);
- * null if there's no caret within current
+ * {@code null} if there's no caret within current
* composed text
* @param visiblePosition the position that's most important
- * to be visible; null if there's no
+ * to be visible; {@code null} if there's no
* recommendation for a visible position within current
* composed text
- * @throws IllegalArgumentException if id is not
+ * @throws IllegalArgumentException if {@code id} is not
* in the range
- * INPUT_METHOD_FIRST..INPUT_METHOD_LAST;
- * or if id is CARET_POSITION_CHANGED and
- * text is not null;
- * or if committedCharacterCount is not in the range
- * 0..(text.getEndIndex() - text.getBeginIndex())
- * @throws IllegalArgumentException if source is null
+ * {@code INPUT_METHOD_FIRST}..{@code INPUT_METHOD_LAST};
+ * or if id is {@code CARET_POSITION_CHANGED} and
+ * {@code text} is not {@code null};
+ * or if {@code committedCharacterCount} is not in the range
+ * {@code 0}..{@code (text.getEndIndex() - text.getBeginIndex())}
+ * @throws IllegalArgumentException if {@code source} is null
*/
public InputMethodEvent(Component source, int id,
AttributedCharacterIterator text, int committedCharacterCount,
@@ -228,39 +228,39 @@
}
/**
- * Constructs an InputMethodEvent with the
+ * Constructs an {@code InputMethodEvent} with the
* specified source component, type, caret, and visiblePosition.
- * The text is set to null,
- * committedCharacterCount to 0.
+ * The text is set to {@code null},
+ * {@code committedCharacterCount} to 0.
* caret and visiblePosition
+ * The offsets of {@code caret} and {@code visiblePosition}
* are relative to the current composed text; that is,
- * the composed text within the text of the
- * preceding INPUT_METHOD_TEXT_CHANGED event if the
- * event being constructed as a CARET_POSITION_CHANGED event.
- * For an INPUT_METHOD_TEXT_CHANGED event without text,
- * caret and visiblePosition must be
- * null.
+ * the composed text within the {@code text} of the
+ * preceding {@code INPUT_METHOD_TEXT_CHANGED} event if the
+ * event being constructed as a {@code CARET_POSITION_CHANGED} event.
+ * For an {@code INPUT_METHOD_TEXT_CHANGED} event without text,
+ * {@code caret} and {@code visiblePosition} must be
+ * {@code null}.
* The time stamp for this event is initialized by invoking
* {@link java.awt.EventQueue#getMostRecentEventTime()}.
- * id results in
+ * IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
* @param source the object where the event originated
* @param id the event type
* @param caret the caret (a.k.a. insertion point);
- * null if there's no caret within current
+ * {@code null} if there's no caret within current
* composed text
* @param visiblePosition the position that's most important
- * to be visible; null if there's no
+ * to be visible; {@code null} if there's no
* recommendation for a visible position within current
* composed text
- * @throws IllegalArgumentException if id is not
+ * @throws IllegalArgumentException if {@code id} is not
* in the range
- * INPUT_METHOD_FIRST..INPUT_METHOD_LAST
- * @throws IllegalArgumentException if source is null
+ * {@code INPUT_METHOD_FIRST}..{@code INPUT_METHOD_LAST}
+ * @throws IllegalArgumentException if {@code source} is null
*/
public InputMethodEvent(Component source, int id, TextHitInfo caret,
TextHitInfo visiblePosition) {
@@ -271,7 +271,7 @@
/**
* Gets the combined committed and composed text.
- * Characters from index 0 to index getCommittedCharacterCount() - 1 are committed
+ * Characters from index 0 to index {@code getCommittedCharacterCount() - 1} are committed
* text, the remaining characters are composed text.
*
* @return the text.
@@ -295,9 +295,9 @@
* INPUT_METHOD_TEXT_CHANGED event,
+ * if this is an {@code INPUT_METHOD_TEXT_CHANGED} event,
* the composed text within getText() of the
- * preceding INPUT_METHOD_TEXT_CHANGED event otherwise.
+ * preceding {@code INPUT_METHOD_TEXT_CHANGED} event otherwise.
*
* @return the caret (a.k.a. insertion point).
* Null if there's no caret within current composed text.
@@ -311,9 +311,9 @@
* INPUT_METHOD_TEXT_CHANGED event,
+ * if this is an {@code INPUT_METHOD_TEXT_CHANGED} event,
* the composed text within getText() of the
- * preceding INPUT_METHOD_TEXT_CHANGED event otherwise.
+ * preceding {@code INPUT_METHOD_TEXT_CHANGED} event otherwise.
*
* @return the position that's most important to be visible.
* Null if there's no recommendation for a visible position within current composed text.
@@ -411,7 +411,7 @@
}
/**
- * Initializes the when field if it is not present in the
+ * Initializes the {@code when} field if it is not present in the
* object input stream. In that case, the field will be initialized by
* invoking {@link java.awt.EventQueue#getMostRecentEventTime()}.
*/
--- old/src/java.desktop/share/classes/java/awt/event/ItemEvent.java 2015-10-04 22:53:32.993271935 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ItemEvent.java 2015-10-04 22:53:32.801271944 +0400
@@ -32,12 +32,12 @@
* A semantic event which indicates that an item was selected or deselected.
* This high-level event is generated by an ItemSelectable object (such as a
* List) when an item is selected or deselected by the user.
- * The event is passed to every ItemListener object which
+ * The event is passed to every {@code ItemListener} object which
* registered to receive such events using the component's
- * addItemListener method.
+ * {@code addItemListener} method.
* ItemListener interface gets
- * this ItemEvent when the event occurs. The listener is
+ * The object that implements the {@code ItemListener} interface gets
+ * this {@code ItemEvent} when the event occurs. The listener is
* spared the details of processing individual mouse movements and mouse
* clicks, and can instead process a "meaningful" (semantic) event like
* "item selected" or "item deselected".
@@ -98,7 +98,7 @@
Object item;
/**
- * stateChange indicates whether the item
+ * {@code stateChange} indicates whether the {@code item}
* was selected or deselected.
*
* @serial
@@ -112,12 +112,12 @@
private static final long serialVersionUID = -608708132447206933L;
/**
- * Constructs an ItemEvent object.
+ * Constructs an {@code ItemEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The ItemSelectable object
+ * @param source The {@code ItemSelectable} object
* that originated the event
* @param id The integer that identifies the event type.
* For information on allowable values, see
@@ -127,7 +127,7 @@
* selected or deselected.
* For information on allowable values, see
* the class description for {@link ItemEvent}
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getItemSelectable()
* @see #getID()
* @see #getStateChange()
--- old/src/java.desktop/share/classes/java/awt/event/ItemListener.java 2015-10-04 22:53:33.517271911 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ItemListener.java 2015-10-04 22:53:33.325271920 +0400
@@ -32,9 +32,9 @@
* The class that is interested in processing an item event
* implements this interface. The object created with that
* class is then registered with a component using the
- * component's addItemListener method. When an
+ * component's {@code addItemListener} method. When an
* item-selection event occurs, the listener object's
- * itemStateChanged method is invoked.
+ * {@code itemStateChanged} method is invoked.
*
* @author Amy Fowler
*
--- old/src/java.desktop/share/classes/java/awt/event/KeyAdapter.java 2015-10-04 22:53:34.041271888 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/KeyAdapter.java 2015-10-04 22:53:33.849271897 +0400
@@ -30,17 +30,17 @@
* The methods in this class are empty. This class exists as
* convenience for creating listener objects.
* KeyEvent listener
+ * Extend this class to create a {@code KeyEvent} listener
* and override the methods for the events of interest. (If you implement the
- * KeyListener interface, you have to define all of
+ * {@code KeyListener} interface, you have to define all of
* the methods in it. This abstract class defines null methods for them
* all, so you can only have to define methods for events you care about.)
* addKeyListener
+ * a component using the component's {@code addKeyListener}
* method. When a key is pressed, released, or typed,
* the relevant method in the listener object is invoked,
- * and the KeyEvent is passed to it.
+ * and the {@code KeyEvent} is passed to it.
*
* @author Carl Quinn
*
--- old/src/java.desktop/share/classes/java/awt/event/KeyEvent.java 2015-10-04 22:53:34.565271864 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/KeyEvent.java 2015-10-04 22:53:34.373271873 +0400
@@ -37,12 +37,12 @@
* KeyListener
- * or KeyAdapter object which registered to receive such
- * events using the component's addKeyListener method.
- * (KeyAdapter objects implement the
- * KeyListener interface.) Each such listener object
- * gets this KeyEvent when the event occurs.
+ * The event is passed to every {@code KeyListener}
+ * or {@code KeyAdapter} object which registered to receive such
+ * events using the component's {@code addKeyListener} method.
+ * ({@code KeyAdapter} objects implement the
+ * {@code KeyListener} interface.) Each such listener object
+ * gets this {@code KeyEvent} when the event occurs.
* KEY_TYPED events do not have a keyLocation; this value
+ * {@code KEY_TYPED} events do not have a keyLocation; this value
* is used instead.
* @since 1.4
*/
@@ -1028,7 +1028,7 @@
int keyCode;
/**
- * keyChar is a valid unicode character
+ * {@code keyChar} is a valid unicode character
* that is fired by a key or a key combination on
* a keyboard.
*
@@ -1045,9 +1045,9 @@
* right shift keys. Additionally, some keys occur on the numeric
* keypad. This variable is used to distinguish such keys.
*
- * The only legal values are KEY_LOCATION_UNKNOWN,
- * KEY_LOCATION_STANDARD, KEY_LOCATION_LEFT,
- * KEY_LOCATION_RIGHT, and KEY_LOCATION_NUMPAD.
+ * The only legal values are {@code KEY_LOCATION_UNKNOWN},
+ * {@code KEY_LOCATION_STANDARD}, {@code KEY_LOCATION_LEFT},
+ * {@code KEY_LOCATION_RIGHT}, and {@code KEY_LOCATION_NUMPAD}.
*
* @serial
* @see #getKeyLocation()
@@ -1115,12 +1115,12 @@
}
/**
- * Constructs a KeyEvent object.
+ * Constructs a {@code KeyEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link KeyEvent}
@@ -1142,19 +1142,19 @@
* CHAR_UNDEFINED (for key-pressed and key-released
* events which do not map to a valid Unicode character)
* @param keyLocation Identifies the key location. The only legal
- * values are KEY_LOCATION_UNKNOWN,
- * KEY_LOCATION_STANDARD, KEY_LOCATION_LEFT,
- * KEY_LOCATION_RIGHT, and KEY_LOCATION_NUMPAD.
+ * values are {@code KEY_LOCATION_UNKNOWN},
+ * {@code KEY_LOCATION_STANDARD}, {@code KEY_LOCATION_LEFT},
+ * {@code KEY_LOCATION_RIGHT}, and {@code KEY_LOCATION_NUMPAD}.
* @throws IllegalArgumentException
- * if id is KEY_TYPED and
- * keyChar is CHAR_UNDEFINED;
- * or if id is KEY_TYPED and
- * keyCode is not VK_UNDEFINED;
- * or if id is KEY_TYPED and
- * keyLocation is not KEY_LOCATION_UNKNOWN;
- * or if keyLocation is not one of the legal
+ * if {@code id} is {@code KEY_TYPED} and
+ * {@code keyChar} is {@code CHAR_UNDEFINED};
+ * or if {@code id} is {@code KEY_TYPED} and
+ * {@code keyCode} is not {@code VK_UNDEFINED};
+ * or if {@code id} is {@code KEY_TYPED} and
+ * {@code keyLocation} is not {@code KEY_LOCATION_UNKNOWN};
+ * or if {@code keyLocation} is not one of the legal
* values enumerated above.
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getWhen()
@@ -1196,12 +1196,12 @@
}
/**
- * Constructs a KeyEvent object.
+ * Constructs a {@code KeyEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Component that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link KeyEvent}
@@ -1222,12 +1222,12 @@
* @param keyChar The Unicode character generated by this event, or
* CHAR_UNDEFINED (for key-pressed and key-released
* events which do not map to a valid Unicode character)
- * @throws IllegalArgumentException if id is
- * KEY_TYPED and keyChar is
- * CHAR_UNDEFINED; or if id is
- * KEY_TYPED and keyCode is not
- * VK_UNDEFINED
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code id} is
+ * {@code KEY_TYPED} and {@code keyChar} is
+ * {@code CHAR_UNDEFINED}; or if {@code id} is
+ * {@code KEY_TYPED} and {@code keyCode} is not
+ * {@code VK_UNDEFINED}
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getWhen()
@@ -1243,7 +1243,7 @@
/**
* @deprecated as of JDK1.1; use {@link #KeyEvent(Component, int, long, int, int, char)} instead
- * @param source The Component that originated the event
+ * @param source The {@code Component} that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link KeyEvent}
@@ -1272,8 +1272,8 @@
* Returns the integer keyCode associated with the key in this event.
*
* @return the integer code for an actual key on the keyboard.
- * (For KEY_TYPED events, the keyCode is
- * VK_UNDEFINED.)
+ * (For {@code KEY_TYPED} events, the keyCode is
+ * {@code VK_UNDEFINED}.)
*/
public int getKeyCode() {
return keyCode;
@@ -1290,17 +1290,17 @@
/**
* Returns the character associated with the key in this event.
- * For example, the KEY_TYPED event for shift + "a"
+ * For example, the {@code KEY_TYPED} event for shift + "a"
* returns the value for "A".
* KEY_PRESSED and KEY_RELEASED events
+ * {@code KEY_PRESSED} and {@code KEY_RELEASED} events
* are not intended for reporting of character input. Therefore,
* the values returned by this method are guaranteed to be
- * meaningful only for KEY_TYPED events.
+ * meaningful only for {@code KEY_TYPED} events.
*
* @return the Unicode character defined for this key event.
* If no valid Unicode character exists for this key event,
- * CHAR_UNDEFINED is returned.
+ * {@code CHAR_UNDEFINED} is returned.
*/
public char getKeyChar() {
return keyChar;
@@ -1322,7 +1322,7 @@
* KEY_TYPED events where the shift
+ * especially true for {@code KEY_TYPED} events where the shift
* modifier is changed.
*
* @param modifiers an integer combination of the modifier constants.
@@ -1347,8 +1347,8 @@
* keypad. This provides a way of distinguishing such keys.
*
* @return the location of the key that was pressed or released.
- * Always returns KEY_LOCATION_UNKNOWN for
- * KEY_TYPED events.
+ * Always returns {@code KEY_LOCATION_UNKNOWN} for
+ * {@code KEY_TYPED} events.
* @since 1.4
*/
public int getKeyLocation() {
@@ -1541,15 +1541,15 @@
}
/**
- * Returns a String describing the modifier key(s),
+ * Returns a {@code String} describing the modifier key(s),
* such as "Shift", or "Ctrl+Shift". These strings can be
- * localized by changing the awt.properties file.
+ * localized by changing the {@code awt.properties} file.
* InputEvent.ALT_MASK and
- * InputEvent.BUTTON2_MASK have the same value,
+ * Note that {@code InputEvent.ALT_MASK} and
+ * {@code InputEvent.BUTTON2_MASK} have the same value,
* so the string "Alt" is returned for both modifiers. Likewise,
- * InputEvent.META_MASK and
- * InputEvent.BUTTON3_MASK have the same value,
+ * {@code InputEvent.META_MASK} and
+ * {@code InputEvent.BUTTON3_MASK} have the same value,
* so the string "Meta" is returned for both modifiers.
*
* @param modifiers the modifier mask to be processed
@@ -1595,8 +1595,8 @@
* Typically an action key does not fire a unicode character and is
* not a modifier key.
*
- * @return true if the key is an "action" key,
- * false otherwise
+ * @return {@code true} if the key is an "action" key,
+ * {@code false} otherwise
*/
public boolean isActionKey() {
switch (keyCode) {
--- old/src/java.desktop/share/classes/java/awt/event/KeyListener.java 2015-10-04 22:53:35.113271840 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/KeyListener.java 2015-10-04 22:53:34.921271848 +0400
@@ -31,14 +31,14 @@
* The listener interface for receiving keyboard events (keystrokes).
* The class that is interested in processing a keyboard event
* either implements this interface (and all the methods it
- * contains) or extends the abstract KeyAdapter class
+ * contains) or extends the abstract {@code KeyAdapter} class
* (overriding only the methods of interest).
* addKeyListener
+ * component using the component's {@code addKeyListener}
* method. A keyboard event is generated when a key is pressed, released,
* or typed. The relevant method in the listener
- * object is then invoked, and the KeyEvent is passed to it.
+ * object is then invoked, and the {@code KeyEvent} is passed to it.
*
* @author Carl Quinn
*
--- old/src/java.desktop/share/classes/java/awt/event/MouseEvent.java 2015-10-04 22:53:35.729271812 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseEvent.java 2015-10-04 22:53:35.537271821 +0400
@@ -526,11 +526,11 @@
* {@link java.awt.MouseInfo#getNumberOfButtons() MouseInfo.getNumberOfButtons()}
* if the mouse has more than three buttons.
*
*
MouseMotionListener.)
+ * {@code MouseMotionListener}.)
* MouseAdapter class
+ * contains) or extends the abstract {@code MouseAdapter} class
* (overriding only the methods of interest).
* addMouseListener
+ * component using the component's {@code addMouseListener}
* method. A mouse event is generated when the mouse is pressed, released
* clicked (pressed and released). A mouse event is also generated when
* the mouse cursor enters or leaves a component. When a mouse event
* occurs, the relevant method in the listener object is invoked, and
- * the MouseEvent is passed to it.
+ * the {@code MouseEvent} is passed to it.
*
* @author Carl Quinn
*
--- old/src/java.desktop/share/classes/java/awt/event/MouseMotionAdapter.java 2015-10-04 22:53:36.885271760 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseMotionAdapter.java 2015-10-04 22:53:36.693271769 +0400
@@ -34,16 +34,16 @@
* (Many such events will be generated in a normal program.
* To track clicks and other mouse events, use the MouseAdapter.)
* MouseEvent listener
+ * Extend this class to create a {@code MouseEvent} listener
* and override the methods for the events of interest. (If you implement the
- * MouseMotionListener interface, you have to define all of
+ * {@code MouseMotionListener} interface, you have to define all of
* the methods in it. This abstract class defines null methods for them
* all, so you can only have to define methods for events you care about.)
* addMouseMotionListener
+ * a component using the component's {@code addMouseMotionListener}
* method. When the mouse is moved or dragged, the relevant method in the
- * listener object is invoked and the MouseEvent is passed to it.
+ * listener object is invoked and the {@code MouseEvent} is passed to it.
*
* @author Amy Fowler
*
--- old/src/java.desktop/share/classes/java/awt/event/MouseMotionListener.java 2015-10-04 22:53:37.409271737 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseMotionListener.java 2015-10-04 22:53:37.221271745 +0400
@@ -29,19 +29,19 @@
/**
* The listener interface for receiving mouse motion events on a component.
- * (For clicks and other mouse events, use the MouseListener.)
+ * (For clicks and other mouse events, use the {@code MouseListener}.)
* MouseMotionAdapter class
+ * contains) or extends the abstract {@code MouseMotionAdapter} class
* (overriding only the methods of interest).
* addMouseMotionListener
+ * component using the component's {@code addMouseMotionListener}
* method. A mouse motion event is generated when the mouse is moved
* or dragged. (Many such events will be generated). When a mouse motion event
* occurs, the relevant method in the listener object is invoked, and
- * the MouseEvent is passed to it.
+ * the {@code MouseEvent} is passed to it.
*
* @author Amy Fowler
*
@@ -55,13 +55,13 @@
/**
* Invoked when a mouse button is pressed on a component and then
- * dragged. MOUSE_DRAGGED events will continue to be
+ * dragged. {@code MOUSE_DRAGGED} events will continue to be
* delivered to the component where the drag originated until the
* mouse button is released (regardless of whether the mouse position
* is within the bounds of the component).
* MOUSE_DRAGGED events may not be delivered during a native
+ * {@code MOUSE_DRAGGED} events may not be delivered during a native
* Drag&Drop operation.
* @param e the event to be processed
*/
--- old/src/java.desktop/share/classes/java/awt/event/MouseWheelEvent.java 2015-10-04 22:53:37.933271713 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseWheelEvent.java 2015-10-04 22:53:37.745271722 +0400
@@ -36,10 +36,10 @@
* This wheel can be rotated towards or away from the user. Mouse wheels are
* most often used for scrolling, though other uses are possible.
* MouseWheelListener
+ * A MouseWheelEvent object is passed to every {@code MouseWheelListener}
* object which registered to receive the "interesting" mouse events using the
- * component's addMouseWheelListener method. Each such listener
- * object gets a MouseEvent containing the mouse event.
+ * component's {@code addMouseWheelListener} method. Each such listener
+ * object gets a {@code MouseEvent} containing the mouse event.
* MouseWheelEvent class includes methods for
+ * The {@code MouseWheelEvent} class includes methods for
* getting the number of "clicks" by which the mouse wheel is rotated.
* The {@link #getWheelRotation} method returns the integer number
* of "clicks" corresponding to the number of notches by which the wheel was
- * rotated. In addition to this method, the MouseWheelEvent
+ * rotated. In addition to this method, the {@code MouseWheelEvent}
* class provides the {@link #getPreciseWheelRotation} method which returns
* a double number of "clicks" in case a partial rotation occurred.
* The {@link #getPreciseWheelRotation} method is useful if a mouse supports
@@ -160,17 +160,17 @@
private static final long serialVersionUID = 6459879390515399677L;
/**
- * Constructs a MouseWheelEvent object with the
+ * Constructs a {@code MouseWheelEvent} object with the
* specified source component, type, modifiers, coordinates,
* scroll type, scroll amount, and wheel rotation.
* id results in
+ * IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source the Component that originated
+ * @param source the {@code Component} that originated
* the event
* @param id the integer that identifies the event
* @param when a long that gives the time the event occurred
@@ -183,14 +183,14 @@
* popup-menu
* @param scrollType the type of scrolling which should take place in
* response to this event; valid values are
- * WHEEL_UNIT_SCROLL and
- * WHEEL_BLOCK_SCROLL
- * @param scrollAmount for scrollType WHEEL_UNIT_SCROLL,
+ * {@code WHEEL_UNIT_SCROLL} and
+ * {@code WHEEL_BLOCK_SCROLL}
+ * @param scrollAmount for scrollType {@code WHEEL_UNIT_SCROLL},
* the number of units to be scrolled
* @param wheelRotation the integer number of "clicks" by which the mouse
* wheel was rotated
*
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see MouseEvent#MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
* @see MouseEvent#MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)
*/
@@ -203,18 +203,18 @@
}
/**
- * Constructs a MouseWheelEvent object with the
+ * Constructs a {@code MouseWheelEvent} object with the
* specified source component, type, modifiers, coordinates,
* absolute coordinates, scroll type, scroll amount, and wheel rotation.
- * id results in
+ * IllegalArgumentException if source
- * is null.Component that originated
+ * @param source the {@code Component} that originated
* the event
* @param id the integer that identifies the event
* @param when a long that gives the time the event occurred
@@ -229,14 +229,14 @@
* popup-menu
* @param scrollType the type of scrolling which should take place in
* response to this event; valid values are
- * WHEEL_UNIT_SCROLL and
- * WHEEL_BLOCK_SCROLL
- * @param scrollAmount for scrollType WHEEL_UNIT_SCROLL,
+ * {@code WHEEL_UNIT_SCROLL} and
+ * {@code WHEEL_BLOCK_SCROLL}
+ * @param scrollAmount for scrollType {@code WHEEL_UNIT_SCROLL},
* the number of units to be scrolled
* @param wheelRotation the integer number of "clicks" by which the mouse
* wheel was rotated
*
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see MouseEvent#MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
* @see MouseEvent#MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)
* @since 1.6
@@ -252,45 +252,45 @@
/**
- * Constructs a MouseWheelEvent object with the specified
+ * Constructs a {@code MouseWheelEvent} object with the specified
* source component, type, modifiers, coordinates, absolute coordinates,
* scroll type, scroll amount, and wheel rotation.
- * id parameter results
+ * IllegalArgumentException if source equals
- * null.
+ * {@code IllegalArgumentException} if {@code source} equals
+ * {@code null}.
* MouseWheelEvent instance
+ * are passed to the constructor, a {@code MouseWheelEvent} instance
* is still created and no exception is thrown.
*
- * @param source the Component that originated the event
+ * @param source the {@code Component} that originated the event
* @param id the integer value that identifies the event
* @param when a long value that gives the time when the event occurred
* @param modifiers the modifier keys down during event
* (shift, ctrl, alt, meta)
- * @param x the horizontal x coordinate for the
+ * @param x the horizontal {@code x} coordinate for the
* mouse location
- * @param y the vertical y coordinate for the
+ * @param y the vertical {@code y} coordinate for the
* mouse location
- * @param xAbs the absolute horizontal x coordinate for
+ * @param xAbs the absolute horizontal {@code x} coordinate for
* the mouse location
- * @param yAbs the absolute vertical y coordinate for
+ * @param yAbs the absolute vertical {@code y} coordinate for
* the mouse location
* @param clickCount the number of mouse clicks associated with the event
- * @param popupTrigger a boolean value, true if this event is a trigger
+ * @param popupTrigger a boolean value, {@code true} if this event is a trigger
* for a popup-menu
* @param scrollType the type of scrolling which should take place in
* response to this event; valid values are
- * WHEEL_UNIT_SCROLL and
- * WHEEL_BLOCK_SCROLL
- * @param scrollAmount for scrollType WHEEL_UNIT_SCROLL,
+ * {@code WHEEL_UNIT_SCROLL} and
+ * {@code WHEEL_BLOCK_SCROLL}
+ * @param scrollAmount for scrollType {@code WHEEL_UNIT_SCROLL},
* the number of units to be scrolled
* @param wheelRotation the integer number of "clicks" by which the mouse wheel
* was rotated
* @param preciseWheelRotation the double number of "clicks" by which the mouse wheel
* was rotated
*
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see MouseEvent#MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
* @see MouseEvent#MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)
* @since 1.7
@@ -332,12 +332,12 @@
/**
* Returns the number of units that should be scrolled per
* click of mouse wheel rotation.
- * Only valid if getScrollType returns
- * MouseWheelEvent.WHEEL_UNIT_SCROLL
+ * Only valid if {@code getScrollType} returns
+ * {@code MouseWheelEvent.WHEEL_UNIT_SCROLL}
*
* @return number of units to scroll, or an undefined value if
- * getScrollType returns
- * MouseWheelEvent.WHEEL_BLOCK_SCROLL
+ * {@code getScrollType} returns
+ * {@code MouseWheelEvent.WHEEL_BLOCK_SCROLL}
* @see #getScrollType
*/
public int getScrollAmount() {
@@ -377,12 +377,12 @@
* This is a convenience method to aid in the implementation of
* the common-case MouseWheelListener - to scroll a ScrollPane or
* JScrollPane by an amount which conforms to the platform settings.
- * (Note, however, that ScrollPane and
- * JScrollPane already have this functionality built in.)
+ * (Note, however, that {@code ScrollPane} and
+ * {@code JScrollPane} already have this functionality built in.)
* getScrollType returns MouseWheelEvent.WHEEL_UNIT_SCROLL.
+ * {@code getScrollType} returns MouseWheelEvent.WHEEL_UNIT_SCROLL.
* MouseListener.
- * For mouse movement and drags, use the MouseMotionListener.)
+ * (For clicks and other mouse events, use the {@code MouseListener}.
+ * For mouse movement and drags, use the {@code MouseMotionListener}.)
* addMouseWheelListener
+ * component using the component's {@code addMouseWheelListener}
* method. A mouse wheel event is generated when the mouse wheel is rotated.
- * When a mouse wheel event occurs, that object's mouseWheelMoved
+ * When a mouse wheel event occurs, that object's {@code mouseWheelMoved}
* method is invoked.
* PaintEvent object with the specified
+ * Constructs a {@code PaintEvent} object with the specified
* source component and type.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
* @param source The object where the event originated
* @param id The integer that identifies the event type.
* For information on allowable values, see
* the class description for {@link PaintEvent}
* @param updateRect The rectangle area which needs to be repainted
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
* @see #getUpdateRect()
--- old/src/java.desktop/share/classes/java/awt/event/TextEvent.java 2015-10-04 22:53:39.513271642 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/TextEvent.java 2015-10-04 22:53:39.325271651 +0400
@@ -31,11 +31,11 @@
* A semantic event which indicates that an object's text changed.
* This high-level event is generated by an object (such as a TextComponent)
* when its text changes. The event is passed to
- * every TextListener object which registered to receive such
- * events using the component's addTextListener method.
+ * every {@code TextListener} object which registered to receive such
+ * events using the component's {@code addTextListener} method.
* TextListener interface gets
- * this TextEvent when the event occurs. The listener is
+ * The object that implements the {@code TextListener} interface gets
+ * this {@code TextEvent} when the event occurs. The listener is
* spared the details of processing individual mouse movements and key strokes
* Instead, it can process a "meaningful" (semantic) event like "text changed".
* TextEvent object.
+ * Constructs a {@code TextEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The (TextComponent) object that
+ * @param source The ({@code TextComponent}) object that
* originated the event
* @param id An integer that identifies the event type.
* For information on allowable values, see
* the class description for {@link TextEvent}
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getSource()
* @see #getID()
*/
--- old/src/java.desktop/share/classes/java/awt/event/TextListener.java 2015-10-04 22:53:40.037271619 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/TextListener.java 2015-10-04 22:53:39.849271627 +0400
@@ -33,9 +33,9 @@
* The class that is interested in processing a text event
* implements this interface. The object created with that
* class is then registered with a component using the
- * component's addTextListener method. When the
+ * component's {@code addTextListener} method. When the
* component's text changes, the listener object's
- * textValueChanged method is invoked.
+ * {@code textValueChanged} method is invoked.
*
* @author Georges Saab
*
--- old/src/java.desktop/share/classes/java/awt/event/WindowAdapter.java 2015-10-04 22:53:40.561271595 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowAdapter.java 2015-10-04 22:53:40.373271604 +0400
@@ -30,18 +30,18 @@
* The methods in this class are empty. This class exists as
* convenience for creating listener objects.
* WindowEvent listener
+ * Extend this class to create a {@code WindowEvent} listener
* and override the methods for the events of interest. (If you implement the
- * WindowListener interface, you have to define all of
+ * {@code WindowListener} interface, you have to define all of
* the methods in it. This abstract class defines null methods for them
* all, so you can only have to define methods for events you care about.)
* addWindowListener
+ * a Window using the window's {@code addWindowListener}
* method. When the window's status changes by virtue of being opened,
* closed, activated or deactivated, iconified or deiconified,
* the relevant method in the listener
- * object is invoked, and the WindowEvent is passed to it.
+ * object is invoked, and the {@code WindowEvent} is passed to it.
*
* @see WindowEvent
* @see WindowListener
--- old/src/java.desktop/share/classes/java/awt/event/WindowEvent.java 2015-10-04 22:53:41.113271570 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowEvent.java 2015-10-04 22:53:40.897271580 +0400
@@ -36,12 +36,12 @@
* activated, deactivated, iconified, or deiconified, or when focus is
* transferred into or out of the Window.
* WindowListener
- * or WindowAdapter object which registered to receive such
- * events using the window's addWindowListener method.
- * (WindowAdapter objects implement the
- * WindowListener interface.) Each such listener object
- * gets this WindowEvent when the event occurs.
+ * The event is passed to every {@code WindowListener}
+ * or {@code WindowAdapter} object which registered to receive such
+ * events using the window's {@code addWindowListener} method.
+ * ({@code WindowAdapter} objects implement the
+ * {@code WindowListener} interface.) Each such listener object
+ * gets this {@code WindowEvent} when the event occurs.
* WindowEvent object.
+ * Constructs a {@code WindowEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Window object
+ * @param source The {@code Window} object
* that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}
* @param opposite The other window involved in the focus or activation
- * change, or null
+ * change, or {@code null}
* @param oldState Previous state of the window for window state change event.
* See {@code #getOldState()} for allowable values
* @param newState New state of the window for window state change event.
* See {@code #getNewState()} for allowable values
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
* @see #getOppositeWindow()
@@ -210,24 +210,24 @@
}
/**
- * Constructs a WindowEvent object with the
- * specified opposite Window. The opposite
- * Window is the other Window
+ * Constructs a {@code WindowEvent} object with the
+ * specified opposite {@code Window}. The opposite
+ * {@code Window} is the other {@code Window}
* involved in this focus or activation change.
- * For a WINDOW_ACTIVATED or
- * WINDOW_GAINED_FOCUS event, this is the
- * Window that lost activation or focus.
- * For a WINDOW_DEACTIVATED or
- * WINDOW_LOST_FOCUS event, this is the
- * Window that gained activation or focus.
+ * For a {@code WINDOW_ACTIVATED} or
+ * {@code WINDOW_GAINED_FOCUS} event, this is the
+ * {@code Window} that lost activation or focus.
+ * For a {@code WINDOW_DEACTIVATED} or
+ * {@code WINDOW_LOST_FOCUS} event, this is the
+ * {@code Window} that gained activation or focus.
* If this focus change occurs with a native application, with a
* Java application in a different VM, or with no other
- * Window, then the opposite Window is null.
+ * {@code Window}, then the opposite Window is {@code null}.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Window object that
+ * @param source The {@code Window} object that
* originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
@@ -237,11 +237,11 @@
* {@code WINDOW_ACTIVATED},{@code WINDOW_DEACTIVATED},
* {@code WINDOW_GAINED_FOCUS}, or {@code WINDOW_LOST_FOCUS}.
* {@code WindowEvent} types,
- * because the opposite Window of other event types
+ * because the opposite {@code Window} of other event types
* will always be {@code null}.
- * @param opposite The other Window involved in the
- * focus or activation change, or null
- * @throws IllegalArgumentException if source is null
+ * @param opposite The other {@code Window} involved in the
+ * focus or activation change, or {@code null}
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
* @see #getOppositeWindow()
@@ -252,13 +252,13 @@
}
/**
- * Constructs a WindowEvent object with the specified
+ * Constructs a {@code WindowEvent} object with the specified
* previous and new window states.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Window object
+ * @param source The {@code Window} object
* that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
@@ -273,7 +273,7 @@
* See {@code #getOldState()} for allowable values
* @param newState An integer representing the new window state.
* See {@code #getNewState()} for allowable values
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
* @see #getOldState()
@@ -285,16 +285,16 @@
}
/**
- * Constructs a WindowEvent object.
+ * Constructs a {@code WindowEvent} object.
* IllegalArgumentException if source
- * is null.
+ * {@code IllegalArgumentException} if {@code source}
+ * is {@code null}.
*
- * @param source The Window object that originated the event
+ * @param source The {@code Window} object that originated the event
* @param id An integer indicating the type of event.
* For information on allowable values, see
* the class description for {@link WindowEvent}.
- * @throws IllegalArgumentException if source is null
+ * @throws IllegalArgumentException if {@code source} is null
* @see #getWindow()
* @see #getID()
*/
@@ -336,18 +336,18 @@
}
/**
- * For WINDOW_STATE_CHANGED events returns the
+ * For {@code WINDOW_STATE_CHANGED} events returns the
* previous state of the window. The state is
* represented as a bitwise mask.
*
- *
*
* @return a bitwise mask of the previous window state
@@ -359,18 +359,18 @@
}
/**
- * For NORMAL
+ *
Indicates that no state bits are set.
- * ICONIFIED
- * MAXIMIZED_HORIZ
- * MAXIMIZED_VERT
- * MAXIMIZED_BOTH
- *
Concatenates MAXIMIZED_HORIZ
- * and MAXIMIZED_VERT.
+ *
Concatenates {@code MAXIMIZED_HORIZ}
+ * and {@code MAXIMIZED_VERT}.
* WINDOW_STATE_CHANGED events returns the
+ * For {@code WINDOW_STATE_CHANGED} events returns the
* new state of the window. The state is
* represented as a bitwise mask.
*
- *
*
* @return a bitwise mask of the new window state
--- old/src/java.desktop/share/classes/java/awt/event/WindowFocusListener.java 2015-10-04 22:53:41.637271547 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowFocusListener.java 2015-10-04 22:53:41.449271555 +0400
@@ -28,20 +28,20 @@
import java.util.EventListener;
/**
- * The listener interface for receiving NORMAL
+ *
Indicates that no state bits are set.
- * ICONIFIED
- * MAXIMIZED_HORIZ
- * MAXIMIZED_VERT
- * MAXIMIZED_BOTH
- *
Concatenates MAXIMIZED_HORIZ
- * and MAXIMIZED_VERT.
+ *
Concatenates {@code MAXIMIZED_HORIZ}
+ * and {@code MAXIMIZED_VERT}.
* WindowEvents, including
- * WINDOW_GAINED_FOCUS and WINDOW_LOST_FOCUS events.
- * The class that is interested in processing a WindowEvent
+ * The listener interface for receiving {@code WindowEvents}, including
+ * {@code WINDOW_GAINED_FOCUS} and {@code WINDOW_LOST_FOCUS} events.
+ * The class that is interested in processing a {@code WindowEvent}
* either implements this interface (and
* all the methods it contains) or extends the abstract
- * WindowAdapter class (overriding only the methods of interest).
+ * {@code WindowAdapter} class (overriding only the methods of interest).
* The listener object created from that class is then registered with a
- * Window
- * using the Window's addWindowFocusListener method.
- * When the Window's
+ * {@code Window}
+ * using the {@code Window}'s {@code addWindowFocusListener} method.
+ * When the {@code Window}'s
* status changes by virtue of it being opened, closed, activated, deactivated,
* iconified, or deiconified, or by focus being transferred into or out of the
- * Window, the relevant method in the listener object is invoked,
- * and the WindowEvent is passed to it.
+ * {@code Window}, the relevant method in the listener object is invoked,
+ * and the {@code WindowEvent} is passed to it.
*
* @author David Mendenhall
*
--- old/src/java.desktop/share/classes/java/awt/event/WindowListener.java 2015-10-04 22:53:42.157271523 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowListener.java 2015-10-04 22:53:41.969271532 +0400
@@ -31,14 +31,14 @@
* The listener interface for receiving window events.
* The class that is interested in processing a window event
* either implements this interface (and all the methods it
- * contains) or extends the abstract WindowAdapter class
+ * contains) or extends the abstract {@code WindowAdapter} class
* (overriding only the methods of interest).
* The listener object created from that class is then registered with a
- * Window using the window's addWindowListener
+ * Window using the window's {@code addWindowListener}
* method. When the window's status changes by virtue of being opened,
* closed, activated or deactivated, iconified or deiconified,
* the relevant method in the listener object is invoked, and the
- * WindowEvent is passed to it.
+ * {@code WindowEvent} is passed to it.
*
* @author Carl Quinn
*
--- old/src/java.desktop/share/classes/java/awt/event/WindowStateListener.java 2015-10-04 22:53:42.681271500 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowStateListener.java 2015-10-04 22:53:42.489271508 +0400
@@ -32,15 +32,15 @@
* WindowAdapter class
+ * or extends the abstract {@code WindowAdapter} class
* (overriding only the methods of interest).
* Window's
- * addWindowStateListener method. When the window's
+ * a window using the {@code Window}'s
+ * {@code addWindowStateListener} method. When the window's
* state changes by virtue of being iconified, maximized etc., the
- * windowStateChanged method in the listener object is
- * invoked, and the WindowEvent is passed to it.
+ * {@code windowStateChanged} method in the listener object is
+ * invoked, and the {@code WindowEvent} is passed to it.
*
* @see java.awt.event.WindowAdapter
* @see java.awt.event.WindowEvent
--- old/src/java.desktop/share/classes/java/awt/font/FontRenderContext.java 2015-10-04 22:53:43.249271474 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/FontRenderContext.java 2015-10-04 22:53:43.061271483 +0400
@@ -34,7 +34,7 @@
import java.awt.geom.AffineTransform;
/**
-* The FontRenderContext class is a container for the
+* The {@code FontRenderContext} class is a container for the
* information needed to correctly measure text. The measurement of text
* can vary because of rules that map outlines to pixels, and rendering
* hints provided by an application.
@@ -52,9 +52,9 @@
* affect the size of a character because of rounding to pixel
* boundaries.
* FontRenderContext are
+* Typically, instances of {@code FontRenderContext} are
* obtained from a {@link java.awt.Graphics2D Graphics2D} object. A
-* FontRenderContext which is directly constructed will
+* {@code FontRenderContext} which is directly constructed will
* most likely not represent any actual graphics device, and may lead
* to unexpected or incorrect results.
* @see java.awt.RenderingHints#KEY_TEXT_ANTIALIASING
@@ -70,7 +70,7 @@
private transient boolean defaulting;
/**
- * Constructs a new FontRenderContext
+ * Constructs a new {@code FontRenderContext}
* object.
*
*/
@@ -81,19 +81,19 @@
}
/**
- * Constructs a FontRenderContext object from an
- * optional {@link AffineTransform} and two boolean
+ * Constructs a {@code FontRenderContext} object from an
+ * optional {@link AffineTransform} and two {@code boolean}
* values that determine if the newly constructed object has
* anti-aliasing or fractional metrics.
- * In each case the boolean values true and false
- * correspond to the rendering hint values ON and
- * OFF respectively.
+ * In each case the boolean values {@code true} and {@code false}
+ * correspond to the rendering hint values {@code ON} and
+ * {@code OFF} respectively.
* FontRenderContext. If null, an
+ * to pixels in this {@code FontRenderContext}. If null, an
* identity transform is used.
* @param isAntiAliased determines if the newly constructed object
* has anti-aliasing.
@@ -119,16 +119,16 @@
}
/**
- * Constructs a FontRenderContext object from an
- * optional {@link AffineTransform} and two Object
+ * Constructs a {@code FontRenderContext} object from an
+ * optional {@link AffineTransform} and two {@code Object}
* values that determine if the newly constructed object has
* anti-aliasing or fractional metrics.
* @param tx the transform which is used to scale typographical points
- * to pixels in this FontRenderContext. If null, an
+ * to pixels in this {@code FontRenderContext}. If null, an
* identity transform is used.
* @param aaHint - one of the text antialiasing rendering hint values
* defined in {@link java.awt.RenderingHints java.awt.RenderingHints}.
- * Any other value will throw IllegalArgumentException.
+ * Any other value will throw {@code IllegalArgumentException}.
* {@link java.awt.RenderingHints#VALUE_TEXT_ANTIALIAS_DEFAULT VALUE_TEXT_ANTIALIAS_DEFAULT}
* may be specified, in which case the mode used is implementation
* dependent.
@@ -137,7 +137,7 @@
* {@link java.awt.RenderingHints#VALUE_FRACTIONALMETRICS_DEFAULT VALUE_FRACTIONALMETRICS_DEFAULT}
* may be specified, in which case the mode used is implementation
* dependent.
- * Any other value will throw IllegalArgumentException
+ * Any other value will throw {@code IllegalArgumentException}
* @throws IllegalArgumentException if the hints are not one of the
* legal values.
* @since 1.6
@@ -167,11 +167,11 @@
}
/**
- * Indicates whether or not this FontRenderContext object
+ * Indicates whether or not this {@code FontRenderContext} object
* measures text in a transformed render context.
- * @return true if this FontRenderContext
+ * @return {@code true} if this {@code FontRenderContext}
* object has a non-identity AffineTransform attribute.
- * false otherwise.
+ * {@code false} otherwise.
* @see java.awt.font.FontRenderContext#getTransform
* @since 1.6
*/
@@ -185,7 +185,7 @@
/**
* Returns the integer type of the affine transform for this
- * FontRenderContext as specified by
+ * {@code FontRenderContext} as specified by
* {@link java.awt.geom.AffineTransform#getType()}
* @return the type of the transform.
* @see AffineTransform
@@ -205,9 +205,9 @@
/**
* Gets the transform that is used to scale typographical points
- * to pixels in this FontRenderContext.
- * @return the AffineTransform of this
- * FontRenderContext.
+ * to pixels in this {@code FontRenderContext}.
+ * @return the {@code AffineTransform} of this
+ * {@code FontRenderContext}.
* @see AffineTransform
*/
public AffineTransform getTransform() {
@@ -216,11 +216,11 @@
/**
* Returns a boolean which indicates whether or not some form of
- * antialiasing is specified by this FontRenderContext.
+ * antialiasing is specified by this {@code FontRenderContext}.
* Call {@link #getAntiAliasingHint() getAntiAliasingHint()}
* for the specific rendering hint value.
- * @return true, if text is anti-aliased in this
- * FontRenderContext; false otherwise.
+ * @return {@code true}, if text is anti-aliased in this
+ * {@code FontRenderContext}; {@code false} otherwise.
* @see java.awt.RenderingHints#KEY_TEXT_ANTIALIASING
* @see #FontRenderContext(AffineTransform,boolean,boolean)
* @see #FontRenderContext(AffineTransform,Object,Object)
@@ -232,12 +232,12 @@
/**
* Returns a boolean which whether text fractional metrics mode
- * is used in this FontRenderContext.
+ * is used in this {@code FontRenderContext}.
* Call {@link #getFractionalMetricsHint() getFractionalMetricsHint()}
* to obtain the corresponding rendering hint value.
- * @return true, if layout should be performed with
- * fractional metrics; false otherwise.
- * in this FontRenderContext.
+ * @return {@code true}, if layout should be performed with
+ * fractional metrics; {@code false} otherwise.
+ * in this {@code FontRenderContext}.
* @see java.awt.RenderingHints#KEY_FRACTIONALMETRICS
* @see #FontRenderContext(AffineTransform,boolean,boolean)
* @see #FontRenderContext(AffineTransform,Object,Object)
@@ -249,11 +249,11 @@
/**
* Return the text anti-aliasing rendering mode hint used in this
- * FontRenderContext.
+ * {@code FontRenderContext}.
* This will be one of the text antialiasing rendering hint values
* defined in {@link java.awt.RenderingHints java.awt.RenderingHints}.
* @return text anti-aliasing rendering mode hint used in this
- * FontRenderContext.
+ * {@code FontRenderContext}.
* @since 1.6
*/
public Object getAntiAliasingHint() {
@@ -269,11 +269,11 @@
/**
* Return the text fractional metrics rendering mode hint used in this
- * FontRenderContext.
+ * {@code FontRenderContext}.
* This will be one of the text fractional metrics rendering hint values
* defined in {@link java.awt.RenderingHints java.awt.RenderingHints}.
* @return the text fractional metrics rendering mode hint used in this
- * FontRenderContext.
+ * {@code FontRenderContext}.
* @since 1.6
*/
public Object getFractionalMetricsHint() {
@@ -291,8 +291,8 @@
* Return true if obj is an instance of FontRenderContext and has the same
* transform, antialiasing, and fractional metrics values as this.
* @param obj the object to test for equality
- * @return true if the specified object is equal to
- * this FontRenderContext; false
+ * @return {@code true} if the specified object is equal to
+ * this {@code FontRenderContext}; {@code false}
* otherwise.
*/
public boolean equals(Object obj) {
@@ -307,9 +307,9 @@
/**
* Return true if rhs has the same transform, antialiasing,
* and fractional metrics values as this.
- * @param rhs the FontRenderContext to test for equality
- * @return true if rhs is equal to
- * this FontRenderContext; false
+ * @param rhs the {@code FontRenderContext} to test for equality
+ * @return {@code true} if {@code rhs} is equal to
+ * this {@code FontRenderContext}; {@code false}
* otherwise.
* @since 1.4
*/
--- old/src/java.desktop/share/classes/java/awt/font/GlyphJustificationInfo.java 2015-10-04 22:53:43.781271450 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GlyphJustificationInfo.java 2015-10-04 22:53:43.589271459 +0400
@@ -40,12 +40,12 @@
package java.awt.font;
/**
- * The GlyphJustificationInfo class represents information
+ * The {@code GlyphJustificationInfo} class represents information
* about the justification properties of a glyph. A glyph is the visual
* representation of one or more characters. Many different glyphs can
* be used to represent a single character or combination of characters.
* The four justification properties represented by
- * GlyphJustificationInfo are weight, priority, absorb and
+ * {@code GlyphJustificationInfo} are weight, priority, absorb and
* limit.
* GlyphJustificationInfo represents two sets of
+ * Each {@code GlyphJustificationInfo} represents two sets of
* metrics, which are growing and shrinking. Growing
* metrics are used when the glyphs on a line are to be
* spread apart to fit a larger width. Shrinking metrics are used when
@@ -80,7 +80,7 @@
* Constructs information about the justification properties of a
* glyph.
* @param weight the weight of this glyph when allocating space. Must be non-negative.
- * @param growAbsorb if true this glyph absorbs
+ * @param growAbsorb if {@code true} this glyph absorbs
* all extra space at this priority and lower priority levels when it
* grows
* @param growPriority the priority level of this glyph when it
@@ -89,7 +89,7 @@
* glyph can grow. Must be non-negative.
* @param growRightLimit the maximum amount by which the right side of this
* glyph can grow. Must be non-negative.
- * @param shrinkAbsorb if true, this glyph absorbs all
+ * @param shrinkAbsorb if {@code true}, this glyph absorbs all
* remaining shrinkage at this and lower priority levels when it
* shrinks
* @param shrinkPriority the priority level of this glyph when
@@ -172,7 +172,7 @@
public final int growPriority;
/**
- * If true, this glyph absorbs all extra
+ * If {@code true}, this glyph absorbs all extra
* space at this and lower priority levels when it grows.
*/
public final boolean growAbsorb;
@@ -193,7 +193,7 @@
public final int shrinkPriority;
/**
- * If true,this glyph absorbs all remaining shrinkage at
+ * If {@code true},this glyph absorbs all remaining shrinkage at
* this and lower priority levels as it shrinks.
*/
public final boolean shrinkAbsorb;
--- old/src/java.desktop/share/classes/java/awt/font/GlyphMetrics.java 2015-10-04 22:53:44.305271427 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GlyphMetrics.java 2015-10-04 22:53:44.117271435 +0400
@@ -43,12 +43,12 @@
import java.awt.geom.Rectangle2D;
/**
- * The GlyphMetrics class represents information for a
+ * The {@code GlyphMetrics} class represents information for a
* single glyph. A glyph is the visual representation of one or more
* characters. Many different glyphs can be used to represent a single
- * character or combination of characters. GlyphMetrics
+ * character or combination of characters. {@code GlyphMetrics}
* instances are produced by {@link java.awt.Font Font} and are applicable
- * to a specific glyph in a particular Font.
+ * to a specific glyph in a particular {@code Font}.
*
@@ -61,18 +61,18 @@
* as accent marks. Carets do not appear before COMBINING glyphs.
*
* GlyphMetrics are the
+ * Other metrics available through {@code GlyphMetrics} are the
* components of the advance, the visual bounds, and the left and right
* side bearings.
* GlyphVector
+ * Glyphs for a rotated font, or obtained from a {@code GlyphVector}
* which has applied a rotation to the glyph, can have advances that
* contain both X and Y components. Usually the advance only has one
* component.
* GlyphVector,
+ * or horizontal. Note that, in a {@code GlyphVector},
* the distance from a glyph to its following glyph might not be the
* glyph's advance, because of kerning or other positioning adjustments.
* GlyphMetrics can be directly
+ * Although instances of {@code GlyphMetrics} can be directly
* constructed, they are almost always obtained from a
- * GlyphVector. Once constructed, GlyphMetrics
+ * {@code GlyphVector}. Once constructed, {@code GlyphMetrics}
* objects are immutable.
* Font for glyph information
+ * Querying a {@code Font} for glyph information
*
* Font font = ...;
* int glyphIndex = ...;
@@ -171,7 +171,7 @@
public static final byte WHITESPACE = 4;
/**
- * Constructs a GlyphMetrics object.
+ * Constructs a {@code GlyphMetrics} object.
* @param advance the advance width of the glyph
* @param bounds the black box bounds of the glyph
* @param glyphType the type of the glyph
@@ -186,7 +186,7 @@
}
/**
- * Constructs a GlyphMetrics object.
+ * Constructs a {@code GlyphMetrics} object.
* @param horizontal if true, metrics are for a horizontal baseline,
* otherwise they are for a vertical baseline
* @param advanceX the X-component of the glyph's advance
@@ -278,45 +278,45 @@
}
/**
- * Returns true if this is a standard glyph.
- * @return true if this is a standard glyph;
- * false otherwise.
+ * Returns {@code true} if this is a standard glyph.
+ * @return {@code true} if this is a standard glyph;
+ * {@code false} otherwise.
*/
public boolean isStandard() {
return (glyphType & 0x3) == STANDARD;
}
/**
- * Returns true if this is a ligature glyph.
- * @return true if this is a ligature glyph;
- * false otherwise.
+ * Returns {@code true} if this is a ligature glyph.
+ * @return {@code true} if this is a ligature glyph;
+ * {@code false} otherwise.
*/
public boolean isLigature() {
return (glyphType & 0x3) == LIGATURE;
}
/**
- * Returns true if this is a combining glyph.
- * @return true if this is a combining glyph;
- * false otherwise.
+ * Returns {@code true} if this is a combining glyph.
+ * @return {@code true} if this is a combining glyph;
+ * {@code false} otherwise.
*/
public boolean isCombining() {
return (glyphType & 0x3) == COMBINING;
}
/**
- * Returns true if this is a component glyph.
- * @return true if this is a component glyph;
- * false otherwise.
+ * Returns {@code true} if this is a component glyph.
+ * @return {@code true} if this is a component glyph;
+ * {@code false} otherwise.
*/
public boolean isComponent() {
return (glyphType & 0x3) == COMPONENT;
}
/**
- * Returns true if this is a whitespace glyph.
- * @return true if this is a whitespace glyph;
- * false otherwise.
+ * Returns {@code true} if this is a whitespace glyph.
+ * @return {@code true} if this is a whitespace glyph;
+ * {@code false} otherwise.
*/
public boolean isWhitespace() {
return (glyphType & 0x4) == WHITESPACE;
--- old/src/java.desktop/share/classes/java/awt/font/GlyphVector.java 2015-10-04 22:53:44.837271403 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GlyphVector.java 2015-10-04 22:53:44.645271412 +0400
@@ -41,65 +41,65 @@
import java.awt.font.GlyphJustificationInfo;
/**
- * A GlyphVector object is a collection of glyphs
+ * A {@code GlyphVector} object is a collection of glyphs
* containing geometric information for the placement of each glyph
* in a transformed coordinate space which corresponds to the
- * device on which the GlyphVector is ultimately
+ * device on which the {@code GlyphVector} is ultimately
* displayed.
* GlyphVector does not attempt any interpretation of
+ * The {@code GlyphVector} does not attempt any interpretation of
* the sequence of glyphs it contains. Relationships between adjacent
* glyphs in sequence are solely used to determine the placement of
* the glyphs in the visual coordinate space.
* GlyphVector are created by a {@link Font}.
+ * Instances of {@code GlyphVector} are created by a {@link Font}.
* GlyphVector for use during rendering is the fastest
+ * {@code GlyphVector} for use during rendering is the fastest
* method to present the visual representation of characters to a user.
* GlyphVector is associated with exactly one
- * Font, and can provide data useful only in relation to
- * this Font. In addition, metrics obtained from a
- * GlyphVector are not generally geometrically scalable
+ * A {@code GlyphVector} is associated with exactly one
+ * {@code Font}, and can provide data useful only in relation to
+ * this {@code Font}. In addition, metrics obtained from a
+ * {@code GlyphVector} are not generally geometrically scalable
* since the pixelization and spacing are dependent on grid-fitting
- * algorithms within a Font. To facilitate accurate
- * measurement of a GlyphVector and its component
+ * algorithms within a {@code Font}. To facilitate accurate
+ * measurement of a {@code GlyphVector} and its component
* glyphs, you must specify a scaling transform, anti-alias mode, and
- * fractional metrics mode when creating the GlyphVector.
+ * fractional metrics mode when creating the {@code GlyphVector}.
* These characteristics can be derived from the destination device.
* GlyphVector, you can obtain:
+ * For each glyph in the {@code GlyphVector}, you can obtain:
*
*
* GlyphVector. The metrics of the glyph may be
+ * {@code GlyphVector}. The metrics of the glyph may be
* different under different transforms, application specified
* rendering hints, and the specific instance of the glyph within
- * the GlyphVector.
+ * the {@code GlyphVector}.
* GlyphVector does not
- * alter the state of the GlyphVector.
+ * Altering the data used to create the {@code GlyphVector} does not
+ * alter the state of the {@code GlyphVector}.
* GlyphVector. These methods are most
+ * within the {@code GlyphVector}. These methods are most
* appropriate for applications that are performing justification
* operations for the presentation of the glyphs.
* GlyphVector. These methods are primarily useful for
+ * {@code GlyphVector}. These methods are primarily useful for
* special effects.
* GlyphVector or of individual glyphs within
- * the GlyphVector.
+ * of the entire {@code GlyphVector} or of individual glyphs within
+ * the {@code GlyphVector}.
* GlyphVector, and for individual glyphs within the
- * GlyphVector.
+ * {@code GlyphVector}, and for individual glyphs within the
+ * {@code GlyphVector}.
* @see Font
* @see GlyphMetrics
* @see TextLayout
@@ -113,19 +113,19 @@
//
/**
- * Returns the Font associated with this
- * GlyphVector.
- * @return Font used to create this
- * GlyphVector.
+ * Returns the {@code Font} associated with this
+ * {@code GlyphVector}.
+ * @return {@code Font} used to create this
+ * {@code GlyphVector}.
* @see Font
*/
public abstract Font getFont();
/**
* Returns the {@link FontRenderContext} associated with this
- * GlyphVector.
- * @return FontRenderContext used to create this
- * GlyphVector.
+ * {@code GlyphVector}.
+ * @return {@code FontRenderContext} used to create this
+ * {@code GlyphVector}.
* @see FontRenderContext
* @see Font
*/
@@ -137,54 +137,54 @@
/**
* Assigns default positions to each glyph in this
- * GlyphVector. This can destroy information
- * generated during initial layout of this GlyphVector.
+ * {@code GlyphVector}. This can destroy information
+ * generated during initial layout of this {@code GlyphVector}.
*/
public abstract void performDefaultLayout();
/**
- * Returns the number of glyphs in this GlyphVector.
- * @return number of glyphs in this GlyphVector.
+ * Returns the number of glyphs in this {@code GlyphVector}.
+ * @return number of glyphs in this {@code GlyphVector}.
*/
public abstract int getNumGlyphs();
/**
* Returns the glyphcode of the specified glyph.
* This return value is meaningless to anything other
- * than the Font object that created this
- * GlyphVector.
- * @param glyphIndex the index into this GlyphVector
+ * than the {@code Font} object that created this
+ * {@code GlyphVector}.
+ * @param glyphIndex the index into this {@code GlyphVector}
* that corresponds to the glyph from which to retrieve the
* glyphcode.
* @return the glyphcode of the glyph at the specified
- * glyphIndex.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * {@code glyphIndex}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the
- * number of glyphs in this GlyphVector
+ * number of glyphs in this {@code GlyphVector}
*/
public abstract int getGlyphCode(int glyphIndex);
/**
* Returns an array of glyphcodes for the specified glyphs.
* The contents of this return value are meaningless to anything other
- * than the Font used to create this
- * GlyphVector. This method is used
+ * than the {@code Font} used to create this
+ * {@code GlyphVector}. This method is used
* for convenience and performance when processing glyphcodes.
* If no array is passed in, a new array is created.
* @param beginGlyphIndex the index into this
- * GlyphVector at which to start retrieving glyphcodes
+ * {@code GlyphVector} at which to start retrieving glyphcodes
* @param numEntries the number of glyphcodes to retrieve
* @param codeReturn the array that receives the glyphcodes and is
* then returned
* @return an array of glyphcodes for the specified glyphs.
- * @throws IllegalArgumentException if numEntries is
+ * @throws IllegalArgumentException if {@code numEntries} is
* less than 0
- * @throws IndexOutOfBoundsException if beginGlyphIndex
+ * @throws IndexOutOfBoundsException if {@code beginGlyphIndex}
* is less than 0
* @throws IndexOutOfBoundsException if the sum of
- * beginGlyphIndex and numEntries is
+ * {@code beginGlyphIndex} and {@code numEntries} is
* greater than the number of glyphs in this
- * GlyphVector
+ * {@code GlyphVector}
*/
public abstract int[] getGlyphCodes(int beginGlyphIndex, int numEntries,
int[] codeReturn);
@@ -231,41 +231,41 @@
}
/**
- * Returns the logical bounds of this GlyphVector.
- * This method is used when positioning this GlyphVector
- * in relation to visually adjacent GlyphVector objects.
+ * Returns the logical bounds of this {@code GlyphVector}.
+ * This method is used when positioning this {@code GlyphVector}
+ * in relation to visually adjacent {@code GlyphVector} objects.
* @return a {@link Rectangle2D} that is the logical bounds of this
- * GlyphVector.
+ * {@code GlyphVector}.
*/
public abstract Rectangle2D getLogicalBounds();
/**
- * Returns the visual bounds of this GlyphVector
+ * Returns the visual bounds of this {@code GlyphVector}
* The visual bounds is the bounding box of the outline of this
- * GlyphVector. Because of rasterization and
+ * {@code GlyphVector}. Because of rasterization and
* alignment of pixels, it is possible that this box does not
- * enclose all pixels affected by rendering this GlyphVector.
- * @return a Rectangle2D that is the bounding box
- * of this GlyphVector.
+ * enclose all pixels affected by rendering this {@code GlyphVector}.
+ * @return a {@code Rectangle2D} that is the bounding box
+ * of this {@code GlyphVector}.
*/
public abstract Rectangle2D getVisualBounds();
/**
- * Returns the pixel bounds of this GlyphVector when
+ * Returns the pixel bounds of this {@code GlyphVector} when
* rendered in a graphics with the given
- * FontRenderContext at the given location. The
+ * {@code FontRenderContext} at the given location. The
* renderFRC need not be the same as the
- * FontRenderContext of this
- * GlyphVector, and can be null. If it is null, the
- * FontRenderContext of this GlyphVector
+ * {@code FontRenderContext} of this
+ * {@code GlyphVector}, and can be null. If it is null, the
+ * {@code FontRenderContext} of this {@code GlyphVector}
* is used. The default implementation returns the visual bounds,
* offset to x, y and rounded out to the next integer value (i.e. returns an
* integer rectangle which encloses the visual bounds) and
* ignores the FRC. Subclassers should override this method.
- * @param renderFRC the FontRenderContext of the Graphics.
- * @param x the x-coordinate at which to render this GlyphVector.
- * @param y the y-coordinate at which to render this GlyphVector.
- * @return a Rectangle bounding the pixels that would be affected.
+ * @param renderFRC the {@code FontRenderContext} of the {@code Graphics}.
+ * @param x the x-coordinate at which to render this {@code GlyphVector}.
+ * @param y the y-coordinate at which to render this {@code GlyphVector}.
+ * @return a {@code Rectangle} bounding the pixels that would be affected.
* @since 1.4
*/
public Rectangle getPixelBounds(FontRenderContext renderFRC, float x, float y) {
@@ -279,57 +279,57 @@
/**
- * Returns a Shape whose interior corresponds to the
- * visual representation of this GlyphVector.
- * @return a Shape that is the outline of this
- * GlyphVector.
+ * Returns a {@code Shape} whose interior corresponds to the
+ * visual representation of this {@code GlyphVector}.
+ * @return a {@code Shape} that is the outline of this
+ * {@code GlyphVector}.
*/
public abstract Shape getOutline();
/**
- * Returns a Shape whose interior corresponds to the
- * visual representation of this GlyphVector when
+ * Returns a {@code Shape} whose interior corresponds to the
+ * visual representation of this {@code GlyphVector} when
* rendered at x, y.
- * @param x the X coordinate of this GlyphVector.
- * @param y the Y coordinate of this GlyphVector.
- * @return a Shape that is the outline of this
- * GlyphVector when rendered at the specified
+ * @param x the X coordinate of this {@code GlyphVector}.
+ * @param y the Y coordinate of this {@code GlyphVector}.
+ * @return a {@code Shape} that is the outline of this
+ * {@code GlyphVector} when rendered at the specified
* coordinates.
*/
public abstract Shape getOutline(float x, float y);
/**
- * Returns a Shape whose interior corresponds to the
+ * Returns a {@code Shape} whose interior corresponds to the
* visual representation of the specified glyph
- * within this GlyphVector.
+ * within this {@code GlyphVector}.
* The outline returned by this method is positioned around the
* origin of each individual glyph.
- * @param glyphIndex the index into this GlyphVector
- * @return a Shape that is the outline of the glyph
- * at the specified glyphIndex of this
- * GlyphVector.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * @param glyphIndex the index into this {@code GlyphVector}
+ * @return a {@code Shape} that is the outline of the glyph
+ * at the specified {@code glyphIndex} of this
+ * {@code GlyphVector}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
*/
public abstract Shape getGlyphOutline(int glyphIndex);
/**
- * Returns a Shape whose interior corresponds to the
+ * Returns a {@code Shape} whose interior corresponds to the
* visual representation of the specified glyph
- * within this GlyphVector, offset to x, y.
+ * within this {@code GlyphVector}, offset to x, y.
* The outline returned by this method is positioned around the
* origin of each individual glyph.
- * @param glyphIndex the index into this GlyphVector
+ * @param glyphIndex the index into this {@code GlyphVector}
* @param x the X coordinate of the location of this {@code GlyphVector}
* @param y the Y coordinate of the location of this {@code GlyphVector}
- * @return a Shape that is the outline of the glyph
- * at the specified glyphIndex of this
- * GlyphVector when rendered at the specified
+ * @return a {@code Shape} that is the outline of the glyph
+ * at the specified {@code glyphIndex} of this
+ * {@code GlyphVector} when rendered at the specified
* coordinates.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
* @since 1.4
*/
public Shape getGlyphOutline(int glyphIndex, float x, float y) {
@@ -340,67 +340,67 @@
/**
* Returns the position of the specified glyph relative to the
- * origin of this GlyphVector.
- * If glyphIndex equals the number of glyphs in
- * this GlyphVector, this method returns the position after
+ * origin of this {@code GlyphVector}.
+ * If {@code glyphIndex} equals the number of glyphs in
+ * this {@code GlyphVector}, this method returns the position after
* the last glyph. This position is used to define the advance of
- * the entire GlyphVector.
- * @param glyphIndex the index into this GlyphVector
+ * the entire {@code GlyphVector}.
+ * @param glyphIndex the index into this {@code GlyphVector}
* @return a {@link Point2D} object that is the position of the glyph
- * at the specified glyphIndex.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * at the specified {@code glyphIndex}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than the number of glyphs
- * in this GlyphVector
+ * in this {@code GlyphVector}
* @see #setGlyphPosition
*/
public abstract Point2D getGlyphPosition(int glyphIndex);
/**
* Sets the position of the specified glyph within this
- * GlyphVector.
- * If glyphIndex equals the number of glyphs in
- * this GlyphVector, this method sets the position after
+ * {@code GlyphVector}.
+ * If {@code glyphIndex} equals the number of glyphs in
+ * this {@code GlyphVector}, this method sets the position after
* the last glyph. This position is used to define the advance of
- * the entire GlyphVector.
- * @param glyphIndex the index into this GlyphVector
- * @param newPos the Point2D at which to position the
- * glyph at the specified glyphIndex
- * @throws IndexOutOfBoundsException if glyphIndex
+ * the entire {@code GlyphVector}.
+ * @param glyphIndex the index into this {@code GlyphVector}
+ * @param newPos the {@code Point2D} at which to position the
+ * glyph at the specified {@code glyphIndex}
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than the number of glyphs
- * in this GlyphVector
+ * in this {@code GlyphVector}
* @see #getGlyphPosition
*/
public abstract void setGlyphPosition(int glyphIndex, Point2D newPos);
/**
* Returns the transform of the specified glyph within this
- * GlyphVector. The transform is relative to the
+ * {@code GlyphVector}. The transform is relative to the
* glyph position. If no special transform has been applied,
- * null can be returned. A null return indicates
+ * {@code null} can be returned. A null return indicates
* an identity transform.
- * @param glyphIndex the index into this GlyphVector
+ * @param glyphIndex the index into this {@code GlyphVector}
* @return an {@link AffineTransform} that is the transform of
- * the glyph at the specified glyphIndex.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * the glyph at the specified {@code glyphIndex}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
* @see #setGlyphTransform
*/
public abstract AffineTransform getGlyphTransform(int glyphIndex);
/**
* Sets the transform of the specified glyph within this
- * GlyphVector. The transform is relative to the glyph
- * position. A null argument for newTX
+ * {@code GlyphVector}. The transform is relative to the glyph
+ * position. A {@code null} argument for {@code newTX}
* indicates that no special transform is applied for the specified
* glyph.
* This method can be used to rotate, mirror, translate and scale the
* glyph. Adding a transform can result in significant performance changes.
- * @param glyphIndex the index into this GlyphVector
- * @param newTX the new transform of the glyph at glyphIndex
- * @throws IndexOutOfBoundsException if glyphIndex
+ * @param glyphIndex the index into this {@code GlyphVector}
+ * @param newTX the new transform of the glyph at {@code glyphIndex}
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
* @see #getGlyphTransform
*/
public abstract void setGlyphTransform(int glyphIndex, AffineTransform newTX);
@@ -426,14 +426,14 @@
}
/**
- * A flag used with getLayoutFlags that indicates that this GlyphVector has
+ * A flag used with getLayoutFlags that indicates that this {@code GlyphVector} has
* per-glyph transforms.
* @since 1.4
*/
public static final int FLAG_HAS_TRANSFORMS = 1;
/**
- * A flag used with getLayoutFlags that indicates that this GlyphVector has
+ * A flag used with getLayoutFlags that indicates that this {@code GlyphVector} has
* position adjustments. When this is true, the glyph positions don't match the
* accumulated default advances of the glyphs (for example, if kerning has been done).
* @since 1.4
@@ -441,7 +441,7 @@
public static final int FLAG_HAS_POSITION_ADJUSTMENTS = 2;
/**
- * A flag used with getLayoutFlags that indicates that this GlyphVector has
+ * A flag used with getLayoutFlags that indicates that this {@code GlyphVector} has
* a right-to-left run direction. This refers to the glyph-to-char mapping and does
* not imply that the visual locations of the glyphs are necessarily in this order,
* although generally they will be.
@@ -450,7 +450,7 @@
public static final int FLAG_RUN_RTL = 4;
/**
- * A flag used with getLayoutFlags that indicates that this GlyphVector has
+ * A flag used with getLayoutFlags that indicates that this {@code GlyphVector} has
* a complex glyph-to-char mapping (one that does not map glyphs to chars one-to-one in
* strictly ascending or descending order matching the run direction).
* @since 1.4
@@ -474,86 +474,86 @@
* processing glyph positions.
* If no array is passed in, a new array is created.
* Even numbered array entries beginning with position zero are the X
- * coordinates of the glyph numbered beginGlyphIndex + position/2.
+ * coordinates of the glyph numbered {@code beginGlyphIndex + position/2}.
* Odd numbered array entries beginning with position one are the Y
- * coordinates of the glyph numbered beginGlyphIndex + (position-1)/2.
- * If beginGlyphIndex equals the number of glyphs in
- * this GlyphVector, this method gets the position after
+ * coordinates of the glyph numbered {@code beginGlyphIndex + (position-1)/2}.
+ * If {@code beginGlyphIndex} equals the number of glyphs in
+ * this {@code GlyphVector}, this method gets the position after
* the last glyph and this position is used to define the advance of
- * the entire GlyphVector.
+ * the entire {@code GlyphVector}.
* @param beginGlyphIndex the index at which to begin retrieving
* glyph positions
* @param numEntries the number of glyphs to retrieve
* @param positionReturn the array that receives the glyph positions
* and is then returned.
* @return an array of glyph positions specified by
- * beginGlyphIndex and numEntries.
- * @throws IllegalArgumentException if numEntries is
+ * {@code beginGlyphIndex} and {@code numEntries}.
+ * @throws IllegalArgumentException if {@code numEntries} is
* less than 0
- * @throws IndexOutOfBoundsException if beginGlyphIndex
+ * @throws IndexOutOfBoundsException if {@code beginGlyphIndex}
* is less than 0
* @throws IndexOutOfBoundsException if the sum of
- * beginGlyphIndex and numEntries
+ * {@code beginGlyphIndex} and {@code numEntries}
* is greater than the number of glyphs in this
- * GlyphVector plus one
+ * {@code GlyphVector} plus one
*/
public abstract float[] getGlyphPositions(int beginGlyphIndex, int numEntries,
float[] positionReturn);
/**
* Returns the logical bounds of the specified glyph within this
- * GlyphVector.
+ * {@code GlyphVector}.
* These logical bounds have a total of four edges, with two edges
* parallel to the baseline under the glyph's transform and the other two
* edges are shared with adjacent glyphs if they are present. This
* method is useful for hit-testing of the specified glyph,
* positioning of a caret at the leading or trailing edge of a glyph,
* and for drawing a highlight region around the specified glyph.
- * @param glyphIndex the index into this GlyphVector
+ * @param glyphIndex the index into this {@code GlyphVector}
* that corresponds to the glyph from which to retrieve its logical
* bounds
- * @return a Shape that is the logical bounds of the
- * glyph at the specified glyphIndex.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * @return a {@code Shape} that is the logical bounds of the
+ * glyph at the specified {@code glyphIndex}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
* @see #getGlyphVisualBounds
*/
public abstract Shape getGlyphLogicalBounds(int glyphIndex);
/**
* Returns the visual bounds of the specified glyph within the
- * GlyphVector.
+ * {@code GlyphVector}.
* The bounds returned by this method is positioned around the
* origin of each individual glyph.
- * @param glyphIndex the index into this GlyphVector
+ * @param glyphIndex the index into this {@code GlyphVector}
* that corresponds to the glyph from which to retrieve its visual
* bounds
- * @return a Shape that is the visual bounds of the
- * glyph at the specified glyphIndex.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * @return a {@code Shape} that is the visual bounds of the
+ * glyph at the specified {@code glyphIndex}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
* @see #getGlyphLogicalBounds
*/
public abstract Shape getGlyphVisualBounds(int glyphIndex);
/**
* Returns the pixel bounds of the glyph at index when this
- * GlyphVector is rendered in a Graphics with the
- * given FontRenderContext at the given location. The
+ * {@code GlyphVector} is rendered in a {@code Graphics} with the
+ * given {@code FontRenderContext} at the given location. The
* renderFRC need not be the same as the
- * FontRenderContext of this
- * GlyphVector, and can be null. If it is null, the
- * FontRenderContext of this GlyphVector
+ * {@code FontRenderContext} of this
+ * {@code GlyphVector}, and can be null. If it is null, the
+ * {@code FontRenderContext} of this {@code GlyphVector}
* is used. The default implementation returns the visual bounds of the glyph,
* offset to x, y and rounded out to the next integer value, and
* ignores the FRC. Subclassers should override this method.
* @param index the index of the glyph.
- * @param renderFRC the FontRenderContext of the Graphics.
- * @param x the X position at which to render this GlyphVector.
- * @param y the Y position at which to render this GlyphVector.
- * @return a Rectangle bounding the pixels that would be affected.
+ * @param renderFRC the {@code FontRenderContext} of the {@code Graphics}.
+ * @param x the X position at which to render this {@code GlyphVector}.
+ * @param y the Y position at which to render this {@code GlyphVector}.
+ * @return a {@code Rectangle} bounding the pixels that would be affected.
* @since 1.4
*/
public Rectangle getGlyphPixelBounds(int index, FontRenderContext renderFRC, float x, float y) {
@@ -567,31 +567,31 @@
/**
* Returns the metrics of the glyph at the specified index into
- * this GlyphVector.
- * @param glyphIndex the index into this GlyphVector
+ * this {@code GlyphVector}.
+ * @param glyphIndex the index into this {@code GlyphVector}
* that corresponds to the glyph from which to retrieve its metrics
* @return a {@link GlyphMetrics} object that represents the
- * metrics of the glyph at the specified glyphIndex
- * into this GlyphVector.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * metrics of the glyph at the specified {@code glyphIndex}
+ * into this {@code GlyphVector}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
*/
public abstract GlyphMetrics getGlyphMetrics(int glyphIndex);
/**
* Returns the justification information for the glyph at
- * the specified index into this GlyphVector.
- * @param glyphIndex the index into this GlyphVector
+ * the specified index into this {@code GlyphVector}.
+ * @param glyphIndex the index into this {@code GlyphVector}
* that corresponds to the glyph from which to retrieve its
* justification properties
* @return a {@link GlyphJustificationInfo} object that
* represents the justification properties of the glyph at the
- * specified glyphIndex into this
- * GlyphVector.
- * @throws IndexOutOfBoundsException if glyphIndex
+ * specified {@code glyphIndex} into this
+ * {@code GlyphVector}.
+ * @throws IndexOutOfBoundsException if {@code glyphIndex}
* is less than 0 or greater than or equal to the number
- * of glyphs in this GlyphVector
+ * of glyphs in this {@code GlyphVector}
*/
public abstract GlyphJustificationInfo getGlyphJustificationInfo(int glyphIndex);
@@ -600,12 +600,12 @@
//
/**
- * Tests if the specified GlyphVector exactly
- * equals this GlyphVector.
- * @param set the specified GlyphVector to test
- * @return true if the specified
- * GlyphVector equals this GlyphVector;
- * false otherwise.
+ * Tests if the specified {@code GlyphVector} exactly
+ * equals this {@code GlyphVector}.
+ * @param set the specified {@code GlyphVector} to test
+ * @return {@code true} if the specified
+ * {@code GlyphVector} equals this {@code GlyphVector};
+ * {@code false} otherwise.
*/
public abstract boolean equals(GlyphVector set);
}
--- old/src/java.desktop/share/classes/java/awt/font/GraphicAttribute.java 2015-10-04 22:53:45.377271379 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GraphicAttribute.java 2015-10-04 22:53:45.189271387 +0400
@@ -49,7 +49,7 @@
/**
* This class is used with the CHAR_REPLACEMENT attribute.
* GraphicAttribute class represents a graphic embedded
+ * The {@code GraphicAttribute} class represents a graphic embedded
* in text. Clients subclass this class to implement their own char
* replacement graphics. Clients wishing to embed shapes and images in
* text need not subclass this class. Instead, clients can use the
@@ -57,9 +57,9 @@
* classes.
* GraphicAttribute that
+ * are constructed. Mutating a {@code GraphicAttribute} that
* is used in a {@link TextLayout} results in undefined behavior from the
- * TextLayout.
+ * {@code TextLayout}.
*/
public abstract class GraphicAttribute {
@@ -91,10 +91,10 @@
public static final int HANGING_BASELINE = Font.HANGING_BASELINE;
/**
- * Constructs a GraphicAttribute.
+ * Constructs a {@code GraphicAttribute}.
* Subclasses use this to define the alignment of the graphic.
* @param alignment an int representing one of the
- * GraphicAttribute alignment fields
+ * {@code GraphicAttribute} alignment fields
* @throws IllegalArgumentException if alignment is not one of the
* five defined values.
*/
@@ -106,43 +106,43 @@
}
/**
- * Returns the ascent of this GraphicAttribute. A
+ * Returns the ascent of this {@code GraphicAttribute}. A
* graphic can be rendered above its ascent.
- * @return the ascent of this GraphicAttribute.
+ * @return the ascent of this {@code GraphicAttribute}.
* @see #getBounds()
*/
public abstract float getAscent();
/**
- * Returns the descent of this GraphicAttribute. A
+ * Returns the descent of this {@code GraphicAttribute}. A
* graphic can be rendered below its descent.
- * @return the descent of this GraphicAttribute.
+ * @return the descent of this {@code GraphicAttribute}.
* @see #getBounds()
*/
public abstract float getDescent();
/**
- * Returns the advance of this GraphicAttribute. The
- * GraphicAttribute object's advance is the distance
+ * Returns the advance of this {@code GraphicAttribute}. The
+ * {@code GraphicAttribute} object's advance is the distance
* from the point at which the graphic is rendered and the point where
* the next character or graphic is rendered. A graphic can be
* rendered beyond its advance
- * @return the advance of this GraphicAttribute.
+ * @return the advance of this {@code GraphicAttribute}.
* @see #getBounds()
*/
public abstract float getAdvance();
/**
* Returns a {@link Rectangle2D} that encloses all of the
- * bits drawn by this GraphicAttribute relative to the
+ * bits drawn by this {@code GraphicAttribute} relative to the
* rendering position.
* A graphic may be rendered beyond its origin, ascent, descent,
* or advance; but if it is, this method's implementation must
* indicate where the graphic is rendered.
* Default bounds is the rectangle (0, -ascent, advance, ascent+descent).
- * @return a Rectangle2D that encloses all of the bits
- * rendered by this GraphicAttribute.
+ * @return a {@code Rectangle2D} that encloses all of the bits
+ * rendered by this {@code GraphicAttribute}.
*/
public Rectangle2D getBounds() {
float ascent = getAscent();
@@ -152,16 +152,16 @@
/**
* Return a {@link java.awt.Shape} that represents the region that
- * this GraphicAttribute renders. This is used when a
+ * this {@code GraphicAttribute} renders. This is used when a
* {@link TextLayout} is requested to return the outline of the text.
* The (untransformed) shape must not extend outside the rectangular
- * bounds returned by getBounds.
+ * bounds returned by {@code getBounds}.
* The default implementation returns the rectangle returned by
* {@link #getBounds}, transformed by the provided {@link AffineTransform}
* if present.
* @param tx an optional {@link AffineTransform} to apply to the
- * outline of this GraphicAttribute. This can be null.
- * @return a Shape representing this graphic attribute,
+ * outline of this {@code GraphicAttribute}. This can be null.
+ * @return a {@code Shape} representing this graphic attribute,
* suitable for stroking or filling.
* @since 1.6
*/
@@ -174,7 +174,7 @@
}
/**
- * Renders this GraphicAttribute at the specified
+ * Renders this {@code GraphicAttribute} at the specified
* location.
* @param graphics the {@link Graphics2D} into which to render the
* graphic
@@ -184,10 +184,10 @@
public abstract void draw(Graphics2D graphics, float x, float y);
/**
- * Returns the alignment of this GraphicAttribute.
+ * Returns the alignment of this {@code GraphicAttribute}.
* Alignment can be to a particular baseline, or to the absolute top
* or bottom of a line.
- * @return the alignment of this GraphicAttribute.
+ * @return the alignment of this {@code GraphicAttribute}.
*/
public final int getAlignment() {
@@ -196,11 +196,11 @@
/**
* Returns the justification information for this
- * GraphicAttribute. Subclasses
+ * {@code GraphicAttribute}. Subclasses
* can override this method to provide different justification
* information.
* @return a {@link GlyphJustificationInfo} object that contains the
- * justification information for this GraphicAttribute.
+ * justification information for this {@code GraphicAttribute}.
*/
public GlyphJustificationInfo getJustificationInfo() {
--- old/src/java.desktop/share/classes/java/awt/font/ImageGraphicAttribute.java 2015-10-04 22:53:45.921271354 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/ImageGraphicAttribute.java 2015-10-04 22:53:45.733271363 +0400
@@ -45,7 +45,7 @@
import java.awt.geom.Rectangle2D;
/**
- * The ImageGraphicAttribute class is an implementation of
+ * The {@code ImageGraphicAttribute} class is an implementation of
* {@link GraphicAttribute} which draws images in
* a {@link TextLayout}.
* @see GraphicAttribute
@@ -58,13 +58,13 @@
private float fOriginX, fOriginY;
/**
- * Constructs an ImageGraphicAttribute from the specified
+ * Constructs an {@code ImageGraphicAttribute} from the specified
* {@link Image}. The origin is at (0, 0).
- * @param image the Image rendered by this
- * ImageGraphicAttribute.
- * This object keeps a reference to image.
+ * @param image the {@code Image} rendered by this
+ * {@code ImageGraphicAttribute}.
+ * This object keeps a reference to {@code image}.
* @param alignment one of the alignments from this
- * ImageGraphicAttribute
+ * {@code ImageGraphicAttribute}
*/
public ImageGraphicAttribute(Image image, int alignment) {
@@ -72,22 +72,22 @@
}
/**
- * Constructs an ImageGraphicAttribute from the specified
- * Image. The point
- * (originX, originY) in the
- * Image appears at the origin of the
- * ImageGraphicAttribute within the text.
- * @param image the Image rendered by this
- * ImageGraphicAttribute.
- * This object keeps a reference to image.
+ * Constructs an {@code ImageGraphicAttribute} from the specified
+ * {@code Image}. The point
+ * ({@code originX}, {@code originY}) in the
+ * {@code Image} appears at the origin of the
+ * {@code ImageGraphicAttribute} within the text.
+ * @param image the {@code Image} rendered by this
+ * {@code ImageGraphicAttribute}.
+ * This object keeps a reference to {@code image}.
* @param alignment one of the alignments from this
- * ImageGraphicAttribute
+ * {@code ImageGraphicAttribute}
* @param originX the X coordinate of the point within
- * the Image that appears at the origin of the
- * ImageGraphicAttribute in the text line.
+ * the {@code Image} that appears at the origin of the
+ * {@code ImageGraphicAttribute} in the text line.
* @param originY the Y coordinate of the point within
- * the Image that appears at the origin of the
- * ImageGraphicAttribute in the text line.
+ * the {@code Image} that appears at the origin of the
+ * {@code ImageGraphicAttribute} in the text line.
*/
public ImageGraphicAttribute(Image image,
int alignment,
@@ -109,10 +109,10 @@
}
/**
- * Returns the ascent of this ImageGraphicAttribute. The
- * ascent of an ImageGraphicAttribute is the distance
+ * Returns the ascent of this {@code ImageGraphicAttribute}. The
+ * ascent of an {@code ImageGraphicAttribute} is the distance
* from the top of the image to the origin.
- * @return the ascent of this ImageGraphicAttribute.
+ * @return the ascent of this {@code ImageGraphicAttribute}.
*/
public float getAscent() {
@@ -120,10 +120,10 @@
}
/**
- * Returns the descent of this ImageGraphicAttribute.
- * The descent of an ImageGraphicAttribute is the
+ * Returns the descent of this {@code ImageGraphicAttribute}.
+ * The descent of an {@code ImageGraphicAttribute} is the
* distance from the origin to the bottom of the image.
- * @return the descent of this ImageGraphicAttribute.
+ * @return the descent of this {@code ImageGraphicAttribute}.
*/
public float getDescent() {
@@ -131,10 +131,10 @@
}
/**
- * Returns the advance of this ImageGraphicAttribute.
- * The advance of an ImageGraphicAttribute is the
+ * Returns the advance of this {@code ImageGraphicAttribute}.
+ * The advance of an {@code ImageGraphicAttribute} is the
* distance from the origin to the right edge of the image.
- * @return the advance of this ImageGraphicAttribute.
+ * @return the advance of this {@code ImageGraphicAttribute}.
*/
public float getAdvance() {
@@ -143,12 +143,12 @@
/**
* Returns a {@link Rectangle2D} that encloses all of the
- * bits rendered by this ImageGraphicAttribute, relative
+ * bits rendered by this {@code ImageGraphicAttribute}, relative
* to the rendering position. A graphic can be rendered beyond its
* origin, ascent, descent, or advance; but if it is, this
* method's implementation must indicate where the graphic is rendered.
- * @return a Rectangle2D that encloses all of the bits
- * rendered by this ImageGraphicAttribute.
+ * @return a {@code Rectangle2D} that encloses all of the bits
+ * rendered by this {@code ImageGraphicAttribute}.
*/
public Rectangle2D getBounds() {
@@ -165,7 +165,7 @@
}
/**
- * Returns a hashcode for this ImageGraphicAttribute.
+ * Returns a hashcode for this {@code ImageGraphicAttribute}.
* @return a hash code value for this object.
*/
public int hashCode() {
@@ -174,12 +174,12 @@
}
/**
- * Compares this ImageGraphicAttribute to the specified
+ * Compares this {@code ImageGraphicAttribute} to the specified
* {@link Object}.
- * @param rhs the Object to compare for equality
- * @return true if this
- * ImageGraphicAttribute equals rhs;
- * false otherwise.
+ * @param rhs the {@code Object} to compare for equality
+ * @return {@code true} if this
+ * {@code ImageGraphicAttribute} equals {@code rhs};
+ * {@code false} otherwise.
*/
public boolean equals(Object rhs) {
@@ -192,13 +192,13 @@
}
/**
- * Compares this ImageGraphicAttribute to the specified
- * ImageGraphicAttribute.
- * @param rhs the ImageGraphicAttribute to compare for
+ * Compares this {@code ImageGraphicAttribute} to the specified
+ * {@code ImageGraphicAttribute}.
+ * @param rhs the {@code ImageGraphicAttribute} to compare for
* equality
- * @return true if this
- * ImageGraphicAttribute equals rhs;
- * false otherwise.
+ * @return {@code true} if this
+ * {@code ImageGraphicAttribute} equals {@code rhs};
+ * {@code false} otherwise.
*/
public boolean equals(ImageGraphicAttribute rhs) {
--- old/src/java.desktop/share/classes/java/awt/font/LayoutPath.java 2015-10-04 22:53:46.453271330 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/LayoutPath.java 2015-10-04 22:53:46.265271339 +0400
@@ -35,7 +35,7 @@
* along the baseline, and an offset perpendicular to the baseline at
* the advance. Positive values along the perpendicular are in the
* direction that is 90 degrees clockwise from the baseline vector.
- * Locations are represented as a Point2D, where x is the advance and
+ * Locations are represented as a {@code Point2D}, where x is the advance and
* y is the offset.
*
* @since 1.6
@@ -49,7 +49,7 @@
* the location with the smallest advance is chosen.
* @param point the point to convert. If it is not the same
* object as location, point will remain unmodified by this call.
- * @param location a Point2D to hold the returned location.
+ * @param location a {@code Point2D} to hold the returned location.
* It can be the same object as point.
* @return true if the point is associated with the portion of the
* path preceding the location, false if it is associated with
@@ -66,7 +66,7 @@
* the location's advance. If this is the case, the value of
* 'preceding' is used to disambiguate the portion of the path
* whose location and slope is to be used to interpret the offset.
- * @param location a Point2D representing the advance (in x) and
+ * @param location a {@code Point2D} representing the advance (in x) and
* offset (in y) of a location relative to the path. If location
* is not the same object as point, location will remain
* unmodified by this call.
@@ -74,7 +74,7 @@
* should be used, if false the portion after should be used.
* This has no effect if the path does not break or bend sharply
* at the advance.
- * @param point a Point2D to hold the returned point. It can be
+ * @param point a {@code Point2D} to hold the returned point. It can be
* the same object as location.
* @throws NullPointerException if location or point is null
* @since 1.6
--- old/src/java.desktop/share/classes/java/awt/font/LineBreakMeasurer.java 2015-10-04 22:53:46.985271307 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/LineBreakMeasurer.java 2015-10-04 22:53:46.797271315 +0400
@@ -46,16 +46,16 @@
import java.awt.font.FontRenderContext;
/**
- * The LineBreakMeasurer class allows styled text to be
+ * The {@code LineBreakMeasurer} class allows styled text to be
* broken into lines (or segments) that fit within a particular visual
* advance. This is useful for clients who wish to display a paragraph of
* text that fits within a specific width, called the wrapping
* width.
* LineBreakMeasurer is constructed with an iterator over
+ * {@code LineBreakMeasurer} is constructed with an iterator over
* styled text. The iterator's range should be a single paragraph in the
* text.
- * LineBreakMeasurer maintains a position in the text for the
+ * {@code LineBreakMeasurer} maintains a position in the text for the
* start of the next text segment. Initially, this position is the
* start of text. Paragraphs are assigned an overall direction (either
* left-to-right or right-to-left) according to the bidirectional
@@ -63,24 +63,24 @@
* same direction as the paragraph.
* nextLayout, which returns a {@link TextLayout}
+ * {@code nextLayout}, which returns a {@link TextLayout}
* representing the text that fits within the wrapping width.
- * The nextLayout method moves the current position
- * to the end of the layout returned from nextLayout.
+ * The {@code nextLayout} method moves the current position
+ * to the end of the layout returned from {@code nextLayout}.
* LineBreakMeasurer implements the most commonly used
+ * {@code LineBreakMeasurer} implements the most commonly used
* line-breaking policy: Every word that fits within the wrapping
* width is placed on the line. If the first word does not fit, then all
* of the characters that fit within the wrapping width are placed on the
* line. At least one character is placed on each line.
* TextLayout instances returned by
- * LineBreakMeasurer treat tabs like 0-width spaces. Clients
+ * The {@code TextLayout} instances returned by
+ * {@code LineBreakMeasurer} treat tabs like 0-width spaces. Clients
* who wish to obtain tab-delimited segments for positioning should use
- * the overload of nextLayout which takes a limiting offset
+ * the overload of {@code nextLayout} which takes a limiting offset
* in the text.
* The limiting offset should be the first character after the tab.
- * The TextLayout objects returned from this method end
+ * The {@code TextLayout} objects returned from this method end
* at the limit provided (or before, if the text between the current
* position and the limit won't fit entirely within the wrapping
* width).
@@ -90,22 +90,22 @@
* placed on a line. Instead of fitting partial words in the
* remaining space, they should place words which don't fit in the
* remaining space entirely on the next line. This change of policy
- * can be requested in the overload of nextLayout which
- * takes a boolean parameter. If this parameter is
- * true, nextLayout returns
- * null if the first word won't fit in
+ * can be requested in the overload of {@code nextLayout} which
+ * takes a {@code boolean} parameter. If this parameter is
+ * {@code true}, {@code nextLayout} returns
+ * {@code null} if the first word won't fit in
* the given space. See the tab sample below.
* LineBreakMeasurer changes, a new
- * LineBreakMeasurer must be constructed to reflect
- * the change. (The old LineBreakMeasurer continues to
+ * {@code LineBreakMeasurer} changes, a new
+ * {@code LineBreakMeasurer} must be constructed to reflect
+ * the change. (The old {@code LineBreakMeasurer} continues to
* function properly, but it won't be aware of the text change.)
* Nevertheless, if the text change is the insertion or deletion of a
- * single character, an existing LineBreakMeasurer can be
- * 'updated' by calling insertChar or
- * deleteChar. Updating an existing
- * LineBreakMeasurer is much faster than creating a new one.
+ * single character, an existing {@code LineBreakMeasurer} can be
+ * 'updated' by calling {@code insertChar} or
+ * {@code deleteChar}. Updating an existing
+ * {@code LineBreakMeasurer} is much faster than creating a new one.
* Clients who modify text based on user typing should take advantage
* of these methods.
* LineBreakMeasurer for the specified text.
+ * Constructs a {@code LineBreakMeasurer} for the specified text.
*
- * @param text the text for which this LineBreakMeasurer
- * produces TextLayout objects; the text must contain
+ * @param text the text for which this {@code LineBreakMeasurer}
+ * produces {@code TextLayout} objects; the text must contain
* at least one character; if the text available through
- * iter changes, further calls to this
- * LineBreakMeasurer instance are undefined (except,
- * in some cases, when insertChar or
- * deleteChar are invoked afterward - see below)
+ * {@code iter} changes, further calls to this
+ * {@code LineBreakMeasurer} instance are undefined (except,
+ * in some cases, when {@code insertChar} or
+ * {@code deleteChar} are invoked afterward - see below)
* @param frc contains information about a graphics device which is
* needed to measure the text correctly;
* text measurements can vary slightly depending on the
* device resolution, and attributes such as antialiasing; this
* parameter does not specify a translation between the
- * LineBreakMeasurer and user space
+ * {@code LineBreakMeasurer} and user space
* @see LineBreakMeasurer#insertChar
* @see LineBreakMeasurer#deleteChar
*/
@@ -278,15 +278,15 @@
}
/**
- * Constructs a LineBreakMeasurer for the specified text.
+ * Constructs a {@code LineBreakMeasurer} for the specified text.
*
- * @param text the text for which this LineBreakMeasurer
- * produces TextLayout objects; the text must contain
+ * @param text the text for which this {@code LineBreakMeasurer}
+ * produces {@code TextLayout} objects; the text must contain
* at least one character; if the text available through
- * iter changes, further calls to this
- * LineBreakMeasurer instance are undefined (except,
- * in some cases, when insertChar or
- * deleteChar are invoked afterward - see below)
+ * {@code iter} changes, further calls to this
+ * {@code LineBreakMeasurer} instance are undefined (except,
+ * in some cases, when {@code insertChar} or
+ * {@code deleteChar} are invoked afterward - see below)
* @param breakIter the {@link BreakIterator} which defines line
* breaks
* @param frc contains information about a graphics device which is
@@ -294,7 +294,7 @@
* text measurements can vary slightly depending on the
* device resolution, and attributes such as antialiasing; this
* parameter does not specify a translation between the
- * LineBreakMeasurer and user space
+ * {@code LineBreakMeasurer} and user space
* @throws IllegalArgumentException if the text has less than one character
* @see LineBreakMeasurer#insertChar
* @see LineBreakMeasurer#deleteChar
@@ -317,12 +317,12 @@
/**
* Returns the position at the end of the next layout. Does NOT
- * update the current position of this LineBreakMeasurer.
+ * update the current position of this {@code LineBreakMeasurer}.
*
* @param wrappingWidth the maximum visible advance permitted for
* the text in the next layout
* @return an offset in the text representing the limit of the
- * next TextLayout.
+ * next {@code TextLayout}.
*/
public int nextOffset(float wrappingWidth) {
return nextOffset(wrappingWidth, limit, false);
@@ -330,20 +330,20 @@
/**
* Returns the position at the end of the next layout. Does NOT
- * update the current position of this LineBreakMeasurer.
+ * update the current position of this {@code LineBreakMeasurer}.
*
* @param wrappingWidth the maximum visible advance permitted for
* the text in the next layout
* @param offsetLimit the first character that can not be included
* in the next layout, even if the text after the limit would fit
- * within the wrapping width; offsetLimit must be
+ * within the wrapping width; {@code offsetLimit} must be
* greater than the current position
- * @param requireNextWord if true, the current position
+ * @param requireNextWord if {@code true}, the current position
* that is returned if the entire next word does not fit within
- * wrappingWidth; if false, the offset
+ * {@code wrappingWidth}; if {@code false}, the offset
* returned is at least one greater than the current position
* @return an offset in the text representing the limit of the
- * next TextLayout
+ * next {@code TextLayout}
*/
public int nextOffset(float wrappingWidth, int offsetLimit,
boolean requireNextWord) {
@@ -405,9 +405,9 @@
*
* @param wrappingWidth the maximum visible advance permitted for
* the text in the next layout
- * @return a TextLayout, beginning at the current
+ * @return a {@code TextLayout}, beginning at the current
* position, which represents the next line fitting within
- * wrappingWidth
+ * {@code wrappingWidth}
*/
public TextLayout nextLayout(float wrappingWidth) {
return nextLayout(wrappingWidth, limit, false);
@@ -420,18 +420,18 @@
* for the text in the next layout
* @param offsetLimit the first character that can not be
* included in the next layout, even if the text after the limit
- * would fit within the wrapping width; offsetLimit
+ * would fit within the wrapping width; {@code offsetLimit}
* must be greater than the current position
- * @param requireNextWord if true, and if the entire word
+ * @param requireNextWord if {@code true}, and if the entire word
* at the current position does not fit within the wrapping width,
- * null is returned. If false, a valid
+ * {@code null} is returned. If {@code false}, a valid
* layout is returned that includes at least the character at the
* current position
- * @return a TextLayout, beginning at the current
+ * @return a {@code TextLayout}, beginning at the current
* position, that represents the next line fitting within
- * wrappingWidth. If the current position is at the end
- * of the text used by this LineBreakMeasurer,
- * null is returned
+ * {@code wrappingWidth}. If the current position is at the end
+ * of the text used by this {@code LineBreakMeasurer},
+ * {@code null} is returned
*/
public TextLayout nextLayout(float wrappingWidth, int offsetLimit,
boolean requireNextWord) {
@@ -452,9 +452,9 @@
}
/**
- * Returns the current position of this LineBreakMeasurer.
+ * Returns the current position of this {@code LineBreakMeasurer}.
*
- * @return the current position of this LineBreakMeasurer
+ * @return the current position of this {@code LineBreakMeasurer}
* @see #setPosition
*/
public int getPosition() {
@@ -462,13 +462,13 @@
}
/**
- * Sets the current position of this LineBreakMeasurer.
+ * Sets the current position of this {@code LineBreakMeasurer}.
*
* @param newPosition the current position of this
- * LineBreakMeasurer; the position should be within the
- * text used to construct this LineBreakMeasurer (or in
- * the text most recently passed to insertChar
- * or deleteChar
+ * {@code LineBreakMeasurer}; the position should be within the
+ * text used to construct this {@code LineBreakMeasurer} (or in
+ * the text most recently passed to {@code insertChar}
+ * or {@code deleteChar}
* @see #getPosition
*/
public void setPosition(int newPosition) {
@@ -479,18 +479,18 @@
}
/**
- * Updates this LineBreakMeasurer after a single
+ * Updates this {@code LineBreakMeasurer} after a single
* character is inserted into the text, and sets the current
* position to the beginning of the paragraph.
*
* @param newParagraph the text after the insertion
* @param insertPos the position in the text at which the character
* is inserted
- * @throws IndexOutOfBoundsException if insertPos is less
- * than the start of newParagraph or greater than
- * or equal to the end of newParagraph
- * @throws NullPointerException if newParagraph is
- * null
+ * @throws IndexOutOfBoundsException if {@code insertPos} is less
+ * than the start of {@code newParagraph} or greater than
+ * or equal to the end of {@code newParagraph}
+ * @throws NullPointerException if {@code newParagraph} is
+ * {@code null}
* @see #deleteChar
*/
public void insertChar(AttributedCharacterIterator newParagraph,
@@ -506,17 +506,17 @@
}
/**
- * Updates this LineBreakMeasurer after a single
+ * Updates this {@code LineBreakMeasurer} after a single
* character is deleted from the text, and sets the current
* position to the beginning of the paragraph.
* @param newParagraph the text after the deletion
* @param deletePos the position in the text at which the character
* is deleted
- * @throws IndexOutOfBoundsException if deletePos is
- * less than the start of newParagraph or greater
- * than the end of newParagraph
- * @throws NullPointerException if newParagraph is
- * null
+ * @throws IndexOutOfBoundsException if {@code deletePos} is
+ * less than the start of {@code newParagraph} or greater
+ * than the end of {@code newParagraph}
+ * @throws NullPointerException if {@code newParagraph} is
+ * {@code null}
* @see #insertChar
*/
public void deleteChar(AttributedCharacterIterator newParagraph,
--- old/src/java.desktop/share/classes/java/awt/font/LineMetrics.java 2015-10-04 22:53:47.521271283 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/LineMetrics.java 2015-10-04 22:53:47.333271291 +0400
@@ -26,16 +26,16 @@
package java.awt.font;
/**
-* The LineMetrics class allows access to the
+* The {@code LineMetrics} class allows access to the
* metrics needed to layout characters along a line
-* and to layout of a set of lines. A LineMetrics
+* and to layout of a set of lines. A {@code LineMetrics}
* object encapsulates the measurement information associated
* with a run of text.
* getLineMetrics methods of
+* characters. The {@code getLineMetrics} methods of
* {@link java.awt.Font Font} take some text as an argument
-* and return a LineMetrics object describing the
+* and return a {@code LineMetrics} object describing the
* metrics of the initial number of characters in that text, as
* returned by {@link #getNumChars}.
*/
@@ -45,11 +45,11 @@
/**
- * Returns the number of characters (char values) in the text whose
- * metrics are encapsulated by this LineMetrics
+ * Returns the number of characters ({@code char} values) in the text whose
+ * metrics are encapsulated by this {@code LineMetrics}
* object.
- * @return the number of characters (char values) in the text with which
- * this LineMetrics was created.
+ * @return the number of characters ({@code char} values) in the text with which
+ * this {@code LineMetrics} was created.
*/
public abstract int getNumChars();
@@ -106,10 +106,10 @@
* relative to the baseline of the text. The
* offsets are indexed by baseline index. For
* example, if the baseline index is
- * CENTER_BASELINE then
- * offsets[HANGING_BASELINE] is usually
- * negative, offsets[CENTER_BASELINE]
- * is zero, and offsets[ROMAN_BASELINE]
+ * {@code CENTER_BASELINE} then
+ * {@code offsets[HANGING_BASELINE]} is usually
+ * negative, {@code offsets[CENTER_BASELINE]}
+ * is zero, and {@code offsets[ROMAN_BASELINE]}
* is usually positive.
* @return the baseline offsets of the text.
*/
--- old/src/java.desktop/share/classes/java/awt/font/MultipleMaster.java 2015-10-04 22:53:48.065271258 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/MultipleMaster.java 2015-10-04 22:53:47.873271267 +0400
@@ -27,7 +27,7 @@
import java.awt.Font;
/**
- * The MultipleMaster interface represents Type 1
+ * The {@code MultipleMaster} interface represents Type 1
* Multiple Master fonts.
* A particular {@link Font} object can implement this interface.
*/
@@ -45,7 +45,7 @@
* for each axis. For example,
* design limits for weight could be from 0.1 to 1.0. The values are
* returned in the same order returned by
- * getDesignAxisNames.
+ * {@code getDesignAxisNames}.
* @return an array of design limits for each axis.
*/
public float[] getDesignAxisRanges();
@@ -53,7 +53,7 @@
/**
* Returns an array of default design values for each axis. For example,
* the default value for weight could be 1.6. The values are returned
- * in the same order returned by getDesignAxisNames.
+ * in the same order returned by {@code getDesignAxisNames}.
* @return an array of default design values for each axis.
*/
public float[] getDesignAxisDefaults();
@@ -69,20 +69,20 @@
* Creates a new instance of a multiple master font based on the design
* axis values contained in the specified array. The size of the array
* must correspond to the value returned from
- * getNumDesignAxes and the values of the array elements
+ * {@code getNumDesignAxes} and the values of the array elements
* must fall within limits specified by
- * getDesignAxesLimits. In case of an error,
- * null is returned.
+ * {@code getDesignAxesLimits}. In case of an error,
+ * {@code null} is returned.
* @param axes an array containing axis values
* @return a {@link Font} object that is an instance of
- * MultipleMaster and is based on the design axis values
- * provided by axes.
+ * {@code MultipleMaster} and is based on the design axis values
+ * provided by {@code axes}.
*/
public Font deriveMMFont(float[] axes);
/**
* Creates a new instance of a multiple master font based on detailed metric
- * information. In case of an error, null is returned.
+ * information. In case of an error, {@code null} is returned.
* @param glyphWidths an array of floats representing the desired width
* of each glyph in font space
* @param avgStemWidth the average stem width for the overall font in
@@ -91,8 +91,8 @@
* @param typicalXHeight the height of a typical lower case char
* @param italicAngle the angle at which the italics lean, in degrees
* counterclockwise from vertical
- * @return a Font object that is an instance of
- * MultipleMaster and is based on the specified metric
+ * @return a {@code Font} object that is an instance of
+ * {@code MultipleMaster} and is based on the specified metric
* information.
*/
public Font deriveMMFont(
--- old/src/java.desktop/share/classes/java/awt/font/NumericShaper.java 2015-10-04 22:53:48.589271235 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/NumericShaper.java 2015-10-04 22:53:48.397271243 +0400
@@ -34,18 +34,18 @@
import jdk.internal.misc.SharedSecrets;
/**
- * The NumericShaper class is used to convert Latin-1 (European)
+ * The {@code NumericShaper} class is used to convert Latin-1 (European)
* digits to other Unicode decimal digits. Users of this class will
* primarily be people who wish to present data using
* national digit shapes, but find it more convenient to represent the
* data internally using Latin-1 (European) digits. This does not
* interpret the deprecated numeric shape selector character (U+206E).
* NumericShaper are typically applied
+ * Instances of {@code NumericShaper} are typically applied
* as attributes to text with the
* {@link TextAttribute#NUMERIC_SHAPING NUMERIC_SHAPING} attribute
- * of the TextAttribute class.
- * For example, this code snippet causes a TextLayout to
+ * of the {@code TextAttribute} class.
+ * For example, this code snippet causes a {@code TextLayout} to
* shape European digits to Arabic in an Arabic context:
*
*
* Map map = new HashMap();
@@ -57,7 +57,7 @@
*
* It is also possible to perform numeric shaping explicitly using instances
- * of NumericShaper, as this code snippet demonstrates:
+ * of {@code NumericShaper}, as this code snippet demonstrates:
*
* char[] text = ...;
* // shape all EUROPEAN digits (except zero) to ARABIC digits
@@ -109,7 +109,7 @@
*
MIME-Type Description
*
- *
* "application/pdf"{@code "application/pdf"}
* Portable Document Format document
*
- *
* "application/postscript"{@code "application/postscript"}
* PostScript document
*
- *
*
@@ -251,15 +251,15 @@
*
*
* "application/vnd.hp-PCL"{@code "application/vnd.hp-PCL"}
* Printer Control Language document
*
- *
* "image/gif"{@code "image/gif"}
* Graphics Interchange Format image
*
- *
* "image/jpeg"{@code "image/jpeg"}
* Joint Photographic Experts Group image
*
- *
*
@@ -275,7 +275,7 @@
*
*
* "image/png"{@code "image/png"}
* Portable Network Graphics image
*
- *
*
- * For convenience, "application/octet-stream"{@code "application/octet-stream"}
* The print data format is unspecified (just an octet stream)
*
* DocPrintJob invokes to
+ * denotes an interface whose methods the {@code DocPrintJob} invokes to
* determine the content to be printed -- such as a renderable image
* interface or a Java printable interface.
* The doc flavor's MIME type is the special value
- * "application/x-java-jvm-local-objectref" indicating the client
+ * {@code "application/x-java-jvm-local-objectref"} indicating the client
* will supply a reference to a Java object that implements the interface
* named as the representation class.
* This MIME type is just a placeholder; what's
@@ -346,17 +346,17 @@
* Plain text print data provided through a byte stream. Specifically, the
* following doc flavors are recommended to be supported:
*
·
- * ("text/plain", "java.io.InputStream")
+ * {@code ("text/plain", "java.io.InputStream")}
*
·
- * ("text/plain; charset=us-ascii", "java.io.InputStream")
+ * {@code ("text/plain; charset=us-ascii", "java.io.InputStream")}
*
·
- * ("text/plain; charset=utf-8", "java.io.InputStream")
+ * {@code ("text/plain; charset=utf-8", "java.io.InputStream")}
*
*
·
- * ("application/x-java-jvm-local-objectref", "java.awt.image.renderable.RenderableImage")
+ * {@code ("application/x-java-jvm-local-objectref", "java.awt.image.renderable.RenderableImage")}
*
* DataFlavor
+ * {@code DataFlavor}
* is not used in the Java Print Service (JPS) API
* for three reasons which are all rooted in allowing the JPS API to be
* shared by other print services APIs which may need to run on Java profiles
@@ -401,13 +401,13 @@
* AWT.
*
* java.awt.datatransfer.DataFlavor
+ * The implementation of class {@code java.awt.datatransfer.DataFlavor}
* does not guarantee that equivalent data flavors will have the same
* serialized representation. DocFlavor does, and can be used in services
* which need this.
*
* java.awt.datatransfer.DataFlavor
+ * The implementation of class {@code java.awt.datatransfer.DataFlavor}
* includes a human presentable name as part of the serialized representation.
* This is not appropriate as part of a service matching constraint.
*
@@ -488,10 +488,10 @@
* @param className Fully-qualified representation class name.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if mimeType is null or
- * className is null.
+ * (unchecked exception) Thrown if {@code mimeType} is null or
+ * {@code className} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if mimeType does not
+ * (unchecked exception) Thrown if {@code mimeType} does not
* obey the syntax for a MIME media type string.
*/
public DocFlavor(String mimeType, String className) {
@@ -528,7 +528,7 @@
}
/**
- * Returns a String representing a MIME
+ * Returns a {@code String} representing a MIME
* parameter.
* Mime types may include parameters which are usually optional.
* The charset for text types is a commonly useful example.
@@ -555,7 +555,7 @@
}
/**
- * Converts this DocFlavor to a string.
+ * Converts this {@code DocFlavor} to a string.
*
* @return MIME type string based on the canonical form. Each parameter
* value is enclosed in quotes.
@@ -576,7 +576,7 @@
/**
* Determines if this doc flavor object is equal to the given object.
* The two are equal if the given object is not null, is an instance
- * of DocFlavor, has a MIME type equivalent to this doc
+ * of {@code DocFlavor}, has a MIME type equivalent to this doc
* flavor object's MIME type (that is, the MIME types have the same media
* type, media subtype, and parameters), and has the same representation
* class name as this doc flavor object. Thus, if two doc flavor objects'
@@ -588,7 +588,7 @@
*
* @param obj Object to test.
*
- * @return True if this doc flavor object equals obj, false
+ * @return True if this doc flavor object equals {@code obj}, false
* otherwise.
*/
public boolean equals(Object obj) {
@@ -642,7 +642,7 @@
/**
* Class DocFlavor.BYTE_ARRAY provides predefined static constant
* DocFlavor objects for example doc flavors using a byte array
- * (byte[]) as the print data representation class.
+ * ({@code byte[]}) as the print data representation class.
*
* @author Alan Kaminsky
*/
@@ -652,14 +652,14 @@
/**
* Constructs a new doc flavor with the given MIME type and a print
- * data representation class name of "[B" (byte array).
+ * data representation class name of {@code "[B"} (byte array).
*
* @param mimeType MIME media type string.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if mimeType is null.
+ * (unchecked exception) Thrown if {@code mimeType} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if mimeType does not
+ * (unchecked exception) Thrown if {@code mimeType} does not
* obey the syntax for a MIME media type string.
*/
public BYTE_ARRAY (String mimeType) {
@@ -667,19 +667,19 @@
}
/**
- * Doc flavor with MIME type = "text/plain",
+ * Doc flavor with MIME type = {@code "text/plain"},
* encoded in the host platform encoding.
* See {@link DocFlavor#hostEncoding hostEncoding}
* Print data representation class name =
- * "[B" (byte array).
+ * {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY TEXT_PLAIN_HOST =
new BYTE_ARRAY ("text/plain; charset="+hostEncoding);
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-8",
- * print data representation class name = "[B" (byte
+ * {@code "text/plain; charset=utf-8"},
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_PLAIN_UTF_8 =
@@ -687,8 +687,8 @@
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16",
- * print data representation class name = "[B" (byte
+ * {@code "text/plain; charset=utf-16"},
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_PLAIN_UTF_16 =
@@ -697,9 +697,9 @@
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16be"
+ * {@code "text/plain; charset=utf-16be"}
* (big-endian byte ordering),
- * print data representation class name = "[B" (byte
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_PLAIN_UTF_16BE =
@@ -707,9 +707,9 @@
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16le"
+ * {@code "text/plain; charset=utf-16le"}
* (little-endian byte ordering),
- * print data representation class name = "[B" (byte
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_PLAIN_UTF_16LE =
@@ -717,28 +717,28 @@
/**
* Doc flavor with MIME type =
- * "text/plain; charset=us-ascii",
+ * {@code "text/plain; charset=us-ascii"},
* print data representation class name =
- * "[B" (byte array).
+ * {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY TEXT_PLAIN_US_ASCII =
new BYTE_ARRAY ("text/plain; charset=us-ascii");
/**
- * Doc flavor with MIME type = "text/html",
+ * Doc flavor with MIME type = {@code "text/html"},
* encoded in the host platform encoding.
* See {@link DocFlavor#hostEncoding hostEncoding}
* Print data representation class name =
- * "[B" (byte array).
+ * {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY TEXT_HTML_HOST =
new BYTE_ARRAY ("text/html; charset="+hostEncoding);
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-8",
- * print data representation class name = "[B" (byte
+ * {@code "text/html; charset=utf-8"},
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_HTML_UTF_8 =
@@ -746,8 +746,8 @@
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16",
- * print data representation class name = "[B" (byte
+ * {@code "text/html; charset=utf-16"},
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_HTML_UTF_16 =
@@ -755,9 +755,9 @@
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16be"
+ * {@code "text/html; charset=utf-16be"}
* (big-endian byte ordering),
- * print data representation class name = "[B" (byte
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_HTML_UTF_16BE =
@@ -765,9 +765,9 @@
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16le"
+ * {@code "text/html; charset=utf-16le"}
* (little-endian byte ordering),
- * print data representation class name = "[B" (byte
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY TEXT_HTML_UTF_16LE =
@@ -775,58 +775,58 @@
/**
* Doc flavor with MIME type =
- * "text/html; charset=us-ascii",
+ * {@code "text/html; charset=us-ascii"},
* print data representation class name =
- * "[B" (byte array).
+ * {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY TEXT_HTML_US_ASCII =
new BYTE_ARRAY ("text/html; charset=us-ascii");
/**
- * Doc flavor with MIME type = "application/pdf", print
- * data representation class name = "[B" (byte array).
+ * Doc flavor with MIME type = {@code "application/pdf"}, print
+ * data representation class name = {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY PDF = new BYTE_ARRAY ("application/pdf");
/**
- * Doc flavor with MIME type = "application/postscript",
- * print data representation class name = "[B" (byte
+ * Doc flavor with MIME type = {@code "application/postscript"},
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY POSTSCRIPT =
new BYTE_ARRAY ("application/postscript");
/**
- * Doc flavor with MIME type = "application/vnd.hp-PCL",
- * print data representation class name = "[B" (byte
+ * Doc flavor with MIME type = {@code "application/vnd.hp-PCL"},
+ * print data representation class name = {@code "[B"} (byte
* array).
*/
public static final BYTE_ARRAY PCL =
new BYTE_ARRAY ("application/vnd.hp-PCL");
/**
- * Doc flavor with MIME type = "image/gif", print data
- * representation class name = "[B" (byte array).
+ * Doc flavor with MIME type = {@code "image/gif"}, print data
+ * representation class name = {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY GIF = new BYTE_ARRAY ("image/gif");
/**
- * Doc flavor with MIME type = "image/jpeg", print data
- * representation class name = "[B" (byte array).
+ * Doc flavor with MIME type = {@code "image/jpeg"}, print data
+ * representation class name = {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY JPEG = new BYTE_ARRAY ("image/jpeg");
/**
- * Doc flavor with MIME type = "image/png", print data
- * representation class name = "[B" (byte array).
+ * Doc flavor with MIME type = {@code "image/png"}, print data
+ * representation class name = {@code "[B"} (byte array).
*/
public static final BYTE_ARRAY PNG = new BYTE_ARRAY ("image/png");
/**
* Doc flavor with MIME type =
- * "application/octet-stream",
- * print data representation class name = "[B" (byte
+ * {@code "application/octet-stream"},
+ * print data representation class name = {@code "[B"} (byte
* array). The client must determine that data described
* using this DocFlavor is valid for the printer.
*/
@@ -850,14 +850,14 @@
/**
* Constructs a new doc flavor with the given MIME type and a print
* data representation class name of
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*
* @param mimeType MIME media type string.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if mimeType is null.
+ * (unchecked exception) Thrown if {@code mimeType} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if mimeType does not
+ * (unchecked exception) Thrown if {@code mimeType} does not
* obey the syntax for a MIME media type string.
*/
public INPUT_STREAM (String mimeType) {
@@ -865,169 +865,169 @@
}
/**
- * Doc flavor with MIME type = "text/plain",
+ * Doc flavor with MIME type = {@code "text/plain"},
* encoded in the host platform encoding.
* See {@link DocFlavor#hostEncoding hostEncoding}
* Print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_PLAIN_HOST =
new INPUT_STREAM ("text/plain; charset="+hostEncoding);
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-8",
+ * {@code "text/plain; charset=utf-8"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_PLAIN_UTF_8 =
new INPUT_STREAM ("text/plain; charset=utf-8");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16",
+ * {@code "text/plain; charset=utf-16"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_PLAIN_UTF_16 =
new INPUT_STREAM ("text/plain; charset=utf-16");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16be"
+ * {@code "text/plain; charset=utf-16be"}
* (big-endian byte ordering),
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_PLAIN_UTF_16BE =
new INPUT_STREAM ("text/plain; charset=utf-16be");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16le"
+ * {@code "text/plain; charset=utf-16le"}
* (little-endian byte ordering),
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_PLAIN_UTF_16LE =
new INPUT_STREAM ("text/plain; charset=utf-16le");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=us-ascii",
+ * {@code "text/plain; charset=us-ascii"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_PLAIN_US_ASCII =
new INPUT_STREAM ("text/plain; charset=us-ascii");
/**
- * Doc flavor with MIME type = "text/html",
+ * Doc flavor with MIME type = {@code "text/html"},
* encoded in the host platform encoding.
* See {@link DocFlavor#hostEncoding hostEncoding}
* Print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_HTML_HOST =
new INPUT_STREAM ("text/html; charset="+hostEncoding);
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-8",
+ * {@code "text/html; charset=utf-8"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_HTML_UTF_8 =
new INPUT_STREAM ("text/html; charset=utf-8");
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16",
+ * {@code "text/html; charset=utf-16"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_HTML_UTF_16 =
new INPUT_STREAM ("text/html; charset=utf-16");
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16be"
+ * {@code "text/html; charset=utf-16be"}
* (big-endian byte ordering),
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_HTML_UTF_16BE =
new INPUT_STREAM ("text/html; charset=utf-16be");
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16le"
+ * {@code "text/html; charset=utf-16le"}
* (little-endian byte ordering),
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_HTML_UTF_16LE =
new INPUT_STREAM ("text/html; charset=utf-16le");
/**
* Doc flavor with MIME type =
- * "text/html; charset=us-ascii",
+ * {@code "text/html; charset=us-ascii"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM TEXT_HTML_US_ASCII =
new INPUT_STREAM ("text/html; charset=us-ascii");
/**
- * Doc flavor with MIME type = "application/pdf", print
- * data representation class name = "java.io.InputStream"
+ * Doc flavor with MIME type = {@code "application/pdf"}, print
+ * data representation class name = {@code "java.io.InputStream"}
* (byte stream).
*/
public static final INPUT_STREAM PDF = new INPUT_STREAM ("application/pdf");
/**
- * Doc flavor with MIME type = "application/postscript",
+ * Doc flavor with MIME type = {@code "application/postscript"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM POSTSCRIPT =
new INPUT_STREAM ("application/postscript");
/**
- * Doc flavor with MIME type = "application/vnd.hp-PCL",
+ * Doc flavor with MIME type = {@code "application/vnd.hp-PCL"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM PCL =
new INPUT_STREAM ("application/vnd.hp-PCL");
/**
- * Doc flavor with MIME type = "image/gif", print data
+ * Doc flavor with MIME type = {@code "image/gif"}, print data
* representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM GIF = new INPUT_STREAM ("image/gif");
/**
- * Doc flavor with MIME type = "image/jpeg", print data
+ * Doc flavor with MIME type = {@code "image/jpeg"}, print data
* representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM JPEG = new INPUT_STREAM ("image/jpeg");
/**
- * Doc flavor with MIME type = "image/png", print data
+ * Doc flavor with MIME type = {@code "image/png"}, print data
* representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
*/
public static final INPUT_STREAM PNG = new INPUT_STREAM ("image/png");
/**
* Doc flavor with MIME type =
- * "application/octet-stream",
+ * {@code "application/octet-stream"},
* print data representation class name =
- * "java.io.InputStream" (byte stream).
+ * {@code "java.io.InputStream"} (byte stream).
* The client must determine that data described
* using this DocFlavor is valid for the printer.
*/
@@ -1050,14 +1050,14 @@
/**
* Constructs a new doc flavor with the given MIME type and a print
- * data representation class name of "java.net.URL".
+ * data representation class name of {@code "java.net.URL"}.
*
* @param mimeType MIME media type string.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if mimeType is null.
+ * (unchecked exception) Thrown if {@code mimeType} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if mimeType does not
+ * (unchecked exception) Thrown if {@code mimeType} does not
* obey the syntax for a MIME media type string.
*/
public URL (String mimeType) {
@@ -1065,160 +1065,160 @@
}
/**
- * Doc flavor with MIME type = "text/plain",
+ * Doc flavor with MIME type = {@code "text/plain"},
* encoded in the host platform encoding.
* See {@link DocFlavor#hostEncoding hostEncoding}
* Print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_PLAIN_HOST =
new URL ("text/plain; charset="+hostEncoding);
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-8",
+ * {@code "text/plain; charset=utf-8"},
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_PLAIN_UTF_8 =
new URL ("text/plain; charset=utf-8");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16",
+ * {@code "text/plain; charset=utf-16"},
* print data representation class name =
- * java.net.URL"" (byte stream).
+ * {@code java.net.URL""} (byte stream).
*/
public static final URL TEXT_PLAIN_UTF_16 =
new URL ("text/plain; charset=utf-16");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16be"
+ * {@code "text/plain; charset=utf-16be"}
* (big-endian byte ordering),
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_PLAIN_UTF_16BE =
new URL ("text/plain; charset=utf-16be");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=utf-16le"
+ * {@code "text/plain; charset=utf-16le"}
* (little-endian byte ordering),
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_PLAIN_UTF_16LE =
new URL ("text/plain; charset=utf-16le");
/**
* Doc flavor with MIME type =
- * "text/plain; charset=us-ascii",
+ * {@code "text/plain; charset=us-ascii"},
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_PLAIN_US_ASCII =
new URL ("text/plain; charset=us-ascii");
/**
- * Doc flavor with MIME type = "text/html",
+ * Doc flavor with MIME type = {@code "text/html"},
* encoded in the host platform encoding.
* See {@link DocFlavor#hostEncoding hostEncoding}
* Print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_HTML_HOST =
new URL ("text/html; charset="+hostEncoding);
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-8",
+ * {@code "text/html; charset=utf-8"},
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_HTML_UTF_8 =
new URL ("text/html; charset=utf-8");
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16",
+ * {@code "text/html; charset=utf-16"},
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_HTML_UTF_16 =
new URL ("text/html; charset=utf-16");
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16be"
+ * {@code "text/html; charset=utf-16be"}
* (big-endian byte ordering),
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_HTML_UTF_16BE =
new URL ("text/html; charset=utf-16be");
/**
* Doc flavor with MIME type =
- * "text/html; charset=utf-16le"
+ * {@code "text/html; charset=utf-16le"}
* (little-endian byte ordering),
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_HTML_UTF_16LE =
new URL ("text/html; charset=utf-16le");
/**
* Doc flavor with MIME type =
- * "text/html; charset=us-ascii",
+ * {@code "text/html; charset=us-ascii"},
* print data representation class name =
- * "java.net.URL" (byte stream).
+ * {@code "java.net.URL"} (byte stream).
*/
public static final URL TEXT_HTML_US_ASCII =
new URL ("text/html; charset=us-ascii");
/**
- * Doc flavor with MIME type = "application/pdf", print
- * data representation class name = "java.net.URL".
+ * Doc flavor with MIME type = {@code "application/pdf"}, print
+ * data representation class name = {@code "java.net.URL"}.
*/
public static final URL PDF = new URL ("application/pdf");
/**
- * Doc flavor with MIME type = "application/postscript",
- * print data representation class name = "java.net.URL".
+ * Doc flavor with MIME type = {@code "application/postscript"},
+ * print data representation class name = {@code "java.net.URL"}.
*/
public static final URL POSTSCRIPT = new URL ("application/postscript");
/**
- * Doc flavor with MIME type = "application/vnd.hp-PCL",
- * print data representation class name = "java.net.URL".
+ * Doc flavor with MIME type = {@code "application/vnd.hp-PCL"},
+ * print data representation class name = {@code "java.net.URL"}.
*/
public static final URL PCL = new URL ("application/vnd.hp-PCL");
/**
- * Doc flavor with MIME type = "image/gif", print data
- * representation class name = "java.net.URL".
+ * Doc flavor with MIME type = {@code "image/gif"}, print data
+ * representation class name = {@code "java.net.URL"}.
*/
public static final URL GIF = new URL ("image/gif");
/**
- * Doc flavor with MIME type = "image/jpeg", print data
- * representation class name = "java.net.URL".
+ * Doc flavor with MIME type = {@code "image/jpeg"}, print data
+ * representation class name = {@code "java.net.URL"}.
*/
public static final URL JPEG = new URL ("image/jpeg");
/**
- * Doc flavor with MIME type = "image/png", print data
- * representation class name = "java.net.URL".
+ * Doc flavor with MIME type = {@code "image/png"}, print data
+ * representation class name = {@code "java.net.URL"}.
*/
public static final URL PNG = new URL ("image/png");
/**
* Doc flavor with MIME type =
- * "application/octet-stream",
- * print data representation class name = "java.net.URL".
+ * {@code "application/octet-stream"},
+ * print data representation class name = {@code "java.net.URL"}.
* The client must determine that data described
* using this DocFlavor is valid for the printer.
*/
@@ -1229,7 +1229,7 @@
/**
* Class DocFlavor.CHAR_ARRAY provides predefined static constant
* DocFlavor objects for example doc flavors using a character array
- * (char[]) as the print data representation class. As such,
+ * ({@code char[]}) as the print data representation class. As such,
* the character set is Unicode.
*
* @author Alan Kaminsky
@@ -1241,16 +1241,16 @@
/**
* Constructs a new doc flavor with the given MIME type and a print
* data representation class name of
- * "[C" (character array).
+ * {@code "[C"} (character array).
*
* @param mimeType MIME media type string. If it is a text media
* type, it is assumed to contain a
- * "charset=utf-16" parameter.
+ * {@code "charset=utf-16"} parameter.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if mimeType is null.
+ * (unchecked exception) Thrown if {@code mimeType} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if mimeType does not
+ * (unchecked exception) Thrown if {@code mimeType} does not
* obey the syntax for a MIME media type string.
*/
public CHAR_ARRAY (String mimeType) {
@@ -1258,17 +1258,17 @@
}
/**
- * Doc flavor with MIME type = "text/plain;
- * charset=utf-16", print data representation class name =
- * "[C" (character array).
+ * Doc flavor with MIME type = {@code "text/plain; charset=utf-16"},
+ * print data representation class name =
+ * {@code "[C"} (character array).
*/
public static final CHAR_ARRAY TEXT_PLAIN =
new CHAR_ARRAY ("text/plain; charset=utf-16");
/**
- * Doc flavor with MIME type = "text/html;
- * charset=utf-16", print data representation class name =
- * "[C" (character array).
+ * Doc flavor with MIME type = {@code "text/html; charset=utf-16"},
+ * print data representation class name =
+ * {@code "[C"} (character array).
*/
public static final CHAR_ARRAY TEXT_HTML =
new CHAR_ARRAY ("text/html; charset=utf-16");
@@ -1289,16 +1289,16 @@
/**
* Constructs a new doc flavor with the given MIME type and a print
- * data representation class name of "java.lang.String".
+ * data representation class name of {@code "java.lang.String"}.
*
* @param mimeType MIME media type string. If it is a text media
* type, it is assumed to contain a
- * "charset=utf-16" parameter.
+ * {@code "charset=utf-16"} parameter.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if mimeType is null.
+ * (unchecked exception) Thrown if {@code mimeType} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if mimeType does not
+ * (unchecked exception) Thrown if {@code mimeType} does not
* obey the syntax for a MIME media type string.
*/
public STRING (String mimeType) {
@@ -1306,17 +1306,17 @@
}
/**
- * Doc flavor with MIME type = "text/plain;
- * charset=utf-16", print data representation class name =
- * "java.lang.String".
+ * Doc flavor with MIME type = {@code "text/plain; charset=utf-16"},
+ * print data representation class name =
+ * {@code "java.lang.String"}.
*/
public static final STRING TEXT_PLAIN =
new STRING ("text/plain; charset=utf-16");
/**
- * Doc flavor with MIME type = "text/html;
- * charset=utf-16", print data representation class name =
- * "java.lang.String".
+ * Doc flavor with MIME type = {@code "text/html; charset=utf-16"},
+ * print data representation class name =
+ * {@code "java.lang.String"}.
*/
public static final STRING TEXT_HTML =
new STRING ("text/html; charset=utf-16");
@@ -1337,16 +1337,16 @@
/**
* Constructs a new doc flavor with the given MIME type and a print
* data representation class name of\
- * "java.io.Reader" (character stream).
+ * {@code "java.io.Reader"} (character stream).
*
* @param mimeType MIME media type string. If it is a text media
* type, it is assumed to contain a
- * "charset=utf-16" parameter.
+ * {@code "charset=utf-16"} parameter.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if mimeType is null.
+ * (unchecked exception) Thrown if {@code mimeType} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if mimeType does not
+ * (unchecked exception) Thrown if {@code mimeType} does not
* obey the syntax for a MIME media type string.
*/
public READER (String mimeType) {
@@ -1354,17 +1354,17 @@
}
/**
- * Doc flavor with MIME type = "text/plain;
- * charset=utf-16", print data representation class name =
- * "java.io.Reader" (character stream).
+ * Doc flavor with MIME type = {@code "text/plain; charset=utf-16"},
+ * print data representation class name =
+ * {@code "java.io.Reader"} (character stream).
*/
public static final READER TEXT_PLAIN =
new READER ("text/plain; charset=utf-16");
/**
- * Doc flavor with MIME type = "text/html;
- * charset=utf-16", print data representation class name =
- * "java.io.Reader" (character stream).
+ * Doc flavor with MIME type = {@code "text/html; charset=utf-16"},
+ * print data representation class name =
+ * {@code "java.io.Reader"} (character stream).
*/
public static final READER TEXT_HTML =
new READER ("text/html; charset=utf-16");
@@ -1384,14 +1384,14 @@
/**
* Constructs a new doc flavor with a MIME type of
- * "application/x-java-jvm-local-objectref" indicating
+ * {@code "application/x-java-jvm-local-objectref"} indicating
* service formatted print data and the given print data
* representation class name.
*
* @param className Fully-qualified representation class name.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if className is
+ * (unchecked exception) Thrown if {@code className} is
* null.
*/
public SERVICE_FORMATTED (String className) {
@@ -1401,7 +1401,7 @@
/**
* Service formatted print data doc flavor with print data
* representation class name =
- * "java.awt.image.renderable.RenderableImage"
+ * {@code "java.awt.image.renderable.RenderableImage"}
* (renderable image object).
*/
public static final SERVICE_FORMATTED RENDERABLE_IMAGE =
@@ -1409,7 +1409,7 @@
/**
* Service formatted print data doc flavor with print data
- * representation class name = "java.awt.print.Printable"
+ * representation class name = {@code "java.awt.print.Printable"}
* (printable object).
*/
public static final SERVICE_FORMATTED PRINTABLE =
@@ -1417,7 +1417,7 @@
/**
* Service formatted print data doc flavor with print data
- * representation class name = "java.awt.print.Pageable"
+ * representation class name = {@code "java.awt.print.Pageable"}
* (pageable object).
*/
public static final SERVICE_FORMATTED PAGEABLE =
--- old/src/java.desktop/share/classes/javax/print/DocPrintJob.java 2015-10-04 22:55:34.277266488 +0400
+++ new/src/java.desktop/share/classes/javax/print/DocPrintJob.java 2015-10-04 22:55:34.089266497 +0400
@@ -45,7 +45,7 @@
* Determines the {@link PrintService} object to which this print job
* object is bound.
*
- * @return PrintService object.
+ * @return {@code PrintService} object.
*
*/
public PrintService getPrintService();
@@ -58,7 +58,7 @@
* call; that is, the returned attribute set's object's contents will
* not be updated if this Print Job's attribute set's contents change
* in the future. To detect changes in attribute values, call
- * getAttributes() again and compare the new attribute
+ * {@code getAttributes()} again and compare the new attribute
* set to the previous attribute set; alternatively, register a
* listener for print job events.
* The returned value may be an empty set but should not be null.
@@ -96,7 +96,7 @@
* If listener is null, no exception is thrown and no action is
* performed.
* To determine the attribute updates that may be reported by this job,
- * a client can call getAttributes() and identify the
+ * a client can call {@code getAttributes()} and identify the
* subset that are interesting and likely to be reported to the
* listener. Clients expecting to be updated about changes in a
* specific job attribute should verify it is in that set, but
@@ -152,7 +152,7 @@
* Print service implementors should close any print data streams (ie
* Reader or InputStream implementations) that they obtain
* from the client doc. Robust clients may still wish to verify this.
- * An exception is always generated if a DocFlavor cannot
+ * An exception is always generated if a {@code DocFlavor} cannot
* be printed.
*
* @param doc The document to be printed. If must be a flavor
--- old/src/java.desktop/share/classes/javax/print/MimeType.java 2015-10-04 22:55:34.801266465 +0400
+++ new/src/java.desktop/share/classes/javax/print/MimeType.java 2015-10-04 22:55:34.609266473 +0400
@@ -195,9 +195,9 @@
* @param s MIME media type string.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if s is null.
+ * (unchecked exception) Thrown if {@code s} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if s does not obey the
+ * (unchecked exception) Thrown if {@code s} does not obey the
* syntax for a MIME media type string.
*/
public MimeType(String s) {
@@ -271,7 +271,7 @@
*
* @param obj Object to test.
*
- * @return True if this MIME type object equals obj, false
+ * @return True if this MIME type object equals {@code obj}, false
* otherwise.
*/
public boolean equals (Object obj) {
@@ -525,7 +525,7 @@
/**
* Parses the given string into canonical pieces and stores the pieces in
- * {@link #myPieces myPieces}.
+ * {@link #myPieces myPieces}.
*
@@ -536,9 +536,9 @@
* @param s MIME media type string.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if
* s is null.
+ * (unchecked exception) Thrown if {@code s} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if s does not obey the
+ * (unchecked exception) Thrown if {@code s} does not obey the
* syntax for a MIME media type string.
*/
private void parse(String s) {
--- old/src/java.desktop/share/classes/javax/print/PrintService.java 2015-10-04 22:55:35.345266440 +0400
+++ new/src/java.desktop/share/classes/javax/print/PrintService.java 2015-10-04 22:55:35.137266450 +0400
@@ -91,7 +91,7 @@
/**
* Removes the print-service listener from this print service.
* This means the listener is no longer interested in
- * PrintService events.
+ * {@code PrintService} events.
* @param listener a PrintServiceAttributeListener object
* @see #addPrintServiceAttributeListener
*/
@@ -103,10 +103,10 @@
* giving this Print Service's status. The returned attribute set object
* is unmodifiable. The returned attribute set object is a "snapshot" of
* this Print Service's attribute set at the time of the
- * getAttributes() method call: that is, the returned
+ * {@code getAttributes()} method call: that is, the returned
* attribute set's contents will not be updated if this print
* service's attribute set's contents change in the future. To detect
- * changes in attribute values, call getAttributes() again
+ * changes in attribute values, call {@code getAttributes()} again
* and compare the new attribute set to the previous attribute set;
* alternatively, register a listener for print service events.
*
@@ -126,8 +126,8 @@
* attribute is not supported by this service.
* @exception NullPointerException if the category is null.
* @exception IllegalArgumentException
- * (unchecked exception) if category is not a
- * Class that implements interface
+ * (unchecked exception) if {@code category} is not a
+ * {@code Class} that implements interface
*{@link javax.print.attribute.PrintServiceAttribute PrintServiceAttribute}.
*/
public PrintService. A print data format is
+ * up a job for this {@code PrintService}. A print data format is
* designated by a "doc
* flavor" (class {@link javax.print.DocFlavor DocFlavor})
* consisting of a MIME type plus a print data representation class.
* getUnsupportedAttributes(..)
+ * with all attributes. Use {@code getUnsupportedAttributes(..)}
* to validate specific combinations.
*
* @return Array of supported doc flavors, should have at least
@@ -152,19 +152,19 @@
/**
* Determines if this print service supports a specific
- * DocFlavor. This is a convenience method to determine
- * if the DocFlavor would be a member of the result of
- * getSupportedDocFlavors().
+ * {@code DocFlavor}. This is a convenience method to determine
+ * if the {@code DocFlavor} would be a member of the result of
+ * {@code getSupportedDocFlavors()}.
* getUnsupportedAttributes(..)
+ * with all attributes. Use {@code getUnsupportedAttributes(..)}
* to validate specific combinations.
*
- * @param flavor the DocFlavorto query for support.
- * @return true if this print service supports the
- * specified DocFlavor; false otherwise.
+ * @param flavor the {@code DocFlavor} to query for support.
+ * @return {@code true} if this print service supports the
+ * specified {@code DocFlavor}; {@code false} otherwise.
* @exception NullPointerException
- * (unchecked exception) Thrown if flavor is null.
+ * (unchecked exception) Thrown if {@code flavor} is null.
*/
public boolean isDocFlavorSupported(DocFlavor flavor);
@@ -173,7 +173,7 @@
* Determines the printing attribute categories a client can specify
* when setting up a job for this print service.
* A printing attribute category is
- * designated by a Class that implements interface
+ * designated by a {@code Class} that implements interface
* {@link javax.print.attribute.Attribute Attribute}. This method returns
* just the attribute categories that are supported; it does not
* return the particular attribute values that are supported.
@@ -181,10 +181,10 @@
* This method returns all the printing attribute
* categories this print service supports for any possible job.
* Some categories may not be supported in a particular context (ie
- * for a particular DocFlavor).
- * Use one of the methods that include a DocFlavor to
+ * for a particular {@code DocFlavor}).
+ * Use one of the methods that include a {@code DocFlavor} to
* validate the request before submitting it, such as
- * getSupportedAttributeValues(..).
+ * {@code getSupportedAttributeValues(..)}.
*
* @return Array of printing attribute categories that the client can
* specify as a doc-level or job-level attribute in a Print
@@ -198,37 +198,37 @@
/**
* Determines whether a client can specify the given printing
* attribute category when setting up a job for this print service. A
- * printing attribute category is designated by a Class
+ * printing attribute category is designated by a {@code Class}
* that implements interface {@link javax.print.attribute.Attribute
* Attribute}. This method tells whether the attribute category is
* supported; it does not tell whether a particular attribute value
* is supported.
* DocFlavor).
- * Use one of the methods which include a DocFlavor to
+ * for a particular {@code DocFlavor}).
+ * Use one of the methods which include a {@code DocFlavor} to
* validate the request before submitting it, such as
- * getSupportedAttributeValues(..).
+ * {@code getSupportedAttributeValues(..)}.
* getSupportedAttributeCategories().
+ * {@code getSupportedAttributeCategories()}.
*
* @param category Printing attribute category to test. It must be a
- * Class that implements
+ * {@code Class} that implements
* interface
* {@link javax.print.attribute.Attribute Attribute}.
*
- * @return true if this print service supports
+ * @return {@code true} if this print service supports
* specifying a doc-level or
- * job-level attribute in category in a Print
- * Request; false if it doesn't.
+ * job-level attribute in {@code category} in a Print
+ * Request; {@code false} if it doesn't.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if category is null.
+ * (unchecked exception) Thrown if {@code category} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if category is not a
- * Class that implements interface
+ * (unchecked exception) Thrown if {@code category} is not a
+ * {@code Class} that implements interface
* {@link javax.print.attribute.Attribute Attribute}.
*/
public boolean
@@ -244,16 +244,16 @@
* default attribute value instead.
* DocFlavor).
- * Use one of the methods that include a DocFlavor to
+ * for a particular {@code DocFlavor}).
+ * Use one of the methods that include a {@code DocFlavor} to
* validate the request before submitting it, such as
- * getSupportedAttributeValues(..).
+ * {@code getSupportedAttributeValues(..)}.
* RequestingUser
+ * service will not have a defaultvalue for {@code RequestingUser}
* i.e. a null return for a supported category means there is no
* service default value for that category. Use the
- * isAttributeCategorySupported(Class) method to
+ * {@code isAttributeCategorySupported(Class)} method to
* distinguish these cases.
*
* @param category Printing attribute category for which the default
@@ -262,16 +262,16 @@
* {@link javax.print.attribute.Attribute
* Attribute}.
*
- * @return Default attribute value for category, or null
+ * @return Default attribute value for {@code category}, or null
* if this Print Service does not support specifying a doc-level or
- * job-level attribute in category in a Print
+ * job-level attribute in {@code category} in a Print
* Request, or the service does not have a default value
* for this attribute.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if category is null.
+ * (unchecked exception) Thrown if {@code category} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if category is not a
+ * (unchecked exception) Thrown if {@code category} is not a
* {@link java.lang.Class Class} that implements interface {@link
* javax.print.attribute.Attribute Attribute}.
*/
@@ -285,10 +285,10 @@
* attribute value is an instance of a class that implements interface
* {@link javax.print.attribute.Attribute Attribute}.
* flavor is null and attributes is null
+ * If {@code flavor} is null and {@code attributes} is null
* or is an empty set, this method returns all the printing attribute
* values this Print Service supports for any possible job. If
- * flavor is not null or attributes is not
+ * {@code flavor} is not null or {@code attributes} is not
* an empty set, this method returns just the printing attribute values
* that are compatible with the given doc flavor and/or set of attributes.
* That is, a null return value may indicate that specifying this attribute
@@ -296,12 +296,12 @@
* Also if DocFlavor is not null it must be a flavor supported by this
* PrintService, else IllegalArgumentException will be thrown.
* attributes parameter contains an Attribute whose
- * category is the same as the category parameter, the service
+ * If the {@code attributes} parameter contains an Attribute whose
+ * category is the same as the {@code category} parameter, the service
* must ignore this attribute in the AttributeSet.
* DocAttributes which are to be specified on the
- * Doc must be included in this set to accurately
+ * {@code DocAttribute}s which are to be specified on the
+ * {@code Doc} must be included in this set to accurately
* represent the context.
* getCategory(Class).
+ * {@code getCategory(Class)}.
* category,
+ * @return Object indicating supported values for {@code category},
* or null if this Print Service does not support specifying a
- * doc-level or job-level attribute in category in
+ * doc-level or job-level attribute in {@code category} in
* a Print Request.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if category is null.
+ * (unchecked exception) Thrown if {@code category} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if category is not a
+ * (unchecked exception) Thrown if {@code category} is not a
* {@link java.lang.Class Class} that implements interface {@link
* javax.print.attribute.Attribute Attribute}, or
- * DocFlavor is not supported by this service.
+ * {@code DocFlavor} is not supported by this service.
*/
public Object
getSupportedAttributeValues(Class category,
@@ -362,24 +362,24 @@
* attribute value is an instance of a class that implements interface
* {@link javax.print.attribute.Attribute Attribute}.
* flavor is null and attributes is null or
+ * If {@code flavor} is null and {@code attributes} is null or
* is an empty set, this method tells whether this Print Service supports
* the given printing attribute value for some possible combination of doc
- * flavor and set of attributes. If flavor is not null or
- * attributes is not an empty set, this method tells whether
+ * flavor and set of attributes. If {@code flavor} is not null or
+ * {@code attributes} is not an empty set, this method tells whether
* this Print Service supports the given printing attribute value in
* combination with the given doc flavor and/or set of attributes.
* DocAttributes which are to be specified on the
- * Doc must be included in this set to accurately
+ * {@code DocAttribute}s which are to be specified on the
+ * {@code Doc} must be included in this set to accurately
* represent the context.
* getSupportedAttributeValues(...).
+ * {@code getSupportedAttributeValues(...)}.
*
* @param attrval Printing attribute value to test.
* @param flavor Doc flavor for a supposed job, or null.
@@ -388,11 +388,11 @@
* attributes), or null.
*
* @return True if this Print Service supports specifying
- * attrval as a doc-level or job-level attribute in a
+ * {@code attrval} as a doc-level or job-level attribute in a
* Print Request, false if it doesn't.
*
* @exception NullPointerException
- * (unchecked exception) if attrval is null.
+ * (unchecked exception) if {@code attrval} is null.
* @exception IllegalArgumentException if flavor is not supported by
* this PrintService.
*/
@@ -410,8 +410,8 @@
* IllegalArgumentException will be thrown. If the
* return value from this method is null, all attributes are supported.
* DocAttributes which are to be specified on the
- * Doc must be included in this set to accurately
+ * {@code DocAttribute}s which are to be specified on the
+ * {@code Doc} must be included in this set to accurately
* represent the context.
* isDocFlavorSupported() to verify that a DocFlavor
+ * Use {@code isDocFlavorSupported()} to verify that a DocFlavor
* is supported before calling this method.
*
* @param flavor Doc flavor to test, or null
@@ -439,7 +439,7 @@
* @return null if this Print Service supports the print request
* specification, else the unsupported attributes.
*
- * @exception IllegalArgumentException ifflavor is
+ * @exception IllegalArgumentException if {@code flavor} is
* not supported by this PrintService.
*/
public AttributeSet getUnsupportedAttributes(DocFlavor flavor,
@@ -453,7 +453,7 @@
* an environment with no UI support should ensure that the factory
* is not initialised unless the application calls this method to
* obtain the factory.
- * See ServiceUIFactory for more information.
+ * See {@code ServiceUIFactory} for more information.
* @return null or a factory for UI components.
*/
public ServiceUIFactory getServiceUIFactory();
@@ -480,7 +480,7 @@
/**
* This method should be implemented consistently with
- * equals(Object).
+ * {@code equals(Object)}.
* @return hash code of this object.
*/
public int hashCode();
--- old/src/java.desktop/share/classes/javax/print/PrintServiceLookup.java 2015-10-04 22:55:35.877266416 +0400
+++ new/src/java.desktop/share/classes/javax/print/PrintServiceLookup.java 2015-10-04 22:55:35.685266425 +0400
@@ -113,7 +113,7 @@
* @param attributes attributes that the print service must support.
* If null this constraint is not used.
*
- * @return array of matching PrintService objects
+ * @return array of matching {@code PrintService} objects
* representing print services that support the specified flavor
* attributes. If no services match, the array is zero-length.
*/
@@ -129,9 +129,9 @@
* Locates MultiDoc print Services capable of printing MultiDocs
* containing all the specified doc flavors.
* MultiDoc in which the elements may be different
+ * a {@code MultiDoc} in which the elements may be different
* flavors. An application could perform this itself by multiple lookups
- * on each DocFlavor in turn and collating the results,
+ * on each {@code DocFlavor} in turn and collating the results,
* but the lookup service may be able to do this more efficiently.
*
* @param flavors the flavors to print. If null or empty this
@@ -201,8 +201,8 @@
* the method returns false.
*
* @param sp an implementation of a lookup service.
- * @return true if the new lookup service is newly
- * registered; false otherwise.
+ * @return {@code true} if the new lookup service is newly
+ * registered; {@code false} otherwise.
*/
public static boolean registerServiceProvider(PrintServiceLookup sp) {
synchronized (PrintServiceLookup.class) {
@@ -232,15 +232,15 @@
* values and classes reported by the service.
* This may be less efficient than a lookup
* service tuned for that service.
- * Therefore registering a PrintServiceLookup instance
+ * Therefore registering a {@code PrintServiceLookup} instance
* instead is recommended.
* The method returns true if this service is not previously
* registered and is now successfully registered.
* This method should not be called with StreamPrintService instances.
* They will always fail to register and the method will return false.
* @param service an implementation of a print service.
- * @return true if the service is newly
- * registered; false otherwise.
+ * @return {@code true} if the service is newly
+ * registered; {@code false} otherwise.
*/
public static boolean registerService(PrintService service) {
--- old/src/java.desktop/share/classes/javax/print/SimpleDoc.java 2015-10-04 22:55:36.405266393 +0400
+++ new/src/java.desktop/share/classes/javax/print/SimpleDoc.java 2015-10-04 22:55:36.213266401 +0400
@@ -35,7 +35,7 @@
import javax.print.attribute.DocAttributeSet;
/**
- * This class is an implementation of interface Doc that can
+ * This class is an implementation of interface {@code Doc} that can
* be used in many common printing requests.
* It can handle all of the presently defined "pre-defined" doc flavors
* defined as static variables in the DocFlavor class.
@@ -52,7 +52,7 @@
* or need a MultiDoc will not want to use this class.
* SimpleDoc does not monitor if the service
+ * stream, then {@code SimpleDoc} does not monitor if the service
* properly closes the stream after data transfer completion or job
* termination.
* Clients may prefer to use provide their own implementation of doc that
@@ -69,18 +69,18 @@
private InputStream inStream;
/**
- * Constructs a SimpleDoc with the specified
+ * Constructs a {@code SimpleDoc} with the specified
* print data, doc flavor and doc attribute set.
* @param printData the print data object
- * @param flavor the DocFlavor object
- * @param attributes a DocAttributeSet, which can
- * be null
- * @throws IllegalArgumentException if flavor or
- * printData is null, or the
- * printData does not correspond
+ * @param flavor the {@code DocFlavor} object
+ * @param attributes a {@code DocAttributeSet}, which can
+ * be {@code null}
+ * @throws IllegalArgumentException if {@code flavor} or
+ * {@code printData} is {@code null}, or the
+ * {@code printData} does not correspond
* to the specified doc flavor--for example, the data is
* not of the type specified as the representation in the
- * DocFlavor.
+ * {@code DocFlavor}.
*/
public SimpleDoc(Object printData,
DocFlavor flavor, DocAttributeSet attributes) {
@@ -144,7 +144,7 @@
* Obtains the print data representation object that contains this doc
* object's piece of print data in the format corresponding to the
* supported doc flavor.
- * The getPrintData() method returns an instance of
+ * The {@code getPrintData()} method returns an instance of
* the representation class whose name is given by
* {@link DocFlavor#getRepresentationClassName() getRepresentationClassName},
* and the return value can be cast
@@ -161,26 +161,26 @@
/**
* Obtains a reader for extracting character print data from this doc.
- * The Doc implementation is required to support this
- * method if the DocFlavor has one of the following print
- * data representation classes, and return null
+ * The {@code Doc} implementation is required to support this
+ * method if the {@code DocFlavor} has one of the following print
+ * data representation classes, and return {@code null}
* otherwise:
*
- *
* The doc's print data representation object is used to construct and
- * return a char[]
- * java.lang.String
- * java.io.Reader
+ * Reader for reading the print data as a stream
+ * return a {@code Reader} for reading the print data as a stream
* of characters from the print data representation object.
* However, if the print data representation object is itself a
- * Reader then the print data representation object is
+ * {@code Reader} then the print data representation object is
* simply returned.
*
- * @return a Reader for reading the print data
+ * @return a {@code Reader} for reading the print data
* characters from this doc.
* If a reader cannot be provided because this doc does not meet
- * the criteria stated above, null is returned.
+ * the criteria stated above, {@code null} is returned.
*
* @exception IOException if there was an I/O error while creating
* the reader.
@@ -209,13 +209,13 @@
/**
* Obtains an input stream for extracting byte print data from
* this doc.
- * The Doc implementation is required to support this
- * method if the DocFlavor has one of the following print
+ * The {@code Doc} implementation is required to support this
+ * method if the {@code DocFlavor} has one of the following print
* data representation classes; otherwise this method
- * returns null:
+ * returns {@code null}:
*
- *
* The doc's print data representation object is obtained. Then, an
* input stream for reading the print data
@@ -225,10 +225,10 @@
* input stream then the print data representation object is simply
* returned.
*
- * @return an byte[]
- * java.io.InputStream
+ * InputStream for reading the print data
+ * @return an {@code InputStream} for reading the print data
* bytes from this doc. If an input stream cannot be
* provided because this doc does not meet
- * the criteria stated above, null is returned.
+ * the criteria stated above, {@code null} is returned.
*
* @exception IOException
* if there was an I/O error while creating the input stream.
--- old/src/java.desktop/share/classes/javax/print/StreamPrintService.java 2015-10-04 22:55:36.929266369 +0400
+++ new/src/java.desktop/share/classes/javax/print/StreamPrintService.java 2015-10-04 22:55:36.741266378 +0400
@@ -37,17 +37,17 @@
* The output format must be declared as a mime type.
* This is equivalent to an output document flavor where the
* representation class is always "java.io.OutputStream"
- * An instance of the StreamPrintService class is
+ * An instance of the {@code StreamPrintService} class is
* obtained from a {@link StreamPrintServiceFactory} instance.
* StreamPrintService is different from a
- * PrintService, which supports a
+ * Note that a {@code StreamPrintService} is different from a
+ * {@code PrintService}, which supports a
* {@link javax.print.attribute.standard.Destination Destination}
- * attribute. A StreamPrintService always requires an output
- * stream, whereas a PrintService optionally accepts a
- * Destination. A StreamPrintService
+ * attribute. A {@code StreamPrintService} always requires an output
+ * stream, whereas a {@code PrintService} optionally accepts a
+ * {@code Destination}. A {@code StreamPrintService}
* has no default destination for its formatted output.
- * Additionally a StreamPrintService is expected to generate
+ * Additionally a {@code StreamPrintService} is expected to generate
output in
* a format useful in other contexts.
* StreamPrintService's are not expected to support the Destination attribute.
@@ -88,7 +88,7 @@
public abstract String getOutputFormat();
/**
- * Disposes this StreamPrintService.
+ * Disposes this {@code StreamPrintService}.
* If a stream service cannot be re-used, it must be disposed
* to indicate this. Typically the client will call this method.
* Services which write data which cannot meaningfully be appended to
@@ -100,12 +100,12 @@
}
/**
- * Returns a boolean indicating whether or not
- * this StreamPrintService has been disposed.
+ * Returns a {@code boolean} indicating whether or not
+ * this {@code StreamPrintService} has been disposed.
* If this object has been disposed, will return true.
* Used by services and client applications to recognize streams
* to which no further data should be written.
- * @return if this StreamPrintService has been disposed
+ * @return if this {@code StreamPrintService} has been disposed
*/
public boolean isDisposed() {
return disposed;
--- old/src/java.desktop/share/classes/javax/print/StreamPrintServiceFactory.java 2015-10-04 22:55:37.453266346 +0400
+++ new/src/java.desktop/share/classes/javax/print/StreamPrintServiceFactory.java 2015-10-04 22:55:37.265266354 +0400
@@ -37,7 +37,7 @@
import java.util.ServiceConfigurationError;
/**
- * A StreamPrintServiceFactory is the factory for
+ * A {@code StreamPrintServiceFactory} is the factory for
* {@link StreamPrintService} instances,
* which can print to an output stream in a particular
* document format described as a mime type.
@@ -51,8 +51,8 @@
* Applications locate instances of this class by calling the
* {@link #lookupStreamPrintServiceFactories(DocFlavor, String)} method.
* StreamPrintService obtained from a
- * factory in place of a PrintService which represents a
+ * Applications can use a {@code StreamPrintService} obtained from a
+ * factory in place of a {@code PrintService} which represents a
* physical printer device.
*/
@@ -127,25 +127,25 @@
public abstract DocFlavor[] getSupportedDocFlavors();
/**
- * Returns a StreamPrintService that can print to
+ * Returns a {@code StreamPrintService} that can print to
* the specified output stream.
* The output stream is created and managed by the application.
* It is the application's responsibility to close the stream and
* to ensure that this Printer is not reused.
* The application should not close this stream until any print job
* created from the printer is complete. Doing so earlier may generate
- * a PrinterException and an event indicating that the
+ * a {@code PrinterException} and an event indicating that the
* job failed.
* PrintService connected to a physical printer
+ * Whereas a {@code PrintService} connected to a physical printer
* can be reused,
- * a StreamPrintService connected to a stream cannot.
- * The underlying StreamPrintService may be disposed by
+ * a {@code StreamPrintService} connected to a stream cannot.
+ * The underlying {@code StreamPrintService} may be disposed by
* the print system with
* the {@link StreamPrintService#dispose() dispose} method
* before returning from the
* {@link DocPrintJob#print(Doc, javax.print.attribute.PrintRequestAttributeSet) print}
- * method of DocPrintJob so that the print system knows
+ * method of {@code DocPrintJob} so that the print system knows
* this printer is no longer usable.
* This is equivalent to a physical printer going offline - permanently.
* Applications may supply a null print stream to create a queryable
--- old/src/java.desktop/share/classes/javax/print/attribute/Attribute.java 2015-10-04 22:55:37.977266322 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/Attribute.java 2015-10-04 22:55:37.789266331 +0400
@@ -52,8 +52,8 @@
* getCategory() method, they should
- * return the same name from the getName() method.
+ * same category from the {@code getCategory()} method, they should
+ * return the same name from the {@code getName()} method.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/AttributeSetUtilities.java 2015-10-04 22:55:38.497266299 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/AttributeSetUtilities.java 2015-10-04 22:55:38.309266307 +0400
@@ -206,10 +206,10 @@
*
* @param attributeSet Underlying attribute set.
*
- * @return Unmodifiable view of attributeSet.
+ * @return Unmodifiable view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null. Null is never a
+ * Thrown if {@code attributeSet} is null. Null is never a
*/
public static AttributeSet unmodifiableView(AttributeSet attributeSet) {
if (attributeSet == null) {
@@ -224,10 +224,10 @@
*
* @param attributeSet Underlying doc attribute set.
*
- * @return Unmodifiable view of attributeSet.
+ * @return Unmodifiable view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static DocAttributeSet unmodifiableView
(DocAttributeSet attributeSet) {
@@ -242,10 +242,10 @@
*
* @param attributeSet Underlying print request attribute set.
*
- * @return Unmodifiable view of attributeSet.
+ * @return Unmodifiable view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static PrintRequestAttributeSet
unmodifiableView(PrintRequestAttributeSet attributeSet) {
@@ -260,10 +260,10 @@
*
* @param attributeSet Underlying print job attribute set.
*
- * @return Unmodifiable view of attributeSet.
+ * @return Unmodifiable view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static PrintJobAttributeSet
unmodifiableView(PrintJobAttributeSet attributeSet) {
@@ -278,10 +278,10 @@
*
* @param attributeSet Underlying print service attribute set.
*
- * @return Unmodifiable view of attributeSet.
+ * @return Unmodifiable view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static PrintServiceAttributeSet
unmodifiableView(PrintServiceAttributeSet attributeSet) {
@@ -417,10 +417,10 @@
*
* @param attributeSet Underlying attribute set.
*
- * @return Synchronized view of attributeSet.
+ * @return Synchronized view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static AttributeSet synchronizedView
(AttributeSet attributeSet) {
@@ -435,10 +435,10 @@
*
* @param attributeSet Underlying doc attribute set.
*
- * @return Synchronized view of attributeSet.
+ * @return Synchronized view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static DocAttributeSet
synchronizedView(DocAttributeSet attributeSet) {
@@ -453,10 +453,10 @@
*
* @param attributeSet Underlying print request attribute set.
*
- * @return Synchronized view of attributeSet.
+ * @return Synchronized view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static PrintRequestAttributeSet
synchronizedView(PrintRequestAttributeSet attributeSet) {
@@ -471,10 +471,10 @@
*
* @param attributeSet Underlying print job attribute set.
*
- * @return Synchronized view of attributeSet.
+ * @return Synchronized view of {@code attributeSet}.
*
* @exception NullPointerException
- * Thrown if attributeSet is null.
+ * Thrown if {@code attributeSet} is null.
*/
public static PrintJobAttributeSet
synchronizedView(PrintJobAttributeSet attributeSet) {
@@ -489,7 +489,7 @@
*
* @param attributeSet Underlying print service attribute set.
*
- * @return Synchronized view of attributeSet.
+ * @return Synchronized view of {@code attributeSet}.
*/
public static PrintServiceAttributeSet
synchronizedView(PrintServiceAttributeSet attributeSet) {
@@ -508,17 +508,17 @@
* @param object Object to test.
* @param interfaceName Interface the object must implement.
*
- * @return If object is a {@link java.lang.Class Class}
- * that implements interfaceName,
- * object is returned downcast to type {@link
+ * @return If {@code object} is a {@link java.lang.Class Class}
+ * that implements {@code interfaceName},
+ * {@code object} is returned downcast to type {@link
* java.lang.Class Class}; otherwise an exception is thrown.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if object is null.
+ * (unchecked exception) Thrown if {@code object} is null.
* @exception ClassCastException
- * (unchecked exception) Thrown if object is not a
+ * (unchecked exception) Thrown if {@code object} is not a
* {@link java.lang.Class Class} that implements
- * interfaceName.
+ * {@code interfaceName}.
*/
public static Class
verifyAttributeCategory(Object object, Class interfaceName) {
@@ -540,16 +540,16 @@
* @param object Object to test.
* @param interfaceName Interface of which the object must be an instance.
*
- * @return If object is an instance of
- * interfaceName, object is returned
+ * @return If {@code object} is an instance of
+ * {@code interfaceName}, {@code object} is returned
* downcast to type {@link Attribute Attribute}; otherwise an
* exception is thrown.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if object is null.
+ * (unchecked exception) Thrown if {@code object} is null.
* @exception ClassCastException
- * (unchecked exception) Thrown if object is not an
- * instance of interfaceName.
+ * (unchecked exception) Thrown if {@code object} is not an
+ * instance of {@code interfaceName}.
*/
public static Attribute
verifyAttributeValue(Object object, Class interfaceName) {
@@ -573,11 +573,11 @@
* @param attribute Attribute value to test.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if the category is
- * null or if the attribute is null.
+ * (unchecked exception) Thrown if the {@code category} is
+ * null or if the {@code attribute} is null.
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if the category is not
- * equal to the category of the attribute.
+ * (unchecked exception) Thrown if the {@code category} is not
+ * equal to the category of the {@code attribute}.
*/
public static void
verifyCategoryForValue(Class category, Attribute attribute) {
--- old/src/java.desktop/share/classes/javax/print/attribute/DateTimeSyntax.java 2015-10-04 22:55:39.025266275 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/DateTimeSyntax.java 2015-10-04 22:55:38.837266283 +0400
@@ -34,26 +34,25 @@
* Class DateTimeSyntax is an abstract base class providing the common
* implementation of all attributes whose value is a date and time.
*
- * java.util.Date. You can get a date-time attribute's Date value by
+ * Under the hood, a date-time attribute is stored as a value of class
+ * {@code java.util.Date}. You can get a date-time attribute's Date value by
* calling {@link #getValue() getValue()}. A date-time attribute's
* Date value is established when it is constructed (see {@link
* #DateTimeSyntax(Date) DateTimeSyntax(Date)}). Once
* constructed, a date-time attribute's value is immutable.
* java.util.Calendar
- * object to construct a java.util.Date object, then use the
- * java.util.Date object to construct the date-time attribute.
+ * day, hour, minute, and so on, use a {@code java.util.Calendar}
+ * object to construct a {@code java.util.Date} object, then use the
+ * {@code java.util.Date} object to construct the date-time attribute.
* To convert
* a date-time attribute to separate values of the year, month, day, hour,
- * minute, and so on, create a java.util.Calendar object and
- * set it to the java.util.Date from the date-time attribute. Class
- * DateTimeSyntax stores its value in the form of a java.util.Date
- *
- * rather than a java.util.Calendar because it typically takes
- * less memory to store and less time to compare a java.util.Date
- * than a java.util.Calendar.
+ * minute, and so on, create a {@code java.util.Calendar} object and
+ * set it to the {@code java.util.Date} from the date-time attribute. Class
+ * DateTimeSyntax stores its value in the form of a {@code java.util.Date}
+ * rather than a {@code java.util.Calendar} because it typically takes
+ * less memory to store and less time to compare a {@code java.util.Date}
+ * than a {@code java.util.Calendar}.
*
* @author Alan Kaminsky
*/
@@ -64,7 +63,7 @@
// Hidden data members.
/**
- * This date-time attribute'sjava.util.Date value.
+ * This date-time attribute's {@code java.util.Date} value.
* @serial
*/
private Date value;
@@ -73,12 +72,12 @@
/**
* Construct a new date-time attribute with the given
- * java.util.Date value.
+ * {@code java.util.Date} value.
*
- * @param value java.util.Date value.
+ * @param value {@code java.util.Date} value.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if theValue is null.
+ * (unchecked exception) Thrown if {@code theValue} is null.
*/
protected DateTimeSyntax(Date value) {
if (value == null) {
@@ -90,7 +89,7 @@
// Exported operations.
/**
- * Returns this date-time attribute's java.util.Date
+ * Returns this date-time attribute's {@code java.util.Date}
* value.
* @return the Date.
*/
@@ -105,17 +104,17 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class DateTimeSyntax.
+ * {@code object} is an instance of class DateTimeSyntax.
* java.util.Date value and
- * object's java.util.Date value are
+ * This date-time attribute's {@code java.util.Date} value and
+ * {@code object}'s {@code java.util.Date} value are
* equal. object is equivalent to this date-time
+ * @return True if {@code object} is equivalent to this date-time
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -126,7 +125,7 @@
/**
* Returns a hash code value for this date-time attribute. The hashcode is
- * that of this attribute's java.util.Date value.
+ * that of this attribute's {@code java.util.Date} value.
*/
public int hashCode() {
return value.hashCode();
@@ -135,7 +134,7 @@
/**
* Returns a string value corresponding to this date-time attribute.
* The string value is just this attribute's
- * java.util.Date value
+ * {@code java.util.Date} value
* converted to a string.
*/
public String toString() {
--- old/src/java.desktop/share/classes/javax/print/attribute/DocAttribute.java 2015-10-04 22:55:39.557266251 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/DocAttribute.java 2015-10-04 22:55:39.361266260 +0400
@@ -30,7 +30,7 @@
* Interface DocAttribute is a tagging interface which a printing attribute
* class implements to indicate the attribute denotes a setting for a doc.
* ("Doc" is a short, easy-to-pronounce term that means "a piece of print
- * data.") The client may include a DocAttribute in a Doc's
+ * data.") The client may include a DocAttribute in a {@code Doc}'s
* attribute set to specify a characteristic of
* that doc. If an attribute implements {@link PrintRequestAttribute
* PrintRequestAttribute} as well as DocAttribute, the client may include the
--- old/src/java.desktop/share/classes/javax/print/attribute/EnumSyntax.java 2015-10-04 22:55:40.077266228 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/EnumSyntax.java 2015-10-04 22:55:39.885266236 +0400
@@ -68,7 +68,7 @@
* }
* }
*
- * You can then write code that uses the == and !=
+ * You can then write code that uses the {@code ==} and {@code !=}
* operators to test enumeration values; for example:
*
* Bach theComposer;
@@ -77,8 +77,8 @@
* System.out.println ("The greatest composer of all time!");
* }
*
- * The equals() method for an enumeration class just does a test
- * for identical objects (==).
+ * The {@code equals()} method for an enumeration class just does a test
+ * for identical objects ({@code ==}).
* ==, !=, equals(), and
- * toString() methods will still work properly even if the subclass
+ * values; the {@code ==}, {@code !=}, {@code equals()}, and
+ * {@code toString()} methods will still work properly even if the subclass
* uses some of the same integer values as the superclass. However, the
* application in which the enumeration class and subclass are used may need to
* have distinct integer values in the superclass and subclass.
@@ -182,7 +182,7 @@
* enumeration value table is null. (Note: {@link
* java.io.InvalidObjectException InvalidObjectException} is a subclass
* of {@link java.io.ObjectStreamException ObjectStreamException}, which
- * readResolve() is declared to throw.)
+ * {@code readResolve()} is declared to throw.)
*/
protected Object readResolve() throws ObjectStreamException {
--- old/src/java.desktop/share/classes/javax/print/attribute/HashDocAttributeSet.java 2015-10-04 22:55:40.605266204 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashDocAttributeSet.java 2015-10-04 22:55:40.413266213 +0400
@@ -55,7 +55,7 @@
* @param attribute Attribute value to add to the set.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if attribute is null.
+ * (unchecked exception) Thrown if {@code attribute} is null.
*/
public HashDocAttributeSet(DocAttribute attribute) {
super (attribute, DocAttribute.class);
@@ -65,7 +65,7 @@
* Construct a new hash doc attribute set,
* initially populated with the values from the given array.
* The new attribute set is populated by
- * adding the elements of attributes array to the set in
+ * adding the elements of {@code attributes} array to the set in
* sequence, starting at index 0. Thus, later array elements may replace
* earlier array elements if the array contains duplicate attribute
* values or attribute categories.
@@ -75,7 +75,7 @@
*
* @exception NullPointerException
* (unchecked exception)
- * Thrown if any element of attributes is null.
+ * Thrown if any element of {@code attributes} is null.
*/
public HashDocAttributeSet(DocAttribute[] attributes) {
super (attributes, DocAttribute.class);
@@ -84,15 +84,15 @@
/**
* Construct a new attribute set, initially populated with the
* values from the given set where the members of the attribute set
- * are restricted to the DocAttribute interface.
+ * are restricted to the {@code DocAttribute} interface.
*
* @param attributes set of attribute values to initialise the set. If
* null, an empty attribute set is constructed.
*
* @exception ClassCastException
* (unchecked exception) Thrown if any element of
- * attributes is not an instance of
- * DocAttribute.
+ * {@code attributes} is not an instance of
+ * {@code DocAttribute}.
*/
public HashDocAttributeSet(DocAttributeSet attributes) {
super(attributes, DocAttribute.class);
--- old/src/java.desktop/share/classes/javax/print/attribute/HashPrintJobAttributeSet.java 2015-10-04 22:55:41.125266181 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashPrintJobAttributeSet.java 2015-10-04 22:55:40.937266189 +0400
@@ -55,7 +55,7 @@
* @param attribute Attribute value to add to the set.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if attribute is null.
+ * (unchecked exception) Thrown if {@code attribute} is null.
*/
public HashPrintJobAttributeSet(PrintJobAttribute attribute) {
super(attribute, PrintJobAttribute.class);
@@ -65,7 +65,7 @@
* Construct a new hash print job attribute set,
* initially populated with the values from the given array.
* The new attribute set is populated
- * by adding the elements of attributes array to the set in
+ * by adding the elements of {@code attributes} array to the set in
* sequence, starting at index 0. Thus, later array elements may replace
* earlier array elements if the array contains duplicate attribute
* values or attribute categories.
@@ -74,7 +74,7 @@
* If null, an empty attribute set is constructed.
*
* @exception NullPointerException (unchecked exception)
- * Thrown if any element of attributes is null.
+ * Thrown if any element of {@code attributes} is null.
*/
public HashPrintJobAttributeSet(PrintJobAttribute[] attributes) {
super (attributes, PrintJobAttribute.class);
@@ -83,15 +83,15 @@
/**
* Construct a new attribute set, initially populated with the
* values from the given set where the members of the attribute set
- * are restricted to the PrintJobAttribute interface.
+ * are restricted to the {@code PrintJobAttribute} interface.
*
* @param attributes set of attribute values to initialise the set. If
* null, an empty attribute set is constructed.
*
* @exception ClassCastException
* (unchecked exception) Thrown if any element of
- * attributes is not an instance of
- * PrintJobAttribute.
+ * {@code attributes} is not an instance of
+ * {@code PrintJobAttribute}.
*/
public HashPrintJobAttributeSet(PrintJobAttributeSet attributes) {
super(attributes, PrintJobAttribute.class);
--- old/src/java.desktop/share/classes/javax/print/attribute/HashPrintRequestAttributeSet.java 2015-10-04 22:55:41.633266158 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashPrintRequestAttributeSet.java 2015-10-04 22:55:41.457266166 +0400
@@ -55,7 +55,7 @@
* @param attribute Attribute value to add to the set.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if attribute is null.
+ * (unchecked exception) Thrown if {@code attribute} is null.
*/
public HashPrintRequestAttributeSet(PrintRequestAttribute attribute) {
super (attribute, PrintRequestAttribute.class);
@@ -64,7 +64,7 @@
/**
* Construct a new print request attribute set, initially populated with
* the values from the given array. The new attribute set is populated
- * by adding the elements of attributes array to the set in
+ * by adding the elements of {@code attributes} array to the set in
* sequence, starting at index 0. Thus, later array elements may replace
* earlier array elements if the array contains duplicate attribute
* values or attribute categories.
@@ -74,7 +74,7 @@
*
* @exception NullPointerException
* (unchecked exception)
- * Thrown if any element of attributes is null.
+ * Thrown if any element of {@code attributes} is null.
*/
public HashPrintRequestAttributeSet(PrintRequestAttribute[] attributes) {
super (attributes, PrintRequestAttribute.class);
@@ -84,15 +84,15 @@
/**
* Construct a new attribute set, initially populated with the
* values from the given set where the members of the attribute set
- * are restricted to the (PrintRequestAttributeSe interface.
+ * are restricted to the {@code (PrintRequestAttributeSe} interface.
*
* @param attributes set of attribute values to initialise the set. If
* null, an empty attribute set is constructed.
*
* @exception ClassCastException
* (unchecked exception) Thrown if any element of
- * attributes is not an instance of
- * (PrintRequestAttributeSe.
+ * {@code attributes} is not an instance of
+ * {@code (PrintRequestAttributeSe}.
*/
public HashPrintRequestAttributeSet(PrintRequestAttributeSet attributes)
{
--- old/src/java.desktop/share/classes/javax/print/attribute/HashPrintServiceAttributeSet.java 2015-10-04 22:55:42.145266135 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashPrintServiceAttributeSet.java 2015-10-04 22:55:41.965266143 +0400
@@ -55,7 +55,7 @@
* @param attribute Attribute value to add to the set.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if attribute is null.
+ * (unchecked exception) Thrown if {@code attribute} is null.
*/
public HashPrintServiceAttributeSet(PrintServiceAttribute attribute) {
super (attribute, PrintServiceAttribute.class);
@@ -64,7 +64,7 @@
/**
* Construct a new print service attribute set, initially populated with
* the values from the given array. The new attribute set is populated
- * by adding the elements of attributes array to the set in
+ * by adding the elements of {@code attributes} array to the set in
* sequence, starting at index 0. Thus, later array elements may replace
* earlier array elements if the array contains duplicate attribute
* values or attribute categories.
@@ -74,7 +74,7 @@
*
* @exception NullPointerException
* (unchecked exception)
- * Thrown if any element of attributes is null.
+ * Thrown if any element of {@code attributes} is null.
*/
public HashPrintServiceAttributeSet(PrintServiceAttribute[] attributes) {
super (attributes, PrintServiceAttribute.class);
@@ -84,15 +84,15 @@
/**
* Construct a new attribute set, initially populated with the
* values from the given set where the members of the attribute set
- * are restricted to the PrintServiceAttribute interface.
+ * are restricted to the {@code PrintServiceAttribute} interface.
*
* @param attributes set of attribute values to initialise the set. If
* null, an empty attribute set is constructed.
*
* @exception ClassCastException
* (unchecked exception) Thrown if any element of
- * attributes is not an instance of
- * PrintServiceAttribute.
+ * {@code attributes} is not an instance of
+ * {@code PrintServiceAttribute}.
*/
public HashPrintServiceAttributeSet(PrintServiceAttributeSet attributes)
{
--- old/src/java.desktop/share/classes/javax/print/attribute/IntegerSyntax.java 2015-10-04 22:55:42.665266112 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/IntegerSyntax.java 2015-10-04 22:55:42.477266120 +0400
@@ -69,9 +69,9 @@
* @param upperBound Upper bound.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than
- * lowerBound or greater than
- * upperBound.
+ * (Unchecked exception) Thrown if {@code value} is less than
+ * {@code lowerBound} or greater than
+ * {@code upperBound}.
*/
protected IntegerSyntax(int value, int lowerBound, int upperBound) {
if (lowerBound > value || value > upperBound) {
@@ -95,17 +95,17 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class IntegerSyntax.
+ * {@code object} is an instance of class IntegerSyntax.
* object's value are
+ * This integer attribute's value and {@code object}'s value are
* equal.
* object is equivalent to this integer
+ * @return True if {@code object} is equivalent to this integer
* attribute, false otherwise.
*/
public boolean equals(Object object) {
--- old/src/java.desktop/share/classes/javax/print/attribute/PrintRequestAttribute.java 2015-10-04 22:55:43.189266088 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/PrintRequestAttribute.java 2015-10-04 22:55:43.001266096 +0400
@@ -37,7 +37,7 @@
* Doc}'s attribute set to specify
+ * attribute in a {@code Doc}'s attribute set to specify
* a job setting which pertains just to that doc.
*
* @see DocAttributeSet
--- old/src/java.desktop/share/classes/javax/print/attribute/ResolutionSyntax.java 2015-10-04 22:55:43.713266064 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/ResolutionSyntax.java 2015-10-04 22:55:43.521266073 +0400
@@ -150,13 +150,13 @@
* @param dphi
* Value (dphi) to convert.
* @param units
- * Unit conversion factor, e.g. {@link #DPI DPI} or
- * {@link #DPCM DPCM}.
+ * Unit conversion factor, e.g. {@link #DPI DPI} or
+ * {@link #DPCM DPCM}.
*
- * @return The value of dphi converted to the desired units.
+ * @return The value of {@code dphi} converted to the desired units.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units} < 1.
*/
private static int convertFromDphi(int dphi, int units) {
if (units < 1) {
@@ -222,7 +222,7 @@
/**
* Returns a string version of this resolution attribute in the given units.
- * The string takes the form "CxF U",
+ * The string takes the form "CxF U",
* where C is the cross feed direction resolution, F is the
* feed direction resolution, and U is the units name. The values are
* rounded to the nearest integer.
@@ -231,7 +231,7 @@
* Unit conversion factor, e.g. {@link #DPI CODE>DPI} or {@link
* #DPCM DPCM}.
* @param unitsName
- * Units name string, e.g. "dpi" or "dpcm". If
+ * Units name string, e.g. {@code "dpi"} or {@code "dpcm"}. If
* null, no units name is appended to the result.
*
* @return String version of this resolution attribute.
@@ -259,19 +259,19 @@
*
*
*
* @param other Resolution attribute to compare with.
*
* @return True if this resolution attribute is less than or equal to the
- * other attribute's cross feed direction resolution.
+ * the {@code other} attribute's cross feed direction resolution.
* other attribute's feed direction resolution.
+ * {@code other} attribute's feed direction resolution.
* other resolution attribute, false otherwise.
+ * {@code other} resolution attribute, false otherwise.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if other is null.
+ * (unchecked exception) Thrown if {@code other} is null.
*/
public boolean lessThanOrEquals(ResolutionSyntax other) {
return (this.crossFeedResolution <= other.crossFeedResolution &&
@@ -284,20 +284,20 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class ResolutionSyntax.
+ * {@code object} is an instance of class ResolutionSyntax.
* object's cross feed direction resolution.
+ * {@code object}'s cross feed direction resolution.
* object's feed direction resolution.
+ * {@code object}'s feed direction resolution.
* object is equivalent to this resolution
+ * @return True if {@code object} is equivalent to this resolution
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -320,7 +320,7 @@
/**
* Returns a string version of this resolution attribute. The string takes
- * the form "CxF dphi", where C is the
+ * the form "CxF dphi", where C is the
* cross feed direction resolution and F is the feed direction
* resolution. The values are reported in the internal units of dphi.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/SetOfIntegerSyntax.java 2015-10-04 22:55:44.237266041 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/SetOfIntegerSyntax.java 2015-10-04 22:55:44.049266049 +0400
@@ -38,19 +38,18 @@
* You can construct an instance of SetOfIntegerSyntax by giving it in "string
* form." The string consists of zero or more comma-separated integer groups.
* Each integer group consists of either one integer, two integers separated by
- * a hyphen (-), or two integers separated by a colon
- * (:). Each integer consists of one or more decimal digits
- * (0 through 9). Whitespace characters cannot
+ * a hyphen ({@code -}), or two integers separated by a colon
+ * ({@code :}). Each integer consists of one or more decimal digits
+ * ({@code 0} through {@code 9}). Whitespace characters cannot
* appear within an integer but are otherwise ignored. For example:
- * "", "1", "5-10", "1:2,
- * 4".
+ * {@code ""}, {@code "1"}, {@code "5-10"}, {@code "1:2, 4"}.
* ints; for example, int[0][],
- * int[][]{{1}}, int[][]{{5,10}},
- * int[][]{{1,2},{4}}.
+ * {@code int}s; for example, {@code int[0][]},
+ * {@code int[][]{{1}}}, {@code int[][]{{5,10}}},
+ * {@code int[][]{{1,2},{4}}}.
* ints
+ * each range is always represented as a length-two array of {@code int}s
* in the form {lower bound, upper bound}. An empty set is represented as a
* zero-length array.
* members does not
+ * (Unchecked exception) Thrown if {@code members} does not
* obey the proper syntax.
*/
protected SetOfIntegerSyntax(String members) {
@@ -305,11 +304,11 @@
*
* @exception NullPointerException
* (Unchecked exception) Thrown if any element of
- * members is null.
+ * {@code members} is null.
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if any element of
- * members is not a length-one or length-two array or if
- * any non-null range in members has a lower bound less
+ * {@code members} is not a length-one or length-two array or if
+ * any non-null range in {@code members} has a lower bound less
* than zero.
*/
protected SetOfIntegerSyntax(int[][] members) {
@@ -357,7 +356,7 @@
* @param member Set member.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if member is less than
+ * (Unchecked exception) Thrown if {@code member} is less than
* zero.
*/
protected SetOfIntegerSyntax(int member) {
@@ -377,7 +376,7 @@
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if the range is non-null and
- * lowerBound is less than zero.
+ * {@code lowerBound} is less than zero.
*/
protected SetOfIntegerSyntax(int lowerBound, int upperBound) {
if (lowerBound <= upperBound && lowerBound < 0) {
@@ -411,7 +410,7 @@
* @param x Integer value.
*
* @return True if this set-of-integer attribute contains the value
- * x, false otherwise.
+ * {@code x}, false otherwise.
*/
public boolean contains(int x) {
// Do a linear search to find the range that contains x, if any.
@@ -433,7 +432,7 @@
* @param attribute Integer attribute.
*
* @return True if this set-of-integer attribute contains
- * theAttribute's value, false otherwise.
+ * {@code theAttribute}'s value, false otherwise.
*/
public boolean contains(IntegerSyntax attribute) {
return contains (attribute.getValue());
@@ -442,10 +441,10 @@
/**
* Determine the smallest integer in this set-of-integer attribute that is
* greater than the given value. If there are no integers in this
- * set-of-integer attribute greater than the given value, -1 is
+ * set-of-integer attribute greater than the given value, {@code -1} is
* returned. (Since a set-of-integer attribute can only contain nonnegative
- * values, -1 will never appear in the set.) You can use the
- * next() method to iterate through the integer values in a
+ * values, {@code -1} will never appear in the set.) You can use the
+ * {@code next()} method to iterate through the integer values in a
* set-of-integer attribute in ascending order, like this:
*
* SetOfIntegerSyntax attribute = . . .;
@@ -459,8 +458,8 @@
* @param x Integer value.
*
* @return The smallest integer in this set-of-integer attribute that is
- * greater than x, or -1 if no integer in
- * this set-of-integer attribute is greater than x.
+ * greater than {@code x}, or {@code -1} if no integer in
+ * this set-of-integer attribute is greater than {@code x}.
*/
public int next(int x) {
// Do a linear search to find the range that contains x, if any.
@@ -481,17 +480,17 @@
* true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class SetOfIntegerSyntax.
+ * {@code object} is an instance of class SetOfIntegerSyntax.
* object's
+ * This set-of-integer attribute's members and {@code object}'s
* members are the same.
* object is equivalent to this
+ * @return True if {@code object} is equivalent to this
* set-of-integer attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -534,9 +533,9 @@
* Returns a string value corresponding to this set-of-integer attribute.
* The string value is a zero-length string if this set is empty. Otherwise,
* the string value is a comma-separated list of the ranges in the canonical
- * array form, where each range is represented as "i" if
+ * array form, where each range is represented as "i" if
* the lower bound equals the upper bound or
- * "i-j" otherwise.
+ * "i-j" otherwise.
*/
public String toString() {
StringBuilder result = new StringBuilder();
--- old/src/java.desktop/share/classes/javax/print/attribute/Size2DSyntax.java 2015-10-04 22:55:44.769266017 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/Size2DSyntax.java 2015-10-04 22:55:44.577266026 +0400
@@ -172,13 +172,13 @@
* @param x
* Value (micrometers) to convert.
* @param units
- * Unit conversion factor, e.g. {@link #INCH INCH} or
- * {@link #MM MM}.
+ * Unit conversion factor, e.g. {@link #INCH INCH} or
+ * {@link #MM MM}.
*
- * @return The value of x converted to the desired units.
+ * @return The value of {@code x} converted to the desired units.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units} < 1.
*/
private static float convertFromMicrometers(int x, int units) {
if (units < 1) {
@@ -238,8 +238,8 @@
/**
* Returns a string version of this two-dimensional size attribute in the
- * given units. The string takes the form "XxY
- * U", where X is the X dimension, Y is the Y
+ * given units. The string takes the form "XxY
+ * U", where X is the X dimension, Y is the Y
* dimension, and U is the units name. The values are displayed in
* floating point.
*
@@ -273,20 +273,20 @@
* be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class Size2DSyntax.
+ * {@code object} is an instance of class Size2DSyntax.
* object's X
+ * This attribute's X dimension is equal to {@code object}'s X
* dimension.
* object's Y
+ * This attribute's Y dimension is equal to {@code object}'s Y
* dimension.
* object is equivalent to this
+ * @return True if {@code object} is equivalent to this
* two-dimensional size attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -306,7 +306,7 @@
/**
* Returns a string version of this two-dimensional size attribute. The
- * string takes the form "XxY um", where
+ * string takes the form "XxY um", where
* X is the X dimension and Y is the Y dimension.
* The values are reported in the internal units of micrometers.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/TextSyntax.java 2015-10-04 22:55:45.305265993 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/TextSyntax.java 2015-10-04 22:55:45.113266002 +0400
@@ -61,10 +61,10 @@
* @param value Text string.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale for as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if value is null.
+ * (unchecked exception) Thrown if {@code value} is null.
*/
protected TextSyntax(String value, Locale locale) {
this.value = verify (value);
@@ -115,20 +115,20 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class TextSyntax.
+ * {@code object} is an instance of class TextSyntax.
* object's
+ * This text attribute's underlying string and {@code object}'s
* underlying string are equal.
* object's locale are
+ * This text attribute's locale and {@code object}'s locale are
* equal.
* object is equivalent to this text
+ * @return True if {@code object} is equivalent to this text
* attribute, false otherwise.
*/
public boolean equals(Object object) {
--- old/src/java.desktop/share/classes/javax/print/attribute/URISyntax.java 2015-10-04 22:55:45.829265969 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/URISyntax.java 2015-10-04 22:55:45.641265978 +0400
@@ -52,7 +52,7 @@
* @param uri URI.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if uri is null.
+ * (unchecked exception) Thrown if {@code uri} is null.
*/
protected URISyntax(URI uri) {
this.uri = verify (uri);
@@ -88,17 +88,17 @@
* To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class URISyntax.
+ * {@code object} is an instance of class URISyntax.
* object's
+ * This URI attribute's underlying URI and {@code object}'s
* underlying URI are equal.
* object is equivalent to this URI
+ * @return True if {@code object} is equivalent to this URI
* attribute, false otherwise.
*/
public boolean equals(Object object) {
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Chromaticity.java 2015-10-04 22:55:46.353265946 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Chromaticity.java 2015-10-04 22:55:46.161265955 +0400
@@ -145,7 +145,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "chromaticity".
+ * For class Chromaticity, the category name is {@code "chromaticity"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/ColorSupported.java 2015-10-04 22:55:46.893265922 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/ColorSupported.java 2015-10-04 22:55:46.689265931 +0400
@@ -49,8 +49,8 @@
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -118,7 +118,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "color-supported".
+ * For class ColorSupported, the category name is {@code "color-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Compression.java 2015-10-04 22:55:47.441265897 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Compression.java 2015-10-04 22:55:47.249265906 +0400
@@ -37,8 +37,8 @@
* NONE}).
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -122,7 +122,7 @@
* instance.
* "compression".
+ * name is {@code "compression"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Copies.java 2015-10-04 22:55:47.989265872 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Copies.java 2015-10-04 22:55:47.797265881 +0400
@@ -62,7 +62,7 @@
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author David Mendenhall
@@ -79,7 +79,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 1.
+ * (Unchecked exception) Thrown if {@code value} is less than 1.
*/
public Copies(int value) {
super (value, 1, Integer.MAX_VALUE);
@@ -90,17 +90,17 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class Copies.
+ * {@code object} is an instance of class Copies.
* object's value are
+ * This copies attribute's value and {@code object}'s value are
* equal.
* object is equivalent to this copies
+ * @return True if {@code object} is equivalent to this copies
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -124,7 +124,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "copies".
+ * For class Copies, the category name is {@code "copies"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/CopiesSupported.java 2015-10-04 22:55:48.513265849 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/CopiesSupported.java 2015-10-04 22:55:48.325265857 +0400
@@ -39,7 +39,7 @@
* in an IPP "copies-supported" attribute. See class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of canonical array form. The category name returned by
- * getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -55,7 +55,7 @@
* @param member Set member.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if member is less than 1.
+ * (Unchecked exception) Thrown if {@code member} is less than 1.
*/
public CopiesSupported(int member) {
super (member);
@@ -74,7 +74,7 @@
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if a null range is specified or if a
- * non-null range is specified with lowerBound less than
+ * non-null range is specified with {@code lowerBound} less than
* 1.
*/
public CopiesSupported(int lowerBound, int upperBound) {
@@ -93,17 +93,17 @@
* be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class CopiesSupported.
+ * {@code object} is an instance of class CopiesSupported.
* object's
+ * This copies supported attribute's members and {@code object}'s
* members are the same.
* object is equivalent to this copies
+ * @return True if {@code object} is equivalent to this copies
* supported attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -129,7 +129,7 @@
* instance.
* "copies-supported".
+ * name is {@code "copies-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtCompleted.java 2015-10-04 22:55:49.029265826 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtCompleted.java 2015-10-04 22:55:48.849265834 +0400
@@ -45,7 +45,7 @@
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author Alan Kaminsky
@@ -62,7 +62,7 @@
* @param dateTime {@link java.util.Date Date} value.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if dateTime is null.
+ * (unchecked exception) Thrown if {@code dateTime} is null.
*/
public DateTimeAtCompleted(Date dateTime) {
super (dateTime);
@@ -74,17 +74,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class DateTimeAtCompleted.
+ * {@code object} is an instance of class DateTimeAtCompleted.
* object's {@link java.util.Date Date} value are equal.
+ * and {@code object}'s {@link java.util.Date Date} value are equal.
* object is equivalent to this date-time
+ * @return True if {@code object} is equivalent to this date-time
* at completed attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -113,7 +113,7 @@
* instance.
* "date-time-at-completed".
+ * {@code "date-time-at-completed"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtCreation.java 2015-10-04 22:55:49.553265802 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtCreation.java 2015-10-04 22:55:49.361265811 +0400
@@ -45,7 +45,7 @@
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author Alan Kaminsky
@@ -62,7 +62,7 @@
* @param dateTime {@link java.util.Date Date} value.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if dateTime is null.
+ * (unchecked exception) Thrown if {@code dateTime} is null.
*/
public DateTimeAtCreation(Date dateTime) {
super (dateTime);
@@ -74,17 +74,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class DateTimeAtCreation.
+ * {@code object} is an instance of class DateTimeAtCreation.
* object's {@link java.util.Date Date} value are equal.
+ * and {@code object}'s {@link java.util.Date Date} value are equal.
* object is equivalent to this date-time
+ * @return True if {@code object} is equivalent to this date-time
* at creation attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -111,7 +111,7 @@
* instance.
* "date-time-at-creation".
+ * {@code "date-time-at-creation"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtProcessing.java 2015-10-04 22:55:50.065265779 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtProcessing.java 2015-10-04 22:55:49.889265787 +0400
@@ -45,7 +45,7 @@
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author Alan Kaminsky
@@ -62,7 +62,7 @@
* @param dateTime {@link java.util.Date Date} value.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if dateTime is null.
+ * (unchecked exception) Thrown if {@code dateTime} is null.
*/
public DateTimeAtProcessing(Date dateTime) {
super (dateTime);
@@ -74,18 +74,18 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class DateTimeAtProcessing.
+ * {@code object} is an instance of class DateTimeAtProcessing.
* object's {@link java.util.Date Date} value
+ * value and {@code object}'s {@link java.util.Date Date} value
* are equal.
* object is equivalent to this date-time
+ * @return True if {@code object} is equivalent to this date-time
* at processing attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -112,7 +112,7 @@
* instance.
* "date-time-at-processing".
+ * {@code "date-time-at-processing"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Destination.java 2015-10-04 22:55:50.589265756 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Destination.java 2015-10-04 22:55:50.401265764 +0400
@@ -40,7 +40,7 @@
* A common use for this attribute will be applications which want
* to redirect output to a local disk file : eg."file:out.prn".
* Note that proper construction of "file:" scheme URI instances should
- * be performed using the toURI() method of class
+ * be performed using the {@code toURI()} method of class
* {@link java.io.File File}.
* See the documentation on that class for more information.
* uri is null.
+ * (unchecked exception) Thrown if {@code uri} is null.
*/
public Destination(URI uri) {
super (uri);
@@ -76,17 +76,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class Destination.
+ * {@code object} is an instance of class Destination.
* object's URI
+ * This destination attribute's URI and {@code object}'s URI
* are equal.
* object is equivalent to this destination
+ * @return True if {@code object} is equivalent to this destination
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -111,7 +111,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "spool-data-destination".
+ * For class Destination, the category name is {@code "spool-data-destination"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/DialogTypeSelection.java 2015-10-04 22:55:51.101265733 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DialogTypeSelection.java 2015-10-04 22:55:50.921265741 +0400
@@ -120,7 +120,7 @@
* instance.
* "dialog-type-selection".
+ * {@code "dialog-type-selection"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/DocumentName.java 2015-10-04 22:55:51.621265709 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DocumentName.java 2015-10-04 22:55:51.433265718 +0400
@@ -42,7 +42,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -57,10 +57,10 @@
* @param documentName Document name.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if documentName is null.
+ * (unchecked exception) Thrown if {@code documentName} is null.
*/
public DocumentName(String documentName, Locale locale) {
super (documentName, locale);
@@ -72,20 +72,20 @@
* To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class DocumentName.
+ * {@code object} is an instance of class DocumentName.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale
+ * This document name attribute's locale and {@code object}'s locale
* are equal.
* object is equivalent to this document
+ * @return True if {@code object} is equivalent to this document
* name attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -109,7 +109,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "document-name".
+ * For class DocumentName, the category name is {@code "document-name"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Fidelity.java 2015-10-04 22:55:52.145265686 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Fidelity.java 2015-10-04 22:55:51.953265694 +0400
@@ -41,8 +41,8 @@
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
* See RFC 2911 Section 15.1 for
* a fuller description of the IPP fidelity attribute.
@@ -117,7 +117,7 @@
* instance.
* "ipp-attribute-fidelity".
+ * {@code "ipp-attribute-fidelity"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Finishings.java 2015-10-04 22:55:52.665265662 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Finishings.java 2015-10-04 22:55:52.477265671 +0400
@@ -212,8 +212,8 @@
* IPP Compatibility: Class Finishings encapsulates some of the
* IPP enum values that can be included in an IPP "finishings" attribute, which
* is a set of enums. The category name returned by
- * getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
* In IPP Finishings is a multi-value attribute, this API currently allows
* only one binding to be specified.
@@ -466,7 +466,7 @@
* instance.
* "finishings".
+ * category name is {@code "finishings"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobHoldUntil.java 2015-10-04 22:55:53.193265639 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobHoldUntil.java 2015-10-04 22:55:53.005265647 +0400
@@ -77,7 +77,7 @@
* converted to one of the standard IPP keywords with some loss of precision;
* for example, a JobHoldUntil value with today's date and 9:00pm local time
* might be converted to the standard IPP keyword "night". The category name
- * returned by getName() gives the IPP attribute name.
+ * returned by {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -94,7 +94,7 @@
* @param dateTime {@link java.util.Date Date} value.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if dateTime is null.
+ * (unchecked exception) Thrown if {@code dateTime} is null.
*/
public JobHoldUntil(Date dateTime) {
super (dateTime);
@@ -106,17 +106,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobHoldUntil.
+ * {@code object} is an instance of class JobHoldUntil.
* object's {@link java.util.Date Date} value are equal.
+ * {@code object}'s {@link java.util.Date Date} value are equal.
* object is equivalent to this job hold
+ * @return True if {@code object} is equivalent to this job hold
* until attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -141,7 +141,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "job-hold-until".
+ * For class JobHoldUntil, the category name is {@code "job-hold-until"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressions.java 2015-10-04 22:55:53.717265615 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressions.java 2015-10-04 22:55:53.529265624 +0400
@@ -63,7 +63,7 @@
* than a measure of the number of impressions to be produced by the job.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @see JobImpressionsSupported
@@ -85,7 +85,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public JobImpressions(int value) {
super(value, 0, Integer.MAX_VALUE);
@@ -97,17 +97,17 @@
* be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobImpressions.
+ * {@code object} is an instance of class JobImpressions.
* object's value
+ * This job impressions attribute's value and {@code object}'s value
* are equal.
* object is equivalent to this job
+ * @return True if {@code object} is equivalent to this job
* impressions attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -132,7 +132,7 @@
* instance.
* "job-impressions".
+ * {@code "job-impressions"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressionsCompleted.java 2015-10-04 22:55:54.233265592 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressionsCompleted.java 2015-10-04 22:55:54.053265600 +0400
@@ -45,7 +45,7 @@
* states, the JobImpressionsCompleted value is the final value for the job.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @see JobImpressions
@@ -67,7 +67,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public JobImpressionsCompleted(int value) {
super (value, 0, Integer.MAX_VALUE);
@@ -79,17 +79,17 @@
* conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobImpressionsCompleted.
+ * {@code object} is an instance of class JobImpressionsCompleted.
* object's value are equal.
+ * {@code object}'s value are equal.
* object is equivalent to this job
+ * @return True if {@code object} is equivalent to this job
* impressions completed attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -116,7 +116,7 @@
* instance.
* "job-impressions-completed".
+ * {@code "job-impressions-completed"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressionsSupported.java 2015-10-04 22:55:54.745265569 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressionsSupported.java 2015-10-04 22:55:54.565265577 +0400
@@ -41,7 +41,7 @@
* included in an IPP "job-impressions-supported" attribute. See class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of canonical array form. The category name returned by
- * getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -61,7 +61,7 @@
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if a null range is specified or if a
- * non-null range is specified with lowerBound less than
+ * non-null range is specified with {@code lowerBound} less than
* 0.
*/
public JobImpressionsSupported(int lowerBound, int upperBound) {
@@ -81,17 +81,17 @@
* conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobImpressionsSupported.
+ * {@code object} is an instance of class JobImpressionsSupported.
* object's members are the same.
+ * {@code object}'s members are the same.
* object is equivalent to this job
+ * @return True if {@code object} is equivalent to this job
* impressions supported attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -118,7 +118,7 @@
* instance.
* "job-impressions-supported".
+ * {@code "job-impressions-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctets.java 2015-10-04 22:55:55.269265545 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctets.java 2015-10-04 22:55:55.081265554 +0400
@@ -115,7 +115,7 @@
* data, replacing any JobKOctets value the client specified.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @see JobKOctetsSupported
@@ -136,7 +136,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public JobKOctets(int value) {
super (value, 0, Integer.MAX_VALUE);
@@ -148,17 +148,17 @@
* true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobKOctets.
+ * {@code object} is an instance of class JobKOctets.
* object's value
+ * This job K octets attribute's value and {@code object}'s value
* are equal.
* object is equivalent to this job K
+ * @return True if {@code object} is equivalent to this job K
* octets attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -182,7 +182,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "job-k-octets".
+ * For class JobKOctets, the category name is {@code "job-k-octets"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctetsProcessed.java 2015-10-04 22:55:55.781265522 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctetsProcessed.java 2015-10-04 22:55:55.605265530 +0400
@@ -57,7 +57,7 @@
* JobKOctets} attribute.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @see JobKOctets
@@ -79,7 +79,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public JobKOctetsProcessed(int value) {
super (value, 0, Integer.MAX_VALUE);
@@ -91,17 +91,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobKOctetsProcessed.
+ * {@code object} is an instance of class JobKOctetsProcessed.
* object's value are equal.
+ * {@code object}'s value are equal.
* object is equivalent to this job K
+ * @return True if {@code object} is equivalent to this job K
* octets processed attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -128,7 +128,7 @@
* instance.
* "job-k-octets-processed".
+ * {@code "job-k-octets-processed"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctetsSupported.java 2015-10-04 22:55:56.293265500 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctetsSupported.java 2015-10-04 22:55:56.117265507 +0400
@@ -41,7 +41,7 @@
* in an IPP "job-k-octets-supported" attribute. See class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of canonical array form. The category name returned by
- * getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -60,7 +60,7 @@
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if a null range is specified or if a
- * non-null range is specified with lowerBound less than
+ * non-null range is specified with {@code lowerBound} less than
* 0.
*/
public JobKOctetsSupported(int lowerBound, int upperBound) {
@@ -79,17 +79,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobKOctetsSupported.
+ * {@code object} is an instance of class JobKOctetsSupported.
* object's members are the same.
+ * {@code object}'s members are the same.
* object is equivalent to this job K
+ * @return True if {@code object} is equivalent to this job K
* octets supported attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -116,7 +116,7 @@
* instance.
* "job-k-octets-supported".
+ * {@code "job-k-octets-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheets.java 2015-10-04 22:55:56.817265476 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheets.java 2015-10-04 22:55:56.629265484 +0400
@@ -55,7 +55,7 @@
* with {@link JobMediaSheetsSupported JobMediaSheetsSupported}.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @see JobMediaSheetsSupported
@@ -78,7 +78,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public JobMediaSheets(int value) {
super (value, 0, Integer.MAX_VALUE);
@@ -90,17 +90,17 @@
* be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobMediaSheets.
+ * {@code object} is an instance of class JobMediaSheets.
* object's
+ * This job media sheets attribute's value and {@code object}'s
* value are equal.
* object is equivalent to this job media
+ * @return True if {@code object} is equivalent to this job media
* sheets attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -126,7 +126,7 @@
* instance.
* "job-media-sheets".
+ * category name is {@code "job-media-sheets"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheetsCompleted.java 2015-10-04 22:55:57.333265453 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheetsCompleted.java 2015-10-04 22:55:57.153265461 +0400
@@ -45,7 +45,7 @@
* states, the JobMediaSheetsCompleted value is the final value for the job.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @see JobMediaSheets
@@ -68,7 +68,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public JobMediaSheetsCompleted(int value) {
super (value, 0, Integer.MAX_VALUE);
@@ -80,17 +80,17 @@
* conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobMediaSheetsCompleted.
+ * {@code object} is an instance of class JobMediaSheetsCompleted.
* object's value are equal.
+ * {@code object}'s value are equal.
* object is equivalent to this job media
+ * @return True if {@code object} is equivalent to this job media
* sheets completed attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -117,7 +117,7 @@
* instance.
* "job-media-sheets-completed".
+ * {@code "job-media-sheets-completed"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheetsSupported.java 2015-10-04 22:55:57.845265430 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheetsSupported.java 2015-10-04 22:55:57.665265438 +0400
@@ -41,7 +41,7 @@
* included in an IPP "job-media-sheets-supported" attribute. See class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of canonical array form. The category name returned by
- * getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -60,7 +60,7 @@
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if a null range is specified or if a
- * non-null range is specified with lowerBound less than
+ * non-null range is specified with {@code lowerBound} less than
* 0.
*/
public JobMediaSheetsSupported(int lowerBound, int upperBound) {
@@ -79,17 +79,17 @@
* conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobMediaSheetsSupported.
+ * {@code object} is an instance of class JobMediaSheetsSupported.
* object's members are the same.
+ * {@code object}'s members are the same.
* object is equivalent to this job media
+ * @return True if {@code object} is equivalent to this job media
* sheets supported attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -116,7 +116,7 @@
* instance.
* "job-media-sheets-supported".
+ * category name is {@code "job-media-sheets-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobMessageFromOperator.java 2015-10-04 22:55:58.357265407 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMessageFromOperator.java 2015-10-04 22:55:58.177265415 +0400
@@ -46,7 +46,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -62,10 +62,10 @@
* @param message Message.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if message is null.
+ * (unchecked exception) Thrown if {@code message} is null.
*/
public JobMessageFromOperator(String message, Locale locale) {
super (message, locale);
@@ -77,20 +77,20 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobMessageFromOperator.
+ * {@code object} is an instance of class JobMessageFromOperator.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale are equal.
+ * {@code object}'s locale are equal.
* object is equivalent to this job
+ * @return True if {@code object} is equivalent to this job
* message from operator attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -117,7 +117,7 @@
* instance.
* "job-message-from-operator".
+ * category name is {@code "job-message-from-operator"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobName.java 2015-10-04 22:55:58.877265383 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobName.java 2015-10-04 22:55:58.689265392 +0400
@@ -47,7 +47,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -62,10 +62,10 @@
* @param jobName Job name.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if jobName is null.
+ * (unchecked exception) Thrown if {@code jobName} is null.
*/
public JobName(String jobName, Locale locale) {
super (jobName, locale);
@@ -76,20 +76,20 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobName.
+ * {@code object} is an instance of class JobName.
* object's
+ * This job name attribute's underlying string and {@code object}'s
* underlying string are equal.
* object's locale are
+ * This job name attribute's locale and {@code object}'s locale are
* equal.
* object is equivalent to this job name
+ * @return True if {@code object} is equivalent to this job name
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -113,7 +113,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "job-name".
+ * For class JobName, the category name is {@code "job-name"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobOriginatingUserName.java 2015-10-04 22:55:59.389265360 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobOriginatingUserName.java 2015-10-04 22:55:59.213265368 +0400
@@ -46,7 +46,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -62,10 +62,10 @@
* @param userName User name.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if userName is null.
+ * (unchecked exception) Thrown if {@code userName} is null.
*/
public JobOriginatingUserName(String userName, Locale locale) {
super (userName, locale);
@@ -77,20 +77,20 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobOriginatingUserName.
+ * {@code object} is an instance of class JobOriginatingUserName.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale are equal.
+ * {@code object}'s locale are equal.
* object is equivalent to this job
+ * @return True if {@code object} is equivalent to this job
* originating user name attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -117,7 +117,7 @@
* instance.
* "job-originating-user-name".
+ * category name is {@code "job-originating-user-name"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobPriority.java 2015-10-04 22:55:59.917265337 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobPriority.java 2015-10-04 22:55:59.725265345 +0400
@@ -52,7 +52,7 @@
* among the available job priority levels.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author Alan Kaminsky
@@ -68,7 +68,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 1
+ * (Unchecked exception) Thrown if {@code value} is less than 1
* or greater than 100.
*/
public JobPriority(int value) {
@@ -81,17 +81,17 @@
* true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobPriority.
+ * {@code object} is an instance of class JobPriority.
* object's value
+ * This job priority attribute's value and {@code object}'s value
* are equal.
* object is equivalent to this job
+ * @return True if {@code object} is equivalent to this job
* priority attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -115,7 +115,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "job-priority".
+ * For class JobPriority, the category name is {@code "job-priority"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobPrioritySupported.java 2015-10-04 22:56:00.433265314 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobPrioritySupported.java 2015-10-04 22:56:00.253265322 +0400
@@ -42,7 +42,7 @@
* priority values equally among the available job priority levels.
* getName() gives the IPP
+ * The category name returned by {@code getName()} gives the IPP
* attribute name.
*
* @author Alan Kaminsky
@@ -60,7 +60,7 @@
* @param value Number of different job priority levels supported.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 1
+ * (Unchecked exception) Thrown if {@code value} is less than 1
* or greater than 100.
*/
public JobPrioritySupported(int value) {
@@ -73,17 +73,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class JobPrioritySupported.
+ * {@code object} is an instance of class JobPrioritySupported.
* object's value are equal.
+ * {@code object}'s value are equal.
* object is equivalent to this job
+ * @return True if {@code object} is equivalent to this job
* priority supported attribute, false otherwise.
*/
public boolean equals (Object object) {
@@ -112,7 +112,7 @@
* instance.
* "job-priority-supported".
+ * category name is {@code "job-priority-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobSheets.java 2015-10-04 22:56:00.953265290 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobSheets.java 2015-10-04 22:56:00.765265299 +0400
@@ -44,9 +44,9 @@
* particular JobSheets value.
* getName() is the IPP attribute name. The
+ * {@code getName()} is the IPP attribute name. The
* enumeration's integer value is the IPP enum value. The
- * toString() method returns the IPP string representation of
+ * {@code toString()} method returns the IPP string representation of
* the attribute value. For a subclass, the attribute value must be
* localized to give the IPP name and natural language values.
*
@@ -122,7 +122,7 @@
* instance.
* "job-sheets".
+ * name is {@code "job-sheets"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobState.java 2015-10-04 22:56:01.497265266 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobState.java 2015-10-04 22:56:01.309265274 +0400
@@ -39,8 +39,8 @@
* detailed information about the job in the given job state.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -225,7 +225,7 @@
* instance.
* "job-state".
+ * name is {@code "job-state"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/JobStateReason.java 2015-10-04 22:56:02.021265242 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobStateReason.java 2015-10-04 22:56:01.833265251 +0400
@@ -48,8 +48,8 @@
* JobState} also changed.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -259,7 +259,7 @@
* The job was aborted by the system because the document data's document
* format (doc flavor) is not among those supported by the printer. If the
* client specifies a doc flavor with a MIME type of
- * "application/octet-stream", the printer may abort the job if
+ * {@code "application/octet-stream"}, the printer may abort the job if
* the printer cannot determine the document data's actual format through
* auto-sensing (even if the printer supports the document format if
* specified explicitly). This value must be supported, since a doc flavor
@@ -449,7 +449,7 @@
* instance.
* "job-state-reason".
+ * category name is {@code "job-state-reason"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Media.java 2015-10-04 22:56:02.549265219 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Media.java 2015-10-04 22:56:02.361265227 +0400
@@ -49,8 +49,8 @@
* one of the ways in which the Media attribute can be specified.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Phil Race
@@ -74,16 +74,16 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is of the same subclass of Media as this object.
+ * {@code object} is of the same subclass of Media as this object.
* object is equivalent to this media
+ * @return True if {@code object} is equivalent to this media
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -111,7 +111,7 @@
* instance.
* "media".
+ * {@code "media"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/MediaPrintableArea.java 2015-10-04 22:56:03.061265196 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/MediaPrintableArea.java 2015-10-04 22:56:02.881265204 +0400
@@ -54,7 +54,7 @@
* The hardware's minimum margins is not just a property of the printer,
* but may be a function of the media size, orientation, media type, and
* any specified finishings.
- * PrintService provides the method to query the supported
+ * {@code PrintService} provides the method to query the supported
* values of an attribute in a suitable context :
* See {@link javax.print.PrintService#getSupportedAttributeValues(Class,DocFlavor, AttributeSet) PrintService.getSupportedAttributeValues()}
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class MediaPrintableArea.
+ * {@code object} is an instance of class MediaPrintableArea.
* object is equivalent to this media margins
+ * @return True if {@code object} is equivalent to this media margins
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -278,7 +278,7 @@
* instance.
* "media-printable-area".
+ * the category name is {@code "media-printable-area"}.
* "in" or "mm". If
+ * Units name string, e.g. {@code "in"} or {@code "mm"}. If
* null, no units name is appended to the result.
*
* @return String version of this two-dimensional size attribute.
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/MediaSize.java 2015-10-04 22:56:03.589265172 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/MediaSize.java 2015-10-04 22:56:03.397265180 +0400
@@ -42,7 +42,7 @@
* MediaSize is not yet used to specify media. Its current role is
* as a mapping for named media (see {@link MediaSizeName MediaSizeName}).
* Clients can use the mapping method
- * MediaSize.getMediaSizeForName(MediaSizeName)
+ * {@code MediaSize.getMediaSizeForName(MediaSizeName)}
* to find the physical dimensions of the MediaSizeName instances
* enumerated in this API. This is useful for clients which need this
* information to format {@literal &} paginate printing.
@@ -66,8 +66,8 @@
* @param x X dimension.
* @param y Y dimension.
* @param units
- * Unit conversion factor, e.g. Size2DSyntax.INCH or
- * Size2DSyntax.MM.
+ * Unit conversion factor, e.g. {@code Size2DSyntax.INCH} or
+ * {@code Size2DSyntax.MM}.
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
@@ -87,8 +87,8 @@
* @param x X dimension.
* @param y Y dimension.
* @param units
- * Unit conversion factor, e.g. Size2DSyntax.INCH or
- * Size2DSyntax.MM.
+ * Unit conversion factor, e.g. {@code Size2DSyntax.INCH} or
+ * {@code Size2DSyntax.MM}.
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
@@ -109,8 +109,8 @@
* @param x X dimension.
* @param y Y dimension.
* @param units
- * Unit conversion factor, e.g. Size2DSyntax.INCH or
- * Size2DSyntax.MM.
+ * Unit conversion factor, e.g. {@code Size2DSyntax.INCH} or
+ * {@code Size2DSyntax.MM}.
* @param media a media name to associate with this MediaSize
*
* @exception IllegalArgumentException
@@ -135,8 +135,8 @@
* @param x X dimension.
* @param y Y dimension.
* @param units
- * Unit conversion factor, e.g. Size2DSyntax.INCH or
- * Size2DSyntax.MM.
+ * Unit conversion factor, e.g. {@code Size2DSyntax.INCH} or
+ * {@code Size2DSyntax.MM}.
* @param media a media name to associate with this MediaSize
*
* @exception IllegalArgumentException
@@ -190,8 +190,8 @@
* @param x - X dimension
* @param y - Y dimension.
* @param units
- * Unit conversion factor, e.g. Size2DSyntax.INCH or
- * Size2DSyntax.MM
+ * Unit conversion factor, e.g. {@code Size2DSyntax.INCH} or
+ * {@code Size2DSyntax.MM}
* @return MediaSizeName matching these dimensions, or null.
* @exception IllegalArgumentException if {@code x <= 0},
* {@code y <= 0}, or {@code units < 1}.
@@ -237,20 +237,20 @@
* To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class MediaSize.
+ * {@code object} is an instance of class MediaSize.
* object's X dimension.
+ * {@code object}'s X dimension.
* object's Y dimension.
+ * {@code object}'s Y dimension.
* object is equivalent to this media size
+ * @return True if {@code object} is equivalent to this media size
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -276,7 +276,7 @@
* instance.
* "media-size".
+ * name is {@code "media-size"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java 2015-10-04 22:56:04.113265148 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java 2015-10-04 22:56:03.933265156 +0400
@@ -62,53 +62,53 @@
* specify two variations of this possibility.
*
* a" represents an
+ * In the detailed explanations below, if "{@code a}" represents an
* instance of document data, then the result of processing the data in
- * document "a" is a sequence of media sheets represented by
- * "a(*)".
+ * document "{@code a}" is a sequence of media sheets represented by
+ * "{@code a(*)}".
*
*
*
* IPP Compatibility: The integer value gives the IPP integer value.
- * The category name returned by a and
- * b -- then the result of processing all the document data
- * (a and then b) must be treated as a single sequence
+ * documents -- say, the document data is called {@code a} and
+ * {@code b} -- then the result of processing all the document data
+ * ({@code a} and then {@code b}) must be treated as a single sequence
* of media sheets for finishing operations; that is, finishing would be
- * performed on the concatenation of the sequences a(*),b(*). The
+ * performed on the concatenation of the sequences {@code a(*),b(*)}. The
* printer must not force the data in each document instance to be formatted
* onto a new print-stream page, nor to start a new impression on a new media
* sheet. If more than one copy is made, the ordering of the sets of media
* sheets resulting from processing the document data must be
- * a(*),b(*),a(*),b(*),..., and the printer object must force
- * each copy (a(*),b(*)) to start on a new media sheet.
+ * {@code a(*),b(*),a(*),b(*),...}, and the printer object must force
+ * each copy ({@code a(*),b(*)}) to start on a new media sheet.
*
* a and
- * b -- then the result of processing the data in each document
+ * has multiple documents -- say, the document data is called {@code a} and
+ * {@code b} -- then the result of processing the data in each document
* instance must be treated as a single sequence of media sheets for finishing
- * operations; that is, the sets a(*) and b(*) would
+ * operations; that is, the sets {@code a(*)} and {@code b(*)} would
* each be finished separately. The printer must force each copy of the result
* of processing the data in a single document to start on a new media sheet.
* If more than one copy is made, the ordering of the sets of media sheets
* resulting from processing the document data must be
- * a(*),a(*),...,b(*),b(*)....
+ * {@code a(*),a(*),...,b(*),b(*)...}.
*
* a and
- * b -- then the result of processing the data in each document
+ * has multiple documents -- say, the document data is called {@code a} and
+ * {@code b} -- then the result of processing the data in each document
* instance must be treated as a single sequence of media sheets for finishing
- * operations; that is, the sets a(*) and b(*) would
+ * operations; that is, the sets {@code a(*)} and {@code b(*)} would
* each be finished separately. The printer must force each copy of the result
* of processing the data in a single document to start on a new media sheet.
* If more than one copy is made, the ordering of the sets of media sheets
* resulting from processing the document data must be
- * a(*),b(*),a(*),b(*),....
+ * {@code a(*),b(*),a(*),b(*),...}.
*
*
*
* a and b are
+ * With SINGLE_DOCUMENT, documents {@code a} and {@code b} are
* stapled together as a single document with no regard to new sheets.
*
* a and b
- * are stapled together as a single document, but document b
+ * With SINGLE_DOCUMENT_NEW_SHEET, documents {@code a} and {@code b}
+ * are stapled together as a single document, but document {@code b}
* starts on a new sheet.
*
* a and
- * b are stapled separately.
+ * SEPARATE_DOCUMENTS_COLLATED_COPIES, documents {@code a} and
+ * {@code b} are stapled separately.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @see Copies
@@ -256,7 +256,7 @@
* instance.
* "multiple-document-handling".
+ * the category name is {@code "multiple-document-handling"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/NumberOfDocuments.java 2015-10-04 22:56:04.641265125 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberOfDocuments.java 2015-10-04 22:56:04.453265133 +0400
@@ -35,7 +35,7 @@
* not.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author Alan Kaminsky
@@ -53,7 +53,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public NumberOfDocuments(int value) {
super (value, 0, Integer.MAX_VALUE);
@@ -65,17 +65,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class NumberOfDocuments.
+ * {@code object} is an instance of class NumberOfDocuments.
* object's
+ * This number of documents attribute's value and {@code object}'s
* value are equal.
* object is equivalent to this number of
+ * @return True if {@code object} is equivalent to this number of
* documents attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -102,7 +102,7 @@
* instance.
* "number-of-documents".
+ * category name is {@code "number-of-documents"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/NumberOfInterveningJobs.java 2015-10-04 22:56:05.157265101 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberOfInterveningJobs.java 2015-10-04 22:56:04.977265110 +0400
@@ -35,7 +35,7 @@
* scheduled order).
* getName() gives the IPP
+ * The category name returned by {@code getName()} gives the IPP
* attribute name.
*
* @author Alan Kaminsky
@@ -52,7 +52,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public NumberOfInterveningJobs(int value) {
super(value, 0, Integer.MAX_VALUE);
@@ -64,17 +64,17 @@
* conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class NumberOfInterveningJobs.
+ * {@code object} is an instance of class NumberOfInterveningJobs.
* object's value are equal.
+ * {@code object}'s value are equal.
* object is equivalent to this number of
+ * @return True if {@code object} is equivalent to this number of
* intervening jobs attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -101,7 +101,7 @@
* instance.
* "number-of-intervening-jobs".
+ * category name is {@code "number-of-intervening-jobs"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/NumberUp.java 2015-10-04 22:56:05.677265078 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberUp.java 2015-10-04 22:56:05.489265087 +0400
@@ -118,7 +118,7 @@
* getName() gives the IPP
+ * The category name returned by {@code getName()} gives the IPP
* attribute name.
*
* @author Alan Kaminsky
@@ -135,7 +135,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 1.
+ * (Unchecked exception) Thrown if {@code value} is less than 1.
*/
public NumberUp(int value) {
super (value, 1, Integer.MAX_VALUE);
@@ -146,17 +146,17 @@
* object. To be equivalent, all of the following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class NumberUp.
+ * {@code object} is an instance of class NumberUp.
* object's value are
+ * This number up attribute's value and {@code object}'s value are
* equal.
* object is equivalent to this number up
+ * @return True if {@code object} is equivalent to this number up
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -180,7 +180,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "number-up".
+ * For class NumberUp, the category name is {@code "number-up"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/NumberUpSupported.java 2015-10-04 22:56:06.197265055 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberUpSupported.java 2015-10-04 22:56:06.009265063 +0400
@@ -37,7 +37,7 @@
* included in an IPP "number-up-supported" attribute. See class {@link
* javax.print.attribute.SetOfIntegerSyntax SetOfIntegerSyntax} for an
* explanation of canonical array form. The category name returned by
- * getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -57,12 +57,12 @@
* @param members Set members in array form.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if members is null or
- * any element of members is null.
+ * (unchecked exception) Thrown if {@code members} is null or
+ * any element of {@code members} is null.
* @exception IllegalArgumentException
* (unchecked exception) Thrown if any element of
- * members is not a length-one or length-two array. Also
- * thrown if members is a zero-length array or if any
+ * {@code members} is not a length-one or length-two array. Also
+ * thrown if {@code members} is a zero-length array or if any
* member of the set is less than 1.
*/
public NumberUpSupported(int[][] members) {
@@ -91,7 +91,7 @@
* @param member Set member.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if member is less than
+ * (Unchecked exception) Thrown if {@code member} is less than
* 1.
*/
public NumberUpSupported(int member) {
@@ -111,7 +111,7 @@
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if a null range is specified or if a
- * non-null range is specified with lowerBound less than
+ * non-null range is specified with {@code lowerBound} less than
* 1.
*/
public NumberUpSupported(int lowerBound, int upperBound) {
@@ -130,17 +130,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class NumberUpSupported.
+ * {@code object} is an instance of class NumberUpSupported.
* object's
+ * This number up supported attribute's members and {@code object}'s
* members are the same.
* object is equivalent to this number up
+ * @return True if {@code object} is equivalent to this number up
* supported attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -167,7 +167,7 @@
* instance.
* "number-up-supported".
+ * category name is {@code "number-up-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/OrientationRequested.java 2015-10-04 22:56:06.709265032 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/OrientationRequested.java 2015-10-04 22:56:06.529265040 +0400
@@ -36,17 +36,17 @@
* does not describe the orientation of the client-supplied print-stream
* pages.
* "application/postscript"),
+ * For some document formats (such as {@code "application/postscript"}),
* the desired orientation of the print-stream pages is specified within the
* document data. This information is generated by a device driver prior to
* the submission of the print job. Other document formats (such as
- * "text/plain") do not include the notion of desired orientation
+ * {@code "text/plain"}) do not include the notion of desired orientation
* within the document data. In the latter case it is possible for the printer
* to bind the desired orientation to the document data after it has been
* submitted. It is expected that a printer would only support the
* OrientationRequested attribute for some document formats (e.g.,
- * "text/plain" or "text/html") but not others (e.g.
- * "application/postscript"). This is no different from any other
+ * {@code "text/plain"} or {@code "text/html"}) but not others (e.g.
+ * {@code "application/postscript"}). This is no different from any other
* job template attribute, since a print job can always impose constraints
* among the values of different job template attributes.
* However, a special mention
@@ -55,8 +55,8 @@
* formats.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -105,7 +105,7 @@
* Finishings Finishings} attribute in cases where the
* opposite edge is desired for finishing a portrait document on simple
* finishing devices that have only one finishing position. Thus a
- * "text/plain" portrait document can be stapled "on the
+ * {@code "text/plain"} portrait document can be stapled "on the
* right" by a simple finishing device as is common use with some
* Middle Eastern languages such as Hebrew.
*/
@@ -176,7 +176,7 @@
* instance.
* "orientation-requested".
+ * category name is {@code "orientation-requested"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/OutputDeviceAssigned.java 2015-10-04 22:56:07.221265009 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/OutputDeviceAssigned.java 2015-10-04 22:56:07.045265017 +0400
@@ -42,7 +42,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -58,10 +58,10 @@
* @param deviceName Device name.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if deviceName is null.
+ * (unchecked exception) Thrown if {@code deviceName} is null.
*/
public OutputDeviceAssigned(String deviceName, Locale locale) {
@@ -76,20 +76,20 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class OutputDeviceAssigned.
+ * {@code object} is an instance of class OutputDeviceAssigned.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale are equal.
+ * {@code object}'s locale are equal.
* object is equivalent to this output
+ * @return True if {@code object} is equivalent to this output
* device assigned attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -116,7 +116,7 @@
* instance.
* "output-device-assigned".
+ * category name is {@code "output-device-assigned"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PDLOverrideSupported.java 2015-10-04 22:56:07.733264986 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PDLOverrideSupported.java 2015-10-04 22:56:07.557264994 +0400
@@ -35,8 +35,8 @@
* specified as attributes outside the print data.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -116,7 +116,7 @@
* instance.
* "pdl-override-supported".
+ * category name is {@code "pdl-override-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PageRanges.java 2015-10-04 22:56:08.261264962 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PageRanges.java 2015-10-04 22:56:08.073264970 +0400
@@ -44,13 +44,13 @@
* driver and this attribute would not be required. However, when printing an
* archived document which has already been formatted, the end user may elect to
* print just a subset of the pages contained in the document. In this case, if
- * a page range of "n-m" is specified, the first page
+ * a page range of "n-m" is specified, the first page
* to be printed will be page n. All subsequent pages of the document
* will be printed through and including page m.
* {{1, Integer.MAX_VALUE}}.
+ * PageRanges attribute is always {@code {{1, Integer.MAX_VALUE}}}.
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author David Mendenhall
* @author Alan Kaminsky
@@ -119,12 +119,12 @@
* @param members Set members in array form.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if members is null or
- * any element of members is null.
+ * (unchecked exception) Thrown if {@code members} is null or
+ * any element of {@code members} is null.
* @exception IllegalArgumentException
* (unchecked exception) Thrown if any element of
- * members is not a length-one or length-two array. Also
- * thrown if members is a zero-length array or if any
+ * {@code members} is not a length-one or length-two array. Also
+ * thrown if {@code members} is a zero-length array or if any
* member of the set is less than 1.
*/
public PageRanges(int[][] members) {
@@ -144,10 +144,10 @@
* @param members Set members in string form.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if members is null or
- * any element of members is null.
+ * (unchecked exception) Thrown if {@code members} is null or
+ * any element of {@code members} is null.
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if members does not
+ * (Unchecked exception) Thrown if {@code members} does not
* obey the proper syntax. Also
* thrown if the constructed set-of-integer is a
* zero-length array or if any
@@ -182,7 +182,7 @@
* @param member Set member.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if member is less than
+ * (Unchecked exception) Thrown if {@code member} is less than
* 1.
*/
public PageRanges(int member) {
@@ -201,7 +201,7 @@
*
* @exception IllegalArgumentException
* (Unchecked exception) Thrown if a null range is specified or if a
- * non-null range is specified with lowerBound less than
+ * non-null range is specified with {@code lowerBound} less than
* 1.
*/
public PageRanges(int lowerBound, int upperBound) {
@@ -219,17 +219,17 @@
* true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PageRanges.
+ * {@code object} is an instance of class PageRanges.
* object's members
+ * This page ranges attribute's members and {@code object}'s members
* are the same.
* object is equivalent to this page ranges
+ * @return True if {@code object} is equivalent to this page ranges
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -253,7 +253,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "page-ranges".
+ * For class PageRanges, the category name is {@code "page-ranges"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PagesPerMinute.java 2015-10-04 22:56:08.785264939 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PagesPerMinute.java 2015-10-04 22:56:08.597264947 +0400
@@ -37,7 +37,7 @@
* device that takes more than two minutes to process a page.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author Alan Kaminsky
@@ -54,7 +54,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public PagesPerMinute(int value) {
super(value, 0, Integer.MAX_VALUE);
@@ -66,17 +66,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PagesPerMinute.
+ * {@code object} is an instance of class PagesPerMinute.
* object's
+ * This pages per minute attribute's value and {@code object}'s
* value are equal.
* object is equivalent to this pages per
+ * @return True if {@code object} is equivalent to this pages per
* minute attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -102,7 +102,7 @@
* instance.
* "pages-per-minute".
+ * category name is {@code "pages-per-minute"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PagesPerMinuteColor.java 2015-10-04 22:56:09.297264916 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PagesPerMinuteColor.java 2015-10-04 22:56:09.117264924 +0400
@@ -48,7 +48,7 @@
* attribute must also be present and have a value of SUPPORTED.
* getName() gives the IPP attribute
+ * category name returned by {@code getName()} gives the IPP attribute
* name.
*
* @author Alan Kaminsky
@@ -65,7 +65,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public PagesPerMinuteColor(int value) {
super(value, 0, Integer.MAX_VALUE);
@@ -77,17 +77,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PagesPerMinuteColor.
+ * {@code object} is an instance of class PagesPerMinuteColor.
* object's
+ * This pages per minute attribute's value and {@code object}'s
* value are equal.
* object is equivalent to this pages per
+ * @return True if {@code object} is equivalent to this pages per
* minute color attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -114,7 +114,7 @@
* instance.
* "pages-per-minute-color".
+ * category name is {@code "pages-per-minute-color"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PresentationDirection.java 2015-10-04 22:56:09.809264893 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PresentationDirection.java 2015-10-04 22:56:09.633264900 +0400
@@ -42,8 +42,8 @@
* attribute; it is an attribute in the Production Printing Extension
* (PDF)
* of IPP 1.1. The category name returned by
- * getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Phil Race.
@@ -174,7 +174,7 @@
* instance.
* "presentation-direction".
+ * the category name is {@code "presentation-direction"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrintQuality.java 2015-10-04 22:56:10.333264869 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrintQuality.java 2015-10-04 22:56:10.141264878 +0400
@@ -35,8 +35,8 @@
* that specifies the print quality that the printer uses for the job.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author David Mendenhall
@@ -123,7 +123,7 @@
* instance.
* "print-quality".
+ * name is {@code "print-quality"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterInfo.java 2015-10-04 22:56:10.857264845 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterInfo.java 2015-10-04 22:56:10.665264854 +0400
@@ -33,15 +33,15 @@
/**
* Class PrinterInfo is a printing attribute class, a text attribute, that
* provides descriptive information about a printer. This could include things
- * like: "This printer can be used for printing color transparencies for
- * HR presentations", or "Out of courtesy for others, please
- * print only small (1-5 page) jobs at this printer", or even \
- * "This printer is going away on July 1, 1997, please find a new
- * printer".
+ * like: {@code "This printer can be used for printing color transparencies for
+ * HR presentations"}, or {@code "Out of courtesy for others, please
+ * print only small (1-5 page) jobs at this printer"}, or even
+ * {@code "This printer is going away on July 1, 1997, please find a new
+ * printer"}.
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -57,10 +57,10 @@
* @param info Printer information string.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if info is null.
+ * (unchecked exception) Thrown if {@code info} is null.
*/
public PrinterInfo(String info, Locale locale) {
super (info, locale);
@@ -72,20 +72,20 @@
* true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PrinterInfo.
+ * {@code object} is an instance of class PrinterInfo.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's
+ * This printer info attribute's locale and {@code object}'s
* locale are equal.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* info attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -109,7 +109,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "printer-info".
+ * For class PrinterInfo, the category name is {@code "printer-info"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterIsAcceptingJobs.java 2015-10-04 22:56:11.365264823 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterIsAcceptingJobs.java 2015-10-04 22:56:11.189264831 +0400
@@ -40,8 +40,8 @@
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -116,7 +116,7 @@
* instance.
* "printer-is-accepting-jobs".
+ * category name is {@code "printer-is-accepting-jobs"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterLocation.java 2015-10-04 22:56:11.889264799 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterLocation.java 2015-10-04 22:56:11.697264808 +0400
@@ -33,11 +33,11 @@
/**
* Class PrinterLocation is a printing attribute class, a text attribute, that
* identifies the location of the device. This could include things like:
- * "in Room 123A, second floor of building XYZ".
+ * {@code "in Room 123A, second floor of building XYZ"}.
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -53,10 +53,10 @@
* @param location Printer location.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if location is null.
+ * (unchecked exception) Thrown if {@code location} is null.
*/
public PrinterLocation(String location, Locale locale) {
super (location, locale);
@@ -68,20 +68,20 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PrinterLocation.
+ * {@code object} is an instance of class PrinterLocation.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's
+ * This printer location attribute's locale and {@code object}'s
* locale are equal.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* location attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -107,7 +107,7 @@
* instance.
* "printer-location".
+ * category name is {@code "printer-location"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMakeAndModel.java 2015-10-04 22:56:12.397264776 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMakeAndModel.java 2015-10-04 22:56:12.221264784 +0400
@@ -35,7 +35,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -51,10 +51,10 @@
* @param makeAndModel Printer make and model string.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if makeAndModel is null.
+ * (unchecked exception) Thrown if {@code makeAndModel} is null.
*/
public PrinterMakeAndModel(String makeAndModel, Locale locale) {
super (makeAndModel, locale);
@@ -66,20 +66,20 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PrinterMakeAndModel.
+ * {@code object} is an instance of class PrinterMakeAndModel.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale are equal.
+ * {@code object}'s locale are equal.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* make and model attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -106,7 +106,7 @@
* instance.
* "printer-make-and-model".
+ * category name is {@code "printer-make-and-model"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMessageFromOperator.java 2015-10-04 22:56:12.909264753 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMessageFromOperator.java 2015-10-04 22:56:12.733264761 +0400
@@ -50,7 +50,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -66,10 +66,10 @@
* @param message Message.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if message is null.
+ * (unchecked exception) Thrown if {@code message} is null.
*/
public PrinterMessageFromOperator(String message, Locale locale) {
super (message, locale);
@@ -81,21 +81,21 @@
* following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class
+ * {@code object} is an instance of class
* PrinterMessageFromOperator.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale are equal.
+ * {@code object}'s locale are equal.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* message from operator attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -122,7 +122,7 @@
* instance.
* "printer-message-from-operator".
+ * the category name is {@code "printer-message-from-operator"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMoreInfo.java 2015-10-04 22:56:13.433264730 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMoreInfo.java 2015-10-04 22:56:13.245264738 +0400
@@ -46,8 +46,8 @@
* about this general kind of printer rather than this specific printer.
* toString() gives the IPP uri value.
- * The category name returned by getName()
+ * {@code toString()} gives the IPP uri value.
+ * The category name returned by {@code getName()}
* gives the IPP attribute name.
*
* @author Alan Kaminsky
@@ -63,7 +63,7 @@
* @param uri URI.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if uri is null.
+ * (unchecked exception) Thrown if {@code uri} is null.
*/
public PrinterMoreInfo(URI uri) {
super (uri);
@@ -75,17 +75,17 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PrinterMoreInfo.
+ * {@code object} is an instance of class PrinterMoreInfo.
* object's URI
+ * This printer more info attribute's URI and {@code object}'s URI
* are equal.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* more info attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -111,7 +111,7 @@
* instance.
* "printer-more-info".
+ * category name is {@code "printer-more-info"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMoreInfoManufacturer.java 2015-10-04 22:56:13.945264707 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMoreInfoManufacturer.java 2015-10-04 22:56:13.769264715 +0400
@@ -46,8 +46,8 @@
* general kind of printer.
* toString() gives the IPP uri value.
- * The category name returned by getName()
+ * {@code toString()} gives the IPP uri value.
+ * The category name returned by {@code getName()}
* gives the IPP attribute name.
*
* @author Alan Kaminsky
@@ -64,7 +64,7 @@
* @param uri URI.
*
* @exception NullPointerException
- * (unchecked exception) Thrown if uri is null.
+ * (unchecked exception) Thrown if {@code uri} is null.
*/
public PrinterMoreInfoManufacturer(URI uri) {
super (uri);
@@ -76,18 +76,18 @@
* following conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class
+ * {@code object} is an instance of class
* PrinterMoreInfoManufacturer.
* object's URI are equal.
+ * {@code object}'s URI are equal.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* more info manufacturer attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -114,7 +114,7 @@
* instance.
* "printer-more-info-manufacturer".
+ * {@code "printer-more-info-manufacturer"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterName.java 2015-10-04 22:56:14.469264683 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterName.java 2015-10-04 22:56:14.281264692 +0400
@@ -40,7 +40,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -55,10 +55,10 @@
* @param printerName Printer name.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if printerName is null.
+ * (unchecked exception) Thrown if {@code printerName} is null.
*/
public PrinterName(String printerName, Locale locale) {
super (printerName, locale);
@@ -70,20 +70,20 @@
* true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PrinterName.
+ * {@code object} is an instance of class PrinterName.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale
+ * This printer name attribute's locale and {@code object}'s locale
* are equal.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* name attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -109,7 +109,7 @@
* instance.
* "printer-name".
+ * name is {@code "printer-name"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterResolution.java 2015-10-04 22:56:15.001264659 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterResolution.java 2015-10-04 22:56:14.813264668 +0400
@@ -61,9 +61,9 @@
* PrintQuality attribute which often controls resolution.
* "printer-resolution" attribute can be obtained by calling
+ * {@code "printer-resolution"} attribute can be obtained by calling
* methods on the PrinterResolution object. The category name returned by
- * getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author David Mendenhall
* @author Alan Kaminsky
@@ -81,8 +81,8 @@
* @param feedResolution
* Feed direction resolution.
* @param units
- * Unit conversion factor, e.g. ResolutionSyntax.DPI
- * or ResolutionSyntax.DPCM.
+ * Unit conversion factor, e.g. {@code ResolutionSyntax.DPI}
+ * or {@code ResolutionSyntax.DPCM}.
*
* @exception IllegalArgumentException
* (unchecked exception) Thrown if {@code crossFeedResolution < 1} or
@@ -99,20 +99,20 @@
* must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PrinterResolution.
+ * {@code object} is an instance of class PrinterResolution.
* object's cross feed direction resolution.
+ * {@code object}'s cross feed direction resolution.
* object's feed direction resolution.
+ * {@code object}'s feed direction resolution.
* object is equivalent to this printer
+ * @return True if {@code object} is equivalent to this printer
* resolution attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -138,7 +138,7 @@
* instance.
* "printer-resolution".
+ * category name is {@code "printer-resolution"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterState.java 2015-10-04 22:56:15.525264636 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterState.java 2015-10-04 22:56:15.337264644 +0400
@@ -39,8 +39,8 @@
* in given printer state.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -130,7 +130,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "printer-state".
+ * For class PrinterState, the category name is {@code "printer-state"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterStateReason.java 2015-10-04 22:56:16.037264613 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterStateReason.java 2015-10-04 22:56:15.861264621 +0400
@@ -56,10 +56,10 @@
* toString()
- * methods, concatenated together with a hyphen ("-") in
+ * associated {@link Severity} object's {@code toString()}
+ * methods, concatenated together with a hyphen ({@code "-"}) in
* between, gives the IPP keyword value for a {@link PrinterStateReasons}.
- * The category name returned by getName() gives the IPP
+ * The category name returned by {@code getName()} gives the IPP
* attribute name.
*
* @author Alan Kaminsky
@@ -432,7 +432,7 @@
* instance.
* "printer-state-reason".
+ * category name is {@code "printer-state-reason"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterURI.java 2015-10-04 22:56:16.565264589 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterURI.java 2015-10-04 22:56:16.373264598 +0400
@@ -38,8 +38,8 @@
* toString() gives the IPP printer-uri value.
- * The category name returned by getName()
+ * {@code toString()} gives the IPP printer-uri value.
+ * The category name returned by {@code getName()}
* gives the IPP attribute name.
*
* @author Robert Herriot
@@ -56,7 +56,7 @@
* @param uri URI of the printer
*
* @exception NullPointerException
- * (unchecked exception) Thrown if uri is null.
+ * (unchecked exception) Thrown if {@code uri} is null.
*/
public PrinterURI(URI uri) {
super (uri);
@@ -68,17 +68,17 @@
* true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class PrinterURI.
+ * {@code object} is an instance of class PrinterURI.
* object's underlying URI are equal.
+ * {@code object}'s underlying URI are equal.
* object is equivalent to this PrinterURI
+ * @return True if {@code object} is equivalent to this PrinterURI
* attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -104,7 +104,7 @@
* instance.
* "printer-uri".
+ * name is {@code "printer-uri"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/QueuedJobCount.java 2015-10-04 22:56:17.085264566 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/QueuedJobCount.java 2015-10-04 22:56:16.897264574 +0400
@@ -34,7 +34,7 @@
* PENDING, PENDING_HELD, PROCESSING, or PROCESSING_STOPPED.
* getName() gives the IPP
+ * The category name returned by {@code getName()} gives the IPP
* attribute name.
*
* @author Alan Kaminsky
@@ -51,7 +51,7 @@
* @param value Integer value.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if value is less than 0.
+ * (Unchecked exception) Thrown if {@code value} is less than 0.
*/
public QueuedJobCount(int value) {
super (value, 0, Integer.MAX_VALUE);
@@ -63,17 +63,17 @@
* mus be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class QueuedJobCount.
+ * {@code object} is an instance of class QueuedJobCount.
* object's
+ * This queued job count attribute's value and {@code object}'s
* value are equal.
* object is equivalent to this queued job
+ * @return True if {@code object} is equivalent to this queued job
* count attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -99,7 +99,7 @@
* instance.
* "queued-job-count".
+ * category name is {@code "queued-job-count"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/ReferenceUriSchemesSupported.java 2015-10-04 22:56:17.609264542 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/ReferenceUriSchemesSupported.java 2015-10-04 22:56:17.433264550 +0400
@@ -32,13 +32,13 @@
* an enumeration, that indicates a "URI scheme," such as "http:" or "ftp:",
* that a printer can use to retrieve print data stored at a URI location.
* If a printer supports doc flavors with a print data representation class of
- * "java.net.URL", the printer uses instances of class
+ * {@code "java.net.URL"}, the printer uses instances of class
* ReferenceUriSchemesSupported to advertise the URI schemes it can accept.
* The acceptable URI schemes are included as service attributes in the
* lookup service; this lets clients search the
* for printers that can get print data using a certain URI scheme. The
* acceptable URI schemes can also be queried using the capability methods in
- * interface PrintService. However,
+ * interface {@code PrintService}. However,
* ReferenceUriSchemesSupported attributes are used solely for determining
* acceptable URI schemes, they are never included in a doc's,
* print request's, print job's, or print service's attribute set.
@@ -52,8 +52,8 @@
* can define them in a subclass of class ReferenceUriSchemesSupported.
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -171,7 +171,7 @@
* "reference-uri-schemes-supported".
+ * {@code "reference-uri-schemes-supported"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/RequestingUserName.java 2015-10-04 22:56:18.125264519 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/RequestingUserName.java 2015-10-04 22:56:17.945264527 +0400
@@ -47,7 +47,7 @@
* getName() gives the IPP attribute name.
+ * {@code getName()} gives the IPP attribute name.
*
* @author Alan Kaminsky
*/
@@ -63,10 +63,10 @@
* @param userName User name.
* @param locale Natural language of the text string. null
* is interpreted to mean the default locale as returned
- * by Locale.getDefault()
+ * by {@code Locale.getDefault()}
*
* @exception NullPointerException
- * (unchecked exception) Thrown if userName is null.
+ * (unchecked exception) Thrown if {@code userName} is null.
*/
public RequestingUserName(String userName, Locale locale) {
super (userName, locale);
@@ -78,20 +78,20 @@
* conditions must be true:
*
*
*
* @param object Object to compare to.
*
- * @return True if object is not null.
+ * {@code object} is not null.
* object is an instance of class RequestingUserName.
+ * {@code object} is an instance of class RequestingUserName.
* object's underlying string are equal.
+ * {@code object}'s underlying string are equal.
* object's locale are equal.
+ * {@code object}'s locale are equal.
* object is equivalent to this requesting
+ * @return True if {@code object} is equivalent to this requesting
* user name attribute, false otherwise.
*/
public boolean equals(Object object) {
@@ -118,7 +118,7 @@
* instance.
* "requesting-user-name".
+ * category name is {@code "requesting-user-name"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Severity.java 2015-10-04 22:56:18.665264495 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Severity.java 2015-10-04 22:56:18.477264503 +0400
@@ -50,13 +50,13 @@
* {@link PrinterState PrinterState} also changed.
* Severity.toString() returns either "error", "warning", or
+ * {@code Severity.toString()} returns either "error", "warning", or
* "report". The string values returned by
* each individual {@link PrinterStateReason} and
- * associated {@link Severity} object's toString()
- * methods, concatenated together with a hyphen ("-") in
+ * associated {@link Severity} object's {@code toString()}
+ * methods, concatenated together with a hyphen ({@code "-"}) in
* between, gives the IPP keyword value for a {@link PrinterStateReasons}.
- * The category name returned by getName() gives the IPP
+ * The category name returned by {@code getName()} gives the IPP
* attribute name.
*
* @author Alan Kaminsky
@@ -146,7 +146,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "severity".
+ * For class Severit, the category name is {@code "severity"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/SheetCollate.java 2015-10-04 22:56:19.189264471 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/SheetCollate.java 2015-10-04 22:56:19.001264480 +0400
@@ -222,7 +222,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "sheet-collate".
+ * For class SheetCollate, the category name is {@code "sheet-collate"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/attribute/standard/Sides.java 2015-10-04 22:56:19.741264446 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Sides.java 2015-10-04 22:56:19.521264456 +0400
@@ -110,8 +110,8 @@
*
* getName() is the IPP attribute name. The enumeration's
- * integer value is the IPP enum value. The toString() method
+ * {@code getName()} is the IPP attribute name. The enumeration's
+ * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
@@ -210,7 +210,7 @@
* Get the name of the category of which this attribute value is an
* instance.
* "sides".
+ * For class Sides, the category name is {@code "sides"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/javax/print/event/PrintEvent.java 2015-10-04 22:56:20.265264423 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintEvent.java 2015-10-04 22:56:20.077264431 +0400
@@ -37,8 +37,8 @@
/**
* Constructs a PrintEvent object.
* @param source is the source of the event
- * @throws IllegalArgumentException if source is
- * null.
+ * @throws IllegalArgumentException if {@code source} is
+ * {@code null}.
*/
public PrintEvent (Object source) {
super(source);
--- old/src/java.desktop/share/classes/javax/print/event/PrintJobAttributeEvent.java 2015-10-04 22:56:20.785264400 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintJobAttributeEvent.java 2015-10-04 22:56:20.597264408 +0400
@@ -45,8 +45,8 @@
* Constructs a PrintJobAttributeEvent object.
* @param source the print job generating this event
* @param attributes the attribute changes being reported
- * @throws IllegalArgumentException if source is
- * null.
+ * @throws IllegalArgumentException if {@code source} is
+ * {@code null}.
*/
public PrintJobAttributeEvent (DocPrintJob source,
PrintJobAttributeSet attributes) {
--- old/src/java.desktop/share/classes/javax/print/event/PrintJobAttributeListener.java 2015-10-04 22:56:21.305264376 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintJobAttributeListener.java 2015-10-04 22:56:21.117264385 +0400
@@ -38,7 +38,7 @@
* One example of an occurrence triggering this event is if the
* {@link javax.print.attribute.standard.JobState JobState}
* attribute changed from
- * PROCESSING to PROCESSING_STOPPED.
+ * {@code PROCESSING} to {@code PROCESSING_STOPPED}.
* @param pjae the event.
*/
public void attributeUpdate(PrintJobAttributeEvent pjae) ;
--- old/src/java.desktop/share/classes/javax/print/event/PrintJobEvent.java 2015-10-04 22:56:21.825264353 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintJobEvent.java 2015-10-04 22:56:21.637264361 +0400
@@ -29,7 +29,7 @@
/**
*
- * Class PrintJobEvent encapsulates common events a print job
+ * Class {@code PrintJobEvent} encapsulates common events a print job
* reports to let a listener know of progress in the processing of the
* {@link DocPrintJob}.
*
@@ -86,12 +86,12 @@
public static final int DATA_TRANSFER_COMPLETE = 106;
/**
- * Constructs a PrintJobEvent object.
+ * Constructs a {@code PrintJobEvent} object.
*
- * @param source a DocPrintJob object
+ * @param source a {@code DocPrintJob} object
* @param reason an int specifying the reason.
- * @throws IllegalArgumentException if source is
- * null.
+ * @throws IllegalArgumentException if {@code source} is
+ * {@code null}.
*/
public PrintJobEvent( DocPrintJob source, int reason) {
@@ -109,12 +109,12 @@
}
/**
- * Determines the DocPrintJob to which this print job
+ * Determines the {@code DocPrintJob} to which this print job
* event pertains.
*
- * @return the DocPrintJob object that represents the
+ * @return the {@code DocPrintJob} object that represents the
* print job that reports the events encapsulated by this
- * PrintJobEvent.
+ * {@code PrintJobEvent}.
*
*/
public DocPrintJob getPrintJob() {
--- old/src/java.desktop/share/classes/javax/print/event/PrintServiceAttributeEvent.java 2015-10-04 22:56:22.349264329 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintServiceAttributeEvent.java 2015-10-04 22:56:22.161264338 +0400
@@ -47,8 +47,8 @@
*
* @param source the print job generating this event
* @param attributes the attribute changes being reported
- * @throws IllegalArgumentException if source is
- * null.
+ * @throws IllegalArgumentException if {@code source} is
+ * {@code null}.
*/
public PrintServiceAttributeEvent(PrintService source,
PrintServiceAttributeSet attributes) {
--- old/src/java.desktop/share/classes/javax/swing/AbstractAction.java 2015-10-04 22:56:22.921264304 +0400
+++ new/src/java.desktop/share/classes/javax/swing/AbstractAction.java 2015-10-04 22:56:22.681264314 +0400
@@ -38,11 +38,11 @@
import sun.security.action.GetPropertyAction;
/**
- * This class provides default implementations for the JFC Action
+ * This class provides default implementations for the JFC {@code Action}
* interface. Standard behaviors like the get and set methods for
- * Action object properties (icon, text, and enabled) are defined
+ * {@code Action} object properties (icon, text, and enabled) are defined
* here. The developer need only subclass this abstract class and
- * define the actionPerformed method.
+ * define the {@code actionPerformed} method.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Georges Saab
@@ -155,11 +155,11 @@
}
/**
- * Gets the Object associated with the specified key.
+ * Gets the {@code Object} associated with the specified key.
*
- * @param key a string containing the specified key
- * @return the binding Object stored with this key; if there
- * are no keys, it will return null
+ * @param key a string containing the specified {@code key}
+ * @return the binding {@code Object} stored with this key; if there
+ * are no keys, it will return {@code null}
* @see Action#getValue
*/
public Object getValue(String key) {
@@ -173,10 +173,10 @@
}
/**
- * Sets the Value associated with the specified key.
+ * Sets the {@code Value} associated with the specified key.
*
- * @param key the String that identifies the stored object
- * @param newValue the Object to store using this key
+ * @param key the {@code String} that identifies the stored object
+ * @param newValue the {@code Object} to store using this key
* @see Action#putValue
*/
public void putValue(String key, Object newValue) {
@@ -242,10 +242,10 @@
/**
- * Returns an array of Objects which are keys for
- * which values have been set for this AbstractAction,
- * or null if no keys have values set.
- * @return an array of key objects, or null if no
+ * Returns an array of {@code Object}s which are keys for
+ * which values have been set for this {@code AbstractAction},
+ * or {@code null} if no keys have values set.
+ * @return an array of key objects, or {@code null} if no
* keys have values set
* @since 1.3
*/
@@ -259,16 +259,16 @@
}
/**
- * If any PropertyChangeListeners have been registered, the
- * changeSupport field describes them.
+ * If any {@code PropertyChangeListeners} have been registered, the
+ * {@code changeSupport} field describes them.
*/
protected SwingPropertyChangeSupport changeSupport;
/**
* Supports reporting bound property changes. This method can be called
* when a bound property has changed and it will send the appropriate
- * PropertyChangeEvent to any registered
- * PropertyChangeListeners.
+ * {@code PropertyChangeEvent} to any registered
+ * {@code PropertyChangeListeners}.
*
* @param propertyName the name of the property that has changed
* @param oldValue the old value of the property
@@ -284,17 +284,17 @@
/**
- * Adds a PropertyChangeListener to the listener list.
+ * Adds a {@code PropertyChangeListener} to the listener list.
* The listener is registered for all properties.
* PropertyChangeEvent will get fired in response to setting
- * a bound property, e.g. setFont, setBackground,
- * or setForeground.
+ * A {@code PropertyChangeEvent} will get fired in response to setting
+ * a bound property, e.g. {@code setFont}, {@code setBackground},
+ * or {@code setForeground}.
* Note that if the current component is inheriting its foreground,
* background, or font from its container, then no event will be
* fired in response to a change in the inherited property.
*
- * @param listener The PropertyChangeListener to be added
+ * @param listener The {@code PropertyChangeListener} to be added
*
* @see Action#addPropertyChangeListener
*/
@@ -307,11 +307,11 @@
/**
- * Removes a PropertyChangeListener from the listener list.
- * This removes a PropertyChangeListener that was registered
+ * Removes a {@code PropertyChangeListener} from the listener list.
+ * This removes a {@code PropertyChangeListener} that was registered
* for all properties.
*
- * @param listener the PropertyChangeListener to be removed
+ * @param listener the {@code PropertyChangeListener} to be removed
*
* @see Action#removePropertyChangeListener
*/
@@ -324,10 +324,10 @@
/**
- * Returns an array of all the PropertyChangeListeners added
+ * Returns an array of all the {@code PropertyChangeListener}s added
* to this AbstractAction with addPropertyChangeListener().
*
- * @return all of the PropertyChangeListeners added or an empty
+ * @return all of the {@code PropertyChangeListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -342,7 +342,7 @@
/**
* Clones the abstract action. This gives the clone
* its own copy of the key/value list,
- * which is not handled for you by Object.clone().
+ * which is not handled for you by {@code Object.clone()}.
**/
protected Object clone() throws CloneNotSupportedException {
--- old/src/java.desktop/share/classes/javax/swing/AbstractButton.java 2015-10-04 22:56:23.449264280 +0400
+++ new/src/java.desktop/share/classes/javax/swing/AbstractButton.java 2015-10-04 22:56:23.261264288 +0400
@@ -49,9 +49,9 @@
* Actions. Using an
- * Action with a button has many benefits beyond directly
+ * {@code Action} with a button has many benefits beyond directly
* configuring a button. Refer to
- * Swing Components Supporting Action for more
+ * Swing Components Supporting {@code Action} for more
* details, and you can find more information in How
* to Use Actions, a section in The Java Tutorial.
@@ -67,7 +67,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Jeff Dinkins
@@ -216,20 +216,20 @@
private Handler handler;
/**
- * The button model's changeListener.
+ * The button model's {@code changeListener}.
*/
protected ChangeListener changeListener = null;
/**
- * The button model's ActionListener.
+ * The button model's {@code ActionListener}.
*/
protected ActionListener actionListener = null;
/**
- * The button model's ItemListener.
+ * The button model's {@code ItemListener}.
*/
protected ItemListener itemListener = null;
/**
- * Only one ChangeEvent is needed per button
+ * Only one {@code ChangeEvent} is needed per button
* instance since the
* event's only state is the source property. The source of events
* generated is always "this".
@@ -239,15 +239,15 @@
private boolean hideActionText = false;
/**
- * Sets the hideActionText property, which determines
- * whether the button displays text from the Action.
- * This is useful only if an Action has been
+ * Sets the {@code hideActionText} property, which determines
+ * whether the button displays text from the {@code Action}.
+ * This is useful only if an {@code Action} has been
* installed on the button.
*
- * @param hideActionText true if the button's
- * text property should not reflect
- * that of the Action; the default is
- * false
+ * @param hideActionText {@code true} if the button's
+ * {@code text} property should not reflect
+ * that of the {@code Action}; the default is
+ * {@code false}
* @see Swing Components Supporting
* Action
* @since 1.6
@@ -255,7 +255,7 @@
* bound: true
* expert: true
* description: Whether the text of the button should come from
- * the Action.
+ * the {@code Action}.
*/
public void setHideActionText(boolean hideActionText) {
if (hideActionText != this.hideActionText) {
@@ -269,14 +269,14 @@
}
/**
- * Returns the value of the hideActionText property, which
+ * Returns the value of the {@code hideActionText} property, which
* determines whether the button displays text from the
- * Action. This is useful only if an Action
+ * {@code Action}. This is useful only if an {@code Action}
* has been installed on the button.
*
- * @return true if the button's text
+ * @return {@code true} if the button's {@code text}
* property should not reflect that of the
- * Action; the default is false
+ * {@code Action}; the default is {@code false}
* @since 1.6
*/
public boolean getHideActionText() {
@@ -331,8 +331,8 @@
/**
* Sets the state of the button. Note that this method does not
- * trigger an actionEvent.
- * Call doClick to perform a programmatic action change.
+ * trigger an {@code actionEvent}.
+ * Call {@code doClick} to perform a programmatic action change.
*
* @param b true if the button is selected, otherwise false
*/
@@ -361,7 +361,7 @@
/**
* Programmatically perform a "click". This does the same
* thing as if the user had pressed and released the button.
- * The button stays visually "pressed" for pressTime
+ * The button stays visually "pressed" for {@code pressTime}
* milliseconds.
*
* @param pressTime the time to "hold down" the button, in milliseconds
@@ -381,11 +381,11 @@
/**
* Sets space for margin between the button's border and
- * the label. Setting to null will cause the button to
- * use the default margin. The button's default Border
+ * the label. Setting to {@code null} will cause the button to
+ * use the default margin. The button's default {@code Border}
* object will use this value to create the proper margin.
* However, if a non-default border is set on the button,
- * it is that Border object's responsibility to create the
+ * it is that {@code Border} object's responsibility to create the
* appropriate margin space (else this property will
* effectively be ignored).
*
@@ -423,7 +423,7 @@
* Returns the margin between the button's border and
* the label.
*
- * @return an Insets object specifying the margin
+ * @return an {@code Insets} object specifying the margin
* between the botton's border and the label
* @see #setMargin
*/
@@ -433,7 +433,7 @@
/**
* Returns the default icon.
- * @return the default Icon
+ * @return the default {@code Icon}
* @see #setIcon
*/
public Icon getIcon() {
@@ -484,7 +484,7 @@
/**
* Returns the pressed icon for the button.
- * @return the pressedIcon property
+ * @return the {@code pressedIcon} property
* @see #setPressedIcon
*/
public Icon getPressedIcon() {
@@ -518,7 +518,7 @@
/**
* Returns the selected icon for the button.
- * @return the selectedIcon property
+ * @return the {@code selectedIcon} property
* @see #setSelectedIcon
*/
public Icon getSelectedIcon() {
@@ -564,7 +564,7 @@
/**
* Returns the rollover icon for the button.
- * @return the rolloverIcon property
+ * @return the {@code rolloverIcon} property
* @see #setRolloverIcon
*/
public Icon getRolloverIcon() {
@@ -600,7 +600,7 @@
/**
* Returns the rollover selection icon for the button.
- * @return the rolloverSelectedIcon property
+ * @return the {@code rolloverSelectedIcon} property
* @see #setRolloverSelectedIcon
*/
public Icon getRolloverSelectedIcon() {
@@ -644,7 +644,7 @@
* Some look and feels might not render the disabled Icon, in which
* case they will ignore this.
*
- * @return the disabledIcon property
+ * @return the {@code disabledIcon} property
* @see #getPressedIcon
* @see #setDisabledIcon
* @see javax.swing.LookAndFeel#getDisabledIcon
@@ -690,12 +690,12 @@
* If no disabled selection icon has been set, this will forward
* the call to the LookAndFeel to construct an appropriate disabled
* Icon from the selection icon if it has been set and to
- * getDisabledIcon() otherwise.
+ * {@code getDisabledIcon()} otherwise.
* disabledSelectedIcon property
+ * @return the {@code disabledSelectedIcon} property
* @see #getDisabledIcon
* @see #setDisabledSelectedIcon
* @see javax.swing.LookAndFeel#getDisabledSelectedIcon
@@ -746,7 +746,7 @@
/**
* Returns the vertical alignment of the text and icon.
*
- * @return the verticalAlignment property, one of the
+ * @return the {@code verticalAlignment} property, one of the
* following values:
*
*
horizontalAlignment property,
+ * @return the {@code horizontalAlignment} property,
* one of the following values:
*
*
verticalTextPosition property,
+ * @return the {@code verticalTextPosition} property,
* one of the following values:
*
*
horizontalTextPosition property,
+ * @return the {@code horizontalTextPosition} property,
* one of the following values:
*
*
- * @exception IllegalArgumentException if textPosition
+ * @exception IllegalArgumentException if {@code textPosition}
* is not one of the legal values listed above
* @beaninfo
* bound: true
@@ -1063,32 +1063,32 @@
private PropertyChangeListener actionPropertyChangeListener;
/**
- * Sets the Action.
- * The new Action replaces any previously set
- * Action but does not affect ActionListeners
- * independently added with addActionListener.
- * If the Action is already a registered
- * ActionListener for the button, it is not re-registered.
+ * Sets the {@code Action}.
+ * The new {@code Action} replaces any previously set
+ * {@code Action} but does not affect {@code ActionListeners}
+ * independently added with {@code addActionListener}.
+ * If the {@code Action} is already a registered
+ * {@code ActionListener} for the button, it is not re-registered.
* Action results in immediately changing
+ * Setting the {@code Action} results in immediately changing
* all the properties described in
- * Swing Components Supporting Action.
+ * Swing Components Supporting {@code Action}.
* Subsequently, the button's properties are automatically updated
- * as the Action's properties change.
+ * as the {@code Action}'s properties change.
* Action's property values.
- * It uses the configurePropertiesFromAction method
+ * and help track the {@code Action}'s property values.
+ * It uses the {@code configurePropertiesFromAction} method
* to immediately change the button's properties.
- * To track changes in the Action's property values,
- * this method registers the PropertyChangeListener
- * returned by createActionPropertyChangeListener. The
+ * To track changes in the {@code Action}'s property values,
+ * this method registers the {@code PropertyChangeListener}
+ * returned by {@code createActionPropertyChangeListener}. The
* default {@code PropertyChangeListener} invokes the
* {@code actionPropertyChanged} method when a property in the
* {@code Action} changes.
*
- * @param a the Action for the AbstractButton,
- * or null
+ * @param a the {@code Action} for the {@code AbstractButton},
+ * or {@code null}
* @since 1.3
* @see Action
* @see #getAction
@@ -1135,12 +1135,12 @@
}
/**
- * Returns the currently set Action for this
- * ActionEvent source, or null
- * if no Action is set.
+ * Returns the currently set {@code Action} for this
+ * {@code ActionEvent} source, or {@code null}
+ * if no {@code Action} is set.
*
- * @return the Action for this ActionEvent
- * source, or null
+ * @return the {@code Action} for this {@code ActionEvent}
+ * source, or {@code null}
* @since 1.3
* @see Action
* @see #setAction
@@ -1151,12 +1151,12 @@
/**
* Sets the properties on this button to match those in the specified
- * Action. Refer to
- * Swing Components Supporting Action for more
+ * {@code Action}. Refer to
+ * Swing Components Supporting {@code Action} for more
* details as to which properties this sets.
*
- * @param a the Action from which to get the properties,
- * or null
+ * @param a the {@code Action} from which to get the properties,
+ * or {@code null}
* @since 1.3
* @see Action
* @see #setAction
@@ -1205,10 +1205,10 @@
* {@code configurePropertiesFromAction}.
* Action for a list of
+ * Swing Components Supporting {@code Action} for a list of
* the properties this method sets.
*
- * @param action the Action associated with this button
+ * @param action the {@code Action} associated with this button
* @param propertyName the name of the property that changed
* @since 1.6
* @see Action
@@ -1330,13 +1330,13 @@
}
/**
- * Creates and returns a PropertyChangeListener that is
+ * Creates and returns a {@code PropertyChangeListener} that is
* responsible for listening for changes from the specified
- * Action and updating the appropriate properties.
+ * {@code Action} and updating the appropriate properties.
* Action.
+ * that of the {@code Action}.
*
* @param a the button's action
* @return the {@code PropertyChangeListener}
@@ -1371,9 +1371,9 @@
}
/**
- * Gets the borderPainted property.
+ * Gets the {@code borderPainted} property.
*
- * @return the value of the borderPainted property
+ * @return the value of the {@code borderPainted} property
* @see #setBorderPainted
*/
public boolean isBorderPainted() {
@@ -1381,16 +1381,16 @@
}
/**
- * Sets the borderPainted property.
- * If true and the button has a border,
+ * Sets the {@code borderPainted} property.
+ * If {@code true} and the button has a border,
* the border is painted. The default value for the
- * borderPainted property is true.
+ * {@code borderPainted} property is {@code true}.
* borderPainted property,
+ * the {@code borderPainted} property,
* in which case they ignore this.
*
- * @param b if true and border property is not null,
+ * @param b if true and border property is not {@code null},
* the border is painted
* @see #isBorderPainted
* @beaninfo
@@ -1410,9 +1410,9 @@
}
/**
- * Paint the button's border if BorderPainted
+ * Paint the button's border if {@code BorderPainted}
* property is true and the button has a border.
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
*
* @see #paint
* @see #setBorder
@@ -1424,9 +1424,9 @@
}
/**
- * Gets the paintFocus property.
+ * Gets the {@code paintFocus} property.
*
- * @return the paintFocus property
+ * @return the {@code paintFocus} property
* @see #setFocusPainted
*/
public boolean isFocusPainted() {
@@ -1434,14 +1434,14 @@
}
/**
- * Sets the paintFocus property, which must
- * be true for the focus state to be painted.
- * The default value for the paintFocus property
- * is true.
+ * Sets the {@code paintFocus} property, which must
+ * be {@code true} for the focus state to be painted.
+ * The default value for the {@code paintFocus} property
+ * is {@code true}.
* Some look and feels might not paint focus state;
* they will ignore this property.
*
- * @param b if true, the focus state should be painted
+ * @param b if {@code true}, the focus state should be painted
* @see #isFocusPainted
* @beaninfo
* bound: true
@@ -1459,9 +1459,9 @@
}
/**
- * Gets the contentAreaFilled property.
+ * Gets the {@code contentAreaFilled} property.
*
- * @return the contentAreaFilled property
+ * @return the {@code contentAreaFilled} property
* @see #setContentAreaFilled
*/
public boolean isContentAreaFilled() {
@@ -1469,13 +1469,13 @@
}
/**
- * Sets the contentAreaFilled property.
- * If true the button will paint the content
+ * Sets the {@code contentAreaFilled} property.
+ * If {@code true} the button will paint the content
* area. If you wish to have a transparent button, such as
* an icon only button, for example, then you should set
- * this to false. Do not call setOpaque(false).
- * The default value for the contentAreaFilled
- * property is true.
+ * this to {@code false}. Do not call {@code setOpaque(false)}.
+ * The default value for the {@code contentAreaFilled}
+ * property is {@code true}.
* rolloverEnabled property.
+ * Gets the {@code rolloverEnabled} property.
*
- * @return the value of the rolloverEnabled property
+ * @return the value of the {@code rolloverEnabled} property
* @see #setRolloverEnabled
*/
public boolean isRolloverEnabled() {
@@ -1513,14 +1513,14 @@
}
/**
- * Sets the rolloverEnabled property, which
- * must be true for rollover effects to occur.
- * The default value for the rolloverEnabled
- * property is false.
+ * Sets the {@code rolloverEnabled} property, which
+ * must be {@code true} for rollover effects to occur.
+ * The default value for the {@code rolloverEnabled}
+ * property is {@code false}.
* Some look and feels might not implement rollover effects;
* they will ignore this property.
*
- * @param b if true, rollover effects should be painted
+ * @param b if {@code true}, rollover effects should be painted
* @see #isRolloverEnabled
* @beaninfo
* bound: true
@@ -1553,11 +1553,11 @@
* window.
* VK_XXX
- * keycodes defined in java.awt.event.KeyEvent.
+ * and should be specified using one of the {@code VK_XXX}
+ * keycodes defined in {@code java.awt.event.KeyEvent}.
* These codes and the wider array of codes for international
* keyboards may be obtained through
- * java.awt.event.KeyEvent.getExtendedKeyCodeForChar.
+ * {@code java.awt.event.KeyEvent.getExtendedKeyCodeForChar}.
* Mnemonics are case-insensitive, therefore a key event
* with the corresponding keycode would cause the button to be
* activated whether or not the Shift modifier was pressed.
@@ -1582,7 +1582,7 @@
}
/**
- * This method is now obsolete, please use setMnemonic(int)
+ * This method is now obsolete, please use {@code setMnemonic(int)}
* to set the mnemonic for a button. This method is only designed
* to handle character values which fall between 'a' and 'z' or
* 'A' and 'Z'.
@@ -1614,12 +1614,12 @@
* you do not wish the default character to be underlined. For example, if
* the text was 'Save As', with a mnemonic of 'a', and you wanted the 'A'
* to be decorated, as 'Save As', you would have to invoke
- * setDisplayedMnemonicIndex(5) after invoking
- * setMnemonic(KeyEvent.VK_A).
+ * {@code setDisplayedMnemonicIndex(5)} after invoking
+ * {@code setMnemonic(KeyEvent.VK_A)}.
*
* @since 1.4
* @param index Index into the String to underline
- * @exception IllegalArgumentException will be thrown if index
+ * @exception IllegalArgumentException will be thrown if {@code index}
* is >= length of the text, or < -1
* @see #getDisplayedMnemonicIndex
*
@@ -1732,7 +1732,7 @@
/**
* Returns the model that this button represents.
- * @return the model property
+ * @return the {@code model} property
* @see #setModel
*/
public ButtonModel getModel() {
@@ -1741,7 +1741,7 @@
/**
* Sets the model that this button represents.
- * @param newModel the new ButtonModel
+ * @param newModel the new {@code ButtonModel}
* @see #getModel
* @beaninfo
* bound: true
@@ -1802,7 +1802,7 @@
/**
* Sets the L&F object that renders this component.
- * @param ui the ButtonUI L&F object
+ * @param ui the {@code ButtonUI} L&F object
* @see #getUI
* @beaninfo
* bound: true
@@ -1824,9 +1824,9 @@
/**
* Resets the UI property to a value from the current look
- * and feel. Subtypes of AbstractButton
+ * and feel. Subtypes of {@code AbstractButton}
* should override this to update the UI. For
- * example, JButton might do the following:
+ * example, {@code JButton} might do the following:
*
* setUI((ButtonUI)UIManager.getUI(
* "ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));
@@ -1845,9 +1845,9 @@
* @param constraints an object expressing layout constraints
* for this component
* @param index the position in the container's list at which to
- * insert the component, where
*
* @param i zero-based index of the key bindings
* @return a javax.lang.Object which specifies the key binding
--- old/src/java.desktop/share/classes/javax/swing/AbstractCellEditor.java 2015-10-04 22:56:24.041264253 +0400
+++ new/src/java.desktop/share/classes/javax/swing/AbstractCellEditor.java 2015-10-04 22:56:23.853264262 +0400
@@ -31,9 +31,9 @@
/**
*
- * A base class for -1
+ * insert the component, where {@code -1}
* means append to the end
- * @exception IllegalArgumentException if index is invalid
+ * @exception IllegalArgumentException if {@code index} is invalid
* @exception IllegalArgumentException if adding the container's parent
* to itself
* @exception IllegalArgumentException if adding a window to a container
@@ -1874,7 +1874,7 @@
}
/**
- * Adds a ChangeListener to the button.
+ * Adds a {@code ChangeListener} to the button.
* @param l the listener to be added
*/
public void addChangeListener(ChangeListener l) {
@@ -1890,10 +1890,10 @@
}
/**
- * Returns an array of all the ChangeListeners added
+ * Returns an array of all the {@code ChangeListener}s added
* to this AbstractButton with addChangeListener().
*
- * @return all of the ChangeListeners added or an empty
+ * @return all of the {@code ChangeListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -1923,18 +1923,18 @@
}
/**
- * Adds an ActionListener to the button.
- * @param l the ActionListener to be added
+ * Adds an {@code ActionListener} to the button.
+ * @param l the {@code ActionListener} to be added
*/
public void addActionListener(ActionListener l) {
listenerList.add(ActionListener.class, l);
}
/**
- * Removes an ActionListener from the button.
- * If the listener is the currently set Action
- * for the button, then the Action
- * is set to null.
+ * Removes an {@code ActionListener} from the button.
+ * If the listener is the currently set {@code Action}
+ * for the button, then the {@code Action}
+ * is set to {@code null}.
*
* @param l the listener to be removed
*/
@@ -1947,10 +1947,10 @@
}
/**
- * Returns an array of all the ActionListeners added
+ * Returns an array of all the {@code ActionListener}s added
* to this AbstractButton with addActionListener().
*
- * @return all of the ActionListeners added or an empty
+ * @return all of the {@code ActionListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -1959,18 +1959,18 @@
}
/**
- * Subclasses that want to handle ChangeEvents differently
- * can override this to return another ChangeListener
+ * Subclasses that want to handle {@code ChangeEvents} differently
+ * can override this to return another {@code ChangeListener}
* implementation.
*
- * @return the new ChangeListener
+ * @return the new {@code ChangeListener}
*/
protected ChangeListener createChangeListener() {
return getHandler();
}
/**
- * Extends ChangeListener to be serializable.
+ * Extends {@code ChangeListener} to be serializable.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial")
@@ -1997,10 +1997,10 @@
/**
* Notifies all listeners that have registered interest for
* notification on this event type. The event instance
- * is lazily created using the event
+ * is lazily created using the {@code event}
* parameter.
*
- * @param event the ActionEvent object
+ * @param event the {@code ActionEvent} object
* @see EventListenerList
*/
protected void fireActionPerformed(ActionEvent event) {
@@ -2031,9 +2031,9 @@
/**
* Notifies all listeners that have registered interest for
* notification on this event type. The event instance
- * is lazily created using the event parameter.
+ * is lazily created using the {@code event} parameter.
*
- * @param event the ItemEvent object
+ * @param event the {@code ItemEvent} object
* @see EventListenerList
*/
protected void fireItemStateChanged(ItemEvent event) {
@@ -2109,8 +2109,8 @@
/**
* Returns the label text.
*
- * @return a String containing the label
- * @deprecated - Replaced by getText
+ * @return a {@code String} containing the label
+ * @deprecated - Replaced by {@code getText}
*/
@Deprecated
public String getLabel() {
@@ -2120,8 +2120,8 @@
/**
* Sets the label text.
*
- * @param label a String containing the text
- * @deprecated - Replaced by setText(text)
+ * @param label a {@code String} containing the text
+ * @deprecated - Replaced by {@code setText(text)}
* @beaninfo
* bound: true
* description: Replace by setText(text)
@@ -2132,26 +2132,26 @@
}
/**
- * Adds an ItemListener to the checkbox.
- * @param l the ItemListener to be added
+ * Adds an {@code ItemListener} to the {@code checkbox}.
+ * @param l the {@code ItemListener} to be added
*/
public void addItemListener(ItemListener l) {
listenerList.add(ItemListener.class, l);
}
/**
- * Removes an ItemListener from the button.
- * @param l the ItemListener to be removed
+ * Removes an {@code ItemListener} from the button.
+ * @param l the {@code ItemListener} to be removed
*/
public void removeItemListener(ItemListener l) {
listenerList.remove(ItemListener.class, l);
}
/**
- * Returns an array of all the ItemListeners added
+ * Returns an array of all the {@code ItemListener}s added
* to this AbstractButton with addItemListener().
*
- * @return all of the ItemListeners added or an empty
+ * @return all of the {@code ItemListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -2161,10 +2161,10 @@
/**
* Returns an array (length 1) containing the label or
- * null if the button is not selected.
+ * {@code null} if the button is not selected.
*
* @return an array containing 1 Object: the text of the button,
- * if the item is selected; otherwise null
+ * if the item is selected; otherwise {@code null}
*/
public Object[] getSelectedObjects() {
if (isSelected() == false) {
@@ -2199,11 +2199,11 @@
/**
- * This is overridden to return false if the current Icon's
- * Image is not equal to the
- * passed in Image img.
+ * This is overridden to return false if the current {@code Icon}'s
+ * {@code Image} is not equal to the
+ * passed in {@code Image img}.
*
- * @param img the Image to be compared
+ * @param img the {@code Image} to be compared
* @param infoflags flags used to repaint the button when the image
* is updated and which determine how much is to be painted
* @param x the x coordinate
@@ -2275,17 +2275,17 @@
}
/**
- * Returns a string representation of this AbstractButton.
+ * Returns a string representation of this {@code AbstractButton}.
* This method
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
* paramString to provide information about the
+ * Overriding {@code paramString} to provide information about the
* specific new aspects of the JFC components.
*
- * @return a string representation of this AbstractButton
+ * @return a string representation of this {@code AbstractButton}
*/
protected String paramString() {
String defaultIconString = ((defaultIcon != null)
@@ -2390,7 +2390,7 @@
///////////////////
/**
* This class implements accessibility support for the
- * AbstractButton class. It provides an implementation of the
+ * {@code AbstractButton} class. It provides an implementation of the
* Java Accessibility API appropriate to button and menu item
* user-interface elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
* @since 1.4
*/
@@ -2413,7 +2413,7 @@
* Returns the accessible name of this object.
*
* @return the localized name of the object -- can be
- * null if this
+ * {@code null} if this
* object does not have a name
*/
public String getAccessibleName() {
@@ -3097,7 +3097,7 @@
* on the underlying implementation of the key. For example, if the
* Object returned is a javax.swing.KeyStroke, the user of this
* method should do the following:
- *
+ * {@code
* Component c = CellEditors, providing default
- * implementations for the methods in the CellEditor
- * interface except getCellEditorValue().
+ * A base class for {@code CellEditors}, providing default
+ * implementations for the methods in the {@code CellEditor}
+ * interface except {@code getCellEditorValue()}.
* Like the other abstract implementations in Swing, also manages a list
* of listeners.
*
@@ -44,7 +44,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Philip Milne
@@ -84,7 +84,7 @@
}
/**
- * Calls fireEditingStopped and returns true.
+ * Calls {@code fireEditingStopped} and returns true.
* @return true
*/
public boolean stopCellEditing() {
@@ -93,14 +93,14 @@
}
/**
- * Calls fireEditingCanceled.
+ * Calls {@code fireEditingCanceled}.
*/
public void cancelCellEditing() {
fireEditingCanceled();
}
/**
- * Adds a CellEditorListener to the listener list.
+ * Adds a {@code CellEditorListener} to the listener list.
* @param l the new listener to be added
*/
public void addCellEditorListener(CellEditorListener l) {
@@ -108,7 +108,7 @@
}
/**
- * Removes a CellEditorListener from the listener list.
+ * Removes a {@code CellEditorListener} from the listener list.
* @param l the listener to be removed
*/
public void removeCellEditorListener(CellEditorListener l) {
@@ -116,10 +116,10 @@
}
/**
- * Returns an array of all the CellEditorListeners added
+ * Returns an array of all the {@code CellEditorListener}s added
* to this AbstractCellEditor with addCellEditorListener().
*
- * @return all of the CellEditorListeners added or an empty
+ * @return all of the {@code CellEditorListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
--- old/src/java.desktop/share/classes/javax/swing/AbstractListModel.java 2015-10-04 22:56:24.565264230 +0400
+++ new/src/java.desktop/share/classes/javax/swing/AbstractListModel.java 2015-10-04 22:56:24.377264238 +0400
@@ -31,7 +31,7 @@
/**
* The abstract definition for the data model that provides
- * a List with its contents.
+ * a {@code List} with its contents.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @param ListDataListener to be added
+ * @param l the {@code ListDataListener} to be added
*/
public void addListDataListener(ListDataListener l) {
listenerList.add(ListDataListener.class, l);
@@ -71,7 +71,7 @@
* Removes a listener from the list that's notified each time a
* change to the data model occurs.
*
- * @param l the ListDataListener to be removed
+ * @param l the {@code ListDataListener} to be removed
*/
public void removeListDataListener(ListDataListener l) {
listenerList.remove(ListDataListener.class, l);
@@ -80,9 +80,9 @@
/**
* Returns an array of all the list data listeners
- * registered on this AbstractListModel.
+ * registered on this {@code AbstractListModel}.
*
- * @return all of this model's ListDataListeners,
+ * @return all of this model's {@code ListDataListener}s,
* or an empty array if no list data listeners
* are currently registered
*
@@ -97,14 +97,14 @@
/**
- * AbstractListModel subclasses must call this method
+ * {@code AbstractListModel} subclasses must call this method
* after
* one or more elements of the list change. The changed elements
* are specified by the closed interval index0, index1 -- the endpoints
* are included. Note that
* index0 need not be less than or equal to index1.
*
- * @param source the ListModel that changed, typically "this"
+ * @param source the {@code ListModel} that changed, typically "this"
* @param index0 one end of the new interval
* @param index1 the other end of the new interval
* @see EventListenerList
@@ -127,14 +127,14 @@
/**
- * AbstractListModel subclasses must call this method
+ * {@code AbstractListModel} subclasses must call this method
* after
* one or more elements are added to the model. The new elements
* are specified by a closed interval index0, index1 -- the enpoints
* are included. Note that
* index0 need not be less than or equal to index1.
*
- * @param source the ListModel that changed, typically "this"
+ * @param source the {@code ListModel} that changed, typically "this"
* @param index0 one end of the new interval
* @param index1 the other end of the new interval
* @see EventListenerList
@@ -157,17 +157,17 @@
/**
- * AbstractListModel subclasses must call this method
+ * {@code AbstractListModel} subclasses must call this method
* after one or more elements are removed from the model.
- * index0 and index1 are the end points
- * of the interval that's been removed. Note that index0
- * need not be less than or equal to index1.
+ * {@code index0} and {@code index1} are the end points
+ * of the interval that's been removed. Note that {@code index0}
+ * need not be less than or equal to {@code index1}.
*
- * @param source the ListModel that changed, typically "this"
+ * @param source the {@code ListModel} that changed, typically "this"
* @param index0 one end of the removed interval,
- * including index0
+ * including {@code index0}
* @param index1 the other end of the removed interval,
- * including index1
+ * including {@code index1}
* @see EventListenerList
* @see DefaultListModel
*/
@@ -193,10 +193,10 @@
* FooListeners
* are registered using the addFooListener method.
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as FooListener.class.
* For example, you can query a list model
- * m
+ * {@code m}
* for its list data listeners
* with the following code:
*
@@ -208,15 +208,15 @@
* @param java.util.EventListener
+ * that descends from {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners
* on this model,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType doesn't
+ * @exception ClassCastException if {@code listenerType} doesn't
* specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getListDataListeners
*
--- old/src/java.desktop/share/classes/javax/swing/AbstractSpinnerModel.java 2015-10-04 22:56:25.093264206 +0400
+++ new/src/java.desktop/share/classes/javax/swing/AbstractSpinnerModel.java 2015-10-04 22:56:24.901264215 +0400
@@ -34,8 +34,8 @@
* This class provides the ChangeListener part of the
* SpinnerModel interface that should be suitable for most concrete SpinnerModel
* implementations. Subclasses must provide an implementation of the
- * setValue, getValue, getNextValue and
- * getPreviousValue methods.
+ * {@code setValue}, {@code getValue}, {@code getNextValue} and
+ * {@code getPreviousValue} methods.
*
* @see JSpinner
* @see SpinnerModel
@@ -91,10 +91,10 @@
/**
- * Returns an array of all the ChangeListeners added
+ * Returns an array of all the {@code ChangeListener}s added
* to this AbstractSpinnerModel with addChangeListener().
*
- * @return all of the ChangeListeners added or an empty
+ * @return all of the {@code ChangeListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
--- old/src/java.desktop/share/classes/javax/swing/Action.java 2015-10-04 22:56:25.617264183 +0400
+++ new/src/java.desktop/share/classes/javax/swing/Action.java 2015-10-04 22:56:25.425264191 +0400
@@ -29,13 +29,13 @@
import java.beans.*;
/**
- * The Action interface provides a useful extension to the
- * ActionListener
+ * The {@code Action} interface provides a useful extension to the
+ * {@code ActionListener}
* interface in cases where the same functionality may be accessed by
* several controls.
* actionPerformed method defined by the
- * ActionListener interface, this interface allows the
+ * In addition to the {@code actionPerformed} method defined by the
+ * {@code ActionListener} interface, this interface allows the
* application to define, in a single place:
*
*
* AbstractAction).
- * The Action object
- * can then be added to multiple Action-aware containers
- * and connected to Action-capable
+ * adapter (typically, by subclassing {@code AbstractAction}).
+ * The {@code Action} object
+ * can then be added to multiple {@code Action}-aware containers
+ * and connected to {@code Action}-capable
* components. The GUI controls can then be activated or
- * deactivated all at once by invoking the Action object's
- * setEnabled method.
+ * deactivated all at once by invoking the {@code Action} object's
+ * {@code setEnabled} method.
* Action implementations tend to be more expensive
- * in terms of storage than a typical ActionListener,
+ * Note that {@code Action} implementations tend to be more expensive
+ * in terms of storage than a typical {@code ActionListener},
* which does not offer the benefits of centralized control of
* functionality and broadcast of property changes. For this reason,
- * you should take care to only use Actions where their benefits
- * are desired, and use simple ActionListeners elsewhere.
+ * you should take care to only use {@code Action}s where their benefits
+ * are desired, and use simple {@code ActionListener}s elsewhere.
*
*
- * Swing Components Supporting
+ * ActionSwing Components Supporting {@code Action}
* Action property. When
- * an Action is set on a component, the following things
+ * Many of Swing's components have an {@code Action} property. When
+ * an {@code Action} is set on a component, the following things
* happen:
*
- *
* Action is added as an ActionListener to
+ * Action.
- * PropertyChangeListener on the
- * Action so that the component can change its properties
- * to reflect changes in the Action's properties.
+ * {@code Action}.
+ * Swing components that support Actions.
+ * {@code Swing} components that support {@code Actions}.
* In the table, button refers to any
- * AbstractButton subclass, which includes not only
- * JButton but also classes such as
- * JMenuItem. Unless otherwise stated, a
- * null property value in an Action (or a
- * Action that is null) results in the
- * button's corresponding property being set to null.
+ * {@code AbstractButton} subclass, which includes not only
+ * {@code JButton} but also classes such as
+ * {@code JMenuItem}. Unless otherwise stated, a
+ * {@code null} property value in an {@code Action} (or a
+ * {@code Action} that is {@code null}) results in the
+ * button's corresponding property being set to {@code null}.
*
*
@@ -102,76 +102,76 @@
*
* Action Key
* Notes
*
- * enabled
+ * {@code enabled}
* All
- * The isEnabled method
+ * The {@code isEnabled} method
*
*
- * toolTipText
+ * {@code toolTipText}
* All
- * SHORT_DESCRIPTION
+ * {@code SHORT_DESCRIPTION}
*
*
- * actionCommand
+ * {@code actionCommand}
* All
- * ACTION_COMMAND_KEY
+ * {@code ACTION_COMMAND_KEY}
*
*
- * mnemonic
+ * {@code mnemonic}
* All buttons
- * MNEMONIC_KEY
- * A null value or Action results in the
- * button's mnemonic property being set to
- * '\0'.
+ * {@code MNEMONIC_KEY}
+ * A {@code null} value or {@code Action} results in the
+ * button's {@code mnemonic} property being set to
+ * {@code '\0'}.
*
- * text
+ * {@code text}
* All buttons
- * NAME
+ * {@code NAME}
* If you do not want the text of the button to mirror that
- * of the Action, set the property
- * hideActionText to true. If
- * hideActionText is true, setting the
- * Action changes the text of the button to
- * null and any changes to NAME
- * are ignored. hideActionText is useful for
- * tool bar buttons that typically only show an Icon.
- * JToolBar.add(Action) sets the property to
- * true if the Action has a
- * non-null value for LARGE_ICON_KEY or
- * SMALL_ICON.
+ * of the {@code Action}, set the property
+ * {@code hideActionText} to {@code true}. If
+ * {@code hideActionText} is {@code true}, setting the
+ * {@code Action} changes the text of the button to
+ * {@code null} and any changes to {@code NAME}
+ * are ignored. {@code hideActionText} is useful for
+ * tool bar buttons that typically only show an {@code Icon}.
+ * {@code JToolBar.add(Action)} sets the property to
+ * {@code true} if the {@code Action} has a
+ * non-{@code null} value for {@code LARGE_ICON_KEY} or
+ * {@code SMALL_ICON}.
*
- * displayedMnemonicIndex
+ * {@code displayedMnemonicIndex}
* All buttons
- * DISPLAYED_MNEMONIC_INDEX_KEY
- * If the value of DISPLAYED_MNEMONIC_INDEX_KEY is
+ * {@code DISPLAYED_MNEMONIC_INDEX_KEY}
+ * If the value of {@code DISPLAYED_MNEMONIC_INDEX_KEY} is
* beyond the bounds of the text, it is ignored. When
- * setAction is called, if the value from the
- * Action is null, the displayed
+ * {@code setAction} is called, if the value from the
+ * {@code Action} is {@code null}, the displayed
* mnemonic index is not updated. In any subsequent changes to
- * DISPLAYED_MNEMONIC_INDEX_KEY, null
+ * {@code DISPLAYED_MNEMONIC_INDEX_KEY}, {@code null}
* is treated as -1.
*
- * icon
- * All buttons except of JCheckBox,
- * JToggleButton and JRadioButton.
- * either LARGE_ICON_KEY or
- * SMALL_ICON
- * The JMenuItem subclasses only use
- * SMALL_ICON. All other buttons will use
- * LARGE_ICON_KEY; if the value is null they
- * use SMALL_ICON.
+ * {@code icon}
+ * All buttons except of {@code JCheckBox},
+ * {@code JToggleButton} and {@code JRadioButton}.
+ * either {@code LARGE_ICON_KEY} or
+ * {@code SMALL_ICON}
+ * The {@code JMenuItem} subclasses only use
+ * {@code SMALL_ICON}. All other buttons will use
+ * {@code LARGE_ICON_KEY}; if the value is {@code null} they
+ * use {@code SMALL_ICON}.
*
- * accelerator
- * All JMenuItem subclasses, with the exception of
- * JMenu.
- * ACCELERATOR_KEY
+ * {@code accelerator}
+ * All {@code JMenuItem} subclasses, with the exception of
+ * {@code JMenu}.
+ * {@code ACCELERATOR_KEY}
*
*
- * selected
- * JToggleButton, JCheckBox,
- * JRadioButton, JCheckBoxMenuItem and
- * JRadioButtonMenuItem
- * SELECTED_KEY
+ * {@code selected}
+ * {@code JToggleButton}, {@code JCheckBox},
+ * {@code JRadioButton}, {@code JCheckBoxMenuItem} and
+ * {@code JRadioButtonMenuItem}
+ * {@code SELECTED_KEY}
* Components that honor this property only use
* the value if it is {@code non-null}. For example, if
* you set an {@code Action} that has a {@code null}
@@ -193,20 +193,20 @@
* exclusive buttons.
* JPopupMenu, JToolBar and JMenu
+ * {@code JPopupMenu}, {@code JToolBar} and {@code JMenu}
* all provide convenience methods for creating a component and setting the
- * Action on the corresponding component. Refer to each of
+ * {@code Action} on the corresponding component. Refer to each of
* these classes for more information.
* Action uses PropertyChangeListener to
- * inform listeners the Action has changed. The beans
- * specification indicates that a null property name can
+ * {@code Action} uses {@code PropertyChangeListener} to
+ * inform listeners the {@code Action} has changed. The beans
+ * specification indicates that a {@code null} property name can
* be used to indicate multiple values have changed. By default Swing
- * components that take an Action do not handle such a
- * change. To indicate that Swing should treat null
+ * components that take an {@code Action} do not handle such a
+ * change. To indicate that Swing should treat {@code null}
* according to the beans specification set the system property
- * swing.actions.reconfigureOnNull to the String
- * value true.
+ * {@code swing.actions.reconfigureOnNull} to the {@code String}
+ * value {@code true}.
*
* @author Georges Saab
* @see AbstractAction
@@ -223,44 +223,44 @@
*/
public static final String DEFAULT = "Default";
/**
- * The key used for storing the String name
+ * The key used for storing the {@code String} name
* for the action, used for a menu or button.
*/
public static final String NAME = "Name";
/**
- * The key used for storing a short String
+ * The key used for storing a short {@code String}
* description for the action, used for tooltip text.
*/
public static final String SHORT_DESCRIPTION = "ShortDescription";
/**
- * The key used for storing a longer String
+ * The key used for storing a longer {@code String}
* description for the action, could be used for context-sensitive help.
*/
public static final String LONG_DESCRIPTION = "LongDescription";
/**
- * The key used for storing a small Icon, such
- * as ImageIcon. This is typically used with
- * menus such as JMenuItem.
+ * The key used for storing a small {@code Icon}, such
+ * as {@code ImageIcon}. This is typically used with
+ * menus such as {@code JMenuItem}.
* Action is used with menus and buttons you'll
- * typically specify both a SMALL_ICON and a
- * LARGE_ICON_KEY. The menu will use the
- * SMALL_ICON and the button will use the
- * LARGE_ICON_KEY.
+ * If the same {@code Action} is used with menus and buttons you'll
+ * typically specify both a {@code SMALL_ICON} and a
+ * {@code LARGE_ICON_KEY}. The menu will use the
+ * {@code SMALL_ICON} and the button will use the
+ * {@code LARGE_ICON_KEY}.
*/
public static final String SMALL_ICON = "SmallIcon";
/**
- * The key used to determine the command String for the
- * ActionEvent that will be created when an
- * Action is going to be notified as the result of
- * residing in a Keymap associated with a
- * JComponent.
+ * The key used to determine the command {@code String} for the
+ * {@code ActionEvent} that will be created when an
+ * {@code Action} is going to be notified as the result of
+ * residing in a {@code Keymap} associated with a
+ * {@code JComponent}.
*/
public static final String ACTION_COMMAND_KEY = "ActionCommandKey";
/**
- * The key used for storing a KeyStroke to be used as the
+ * The key used for storing a {@code KeyStroke} to be used as the
* accelerator for the action.
*
* @since 1.3
@@ -268,49 +268,49 @@
public static final String ACCELERATOR_KEY="AcceleratorKey";
/**
- * The key used for storing an Integer that corresponds to
- * one of the KeyEvent key codes. The value is
+ * The key used for storing an {@code Integer} that corresponds to
+ * one of the {@code KeyEvent} key codes. The value is
* commonly used to specify a mnemonic. For example:
- * myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.VK_A)
- * sets the mnemonic of myAction to 'a', while
+ * {@code myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.VK_A)}
+ * sets the mnemonic of {@code myAction} to 'a', while
* myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.getExtendedKeyCodeForChar('\u0444'))
- * sets the mnemonic of myAction to Cyrillic letter "Ef".
+ * sets the mnemonic of {@code myAction} to Cyrillic letter "Ef".
*
* @since 1.3
*/
public static final String MNEMONIC_KEY="MnemonicKey";
/**
- * The key used for storing a Boolean that corresponds
+ * The key used for storing a {@code Boolean} that corresponds
* to the selected state. This is typically used only for components
* that have a meaningful selection state. For example,
- * JRadioButton and JCheckBox make use of
- * this but instances of JMenu don't.
+ * {@code JRadioButton} and {@code JCheckBox} make use of
+ * this but instances of {@code JMenu} don't.
* Action is attached to a JCheckBox
- * the selected state of the JCheckBox will be set from
- * that of the Action. If the user clicks on the
- * JCheckBox the selected state of the JCheckBox
- * and the Action will both be updated.
+ * if an {@code Action} is attached to a {@code JCheckBox}
+ * the selected state of the {@code JCheckBox} will be set from
+ * that of the {@code Action}. If the user clicks on the
+ * {@code JCheckBox} the selected state of the {@code JCheckBox}
+ * and the {@code Action} will both be updated.
* Actions.
+ * avoid possible collisions with existing {@code Actions}.
*
* @since 1.6
*/
public static final String SELECTED_KEY = "SwingSelectedKey";
/**
- * The key used for storing an Integer that corresponds
- * to the index in the text (identified by the NAME
+ * The key used for storing an {@code Integer} that corresponds
+ * to the index in the text (identified by the {@code NAME}
* property) that the decoration for a mnemonic should be rendered at. If
* the value of this property is greater than or equal to the length of
* the text, it will treated as -1.
* Actions.
+ * avoid possible collisions with existing {@code Actions}.
*
* @see AbstractButton#setDisplayedMnemonicIndex
* @since 1.6
@@ -319,17 +319,17 @@
"SwingDisplayedMnemonicIndexKey";
/**
- * The key used for storing an Icon. This is typically
- * used by buttons, such as JButton and
- * JToggleButton.
+ * The key used for storing an {@code Icon}. This is typically
+ * used by buttons, such as {@code JButton} and
+ * {@code JToggleButton}.
* Action is used with menus and buttons you'll
- * typically specify both a SMALL_ICON and a
- * LARGE_ICON_KEY. The menu will use the
- * SMALL_ICON and the button the LARGE_ICON_KEY.
+ * If the same {@code Action} is used with menus and buttons you'll
+ * typically specify both a {@code SMALL_ICON} and a
+ * {@code LARGE_ICON_KEY}. The menu will use the
+ * {@code SMALL_ICON} and the button the {@code LARGE_ICON_KEY}.
* Actions.
+ * avoid possible collisions with existing {@code Actions}.
*
* @since 1.6
*/
@@ -347,46 +347,46 @@
/**
* Sets one of this object's properties
* using the associated key. If the value has
- * changed, a PropertyChangeEvent is sent
+ * changed, a {@code PropertyChangeEvent} is sent
* to listeners.
*
- * @param key a String containing the key
- * @param value an Object value
+ * @param key a {@code String} containing the key
+ * @param value an {@code Object} value
*/
public void putValue(String key, Object value);
/**
- * Sets the enabled state of the Action. When enabled,
+ * Sets the enabled state of the {@code Action}. When enabled,
* any component associated with this object is active and
- * able to fire this object's actionPerformed method.
- * If the value has changed, a PropertyChangeEvent is sent
+ * able to fire this object's {@code actionPerformed} method.
+ * If the value has changed, a {@code PropertyChangeEvent} is sent
* to listeners.
*
- * @param b true to enable this Action, false to disable it
+ * @param b true to enable this {@code Action}, false to disable it
*/
public void setEnabled(boolean b);
/**
- * Returns the enabled state of the Action. When enabled,
+ * Returns the enabled state of the {@code Action}. When enabled,
* any component associated with this object is active and
- * able to fire this object's actionPerformed method.
+ * able to fire this object's {@code actionPerformed} method.
*
- * @return true if this Action is enabled
+ * @return true if this {@code Action} is enabled
*/
public boolean isEnabled();
/**
- * Adds a PropertyChange listener. Containers and attached
+ * Adds a {@code PropertyChange} listener. Containers and attached
* components use these methods to register interest in this
- * Action object. When its enabled state or other property
+ * {@code Action} object. When its enabled state or other property
* changes, the registered listeners are informed of the change.
*
- * @param listener a PropertyChangeListener object
+ * @param listener a {@code PropertyChangeListener} object
*/
public void addPropertyChangeListener(PropertyChangeListener listener);
/**
- * Removes a PropertyChange listener.
+ * Removes a {@code PropertyChange} listener.
*
- * @param listener a PropertyChangeListener object
+ * @param listener a {@code PropertyChangeListener} object
* @see #addPropertyChangeListener
*/
public void removePropertyChangeListener(PropertyChangeListener listener);
--- old/src/java.desktop/share/classes/javax/swing/ActionMap.java 2015-10-04 22:56:26.149264159 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ActionMap.java 2015-10-04 22:56:25.961264167 +0400
@@ -32,16 +32,16 @@
import java.util.Set;
/**
- * ActionMap provides mappings from
- * Objects
- * (called keys or Action names)
- * to Actions.
- * An ActionMap is usually used with an InputMap
+ * {@code ActionMap} provides mappings from
+ * {@code Object}s
+ * (called keys or {@code Action} names)
+ * to {@code Action}s.
+ * An {@code ActionMap} is usually used with an {@code InputMap}
* to locate a particular action
- * when a key is pressed. As with InputMap,
- * an ActionMap can have a parent
- * that is searched for keys not defined in the ActionMap.
- * InputMap if you create a cycle, eg:
+ * when a key is pressed. As with {@code InputMap},
+ * an {@code ActionMap} can have a parent
+ * that is searched for keys not defined in the {@code ActionMap}.
+ *
* ActionMap am = new ActionMap();
* ActionMap bm = new ActionMap():
@@ -64,36 +64,36 @@
/**
- * Creates an ActionMap with no parent and no mappings.
+ * Creates an {@code ActionMap} with no parent and no mappings.
*/
public ActionMap() {
}
/**
- * Sets this ActionMap's parent.
+ * Sets this {@code ActionMap}'s parent.
*
- * @param map the ActionMap that is the parent of this one
+ * @param map the {@code ActionMap} that is the parent of this one
*/
public void setParent(ActionMap map) {
this.parent = map;
}
/**
- * Returns this ActionMap's parent.
+ * Returns this {@code ActionMap}'s parent.
*
- * @return the ActionMap that is the parent of this one,
- * or null if this ActionMap has no parent
+ * @return the {@code ActionMap} that is the parent of this one,
+ * or null if this {@code ActionMap} has no parent
*/
public ActionMap getParent() {
return parent;
}
/**
- * Adds a binding for key to action.
- * If action is null, this removes the current binding
- * for key.
- * key will be
- * action.getValue(NAME).
+ * Adds a binding for {@code key} to {@code action}.
+ * If {@code action} is null, this removes the current binding
+ * for {@code key}.
+ * key, messaging the
- * parent ActionMap if the binding is not locally defined.
+ * Returns the binding for {@code key}, messaging the
+ * parent {@code ActionMap} if the binding is not locally defined.
*
* @param key a key
* @return the binding for {@code key}
@@ -135,7 +135,7 @@
}
/**
- * Removes the binding for key from this ActionMap.
+ * Removes the binding for {@code key} from this {@code ActionMap}.
*
* @param key a key
*/
@@ -146,7 +146,7 @@
}
/**
- * Removes all the mappings from this ActionMap.
+ * Removes all the mappings from this {@code ActionMap}.
*/
public void clear() {
if (arrayTable != null) {
@@ -155,7 +155,7 @@
}
/**
- * Returns the Action names that are bound in this ActionMap.
+ * Returns the {@code Action} names that are bound in this {@code ActionMap}.
*
* @return an array of the keys
*/
@@ -179,8 +179,8 @@
}
/**
- * Returns an array of the keys defined in this ActionMap and
- * its parent. This method differs from keys() in that
+ * Returns an array of the keys defined in this {@code ActionMap} and
+ * its parent. This method differs from {@code keys()} in that
* this method includes the keys defined in the parent.
*
* @return an array of the keys
--- old/src/java.desktop/share/classes/javax/swing/ActionPropertyChangeListener.java 2015-10-04 22:56:26.673264135 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ActionPropertyChangeListener.java 2015-10-04 22:56:26.485264144 +0400
@@ -78,7 +78,7 @@
/**
* PropertyChangeListener method. If the target has been gc'ed this
- * will remove the PropertyChangeListener from the Action,
+ * will remove the {@code PropertyChangeListener} from the Action,
* otherwise this will invoke actionPropertyChanged.
*/
public final void propertyChange(PropertyChangeEvent e) {
--- old/src/java.desktop/share/classes/javax/swing/ArrayTable.java 2015-10-04 22:56:27.197264112 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ArrayTable.java 2015-10-04 22:56:27.009264120 +0400
@@ -52,7 +52,7 @@
* Writes the passed in ArrayTable to the passed in ObjectOutputStream.
* The data is saved as an integer indicating how many key/value
* pairs are being archived, followed by the key/value pairs. If
- * table is null, 0 will be written to s.
+ * {@code table} is null, 0 will be written to {@code s}.
* ArrayTable.
+ * Returns a clone of the {@code ArrayTable}.
*/
public Object clone() {
ArrayTable newArrayTable = new ArrayTable();
@@ -272,7 +272,7 @@
}
/**
- * Returns the keys of the table, or null if there
+ * Returns the keys of the table, or {@code null} if there
* are currently no bindings.
* @param keys array of keys
* @return an array of bindings
--- old/src/java.desktop/share/classes/javax/swing/BorderFactory.java 2015-10-04 22:56:27.721264088 +0400
+++ new/src/java.desktop/share/classes/javax/swing/BorderFactory.java 2015-10-04 22:56:27.533264097 +0400
@@ -31,9 +31,9 @@
import javax.swing.border.*;
/**
- * Factory class for vending standard Border objects. Wherever
+ * Factory class for vending standard {@code Border} objects. Wherever
* possible, this factory will hand out references to shared
- * Border instances.
+ * {@code Border} instances.
* For further information and examples see
* How
to Use Borders,
@@ -54,8 +54,8 @@
/**
* Creates a line border withe the specified color.
*
- * @param color a Color to use for the line
- * @return the Border object
+ * @param color a {@code Color} to use for the line
+ * @return the {@code Border} object
*/
public static Border createLineBorder(Color color) {
return new LineBorder(color, 1);
@@ -68,9 +68,9 @@
* bottom, left, and right, use
* {@link #createMatteBorder(int,int,int,int,Color)}.
*
- * @param color a Color to use for the line
+ * @param color a {@code Color} to use for the line
* @param thickness an integer specifying the width in pixels
- * @return the Border object
+ * @return the {@code Border} object
*/
public static Border createLineBorder(Color color, int thickness) {
return new LineBorder(color, thickness);
@@ -103,7 +103,7 @@
* (In a raised border, highlights are on top and shadows
* are underneath.)
*
- * @return the Border object
+ * @return the {@code Border} object
*/
public static Border createRaisedBevelBorder() {
return createSharedBevel(BevelBorder.RAISED);
@@ -116,7 +116,7 @@
* (In a lowered border, shadows are on top and highlights
* are underneath.)
*
- * @return the Border object
+ * @return the {@code Border} object
*/
public static Border createLoweredBevelBorder() {
return createSharedBevel(BevelBorder.LOWERED);
@@ -130,9 +130,9 @@
* are underneath.)
*
* @param type an integer specifying either
- * BevelBorder.LOWERED or
- * BevelBorder.RAISED
- * @return the Border object
+ * {@code BevelBorder.LOWERED} or
+ * {@code BevelBorder.RAISED}
+ * @return the {@code Border} object
*/
public static Border createBevelBorder(int type) {
return createSharedBevel(type);
@@ -146,11 +146,11 @@
* uses a brighter shade of the shadow color.
*
* @param type an integer specifying either
- * BevelBorder.LOWERED or
- * BevelBorder.RAISED
- * @param highlight a Color object for highlights
- * @param shadow a Color object for shadows
- * @return the Border object
+ * {@code BevelBorder.LOWERED} or
+ * {@code BevelBorder.RAISED}
+ * @param highlight a {@code Color} object for highlights
+ * @param shadow a {@code Color} object for shadows
+ * @return the {@code Border} object
*/
public static Border createBevelBorder(int type, Color highlight, Color shadow) {
return new BevelBorder(type, highlight, shadow);
@@ -162,17 +162,17 @@
* and shadow areas.
*
* @param type an integer specifying either
- * BevelBorder.LOWERED or
- * BevelBorder.RAISED
- * @param highlightOuter a Color object for the
+ * {@code BevelBorder.LOWERED} or
+ * {@code BevelBorder.RAISED}
+ * @param highlightOuter a {@code Color} object for the
* outer edge of the highlight area
- * @param highlightInner a Color object for the
+ * @param highlightInner a {@code Color} object for the
* inner edge of the highlight area
- * @param shadowOuter a Color object for the
+ * @param shadowOuter a {@code Color} object for the
* outer edge of the shadow area
- * @param shadowInner a Color object for the
+ * @param shadowInner a {@code Color} object for the
* inner edge of the shadow area
- * @return the Border object
+ * @return the {@code Border} object
*/
public static Border createBevelBorder(int type,
Color highlightOuter, Color highlightInner,
@@ -306,7 +306,7 @@
* the component's current background color for
* highlighting and shading.
*
- * @return the Border object
+ * @return the {@code Border} object
*/
public static Border createEtchedBorder() {
return sharedEtchedBorder;
@@ -316,9 +316,9 @@
* Creates a border with an "etched" look using
* the specified highlighting and shading colors.
*
- * @param highlight a Color object for the border highlights
- * @param shadow a Color object for the border shadows
- * @return the Border object
+ * @param highlight a {@code Color} object for the border highlights
+ * @param shadow a {@code Color} object for the border shadows
+ * @return the {@code Border} object
*/
public static Border createEtchedBorder(Color highlight, Color shadow) {
return new EtchedBorder(highlight, shadow);
@@ -329,12 +329,12 @@
* the component's current background color for
* highlighting and shading.
*
- * @param type one of EtchedBorder.RAISED, or
- * EtchedBorder.LOWERED
- * @return the Border object
+ * @param type one of {@code EtchedBorder.RAISED}, or
+ * {@code EtchedBorder.LOWERED}
+ * @return the {@code Border} object
* @exception IllegalArgumentException if type is not either
- * EtchedBorder.RAISED or
- * EtchedBorder.LOWERED
+ * {@code EtchedBorder.RAISED} or
+ * {@code EtchedBorder.LOWERED}
* @since 1.3
*/
public static Border createEtchedBorder(int type) {
@@ -356,11 +356,11 @@
* Creates a border with an "etched" look using
* the specified highlighting and shading colors.
*
- * @param type one of EtchedBorder.RAISED, or
- * EtchedBorder.LOWERED
- * @param highlight a Color object for the border highlights
- * @param shadow a Color object for the border shadows
- * @return the Border object
+ * @param type one of {@code EtchedBorder.RAISED}, or
+ * {@code EtchedBorder.LOWERED}
+ * @param highlight a {@code Color} object for the border highlights
+ * @param shadow a {@code Color} object for the border shadows
+ * @return the {@code Border} object
* @since 1.3
*/
public static Border createEtchedBorder(int type, Color highlight,
@@ -376,8 +376,8 @@
* the default justification (leading), and the default
* font and text color (determined by the current look and feel).
*
- * @param title a String containing the text of the title
- * @return the TitledBorder object
+ * @param title a {@code String} containing the text of the title
+ * @return the {@code TitledBorder} object
*/
public static TitledBorder createTitledBorder(String title) {
return new TitledBorder(title);
@@ -390,10 +390,10 @@
* the default justification (leading), and the default
* font and text color (determined by the current look and feel).
*
- * @param border the Border object to add the title to; if
- * null the Border is determined
+ * @param border the {@code Border} object to add the title to; if
+ * {@code null} the {@code Border} is determined
* by the current look and feel.
- * @return the TitledBorder object
+ * @return the {@code TitledBorder} object
*/
public static TitledBorder createTitledBorder(Border border) {
return new TitledBorder(border);
@@ -405,9 +405,9 @@
* default justification (leading) and the default
* font and text color (determined by the current look and feel).
*
- * @param border the Border object to add the title to
- * @param title a String containing the text of the title
- * @return the TitledBorder object
+ * @param border the {@code Border} object to add the title to
+ * @param title a {@code String} containing the text of the title
+ * @return the {@code TitledBorder} object
*/
public static TitledBorder createTitledBorder(Border border,
String title) {
@@ -419,31 +419,31 @@
* positioning and using the default
* font and text color (determined by the current look and feel).
*
- * @param border the Border object to add the title to
- * @param title a String containing the text of the title
+ * @param border the {@code Border} object to add the title to
+ * @param title a {@code String} containing the text of the title
* @param titleJustification an integer specifying the justification
* of the title -- one of the following:
*
- *
* @param titlePosition an integer specifying the vertical position of
* the text in relation to the border -- one of the following:
*TitledBorder.LEFT
- *TitledBorder.CENTER
- *TitledBorder.RIGHT
- *TitledBorder.LEADING
- *TitledBorder.TRAILING
- *TitledBorder.DEFAULT_JUSTIFICATION (leading)
+ *
- *
- * @return the TitledBorder.ABOVE_TOP
- *TitledBorder.TOP (sitting on the top line)
- *TitledBorder.BELOW_TOP
- *TitledBorder.ABOVE_BOTTOM
- *TitledBorder.BOTTOM (sitting on the bottom line)
- *TitledBorder.BELOW_BOTTOM
- *TitledBorder.DEFAULT_POSITION (the title position
+ *TitledBorder object
+ * @return the {@code TitledBorder} object
*/
public static TitledBorder createTitledBorder(Border border,
String title,
@@ -458,28 +458,28 @@
* positioning and font, and using the default text color
* (determined by the current look and feel).
*
- * @param border the Border object to add the title to
- * @param title a String containing the text of the title
+ * @param border the {@code Border} object to add the title to
+ * @param title a {@code String} containing the text of the title
* @param titleJustification an integer specifying the justification
* of the title -- one of the following:
*
- *
* @param titlePosition an integer specifying the vertical position of
* the text in relation to the border -- one of the following:
*TitledBorder.LEFT
- *TitledBorder.CENTER
- *TitledBorder.RIGHT
- *TitledBorder.LEADING
- *TitledBorder.TRAILING
- *TitledBorder.DEFAULT_JUSTIFICATION (leading)
+ *
- *
* @param titleFont a Font object specifying the title font
@@ -498,33 +498,33 @@
* Adds a title to an existing border, with the specified
* positioning, font and color.
*
- * @param border the TitledBorder.ABOVE_TOP
- *TitledBorder.TOP (sitting on the top line)
- *TitledBorder.BELOW_TOP
- *TitledBorder.ABOVE_BOTTOM
- *TitledBorder.BOTTOM (sitting on the bottom line)
- *TitledBorder.BELOW_BOTTOM
- *TitledBorder.DEFAULT_POSITION (the title position
+ *Border object to add the title to
- * @param title a String containing the text of the title
+ * @param border the {@code Border} object to add the title to
+ * @param title a {@code String} containing the text of the title
* @param titleJustification an integer specifying the justification
* of the title -- one of the following:
*
- *
* @param titlePosition an integer specifying the vertical position of
* the text in relation to the border -- one of the following:
*TitledBorder.LEFT
- *TitledBorder.CENTER
- *TitledBorder.RIGHT
- *TitledBorder.LEADING
- *TitledBorder.TRAILING
- *TitledBorder.DEFAULT_JUSTIFICATION (leading)
+ *
- *
- * @param titleFont a TitledBorder.ABOVE_TOP
- *TitledBorder.TOP (sitting on the top line)
- *TitledBorder.BELOW_TOP
- *TitledBorder.ABOVE_BOTTOM
- *TitledBorder.BOTTOM (sitting on the bottom line)
- *TitledBorder.BELOW_BOTTOM
- *TitledBorder.DEFAULT_POSITION (the title position
+ *Font object specifying the title font
- * @param titleColor a Color object specifying the title color
- * @return the TitledBorder object
+ * @param titleFont a {@code Font} object specifying the title font
+ * @param titleColor a {@code Color} object specifying the title color
+ * @return the {@code TitledBorder} object
*/
public static TitledBorder createTitledBorder(Border border,
String title,
@@ -542,7 +542,7 @@
* Creates an empty border that takes up no space. (The width
* of the top, bottom, left, and right sides are all zero.)
*
- * @return the Border object
+ * @return the {@code Border} object
*/
public static Border createEmptyBorder() {
return emptyBorder;
@@ -561,7 +561,7 @@
* in pixels
* @param right an integer specifying the width of the right side,
* in pixels
- * @return the Border object
+ * @return the {@code Border} object
*/
public static Border createEmptyBorder(int top, int left,
int bottom, int right) {
@@ -570,10 +570,10 @@
//// CompoundBorder ////////////////////////////////////////////////////////
/**
- * Creates a compound border with a null inside edge and a
- * null outside edge.
+ * Creates a compound border with a {@code null} inside edge and a
+ * {@code null} outside edge.
*
- * @return the CompoundBorder object
+ * @return the {@code CompoundBorder} object
*/
public static CompoundBorder createCompoundBorder() {
return new CompoundBorder();
@@ -583,11 +583,11 @@
* Creates a compound border specifying the border objects to use
* for the outside and inside edges.
*
- * @param outsideBorder a Border object for the outer
+ * @param outsideBorder a {@code Border} object for the outer
* edge of the compound border
- * @param insideBorder a Border object for the inner
+ * @param insideBorder a {@code Border} object for the inner
* edge of the compound border
- * @return the CompoundBorder object
+ * @return the {@code CompoundBorder} object
*/
public static CompoundBorder createCompoundBorder(Border outsideBorder,
Border insideBorder) {
@@ -608,8 +608,8 @@
* in pixels
* @param right an integer specifying the width of the bottom,
* in pixels
- * @param color a Color to use for the border
- * @return the MatteBorder object
+ * @param color a {@code Color} to use for the border
+ * @return the {@code MatteBorder} object
*/
public static MatteBorder createMatteBorder(int top, int left, int bottom, int right,
Color color) {
@@ -632,8 +632,8 @@
* in pixels
* @param right an integer specifying the width of the bottom,
* in pixels
- * @param tileIcon the Icon object used for the border tiles
- * @return the MatteBorder object
+ * @param tileIcon the {@code Icon} object used for the border tiles
+ * @return the {@code MatteBorder} object
*/
public static MatteBorder createMatteBorder(int top, int left, int bottom, int right,
Icon tileIcon) {
--- old/src/java.desktop/share/classes/javax/swing/BoundedRangeModel.java 2015-10-04 22:56:28.261264064 +0400
+++ new/src/java.desktop/share/classes/javax/swing/BoundedRangeModel.java 2015-10-04 22:56:28.069264072 +0400
@@ -29,23 +29,23 @@
/**
- * Defines the data model used by components like Sliders
- * and ProgressBars.
+ * Defines the data model used by components like {@code Slider}s
+ * and {@code ProgressBar}s.
* Defines four interrelated integer properties: minimum, maximum, extent
* and value. These four integers define two nested ranges like this:
*
* minimum <= value <= value+extent <= maximum
*
- * The outer range is minimum,maximum and the inner
- * range is value,value+extent. The inner range
- * must lie within the outer one, i.e. value must be
- * less than or equal to maximum and value+extent
- * must greater than or equal to minimum, and maximum
- * must be greater than or equal to minimum.
+ * The outer range is {@code minimum,maximum} and the inner
+ * range is {@code value,value+extent}. The inner range
+ * must lie within the outer one, i.e. {@code value} must be
+ * less than or equal to {@code maximum} and {@code value+extent}
+ * must greater than or equal to {@code minimum}, and {@code maximum}
+ * must be greater than or equal to {@code minimum}.
* There are a few features of this model that one might find a little
* surprising. These quirks exist for the convenience of the
- * Swing BoundedRangeModel clients, such as Slider and
- * ScrollBar.
+ * Swing BoundedRangeModel clients, such as {@code Slider} and
+ * {@code ScrollBar}.
*
*
- * @param create if true, create the value == maximum, setExtent(10)
+ * For example if {@code value == maximum}, {@code setExtent(10)}
* would change the extent (back) to zero.
*
* maximum - extent
- * and the lower limit is minimum.
+ * limit on the model's value is {@code maximum - extent}
+ * and the lower limit is {@code minimum}.
*
* @return the model's value
* @see #setValue
@@ -145,16 +145,16 @@
/**
- * Sets the model's current value to newValue if newValue
+ * Sets the model's current value to {@code newValue} if {@code newValue}
* satisfies the model's constraints. Those constraints are:
*
* minimum <= value <= value+extent <= maximum
*
- * Otherwise, if newValue is less than minimum
- * it's set to minimum, if its greater than
- * maximum then it's set to maximum, and
- * if it's greater than value+extent then it's set to
- * value+extent.
+ * Otherwise, if {@code newValue} is less than {@code minimum}
+ * it's set to {@code minimum}, if its greater than
+ * {@code maximum} then it's set to {@code maximum}, and
+ * if it's greater than {@code value+extent} then it's set to
+ * {@code value+extent}.
* Box class can create several kinds
+ * The {@code Box} class can create several kinds
* of invisible components
* that affect layout:
* glue, struts, and rigid areas.
- * If all the components your Box contains
+ * If all the components your {@code Box} contains
* have a fixed size,
* you might want to use a glue component
- * (returned by createGlue)
+ * (returned by {@code createGlue})
* to control the components' positions.
* If you need a fixed amount of space between two components,
* try using a strut
- * (createHorizontalStrut or createVerticalStrut).
+ * ({@code createHorizontalStrut} or {@code createVerticalStrut}).
* If you need an invisible component
* that always takes up the same amount of space,
- * get it by invoking createRigidArea.
+ * get it by invoking {@code createRigidArea}.
* BoxLayout you
+ * If you are implementing a {@code BoxLayout} you
* can find further information and examples in
* How to Use BoxLayout,
@@ -69,7 +69,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see BoxLayout
@@ -81,14 +81,14 @@
public class Box extends JComponent implements Accessible {
/**
- * Creates a Box that displays its components
+ * Creates a {@code Box} that displays its components
* along the specified axis.
*
* @param axis can be {@link BoxLayout#X_AXIS},
* {@link BoxLayout#Y_AXIS},
* {@link BoxLayout#LINE_AXIS} or
* {@link BoxLayout#PAGE_AXIS}.
- * @throws AWTError if the axis is invalid
+ * @throws AWTError if the {@code axis} is invalid
* @see #createHorizontalBox
* @see #createVerticalBox
*/
@@ -98,11 +98,11 @@
}
/**
- * Creates a Box that displays its components
- * from left to right. If you want a Box that
+ * Creates a {@code Box} that displays its components
+ * from left to right. If you want a {@code Box} that
* respects the component orientation you should create the
- * Box using the constructor and pass in
- * BoxLayout.LINE_AXIS, eg:
+ * {@code Box} using the constructor and pass in
+ * {@code BoxLayout.LINE_AXIS}, eg:
*
* Box lineBox = new Box(BoxLayout.LINE_AXIS);
*
@@ -114,11 +114,11 @@
}
/**
- * Creates a Box that displays its components
- * from top to bottom. If you want a Box that
+ * Creates a {@code Box} that displays its components
+ * from top to bottom. If you want a {@code Box} that
* respects the component orientation you should create the
- * Box using the constructor and pass in
- * BoxLayout.PAGE_AXIS, eg:
+ * {@code Box} using the constructor and pass in
+ * {@code BoxLayout.PAGE_AXIS}, eg:
*
* Box lineBox = new Box(BoxLayout.PAGE_AXIS);
*
@@ -224,7 +224,7 @@
* Box.createGlue
+ * call {@code Box.createGlue}
* and add the returned component to a container.
* The glue component has no minimum or preferred size,
* so it takes no space unless excess space is available.
@@ -270,13 +270,13 @@
}
/**
- * Paints this Box. If this Box has a UI this
+ * Paints this {@code Box}. If this {@code Box} has a UI this
* method invokes super's implementation, otherwise if this
- * Box is opaque the Graphics is filled
+ * {@code Box} is opaque the {@code Graphics} is filled
* using the background.
*
- * @param g the Graphics to paint to
- * @throws NullPointerException if g is null
+ * @param g the {@code Graphics} to paint to
+ * @throws NullPointerException if {@code g} is null
* @since 1.6
*/
protected void paintComponent(Graphics g) {
@@ -300,7 +300,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial")
@@ -339,14 +339,14 @@
// ---- Component methods ------------------------------------------
/**
- * Paints this Filler. If this
- * Filler has a UI this method invokes super's
- * implementation, otherwise if this Filler is
- * opaque the Graphics is filled using the
+ * Paints this {@code Filler}. If this
+ * {@code Filler} has a UI this method invokes super's
+ * implementation, otherwise if this {@code Filler} is
+ * opaque the {@code Graphics} is filled using the
* background.
*
- * @param g the Graphics to paint to
- * @throws NullPointerException if g is null
+ * @param g the {@code Graphics} to paint to
+ * @throws NullPointerException if {@code g} is null
* @since 1.6
*/
protected void paintComponent(Graphics g) {
@@ -381,7 +381,7 @@
/**
* This class implements accessibility support for the
- * Box.Filler class.
+ * {@code Box.Filler} class.
*/
@SuppressWarnings("serial")
protected class AccessibleBoxFiller extends AccessibleAWTComponent {
@@ -422,7 +422,7 @@
/**
* This class implements accessibility support for the
- * Box class.
+ * {@code Box} class.
*/
@SuppressWarnings("serial")
protected class AccessibleBox extends AccessibleAWTContainer {
--- old/src/java.desktop/share/classes/javax/swing/BufferStrategyPaintManager.java 2015-10-04 22:56:29.313264017 +0400
+++ new/src/java.desktop/share/classes/javax/swing/BufferStrategyPaintManager.java 2015-10-04 22:56:29.125264025 +0400
@@ -80,7 +80,7 @@
private ArrayListbeginPaint has been invoked. This is
+ * Indicates {@code beginPaint} has been invoked. This is
* set to true for the life of beginPaint/endPaint pair.
*/
private boolean painting;
@@ -686,9 +686,9 @@
/**
* Returns the BufferStartegy. This will return null if
- * the BufferStartegy hasn't been created and create is
+ * the BufferStartegy hasn't been created and {@code create} is
* false, or if there is a problem in creating the
- * BufferStartegy.
+ * {@code BufferStartegy}.
*
* @param create If true, and the BufferStartegy is currently null,
* one will be created.
--- old/src/java.desktop/share/classes/javax/swing/ButtonGroup.java 2015-10-04 22:56:29.845263993 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ButtonGroup.java 2015-10-04 22:56:29.653264001 +0400
@@ -32,20 +32,20 @@
/**
* This class is used to create a multiple-exclusion scope for
* a set of buttons. Creating a set of buttons with the
- * same ButtonGroup object means that
+ * same {@code ButtonGroup} object means that
* turning "on" one of those buttons
* turns off all other buttons in the group.
* ButtonGroup can be used with
- * any set of objects that inherit from AbstractButton.
+ * A {@code ButtonGroup} can be used with
+ * any set of objects that inherit from {@code AbstractButton}.
* Typically a button group contains instances of
- * JRadioButton,
- * JRadioButtonMenuItem,
- * or JToggleButton.
+ * {@code JRadioButton},
+ * {@code JRadioButtonMenuItem},
+ * or {@code JToggleButton}.
* It wouldn't make sense to put an instance of
- * JButton or JMenuItem
+ * {@code JButton} or {@code JMenuItem}
* in a button group
- * because JButton and JMenuItem
+ * because {@code JButton} and {@code JMenuItem}
* don't implement the selected state.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Jeff Dinkins
@@ -80,7 +80,7 @@
ButtonModel selection = null;
/**
- * Creates a new ButtonGroup.
+ * Creates a new {@code ButtonGroup}.
*/
public ButtonGroup() {}
@@ -122,7 +122,7 @@
/**
* Clears the selection such that none of the buttons
- * in the ButtonGroup are selected.
+ * in the {@code ButtonGroup} are selected.
*
* @since 1.6
*/
@@ -137,7 +137,7 @@
/**
* Returns all the buttons that are participating in
* this group.
- * @return an Enumeration of the buttons in this group
+ * @return an {@code Enumeration} of the buttons in this group
*/
public EnumerationButtonModel.
+ * Sets the selected value for the {@code ButtonModel}.
* Only one button in the group may be selected at a time.
- * @param m the ButtonModel
- * @param b true if this button is to be
- * selected, otherwise false
+ * @param m the {@code ButtonModel}
+ * @param b {@code true} if this button is to be
+ * selected, otherwise {@code false}
*/
public void setSelected(ButtonModel m, boolean b) {
if (b && m != null && m != selection) {
--- old/src/java.desktop/share/classes/javax/swing/ButtonModel.java 2015-10-04 22:56:30.369263969 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ButtonModel.java 2015-10-04 22:56:30.181263978 +0400
@@ -38,7 +38,7 @@
* model to manage the state, as detailed below:
* ActionEvent
+ * button triggers the button and causes and {@code ActionEvent}
* to be fired. The same behavior can be produced via a keyboard key
* defined by the look and feel of the button (typically the SPACE BAR).
* Pressing and releasing this key while the button has
@@ -56,7 +56,7 @@
* armed while the mouse remains pressed within the bounds of
* the button (it can move in or out of the button, but the model
* is only armed during the portion of time spent within the button).
- * A button is triggered, and an ActionEvent is fired,
+ * A button is triggered, and an {@code ActionEvent} is fired,
* when the mouse is released while the model is armed
* - meaning when it is released over top of the button after the mouse
* has previously been pressed on that button (and not already released).
@@ -69,7 +69,7 @@
* has focus makes the model both armed and pressed. As long as this key
* remains down, the model remains in this state. Releasing the key sets
* the model to unarmed and unpressed, triggers the button, and causes an
- * ActionEvent to be fired.
+ * {@code ActionEvent} to be fired.
*
* @author Jeff Dinkins
* @since 1.2
@@ -80,7 +80,7 @@
* Indicates partial commitment towards triggering the
* button.
*
- * @return true if the button is armed,
+ * @return {@code true} if the button is armed,
* and ready to be triggered
* @see #setArmed
*/
@@ -90,7 +90,7 @@
* Indicates if the button has been selected. Only needed for
* certain types of buttons - such as radio buttons and check boxes.
*
- * @return true if the button is selected
+ * @return {@code true} if the button is selected
*/
boolean isSelected();
@@ -98,21 +98,21 @@
* Indicates if the button can be selected or triggered by
* an input device, such as a mouse pointer.
*
- * @return true if the button is enabled
+ * @return {@code true} if the button is enabled
*/
boolean isEnabled();
/**
* Indicates if the button is pressed.
*
- * @return true if the button is pressed
+ * @return {@code true} if the button is pressed
*/
boolean isPressed();
/**
* Indicates that the mouse is over the button.
*
- * @return true if the mouse is over the button
+ * @return {@code true} if the mouse is over the button
*/
boolean isRollover();
@@ -126,8 +126,8 @@
/**
* Selects or deselects the button.
*
- * @param b true selects the button,
- * false deselects the button
+ * @param b {@code true} selects the button,
+ * {@code false} deselects the button
*/
public void setSelected(boolean b);
@@ -173,9 +173,9 @@
/**
* Sets the action command string that gets sent as part of the
- * ActionEvent when the button is triggered.
+ * {@code ActionEvent} when the button is triggered.
*
- * @param s the String that identifies the generated event
+ * @param s the {@code String} that identifies the generated event
* @see #getActionCommand
* @see java.awt.event.ActionEvent#getActionCommand
*/
@@ -184,7 +184,7 @@
/**
* Returns the action command string for the button.
*
- * @return the String that identifies the generated event
+ * @return the {@code String} that identifies the generated event
* @see #setActionCommand
*/
public String getActionCommand();
@@ -194,47 +194,47 @@
* needed for radio buttons, which are mutually
* exclusive within their group.
*
- * @param group the ButtonGroup the button belongs to
+ * @param group the {@code ButtonGroup} the button belongs to
*/
public void setGroup(ButtonGroup group);
/**
- * Adds an ActionListener to the model.
+ * Adds an {@code ActionListener} to the model.
*
* @param l the listener to add
*/
void addActionListener(ActionListener l);
/**
- * Removes an ActionListener from the model.
+ * Removes an {@code ActionListener} from the model.
*
* @param l the listener to remove
*/
void removeActionListener(ActionListener l);
/**
- * Adds an ItemListener to the model.
+ * Adds an {@code ItemListener} to the model.
*
* @param l the listener to add
*/
void addItemListener(ItemListener l);
/**
- * Removes an ItemListener from the model.
+ * Removes an {@code ItemListener} from the model.
*
* @param l the listener to remove
*/
void removeItemListener(ItemListener l);
/**
- * Adds a ChangeListener to the model.
+ * Adds a {@code ChangeListener} to the model.
*
* @param l the listener to add
*/
void addChangeListener(ChangeListener l);
/**
- * Removes a ChangeListener from the model.
+ * Removes a {@code ChangeListener} from the model.
*
* @param l the listener to remove
*/
--- old/src/java.desktop/share/classes/javax/swing/CellEditor.java 2015-10-04 22:56:30.897263945 +0400
+++ new/src/java.desktop/share/classes/javax/swing/CellEditor.java 2015-10-04 22:56:30.705263954 +0400
@@ -33,26 +33,26 @@
* to implement. JTree and
- * JTable to allow any generic editor to
+ * editor) such as {@code JTree} and
+ * {@code JTable} to allow any generic editor to
* edit values in a table cell, or tree cell, etc. Without this generic
- * editor interface, JTable would have to know about specific editors,
- * such as JTextField, JCheckBox, JComboBox,
+ * editor interface, {@code JTable} would have to know about specific editors,
+ * such as {@code JTextField}, {@code JCheckBox}, {@code JComboBox},
* etc. In addition, without this interface, clients of editors such as
- * JTable would not be able
+ * {@code JTable} would not be able
* to work with any editors developed in the future by the user
* or a 3rd party ISV. CellEditor interface (See
- * DefaultCellEditor for example). The wrapper approach
+ * implements the {@code CellEditor} interface (See
+ * {@code DefaultCellEditor} for example). The wrapper approach
* is particularly useful if the user want to use a 3rd party ISV
- * editor with JTable, but the ISV didn't implement the
- * CellEditor interface. The user can simply create an object
+ * editor with {@code JTable}, but the ISV didn't implement the
+ * {@code CellEditor} interface. The user can simply create an object
* that contains an instance of the 3rd party editor object and "translate"
- * the CellEditor API into the 3rd party editor's API.
+ * the {@code CellEditor} API into the 3rd party editor's API.
*
* @see javax.swing.event.CellEditorListener
*
@@ -68,10 +68,10 @@
public Object getCellEditorValue();
/**
- * Asks the editor if it can start editing using anEvent.
- * anEvent is in the invoking component coordinate system.
+ * Asks the editor if it can start editing using {@code anEvent}.
+ * {@code anEvent} is in the invoking component coordinate system.
* The editor can not assume the Component returned by
- * getCellEditorComponent is installed. This method
+ * {@code getCellEditorComponent} is installed. This method
* is intended for the use of client to avoid the cost of setting up
* and installing the editor component if editing is not possible.
* If editing can be started this method returns true.
--- old/src/java.desktop/share/classes/javax/swing/CellRendererPane.java 2015-10-04 22:56:31.417263922 +0400
+++ new/src/java.desktop/share/classes/javax/swing/CellRendererPane.java 2015-10-04 22:56:31.229263931 +0400
@@ -58,7 +58,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Hans Muller
@@ -241,7 +241,7 @@
/**
* This class implements accessibility support for the
- * CellRendererPane class.
+ * {@code CellRendererPane} class.
*/
protected class AccessibleCellRendererPane extends AccessibleAWTContainer {
// AccessibleContext methods
--- old/src/java.desktop/share/classes/javax/swing/ComboBoxModel.java 2015-10-04 22:56:31.945263898 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ComboBoxModel.java 2015-10-04 22:56:31.753263907 +0400
@@ -25,12 +25,12 @@
package javax.swing;
/**
- * A data model for a combo box. This interface extends ListDataModel
+ * A data model for a combo box. This interface extends {@code ListDataModel}
* and adds the concept of a selected item. The selected item is generally
* the item which is visible in the combo box display area.
* ListModel. This disjoint behavior allows for the temporary
+ * {@code ListModel}. This disjoint behavior allows for the temporary
* storage and retrieval of a selected item in the model.
*
* @param ListDataListeners that the contents
+ * all registered {@code ListDataListener}s that the contents
* have changed.
*
- * @param anItem the list object to select or null
+ * @param anItem the list object to select or {@code null}
* to clear the selection
*/
void setSelectedItem(Object anItem);
/**
* Returns the selected item
- * @return The selected item or null if there is no selection
+ * @return The selected item or {@code null} if there is no selection
*/
Object getSelectedItem();
}
--- old/src/java.desktop/share/classes/javax/swing/ComponentInputMap.java 2015-10-04 22:56:32.465263875 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ComponentInputMap.java 2015-10-04 22:56:32.273263884 +0400
@@ -25,12 +25,12 @@
package javax.swing;
/**
- * A ComponentInputMap is an InputMap
- * associated with a particular JComponent.
+ * A {@code ComponentInputMap} is an {@code InputMap}
+ * associated with a particular {@code JComponent}.
* The component is automatically notified whenever
- * the ComponentInputMap changes.
- * ComponentInputMaps are used for
- * WHEN_IN_FOCUSED_WINDOW bindings.
+ * the {@code ComponentInputMap} changes.
+ * {@code ComponentInputMap}s are used for
+ * {@code WHEN_IN_FOCUSED_WINDOW} bindings.
*
* @author Scott Violet
* @since 1.3
@@ -41,11 +41,11 @@
private JComponent component;
/**
- * Creates a ComponentInputMap associated with the
+ * Creates a {@code ComponentInputMap} associated with the
* specified component.
*
- * @param component a non-null JComponent
- * @throws IllegalArgumentException if component is null
+ * @param component a non-null {@code JComponent}
+ * @throws IllegalArgumentException if {@code component} is null
*/
public ComponentInputMap(JComponent component) {
this.component = component;
@@ -55,14 +55,14 @@
}
/**
- * Sets the parent, which must be a ComponentInputMap
+ * Sets the parent, which must be a {@code ComponentInputMap}
* associated with the same component as this
- * ComponentInputMap.
+ * {@code ComponentInputMap}.
*
- * @param map a ComponentInputMap
+ * @param map a {@code ComponentInputMap}
*
- * @throws IllegalArgumentException if map
- * is not a ComponentInputMap
+ * @throws IllegalArgumentException if {@code map}
+ * is not a {@code ComponentInputMap}
* or is not associated with the same component
*/
public void setParent(InputMap map) {
@@ -87,9 +87,9 @@
}
/**
- * Adds a binding for keyStroke to actionMapKey.
- * If actionMapKey is null, this removes the current binding
- * for keyStroke.
+ * Adds a binding for {@code keyStroke} to {@code actionMapKey}.
+ * If {@code actionMapKey} is null, this removes the current binding
+ * for {@code keyStroke}.
*/
public void put(KeyStroke keyStroke, Object actionMapKey) {
super.put(keyStroke, actionMapKey);
@@ -99,7 +99,7 @@
}
/**
- * Removes the binding for key from this object.
+ * Removes the binding for {@code key} from this object.
*/
public void remove(KeyStroke key) {
super.remove(key);
--- old/src/java.desktop/share/classes/javax/swing/DebugGraphics.java 2015-10-04 22:56:32.985263852 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DebugGraphics.java 2015-10-04 22:56:32.797263860 +0400
@@ -60,7 +60,7 @@
public static final int LOG_OPTION = 1 << 0;
/** Flash graphics operations. */
public static final int FLASH_OPTION = 1 << 1;
- /** Show buffered operations in a separate Frame. */
+ /** Show buffered operations in a separate {@code Frame}. */
public static final int BUFFERED_OPTION = 1 << 2;
/** Don't debug graphics operations. */
public static final int NONE_OPTION = -1;
@@ -103,7 +103,7 @@
}
/**
- * Overrides Graphics.create to return a DebugGraphics object.
+ * Overrides {@code Graphics.create} to return a DebugGraphics object.
*/
public Graphics create() {
DebugGraphics debugGraphics;
@@ -117,7 +117,7 @@
}
/**
- * Overrides Graphics.create to return a DebugGraphics object.
+ * Overrides {@code Graphics.create} to return a DebugGraphics object.
*/
public Graphics create(int x, int y, int width, int height) {
DebugGraphics debugGraphics;
@@ -251,21 +251,21 @@
//------------------------------------------------
/**
- * Overrides Graphics.getFontMetrics.
+ * Overrides {@code Graphics.getFontMetrics}.
*/
public FontMetrics getFontMetrics() {
return graphics.getFontMetrics();
}
/**
- * Overrides Graphics.getFontMetrics.
+ * Overrides {@code Graphics.getFontMetrics}.
*/
public FontMetrics getFontMetrics(Font f) {
return graphics.getFontMetrics(f);
}
/**
- * Overrides Graphics.translate.
+ * Overrides {@code Graphics.translate}.
*/
public void translate(int x, int y) {
if (debugLog()) {
@@ -278,7 +278,7 @@
}
/**
- * Overrides Graphics.setPaintMode.
+ * Overrides {@code Graphics.setPaintMode}.
*/
public void setPaintMode() {
if (debugLog()) {
@@ -288,7 +288,7 @@
}
/**
- * Overrides Graphics.setXORMode.
+ * Overrides {@code Graphics.setXORMode}.
*/
public void setXORMode(Color aColor) {
if (debugLog()) {
@@ -298,14 +298,14 @@
}
/**
- * Overrides Graphics.getClipBounds.
+ * Overrides {@code Graphics.getClipBounds}.
*/
public Rectangle getClipBounds() {
return graphics.getClipBounds();
}
/**
- * Overrides Graphics.clipRect.
+ * Overrides {@code Graphics.clipRect}.
*/
public void clipRect(int x, int y, int width, int height) {
graphics.clipRect(x, y, width, height);
@@ -317,7 +317,7 @@
}
/**
- * Overrides Graphics.setClip.
+ * Overrides {@code Graphics.setClip}.
*/
public void setClip(int x, int y, int width, int height) {
graphics.setClip(x, y, width, height);
@@ -328,14 +328,14 @@
}
/**
- * Overrides Graphics.getClip.
+ * Overrides {@code Graphics.getClip}.
*/
public Shape getClip() {
return graphics.getClip();
}
/**
- * Overrides Graphics.setClip.
+ * Overrides {@code Graphics.setClip}.
*/
public void setClip(Shape clip) {
graphics.setClip(clip);
@@ -346,7 +346,7 @@
}
/**
- * Overrides Graphics.drawRect.
+ * Overrides {@code Graphics.drawRect}.
*/
public void drawRect(int x, int y, int width, int height) {
DebugGraphicsInfo info = info();
@@ -380,7 +380,7 @@
}
/**
- * Overrides Graphics.fillRect.
+ * Overrides {@code Graphics.fillRect}.
*/
public void fillRect(int x, int y, int width, int height) {
DebugGraphicsInfo info = info();
@@ -414,7 +414,7 @@
}
/**
- * Overrides Graphics.clearRect.
+ * Overrides {@code Graphics.clearRect}.
*/
public void clearRect(int x, int y, int width, int height) {
DebugGraphicsInfo info = info();
@@ -448,7 +448,7 @@
}
/**
- * Overrides Graphics.drawRoundRect.
+ * Overrides {@code Graphics.drawRoundRect}.
*/
public void drawRoundRect(int x, int y, int width, int height,
int arcWidth, int arcHeight) {
@@ -486,7 +486,7 @@
}
/**
- * Overrides Graphics.fillRoundRect.
+ * Overrides {@code Graphics.fillRoundRect}.
*/
public void fillRoundRect(int x, int y, int width, int height,
int arcWidth, int arcHeight) {
@@ -524,7 +524,7 @@
}
/**
- * Overrides Graphics.drawLine.
+ * Overrides {@code Graphics.drawLine}.
*/
public void drawLine(int x1, int y1, int x2, int y2) {
DebugGraphicsInfo info = info();
@@ -558,7 +558,7 @@
}
/**
- * Overrides Graphics.draw3DRect.
+ * Overrides {@code Graphics.draw3DRect}.
*/
public void draw3DRect(int x, int y, int width, int height,
boolean raised) {
@@ -593,7 +593,7 @@
}
/**
- * Overrides Graphics.fill3DRect.
+ * Overrides {@code Graphics.fill3DRect}.
*/
public void fill3DRect(int x, int y, int width, int height,
boolean raised) {
@@ -628,7 +628,7 @@
}
/**
- * Overrides Graphics.drawOval.
+ * Overrides {@code Graphics.drawOval}.
*/
public void drawOval(int x, int y, int width, int height) {
DebugGraphicsInfo info = info();
@@ -661,7 +661,7 @@
}
/**
- * Overrides Graphics.fillOval.
+ * Overrides {@code Graphics.fillOval}.
*/
public void fillOval(int x, int y, int width, int height) {
DebugGraphicsInfo info = info();
@@ -694,7 +694,7 @@
}
/**
- * Overrides Graphics.drawArc.
+ * Overrides {@code Graphics.drawArc}.
*/
public void drawArc(int x, int y, int width, int height,
int startAngle, int arcAngle) {
@@ -731,7 +731,7 @@
}
/**
- * Overrides Graphics.fillArc.
+ * Overrides {@code Graphics.fillArc}.
*/
public void fillArc(int x, int y, int width, int height,
int startAngle, int arcAngle) {
@@ -768,7 +768,7 @@
}
/**
- * Overrides Graphics.drawPolyline.
+ * Overrides {@code Graphics.drawPolyline}.
*/
public void drawPolyline(int xPoints[], int yPoints[], int nPoints) {
DebugGraphicsInfo info = info();
@@ -803,7 +803,7 @@
}
/**
- * Overrides Graphics.drawPolygon.
+ * Overrides {@code Graphics.drawPolygon}.
*/
public void drawPolygon(int xPoints[], int yPoints[], int nPoints) {
DebugGraphicsInfo info = info();
@@ -838,7 +838,7 @@
}
/**
- * Overrides Graphics.fillPolygon.
+ * Overrides {@code Graphics.fillPolygon}.
*/
public void fillPolygon(int xPoints[], int yPoints[], int nPoints) {
DebugGraphicsInfo info = info();
@@ -873,7 +873,7 @@
}
/**
- * Overrides Graphics.drawString.
+ * Overrides {@code Graphics.drawString}.
*/
public void drawString(String aString, int x, int y) {
DebugGraphicsInfo info = info();
@@ -908,7 +908,7 @@
}
/**
- * Overrides Graphics.drawString.
+ * Overrides {@code Graphics.drawString}.
*/
public void drawString(AttributedCharacterIterator iterator, int x, int y) {
DebugGraphicsInfo info = info();
@@ -943,7 +943,7 @@
}
/**
- * Overrides Graphics.drawBytes.
+ * Overrides {@code Graphics.drawBytes}.
*/
public void drawBytes(byte data[], int offset, int length, int x, int y) {
DebugGraphicsInfo info = info();
@@ -979,7 +979,7 @@
}
/**
- * Overrides Graphics.drawChars.
+ * Overrides {@code Graphics.drawChars}.
*/
public void drawChars(char data[], int offset, int length, int x, int y) {
DebugGraphicsInfo info = info();
@@ -1015,7 +1015,7 @@
}
/**
- * Overrides Graphics.drawImage.
+ * Overrides {@code Graphics.drawImage}.
*/
public boolean drawImage(Image img, int x, int y,
ImageObserver observer) {
@@ -1059,7 +1059,7 @@
}
/**
- * Overrides Graphics.drawImage.
+ * Overrides {@code Graphics.drawImage}.
*/
public boolean drawImage(Image img, int x, int y, int width, int height,
ImageObserver observer) {
@@ -1103,7 +1103,7 @@
}
/**
- * Overrides Graphics.drawImage.
+ * Overrides {@code Graphics.drawImage}.
*/
public boolean drawImage(Image img, int x, int y,
Color bgcolor,
@@ -1149,7 +1149,7 @@
}
/**
- * Overrides Graphics.drawImage.
+ * Overrides {@code Graphics.drawImage}.
*/
public boolean drawImage(Image img, int x, int y,int width, int height,
Color bgcolor,
@@ -1196,7 +1196,7 @@
}
/**
- * Overrides Graphics.drawImage.
+ * Overrides {@code Graphics.drawImage}.
*/
public boolean drawImage(Image img,
int dx1, int dy1, int dx2, int dy2,
@@ -1246,7 +1246,7 @@
}
/**
- * Overrides Graphics.drawImage.
+ * Overrides {@code Graphics.drawImage}.
*/
public boolean drawImage(Image img,
int dx1, int dy1, int dx2, int dy2,
@@ -1303,7 +1303,7 @@
/**
- * Overrides Graphics.copyArea.
+ * Overrides {@code Graphics.copyArea}.
*/
public void copyArea(int x, int y, int width, int height,
int destX, int destY) {
@@ -1324,7 +1324,7 @@
}
/**
- * Overrides Graphics.dispose.
+ * Overrides {@code Graphics.dispose}.
*/
public void dispose() {
graphics.dispose();
--- old/src/java.desktop/share/classes/javax/swing/DefaultBoundedRangeModel.java 2015-10-04 22:56:33.533263827 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultBoundedRangeModel.java 2015-10-04 22:56:33.341263836 +0400
@@ -38,7 +38,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author David Kloba
@@ -50,7 +50,7 @@
public class DefaultBoundedRangeModel implements BoundedRangeModel, Serializable
{
/**
- * Only one ChangeEvent is needed per model instance since the
+ * Only one {@code ChangeEvent} is needed per model instance since the
* event's only (read-only) state is the source property. The source
* of events generated here is always "this".
*/
@@ -70,11 +70,11 @@
* Initializes all of the properties with default values.
* Those values are:
*
- *
*/
public DefaultBoundedRangeModel() {
@@ -83,7 +83,7 @@
/**
* Initializes value, extent, minimum and maximum. Adjusting is false.
- * Throws an value = 0
- * extent = 0
- * minimum = 0
- * maximum = 100
- * adjusting = false
+ * IllegalArgumentException if the following
+ * Throws an {@code IllegalArgumentException} if the following
* constraints aren't satisfied:
*
* min <= value <= value+extent <= max
@@ -228,7 +228,7 @@
/**
- * Sets the
*
- * And the child will be added to the valueIsAdjusting property.
+ * Sets the {@code valueIsAdjusting} property.
*
* @see #getValueIsAdjusting
* @see #setValue
@@ -243,7 +243,7 @@
* Returns true if the value is in the process of changing
* as a result of actions being taken by the user.
*
- * @return the value of the valueIsAdjusting property
+ * @return the value of the {@code valueIsAdjusting} property
* @see #setValue
* @see BoundedRangeModel#getValueIsAdjusting
*/
@@ -253,13 +253,13 @@
/**
- * Sets all of the BoundedRangeModel properties after forcing
+ * Sets all of the {@code BoundedRangeModel} properties after forcing
* the arguments to obey the usual constraints:
*
* minimum <= value <= value+extent <= maximum
*
* ChangeEvent is generated.
+ * At most, one {@code ChangeEvent} is generated.
*
* @see BoundedRangeModel#setRangeProperties
* @see #setValue
@@ -312,7 +312,7 @@
/**
- * Adds a ChangeListener. The change listeners are run each
+ * Adds a {@code ChangeListener}. The change listeners are run each
* time any one of the Bounded Range model properties changes.
*
* @param l the ChangeListener to add
@@ -325,9 +325,9 @@
/**
- * Removes a ChangeListener.
+ * Removes a {@code ChangeListener}.
*
- * @param l the ChangeListener to remove
+ * @param l the {@code ChangeListener} to remove
* @see #addChangeListener
* @see BoundedRangeModel#removeChangeListener
*/
@@ -338,9 +338,9 @@
/**
* Returns an array of all the change listeners
- * registered on this DefaultBoundedRangeModel.
+ * registered on this {@code DefaultBoundedRangeModel}.
*
- * @return all of this model's ChangeListeners
+ * @return all of this model's {@code ChangeListener}s
* or an empty
* array if no change listeners are currently registered
*
@@ -355,7 +355,7 @@
/**
- * Runs each ChangeListener's stateChanged method.
+ * Runs each {@code ChangeListener}'s {@code stateChanged} method.
*
* @see #setRangeProperties
* @see EventListenerList
@@ -376,7 +376,7 @@
/**
* Returns a string that displays all of the
- * BoundedRangeModel properties.
+ * {@code BoundedRangeModel} properties.
*/
public String toString() {
String modelString =
@@ -396,10 +396,10 @@
* FooListeners
* are registered using the addFooListener method.
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as FooListener.class.
- * For example, you can query a DefaultBoundedRangeModel
- * instance m
+ * For example, you can query a {@code DefaultBoundedRangeModel}
+ * instance {@code m}
* for its change listeners
* with the following code:
*
@@ -411,15 +411,15 @@
* @param java.util.EventListener
+ * that descends from {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners
* on this model,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType doesn't
+ * @exception ClassCastException if {@code listenerType} doesn't
* specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getChangeListeners
*
--- old/src/java.desktop/share/classes/javax/swing/DefaultButtonModel.java 2015-10-04 22:56:34.073263803 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultButtonModel.java 2015-10-04 22:56:33.873263812 +0400
@@ -32,7 +32,7 @@
import javax.swing.event.*;
/**
- * The default implementation of a Button component's data model.
+ * The default implementation of a {@code Button} component's data model.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Jeff Dinkins
@@ -62,7 +62,7 @@
protected int mnemonic = 0;
/**
- * Only one ChangeEvent is needed per button model
+ * Only one {@code ChangeEvent} is needed per button model
* instance since the event's only state is the source property.
* The source of events generated is always "this".
*/
@@ -76,7 +76,7 @@
private boolean menuItem = false;
/**
- * Constructs a DefaultButtonModel.
+ * Constructs a {@code DefaultButtonModel}.
*
*/
public DefaultButtonModel() {
@@ -316,9 +316,9 @@
/**
* Returns an array of all the change listeners
- * registered on this DefaultButtonModel.
+ * registered on this {@code DefaultButtonModel}.
*
- * @return all of this model's ChangeListeners
+ * @return all of this model's {@code ChangeListener}s
* or an empty
* array if no change listeners are currently registered
*
@@ -369,9 +369,9 @@
/**
* Returns an array of all the action listeners
- * registered on this DefaultButtonModel.
+ * registered on this {@code DefaultButtonModel}.
*
- * @return all of this model's ActionListeners
+ * @return all of this model's {@code ActionListener}s
* or an empty
* array if no action listeners are currently registered
*
@@ -388,7 +388,7 @@
* Notifies all listeners that have registered interest for
* notification on this event type.
*
- * @param e the ActionEvent to deliver to listeners
+ * @param e the {@code ActionEvent} to deliver to listeners
* @see EventListenerList
*/
protected void fireActionPerformed(ActionEvent e) {
@@ -422,9 +422,9 @@
/**
* Returns an array of all the item listeners
- * registered on this DefaultButtonModel.
+ * registered on this {@code DefaultButtonModel}.
*
- * @return all of this model's ItemListeners
+ * @return all of this model's {@code ItemListener}s
* or an empty
* array if no item listeners are currently registered
*
@@ -441,7 +441,7 @@
* Notifies all listeners that have registered interest for
* notification on this event type.
*
- * @param e the ItemEvent to deliver to listeners
+ * @param e the {@code ItemEvent} to deliver to listeners
* @see EventListenerList
*/
protected void fireItemStateChanged(ItemEvent e) {
@@ -466,10 +466,10 @@
* FooListeners
* are registered using the addFooListener method.
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as FooListener.class.
- * For example, you can query a DefaultButtonModel
- * instance m
+ * For example, you can query a {@code DefaultButtonModel}
+ * instance {@code m}
* for its action listeners
* with the following code:
*
@@ -481,15 +481,15 @@
* @param java.util.EventListener
+ * that descends from {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners
* on this model,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType doesn't
+ * @exception ClassCastException if {@code listenerType} doesn't
* specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getActionListeners
* @see #getChangeListeners
@@ -501,7 +501,7 @@
return listenerList.getListeners(listenerType);
}
- /** Overridden to return null. */
+ /** Overridden to return {@code null}. */
public Object[] getSelectedObjects() {
return null;
}
@@ -518,7 +518,7 @@
* Normally used with radio buttons, which are mutually
* exclusive within their group.
*
- * @return the ButtonGroup that the button belongs to
+ * @return the {@code ButtonGroup} that the button belongs to
*
* @since 1.3
*/
--- old/src/java.desktop/share/classes/javax/swing/DefaultCellEditor.java 2015-10-04 22:56:34.601263779 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultCellEditor.java 2015-10-04 22:56:34.413263788 +0400
@@ -44,7 +44,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Alan Chung
@@ -63,12 +63,12 @@
protected JComponent editorComponent;
/**
* The delegate class which handles all methods sent from the
- * CellEditor.
+ * {@code CellEditor}.
*/
protected EditorDelegate delegate;
/**
* An integer specifying the number of clicks needed to start editing.
- * Even if clickCountToStart is defined as zero, it
+ * Even if {@code clickCountToStart} is defined as zero, it
* will not initiate until a click occurs.
*/
protected int clickCountToStart = 1;
@@ -78,9 +78,9 @@
//
/**
- * Constructs a DefaultCellEditor that uses a text field.
+ * Constructs a {@code DefaultCellEditor} that uses a text field.
*
- * @param textField a JTextField object
+ * @param textField a {@code JTextField} object
*/
@ConstructorProperties({"component"})
public DefaultCellEditor(final JTextField textField) {
@@ -99,9 +99,9 @@
}
/**
- * Constructs a DefaultCellEditor object that uses a check box.
+ * Constructs a {@code DefaultCellEditor} object that uses a check box.
*
- * @param checkBox a JCheckBox object
+ * @param checkBox a {@code JCheckBox} object
*/
public DefaultCellEditor(final JCheckBox checkBox) {
editorComponent = checkBox;
@@ -126,10 +126,10 @@
}
/**
- * Constructs a DefaultCellEditor object that uses a
+ * Constructs a {@code DefaultCellEditor} object that uses a
* combo box.
*
- * @param comboBox a JComboBox object
+ * @param comboBox a {@code JComboBox} object
*/
public DefaultCellEditor(final JComboBox comboBox) {
editorComponent = comboBox;
@@ -165,7 +165,7 @@
/**
* Returns a reference to the editor component.
*
- * @return the editor Component
+ * @return the editor {@code Component}
*/
public Component getComponent() {
return editorComponent;
@@ -199,8 +199,8 @@
//
/**
- * Forwards the message from the CellEditor to
- * the delegate.
+ * Forwards the message from the {@code CellEditor} to
+ * the {@code delegate}.
* @see EditorDelegate#getCellEditorValue
*/
public Object getCellEditorValue() {
@@ -208,8 +208,8 @@
}
/**
- * Forwards the message from the CellEditor to
- * the delegate.
+ * Forwards the message from the {@code CellEditor} to
+ * the {@code delegate}.
* @see EditorDelegate#isCellEditable(EventObject)
*/
public boolean isCellEditable(EventObject anEvent) {
@@ -217,8 +217,8 @@
}
/**
- * Forwards the message from the CellEditor to
- * the delegate.
+ * Forwards the message from the {@code CellEditor} to
+ * the {@code delegate}.
* @see EditorDelegate#shouldSelectCell(EventObject)
*/
public boolean shouldSelectCell(EventObject anEvent) {
@@ -226,8 +226,8 @@
}
/**
- * Forwards the message from the CellEditor to
- * the delegate.
+ * Forwards the message from the {@code CellEditor} to
+ * the {@code delegate}.
* @see EditorDelegate#stopCellEditing
*/
public boolean stopCellEditing() {
@@ -235,8 +235,8 @@
}
/**
- * Forwards the message from the CellEditor to
- * the delegate.
+ * Forwards the message from the {@code CellEditor} to
+ * the {@code delegate}.
* @see EditorDelegate#cancelCellEditing
*/
public void cancelCellEditing() {
@@ -247,7 +247,7 @@
// Implementing the TreeCellEditor Interface
//
- /** Implements the TreeCellEditor interface. */
+ /** Implements the {@code TreeCellEditor} interface. */
public Component getTreeCellEditorComponent(JTree tree, Object value,
boolean isSelected,
boolean expanded,
@@ -262,7 +262,7 @@
//
// Implementing the CellEditor Interface
//
- /** Implements the TableCellEditor interface. */
+ /** Implements the {@code TableCellEditor} interface. */
public Component getTableCellEditorComponent(JTable table, Object value,
boolean isSelected,
int row, int column) {
@@ -296,7 +296,7 @@
//
/**
- * The protected EditorDelegate class.
+ * The protected {@code EditorDelegate} class.
*/
protected class EditorDelegate implements ActionListener, ItemListener, Serializable {
@@ -320,8 +320,8 @@
}
/**
- * Returns true if anEvent is not a
- * MouseEvent. Otherwise, it returns true
+ * Returns true if {@code anEvent} is not a
+ * {@code MouseEvent}. Otherwise, it returns true
* if the necessary number of clicks have occurred, and
* returns false otherwise.
*
@@ -362,7 +362,7 @@
/**
* Stops editing and
* returns true to indicate that editing has stopped.
- * This method calls fireEditingStopped.
+ * This method calls {@code fireEditingStopped}.
*
* @return true
*/
@@ -372,7 +372,7 @@
}
/**
- * Cancels editing. This method calls fireEditingCanceled.
+ * Cancels editing. This method calls {@code fireEditingCanceled}.
*/
public void cancelCellEditing() {
fireEditingCanceled();
--- old/src/java.desktop/share/classes/javax/swing/DefaultDesktopManager.java 2015-10-04 22:56:35.133263755 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultDesktopManager.java 2015-10-04 22:56:34.945263764 +0400
@@ -33,11 +33,11 @@
import java.awt.*;
import java.beans.PropertyVetoException;
-/** This is an implementation of the DesktopManager.
+/** This is an implementation of the {@code DesktopManager}.
* It currently implements the basic behaviors for managing
- * JInternalFrames in an arbitrary parent.
- * JInternalFrames that are not children of a
- * JDesktop will use this component
+ * {@code JInternalFrame}s in an arbitrary parent.
+ * {@code JInternalFrame}s that are not children of a
+ * {@code JDesktop} will use this component
* to handle their desktop-like actions.
* desktopIcon, from its parent.
- * @param f the JInternalFrame to be removed
+ * {@code desktopIcon}, from its parent.
+ * @param f the {@code JInternalFrame} to be removed
*/
public void closeFrame(JInternalFrame f) {
JDesktopPane d = f.getDesktopPane();
@@ -144,8 +144,8 @@
/**
* Restores the frame back to its size and position prior
- * to a maximizeFrame call.
- * @param f the JInternalFrame to be restored
+ * to a {@code maximizeFrame} call.
+ * @param f the {@code JInternalFrame} to be restored
*/
public void minimizeFrame(JInternalFrame f) {
// If the frame was an icon restore it back to an icon.
@@ -164,8 +164,8 @@
/**
* Removes the frame from its parent and adds its
- * desktopIcon to the parent.
- * @param f the JInternalFrame to be iconified
+ * {@code desktopIcon} to the parent.
+ * @param f the {@code JInternalFrame} to be iconified
*/
public void iconifyFrame(JInternalFrame f) {
JInternalFrame.JDesktopIcon desktopIcon;
@@ -213,7 +213,7 @@
/**
* Removes the desktopIcon from its parent and adds its frame
* to the parent.
- * @param f the JInternalFrame to be de-iconified
+ * @param f the {@code JInternalFrame} to be de-iconified
*/
public void deiconifyFrame(JInternalFrame f) {
JInternalFrame.JDesktopIcon desktopIcon = f.getDesktopIcon();
@@ -247,9 +247,9 @@
/** This will activate f moving it to the front. It will
* set the current active frame's (if any)
- * IS_SELECTED_PROPERTY to false.
+ * {@code IS_SELECTED_PROPERTY} to {@code false}.
* There can be only one active frame across all Layers.
- * @param f the JInternalFrame to be activated
+ * @param f the {@code JInternalFrame} to be activated
*/
public void activateFrame(JInternalFrame f) {
Container p = f.getParent();
@@ -348,7 +348,7 @@
* Moves the visible location of the frame being dragged
* to the location specified. The means by which this occurs can vary depending
* on the dragging algorithm being used. The actual logical location of the frame
- * might not change until endDraggingFrame is called.
+ * might not change until {@code endDraggingFrame} is called.
*/
public void dragFrame(JComponent f, int newX, int newY) {
@@ -410,7 +410,7 @@
}
/**
- * Calls setBoundsForFrame with the new values.
+ * Calls {@code setBoundsForFrame} with the new values.
* @param f the component to be resized
* @param newX the new x-coordinate
* @param newY the new y-coordinate
@@ -455,7 +455,7 @@
}
- /** This moves the JComponent and repaints the damaged areas. */
+ /** This moves the {@code JComponent} and repaints the damaged areas. */
public void setBoundsForFrame(JComponent f, int newX, int newY, int newWidth, int newHeight) {
f.setBounds(newX, newY, newWidth, newHeight);
// we must validate the hierarchy to not break the hw/lw mixing
@@ -590,7 +590,7 @@
/**
* Gets the normal bounds of the component prior to the component
* being maximized.
- * @param f the JInternalFrame of interest
+ * @param f the {@code JInternalFrame} of interest
* @return the normal bounds of the component
*/
protected Rectangle getPreviousBounds(JInternalFrame f) {
@@ -599,7 +599,7 @@
/**
* Sets that the component has been iconized and the bounds of the
- * desktopIcon are valid.
+ * {@code desktopIcon} are valid.
*
* @param f the {@code JInternalFrame} of interest
* @param value a {@code Boolean} signifying if component has been iconized
@@ -611,13 +611,13 @@
}
/**
- * Returns true if the component has been iconized
- * and the bounds of the desktopIcon are valid,
- * otherwise returns false.
+ * Returns {@code true} if the component has been iconized
+ * and the bounds of the {@code desktopIcon} are valid,
+ * otherwise returns {@code false}.
*
- * @param f the JInternalFrame of interest
- * @return true if the component has been iconized;
- * otherwise returns false
+ * @param f the {@code JInternalFrame} of interest
+ * @return {@code true} if the component has been iconized;
+ * otherwise returns {@code false}
*/
protected boolean wasIcon(JInternalFrame f) {
return (f.getClientProperty(HAS_BEEN_ICONIFIED_PROPERTY) == Boolean.TRUE);
--- old/src/java.desktop/share/classes/javax/swing/DefaultFocusManager.java 2015-10-04 22:56:35.665263731 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultFocusManager.java 2015-10-04 22:56:35.477263740 +0400
@@ -33,8 +33,8 @@
/**
* This class has been obsoleted by the 1.4 focus APIs. While client code may
* still use this class, developers are strongly encouraged to use
- * java.awt.KeyboardFocusManager and
- * java.awt.DefaultKeyboardFocusManager instead.
+ * {@code java.awt.KeyboardFocusManager} and
+ * {@code java.awt.DefaultKeyboardFocusManager} instead.
* invalidate,
- * validate,
- * revalidate,
- * repaint,
- * isOpaque,
+ * {@code invalidate},
+ * {@code validate},
+ * {@code revalidate},
+ * {@code repaint},
+ * {@code isOpaque},
* and
- * firePropertyChange
+ * {@code firePropertyChange}
* solely to improve performance.
* If not overridden, these frequently called methods would execute code paths
* that are unnecessary for the default list cell renderer.
@@ -64,7 +64,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Philip Milne
@@ -77,9 +77,9 @@
{
/**
- * An empty Border. This field might not be used. To change the
- * Border used by this renderer override the
- * getListCellRendererComponent method and set the border
+ * An empty {@code Border}. This field might not be used. To change the
+ * {@code Border} used by this renderer override the
+ * {@code getListCellRendererComponent} method and set the border
* of the returned component directly.
*/
private static final Border SAFE_NO_FOCUS_BORDER = new EmptyBorder(1, 1, 1, 1);
@@ -181,9 +181,9 @@
* for more information.
*
* @since 1.5
- * @return true if the background is completely opaque
+ * @return {@code true} if the background is completely opaque
* and differs from the JList's background;
- * false otherwise
+ * {@code false} otherwise
*/
@Override
public boolean isOpaque() {
@@ -343,7 +343,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
--- old/src/java.desktop/share/classes/javax/swing/DefaultListModel.java 2015-10-04 22:56:36.713263684 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultListModel.java 2015-10-04 22:56:36.525263693 +0400
@@ -32,11 +32,11 @@
/**
- * This class loosely implements the java.util.Vector
+ * This class loosely implements the {@code java.util.Vector}
* API, in that it implements the 1.1.x version of
- * java.util.Vector, has no collection class support,
- * and notifies the ListDataListeners when changes occur.
- * Presently it delegates to a Vector,
+ * {@code java.util.Vector}, has no collection class support,
+ * and notifies the {@code ListDataListener}s when changes occur.
+ * Presently it delegates to a {@code Vector},
* in a future release it will be a real Collection implementation.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @param size, which implements the
- * List interface defined in the 1.2 Collections framework.
- * This method exists in conjunction with setSize so that
- * size is identifiable as a JavaBean property.
+ * This method is identical to {@code size}, which implements the
+ * {@code List} interface defined in the 1.2 Collections framework.
+ * This method exists in conjunction with {@code setSize} so that
+ * {@code size} is identifiable as a JavaBean property.
*
* @return the number of components in this list
* @see #size()
@@ -77,12 +77,12 @@
* Returns the component at the specified index.
*
* Note: Although this method is not deprecated, the preferred
- * method to use is
* @param index an index into this list
* @return the component at the specified index
- * @exception ArrayIndexOutOfBoundsException if the get(int), which implements the
- * List interface defined in the 1.2 Collections framework.
+ * method to use is {@code get(int)}, which implements the
+ * {@code List} interface defined in the 1.2 Collections framework.
* index
+ * @exception ArrayIndexOutOfBoundsException if the {@code index}
* is negative or greater than the current size of this
* list
* @see #get(int)
@@ -94,7 +94,7 @@
/**
* Copies the components of this list into the specified array.
* The array must be big enough to hold all the objects in this list,
- * else an IndexOutOfBoundsException is thrown.
+ * else an {@code IndexOutOfBoundsException} is thrown.
*
* @param anArray the array into which the components get copied
* @see Vector#copyInto(Object[])
@@ -164,9 +164,9 @@
/**
* Tests whether this list has any components.
*
- * @return true if and only if this list has
+ * @return {@code true} if and only if this list has
* no components, that is, its size is zero;
- * false otherwise
+ * {@code false} otherwise
* @see Vector#isEmpty()
*/
public boolean isEmpty() {
@@ -187,7 +187,7 @@
* Tests whether the specified object is a component in this list.
*
* @param elem an object
- * @return true if the specified object
+ * @return {@code true} if the specified object
* is the same as a component in this list
* @see Vector#contains(Object)
*/
@@ -196,11 +196,11 @@
}
/**
- * Searches for the first occurrence of elem.
+ * Searches for the first occurrence of {@code elem}.
*
* @param elem an object
* @return the index of the first occurrence of the argument in this
- * list; returns -1 if the object is not found
+ * list; returns {@code -1} if the object is not found
* @see Vector#indexOf(Object)
*/
public int indexOf(Object elem) {
@@ -208,14 +208,14 @@
}
/**
- * Searches for the first occurrence of elem, beginning
- * the search at index.
+ * Searches for the first occurrence of {@code elem}, beginning
+ * the search at {@code index}.
*
* @param elem an desired component
* @param index the index from which to begin searching
- * @return the index where the first occurrence of elem
- * is found after index; returns -1
- * if the elem is not found in the list
+ * @return the index where the first occurrence of {@code elem}
+ * is found after {@code index}; returns {@code -1}
+ * if the {@code elem} is not found in the list
* @see Vector#indexOf(Object,int)
*/
public int indexOf(Object elem, int index) {
@@ -223,11 +223,11 @@
}
/**
- * Returns the index of the last occurrence of elem.
+ * Returns the index of the last occurrence of {@code elem}.
*
* @param elem the desired component
- * @return the index of the last occurrence of elem
- * in the list; returns -1 if the object is not found
+ * @return the index of the last occurrence of {@code elem}
+ * in the list; returns {@code -1} if the object is not found
* @see Vector#lastIndexOf(Object)
*/
public int lastIndexOf(Object elem) {
@@ -235,14 +235,14 @@
}
/**
- * Searches backwards for elem, starting from the
+ * Searches backwards for {@code elem}, starting from the
* specified index, and returns an index to it.
*
* @param elem the desired component
* @param index the index to start searching from
- * @return the index of the last occurrence of the elem
- * in this list at position less than index;
- * returns -1 if the object is not found
+ * @return the index of the last occurrence of the {@code elem}
+ * in this list at position less than {@code index};
+ * returns {@code -1} if the object is not found
* @see Vector#lastIndexOf(Object,int)
*/
public int lastIndexOf(Object elem, int index) {
@@ -251,12 +251,12 @@
/**
* Returns the component at the specified index.
- * Throws an ArrayIndexOutOfBoundsException if the index
+ * Throws an {@code ArrayIndexOutOfBoundsException} if the index
* is negative or not less than the size of the list.
*
* Note: Although this method is not deprecated, the preferred
- * method to use is
*
* @param index an index into this list
@@ -270,7 +270,7 @@
/**
* Returns the first component of this list.
- * Throws a get(int), which implements the
- * List interface defined in the 1.2 Collections framework.
+ * method to use is {@code get(int)}, which implements the
+ * {@code List} interface defined in the 1.2 Collections framework.
* NoSuchElementException if this
+ * Throws a {@code NoSuchElementException} if this
* vector has no components.
* @return the first component of this list
* @see Vector#firstElement()
@@ -281,7 +281,7 @@
/**
* Returns the last component of the list.
- * Throws a NoSuchElementException if this vector
+ * Throws a {@code NoSuchElementException} if this vector
* has no components.
*
* @return the last component of the list
@@ -292,16 +292,16 @@
}
/**
- * Sets the component at the specified index of this
+ * Sets the component at the specified {@code index} of this
* list to be the specified element. The previous component at that
* position is discarded.
* ArrayIndexOutOfBoundsException if the index
+ * Throws an {@code ArrayIndexOutOfBoundsException} if the index
* is invalid.
*
* Note: Although this method is not deprecated, the preferred
- * method to use is
*
* @param element what the component is to be set to
@@ -317,12 +317,12 @@
/**
* Deletes the component at the specified index.
* set(int,Object), which implements the
- * List interface defined in the 1.2 Collections framework.
+ * method to use is {@code set(int,Object)}, which implements the
+ * {@code List} interface defined in the 1.2 Collections framework.
* ArrayIndexOutOfBoundsException if the index
+ * Throws an {@code ArrayIndexOutOfBoundsException} if the index
* is invalid.
*
* Note: Although this method is not deprecated, the preferred
- * method to use is
*
* @param index the index of the object to remove
@@ -336,14 +336,14 @@
/**
* Inserts the specified element as a component in this list at the
- * specified remove(int), which implements the
- * List interface defined in the 1.2 Collections framework.
+ * method to use is {@code remove(int)}, which implements the
+ * {@code List} interface defined in the 1.2 Collections framework.
* index.
+ * specified {@code index}.
* ArrayIndexOutOfBoundsException if the index
+ * Throws an {@code ArrayIndexOutOfBoundsException} if the index
* is invalid.
*
* Note: Although this method is not deprecated, the preferred
- * method to use is
*
* @param element the component to insert
@@ -374,8 +374,8 @@
* from this list.
*
* @param obj the component to be removed
- * @return add(int,Object), which implements the
- * List interface defined in the 1.2 Collections framework.
+ * method to use is {@code add(int,Object)}, which implements the
+ * {@code List} interface defined in the 1.2 Collections framework.
* true if the argument was a component of this
- * list; false otherwise
+ * @return {@code true} if the argument was a component of this
+ * list; {@code false} otherwise
* @see Vector#removeElement(Object)
*/
public boolean removeElement(Object obj) {
@@ -392,8 +392,8 @@
* Removes all components from this list and sets its size to zero.
*
* Note: Although this method is not deprecated, the preferred
- * method to use is
*
* @see #clear()
@@ -439,9 +439,9 @@
/**
* Returns the element at the specified position in this list.
* clear, which implements the
- * List interface defined in the 1.2 Collections framework.
+ * method to use is {@code clear}, which implements the
+ * {@code List} interface defined in the 1.2 Collections framework.
* ArrayIndexOutOfBoundsException
+ * Throws an {@code ArrayIndexOutOfBoundsException}
* if the index is out of range
- * (index < 0 || index >= size()).
+ * ({@code index < 0 || index >= size()}).
*
* @param index index of element to return
* @return the element at the specified position in this list
@@ -454,9 +454,9 @@
* Replaces the element at the specified position in this list with the
* specified element.
* ArrayIndexOutOfBoundsException
+ * Throws an {@code ArrayIndexOutOfBoundsException}
* if the index is out of range
- * (index < 0 || index >= size()).
+ * ({@code index < 0 || index >= size()}).
*
* @param index index of element to replace
* @param element element to be stored at the specified position
@@ -472,9 +472,9 @@
/**
* Inserts the specified element at the specified position in this list.
* ArrayIndexOutOfBoundsException if the
+ * Throws an {@code ArrayIndexOutOfBoundsException} if the
* index is out of range
- * (index < 0 || index > size()).
+ * ({@code index < 0 || index > size()}).
*
* @param index index at which the specified element is to be inserted
* @param element element to be inserted
@@ -488,9 +488,9 @@
* Removes the element at the specified position in this list.
* Returns the element that was removed from the list.
* ArrayIndexOutOfBoundsException
+ * Throws an {@code ArrayIndexOutOfBoundsException}
* if the index is out of range
- * (index < 0 || index >= size()).
+ * ({@code index < 0 || index >= size()}).
*
* @param index the index of the element to removed
* @return the element previously at the specified position
@@ -520,10 +520,10 @@
* removes the component at index 1 and the component at index 5,
* as well as all components in between.
* ArrayIndexOutOfBoundsException
+ * Throws an {@code ArrayIndexOutOfBoundsException}
* if the index was invalid.
- * Throws an IllegalArgumentException if
- * fromIndex > toIndex.
+ * Throws an {@code IllegalArgumentException} if
+ * {@code fromIndex > toIndex}.
*
* @param fromIndex the index of the lower end of the range
* @param toIndex the index of the upper end of the range
--- old/src/java.desktop/share/classes/javax/swing/DefaultListSelectionModel.java 2015-10-04 22:56:37.245263660 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultListSelectionModel.java 2015-10-04 22:56:37.057263669 +0400
@@ -42,7 +42,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Philip Milne
@@ -128,9 +128,9 @@
/**
* Returns an array of all the list selection listeners
- * registered on this DefaultListSelectionModel.
+ * registered on this {@code DefaultListSelectionModel}.
*
- * @return all of this model's ListSelectionListeners
+ * @return all of this model's {@code ListSelectionListener}s
* or an empty
* array if no list selection listeners are currently registered
*
@@ -165,9 +165,9 @@
/**
- * Notifies ListSelectionListeners that the value
- * of the selection, in the closed interval firstIndex,
- * lastIndex, has changed.
+ * Notifies {@code ListSelectionListeners} that the value
+ * of the selection, in the closed interval {@code firstIndex},
+ * {@code lastIndex}, has changed.
*
* @param firstIndex the first index in the interval
* @param lastIndex the last index in the interval
@@ -230,10 +230,10 @@
* FooListeners
* are registered using the addFooListener method.
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as FooListener.class.
- * For example, you can query a DefaultListSelectionModel
- * instance m
+ * For example, you can query a {@code DefaultListSelectionModel}
+ * instance {@code m}
* for its list selection listeners
* with the following code:
*
@@ -245,15 +245,15 @@
* @param java.util.EventListener
+ * that descends from {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners
* on this model,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType doesn't
+ * @exception ClassCastException if {@code listenerType} doesn't
* specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getListSelectionListeners
*
@@ -353,8 +353,8 @@
}
/**
- * Returns the value of the leadAnchorNotificationEnabled flag.
- * When leadAnchorNotificationEnabled is true the model
+ * Returns the value of the {@code leadAnchorNotificationEnabled} flag.
+ * When {@code leadAnchorNotificationEnabled} is true the model
* generates notification events with bounds that cover all the changes to
* the selection plus the changes to the lead and anchor indices.
* Setting the flag to false causes a narrowing of the event's bounds to
@@ -367,7 +367,7 @@
* important, such as when the new lead or anchor needs to be updated in
* the view. Therefore, caution is urged when changing the default value.
*
- * @return the value of the leadAnchorNotificationEnabled flag
+ * @return the value of the {@code leadAnchorNotificationEnabled} flag
* @see #setLeadAnchorNotificationEnabled(boolean)
*/
public boolean isLeadAnchorNotificationEnabled() {
@@ -706,7 +706,7 @@
* Returns a string that displays and identifies this
* object's properties.
*
- * @return a String representation of this object
+ * @return a {@code String} representation of this object
*/
public String toString() {
String s = ((getValueIsAdjusting()) ? "~" : "=") + value.toString();
@@ -715,11 +715,11 @@
/**
* Returns a clone of this selection model with the same selection.
- * listenerLists are not duplicated.
+ * {@code listenerLists} are not duplicated.
*
* @exception CloneNotSupportedException if the selection model does not
* both (a) implement the Cloneable interface and (b) define a
- * clone method.
+ * {@code clone} method.
*/
public Object clone() throws CloneNotSupportedException {
DefaultListSelectionModel clone = (DefaultListSelectionModel)super.clone();
@@ -814,7 +814,7 @@
* values would be wider, including cells that had been first cleared only
* to later be set.
* mouseDragged method
+ * This method can be used in the {@code mouseDragged} method
* of a UI class to extend a selection.
*
* @see #getLeadSelectionIndex
--- old/src/java.desktop/share/classes/javax/swing/DefaultRowSorter.java 2015-10-04 22:56:37.781263636 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultRowSorter.java 2015-10-04 22:56:37.589263645 +0400
@@ -33,61 +33,61 @@
import javax.swing.SortOrder;
/**
- * An implementation of RowSorter that provides sorting and
+ * An implementation of {@code RowSorter} that provides sorting and
* filtering around a grid-based data model.
- * Beyond creating and installing a RowSorter, you very rarely
+ * Beyond creating and installing a {@code RowSorter}, you very rarely
* need to interact with one directly. Refer to
* {@link javax.swing.table.TableRowSorter TableRowSorter} for a concrete
- * implementation of RowSorter for JTable.
+ * implementation of {@code RowSorter} for {@code JTable}.
* SortKeys, in order.
- * If two objects are equal (the Comparator for the
- * column returns 0) the next SortKey is used. If no
- * SortKeys remain or the order is UNSORTED, then
+ * Sorting is done based on the current {@code SortKey}s, in order.
+ * If two objects are equal (the {@code Comparator} for the
+ * column returns 0) the next {@code SortKey} is used. If no
+ * {@code SortKey}s remain or the order is {@code UNSORTED}, then
* the order of the rows in the model is used.
* Comparator
- * that you can specify using the setComparator method.
- * If a Comparator has not been specified, the
- * Comparator returned by
- * Collator.getInstance() is used on the results of
- * calling toString on the underlying objects. The
- * Comparator is never passed null. A
- * null value is treated as occurring before a
- * non-null value, and two null values are
+ * Sorting of each column is done by way of a {@code Comparator}
+ * that you can specify using the {@code setComparator} method.
+ * If a {@code Comparator} has not been specified, the
+ * {@code Comparator} returned by
+ * {@code Collator.getInstance()} is used on the results of
+ * calling {@code toString} on the underlying objects. The
+ * {@code Comparator} is never passed {@code null}. A
+ * {@code null} value is treated as occurring before a
+ * non-{@code null} value, and two {@code null} values are
* considered equal.
* Comparator that casts its argument to
+ * If you specify a {@code Comparator} that casts its argument to
* a type other than that provided by the model, a
- * ClassCastException will be thrown when the data is sorted.
+ * {@code ClassCastException} will be thrown when the data is sorted.
* DefaultRowSorter provides the
+ * In addition to sorting, {@code DefaultRowSorter} provides the
* ability to filter rows. Filtering is done by way of a
- * RowFilter that is specified using the
- * setRowFilter method. If no filter has been specified all
+ * {@code RowFilter} that is specified using the
+ * {@code setRowFilter} method. If no filter has been specified all
* rows are included.
* Comparators are
+ * every column is sortable. The default {@code Comparator}s are
* documented in the subclasses (for example, {@link
* javax.swing.table.TableRowSorter TableRowSorter}).
* modelStructureChanged method is invoked) the following
- * are reset to their default values: Comparators by
+ * {@code modelStructureChanged} method is invoked) the following
+ * are reset to their default values: {@code Comparator}s by
* column, current sort order, and whether each column is sortable. To
- * find the default Comparators, see the concrete
+ * find the default {@code Comparator}s, see the concrete
* implementation (for example, {@link
* javax.swing.table.TableRowSorter TableRowSorter}). The default
* sort order is unsorted (the same as the model), and columns are
* sortable by default.
* modelStructureChanged method is invoked) the following
- * are reset to their default values: Comparators by column,
+ * {@code modelStructureChanged} method is invoked) the following
+ * are reset to their default values: {@code Comparator}s by column,
* current sort order and whether a column is sortable.
* DefaultRowSorter is an abstract class. Concrete
+ * {@code DefaultRowSorter} is an abstract class. Concrete
* subclasses must provide access to the underlying data by invoking
* {@code setModelWrapper}. The {@code setModelWrapper} method
* must be invoked soon after the constructor is
@@ -95,15 +95,15 @@
* Undefined behavior will result if you use a {@code
* DefaultRowSorter} without specifying a {@code ModelWrapper}.
* DefaultRowSorter has two formal type parameters. The
+ * {@code DefaultRowSorter} has two formal type parameters. The
* first type parameter corresponds to the class of the model, for example
- * DefaultTableModel. The second type parameter
+ * {@code DefaultTableModel}. The second type parameter
* corresponds to the class of the identifier passed to the
- * RowFilter. Refer to TableRowSorter and
- * RowFilter for more details on the type parameters.
+ * {@code RowFilter}. Refer to {@code TableRowSorter} and
+ * {@code RowFilter} for more details on the type parameters.
*
* @param RowFilter
+ * @param the type of the identifier passed to the {@code RowFilter}
* @see javax.swing.table.TableRowSorter
* @see javax.swing.table.DefaultTableModel
* @see java.text.Collator
@@ -190,7 +190,7 @@
/**
- * Creates an empty DefaultRowSorter.
+ * Creates an empty {@code DefaultRowSorter}.
*/
public DefaultRowSorter() {
sortKeys = Collections.emptyList();
@@ -244,7 +244,7 @@
/**
* Sets whether or not the specified column is sortable. The specified
- * value is only checked when toggleSortOrder is invoked.
+ * value is only checked when {@code toggleSortOrder} is invoked.
* It is still possible to sort on a column that has been marked as
* unsortable by directly setting the sort keys. The default is
* true.
@@ -252,7 +252,7 @@
* @param column the column to enable or disable sorting on, in terms
* of the underlying model
* @param sortable whether or not the specified column is sortable
- * @throws IndexOutOfBoundsException if column is outside
+ * @throws IndexOutOfBoundsException if {@code column} is outside
* the range of the model
* @see #toggleSortOrder
* @see #setSortKeys
@@ -288,11 +288,11 @@
* {@code List} do not effect this {@code DefaultRowSorter}.
* If the sort keys have changed this triggers a sort.
*
- * @param sortKeys the new SortKeys; null
+ * @param sortKeys the new {@code SortKeys}; {@code null}
* is a shorthand for specifying an empty list,
* indicating that the view should be unsorted
* @throws IllegalArgumentException if any of the values in
- * sortKeys are null or have a column index outside
+ * {@code sortKeys} are null or have a column index outside
* the range of the model
*/
public void setSortKeys(List sortKeys) {
@@ -339,7 +339,7 @@
* Sets the maximum number of sort keys. The number of sort keys
* determines how equal values are resolved when sorting. For
* example, assume a table row sorter is created and
- * setMaxSortKeys(2) is invoked on it. The user
+ * {@code setMaxSortKeys(2)} is invoked on it. The user
* clicks the header for column 1, causing the table rows to be
* sorted based on the items in column 1. Next, the user clicks
* the header for column 2, causing the table to be sorted based
@@ -350,18 +350,18 @@
* then clicks the header for column 3, then the items are
* primarily sorted on column 3 and secondarily sorted on column
* 2. Because the maximum number of sort keys has been set to 2
- * with setMaxSortKeys, column 1 no longer has an
+ * with {@code setMaxSortKeys}, column 1 no longer has an
* effect on the order.
* toggleSortOrder. You can specify more sort
- * keys by invoking setSortKeys directly and they will
- * all be honored. However if toggleSortOrder is subsequently
+ * {@code toggleSortOrder}. You can specify more sort
+ * keys by invoking {@code setSortKeys} directly and they will
+ * all be honored. However if {@code toggleSortOrder} is subsequently
* invoked the maximum number of sort keys will be enforced.
* The default value is 3.
*
* @param max the maximum number of sort keys
- * @throws IllegalArgumentException if max < 1
+ * @throws IllegalArgumentException if {@code max < 1}
*/
public void setMaxSortKeys(int max) {
if (max < 1) {
@@ -381,7 +381,7 @@
/**
* If true, specifies that a sort should happen when the underlying
- * model is updated (rowsUpdated is invoked). For
+ * model is updated ({@code rowsUpdated} is invoked). For
* example, if this is true and the user edits an entry the
* location of that item in the view may change. The default is
* false.
@@ -405,14 +405,14 @@
/**
* Sets the filter that determines which rows, if any, should be
* hidden from the view. The filter is applied before sorting. A value
- * of null indicates all values from the model should be
+ * of {@code null} indicates all values from the model should be
* included.
* RowFilter's include method is passed an
- * Entry that wraps the underlying model. The number
- * of columns in the Entry corresponds to the
- * number of columns in the ModelWrapper. The identifier
- * comes from the ModelWrapper as well.
+ * {@code RowFilter}'s {@code include} method is passed an
+ * {@code Entry} that wraps the underlying model. The number
+ * of columns in the {@code Entry} corresponds to the
+ * number of columns in the {@code ModelWrapper}. The identifier
+ * comes from the {@code ModelWrapper} as well.
* sortKeys list
+ * associated with this sorter. An empty {@code sortKeys} list
* indicates that the view should unsorted, the same as the model.
*
* @see #setRowFilter
@@ -705,16 +705,16 @@
/**
* Returns whether or not to convert the value to a string before
* doing comparisons when sorting. If true
- * ModelWrapper.getStringValueAt will be used, otherwise
- * ModelWrapper.getValueAt will be used. It is up to
- * subclasses, such as TableRowSorter, to honor this value
- * in their ModelWrapper implementation.
+ * {@code ModelWrapper.getStringValueAt} will be used, otherwise
+ * {@code ModelWrapper.getValueAt} will be used. It is up to
+ * subclasses, such as {@code TableRowSorter}, to honor this value
+ * in their {@code ModelWrapper} implementation.
*
* @param column the index of the column to test, in terms of the
* underlying model
* @return true if values are to be converted to strings before doing
* comparisons when sorting
- * @throws IndexOutOfBoundsException if column is not valid
+ * @throws IndexOutOfBoundsException if {@code column} is not valid
*/
protected boolean useToString(int column) {
return (getComparator(column) == null);
@@ -722,7 +722,7 @@
/**
* Refreshes the modelToView mapping from that of viewToModel.
- * If unsetFirst is true, all indices in modelToView are
+ * If {@code unsetFirst} is true, all indices in modelToView are
* first set to -1.
*/
private void setModelToViewFromViewToModel(boolean unsetFirst) {
@@ -749,14 +749,14 @@
}
/**
- * Sets the Comparator to use when sorting the specified
+ * Sets the {@code Comparator} to use when sorting the specified
* column. This does not trigger a sort. If you want to sort after
- * setting the comparator you need to explicitly invoke sort.
+ * setting the comparator you need to explicitly invoke {@code sort}.
*
- * @param column the index of the column the Comparator is
+ * @param column the index of the column the {@code Comparator} is
* to be used for, in terms of the underlying model
- * @param comparator the Comparator to use
- * @throws IndexOutOfBoundsException if column is outside
+ * @param comparator the {@code Comparator} to use
+ * @throws IndexOutOfBoundsException if {@code column} is outside
* the range of the underlying model
*/
public void setComparator(int column, Comparator comparator) {
@@ -768,13 +768,13 @@
}
/**
- * Returns the Comparator for the specified
- * column. This will return null if a Comparator
+ * Returns the {@code Comparator} for the specified
+ * column. This will return {@code null} if a {@code Comparator}
* has not been specified for the column.
*
- * @param column the column to fetch the Comparator for, in
+ * @param column the column to fetch the {@code Comparator} for, in
* terms of the underlying model
- * @return the Comparator for the specified column
+ * @return the {@code Comparator} for the specified column
* @throws IndexOutOfBoundsException if column is outside
* the range of the underlying model
*/
@@ -1016,7 +1016,7 @@
/**
* Returns true if we should try and optimize the processing of the
- * TableModelEvent. If this returns false, assume the
+ * {@code TableModelEvent}. If this returns false, assume the
* event was dealt with and no further processing needs to happen.
*/
private boolean shouldOptimizeChange(int firstRow, int lastRow) {
@@ -1227,19 +1227,19 @@
/**
- * DefaultRowSorter.ModelWrapper is responsible for providing
- * the data that gets sorted by DefaultRowSorter. You
- * normally do not interact directly with ModelWrapper.
- * Subclasses of DefaultRowSorter provide an
- * implementation of ModelWrapper wrapping another model.
+ * {@code DefaultRowSorter.ModelWrapper} is responsible for providing
+ * the data that gets sorted by {@code DefaultRowSorter}. You
+ * normally do not interact directly with {@code ModelWrapper}.
+ * Subclasses of {@code DefaultRowSorter} provide an
+ * implementation of {@code ModelWrapper} wrapping another model.
* For example,
- * TableRowSorter provides a ModelWrapper that
- * wraps a TableModel.
+ * {@code TableRowSorter} provides a {@code ModelWrapper} that
+ * wraps a {@code TableModel}.
* ModelWrapper makes a distinction between values as
- * Objects and Strings. This allows
+ * {@code ModelWrapper} makes a distinction between values as
+ * {@code Object}s and {@code String}s. This allows
* implementations to provide a custom string
- * converter to be used instead of invoking toString on the
+ * converter to be used instead of invoking {@code toString} on the
* object.
*
* @param ModelWrapper.
+ * Creates a new {@code ModelWrapper}.
*/
protected ModelWrapper() {
}
/**
- * Returns the underlying model that this Model is
+ * Returns the underlying model that this {@code Model} is
* wrapping.
*
* @return the underlying model
@@ -1289,15 +1289,15 @@
public abstract Object getValueAt(int row, int column);
/**
- * Returns the value as a String at the specified
- * index. This implementation uses toString on
- * the result from getValueAt (making sure
+ * Returns the value as a {@code String} at the specified
+ * index. This implementation uses {@code toString} on
+ * the result from {@code getValueAt} (making sure
* to return an empty string for null values). Subclasses that
* override this method should never return null.
*
* @param row the row index
* @param column the column index
- * @return the value at the specified index as a String
+ * @return the value at the specified index as a {@code String}
* @throws IndexOutOfBoundsException if the indices are outside
* the range of the model
*/
@@ -1316,8 +1316,8 @@
/**
* Returns the identifier for the specified row. The return value
* of this is used as the identifier for the
- * RowFilter.Entry that is passed to the
- * RowFilter.
+ * {@code RowFilter.Entry} that is passed to the
+ * {@code RowFilter}.
*
* @param row the row to return the identifier for, in terms of
* the underlying model
--- old/src/java.desktop/share/classes/javax/swing/DefaultSingleSelectionModel.java 2015-10-04 22:56:38.325263612 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DefaultSingleSelectionModel.java 2015-10-04 22:56:38.133263621 +0400
@@ -38,7 +38,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Dave Moore
@@ -94,14 +94,14 @@
}
/**
- * Adds a ChangeListener to the button.
+ * Adds a {@code ChangeListener} to the button.
*/
public void addChangeListener(ChangeListener l) {
listenerList.add(ChangeListener.class, l);
}
/**
- * Removes a ChangeListener from the button.
+ * Removes a {@code ChangeListener} from the button.
*/
public void removeChangeListener(ChangeListener l) {
listenerList.remove(ChangeListener.class, l);
@@ -109,9 +109,9 @@
/**
* Returns an array of all the change listeners
- * registered on this DefaultSingleSelectionModel.
+ * registered on this {@code DefaultSingleSelectionModel}.
*
- * @return all of this model's ChangeListeners
+ * @return all of this model's {@code ChangeListener}s
* or an empty
* array if no change listeners are currently registered
*
@@ -152,10 +152,10 @@
* FooListeners
* are registered using the addFooListener method.
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as FooListener.class.
- * For example, you can query a DefaultSingleSelectionModel
- * instance m
+ * For example, you can query a {@code DefaultSingleSelectionModel}
+ * instance {@code m}
* for its change listeners
* with the following code:
*
@@ -167,15 +167,15 @@
* @param java.util.EventListener
+ * that descends from {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners
* on this model,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType doesn't
+ * @exception ClassCastException if {@code listenerType} doesn't
* specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @see #getChangeListeners
*
--- old/src/java.desktop/share/classes/javax/swing/DropMode.java 2015-10-04 22:56:38.853263588 +0400
+++ new/src/java.desktop/share/classes/javax/swing/DropMode.java 2015-10-04 22:56:38.661263597 +0400
@@ -78,26 +78,26 @@
INSERT_COLS,
/**
- * This mode is a combination of ON
- * and INSERT, specifying that data can be
+ * This mode is a combination of {@code ON}
+ * and {@code INSERT}, specifying that data can be
* dropped on existing items, or in insert locations
- * as specified by INSERT.
+ * as specified by {@code INSERT}.
*/
ON_OR_INSERT,
/**
- * This mode is a combination of ON
- * and INSERT_ROWS, specifying that data can be
+ * This mode is a combination of {@code ON}
+ * and {@code INSERT_ROWS}, specifying that data can be
* dropped on existing items, or as insert rows
- * as specified by INSERT_ROWS.
+ * as specified by {@code INSERT_ROWS}.
*/
ON_OR_INSERT_ROWS,
/**
- * This mode is a combination of ON
- * and INSERT_COLS, specifying that data can be
+ * This mode is a combination of {@code ON}
+ * and {@code INSERT_COLS}, specifying that data can be
* dropped on existing items, or as insert columns
- * as specified by INSERT_COLS.
+ * as specified by {@code INSERT_COLS}.
*/
ON_OR_INSERT_COLS
}
--- old/src/java.desktop/share/classes/javax/swing/FocusManager.java 2015-10-04 22:56:39.373263565 +0400
+++ new/src/java.desktop/share/classes/javax/swing/FocusManager.java 2015-10-04 22:56:39.185263573 +0400
@@ -30,8 +30,8 @@
/**
* This class has been obsoleted by the 1.4 focus APIs. While client code may
* still use this class, developers are strongly encouraged to use
- * java.awt.KeyboardFocusManager and
- * java.awt.DefaultKeyboardFocusManager instead.
+ * {@code java.awt.KeyboardFocusManager} and
+ * {@code java.awt.DefaultKeyboardFocusManager} instead.
* KeyboardFocusManager.getCurrentKeyboardFocusManager().
+ * {@code KeyboardFocusManager.getCurrentKeyboardFocusManager()}.
* See the Focus Specification for more information.
*
* @see java.awt.KeyboardFocusManager#getCurrentKeyboardFocusManager
@@ -65,10 +65,10 @@
private static boolean enabled = true;
/**
- * Returns the current KeyboardFocusManager instance
+ * Returns the current {@code KeyboardFocusManager} instance
* for the calling thread's context.
*
- * @return this thread's context's KeyboardFocusManager
+ * @return this thread's context's {@code KeyboardFocusManager}
* @see #setCurrentManager
*/
public static FocusManager getCurrentManager() {
@@ -82,26 +82,26 @@
}
/**
- * Sets the current KeyboardFocusManager instance
- * for the calling thread's context. If null is
- * specified, then the current KeyboardFocusManager
+ * Sets the current {@code KeyboardFocusManager} instance
+ * for the calling thread's context. If {@code null} is
+ * specified, then the current {@code KeyboardFocusManager}
* is replaced with a new instance of
- * DefaultKeyboardFocusManager.
+ * {@code DefaultKeyboardFocusManager}.
* SecurityManager is installed,
- * the calling thread must be granted the AWTPermission
+ * If a {@code SecurityManager} is installed,
+ * the calling thread must be granted the {@code AWTPermission}
* "replaceKeyboardFocusManager" in order to replace the
- * the current KeyboardFocusManager.
+ * the current {@code KeyboardFocusManager}.
* If this permission is not granted,
- * this method will throw a SecurityException,
- * and the current KeyboardFocusManager will be unchanged.
+ * this method will throw a {@code SecurityException},
+ * and the current {@code KeyboardFocusManager} will be unchanged.
*
- * @param aFocusManager the new KeyboardFocusManager
+ * @param aFocusManager the new {@code KeyboardFocusManager}
* for this thread's context
* @see #getCurrentManager
* @see java.awt.DefaultKeyboardFocusManager
* @throws SecurityException if the calling thread does not have permission
- * to replace the current KeyboardFocusManager
+ * to replace the current {@code KeyboardFocusManager}
*/
public static void setCurrentManager(FocusManager aFocusManager)
throws SecurityException
@@ -118,14 +118,14 @@
}
/**
- * Changes the current KeyboardFocusManager's default
- * FocusTraversalPolicy to
- * DefaultFocusTraversalPolicy.
+ * Changes the current {@code KeyboardFocusManager}'s default
+ * {@code FocusTraversalPolicy} to
+ * {@code DefaultFocusTraversalPolicy}.
*
* @see java.awt.DefaultFocusTraversalPolicy
* @see java.awt.KeyboardFocusManager#setDefaultFocusTraversalPolicy
* @deprecated as of 1.4, replaced by
- * KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)
+ * {@code KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)}
*/
@Deprecated
public static void disableSwingFocusManager() {
@@ -139,12 +139,12 @@
/**
* Returns whether the application has invoked
- * disableSwingFocusManager().
+ * {@code disableSwingFocusManager()}.
*
* @return {@code true} if focus manager is enabled.
* @see #disableSwingFocusManager
* @deprecated As of 1.4, replaced by
- * KeyboardFocusManager.getDefaultFocusTraversalPolicy()
+ * {@code KeyboardFocusManager.getDefaultFocusTraversalPolicy()}
*/
@Deprecated
public static boolean isFocusManagerEnabled() {
--- old/src/java.desktop/share/classes/javax/swing/GrayFilter.java 2015-10-04 22:56:39.921263540 +0400
+++ new/src/java.desktop/share/classes/javax/swing/GrayFilter.java 2015-10-04 22:56:39.709263550 +0400
@@ -76,7 +76,7 @@
}
/**
- * Overrides RGBImageFilter.filterRGB.
+ * Overrides {@code RGBImageFilter.filterRGB}.
*/
public int filterRGB(int x, int y, int rgb) {
// Use NTSC conversion formula.
--- old/src/java.desktop/share/classes/javax/swing/ImageIcon.java 2015-10-04 22:56:40.445263517 +0400
+++ new/src/java.desktop/share/classes/javax/swing/ImageIcon.java 2015-10-04 22:56:40.257263525 +0400
@@ -60,7 +60,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @author Jeff Dinkins
@@ -178,7 +178,7 @@
* For example, specify:
*
* new ImageIcon("images/myImage.gif")
- * The description is initialized to the filename string.
+ * The description is initialized to the {@code filename} string.
*
* @param filename a String specifying a filename or path
* @see #getDescription
@@ -366,8 +366,8 @@
}
/**
- * Returns this icon's Image.
- * @return the Image object for this ImageIcon
+ * Returns this icon's {@code Image}.
+ * @return the {@code Image} object for this {@code ImageIcon}
*/
@Transient
public Image getImage() {
@@ -410,10 +410,10 @@
/**
* Paints the icon.
* The top-left corner of the icon is drawn at
- * the point (x, y)
- * in the coordinate space of the graphics context g.
+ * the point ({@code x}, {@code y})
+ * in the coordinate space of the graphics context {@code g}.
* If this icon has no image observer,
- * this method uses the c component
+ * this method uses the {@code c} component
* as the observer.
*
* @param c the component to be used as the observer
@@ -581,7 +581,7 @@
/**
* This class implements accessibility support for the
- * ImageIcon class. It provides an implementation of the
+ * {@code ImageIcon} class. It provides an implementation of the
* Java Accessibility API appropriate to image icon user-interface
* elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
* @since 1.3
*/
--- old/src/java.desktop/share/classes/javax/swing/InputVerifier.java 2015-10-04 22:56:41.001263492 +0400
+++ new/src/java.desktop/share/classes/javax/swing/InputVerifier.java 2015-10-04 22:56:40.789263501 +0400
@@ -34,12 +34,12 @@
* that it's in
* the proper format) before allowing the user to navigate out of
* the text field. To do this, clients create a subclass of
- * InputVerifier and, using JComponent's
- * setInputVerifier method,
- * attach an instance of their subclass to the JComponent whose input they
+ * {@code InputVerifier} and, using {@code JComponent}'s
+ * {@code setInputVerifier} method,
+ * attach an instance of their subclass to the {@code JComponent} whose input they
* want to validate. Before focus is transfered to another Swing component
- * that requests it, the input verifier's shouldYieldFocus method is
- * called. Focus is transfered only if that method returns true.
+ * that requests it, the input verifier's {@code shouldYieldFocus} method is
+ * called. Focus is transfered only if that method returns {@code true}.
* true when valid, false when invalid
+ * @return {@code true} when valid, {@code false} when invalid
* @see JComponent#setInputVerifier
* @see JComponent#getInputVerifier
*
@@ -113,16 +113,16 @@
/**
- * Calls verify(input) to ensure that the input is valid.
+ * Calls {@code verify(input)} to ensure that the input is valid.
* This method can have side effects. In particular, this method
* is called when the user attempts to advance focus out of the
* argument component into another Swing component in this window.
- * If this method returns true, then the focus is transfered
- * normally; if it returns false, then the focus remains in
+ * If this method returns {@code true}, then the focus is transfered
+ * normally; if it returns {@code false}, then the focus remains in
* the argument component.
*
* @param input the JComponent to verify
- * @return true when valid, false when invalid
+ * @return {@code true} when valid, {@code false} when invalid
* @see JComponent#setInputVerifier
* @see JComponent#getInputVerifier
*
--- old/src/java.desktop/share/classes/javax/swing/InternalFrameFocusTraversalPolicy.java 2015-10-04 22:56:41.525263468 +0400
+++ new/src/java.desktop/share/classes/javax/swing/InternalFrameFocusTraversalPolicy.java 2015-10-04 22:56:41.337263477 +0400
@@ -46,7 +46,7 @@
/**
* Returns the Component that should receive the focus when a
* JInternalFrame is selected for the first time. Once the JInternalFrame
- * has been selected by a call to setSelected(true), the
+ * has been selected by a call to {@code setSelected(true)}, the
* initial Component will not be used again. Instead, if the JInternalFrame
* loses and subsequently regains selection, or is made invisible or
* undisplayable and subsequently made visible and displayable, the
--- old/src/java.desktop/share/classes/javax/swing/JApplet.java 2015-10-04 22:56:42.045263445 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JApplet.java 2015-10-04 22:56:41.857263453 +0400
@@ -38,18 +38,18 @@
import javax.accessibility.AccessibleContext;
/**
- * An extended version of java.applet.Applet that adds support for
+ * An extended version of {@code java.applet.Applet} that adds support for
* the JFC/Swing component architecture.
- * You can find task-oriented documentation about using JApplet
+ * You can find task-oriented documentation about using {@code JApplet}
* in The Java Tutorial,
* in the section
* How to Make Applets.
* JApplet class is slightly incompatible with
- * java.applet.Applet. JApplet contains a
- * JRootPane as its only child. The contentPane
- * should be the parent of any children of the JApplet.
+ * The {@code JApplet} class is slightly incompatible with
+ * {@code java.applet.Applet}. {@code JApplet} contains a
+ * {@code JRootPane} as its only child. The {@code contentPane}
+ * should be the parent of any children of the {@code JApplet}.
* As a convenience, the {@code add}, {@code remove}, and {@code setLayout}
* methods of this class are overridden, so that they delegate calls
* to the corresponding methods of the {@code ContentPane}.
@@ -58,19 +58,19 @@
* applet.add(child);
* contentPane.
- * The contentPane will always be non-null.
- * Attempting to set it to null will cause the
- * JApplet to throw an exception. The default
- * contentPane will have a BorderLayout
+ * And the child will be added to the {@code contentPane}.
+ * The {@code contentPane} will always be non-{@code null}.
+ * Attempting to set it to {@code null} will cause the
+ * {@code JApplet} to throw an exception. The default
+ * {@code contentPane} will have a {@code BorderLayout}
* manager set on it.
* Refer to {@link javax.swing.RootPaneContainer}
- * for details on adding, removing and setting the LayoutManager
- * of a JApplet.
+ * for details on adding, removing and setting the {@code LayoutManager}
+ * of a {@code JApplet}.
* JRootPane documentation for a
- * complete description of the contentPane, glassPane,
- * and layeredPane properties.
+ * Please see the {@code JRootPane} documentation for a
+ * complete description of the {@code contentPane}, {@code glassPane},
+ * and {@code layeredPane} properties.
* add and setLayout
- * will be forwarded to the contentPane. This is initially
- * false, but is set to true when the JApplet is constructed.
+ * If true then calls to {@code add} and {@code setLayout}
+ * will be forwarded to the {@code contentPane}. This is initially
+ * false, but is set to true when the {@code JApplet} is constructed.
*
* @see #isRootPaneCheckingEnabled
* @see #setRootPaneCheckingEnabled
@@ -118,7 +118,7 @@
protected boolean rootPaneCheckingEnabled = false;
/**
- * The TransferHandler for this applet.
+ * The {@code TransferHandler} for this applet.
*/
private TransferHandler transferHandler;
@@ -126,7 +126,7 @@
* Creates a swing applet instance.
* JComponent.getDefaultLocale.
+ * returned by {@code JComponent.getDefaultLocale}.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
@@ -217,9 +217,9 @@
}
/**
- * Gets the transferHandler property.
+ * Gets the {@code transferHandler} property.
*
- * @return the value of the transferHandler property
+ * @return the value of the {@code transferHandler} property
*
* @see TransferHandler
* @see #setTransferHandler
@@ -230,7 +230,7 @@
}
/**
- * Just calls paint(g). This method was overridden to
+ * Just calls {@code paint(g)}. This method was overridden to
* prevent an unnecessary call to clear the background.
*/
public void update(Graphics g) {
@@ -263,10 +263,10 @@
/**
- * Returns whether calls to add and
- * setLayout are forwarded to the contentPane.
+ * Returns whether calls to {@code add} and
+ * {@code setLayout} are forwarded to the {@code contentPane}.
*
- * @return true if add and setLayout
+ * @return true if {@code add} and {@code setLayout}
* are forwarded; false otherwise
*
* @see #addImpl
@@ -280,12 +280,12 @@
/**
- * Sets whether calls to add and
- * setLayout are forwarded to the contentPane.
+ * Sets whether calls to {@code add} and
+ * {@code setLayout} are forwarded to the {@code contentPane}.
*
- * @param enabled true if add and setLayout
+ * @param enabled true if {@code add} and {@code setLayout}
* are forwarded, false if they should operate directly on the
- * JApplet.
+ * {@code JApplet}.
*
* @see #addImpl
* @see #setLayout
@@ -301,17 +301,17 @@
/**
- * Adds the specified child Component.
+ * Adds the specified child {@code Component}.
* This method is overridden to conditionally forward calls to the
- * contentPane.
- * By default, children are added to the contentPane instead
+ * {@code contentPane}.
+ * By default, children are added to the {@code contentPane} instead
* of the frame, refer to {@link javax.swing.RootPaneContainer} for
* details.
*
* @param comp the component to be enhanced
* @param constraints the constraints to be respected
* @param index the index
- * @exception IllegalArgumentException if index is invalid
+ * @exception IllegalArgumentException if {@code index} is invalid
* @exception IllegalArgumentException if adding the container's parent
* to itself
* @exception IllegalArgumentException if adding a window to a container
@@ -331,13 +331,13 @@
/**
* Removes the specified component from the container. If
- * comp is not the rootPane, this will forward
- * the call to the contentPane. This will do nothing if
- * comp is not a child of the JFrame or
- * contentPane.
+ * {@code comp} is not the {@code rootPane}, this will forward
+ * the call to the {@code contentPane}. This will do nothing if
+ * {@code comp} is not a child of the {@code JFrame} or
+ * {@code contentPane}.
*
* @param comp the component to be removed
- * @throws NullPointerException if comp is null
+ * @throws NullPointerException if {@code comp} is null
* @see #add
* @see javax.swing.RootPaneContainer
*/
@@ -351,13 +351,13 @@
/**
- * Sets the LayoutManager.
+ * Sets the {@code LayoutManager}.
* Overridden to conditionally forward the call to the
- * contentPane.
+ * {@code contentPane}.
* Refer to {@link javax.swing.RootPaneContainer} for
* more information.
*
- * @param manager the LayoutManager
+ * @param manager the {@code LayoutManager}
* @see #setRootPaneCheckingEnabled
* @see javax.swing.RootPaneContainer
*/
@@ -503,7 +503,7 @@
/**
* Repaints the specified rectangle of this component within
- * time milliseconds. Refer to RepaintManager
+ * {@code time} milliseconds. Refer to {@code RepaintManager}
* for details on how the repaint is handled.
*
* @param time maximum time in milliseconds before update
@@ -529,7 +529,7 @@
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
* @return a string representation of this JApplet.
*/
@@ -573,7 +573,7 @@
/**
* This class implements accessibility support for the
- * JApplet class.
+ * {@code JApplet} class.
*/
protected class AccessibleJApplet extends AccessibleApplet {
// everything moved to new parent, AccessibleApplet
--- old/src/java.desktop/share/classes/javax/swing/JButton.java 2015-10-04 22:56:42.577263421 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JButton.java 2015-10-04 22:56:42.385263430 +0400
@@ -44,9 +44,9 @@
* Actions. Using an
- * Action with a button has many benefits beyond directly
+ * {@code Action} with a button has many benefits beyond directly
* configuring a button. Refer to
- * Swing Components Supporting Action for more
+ * Swing Components Supporting {@code Action}java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @beaninfo
@@ -113,9 +113,9 @@
/**
* Creates a button where properties are taken from the
- * Action supplied.
+ * {@code Action} supplied.
*
- * @param a the Action used to specify the new button
+ * @param a the {@code Action} used to specify the new button
*
* @since 1.3
*/
@@ -166,14 +166,14 @@
/**
- * Gets the value of the defaultButton property,
- * which if true means that this button is the current
- * default button for its JRootPane.
+ * Gets the value of the {@code defaultButton} property,
+ * which if {@code true} means that this button is the current
+ * default button for its {@code JRootPane}.
* Most look and feels render the default button
* differently, and may potentially provide bindings
* to access the default button.
*
- * @return the value of the defaultButton property
+ * @return the value of the {@code defaultButton} property
* @see JRootPane#setDefaultButton
* @see #isDefaultCapable
* @beaninfo
@@ -188,9 +188,9 @@
}
/**
- * Gets the value of the defaultCapable property.
+ * Gets the value of the {@code defaultCapable} property.
*
- * @return the value of the defaultCapable property
+ * @return the value of the {@code defaultCapable} property
* @see #setDefaultCapable
* @see #isDefaultButton
* @see JRootPane#setDefaultButton
@@ -200,16 +200,16 @@
}
/**
- * Sets the defaultCapable property,
+ * Sets the {@code defaultCapable} property,
* which determines whether this button can be
* made the default button for its root pane.
- * The default value of the defaultCapable
- * property is true unless otherwise
+ * The default value of the {@code defaultCapable}
+ * property is {@code true} unless otherwise
* specified by the look and feel.
*
- * @param defaultCapable true if this button will be
+ * @param defaultCapable {@code true} if this button will be
* capable of being the default button on the
- * RootPane; otherwise false
+ * {@code RootPane}; otherwise {@code false}
* @see #isDefaultCapable
* @beaninfo
* bound: true
@@ -223,11 +223,11 @@
}
/**
- * Overrides JComponent.removeNotify to check if
+ * Overrides {@code JComponent.removeNotify} to check if
* this button is currently set as the default button on the
- * RootPane, and if so, sets the RootPane's
- * default button to null to ensure the
- * RootPane doesn't hold onto an invalid button reference.
+ * {@code RootPane}, and if so, sets the {@code RootPane}'s
+ * default button to {@code null} to ensure the
+ * {@code RootPane} doesn't hold onto an invalid button reference.
*/
public void removeNotify() {
JRootPane root = SwingUtilities.getRootPane(this);
@@ -254,13 +254,13 @@
/**
- * Returns a string representation of this JButton.
+ * Returns a string representation of this {@code JButton}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JButton
+ * @return a string representation of this {@code JButton}
*/
protected String paramString() {
String defaultCapableString = (defaultCapable ? "true" : "false");
@@ -275,14 +275,14 @@
////////////////
/**
- * Gets the AccessibleContext associated with this
- * JButton. For JButtons,
- * the AccessibleContext takes the form of an
- * AccessibleJButton.
- * A new AccessibleJButton instance is created if necessary.
+ * Gets the {@code AccessibleContext} associated with this
+ * {@code JButton}. For {@code JButton}s,
+ * the {@code AccessibleContext} takes the form of an
+ * {@code AccessibleJButton}.
+ * A new {@code AccessibleJButton} instance is created if necessary.
*
- * @return an AccessibleJButton that serves as the
- * AccessibleContext of this JButton
+ * @return an {@code AccessibleJButton} that serves as the
+ * {@code AccessibleContext} of this {@code JButton}
* @beaninfo
* expert: true
* description: The AccessibleContext associated with this Button.
@@ -296,7 +296,7 @@
/**
* This class implements accessibility support for the
- * JButton class. It provides an implementation of the
+ * {@code JButton} class. It provides an implementation of the
* Java Accessibility API appropriate to button user-interface
* elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial")
--- old/src/java.desktop/share/classes/javax/swing/JCheckBox.java 2015-10-04 22:56:43.105263397 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JCheckBox.java 2015-10-04 22:56:42.913263406 +0400
@@ -46,9 +46,9 @@
* Actions. Using an
- * Action with a button has many benefits beyond directly
+ * {@code Action} with a button has many benefits beyond directly
* configuring a button. Refer to
- * Swing Components Supporting Action for more
+ * Swing Components Supporting {@code Action} for more
* details, and you can find more information in How
* to Use Actions, a section in The Java Tutorial.
@@ -64,7 +64,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see JRadioButton
@@ -113,7 +113,7 @@
*
* @param icon the Icon image to display
* @param selected a boolean value indicating the initial selection
- * state. If true the check box is selected
+ * state. If {@code true} the check box is selected
*/
public JCheckBox(Icon icon, boolean selected) {
this(null, icon, selected);
@@ -147,7 +147,7 @@
*
* @param text the text of the check box.
* @param selected a boolean value indicating the initial selection
- * state. If true the check box is selected
+ * state. If {@code true} the check box is selected
*/
public JCheckBox (String text, boolean selected) {
this(text, null, selected);
@@ -171,7 +171,7 @@
* @param text the text of the check box.
* @param icon the Icon image to display
* @param selected a boolean value indicating the initial selection
- * state. If true the check box is selected
+ * state. If {@code true} the check box is selected
*/
public JCheckBox (String text, Icon icon, boolean selected) {
super(text, icon, selected);
@@ -180,20 +180,20 @@
}
/**
- * Sets the borderPaintedFlat property,
+ * Sets the {@code borderPaintedFlat} property,
* which gives a hint to the look and feel as to the
* appearance of the check box border.
- * This is usually set to true when a
- * JCheckBox instance is used as a
- * renderer in a component such as a JTable or
- * JTree. The default value for the
- * borderPaintedFlat property is false.
+ * This is usually set to {@code true} when a
+ * {@code JCheckBox} instance is used as a
+ * renderer in a component such as a {@code JTable} or
+ * {@code JTree}. The default value for the
+ * {@code borderPaintedFlat} property is {@code false}.
* This method fires a property changed event.
* Some look and feels might not implement flat borders;
* they will ignore this property.
*
- * @param b true requests that the border be painted flat;
- * false requests normal borders
+ * @param b {@code true} requests that the border be painted flat;
+ * {@code false} requests normal borders
* @see #isBorderPaintedFlat
* @beaninfo
* bound: true
@@ -212,9 +212,9 @@
}
/**
- * Gets the value of the borderPaintedFlat property.
+ * Gets the value of the {@code borderPaintedFlat} property.
*
- * @return the value of the borderPaintedFlat property
+ * @return the value of the {@code borderPaintedFlat} property
* @see #setBorderPaintedFlat
* @since 1.3
*/
@@ -290,7 +290,7 @@
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
* specific new aspects of the JFC components.
*
* @return a string representation of this JCheckBox.
@@ -324,7 +324,7 @@
/**
* This class implements accessibility support for the
- * JCheckBox class. It provides an implementation of the
+ * {@code JCheckBox} class. It provides an implementation of the
* Java Accessibility API appropriate to check box user-interface
* elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
--- old/src/java.desktop/share/classes/javax/swing/JCheckBoxMenuItem.java 2015-10-04 22:56:43.633263374 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JCheckBoxMenuItem.java 2015-10-04 22:56:43.441263382 +0400
@@ -45,19 +45,19 @@
* menu item, a check box menu item can have either text or a graphic
* icon associated with it, or both.
* isSelected/setSelected or
- * getState/setState can be used
+ * Either {@code isSelected}/{@code setSelected} or
+ * {@code getState}/{@code setState} can be used
* to determine/specify the menu item's selection state. The
- * preferred methods are isSelected and
- * setSelected, which work for all menus and buttons.
- * The getState and setState methods exist for
+ * preferred methods are {@code isSelected} and
+ * {@code setSelected}, which work for all menus and buttons.
+ * The {@code getState} and {@code setState} methods exist for
* compatibility with other component sets.
* Actions. Using an
- * Action with a menu item has many benefits beyond directly
+ * {@code Action} with a menu item has many benefits beyond directly
* configuring a menu item. Refer to
- * Swing Components Supporting Action for more
+ * Swing Components Supporting {@code Action} for more
* details, and you can find more information in How
* to Use Actions, a section in The Java Tutorial.
@@ -78,7 +78,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @beaninfo
@@ -245,7 +245,7 @@
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
* @return a string representation of this JCheckBoxMenuItem.
*/
@@ -283,7 +283,7 @@
/**
* This class implements accessibility support for the
- * JCheckBoxMenuItem class. It provides an implementation
+ * {@code JCheckBoxMenuItem} class. It provides an implementation
* of the Java Accessibility API appropriate to checkbox menu item
* user-interface elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
--- old/src/java.desktop/share/classes/javax/swing/JColorChooser.java 2015-10-04 22:56:44.173263349 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JColorChooser.java 2015-10-04 22:56:43.969263358 +0400
@@ -38,7 +38,7 @@
/**
- * JColorChooser provides a pane of controls designed to allow
+ * {@code JColorChooser} provides a pane of controls designed to allow
* a user to manipulate and select a color.
* For information about using color choosers, see
* A static convenience method which shows a modal color-chooser
* dialog and returns the color selected by the user.
* ActionListeners can be specified to be invoked when
+ * where {@code ActionListeners} can be specified to be invoked when
* the user presses one of the dialog buttons.
- * JColorChooser panes
- * directly (within any container). PropertyChange listeners
+ * java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
*
@@ -123,12 +123,12 @@
* this method hides/disposes the dialog and returns the selected color.
* If the user presses the "Cancel" button or closes the dialog without
* pressing "OK", then this method hides/disposes the dialog and returns
- * null.
+ * {@code null}.
*
- * @param component the parent Component for the dialog
+ * @param component the parent {@code Component} for the dialog
* @param title the String containing the dialog's title
* @param initialColor the initial Color set when the color-chooser is shown
- * @return the selected color or null if the user opted out
+ * @return the selected color or {@code null} if the user opted out
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -144,14 +144,14 @@
* this method hides/disposes the dialog and returns the selected color.
* If the user presses the "Cancel" button or closes the dialog without
* pressing "OK", then this method hides/disposes the dialog and returns
- * null.
+ * {@code null}.
*
- * @param component the parent Component for the dialog
+ * @param component the parent {@code Component} for the dialog
* @param title the String containing the dialog's title
* @param initialColor the initial Color set when the color-chooser is shown
* @param colorTransparencySelectionEnabled true if the transparency of
* a color can be selected
- * @return the selected color or null if the user opted out
+ * @return the selected color or {@code null} if the user opted out
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -181,11 +181,11 @@
/**
* Creates and returns a new dialog containing the specified
- * ColorChooser pane along with "OK", "Cancel", and "Reset"
+ * {@code ColorChooser} pane along with "OK", "Cancel", and "Reset"
* buttons. If the "OK" or "Cancel" buttons are pressed, the dialog is
* automatically hidden (but not disposed). If the "Reset"
* button is pressed, the color-chooser's color will be reset to the
- * color which was set the last time show was invoked on the
+ * color which was set the last time {@code show} was invoked on the
* dialog and the dialog will remain showing.
*
* @param c the parent component for the dialog
@@ -236,9 +236,9 @@
/**
* Creates a color chooser pane with the specified
- * ColorSelectionModel.
+ * {@code ColorSelectionModel}.
*
- * @param model the ColorSelectionModel to be used
+ * @param model the {@code ColorSelectionModel} to be used
*/
public JColorChooser(ColorSelectionModel model) {
selectionModel = model;
@@ -249,7 +249,7 @@
/**
* Returns the L&F object that renders this component.
*
- * @return the ColorChooserUI object that renders
+ * @return the {@code ColorChooserUI} object that renders
* this component
*/
public ColorChooserUI getUI() {
@@ -259,7 +259,7 @@
/**
* Sets the L&F object that renders this component.
*
- * @param ui the ColorChooserUI L&F object
+ * @param ui the {@code ColorChooserUI} L&F object
* @see UIDefaults#getUI
*
* @beaninfo
@@ -272,9 +272,9 @@
}
/**
- * Notification from the UIManager that the L&F has changed.
+ * Notification from the {@code UIManager} that the L&F has changed.
* Replaces the current UI object with the latest version from the
- * UIManager.
+ * {@code UIManager}.
*
* @see JComponent#updateUI
*/
@@ -305,7 +305,7 @@
/**
* Sets the current color of the color chooser to the specified color.
- * The ColorSelectionModel will fire a ChangeEvent
+ * The {@code ColorSelectionModel} will fire a {@code ChangeEvent}
* @param color the color to be set in the color chooser
* @see JComponent#addPropertyChangeListener
*
@@ -348,15 +348,15 @@
}
/**
- * Sets the dragEnabled property,
- * which must be true to enable
+ * Sets the {@code dragEnabled} property,
+ * which must be {@code true} to enable
* automatic drag handling (the first part of drag and drop)
* on this component.
- * The transferHandler property needs to be set
- * to a non-null value for the drag to do
- * anything. The default value of the dragEnabled
+ * The {@code transferHandler} property needs to be set
+ * to a non-{@code null} value for the drag to do
+ * anything. The default value of the {@code dragEnabled}
* property
- * is false.
+ * is {@code false}.
*
* exportAsDrag method of a
- * TransferHandler.
+ * to directly call the {@code exportAsDrag} method of a
+ * {@code TransferHandler}.
*
- * @param b the value to set the dragEnabled property to
+ * @param b the value to set the {@code dragEnabled} property to
* @exception HeadlessException if
- * b is true and
- * GraphicsEnvironment.isHeadless()
- * returns true
+ * {@code b} is {@code true} and
+ * {@code GraphicsEnvironment.isHeadless()}
+ * returns {@code true}
*
* @since 1.4
*
@@ -394,9 +394,9 @@
}
/**
- * Gets the value of the dragEnabled property.
+ * Gets the value of the {@code dragEnabled} property.
*
- * @return the value of the dragEnabled property
+ * @return the value of the {@code dragEnabled} property
* @see #setDragEnabled
* @since 1.4
*/
@@ -406,10 +406,10 @@
/**
* Sets the current preview panel.
- * This will fire a PropertyChangeEvent for the property
+ * This will fire a {@code PropertyChangeEvent} for the property
* named "previewPanel".
*
- * @param preview the JComponent which displays the current color
+ * @param preview the {@code JComponent} which displays the current color
* @see JComponent#addPropertyChangeListener
*
* @beaninfo
@@ -429,7 +429,7 @@
/**
* Returns the preview panel that shows a chosen color.
*
- * @return a JComponent object -- the preview panel
+ * @return a {@code JComponent} object -- the preview panel
*/
public JComponent getPreviewPanel() {
return previewPanel;
@@ -438,7 +438,7 @@
/**
* Adds a color chooser panel to the color chooser.
*
- * @param panel the AbstractColorChooserPanel to be added
+ * @param panel the {@code AbstractColorChooserPanel} to be added
*/
public void addChooserPanel( AbstractColorChooserPanel panel ) {
AbstractColorChooserPanel[] oldPanels = getChooserPanels();
@@ -494,7 +494,7 @@
/**
* Specifies the Color Panels used to choose a color value.
*
- * @param panels an array of AbstractColorChooserPanel
+ * @param panels an array of {@code AbstractColorChooserPanel}
* objects
*
* @beaninfo
@@ -511,7 +511,7 @@
/**
* Returns the specified color panels.
*
- * @return an array of AbstractColorChooserPanel objects
+ * @return an array of {@code AbstractColorChooserPanel} objects
*/
public AbstractColorChooserPanel[] getChooserPanels() {
return chooserPanels;
@@ -520,7 +520,7 @@
/**
* Returns the data model that handles color selections.
*
- * @return a ColorSelectionModel object
+ * @return a {@code ColorSelectionModel} object
*/
public ColorSelectionModel getSelectionModel() {
return selectionModel;
@@ -530,7 +530,7 @@
/**
* Sets the model containing the selected color.
*
- * @param newModel the new ColorSelectionModel object
+ * @param newModel the new {@code ColorSelectionModel} object
*
* @beaninfo
* bound: true
@@ -545,8 +545,8 @@
/**
- * See readObject and writeObject in
- * JComponent for more
+ * See {@code readObject} and {@code writeObject} in
+ * {@code JComponent} for more
* information about serialization in Swing.
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -562,14 +562,14 @@
/**
- * Returns a string representation of this JColorChooser.
+ * Returns a string representation of this {@code JColorChooser}.
* This method
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JColorChooser
+ * @return a string representation of this {@code JColorChooser}
*/
protected String paramString() {
StringBuilder chooserPanelsString = new StringBuilder();
@@ -612,7 +612,7 @@
/**
* This class implements accessibility support for the
- * JColorChooser class. It provides an implementation of the
+ * {@code JColorChooser} class. It provides an implementation of the
* Java Accessibility API appropriate to color chooser user-interface
* elements.
*/
--- old/src/java.desktop/share/classes/javax/swing/JComboBox.java 2015-10-04 22:56:44.725263324 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JComboBox.java 2015-10-04 22:56:44.517263334 +0400
@@ -58,7 +58,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* JComboBox that takes its items from an
- * existing ComboBoxModel. Since the
- * ComboBoxModel is provided, a combo box created using
+ * Creates a {@code JComboBox} that takes its items from an
+ * existing {@code ComboBoxModel}. Since the
+ * {@code ComboBoxModel} is provided, a combo box created using
* this constructor does not create a default combo box model and
* may impact how the insert, remove and add methods behave.
*
- * @param aModel the ComboBoxModel that provides the
+ * @param aModel the {@code ComboBoxModel} that provides the
* displayed list of items
* @see DefaultComboBoxModel
*/
@@ -186,7 +186,7 @@
}
/**
- * Creates a JComboBox that contains the elements
+ * Creates a {@code JComboBox} that contains the elements
* in the specified array. By default the first item in the array
* (and therefore the data model) becomes selected.
*
@@ -200,7 +200,7 @@
}
/**
- * Creates a JComboBox that contains the elements
+ * Creates a {@code JComboBox} that contains the elements
* in the specified Vector. By default the first item in the vector
* (and therefore the data model) becomes selected.
*
@@ -214,9 +214,9 @@
}
/**
- * Creates a JComboBox with a default data model.
+ * Creates a {@code JComboBox} with a default data model.
* The default data model is an empty list of objects.
- * Use addItem to add items. By default the first item
+ * Use {@code addItem} to add items. By default the first item
* in the data model becomes selected.
*
* @see DefaultComboBoxModel
@@ -253,7 +253,7 @@
/**
* Sets the L&F object that renders this component.
*
- * @param ui the ComboBoxUI L&F object
+ * @param ui the {@code ComboBoxUI} L&F object
* @see UIDefaults#getUI
*
* @beaninfo
@@ -303,10 +303,10 @@
}
/**
- * Sets the data model that the JComboBox uses to obtain
+ * Sets the data model that the {@code JComboBox} uses to obtain
* the list of items.
*
- * @param aModel the ComboBoxModel that provides the
+ * @param aModel the {@code ComboBoxModel} that provides the
* displayed list of items
*
* @beaninfo
@@ -328,9 +328,9 @@
}
/**
- * Returns the data model currently used by the JComboBox.
+ * Returns the data model currently used by the {@code JComboBox}.
*
- * @return the ComboBoxModel that provides the displayed
+ * @return the {@code ComboBoxModel} that provides the displayed
* list of items
*/
public ComboBoxModellightWeightPopupEnabled property, which
+ * Sets the {@code lightWeightPopupEnabled} property, which
* provides a hint as to whether or not a lightweight
- * Component should be used to contain the
- * JComboBox, versus a heavyweight
- * Component such as a Panel
- * or a Window. The decision of lightweight
+ * {@code Component} should be used to contain the
+ * {@code JComboBox}, versus a heavyweight
+ * {@code Component} such as a {@code Panel}
+ * or a {@code Window}. The decision of lightweight
* versus heavyweight is ultimately up to the
- * JComboBox. Lightweight windows are more
+ * {@code JComboBox}. Lightweight windows are more
* efficient than heavyweight windows, but lightweight
* and heavyweight components do not mix well in a GUI.
* If your application mixes lightweight and heavyweight
* components, you should disable lightweight popups.
- * The default value for the lightWeightPopupEnabled
- * property is true, unless otherwise specified
+ * The default value for the {@code lightWeightPopupEnabled}
+ * property is {@code true}, unless otherwise specified
* by the look and feel. Some look and feels always use
* heavyweight popups, no matter what the value of this property.
* true, lightweight popups are desired
+ * @param aFlag if {@code true}, lightweight popups are desired
*
* @beaninfo
* bound: true
* expert: true
- * description: Set to false to require heavyweight popups.
+ * description: Set to {@code false} to require heavyweight popups.
*/
public void setLightWeightPopupEnabled(boolean aFlag) {
boolean oldFlag = lightWeightPopupEnabled;
@@ -376,10 +376,10 @@
}
/**
- * Gets the value of the lightWeightPopupEnabled
+ * Gets the value of the {@code lightWeightPopupEnabled}
* property.
*
- * @return the value of the lightWeightPopupEnabled
+ * @return the value of the {@code lightWeightPopupEnabled}
* property
* @see #setLightWeightPopupEnabled
*/
@@ -388,11 +388,11 @@
}
/**
- * Determines whether the JComboBox field is editable.
- * An editable JComboBox allows the user to type into the
+ * Determines whether the {@code JComboBox} field is editable.
+ * An editable {@code JComboBox} allows the user to type into the
* field or selected an item from the list to initialize the field,
* after which it can be edited. (The editing affects only the field,
- * the list item remains intact.) A non editable JComboBox
+ * the list item remains intact.) A non editable {@code JComboBox}
* displays the selected item in the field,
* but the selection cannot be modified.
*
@@ -411,17 +411,17 @@
}
/**
- * Returns true if the JComboBox is editable.
+ * Returns true if the {@code JComboBox} is editable.
* By default, a combo box is not editable.
*
- * @return true if the JComboBox is editable, else false
+ * @return true if the {@code JComboBox} is editable, else false
*/
public boolean isEditable() {
return isEditable;
}
/**
- * Sets the maximum number of rows the JComboBox displays.
+ * Sets the maximum number of rows the {@code JComboBox} displays.
* If the number of objects in the model is greater than count,
* the combo box uses a scrollbar.
*
@@ -459,10 +459,10 @@
* Other renderers can handle graphic images and composite items.
* aRenderer.getListCellRendererComponent
+ * {@code aRenderer.getListCellRendererComponent}
* is called, passing the list object and an index of -1.
*
- * @param aRenderer the ListCellRenderer that
+ * @param aRenderer the {@code ListCellRenderer} that
* displays the selected item
* @see #setEditor
* @beaninfo
@@ -479,9 +479,9 @@
/**
* Returns the renderer used to display the selected item in the
- * JComboBox field.
+ * {@code JComboBox} field.
*
- * @return the ListCellRenderer that displays
+ * @return the {@code ListCellRenderer} that displays
* the selected item.
*/
public ListCellRenderer getRenderer() {
@@ -490,11 +490,11 @@
/**
* Sets the editor used to paint and edit the selected item in the
- * JComboBox field. The editor is used only if the
- * receiving JComboBox is editable. If not editable,
+ * {@code JComboBox} field. The editor is used only if the
+ * receiving {@code JComboBox} is editable. If not editable,
* the combo box uses the renderer to paint the selected item.
*
- * @param anEditor the ComboBoxEditor that
+ * @param anEditor the {@code ComboBoxEditor} that
* displays the selected item
* @see #setRenderer
* @beaninfo
@@ -517,9 +517,9 @@
/**
* Returns the editor used to paint and edit the selected item in the
- * JComboBox field.
+ * {@code JComboBox} field.
*
- * @return the ComboBoxEditor that displays the selected item
+ * @return the {@code ComboBoxEditor} that displays the selected item
*/
public ComboBoxEditor getEditor() {
return editor;
@@ -532,26 +532,26 @@
/**
* Sets the selected item in the combo box display area to the object in
* the argument.
- * If anObject is in the list, the display area shows
- * anObject selected.
+ * If {@code anObject} is in the list, the display area shows
+ * {@code anObject} selected.
* anObject is not in the list and the combo box is
+ * If {@code anObject} is not in the list and the combo box is
* uneditable, it will not change the current selection. For editable
- * combo boxes, the selection will change to anObject.
+ * combo boxes, the selection will change to {@code anObject}.
* ItemListeners added to the combo box will be notified with
- * one or two ItemEvents.
- * If there is a current selected item, an ItemEvent will be
- * fired and the state change will be ItemEvent.DESELECTED.
- * If anObject is in the list and is not currently selected
- * then an ItemEvent will be fired and the state change will
- * be ItemEvent.SELECTED.
+ * {@code ItemListener}s added to the combo box will be notified with
+ * one or two {@code ItemEvent}s.
+ * If there is a current selected item, an {@code ItemEvent} will be
+ * fired and the state change will be {@code ItemEvent.DESELECTED}.
+ * If {@code anObject} is in the list and is not currently selected
+ * then an {@code ItemEvent} will be fired and the state change will
+ * be {@code ItemEvent.SELECTED}.
* ActionListeners added to the combo box will be notified
- * with an ActionEvent when this method is called.
+ * {@code ActionListener}s added to the combo box will be notified
+ * with an {@code ActionEvent} when this method is called.
*
- * @param anObject the list object to select; use null to
+ * @param anObject the list object to select; use {@code null} to
clear the selection
* @beaninfo
* preferred: true
@@ -601,7 +601,7 @@
* Returns the current selected item.
* addItem, insertItemAt
+ * to the combo box with {@code addItem}, {@code insertItemAt}
* or the data constructors.
*
* @return the current selected Object
@@ -612,12 +612,12 @@
}
/**
- * Selects the item at index anIndex.
+ * Selects the item at index {@code anIndex}.
*
* @param anIndex an integer specifying the list item to select,
* where 0 specifies the first item in the list and -1 indicates no selection
- * @exception IllegalArgumentException if anIndex < -1 or
- * anIndex is greater than or equal to size
+ * @exception IllegalArgumentException if {@code anIndex < -1} or
+ * {@code anIndex} is greater than or equal to size
* @beaninfo
* preferred: true
* description: The item at index is selected.
@@ -636,7 +636,7 @@
/**
* Returns the first item in the list that matches the given item.
- * The result is not always defined if the JComboBox
+ * The result is not always defined if the {@code JComboBox}
* allows selected items that are not in the list.
* Returns -1 if there is no selected item or if the user specified
* an item which is not in the list.
@@ -665,7 +665,7 @@
* Returns the "prototypical display" value - an Object used
* for the calculation of the display height and width.
*
- * @return the value of the prototypeDisplayValue property
+ * @return the value of the {@code prototypeDisplayValue} property
* @see #setPrototypeDisplayValue
* @since 1.4
*/
@@ -702,7 +702,7 @@
/**
* Adds an item to the item list.
- * This method works only if the JComboBox uses a
+ * This method works only if the {@code JComboBox} uses a
* mutable data model.
* JComboBox uses a
+ * This method works only if the {@code JComboBox} uses a
* mutable data model.
*
* @param item the item to add to the list
@@ -744,7 +744,7 @@
/**
* Removes an item from the item list.
- * This method works only if the JComboBox uses a
+ * This method works only if the {@code JComboBox} uses a
* mutable data model.
*
* @param anObject the object to remove from the item list
@@ -756,8 +756,8 @@
}
/**
- * Removes the item at anIndex
- * This method works only if the JComboBox uses a
+ * Removes the item at {@code anIndex}
+ * This method works only if the {@code JComboBox} uses a
* mutable data model.
*
* @param anIndex an int specifying the index of the item to remove,
@@ -794,10 +794,10 @@
}
/**
- * Checks that the dataModel is an instance of
- * MutableComboBoxModel. If not, it throws an exception.
- * @exception RuntimeException if dataModel is not an
- * instance of MutableComboBoxModel.
+ * Checks that the {@code dataModel} is an instance of
+ * {@code MutableComboBoxModel}. If not, it throws an exception.
+ * @exception RuntimeException if {@code dataModel} is not an
+ * instance of {@code MutableComboBoxModel}.
*/
void checkMutableComboBoxModel() {
if ( !(dataModel instanceof MutableComboBoxModel) )
@@ -841,31 +841,31 @@
/** Selection **/
/**
- * Adds an ItemListener.
+ * Adds an {@code ItemListener}.
* aListener will receive one or two ItemEvents when
+ * {@code aListener} will receive one or two {@code ItemEvent}s when
* the selected item changes.
*
- * @param aListener the ItemListener that is to be notified
+ * @param aListener the {@code ItemListener} that is to be notified
* @see #setSelectedItem
*/
public void addItemListener(ItemListener aListener) {
listenerList.add(ItemListener.class,aListener);
}
- /** Removes an ItemListener.
+ /** Removes an {@code ItemListener}.
*
- * @param aListener the ItemListener to remove
+ * @param aListener the {@code ItemListener} to remove
*/
public void removeItemListener(ItemListener aListener) {
listenerList.remove(ItemListener.class,aListener);
}
/**
- * Returns an array of all the ItemListeners added
+ * Returns an array of all the {@code ItemListener}s added
* to this JComboBox with addItemListener().
*
- * @return all of the ItemListeners added or an empty
+ * @return all of the {@code ItemListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -874,22 +874,22 @@
}
/**
- * Adds an ActionListener.
+ * Adds an {@code ActionListener}.
* ActionListener will receive an ActionEvent
+ * The {@code ActionListener} will receive an {@code ActionEvent}
* when a selection has been made. If the combo box is editable, then
- * an ActionEvent will be fired when editing has stopped.
+ * an {@code ActionEvent} will be fired when editing has stopped.
*
- * @param l the ActionListener that is to be notified
+ * @param l the {@code ActionListener} that is to be notified
* @see #setSelectedItem
*/
public void addActionListener(ActionListener l) {
listenerList.add(ActionListener.class,l);
}
- /** Removes an ActionListener.
+ /** Removes an {@code ActionListener}.
*
- * @param l the ActionListener to remove
+ * @param l the {@code ActionListener} to remove
*/
public void removeActionListener(ActionListener l) {
if ((l != null) && (getAction() == l)) {
@@ -900,10 +900,10 @@
}
/**
- * Returns an array of all the ActionListeners added
+ * Returns an array of all the {@code ActionListener}s added
* to this JComboBox with addActionListener().
*
- * @return all of the ActionListeners added or an empty
+ * @return all of the {@code ActionListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -912,15 +912,15 @@
}
/**
- * Adds a PopupMenu listener which will listen to notification
+ * Adds a {@code PopupMenu} listener which will listen to notification
* messages from the popup portion of the combo box.
* JPopupMenu.
+ * portion of combo box is implemented as a {@code JPopupMenu}.
* A custom look and feel may not implement it this way and will
* therefore not receive the notification.
*
- * @param l the PopupMenuListener to add
+ * @param l the {@code PopupMenuListener} to add
* @since 1.4
*/
public void addPopupMenuListener(PopupMenuListener l) {
@@ -928,9 +928,9 @@
}
/**
- * Removes a PopupMenuListener.
+ * Removes a {@code PopupMenuListener}.
*
- * @param l the PopupMenuListener to remove
+ * @param l the {@code PopupMenuListener} to remove
* @see #addPopupMenuListener
* @since 1.4
*/
@@ -939,10 +939,10 @@
}
/**
- * Returns an array of all the PopupMenuListeners added
+ * Returns an array of all the {@code PopupMenuListener}s added
* to this JComboBox with addPopupMenuListener().
*
- * @return all of the PopupMenuListeners added or an empty
+ * @return all of the {@code PopupMenuListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -951,7 +951,7 @@
}
/**
- * Notifies PopupMenuListeners that the popup portion of the
+ * Notifies {@code PopupMenuListener}s that the popup portion of the
* combo box will become visible.
* PopupMenuListeners that the popup portion of the
+ * Notifies {@code PopupMenuListener}s that the popup portion of the
* combo box has become invisible.
* PopupMenuListeners that the popup portion of the
+ * Notifies {@code PopupMenuListener}s that the popup portion of the
* combo box has been canceled.
* Action for the ActionEvent source.
- * The new Action replaces any previously set
- * Action but does not affect ActionListeners
- * independently added with addActionListener.
- * If the Action is already a registered
- * ActionListener for the ActionEvent source,
+ * Sets the {@code Action} for the {@code ActionEvent} source.
+ * The new {@code Action} replaces any previously set
+ * {@code Action} but does not affect {@code ActionListeners}
+ * independently added with {@code addActionListener}.
+ * If the {@code Action} is already a registered
+ * {@code ActionListener} for the {@code ActionEvent} source,
* it is not re-registered.
* Action results in immediately changing
+ * Setting the {@code Action} results in immediately changing
* all the properties described in
- * Swing Components Supporting Action.
+ * Swing Components Supporting {@code Action}Action's properties change.
+ * as the {@code Action}'s properties change.
* Action's property values.
- * It uses the configurePropertiesFromAction method
+ * and help track the {@code Action}'s property values.
+ * It uses the {@code configurePropertiesFromAction} method
* to immediately change the combobox's properties.
- * To track changes in the Action's property values,
- * this method registers the PropertyChangeListener
- * returned by createActionPropertyChangeListener. The
+ * To track changes in the {@code Action}'s property values,
+ * this method registers the {@code PropertyChangeListener}
+ * returned by {@code createActionPropertyChangeListener}. The
* default {@code PropertyChangeListener} invokes the
* {@code actionPropertyChanged} method when a property in the
* {@code Action} changes.
*
- * @param a the Action for the JComboBox,
- * or null.
+ * @param a the {@code Action} for the {@code JComboBox},
+ * or {@code null}.
* @since 1.3
* @see Action
* @see #getAction
@@ -1114,12 +1114,12 @@
}
/**
- * Returns the currently set Action for this
- * ActionEvent source, or null if no
- * Action is set.
+ * Returns the currently set {@code Action} for this
+ * {@code ActionEvent} source, or {@code null} if no
+ * {@code Action} is set.
*
- * @return the Action for this ActionEvent
- * source; or null
+ * @return the {@code Action} for this {@code ActionEvent}
+ * source; or {@code null}
* @since 1.3
* @see Action
* @see #setAction
@@ -1130,12 +1130,12 @@
/**
* Sets the properties on this combobox to match those in the specified
- * Action. Refer to
- * Swing Components Supporting Action for more
+ * {@code Action}. Refer to
+ * Swing Components Supporting {@code Action} for more
* details as to which properties this sets.
*
- * @param a the Action from which to get the properties,
- * or null
+ * @param a the {@code Action} from which to get the properties,
+ * or {@code null}
* @since 1.3
* @see Action
* @see #setAction
@@ -1147,13 +1147,13 @@
}
/**
- * Creates and returns a PropertyChangeListener that is
+ * Creates and returns a {@code PropertyChangeListener} that is
* responsible for listening for changes from the specified
- * Action and updating the appropriate properties.
+ * {@code Action} and updating the appropriate properties.
* Action.
+ * that of the {@code Action}.
*
* @param a the combobox's action
* @return the {@code PropertyChangeListener}
@@ -1175,10 +1175,10 @@
* {@code configurePropertiesFromAction}.
* Action for a list of
+ * Swing Components Supporting {@code Action} for a list of
* the properties this method sets.
*
- * @param action the Action associated with this combobox
+ * @param action the {@code Action} associated with this combobox
* @param propertyName the name of the property that changed
* @since 1.6
* @see Action
@@ -1300,9 +1300,9 @@
/**
* Returns an array containing the selected item.
* This method is implemented for compatibility with
- * ItemSelectable.
+ * {@code ItemSelectable}.
*
- * @return an array of Objects containing one
+ * @return an array of {@code Objects} containing one
* element -- the selected item
*/
public Object[] getSelectedObjects() {
@@ -1407,7 +1407,7 @@
/**
* Initializes the editor with the specified item.
*
- * @param anEditor the ComboBoxEditor that displays
+ * @param anEditor the {@code ComboBoxEditor} that displays
* the list item in the
* combo box field and allows it to be edited
* @param anItem the object to display and edit in the field
@@ -1417,10 +1417,10 @@
}
/**
- * Handles KeyEvents, looking for the Tab key.
+ * Handles {@code KeyEvent}s, looking for the Tab key.
* If the Tab key is found, the popup window is closed.
*
- * @param e the KeyEvent containing the keyboard
+ * @param e the {@code KeyEvent} containing the keyboard
* key that was pressed
*/
public void processKeyEvent(KeyEvent e) {
@@ -1469,7 +1469,7 @@
/**
* Returns the list's key-selection manager.
*
- * @return the KeySelectionManager currently in use
+ * @return the {@code KeySelectionManager} currently in use
*/
public KeySelectionManager getKeySelectionManager() {
return keySelectionManager;
@@ -1486,14 +1486,14 @@
}
/**
- * Returns the list item at the specified index. If index
+ * Returns the list item at the specified index. If {@code index}
* is out of range (less than zero or greater than or equal to size)
- * it will return null.
+ * it will return {@code null}.
*
* @param index an integer indicating the list position, where the first
* item starts at zero
* @return the item at that list position; or
- * null if out of range
+ * {@code null} if out of range
*/
public E getItemAt(int index) {
return dataModel.getElementAt(index);
@@ -1502,7 +1502,7 @@
/**
* Returns an instance of the default key-selection manager.
*
- * @return the KeySelectionManager currently used by the list
+ * @return the {@code KeySelectionManager} currently used by the list
* @see #setKeySelectionManager
*/
protected KeySelectionManager createDefaultKeySelectionManager() {
@@ -1511,14 +1511,14 @@
/**
- * The interface that defines a KeySelectionManager.
- * To qualify as a KeySelectionManager,
+ * The interface that defines a {@code KeySelectionManager}.
+ * To qualify as a {@code KeySelectionManager},
* the class needs to implement the method
* that identifies the list index given a character and the
* combo box data model.
*/
public interface KeySelectionManager {
- /** Given aKey and the model, returns the row
+ /** Given {@code aKey} and the model, returns the row
* that should become selected. Return -1 if no match was
* found.
*
@@ -1575,8 +1575,8 @@
/**
- * See readObject and writeObject in
- * JComponent for more
+ * See {@code readObject} and {@code writeObject} in
+ * {@code JComponent} for more
* information about serialization in Swing.
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -1592,13 +1592,13 @@
/**
- * Returns a string representation of this JComboBox.
+ * Returns a string representation of this {@code JComboBox}.
* This method is intended to be used only for debugging purposes,
* and the content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JComboBox
+ * @return a string representation of this {@code JComboBox}
*/
protected String paramString() {
String selectedItemReminderString = (selectedItemReminder != null ?
@@ -1638,7 +1638,7 @@
/**
* This class implements accessibility support for the
- * JComboBox class. It provides an implementation of the
+ * {@code JComboBox} class. It provides an implementation of the
* Java Accessibility API appropriate to Combo Box user-interface elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
--- old/src/java.desktop/share/classes/javax/swing/JComponent.java 2015-10-04 22:56:45.313263298 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JComponent.java 2015-10-04 22:56:45.109263307 +0400
@@ -64,12 +64,12 @@
/**
* The base class for all Swing components except top-level containers.
- * To use a component that inherits from JComponent,
+ * To use a component that inherits from {@code JComponent},
* you must place the component in a containment hierarchy
* whose root is a top-level Swing container.
* Top-level Swing containers --
- * such as JFrame, JDialog,
- * and JApplet --
+ * such as {@code JFrame}, {@code JDialog},
+ * and {@code JApplet} --
* are specialized components
* that provide a place for other Swing components to paint themselves.
* For an explanation of containment hierarchies, see
@@ -78,7 +78,7 @@
* a section in The Java Tutorial.
*
* JComponent class provides:
+ * The {@code JComponent} class provides:
*
*
- * JComponent contains all of the methods in the
- * Accessible interface,
+ * {@code JComponent} contains all of the methods in the
+ * {@code Accessible} interface,
* but it doesn't actually implement the interface. That is the
* responsibility of the individual classes
- * that extend JComponent.
+ * that extend {@code JComponent}.
* JComponent.
+ * with any object that descends from {@code JComponent}.
* JComponent and its subclasses document default values
- * for certain properties. For example, JTable documents the
- * default row height as 16. Each JComponent subclass
- * that has a ComponentUI will create the
- * ComponentUI as part of its constructor. In order
+ * {@code JComponent} and its subclasses document default values
+ * for certain properties. For example, {@code JTable} documents the
+ * default row height as 16. Each {@code JComponent} subclass
+ * that has a {@code ComponentUI} will create the
+ * {@code ComponentUI} as part of its constructor. In order
* to provide a particular look and feel each
- * ComponentUI may set properties back on the
- * JComponent that created it. For example, a custom
- * look and feel may require JTables to have a row
+ * {@code ComponentUI} may set properties back on the
+ * {@code JComponent} that created it. For example, a custom
+ * look and feel may require {@code JTable}s to have a row
* height of 24. The documented defaults are the value of a property
- * BEFORE the ComponentUI has been installed. If you
+ * BEFORE the {@code ComponentUI} has been installed. If you
* need a specific value for a particular property you should
* explicitly set it.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see KeyStroke
@@ -256,23 +256,23 @@
private boolean verifyInputWhenFocusTarget = true;
/**
- * Set in _paintImmediately.
+ * Set in {@code _paintImmediately}.
* Will indicate the child that initiated the painting operation.
- * If paintingChild is opaque, no need to paint
- * any child components after paintingChild.
- * Test used in paintChildren.
+ * If {@code paintingChild} is opaque, no need to paint
+ * any child components after {@code paintingChild}.
+ * Test used in {@code paintChildren}.
*/
transient Component paintingChild;
/**
- * Constant used for registerKeyboardAction that
+ * Constant used for {@code registerKeyboardAction} that
* means that the command should be invoked when
* the component has the focus.
*/
public static final int WHEN_FOCUSED = 0;
/**
- * Constant used for registerKeyboardAction that
+ * Constant used for {@code registerKeyboardAction} that
* means that the command should be invoked when the receiving
* component is an ancestor of the focused component or is
* itself the focused component.
@@ -280,7 +280,7 @@
public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT = 1;
/**
- * Constant used for registerKeyboardAction that
+ * Constant used for {@code registerKeyboardAction} that
* means that the command should be invoked when
* the receiving component is in the window that has the focus
* or is itself the focused component.
@@ -293,13 +293,13 @@
public static final int UNDEFINED_CONDITION = -1;
/**
- * The key used by JComponent to access keyboard bindings.
+ * The key used by {@code JComponent} to access keyboard bindings.
*/
private static final String KEYBOARD_BINDINGS_KEY = "_KeyboardBindings";
/**
- * An array of KeyStrokes used for
- * WHEN_IN_FOCUSED_WINDOW are stashed
+ * An array of {@code KeyStroke}s used for
+ * {@code WHEN_IN_FOCUSED_WINDOW} are stashed
* in the client properties under this string.
*/
private static final String WHEN_IN_FOCUSED_WINDOW_BINDINGS = "_WhenInFocusedWindow";
@@ -313,7 +313,7 @@
private static final String NEXT_FOCUS = "nextFocus";
/**
- * JPopupMenu assigned to this component
+ * {@code JPopupMenu} assigned to this component
* and all of its children
*/
private JPopupMenu popupMenu;
@@ -357,11 +357,11 @@
*/
private static java.util.ListWHEN_FOCUSED bindings. */
+ /** Used for {@code WHEN_FOCUSED} bindings. */
private InputMap focusInputMap;
- /** Used for WHEN_ANCESTOR_OF_FOCUSED_COMPONENT bindings. */
+ /** Used for {@code WHEN_ANCESTOR_OF_FOCUSED_COMPONENT} bindings. */
private InputMap ancestorInputMap;
- /** Used for WHEN_IN_FOCUSED_KEY bindings. */
+ /** Used for {@code WHEN_IN_FOCUSED_KEY} bindings. */
private ComponentInputMap windowInputMap;
/** ActionMap. */
@@ -414,7 +414,7 @@
}
/**
- * Returns the Set of KeyStrokes to use if the component
+ * Returns the Set of {@code KeyStroke}s to use if the component
* is managing focus for forward focus traversal.
*/
static SetKeyStrokes to use if the component
+ * Returns the Set of {@code KeyStroke}s to use if the component
* is managing focus for backward focus traversal.
*/
static SetgetComponentPopupMenu should delegate
- * to the parent if this component does not have a JPopupMenu
+ * Sets whether or not {@code getComponentPopupMenu} should delegate
+ * to the parent if this component does not have a {@code JPopupMenu}
* assigned to it.
* JComponent
- * subclasses that are implemented as a number of JComponents
+ * The default value for this is false, but some {@code JComponent}
+ * subclasses that are implemented as a number of {@code JComponent}s
* may set this to true.
* JPopupMenu for this JComponent.
+ * Sets the {@code JPopupMenu} for this {@code JComponent}.
* The UI is responsible for registering bindings and adding the necessary
- * listeners such that the JPopupMenu will be shown at
- * the appropriate time. When the JPopupMenu is shown
+ * listeners such that the {@code JPopupMenu} will be shown at
+ * the appropriate time. When the {@code JPopupMenu} is shown
* depends upon the look and feel: some may show it on a mouse event,
* some may enable a key binding.
* popup is null, and getInheritsPopupMenu
- * returns true, then getComponentPopupMenu will be delegated
+ * If {@code popup} is null, and {@code getInheritsPopupMenu}
+ * returns true, then {@code getComponentPopupMenu} will be delegated
* to the parent. This provides for a way to make all child components
* inherit the popupmenu of the parent.
* JPopupMenu that assigned for this component.
- * If this component does not have a JPopupMenu assigned
- * to it and getInheritsPopupMenu is true, this
- * will return getParent().getComponentPopupMenu() (assuming
+ * Returns {@code JPopupMenu} that assigned for this component.
+ * If this component does not have a {@code JPopupMenu} assigned
+ * to it and {@code getInheritsPopupMenu} is true, this
+ * will return {@code getParent().getComponentPopupMenu()} (assuming
* the parent is valid.)
*
- * @return JPopupMenu assigned for this component
- * or null if no popup assigned
+ * @return {@code JPopupMenu} assigned for this component
+ * or {@code null} if no popup assigned
* @see #setComponentPopupMenu
* @since 1.5
*/
@@ -573,12 +573,12 @@
}
/**
- * Default JComponent constructor. This constructor does
- * very little initialization beyond calling the Container
+ * Default {@code JComponent} constructor. This constructor does
+ * very little initialization beyond calling the {@code Container}
* constructor. For example, the initial layout manager is
- * null. It does, however, set the component's locale
+ * {@code null}. It does, however, set the component's locale
* property to the value returned by
- * JComponent.getDefaultLocale.
+ * {@code JComponent.getDefaultLocale}.
*
* @see #getDefaultLocale
*/
@@ -603,7 +603,7 @@
/**
* Resets the UI property to a value from the current look and feel.
- * JComponent subclasses must override this method
+ * {@code JComponent} subclasses must override this method
* like this:
*
* public void updateUI() {
@@ -629,16 +629,16 @@
/**
* Sets the look and feel delegate for this component.
- * JComponent subclasses generally override this method
- * to narrow the argument type. For example, in JSlider:
+ * {@code JComponent} subclasses generally override this method
+ * to narrow the argument type. For example, in {@code JSlider}:
*
* public void setUI(SliderUI newUI) {
* super.setUI(newUI);
* }
*
* JComponent subclasses must provide a
- * getUI method that returns the correct type. For example:
+ * Additionally {@code JComponent} subclasses must provide a
+ * {@code getUI} method that returns the correct type. For example:
*
* public SliderUI getUI() {
* return (SliderUI)ui;
@@ -706,17 +706,17 @@
}
/**
- * Returns the UIDefaults key used to
- * look up the name of the swing.plaf.ComponentUI
+ * Returns the {@code UIDefaults} key used to
+ * look up the name of the {@code swing.plaf.ComponentUI}
* class that defines the look and feel
* for this component. Most applications will never need to
- * call this method. Subclasses of JComponent that support
+ * call this method. Subclasses of {@code JComponent} that support
* pluggable look and feel should override this method to
- * return a UIDefaults key that maps to the
- * ComponentUI subclass that defines their look and feel.
+ * return a {@code UIDefaults} key that maps to the
+ * {@code ComponentUI} subclass that defines their look and feel.
*
- * @return the UIDefaults key for a
- * ComponentUI subclass
+ * @return the {@code UIDefaults} key for a
+ * {@code ComponentUI} subclass
* @see UIDefaults#getUI
* @beaninfo
* expert: true
@@ -729,13 +729,13 @@
/**
* Returns the graphics object used to paint this component.
- * If DebugGraphics is turned on we create a new
- * DebugGraphics object if necessary.
+ * If {@code DebugGraphics} is turned on we create a new
+ * {@code DebugGraphics} object if necessary.
* Otherwise we just configure the
* specified graphics object's foreground and font.
*
- * @param g the original Graphics object
- * @return a Graphics object configured for this component
+ * @param g the original {@code Graphics} object
+ * @return a {@code Graphics} object configured for this component
*/
protected Graphics getComponentGraphics(Graphics g) {
Graphics componentGraphics = g;
@@ -755,30 +755,30 @@
/**
* Calls the UI delegate's paint method, if the UI delegate
- * is non-null. We pass the delegate a copy of the
- * Graphics object to protect the rest of the
+ * is non-{@code null}. We pass the delegate a copy of the
+ * {@code Graphics} object to protect the rest of the
* paint code from irrevocable changes
- * (for example, Graphics.translate).
+ * (for example, {@code Graphics.translate}).
* Graphics. For example, you
- * should not alter the clip Rectangle or modify the
+ * changes to the passed in {@code Graphics}. For example, you
+ * should not alter the clip {@code Rectangle} or modify the
* transform. If you need to do these operations you may find it
- * easier to create a new Graphics from the passed in
- * Graphics and manipulate it. Further, if you do not
+ * easier to create a new {@code Graphics} from the passed in
+ * {@code Graphics} and manipulate it. Further, if you do not
* invoker super's implementation you must honor the opaque property,
* that is
* if this component is opaque, you must completely fill in the background
* in a non-opaque color. If you do not honor the opaque property you
* will likely see visual artifacts.
* Graphics object might
+ * The passed in {@code Graphics} object might
* have a transform other than the identify transform
* installed on it. In this case, you might get
* unexpected results if you cumulatively apply
* another transform.
*
- * @param g the Graphics object to protect
+ * @param g the {@code Graphics} object to protect
* @see #paint
* @see ComponentUI
*/
@@ -796,12 +796,12 @@
/**
* Paints this component's children.
- * If shouldUseBuffer is true,
+ * If {@code shouldUseBuffer} is true,
* no component ancestor has a buffer and
* the component children can use a buffer if they have one.
* Otherwise, one ancestor has a buffer currently in use and children
* should not use a buffer to paint.
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #paint
* @see java.awt.Container#paint
*/
@@ -941,13 +941,13 @@
* Paints the component's border.
* Graphics. For example, you
- * should not alter the clip Rectangle or modify the
+ * changes to the passed in {@code Graphics}. For example, you
+ * should not alter the clip {@code Rectangle} or modify the
* transform. If you need to do these operations you may find it
- * easier to create a new Graphics from the passed in
- * Graphics and manipulate it.
+ * easier to create a new {@code Graphics} from the passed in
+ * {@code Graphics} and manipulate it.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
*
* @see #paint
* @see #setBorder
@@ -961,11 +961,11 @@
/**
- * Calls paint. Doesn't clear the background but see
- * ComponentUI.update, which is called by
- * paintComponent.
+ * Calls {@code paint}. Doesn't clear the background but see
+ * {@code ComponentUI.update}, which is called by
+ * {@code paintComponent}.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #paint
* @see #paintComponent
* @see javax.swing.plaf.ComponentUI
@@ -977,23 +977,23 @@
/**
* Invoked by Swing to draw components.
- * Applications should not invoke paint directly,
- * but should instead use the repaint method to
+ * Applications should not invoke {@code paint} directly,
+ * but should instead use the {@code repaint} method to
* schedule the component for redrawing.
* paintComponent,
- * paintBorder,
- * and paintChildren. They're called in the order
+ * protected methods: {@code paintComponent},
+ * {@code paintBorder},
+ * and {@code paintChildren}. They're called in the order
* listed to ensure that children appear on top of component itself.
* Generally speaking, the component and its children should not
* paint in the insets area allocated to the border. Subclasses can
* just override this method, as always. A subclass that just
* wants to specialize the UI (look and feel) delegate's
- * paint method should just override
- * paintComponent.
+ * {@code paint} method should just override
+ * {@code paintComponent}.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #paintComponent
* @see #paintBorder
* @see #paintChildren
@@ -1143,9 +1143,9 @@
/**
* Invoke this method to print the component. This method invokes
- * print on the component.
+ * {@code print} on the component.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #print
* @see #printComponent
* @see #printBorder
@@ -1163,9 +1163,9 @@
/**
* Invoke this method to print the component to the specified
- * Graphics. This method will result in invocations
- * of printComponent, printBorder and
- * printChildren. It is recommended that you override
+ * {@code Graphics}. This method will result in invocations
+ * of {@code printComponent}, {@code printBorder} and
+ * {@code printChildren}. It is recommended that you override
* one of the previously mentioned methods rather than this one if
* your intention is to customize the way printing looks. However,
* it can be useful to override this method should you want to prepare
@@ -1188,17 +1188,17 @@
* isPaintingForPrint method provides
+ * midst of a print operation. The {@code isPaintingForPrint} method provides
* this ability and its return value will be changed by this method: to
- * true immediately before rendering and to false
+ * {@code true} immediately before rendering and to {@code false}
* immediately after. With each change a property change event is fired on
- * this component with the name "paintingForPrint".
+ * this component with the name {@code "paintingForPrint"}.
* Graphics.
+ * {@code Graphics}.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #printComponent
* @see #printBorder
* @see #printChildren
@@ -1218,10 +1218,10 @@
/**
* This is invoked during a printing operation. This is implemented to
- * invoke paintComponent on the component. Override this
+ * invoke {@code paintComponent} on the component. Override this
* if you wish to add special painting behavior when printing.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #print
* @since 1.3
*/
@@ -1231,10 +1231,10 @@
/**
* Prints this component's children. This is implemented to invoke
- * paintChildren on the component. Override this if you
+ * {@code paintChildren} on the component. Override this if you
* wish to print the children differently than painting.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #print
* @since 1.3
*/
@@ -1244,10 +1244,10 @@
/**
* Prints the component's border. This is implemented to invoke
- * paintBorder on the component. Override this if you
+ * {@code paintBorder} on the component. Override this if you
* wish to print the border differently that it is painted.
*
- * @param g the Graphics context in which to paint
+ * @param g the {@code Graphics} context in which to paint
* @see #print
* @since 1.3
*/
@@ -1270,14 +1270,14 @@
}
/**
- * Returns true if the current painting operation on this
- * component is part of a print operation. This method is
+ * Returns {@code true} if the current painting operation on this
+ * component is part of a {@code print} operation. This method is
* useful when you want to customize what you print versus what you show
* on the screen.
* "paintingForPrint".
+ * {@code "paintingForPrint"}.
* true when, and only
+ * case, the return value of this method is {@code true} when, and only
* when, the table is being painted as part of the printing process.
*
* @return true if the current painting operation on this component
@@ -1306,17 +1306,17 @@
* How to Use the Focus Subsystem,
* a section in The Java Tutorial.
* JComponent's focus traversal keys to
+ * Changes this {@code JComponent}'s focus traversal keys to
* CTRL+TAB and CTRL+SHIFT+TAB. Also prevents
- * SortingFocusTraversalPolicy from considering descendants
+ * {@code SortingFocusTraversalPolicy} from considering descendants
* of this JComponent when computing a focus traversal cycle.
*
* @return false
* @see java.awt.Component#setFocusTraversalKeys
* @see SortingFocusTraversalPolicy
* @deprecated As of 1.4, replaced by
- * Component.setFocusTraversalKeys(int, Set) and
- * Container.setFocusCycleRoot(boolean).
+ * {@code Component.setFocusTraversalKeys(int, Set)} and
+ * {@code Container.setFocusCycleRoot(boolean)}.
*/
@Deprecated
public boolean isManagingFocus() {
@@ -1369,19 +1369,19 @@
* How to Use the Focus Subsystem,
* a section in The Java Tutorial.
* FocusTraversalPolicy for this
- * JComponent's focus traversal cycle by unconditionally
- * setting the specified Component as the next
- * Component in the cycle, and this JComponent
- * as the specified Component's previous
- * Component in the cycle.
+ * Overrides the default {@code FocusTraversalPolicy} for this
+ * {@code JComponent}'s focus traversal cycle by unconditionally
+ * setting the specified {@code Component} as the next
+ * {@code Component} in the cycle, and this {@code JComponent}
+ * as the specified {@code Component}'s previous
+ * {@code Component} in the cycle.
*
- * @param aComponent the Component that should follow this
- * JComponent in the focus traversal cycle
+ * @param aComponent the {@code Component} that should follow this
+ * {@code JComponent} in the focus traversal cycle
*
* @see #getNextFocusableComponent
* @see java.awt.FocusTraversalPolicy
- * @deprecated As of 1.4, replaced by FocusTraversalPolicy
+ * @deprecated As of 1.4, replaced by {@code FocusTraversalPolicy}
*/
@Deprecated
public void setNextFocusableComponent(Component aComponent) {
@@ -1402,16 +1402,16 @@
* How to Use the Focus Subsystem,
* a section in The Java Tutorial.
* Component set by a prior call to
- * setNextFocusableComponent(Component) on this
- * JComponent.
- *
- * @return the Component that will follow this
- * JComponent in the focus traversal cycle, or
- * null if none has been explicitly specified
+ * Returns the {@code Component} set by a prior call to
+ * {@code setNextFocusableComponent(Component)} on this
+ * {@code JComponent}.
+ *
+ * @return the {@code Component} that will follow this
+ * {@code JComponent} in the focus traversal cycle, or
+ * {@code null} if none has been explicitly specified
*
* @see #setNextFocusableComponent
- * @deprecated As of 1.4, replaced by FocusTraversalPolicy.
+ * @deprecated As of 1.4, replaced by {@code FocusTraversalPolicy}.
*/
@Deprecated
public Component getNextFocusableComponent() {
@@ -1419,16 +1419,16 @@
}
/**
- * Provides a hint as to whether or not this JComponent
+ * Provides a hint as to whether or not this {@code JComponent}
* should get focus. This is only a hint, and it is up to consumers that
* are requesting focus to honor this property. This is typically honored
* for mouse operations, but not keyboard operations. For example, look
* and feels could verify this property is true before requesting focus
* during a mouse operation. This would often times be used if you did
- * not want a mouse press on a JComponent to steal focus,
- * but did want the JComponent to be traversable via the
- * keyboard. If you do not want this JComponent focusable at
- * all, use the setFocusable method instead.
+ * not want a mouse press on a {@code JComponent} to steal focus,
+ * but did want the {@code JComponent} to be traversable via the
+ * keyboard. If you do not want this {@code JComponent} focusable at
+ * all, use the {@code setFocusable} method instead.
* JComponent to be focusable or not
+ * {@code JComponent} to be focusable or not
* @see Focus Specification
* @see java.awt.Component#setFocusable
*/
@@ -1446,8 +1446,8 @@
}
/**
- * Returns true if this JComponent should
- * get focus; otherwise returns false.
+ * Returns {@code true} if this {@code JComponent} should
+ * get focus; otherwise returns {@code false}.
* true if this component should get focus,
- * otherwise returns false
+ * @return {@code true} if this component should get focus,
+ * otherwise returns {@code false}
* @see #setRequestFocusEnabled
* @see Focus
* Specification
@@ -1467,7 +1467,7 @@
}
/**
- * Requests that this Component gets the input focus.
+ * Requests that this {@code Component} gets the input focus.
* Refer to {@link java.awt.Component#requestFocus()
* Component.requestFocus()} for a complete description of
* this method.
@@ -1489,7 +1489,7 @@
}
/**
- * Requests that this Component gets the input focus.
+ * Requests that this {@code Component} gets the input focus.
* Refer to {@link java.awt.Component#requestFocus(boolean)
* Component.requestFocus(boolean)} for a complete description of
* this method.
@@ -1504,8 +1504,8 @@
* a section in The Java Tutorial.
*
* @param temporary boolean indicating if the focus change is temporary
- * @return false if the focus change request is guaranteed to
- * fail; true if it is likely to succeed
+ * @return {@code false} if the focus change request is guaranteed to
+ * fail; {@code true} if it is likely to succeed
* @see java.awt.Component#requestFocusInWindow()
* @see java.awt.Component#requestFocusInWindow(boolean)
* @since 1.4
@@ -1515,7 +1515,7 @@
}
/**
- * Requests that this Component gets the input focus.
+ * Requests that this {@code Component} gets the input focus.
* Refer to {@link java.awt.Component#requestFocusInWindow()
* Component.requestFocusInWindow()} for a complete description of
* this method.
@@ -1525,8 +1525,8 @@
* How to Use the Focus Subsystem,
* a section in The Java Tutorial.
*
- * @return false if the focus change request is guaranteed to
- * fail; true if it is likely to succeed
+ * @return {@code false} if the focus change request is guaranteed to
+ * fail; {@code true} if it is likely to succeed
* @see java.awt.Component#requestFocusInWindow()
* @see java.awt.Component#requestFocusInWindow(boolean)
* @since 1.4
@@ -1536,7 +1536,7 @@
}
/**
- * Requests that this Component gets the input focus.
+ * Requests that this {@code Component} gets the input focus.
* Refer to {@link java.awt.Component#requestFocusInWindow(boolean)
* Component.requestFocusInWindow(boolean)} for a complete description of
* this method.
@@ -1547,8 +1547,8 @@
* a section in The Java Tutorial.
*
* @param temporary boolean indicating if the focus change is temporary
- * @return false if the focus change request is guaranteed to
- * fail; true if it is likely to succeed
+ * @return {@code false} if the focus change request is guaranteed to
+ * fail; {@code true} if it is likely to succeed
* @see java.awt.Component#requestFocusInWindow()
* @see java.awt.Component#requestFocusInWindow(boolean)
* @since 1.4
@@ -1565,7 +1565,7 @@
* requestFocusInWindow().
+ * {@code requestFocusInWindow()}.
*
* @see #requestFocusInWindow()
*/
@@ -1582,7 +1582,7 @@
* verifier for that component.
*
* @param verifyInputWhenFocusTarget value for the
- * verifyInputWhenFocusTarget property
+ * {@code verifyInputWhenFocusTarget} property
* @see InputVerifier
* @see #setInputVerifier
* @see #getInputVerifier
@@ -1609,7 +1609,7 @@
* current focus owner will be called before this component requests
* focus.
*
- * @return value of the verifyInputWhenFocusTarget property
+ * @return value of the {@code verifyInputWhenFocusTarget} property
*
* @see InputVerifier
* @see #setInputVerifier
@@ -1624,12 +1624,12 @@
/**
- * Gets the FontMetrics for the specified Font.
+ * Gets the {@code FontMetrics} for the specified {@code Font}.
*
* @param font the font for which font metrics is to be
* obtained
- * @return the font metrics for font
- * @throws NullPointerException if font is null
+ * @return the font metrics for {@code font}
+ * @throws NullPointerException if {@code font} is null
* @since 1.5
*/
public FontMetrics getFontMetrics(Font font) {
@@ -1639,7 +1639,7 @@
/**
* Sets the preferred size of this component.
- * If preferredSize is null, the UI will
+ * If {@code preferredSize} is {@code null}, the UI will
* be asked for the preferred size.
* @beaninfo
* preferred: true
@@ -1652,13 +1652,13 @@
/**
- * If the preferredSize has been set to a
- * non-null value just returns it.
- * If the UI delegate's getPreferredSize
- * method returns a non null value then return that;
+ * If the {@code preferredSize} has been set to a
+ * non-{@code null} value just returns it.
+ * If the UI delegate's {@code getPreferredSize}
+ * method returns a non {@code null} value then return that;
* otherwise defer to the component's layout manager.
*
- * @return the value of the preferredSize property
+ * @return the value of the {@code preferredSize} property
* @see #setPreferredSize
* @see ComponentUI
*/
@@ -1677,12 +1677,12 @@
/**
* Sets the maximum size of this component to a constant
- * value. Subsequent calls to getMaximumSize will always
+ * value. Subsequent calls to {@code getMaximumSize} will always
* return this value; the component's UI will not be asked
- * to compute it. Setting the maximum size to null
+ * to compute it. Setting the maximum size to {@code null}
* restores the default behavior.
*
- * @param maximumSize a Dimension containing the
+ * @param maximumSize a {@code Dimension} containing the
* desired maximum allowable size
* @see #getMaximumSize
* @beaninfo
@@ -1695,12 +1695,12 @@
/**
- * If the maximum size has been set to a non-null value
- * just returns it. If the UI delegate's getMaximumSize
- * method returns a non-null value then return that;
+ * If the maximum size has been set to a non-{@code null} value
+ * just returns it. If the UI delegate's {@code getMaximumSize}
+ * method returns a non-{@code null} value then return that;
* otherwise defer to the component's layout manager.
*
- * @return the value of the maximumSize property
+ * @return the value of the {@code maximumSize} property
* @see #setMaximumSize
* @see ComponentUI
*/
@@ -1719,9 +1719,9 @@
/**
* Sets the minimum size of this component to a constant
- * value. Subsequent calls to getMinimumSize will always
+ * value. Subsequent calls to {@code getMinimumSize} will always
* return this value; the component's UI will not be asked
- * to compute it. Setting the minimum size to null
+ * to compute it. Setting the minimum size to {@code null}
* restores the default behavior.
*
* @param minimumSize the new minimum size of this component
@@ -1735,12 +1735,12 @@
}
/**
- * If the minimum size has been set to a non-null value
- * just returns it. If the UI delegate's getMinimumSize
- * method returns a non-null value then return that; otherwise
+ * If the minimum size has been set to a non-{@code null} value
+ * just returns it. If the UI delegate's {@code getMinimumSize}
+ * method returns a non-{@code null} value then return that; otherwise
* defer to the component's layout manager.
*
- * @return the value of the minimumSize property
+ * @return the value of the {@code minimumSize} property
* @see #setMinimumSize
* @see ComponentUI
*/
@@ -1769,7 +1769,7 @@
}
/**
- * Sets the border of this component. The Border object is
+ * Sets the border of this component. The {@code Border} object is
* responsible for defining the insets for the component
* (overriding any insets set directly on the component) and
* for optionally rendering any border decorations within the
@@ -1780,13 +1780,13 @@
* single component.
* JComponent, the look and
+ * that inherits from {@code JComponent}, the look and
* feel implementation of many standard Swing components
* doesn't work well with user-set borders. In general,
* when you want to set a border on a standard Swing
- * component other than JPanel or JLabel,
- * we recommend that you put the component in a JPanel
- * and set the border on the JPanel.
+ * component other than {@code JPanel} or {@code JLabel},
+ * we recommend that you put the component in a {@code JPanel}
+ * and set the border on the {@code JPanel}.
* null if no
+ * Returns the border of this component or {@code null} if no
* border is currently set.
*
* @return the border object for this component
@@ -1826,7 +1826,7 @@
/**
* If a border has been set on this component, returns the
- * border's insets; otherwise calls super.getInsets.
+ * border's insets; otherwise calls {@code super.getInsets}.
*
* @return the value of the insets property
* @see #setBorder
@@ -1839,15 +1839,15 @@
}
/**
- * Returns an Insets object containing this component's inset
- * values. The passed-in Insets object will be reused
+ * Returns an {@code Insets} object containing this component's inset
+ * values. The passed-in {@code Insets} object will be reused
* if possible.
* Calling methods cannot assume that the same object will be returned,
* however. All existing values within this object are overwritten.
- * If insets is null, this will allocate a new one.
+ * If {@code insets} is null, this will allocate a new one.
*
- * @param insets the Insets object, which can be reused
- * @return the Insets object
+ * @param insets the {@code Insets} object, which can be reused
+ * @return the {@code Insets} object
* @see #getInsets
* @beaninfo
* expert: true
@@ -1873,10 +1873,10 @@
}
/**
- * Overrides Container.getAlignmentY to return
+ * Overrides {@code Container.getAlignmentY} to return
* the vertical alignment.
*
- * @return the value of the alignmentY property
+ * @return the value of the {@code alignmentY} property
* @see #setAlignmentY
* @see java.awt.Component#getAlignmentY
*/
@@ -1902,10 +1902,10 @@
/**
- * Overrides Container.getAlignmentX to return
+ * Overrides {@code Container.getAlignmentX} to return
* the horizontal alignment.
*
- * @return the value of the alignmentX property
+ * @return the value of the {@code alignmentX} property
* @see #setAlignmentX
* @see java.awt.Component#getAlignmentX
*/
@@ -1953,7 +1953,7 @@
/**
* Returns the input verifier for this component.
*
- * @return the inputVerifier property
+ * @return the {@code inputVerifier} property
* @since 1.3
* @see InputVerifier
*/
@@ -1963,7 +1963,7 @@
/**
* Returns this component's graphics context, which lets you draw
- * on a component. Use this method to get a Graphics object and
+ * on a component. Use this method to get a {@code Graphics} object and
* then invoke operations on that object to draw on the component.
* @return this components graphics context
*/
@@ -1987,12 +1987,12 @@
* ExternalWindow that displays the operations
+ * {@code ExternalWindow} that displays the operations
* performed on the View's offscreen buffer.
* debugOptions is bitwise OR'd into the current value
+ * {@code debugOptions} is bitwise OR'd into the current value
*
* @beaninfo
* preferred: true
@@ -2014,7 +2014,7 @@
* ExternalWindow that displays the operations
+ * {@code ExternalWindow} that displays the operations
* performed on the View's offscreen buffer.
* JComponent or one of its parents.
+ * {@code JComponent} or one of its parents.
*/
int shouldDebugGraphics() {
return DebugGraphics.shouldComponentDebug(this);
@@ -2036,29 +2036,29 @@
/**
* This method is now obsolete, please use a combination of
- * getActionMap() and getInputMap() for
- * similar behavior. For example, to bind the KeyStroke
- * aKeyStroke to the Action anAction
+ * {@code getActionMap()} and {@code getInputMap()} for
+ * similar behavior. For example, to bind the {@code KeyStroke}
+ * {@code aKeyStroke} to the {@code Action anAction}
* now use:
*
* component.getInputMap().put(aKeyStroke, aCommand);
* component.getActionMap().put(aCommmand, anAction);
*
* The above assumes you want the binding to be applicable for
- * WHEN_FOCUSED. To register bindings for other focus
- * states use the getInputMap method that takes an integer.
+ * {@code WHEN_FOCUSED}. To register bindings for other focus
+ * states use the {@code getInputMap} method that takes an integer.
* anAction will be invoked if a key event matching
- * aKeyStroke occurs and aCondition is verified.
- * The KeyStroke object defines a
+ * {@code anAction} will be invoked if a key event matching
+ * {@code aKeyStroke} occurs and {@code aCondition} is verified.
+ * The {@code KeyStroke} object defines a
* particular combination of a keyboard key and one or more modifiers
* (alt, shift, ctrl, meta).
* aCommand will be set in the delivered event if
+ * The {@code aCommand} will be set in the delivered event if
* specified.
* aCondition can be one of:
+ * The {@code aCondition} can be one of:
*
*
*
anAction will replace the action.
+ * {@code anAction} will replace the action.
*
- * @param anAction the Action to be registered
+ * @param anAction the {@code Action} to be registered
* @param aCommand the command to be set in the delivered event
- * @param aKeyStroke the KeyStroke to bind to the action
+ * @param aKeyStroke the {@code KeyStroke} to bind to the action
* @param aCondition the condition that needs to be met, see above
* @see KeyStroke
*/
@@ -2113,14 +2113,14 @@
}
/**
- * Registers any bound WHEN_IN_FOCUSED_WINDOW actions with
- * the KeyboardManager. If onlyIfNew
+ * Registers any bound {@code WHEN_IN_FOCUSED_WINDOW} actions with
+ * the {@code KeyboardManager}. If {@code onlyIfNew}
* is true only actions that haven't been registered are pushed
- * to the KeyboardManager;
- * otherwise all actions are pushed to the KeyboardManager.
+ * to the {@code KeyboardManager};
+ * otherwise all actions are pushed to the {@code KeyboardManager}.
*
* @param onlyIfNew if true, only actions that haven't been registered
- * are pushed to the KeyboardManager
+ * are pushed to the {@code KeyboardManager}
*/
private void registerWithKeyboardManager(boolean onlyIfNew) {
InputMap inputMap = getInputMap(WHEN_IN_FOCUSED_WINDOW, false);
@@ -2176,7 +2176,7 @@
/**
* Unregisters all the previously registered
- * WHEN_IN_FOCUSED_WINDOW KeyStroke bindings.
+ * {@code WHEN_IN_FOCUSED_WINDOW KeyStroke} bindings.
*/
private void unregisterWithKeyboardManager() {
@SuppressWarnings("unchecked")
@@ -2196,10 +2196,10 @@
}
/**
- * Invoked from ComponentInputMap when its bindings change.
- * If inputMap is the current windowInputMap
- * (or a parent of the window InputMap)
- * the KeyboardManager is notified of the new bindings.
+ * Invoked from {@code ComponentInputMap} when its bindings change.
+ * If {@code inputMap} is the current {@code windowInputMap}
+ * (or a parent of the window {@code InputMap})
+ * the {@code KeyboardManager} is notified of the new bindings.
*
* @param inputMap the map containing the new bindings
*/
@@ -2225,7 +2225,7 @@
/**
* This method is now obsolete, please use a combination of
- * getActionMap() and getInputMap() for
+ * {@code getActionMap()} and {@code getInputMap()} for
* similar behavior.
*
* @param anAction action to be registered to given keystroke and condition
@@ -2242,16 +2242,16 @@
/**
* This method is now obsolete. To unregister an existing binding
* you can either remove the binding from the
- * ActionMap/InputMap, or place a dummy binding the
- * InputMap. Removing the binding from the
- * InputMap allows bindings in parent InputMaps
+ * {@code ActionMap/InputMap}, or place a dummy binding the
+ * {@code InputMap}. Removing the binding from the
+ * {@code InputMap} allows bindings in parent {@code InputMap}s
* to be active, whereas putting a dummy binding in the
- * InputMap effectively disables
+ * {@code InputMap} effectively disables
* the binding from ever happening.
* ActionMap
- * (if it exists) as well as the InputMaps.
+ * This will remove the binding from the {@code ActionMap}
+ * (if it exists) as well as the {@code InputMap}s.
*
* @param aKeyStroke the keystroke for which to unregister its
* keyboard action
@@ -2272,10 +2272,10 @@
}
/**
- * Returns the KeyStrokes that will initiate
+ * Returns the {@code KeyStrokes} that will initiate
* registered actions.
*
- * @return an array of KeyStroke objects
+ * @return an array of {@code KeyStroke} objects
* @see #registerKeyboardAction
*/
public KeyStroke[] getRegisteredKeyStrokes() {
@@ -2304,11 +2304,11 @@
* Returns the condition that determines whether a registered action
* occurs in response to the specified keystroke.
* KeyStroke can be associated
+ * For Java 2 platform v1.3, a {@code KeyStroke} can be associated
* with more than one condition.
* For example, 'a' could be bound for the two
- * conditions WHEN_FOCUSED and
- * WHEN_IN_FOCUSED_WINDOW condition.
+ * conditions {@code WHEN_FOCUSED} and
+ * {@code WHEN_IN_FOCUSED_WINDOW} condition.
*
* @param aKeyStroke the keystroke for which to request an
* action-keystroke condition
@@ -2329,7 +2329,7 @@
* given keystroke.
*
* @param aKeyStroke the keystroke for which to return a listener
- * @return the ActionListener
+ * @return the {@code ActionListener}
* object invoked when the keystroke occurs
*/
public ActionListener getActionForKeyStroke(KeyStroke aKeyStroke) {
@@ -2356,10 +2356,10 @@
}
/**
- * Unregisters all the bindings in the first tier InputMaps
- * and ActionMap. This has the effect of removing any
+ * Unregisters all the bindings in the first tier {@code InputMaps}
+ * and {@code ActionMap}. This has the effect of removing any
* local bindings, and allowing the bindings defined in parent
- * InputMap/ActionMaps
+ * {@code InputMap/ActionMaps}
* (the UI is usually defined in the second tier) to persist.
*/
public void resetKeyboardActions() {
@@ -2381,29 +2381,29 @@
}
/**
- * Sets the InputMap to use under the condition
- * condition to
- * map. A null value implies you
+ * Sets the {@code InputMap} to use under the condition
+ * {@code condition} to
+ * {@code map}. A {@code null} value implies you
* do not want any bindings to be used, even from the UI. This will
- * not reinstall the UI InputMap (if there was one).
- * condition has one of the following values:
+ * not reinstall the UI {@code InputMap} (if there was one).
+ * {@code condition} has one of the following values:
*
- *
- * If WHEN_IN_FOCUSED_WINDOW
- * WHEN_FOCUSED
- * WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
+ * condition is WHEN_IN_FOCUSED_WINDOW
- * and map is not a ComponentInputMap, an
- * IllegalArgumentException will be thrown.
- * Similarly, if condition is not one of the values
- * listed, an IllegalArgumentException will be thrown.
+ * If {@code condition} is {@code WHEN_IN_FOCUSED_WINDOW}
+ * and {@code map} is not a {@code ComponentInputMap}, an
+ * {@code IllegalArgumentException} will be thrown.
+ * Similarly, if {@code condition} is not one of the values
+ * listed, an {@code IllegalArgumentException} will be thrown.
*
* @param condition one of the values listed above
- * @param map the InputMap to use for the given condition
- * @exception IllegalArgumentException if condition is
- * WHEN_IN_FOCUSED_WINDOW and map
- * is not an instance of ComponentInputMap; or
- * if condition is not one of the legal values
+ * @param map the {@code InputMap} to use for the given condition
+ * @exception IllegalArgumentException if {@code condition} is
+ * {@code WHEN_IN_FOCUSED_WINDOW} and {@code map}
+ * is not an instance of {@code ComponentInputMap}; or
+ * if {@code condition} is not one of the legal values
* specified above
* @since 1.3
*/
@@ -2431,13 +2431,13 @@
}
/**
- * Returns the InputMap that is used during
- * condition.
+ * Returns the {@code InputMap} that is used during
+ * {@code condition}.
*
* @param condition one of WHEN_IN_FOCUSED_WINDOW, WHEN_FOCUSED,
* WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
- * @return the InputMap for the specified
- * condition
+ * @return the {@code InputMap} for the specified
+ * {@code condition}
* @since 1.3
*/
public final InputMap getInputMap(int condition) {
@@ -2445,11 +2445,11 @@
}
/**
- * Returns the InputMap that is used when the
+ * Returns the {@code InputMap} that is used when the
* component has focus.
- * This is convenience method for getInputMap(WHEN_FOCUSED).
+ * This is convenience method for {@code getInputMap(WHEN_FOCUSED)}.
*
- * @return the InputMap used when the component has focus
+ * @return the {@code InputMap} used when the component has focus
* @since 1.3
*/
public final InputMap getInputMap() {
@@ -2457,11 +2457,11 @@
}
/**
- * Sets the ActionMap to am. This does not set
- * the parent of the am to be the ActionMap
+ * Sets the {@code ActionMap} to {@code am}. This does not set
+ * the parent of the {@code am} to be the {@code ActionMap}
* from the UI (if there was one), it is up to the caller to have done this.
*
- * @param am the new ActionMap
+ * @param am the new {@code ActionMap}
* @since 1.3
*/
public final void setActionMap(ActionMap am) {
@@ -2470,12 +2470,12 @@
}
/**
- * Returns the ActionMap used to determine what
- * Action to fire for particular KeyStroke
- * binding. The returned ActionMap, unless otherwise
- * set, will have the ActionMap from the UI set as the parent.
+ * Returns the {@code ActionMap} used to determine what
+ * {@code Action} to fire for particular {@code KeyStroke}
+ * binding. The returned {@code ActionMap}, unless otherwise
+ * set, will have the {@code ActionMap} from the UI set as the parent.
*
- * @return the ActionMap containing the key/action bindings
+ * @return the {@code ActionMap} containing the key/action bindings
* @since 1.3
*/
public final ActionMap getActionMap() {
@@ -2483,9 +2483,9 @@
}
/**
- * Returns the InputMap to use for condition
- * condition. If the InputMap hasn't
- * been created, and create is
+ * Returns the {@code InputMap} to use for condition
+ * {@code condition}. If the {@code InputMap} hasn't
+ * been created, and {@code create} is
* true, it will be created.
*
* @param condition one of the following values:
@@ -2494,12 +2494,12 @@
* InputMap if it
+ * @param create if true, create the {@code InputMap} if it
* is not already created
- * @return the InputMap for the given condition;
- * if create is false and the InputMap
- * hasn't been created, returns null
- * @exception IllegalArgumentException if condition
+ * @return the {@code InputMap} for the given {@code condition};
+ * if {@code create} is false and the {@code InputMap}
+ * hasn't been created, returns {@code null}
+ * @exception IllegalArgumentException if {@code condition}
* is not one of the legal values listed above
*/
final InputMap getInputMap(int condition, boolean create) {
@@ -2544,13 +2544,13 @@
}
/**
- * Finds and returns the appropriate ActionMap.
+ * Finds and returns the appropriate {@code ActionMap}.
*
- * @param create if true, create the ActionMap if it
+ * @param create if true, create the {@code ActionMap} if it
* is not already created
- * @return the ActionMap for this component; if the
- * create flag is false and there is no
- * current ActionMap, returns null
+ * @return the {@code ActionMap} for this component; if the
+ * {@code create} flag is false and there is no
+ * current {@code ActionMap}, returns {@code null}
*/
final ActionMap getActionMap(boolean create) {
if (getFlag(ACTIONMAP_CREATED)) {
@@ -2568,17 +2568,17 @@
/**
* Returns the baseline. The baseline is measured from the top of
* the component. This method is primarily meant for
- * LayoutManagers to align components along their
+ * {@code LayoutManager}s to align components along their
* baseline. A return value less than 0 indicates this component
* does not have a reasonable baseline and that
- * LayoutManagers should not align this component on
+ * {@code LayoutManager}s should not align this component on
* its baseline.
* ComponentUI method of the
- * same name. If this component does not have a ComponentUI
+ * This method calls into the {@code ComponentUI} method of the
+ * same name. If this component does not have a {@code ComponentUI}
* -1 will be returned. If a value >= 0 is
* returned, then the component has a valid baseline for any
- * size >= the minimum size and getBaselineResizeBehavior
+ * size >= the minimum size and {@code getBaselineResizeBehavior}
* can be used to determine how the baseline changes with size.
*
* @throws IllegalArgumentException {@inheritDoc}
@@ -2600,18 +2600,18 @@
* changes as the size changes. This method is primarily meant for
* layout managers and GUI builders.
* ComponentUI method of
+ * This method calls into the {@code ComponentUI} method of
* the same name. If this component does not have a
- * ComponentUI
- * BaselineResizeBehavior.OTHER will be
+ * {@code ComponentUI}
+ * {@code BaselineResizeBehavior.OTHER} will be
* returned. Subclasses should
- * never return null; if the baseline can not be
- * calculated return BaselineResizeBehavior.OTHER. Callers
+ * never return {@code null}; if the baseline can not be
+ * calculated return {@code BaselineResizeBehavior.OTHER}. Callers
* should first ask for the baseline using
- * getBaseline and if a value >= 0 is returned use
+ * {@code getBaseline} and if a value >= 0 is returned use
* this method. It is acceptable for this method to return a
- * value other than BaselineResizeBehavior.OTHER even if
- * getBaseline returns a value less than 0.
+ * value other than {@code BaselineResizeBehavior.OTHER} even if
+ * {@code getBaseline} returns a value less than 0.
*
* @see #getBaseline(int, int)
* @since 1.6
@@ -2630,18 +2630,18 @@
* How to Use the Focus Subsystem,
* a section in The Java Tutorial.
* JComponent's
- * FocusTraversalPolicy's default Component.
- * If this JComponent is a focus cycle root, then its
- * FocusTraversalPolicy is used. Otherwise, the
- * FocusTraversalPolicy of this JComponent's
+ * Requests focus on this {@code JComponent}'s
+ * {@code FocusTraversalPolicy}'s default {@code Component}.
+ * If this {@code JComponent} is a focus cycle root, then its
+ * {@code FocusTraversalPolicy} is used. Otherwise, the
+ * {@code FocusTraversalPolicy} of this {@code JComponent}'s
* focus-cycle-root ancestor is used.
*
* @return true if this component can request to get the input focus,
* false if it can not
* @see java.awt.FocusTraversalPolicy#getDefaultComponent
* @deprecated As of 1.4, replaced by
- * FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
+ * {@code FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()}
*/
@Deprecated
public boolean requestDefaultFocus() {
@@ -2662,7 +2662,7 @@
/**
* Makes the component visible or invisible.
- * Overrides Component.setVisible.
+ * Overrides {@code Component.setVisible}.
*
* @param aFlag true to make the component visible; false to
* make it invisible
@@ -2720,7 +2720,7 @@
* look and feel to honor this property, some may choose to ignore
* it.
*
- * @param fg the desired foreground Color
+ * @param fg the desired foreground {@code Color}
* @see java.awt.Component#getForeground
*
* @beaninfo
@@ -2741,15 +2741,15 @@
/**
* Sets the background color of this component. The background
* color is used only if the component is opaque, and only
- * by subclasses of JComponent or
- * ComponentUI implementations. Direct subclasses of
- * JComponent must override
- * paintComponent to honor this property.
+ * by subclasses of {@code JComponent} or
+ * {@code ComponentUI} implementations. Direct subclasses of
+ * {@code JComponent} must override
+ * {@code paintComponent} to honor this property.
* Color
+ * @param bg the desired background {@code Color}
* @see java.awt.Component#getBackground
* @see #setOpaque
*
@@ -2771,7 +2771,7 @@
/**
* Sets the font for this component.
*
- * @param font the desired Font for this component
+ * @param font the desired {@code Font} for this component
* @see java.awt.Component#getFont
*
* @beaninfo
@@ -2799,7 +2799,7 @@
* can have their own setting. An applet can safely alter its default
* locale because it will have no affect on other applets (or the browser).
*
- * @return the default Locale.
+ * @return the default {@code Locale}.
* @see #setDefaultLocale
* @see java.awt.Component#getLocale
* @see #setLocale
@@ -2826,7 +2826,7 @@
* can have their own setting. An applet can safely alter its default
* locale because it will have no affect on other applets (or the browser).
*
- * @param l the desired default Locale for new components.
+ * @param l the desired default {@code Locale} for new components.
* @see #getDefaultLocale
* @see java.awt.Component#getLocale
* @see #setLocale
@@ -2856,7 +2856,7 @@
protected void processComponentKeyEvent(KeyEvent e) {
}
- /** Overrides processKeyEvent to process events. **/
+ /** Overrides {@code processKeyEvent} to process events. **/
protected void processKeyEvent(KeyEvent e) {
boolean result;
boolean shouldProcessKey;
@@ -2882,15 +2882,15 @@
}
/**
- * Invoked to process the key bindings for ks as the result
- * of the KeyEvent e. This obtains
- * the appropriate InputMap,
- * gets the binding, gets the action from the ActionMap,
+ * Invoked to process the key bindings for {@code ks} as the result
+ * of the {@code KeyEvent e}. This obtains
+ * the appropriate {@code InputMap},
+ * gets the binding, gets the action from the {@code ActionMap},
* and then (if the action is found and the component
- * is enabled) invokes notifyAction to notify the action.
+ * is enabled) invokes {@code notifyAction} to notify the action.
*
- * @param ks the KeyStroke queried
- * @param e the KeyEvent
+ * @param ks the {@code KeyStroke} queried
+ * @param e the {@code KeyEvent}
* @param condition one of the following values:
*
*
KeyEvent
- * that was not consumed by the FocusManager,
- * KeyListeners, or the component. It will first try
- * WHEN_FOCUSED bindings,
- * then WHEN_ANCESTOR_OF_FOCUSED_COMPONENT bindings,
- * and finally WHEN_IN_FOCUSED_WINDOW bindings.
+ * This is invoked as the result of a {@code KeyEvent}
+ * that was not consumed by the {@code FocusManager},
+ * {@code KeyListeners}, or the component. It will first try
+ * {@code WHEN_FOCUSED} bindings,
+ * then {@code WHEN_ANCESTOR_OF_FOCUSED_COMPONENT} bindings,
+ * and finally {@code WHEN_IN_FOCUSED_WINDOW} bindings.
*
- * @param e the unconsumed KeyEvent
+ * @param e the unconsumed {@code KeyEvent}
* @param pressed true if the key is pressed
- * @return true if there is a key binding for e
+ * @return true if there is a key binding for {@code e}
*/
boolean processKeyBindings(KeyEvent e, boolean pressed) {
if (!SwingUtilities.isValidKeyEventForKeyBindings(e)) {
@@ -3025,7 +3025,7 @@
* in The Java Tutorial
* for further documentation.
*
- * @param text the string to display; if the text is null,
+ * @param text the string to display; if the text is {@code null},
* the tool tip is turned off for this component
* @see #TOOL_TIP_TEXT_KEY
* @beaninfo
@@ -3047,7 +3047,7 @@
/**
* Returns the tooltip string that has been set with
- * setToolTipText.
+ * {@code setToolTipText}.
*
* @return the text of the tool tip
* @see #TOOL_TIP_TEXT_KEY
@@ -3060,7 +3060,7 @@
/**
* Returns the string to be used as the tooltip for event.
* By default this returns any string set using
- * setToolTipText. If a component provides
+ * {@code setToolTipText}. If a component provides
* more extensive API to support differing tooltips at different locations,
* this method should be overridden.
*
@@ -3074,12 +3074,12 @@
/**
* Returns the tooltip location in this component's coordinate system.
- * If null is returned, Swing will choose a location.
- * The default implementation returns null.
+ * If {@code null} is returned, Swing will choose a location.
+ * The default implementation returns {@code null}.
*
- * @param event the MouseEvent that caused the
- * ToolTipManager to show the tooltip
- * @return always returns null
+ * @param event the {@code MouseEvent} that caused the
+ * {@code ToolTipManager} to show the tooltip
+ * @return always returns {@code null}
*/
public Point getToolTipLocation(MouseEvent event) {
return null;
@@ -3103,13 +3103,13 @@
/**
- * Returns the instance of JToolTip that should be used
+ * Returns the instance of {@code JToolTip} that should be used
* to display the tooltip.
* Components typically would not override this method,
* but it can be used to
* cause different tooltips to be displayed differently.
*
- * @return the JToolTip used to display this toolTip
+ * @return the {@code JToolTip} used to display this toolTip
*/
public JToolTip createToolTip() {
JToolTip tip = new JToolTip();
@@ -3118,12 +3118,12 @@
}
/**
- * Forwards the scrollRectToVisible() message to the
- * JComponent's parent. Components that can service
- * the request, such as JViewport,
+ * Forwards the {@code scrollRectToVisible()} message to the
+ * {@code JComponent}'s parent. Components that can service
+ * the request, such as {@code JViewport},
* override this method and perform the scrolling.
*
- * @param aRect the visible Rectangle
+ * @param aRect the visible {@code Rectangle}
* @see JViewport
*/
public void scrollRectToVisible(Rectangle aRect) {
@@ -3152,25 +3152,25 @@
}
/**
- * Sets the autoscrolls property.
- * If true mouse dragged events will be
+ * Sets the {@code autoscrolls} property.
+ * If {@code true} mouse dragged events will be
* synthetically generated when the mouse is dragged
* outside of the component's bounds and mouse motion
* has paused (while the button continues to be held
* down). The synthetic events make it appear that the
* drag gesture has resumed in the direction established when
* the component's boundary was crossed. Components that
- * support autoscrolling must handle mouseDragged
- * events by calling scrollRectToVisible with a
+ * support autoscrolling must handle {@code mouseDragged}
+ * events by calling {@code scrollRectToVisible} with a
* rectangle that contains the mouse event's location. All of
* the Swing components that support item selection and are
- * typically displayed in a JScrollPane
- * (JTable, JList, JTree,
- * JTextArea, and JEditorPane)
+ * typically displayed in a {@code JScrollPane}
+ * ({@code JTable}, {@code JList}, {@code JTree},
+ * {@code JTextArea}, and {@code JEditorPane})
* already handle mouse dragged events in this way. To enable
* autoscrolling in any other component, add a mouse motion
- * listener that calls scrollRectToVisible.
- * For example, given a JPanel, myPanel:
+ * listener that calls {@code scrollRectToVisible}.
+ * For example, given a {@code JPanel}, {@code myPanel}:
*
* MouseMotionListener doScrollRectToVisible = new MouseMotionAdapter() {
* public void mouseDragged(MouseEvent e) {
@@ -3180,8 +3180,8 @@
* };
* myPanel.addMouseMotionListener(doScrollRectToVisible);
*
- * The default value of the autoScrolls
- * property is false.
+ * The default value of the {@code autoScrolls}
+ * property is {@code false}.
*
* @param autoscrolls if true, synthetic mouse dragged events
* are generated when the mouse is dragged outside of a component's
@@ -3210,9 +3210,9 @@
}
/**
- * Gets the autoscrolls property.
+ * Gets the {@code autoscrolls} property.
*
- * @return the value of the autoscrolls property
+ * @return the value of the {@code autoscrolls} property
* @see JViewport
* @see #setAutoscrolls
*/
@@ -3269,9 +3269,9 @@
}
/**
- * Gets the transferHandler property.
+ * Gets the {@code transferHandler} property.
*
- * @return the value of the transferHandler property
+ * @return the value of the {@code transferHandler} property
*
* @see TransferHandler
* @see #setTransferHandler
@@ -3284,13 +3284,13 @@
/**
* Calculates a custom drop location for this type of component,
* representing where a drop at the given point should insert data.
- * null is returned if this component doesn't calculate
- * custom drop locations. In this case, TransferHandler
- * will provide a default DropLocation containing just
+ * {@code null} is returned if this component doesn't calculate
+ * custom drop locations. In this case, {@code TransferHandler}
+ * will provide a default {@code DropLocation} containing just
* the point.
*
* @param p the point to calculate a drop location for
- * @return the drop location, or null
+ * @return the drop location, or {@code null}
*/
TransferHandler.DropLocation dropLocationForPoint(Point p) {
return null;
@@ -3314,20 +3314,20 @@
* is being changed to something else. The component doesn't need to
* restore anything yet, so it simply passes back the same state object
* to have the DnD system continue storing it. Finally, let's say this
- * method is messaged with null. This means DnD
+ * method is messaged with {@code null}. This means DnD
* is finished with this component for now, meaning it should restore
* state. At this point, it can use the state parameter to restore
- * said state, and of course return null since there's
+ * said state, and of course return {@code null} since there's
* no longer anything to store.
*
* @param location the drop location (as calculated by
- * dropLocationForPoint) or null
+ * {@code dropLocationForPoint}) or {@code null}
* if there's no longer a valid drop location
* @param state the state object saved earlier for this component,
- * or null
+ * or {@code null}
* @param forDrop whether or not the method is being called because an
* actual drop occurred
- * @return any saved state for this component, or null if none
+ * @return any saved state for this component, or {@code null} if none
*/
Object setDropLocation(TransferHandler.DropLocation location,
Object state,
@@ -3338,7 +3338,7 @@
/**
* Called to indicate to this component that DnD is done.
- * Needed by JTree.
+ * Needed by {@code JTree}.
*/
void dndDone() {
}
@@ -3346,7 +3346,7 @@
/**
* Processes mouse events occurring on this component by
* dispatching them to any registered
- * MouseListener objects, refer to
+ * {@code MouseListener} objects, refer to
* {@link java.awt.Component#processMouseEvent(MouseEvent)}
* for a complete description of this method.
*
@@ -3364,7 +3364,7 @@
/**
* Processes mouse motion events, such as MouseEvent.MOUSE_DRAGGED.
*
- * @param e the MouseEvent
+ * @param e the {@code MouseEvent}
* @see MouseEvent
*/
protected void processMouseMotionEvent(MouseEvent e) {
@@ -3386,8 +3386,8 @@
}
/**
- * This is invoked by the RepaintManager if
- * createImage is called on the component.
+ * This is invoked by the {@code RepaintManager} if
+ * {@code createImage} is called on the component.
*
* @param newValue true if the double buffer image was created from this component
*/
@@ -3396,7 +3396,7 @@
}
/**
- * Returns true if the RepaintManager
+ * Returns true if the {@code RepaintManager}
* created the double buffer image from the component.
*
* @return true if this component had a double buffer image, false otherwise
@@ -3406,9 +3406,9 @@
}
/**
- * ActionStandin is used as a standin for
- * ActionListeners that are
- * added via registerKeyboardAction.
+ * {@code ActionStandin} is used as a standin for
+ * {@code ActionListeners} that are
+ * added via {@code registerKeyboardAction}.
*/
final class ActionStandin implements Action {
private final ActionListener actionListener;
@@ -3652,7 +3652,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by java.awt.Component.setEnabled(boolean).
+ * replaced by {@code java.awt.Component.setEnabled(boolean)}.
*/
@Deprecated
public void enable() {
@@ -3668,7 +3668,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by java.awt.Component.setEnabled(boolean).
+ * replaced by {@code java.awt.Component.setEnabled(boolean)}.
*/
@Deprecated
public void disable() {
@@ -3694,7 +3694,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
@@ -4033,9 +4033,9 @@
/**
- * Returns an ArrayTable used for
+ * Returns an {@code ArrayTable} used for
* key/value "client properties" for this component. If the
- * clientProperties table doesn't exist, an empty one
+ * {@code clientProperties} table doesn't exist, an empty one
* will be created.
*
* @return an ArrayTable
@@ -4052,11 +4052,11 @@
/**
* Returns the value of the property with the specified key. Only
- * properties added with putClientProperty will return
- * a non-null value.
+ * properties added with {@code putClientProperty} will return
+ * a non-{@code null} value.
*
* @param key the being queried
- * @return the value of this property or null
+ * @return the value of this property or {@code null}
* @see #putClientProperty
*/
public final Object getClientProperty(Object key) {
@@ -4077,7 +4077,7 @@
/**
* Adds an arbitrary key/value "client property" to this component.
* get/putClientProperty methods provide access to
+ * The {@code get/putClientProperty} methods provide access to
* a small per-instance hashtable. Callers can use get/putClientProperty
* to annotate components that were created by another module.
* For example, a
@@ -4085,19 +4085,19 @@
*
* componentA.putClientProperty("to the left of", componentB);
*
- * If value is null this method will remove the property.
+ * If value is {@code null} this method will remove the property.
* Changes to client properties are reported with
- * PropertyChange events.
+ * {@code PropertyChange} events.
* The name of the property (for the sake of PropertyChange
- * events) is key.toString().
+ * events) is {@code key.toString()}.
* clientProperty dictionary is not intended to
+ * The {@code clientProperty} dictionary is not intended to
* support large
* scale extensions to JComponent nor should be it considered an
* alternative to subclassing when designing a new component.
*
* @param key the new client property key
- * @param value the new client property value; if null
+ * @param value the new client property value; if {@code null}
* this method will remove the property
* @see #getClientProperty
* @see #addPropertyChangeListener
@@ -4243,7 +4243,7 @@
/**
* @deprecated As of JDK 5,
- * replaced by Component.setBounds(int, int, int, int).
+ * replaced by {@code Component.setBounds(int, int, int, int)}.
* rv and returns rv.
- * If rv is null a new Rectangle
- * is allocated. This version of getBounds is useful
- * if the caller wants to avoid allocating a new Rectangle
+ * {@code rv} and returns {@code rv}.
+ * If {@code rv} is {@code null} a new {@code Rectangle}
+ * is allocated. This version of {@code getBounds} is useful
+ * if the caller wants to avoid allocating a new {@code Rectangle}
* object on the heap.
*
* @param rv the return value, modified to the component's bounds
- * @return rv; if rv is null
- * return a newly created Rectangle with this
+ * @return {@code rv}; if {@code rv} is {@code null}
+ * return a newly created {@code Rectangle} with this
* component's bounds
*/
public Rectangle getBounds(Rectangle rv) {
@@ -4285,14 +4285,14 @@
/**
* Stores the width/height of this component into "return value"
- * rv and returns rv.
- * If rv is null a new Dimension
- * object is allocated. This version of getSize
+ * {@code rv} and returns {@code rv}.
+ * If {@code rv} is {@code null} a new {@code Dimension}
+ * object is allocated. This version of {@code getSize}
* is useful if the caller wants to avoid allocating a new
- * Dimension object on the heap.
+ * {@code Dimension} object on the heap.
*
* @param rv the return value, modified to the component's size
- * @return rv
+ * @return {@code rv}
*/
public Dimension getSize(Dimension rv) {
if (rv == null) {
@@ -4307,14 +4307,14 @@
/**
* Stores the x,y origin of this component into "return value"
- * rv and returns rv.
- * If rv is null a new Point
- * is allocated. This version of getLocation is useful
- * if the caller wants to avoid allocating a new Point
+ * {@code rv} and returns {@code rv}.
+ * If {@code rv} is {@code null} a new {@code Point}
+ * is allocated. This version of {@code getLocation} is useful
+ * if the caller wants to avoid allocating a new {@code Point}
* object on the heap.
*
* @param rv the return value, modified to the component's location
- * @return rv
+ * @return {@code rv}
*/
public Point getLocation(Point rv) {
if (rv == null) {
@@ -4330,8 +4330,8 @@
/**
* Returns the current x coordinate of the component's origin.
* This method is preferable to writing
- * component.getBounds().x, or
- * component.getLocation().x because it doesn't cause any
+ * {@code component.getBounds().x}, or
+ * {@code component.getLocation().x} because it doesn't cause any
* heap allocations.
*
* @return the current x coordinate of the component's origin
@@ -4342,8 +4342,8 @@
/**
* Returns the current y coordinate of the component's origin.
* This method is preferable to writing
- * component.getBounds().y, or
- * component.getLocation().y because it doesn't cause any
+ * {@code component.getBounds().y}, or
+ * {@code component.getLocation().y} because it doesn't cause any
* heap allocations.
*
* @return the current y coordinate of the component's origin
@@ -4354,8 +4354,8 @@
/**
* Returns the current width of this component.
* This method is preferable to writing
- * component.getBounds().width, or
- * component.getSize().width because it doesn't cause any
+ * {@code component.getBounds().width}, or
+ * {@code component.getSize().width} because it doesn't cause any
* heap allocations.
*
* @return the current width of this component
@@ -4366,8 +4366,8 @@
/**
* Returns the current height of this component.
* This method is preferable to writing
- * component.getBounds().height, or
- * component.getSize().height because it doesn't cause any
+ * {@code component.getBounds().height}, or
+ * {@code component.getSize().height} because it doesn't cause any
* heap allocations.
*
* @return the current height of this component
@@ -4398,10 +4398,10 @@
* Otherwise, the component may not paint some or all of its
* pixels, allowing the underlying pixels to show through.
* JComponent.
+ * The default value of this property is false for {@code JComponent}.
* However, the default value for this property on most standard
- * JComponent subclasses (such as JButton and
- * JTree) is look-and-feel dependent.
+ * {@code JComponent} subclasses (such as {@code JButton} and
+ * {@code JTree}) is look-and-feel dependent.
*
* @param isOpaque true if this component should be opaque
* @see #isOpaque
@@ -4422,8 +4422,8 @@
* If the specified rectangle is completely obscured by any of this
* component's opaque children then returns true. Only direct children
* are considered, more distant descendants are ignored. A
- * JComponent is opaque if
- * JComponent.isOpaque() returns true, other lightweight
+ * {@code JComponent} is opaque if
+ * {@code JComponent.isOpaque()} returns true, other lightweight
* components are always considered transparent, and heavyweight components
* are always considered opaque.
*
@@ -4468,15 +4468,15 @@
/**
- * Returns the Component's "visible rect rectangle" - the
- * intersection of the visible rectangles for the component c
+ * Returns the {@code Component}'s "visible rect rectangle" - the
+ * intersection of the visible rectangles for the component {@code c}
* and all of its ancestors. The return value is stored in
- * visibleRect.
+ * {@code visibleRect}.
*
* @param c the component
- * @param visibleRect a Rectangle computed as the
+ * @param visibleRect a {@code Rectangle} computed as the
* intersection of all visible rectangles for the component
- * c and all of its ancestors -- this is the
+ * {@code c} and all of its ancestors -- this is the
* return value for this method
* @see #getVisibleRect
*/
@@ -4496,12 +4496,12 @@
/**
- * Returns the Component's "visible rect rectangle" - the
+ * Returns the {@code Component}'s "visible rect rectangle" - the
* intersection of the visible rectangles for this component
* and all of its ancestors. The return value is stored in
- * visibleRect.
+ * {@code visibleRect}.
*
- * @param visibleRect a Rectangle computed as the
+ * @param visibleRect a {@code Rectangle} computed as the
* intersection of all visible rectangles for this
* component and all of its ancestors -- this is the return
* value for this method
@@ -4513,9 +4513,9 @@
/**
- * Returns the Component's "visible rectangle" - the
+ * Returns the {@code Component}'s "visible rectangle" - the
* intersection of this component's visible rectangle,
- * new Rectangle(0, 0, getWidth(), getHeight()),
+ * {@code new Rectangle(0, 0, getWidth(), getHeight())},
* and all of its ancestors' visible rectangles.
*
* @return the visible rectangle
@@ -4567,8 +4567,8 @@
/**
* Supports reporting constrained property changes.
* This method can be called when a constrained property has changed
- * and it will send the appropriate PropertyChangeEvent
- * to any registered VetoableChangeListeners.
+ * and it will send the appropriate {@code PropertyChangeEvent}
+ * to any registered {@code VetoableChangeListeners}.
*
* @param propertyName the name of the property that was listened on
* @param oldValue the old value of the property
@@ -4587,10 +4587,10 @@
/**
- * Adds a VetoableChangeListener to the listener list.
+ * Adds a {@code VetoableChangeListener} to the listener list.
* The listener is registered for all properties.
*
- * @param listener the VetoableChangeListener to be added
+ * @param listener the {@code VetoableChangeListener} to be added
*/
public synchronized void addVetoableChangeListener(VetoableChangeListener listener) {
if (vetoableChangeSupport == null) {
@@ -4601,11 +4601,11 @@
/**
- * Removes a VetoableChangeListener from the listener list.
- * This removes a VetoableChangeListener that was registered
+ * Removes a {@code VetoableChangeListener} from the listener list.
+ * This removes a {@code VetoableChangeListener} that was registered
* for all properties.
*
- * @param listener the VetoableChangeListener to be removed
+ * @param listener the {@code VetoableChangeListener} to be removed
*/
public synchronized void removeVetoableChangeListener(VetoableChangeListener listener) {
if (vetoableChangeSupport == null) {
@@ -4619,7 +4619,7 @@
* Returns an array of all the vetoable change listeners
* registered on this component.
*
- * @return all of the component's VetoableChangeListeners
+ * @return all of the component's {@code VetoableChangeListener}s
* or an empty
* array if no vetoable change listeners are currently registered
*
@@ -4638,12 +4638,12 @@
/**
* Returns the top-level ancestor of this component (either the
- * containing Window or Applet),
- * or null if this component has not
+ * containing {@code Window} or {@code Applet}),
+ * or {@code null} if this component has not
* been added to any container.
*
- * @return the top-level Container that this component is in,
- * or null if not in any container
+ * @return the top-level {@code Container} that this component is in,
+ * or {@code null} if not in any container
*/
public Container getTopLevelAncestor() {
for(Container p = this; p != null; p = p.getParent()) {
@@ -4660,13 +4660,13 @@
}
/**
- * Registers listener so that it will receive
- * AncestorEvents when it or any of its ancestors
+ * Registers {@code listener} so that it will receive
+ * {@code AncestorEvents} when it or any of its ancestors
* move or are made visible or invisible.
* Events are also sent when the component or its ancestors are added
* or removed from the containment hierarchy.
*
- * @param listener the AncestorListener to register
+ * @param listener the {@code AncestorListener} to register
* @see AncestorEvent
*/
public void addAncestorListener(AncestorListener listener) {
@@ -4680,10 +4680,10 @@
}
/**
- * Unregisters listener so that it will no longer receive
- * AncestorEvents.
+ * Unregisters {@code listener} so that it will no longer receive
+ * {@code AncestorEvents}.
*
- * @param listener the AncestorListener to be removed
+ * @param listener the {@code AncestorListener} to be removed
* @see #addAncestorListener
*/
public void removeAncestorListener(AncestorListener listener) {
@@ -4702,7 +4702,7 @@
* Returns an array of all the ancestor listeners
* registered on this component.
*
- * @return all of the component's AncestorListeners
+ * @return all of the component's {@code AncestorListener}s
* or an empty
* array if no ancestor listeners are currently registered
*
@@ -4722,32 +4722,32 @@
/**
* Returns an array of all the objects currently registered
* as FooListeners
- * upon this JComponent.
+ * upon this {@code JComponent}.
* FooListeners are registered using the
* addFooListener method.
*
* listenerType argument
+ * You can specify the {@code listenerType} argument
* with a class literal,
* such as
* FooListener.class.
* For example, you can query a
- * JComponent c
+ * {@code JComponent c}
* for its mouse listeners with the following code:
* MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));
* If no such listeners exist, this method returns an empty array.
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * java.util.EventListener
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* FooListeners on this component,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if listenerType
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * java.util.EventListener
+ * {@code java.util.EventListener}
*
* @since 1.3
*
@@ -4782,7 +4782,7 @@
/**
* Notifies this component that it now has a parent component.
* When this method is invoked, the chain of parent components is
- * set up with KeyboardAction event listeners.
+ * set up with {@code KeyboardAction} event listeners.
* This method is called by the toolkit internally and should
* not be called directly by programs.
*
@@ -4799,7 +4799,7 @@
/**
* Notifies this component that it no longer has a parent component.
- * When this method is invoked, any KeyboardActions
+ * When this method is invoked, any {@code KeyboardAction}s
* set up in the chain of parent components are removed.
* This method is called by the toolkit internally and should
* not be called directly by programs.
@@ -4851,7 +4851,7 @@
* is showing. The component will be repainted after all of the
* currently pending events have been dispatched.
*
- * @param r a Rectangle containing the dirty region
+ * @param r a {@code Rectangle} containing the dirty region
* @see #isPaintingOrigin()
* @see java.awt.Component#isShowing
* @see RepaintManager#addDirtyRegion
@@ -4864,21 +4864,21 @@
/**
* Supports deferred automatic layout.
* invalidate and then adds this component's
- * validateRoot to a list of components that need to be
+ * Calls {@code invalidate} and then adds this component's
+ * {@code validateRoot} to a list of components that need to be
* validated. Validation will occur after all currently pending
* events have been dispatched. In other words after this method
* is called, the first validateRoot (if any) found when walking
* up the containment hierarchy of this component will be validated.
- * By default, JRootPane, JScrollPane,
- * and JTextField return true
- * from isValidateRoot.
+ * By default, {@code JRootPane}, {@code JScrollPane},
+ * and {@code JTextField} return true
+ * from {@code isValidateRoot}.
* validate to get the contents of the
+ * longer need to invoke {@code validate} to get the contents of the
* GUI to update.
*
* @see java.awt.Component#invalidate
@@ -4915,10 +4915,10 @@
}
/**
- * If this method returns true, revalidate calls by
+ * If this method returns true, {@code revalidate} calls by
* descendants of this component will cause the entire tree
* beginning with this root to be validated.
- * Returns false by default. JScrollPane overrides
+ * Returns false by default. {@code JScrollPane} overrides
* this method and returns true.
*
* @return always returns false
@@ -4937,8 +4937,8 @@
* Returns true if this component tiles its children -- that is, if
* it can guarantee that the children will not overlap. The
* repainting system is substantially more efficient in this
- * common case. JComponent subclasses that can't make this
- * guarantee, such as JLayeredPane,
+ * common case. {@code JComponent} subclasses that can't make this
+ * guarantee, such as {@code JLayeredPane},
* should override this method to return false.
*
* @return always returns true
@@ -5027,7 +5027,7 @@
/**
* Paints the specified region now.
*
- * @param r a Rectangle containing the region to be painted
+ * @param r a {@code Rectangle} containing the region to be painted
*/
public void paintImmediately(Rectangle r) {
paintImmediately(r.x,r.y,r.width,r.height);
@@ -5035,7 +5035,7 @@
/**
* Returns whether this component should be guaranteed to be on top.
- * For example, it would make no sense for Menus to pop up
+ * For example, it would make no sense for {@code Menu}s to pop up
* under another component, so they would always return true.
* Most components will want to return false, hence that is the default.
*
@@ -5329,7 +5329,7 @@
/**
* Returns true, which implies that before checking if a child should
* be painted it is first check that the child is not obscured by another
- * sibling. This is only checked if isOptimizedDrawingEnabled
+ * sibling. This is only checked if {@code isOptimizedDrawingEnabled}
* returns false.
*
* @return always returns true
@@ -5368,7 +5368,7 @@
* If set to true, all the drawing from this component will be done
* in an offscreen painting buffer. The offscreen painting buffer will
* the be copied onto the screen.
- * If a Component is buffered and one of its ancestor
+ * If a {@code Component} is buffered and one of its ancestor
* is also buffered, the ancestor buffer will be used.
*
* @param aFlag if true, set this component to be double buffered
@@ -5387,10 +5387,10 @@
}
/**
- * Returns the JRootPane ancestor for this component.
+ * Returns the {@code JRootPane} ancestor for this component.
*
- * @return the JRootPane that contains this component,
- * or null if no JRootPane is found
+ * @return the {@code JRootPane} that contains this component,
+ * or {@code null} if no {@code JRootPane} is found
*/
public JRootPane getRootPane() {
return SwingUtilities.getRootPane(this);
@@ -5426,16 +5426,16 @@
}
/**
- * This object is the ObjectInputStream callback
+ * This object is the {@code ObjectInputStream} callback
* that's called after a complete graph of objects (including at least
- * one JComponent) has been read.
+ * one {@code JComponent}) has been read.
* It sets the UI property of each Swing component
- * that was read to the current default with updateUI.
+ * that was read to the current default with {@code updateUI}.
* ReadObjectCallback per ObjectInputStream,
- * they're stored in the static readObjectCallbacks
+ * {@code ReadObjectCallback} per {@code ObjectInputStream},
+ * they're stored in the static {@code readObjectCallbacks}
* hashtable.
*
* @see java.io.ObjectInputStream#registerValidation
@@ -5455,7 +5455,7 @@
* This is the method that's called after the entire graph
* of objects has been read in. It initializes
* the UI property of all of the copmonents with
- * SwingUtilities.updateComponentTreeUI.
+ * {@code SwingUtilities.updateComponentTreeUI}.
*/
public void validateObject() throws InvalidObjectException {
try {
@@ -5469,10 +5469,10 @@
}
/**
- * If c isn't a descendant of a component we've already
- * seen, then add it to the roots Vector.
+ * If {@code c} isn't a descendant of a component we've already
+ * seen, then add it to the roots {@code Vector}.
*
- * @param c the JComponent to add
+ * @param c the {@code JComponent} to add
*/
private void registerComponent(JComponent c)
{
@@ -5507,11 +5507,11 @@
/**
- * We use the ObjectInputStream "registerValidation"
+ * We use the {@code ObjectInputStream} "registerValidation"
* callback to update the UI for the entire tree of components
* after they've all been read in.
*
- * @param s the ObjectInputStream from which to read
+ * @param s the {@code ObjectInputStream} from which to read
*/
private void readObject(ObjectInputStream s)
throws IOException, ClassNotFoundException
@@ -5570,15 +5570,15 @@
/**
- * Before writing a JComponent to an
- * ObjectOutputStream we temporarily uninstall its UI.
+ * Before writing a {@code JComponent} to an
+ * {@code ObjectOutputStream} we temporarily uninstall its UI.
* This is tricky to do because we want to uninstall
- * the UI before any of the JComponent's children
- * (or its LayoutManager etc.) are written,
+ * the UI before any of the {@code JComponent}'s children
+ * (or its {@code LayoutManager} etc.) are written,
* and we don't want to restore the UI until the most derived
- * JComponent subclass has been stored.
+ * {@code JComponent} subclass has been stored.
*
- * @param s the ObjectOutputStream in which to write
+ * @param s the {@code ObjectOutputStream} in which to write
*/
private void writeObject(ObjectOutputStream s) throws IOException {
s.defaultWriteObject();
@@ -5594,14 +5594,14 @@
/**
- * Returns a string representation of this JComponent.
+ * Returns a string representation of this {@code JComponent}.
* This method
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JComponent
+ * @return a string representation of this {@code JComponent}
*/
protected String paramString() {
String preferredSizeString = (isPreferredSizeSet() ?
--- old/src/java.desktop/share/classes/javax/swing/JDesktopPane.java 2015-10-04 22:56:46.077263264 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JDesktopPane.java 2015-10-04 22:56:45.889263272 +0400
@@ -46,21 +46,21 @@
import java.util.LinkedHashSet;
/**
* A container used to create a multiple-document interface or a virtual desktop.
- * You create JInternalFrame objects and add them to the
- * JDesktopPane. JDesktopPane extends
- * JLayeredPane to manage the potentially overlapping internal
+ * You create {@code JInternalFrame} objects and add them to the
+ * {@code JDesktopPane}. {@code JDesktopPane} extends
+ * {@code JLayeredPane} to manage the potentially overlapping internal
* frames. It also maintains a reference to an instance of
- * DesktopManager that is set by the UI
- * class for the current look and feel (L&F). Note that JDesktopPane
+ * {@code DesktopManager} that is set by the UI
+ * class for the current look and feel (L&F). Note that {@code JDesktopPane}
* does not support borders.
* JInternalFrames
- * to provide a pluggable DesktopManager object to the
- * JInternalFrames. The installUI of the
+ * This class is normally used as the parent of {@code JInternalFrames}
+ * to provide a pluggable {@code DesktopManager} object to the
+ * {@code JInternalFrames}. The {@code installUI} of the
* L&F specific implementation is responsible for setting the
- * desktopManager variable appropriately.
- * When the parent of a JInternalFrame is a JDesktopPane,
- * it should delegate most of its behavior to the desktopManager
+ * {@code desktopManager} variable appropriately.
+ * When the parent of a {@code JInternalFrame} is a {@code JDesktopPane},
+ * it should delegate most of its behavior to the {@code desktopManager}
* (closing, resizing, etc).
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see JInternalFrame
@@ -126,7 +126,7 @@
private boolean componentOrderChanged = false;
/**
- * Creates a new JDesktopPane.
+ * Creates a new {@code JDesktopPane}.
*/
public JDesktopPane() {
setUIProperty("opaque", Boolean.TRUE);
@@ -151,7 +151,7 @@
/**
* Returns the L&F object that renders this component.
*
- * @return the DesktopPaneUI object that
+ * @return the {@code DesktopPaneUI} object that
* renders this component
*/
public DesktopPaneUI getUI() {
@@ -199,8 +199,8 @@
/**
* Gets the current "dragging style" used by the desktop pane.
- * @return either Live_DRAG_MODE or
- * OUTLINE_DRAG_MODE
+ * @return either {@code Live_DRAG_MODE} or
+ * {@code OUTLINE_DRAG_MODE}
* @see #setDragMode
* @since 1.3
*/
@@ -220,11 +220,11 @@
}
/**
- * Sets the DesktopManger that will handle
+ * Sets the {@code DesktopManger} that will handle
* desktop-specific UI actions. This may be overridden by
* {@code LookAndFeel}.
*
- * @param d the DesktopManager to use
+ * @param d the {@code DesktopManager} to use
*
* @beaninfo
* bound: true
@@ -238,9 +238,9 @@
}
/**
- * Notification from the UIManager that the L&F has changed.
+ * Notification from the {@code UIManager} that the L&F has changed.
* Replaces the current UI object with the latest version from the
- * UIManager.
+ * {@code UIManager}.
*
* @see JComponent#updateUI
*/
@@ -261,10 +261,10 @@
}
/**
- * Returns all JInternalFrames currently displayed in the
+ * Returns all {@code JInternalFrames} currently displayed in the
* desktop. Returns iconified frames as well as expanded frames.
*
- * @return an array of JInternalFrame objects
+ * @return an array of {@code JInternalFrame} objects
*/
public JInternalFrame[] getAllFrames() {
return getAllFrames(this).toArray(new JInternalFrame[0]);
@@ -290,12 +290,12 @@
return results;
}
- /** Returns the currently active JInternalFrame
- * in this JDesktopPane, or null
- * if no JInternalFrame is currently active.
+ /** Returns the currently active {@code JInternalFrame}
+ * in this {@code JDesktopPane}, or {@code null}
+ * if no {@code JInternalFrame} is currently active.
*
- * @return the currently active JInternalFrame or
- * null
+ * @return the currently active {@code JInternalFrame} or
+ * {@code null}
* @since 1.3
*/
@@ -303,8 +303,8 @@
return selectedFrame;
}
- /** Sets the currently active JInternalFrame
- * in this JDesktopPane. This method is used to bridge
+ /** Sets the currently active {@code JInternalFrame}
+ * in this {@code JDesktopPane}. This method is used to bridge
* the package gap between JDesktopPane and the platform implementation
* code and should not be called directly. To visually select the frame
* the client must call JInternalFrame.setSelected(true) to activate
@@ -320,12 +320,12 @@
}
/**
- * Returns all JInternalFrames currently displayed in the
+ * Returns all {@code JInternalFrames} currently displayed in the
* specified layer of the desktop. Returns iconified frames as well
* expanded frames.
*
* @param layer an int specifying the desktop layer
- * @return an array of JInternalFrame objects
+ * @return an array of {@code JInternalFrame} objects
* @see JLayeredPane
*/
public JInternalFrame[] getAllFramesInLayer(int layer) {
@@ -443,12 +443,12 @@
}
/**
- * Selects the next JInternalFrame in this desktop pane.
+ * Selects the next {@code JInternalFrame} in this desktop pane.
*
* @param forward a boolean indicating which direction to select in;
- * true for forward, false for
+ * {@code true} for forward, {@code false} for
* backward
- * @return the JInternalFrame that was selected or null
+ * @return the JInternalFrame that was selected or {@code null}
* if nothing was selected
* @since 1.6
*/
@@ -472,7 +472,7 @@
/*
* Sets whether component order checking is enabled.
- * @param enable a boolean value, where true means
+ * @param enable a boolean value, where {@code true} means
* a change in component order will cause a change in the keyboard
* navigation order.
* @since 1.6
@@ -570,13 +570,13 @@
}
/**
- * Returns a string representation of this JDesktopPane.
+ * Returns a string representation of this {@code JDesktopPane}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JDesktopPane
+ * @return a string representation of this {@code JDesktopPane}
*/
protected String paramString() {
String desktopManagerString = (desktopManager != null ?
@@ -591,14 +591,14 @@
////////////////
/**
- * Gets the AccessibleContext associated with this
- * JDesktopPane. For desktop panes, the
- * AccessibleContext takes the form of an
- * AccessibleJDesktopPane.
- * A new AccessibleJDesktopPane instance is created if necessary.
+ * Gets the {@code AccessibleContext} associated with this
+ * {@code JDesktopPane}. For desktop panes, the
+ * {@code AccessibleContext} takes the form of an
+ * {@code AccessibleJDesktopPane}.
+ * A new {@code AccessibleJDesktopPane} instance is created if necessary.
*
- * @return an AccessibleJDesktopPane that serves as the
- * AccessibleContext of this JDesktopPane
+ * @return an {@code AccessibleJDesktopPane} that serves as the
+ * {@code AccessibleContext} of this {@code JDesktopPane}
*/
public AccessibleContext getAccessibleContext() {
if (accessibleContext == null) {
@@ -609,7 +609,7 @@
/**
* This class implements accessibility support for the
- * JDesktopPane class. It provides an implementation of the
+ * {@code JDesktopPane} class. It provides an implementation of the
* Java Accessibility API appropriate to desktop pane user-interface
* elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
--- old/src/java.desktop/share/classes/javax/swing/JEditorPane.java 2015-10-04 22:56:46.613263240 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JEditorPane.java 2015-10-04 22:56:46.421263248 +0400
@@ -49,12 +49,12 @@
*
* EditorKit to accomplish its behavior. It effectively
+ * {@code EditorKit} to accomplish its behavior. It effectively
* morphs into the proper kind of text editor for the kind
* of content it is given. The content type that editor is bound
- * to at any given time is determined by the EditorKit currently
+ * to at any given time is determined by the {@code EditorKit} currently
* installed. If the content is set to a new URL, its type is used
- * to determine the EditorKit that should be used to
+ * to determine the {@code EditorKit} that should be used to
* load the content.
* DefaultEditorKit that produces a wrapped plain text view.
+ * {@code DefaultEditorKit} that produces a wrapped plain text view.
* javax.swing.text.html.HTMLEditorKit
+ * {@code javax.swing.text.html.HTMLEditorKit}
* which provides HTML 3.2 support.
* javax.swing.text.rtf.RTFEditorKit
+ * {@code javax.swing.text.rtf.RTFEditorKit}
* which provides a limited support of the Rich Text Format.
*
* EditorKit will be used, and the content type will be
+ * {@code EditorKit} will be used, and the content type will be
* expected to be of this type.
* Reader. Note that if the content type is HTML,
+ * component from a {@code Reader}. Note that if the content type is HTML,
* relative references (e.g. for things like images) can't be resolved
* unless the <base> tag is used or the Base property
- * on HTMLDocument is set.
- * In this case the current EditorKit will be used,
+ * on {@code HTMLDocument} is set.
+ * In this case the current {@code EditorKit} will be used,
* and the content type will be expected to be of this type.
* EditorKit
+ * determined from the URL, and the registered {@code EditorKit}
* for that content type will be set.
*
* EditorKit will generate
- * hyperlink events if the JEditorPane is not editable
- * (JEditorPane.setEditable(false); has been called).
+ * hyperlink events. The HTML {@code EditorKit} will generate
+ * hyperlink events if the {@code JEditorPane} is not editable
+ * ({@code JEditorPane.setEditable(false);} has been called).
* If HTML frames are embedded in the document, the typical response would be
* to change a portion of the current document. The following code
* fragment is a possible hyperlink listener implementation, that treats
@@ -137,11 +137,11 @@
* digits, symbols, or control functions) to specific numeric code values. It
* represents the way the file is stored. Example character encodings are
* ISO-8859-1, ISO-8859-5, Shift-jis, Euc-jp, and UTF-8. When the file is
- * passed to an user agent (JEditorPane) it is converted to
+ * passed to an user agent ({@code JEditorPane}) it is converted to
* the document character set (ISO-10646 aka Unicode).
* JEditorPane.
+ * with {@code JEditorPane}.
*
*
*
* EditorKit.read operation throw a
- * ChangedCharSetException which will
+ * {@code EditorKit}.read operation throw a
+ * {@code ChangedCharSetException} which will
* be caught. The read is then restarted with a new Reader that uses
- * the character set specified in the ChangedCharSetException
- * (which is an IOException).
+ * the character set specified in the {@code ChangedCharSetException}
+ * (which is an {@code IOException}).
*
@@ -181,7 +181,7 @@
* appropriate for short term storage or RMI between applications running
* the same version of Swing. As of 1.4, support for long term storage
* of all JavaBeans™
- * has been added to the
java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @beaninfo
@@ -195,8 +195,8 @@
public class JEditorPane extends JTextComponent {
/**
- * Creates a new JEditorPane.
- * The document model is set to null.
+ * Creates a new {@code JEditorPane}.
+ * The document model is set to {@code null}.
*/
public JEditorPane() {
super();
@@ -256,10 +256,10 @@
}
/**
- * Creates a JEditorPane based on a specified URL for input.
+ * Creates a {@code JEditorPane} based on a specified URL for input.
*
* @param initialPage the URL
- * @exception IOException if the URL is null
+ * @exception IOException if the URL is {@code null}
* or cannot be accessed
*/
public JEditorPane(URL initialPage) throws IOException {
@@ -268,11 +268,11 @@
}
/**
- * Creates a JEditorPane based on a string containing
+ * Creates a {@code JEditorPane} based on a string containing
* a URL specification.
*
* @param url the URL
- * @exception IOException if the URL is null or
+ * @exception IOException if the URL is {@code null} or
* cannot be accessed
*/
public JEditorPane(String url) throws IOException {
@@ -281,14 +281,14 @@
}
/**
- * Creates a JEditorPane that has been initialized
+ * Creates a {@code JEditorPane} that has been initialized
* to the given text. This is a convenience constructor that calls the
- * setContentType and setText methods.
+ * {@code setContentType} and {@code setText} methods.
*
* @param type mime type of the given text
- * @param text the text to initialize with; may be null
- * @exception NullPointerException if the type parameter
- * is null
+ * @param text the text to initialize with; may be {@code null}
+ * @exception NullPointerException if the {@code type} parameter
+ * is {@code null}
*/
public JEditorPane(String type, String text) {
this();
@@ -316,10 +316,10 @@
}
/**
- * Returns an array of all the HyperLinkListeners added
+ * Returns an array of all the {@code HyperLinkListener}s added
* to this JEditorPane with addHyperlinkListener().
*
- * @return all of the HyperLinkListeners added or an empty
+ * @return all of the {@code HyperLinkListener}s added or an empty
* array if no listeners have been added
* @since 1.4
*/
@@ -330,7 +330,7 @@
/**
* Notifies all listeners that have registered interest for
* notification on this event type. This is normally called
- * by the currently installed EditorKit if a content type
+ * by the currently installed {@code EditorKit} if a content type
* that supports hyperlinks is currently active and there
* was activity with a link. The listener list is processed
* last to first.
@@ -354,10 +354,10 @@
/**
* Sets the current URL being displayed. The content type of the
* pane is set, and if the editor kit for the pane is
- * non-null, then
+ * non-{@code null}, then
* a new default document is created and the URL is read into it.
* If the URL contains and reference location, the location will
- * be scrolled to by calling the scrollToReference
+ * be scrolled to by calling the {@code scrollToReference}
* method. If the desired URL is the one currently being displayed,
* the document will not be reloaded. To force a document
* reload it is necessary to clear the stream description property
@@ -369,22 +369,22 @@
*
*
* If the desired URL is not the one currently being
- * displayed, the getStream method is called to
+ * displayed, the {@code getStream} method is called to
* give subclasses control over the stream provided.
* EditorKit.
- * If the Document is of type
- * AbstractDocument and has a value returned by
- * AbstractDocument.getAsynchronousLoadPriority
+ * depending upon the document returned by the {@code EditorKit}.
+ * If the {@code Document} is of type
+ * {@code AbstractDocument} and has a value returned by
+ * {@code AbstractDocument.getAsynchronousLoadPriority}
* that is greater than or equal to zero, the page will be
* loaded on a separate thread using that priority.
* setDocument, which
+ * the editor with a call to {@code setDocument}, which
* is bound and will fire a property change event. If an
- * IOException is thrown the partially loaded
+ * {@code IOException} is thrown the partially loaded
* document will
* be discarded and neither the document or page property
* change events will be fired. If the document is
@@ -395,20 +395,20 @@
* setDocument which will fire a
+ * call to {@code setDocument} which will fire a
* document property change event, then a thread will be
* created which will begin doing the actual loading.
* In this case, the page property change event will not be
* fired by the call to this method directly, but rather will be
* fired when the thread doing the loading has finished.
* It will also be fired on the event-dispatch thread.
- * Since the calling thread can not throw an IOException
+ * Since the calling thread can not throw an {@code IOException}
* in the event of failure on the other thread, the page
* property change event will be fired when the other
* thread is done whether the load was successful or not.
*
* @param page the URL of the page
- * @exception IOException for a null or invalid
+ * @exception IOException for a {@code null} or invalid
* page specification, or exception from the stream being read
* @see #getPage
* @beaninfo
@@ -518,9 +518,9 @@
/**
* This method initializes from a stream. If the kit is
- * set to be of type HTMLEditorKit, and the
- * desc parameter is an HTMLDocument,
- * then it invokes the HTMLEditorKit to initiate
+ * set to be of type {@code HTMLEditorKit}, and the
+ * {@code desc} parameter is an {@code HTMLDocument},
+ * then it invokes the {@code HTMLEditorKit} to initiate
* the read. Otherwise it calls the superclass
* method which loads the model as plain text.
*
@@ -548,10 +548,10 @@
/**
- * This method invokes the EditorKit to initiate a
- * read. In the case where a ChangedCharSetException
+ * This method invokes the {@code EditorKit} to initiate a
+ * read. In the case where a {@code ChangedCharSetException}
* is thrown this exception will contain the new CharSet.
- * Therefore the read operation
+ * Therefore the {@code read} operation
* is then restarted after building a new Reader with the new charset.
*
* @param in the inputstream to use
@@ -710,7 +710,7 @@
/**
* Fetches a stream for the given URL, which is about to
- * be loaded by the setPage method. By
+ * be loaded by the {@code setPage} method. By
* default, this simply opens the URL and returns the
* stream. This can be reimplemented to do useful things
* like fetch the stream from a cache, monitor the progress
@@ -718,11 +718,11 @@
* EditorKit to use for loading the stream.
+ * appropriate {@code EditorKit} to use for loading the stream.
* Document.StreamDescriptionProperty so that relative
+ * the {@code Document.StreamDescriptionProperty} so that relative
* URL's can be properly resolved.
*
* @param page the URL of the page
@@ -818,11 +818,11 @@
/**
* Scrolls the view to the given reference location
- * (that is, the value returned by the UL.getRef
+ * (that is, the value returned by the {@code UL.getRef}
* method for the URL being displayed). By default, this
* method only knows how to locate a reference in an
* HTMLDocument. The implementation calls the
- * scrollRectToVisible method to
+ * {@code scrollRectToVisible} method to
* accomplish the actual scrolling. If scrolling to a
* reference location is needed for document types other
* than HTML, this method should be reimplemented.
@@ -864,10 +864,10 @@
/**
* Gets the current URL being displayed. If a URL was
* not specified in the creation of the document, this
- * will return null, and relative URL's will not be
+ * will return {@code null}, and relative URL's will not be
* resolved.
*
- * @return the URL, or null if none
+ * @return the URL, or {@code null} if none
*/
public URL getPage() {
return (URL) getDocument().getProperty(Document.StreamDescriptionProperty);
@@ -877,7 +877,7 @@
* Sets the current URL being displayed.
*
* @param url the URL for display
- * @exception IOException for a null or invalid URL
+ * @exception IOException for a {@code null} or invalid URL
* specification
*/
public void setPage(String url) throws IOException {
@@ -900,7 +900,7 @@
}
/**
- * Creates the default editor kit (PlainEditorKit) for when
+ * Creates the default editor kit ({@code PlainEditorKit}) for when
* the component is first created.
*
* @return the editor kit
@@ -911,7 +911,7 @@
/**
* Fetches the currently installed kit for handling content.
- * createDefaultEditorKit is called to set up a default
+ * {@code createDefaultEditorKit} is called to set up a default
* if necessary.
*
* @return the editor kit
@@ -928,9 +928,9 @@
* Gets the type of content that this editor
* is currently set to deal with. This is
* defined to be the type associated with the
- * currently installed EditorKit.
+ * currently installed {@code EditorKit}.
*
- * @return the content type, null if no editor kit set
+ * @return the content type, {@code null} if no editor kit set
*/
public final String getContentType() {
return (kit != null) ? kit.getContentType() : null;
@@ -938,32 +938,32 @@
/**
* Sets the type of content that this editor
- * handles. This calls getEditorKitForContentType,
- * and then setEditorKit if an editor kit can
+ * handles. This calls {@code getEditorKitForContentType},
+ * and then {@code setEditorKit} if an editor kit can
* be successfully located. This is mostly convenience method
* that can be used as an alternative to calling
- * setEditorKit directly.
+ * {@code setEditorKit} directly.
* EditorKit.
+ * loading input streams using the associated {@code EditorKit}.
* For example if the type is specified as
- * text/html; charset=EUC-JP the content
- * will be loaded using the EditorKit registered for
- * text/html and the Reader provided to
- * the EditorKit to load unicode into the document will
- * use the EUC-JP charset for translating
+ * {@code text/html; charset=EUC-JP} the content
+ * will be loaded using the {@code EditorKit} registered for
+ * {@code text/html} and the Reader provided to
+ * the {@code EditorKit} to load unicode into the document will
+ * use the {@code EUC-JP} charset for translating
* to unicode. If the type is not recognized, the content
- * will be loaded using the EditorKit registered
- * for plain text, text/plain.
+ * will be loaded using the {@code EditorKit} registered
+ * for plain text, {@code text/plain}.
*
- * @param type the non-null mime type for the content editing
+ * @param type the non-{@code null} mime type for the content editing
* support
* @see #getContentType
* @beaninfo
* description: the type of content
- * @throws NullPointerException if the type parameter
- * is null
+ * @throws NullPointerException if the {@code type} parameter
+ * is {@code null}
*/
public final void setContentType(String type) {
// The type could have optional info is part of it,
@@ -1032,15 +1032,15 @@
* content. This is the bound property that
* establishes the content type of the editor.
* Any old kit is first deinstalled, then if kit is
- * non-null,
+ * non-{@code null},
* the new kit is installed, and a default document created for it.
- * A PropertyChange event ("editorKit") is always fired when
- * setEditorKit is called.
+ * A {@code PropertyChange} event ("editorKit") is always fired when
+ * {@code setEditorKit} is called.
* EditorKit is the source of how a
+ * because the {@code EditorKit} is the source of how a
* particular type
- * of content is modeled. This method will cause setDocument
+ * of content is modeled. This method will cause {@code setDocument}
* to be called on behalf of the caller to ensure integrity
* of the internal state.
*
@@ -1069,10 +1069,10 @@
* Fetches the editor kit to use for the given type
* of content. This is called when a type is requested
* that doesn't match the currently installed type.
- * If the component doesn't have an EditorKit registered
+ * If the component doesn't have an {@code EditorKit} registered
* for the given type, it will try to create an
- * EditorKit from the default EditorKit registry.
- * If that fails, a PlainEditorKit is used on the
+ * {@code EditorKit} from the default {@code EditorKit} registry.
+ * If that fails, a {@code PlainEditorKit} is used on the
* assumption that all text documents can be represented
* as plain text.
* null content type
+ * @param type the non-{@code null} content type
* @return the editor kit
*/
public EditorKit getEditorKitForContentType(String type) {
@@ -1104,10 +1104,10 @@
/**
* Directly sets the editor kit to use for the given type. A
* look-and-feel implementation might use this in conjunction
- * with createEditorKitForContentType to install handlers for
+ * with {@code createEditorKitForContentType} to install handlers for
* content types with a look-and-feel bias.
*
- * @param type the non-null content type
+ * @param type the non-{@code null} content type
* @param k the editor kit to be set
*/
public void setEditorKitForContentType(String type, EditorKit k) {
@@ -1122,13 +1122,13 @@
* represented by the given string. If there is no selection
* this amounts to an insert of the given text. If there
* is no replacement text (i.e. the content string is empty
- * or null) this amounts to a removal of the
+ * or {@code null}) this amounts to a removal of the
* current selection. The replacement text will have the
* attributes currently defined for input. If the component is not
* editable, beep and return.
*
* @param content the content to replace the selection with. This
- * value can be null
+ * value can be {@code null}
*/
@Override
public void replaceSelection(String content) {
@@ -1174,16 +1174,16 @@
* of editor kits. The registry is created if necessary. If the
* registered class has not yet been loaded, an attempt
* is made to dynamically load the prototype of the kit for the
- * given type. If the type was registered with a ClassLoader,
- * that ClassLoader will be used to load the prototype.
- * If there was no registered ClassLoader,
- * Class.forName will be used to load the prototype.
+ * given type. If the type was registered with a {@code ClassLoader},
+ * that {@code ClassLoader} will be used to load the prototype.
+ * If there was no registered {@code ClassLoader},
+ * {@code Class.forName} will be used to load the prototype.
* EditorKit instance is successfully
+ * Once a prototype {@code EditorKit} instance is successfully
* located, it is cloned and the clone is returned.
*
* @param type the content type
- * @return the editor kit, or null if there is nothing
+ * @return the editor kit, or {@code null} if there is nothing
* registered for the given type
*/
public static EditorKit createEditorKitForContentType(String type) {
@@ -1219,15 +1219,15 @@
}
/**
- * Establishes the default bindings of type to
- * classname.
+ * Establishes the default bindings of {@code type} to
+ * {@code classname}.
* The class will be dynamically loaded later when actually
* needed, and can be safely changed before attempted uses
* to avoid loading unwanted classes. The prototype
- * EditorKit will be loaded with Class.forName
+ * {@code EditorKit} will be loaded with {@code Class.forName}
* when registered with this method.
*
- * @param type the non-null content type
+ * @param type the non-{@code null} content type
* @param classname the class to load later
*/
public static void registerEditorKitForContentType(String type, String classname) {
@@ -1236,16 +1236,16 @@
}
/**
- * Establishes the default bindings of type to
- * classname.
+ * Establishes the default bindings of {@code type} to
+ * {@code classname}.
* The class will be dynamically loaded later when actually
- * needed using the given ClassLoader,
+ * needed using the given {@code ClassLoader},
* and can be safely changed
* before attempted uses to avoid loading unwanted classes.
*
- * @param type the non-null content type
+ * @param type the non-{@code null} content type
* @param classname the class to load later
- * @param loader the ClassLoader to use to load the name
+ * @param loader the {@code ClassLoader} to use to load the name
*/
public static void registerEditorKitForContentType(String type, String classname, ClassLoader loader) {
getKitTypeRegistry().put(type, classname);
@@ -1327,8 +1327,8 @@
// --- java.awt.Component methods --------------------------
/**
- * Returns the preferred size for the JEditorPane.
- * The preferred size for JEditorPane is slightly altered
+ * Returns the preferred size for the {@code JEditorPane}.
+ * The preferred size for {@code JEditorPane} is slightly altered
* from the preferred size of the superclass. If the size
* of the viewport has become smaller than the minimum size
* of the component, the scrollable definition for tracking
@@ -1340,7 +1340,7 @@
* shrink down to their minimum size and then be laid out at
* their minimum size, refusing to shrink any further.
*
- * @return a Dimension containing the preferred size
+ * @return a {@code Dimension} containing the preferred size
*/
public Dimension getPreferredSize() {
Dimension d = super.getPreferredSize();
@@ -1376,15 +1376,15 @@
// --- JTextComponent methods -----------------------------
/**
- * Sets the text of this TextComponent to the specified
+ * Sets the text of this {@code TextComponent} to the specified
* content,
* which is expected to be in the format of the content type of
- * this editor. For example, if the type is set to text/html
+ * this editor. For example, if the type is set to {@code text/html}
* the string should be specified in terms of HTML.
* EditorKit. This gives the semantics of the
+ * {@code EditorKit}. This gives the semantics of the
* superclass by not changing
* out the model, while supporting the content type currently set on
* this component. The assumption is that the previous content is
@@ -1392,9 +1392,9 @@
* small, and that the previous content doesn't have side effects.
* Both of those assumptions can be violated and cause undesirable results.
* To avoid this, create a new document,
- * getEditorKit().createDefaultDocument(), and replace the
- * existing Document with the new one. You are then assured the
- * previous Document won't have any lingering state.
+ * {@code getEditorKit().createDefaultDocument()}, and replace the
+ * existing {@code Document} with the new one. You are then assured the
+ * previous {@code Document} won't have any lingering state.
*
*
null the old
+ * @param t the new text to be set; if {@code null} the old
* text will be deleted
* @see #getText
* @beaninfo
@@ -1435,12 +1435,12 @@
}
/**
- * Returns the text contained in this TextComponent
+ * Returns the text contained in this {@code TextComponent}
* in terms of the
* content type of this editor. If an exception is thrown while
- * attempting to retrieve the text, null will be returned.
- * This is implemented to call JTextComponent.write with
- * a StringWriter.
+ * attempting to retrieve the text, {@code null} will be returned.
+ * This is implemented to call {@code JTextComponent.write} with
+ * a {@code StringWriter}.
*
* @return the text
* @see #setText
@@ -1461,7 +1461,7 @@
/**
* Returns true if a viewport should always force the width of this
- * Scrollable to match the width of the viewport.
+ * {@code Scrollable} to match the width of the viewport.
*
* @return true if a viewport should force the Scrollables width to
* match its own, false otherwise
@@ -1483,10 +1483,10 @@
/**
* Returns true if a viewport should always force the height of this
- * Scrollable to match the height of the viewport.
+ * {@code Scrollable} to match the height of the viewport.
*
* @return true if a viewport should force the
- * Scrollable's height to match its own,
+ * {@code Scrollable}'s height to match its own,
* false otherwise
*/
public boolean getScrollableTracksViewportHeight() {
@@ -1509,8 +1509,8 @@
// --- Serialization ------------------------------------
/**
- * See readObject and writeObject in
- * JComponent for more
+ * See {@code readObject} and {@code writeObject} in
+ * {@code JComponent} for more
* information about serialization in Swing.
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -1568,7 +1568,7 @@
* Boolean.TRUE.
+ * to {@code Boolean.TRUE}.
*
* @since 1.5
*/
@@ -1582,7 +1582,7 @@
* Boolean.TRUE.
+ * this name to {@code Boolean.TRUE}.
*
* @since 1.5
*/
@@ -1591,14 +1591,14 @@
static final MapJEditorPane.
+ * Returns a string representation of this {@code JEditorPane}.
* This method
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JEditorPane
+ * @return a string representation of this {@code JEditorPane}
*/
protected String paramString() {
String kitString = (kit != null ?
@@ -1641,7 +1641,7 @@
/**
* This class implements accessibility support for the
- * JEditorPane class. It provides an implementation of the
+ * {@code JEditorPane} class. It provides an implementation of the
* Java Accessibility API appropriate to editor pane user-interface
* elements.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
@@ -1660,9 +1660,9 @@
/**
* Gets the accessibleDescription property of this object. If this
* property isn't set, returns the content type of this
- * JEditorPane instead (e.g. "plain/text", "html/text").
+ * {@code JEditorPane} instead (e.g. "plain/text", "html/text").
*
- * @return the localized description of the object; null
+ * @return the localized description of the object; {@code null}
* if this object does not have a description
*
* @see #setAccessibleName
@@ -1695,10 +1695,10 @@
}
/**
- * This class provides support for AccessibleHypertext,
- * and is used in instances where the EditorKit
- * installed in this JEditorPane is an instance of
- * HTMLEditorKit.
+ * This class provides support for {@code AccessibleHypertext},
+ * and is used in instances where the {@code EditorKit}
+ * installed in this {@code JEditorPane} is an instance of
+ * {@code HTMLEditorKit}.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*/
@SuppressWarnings("serial") // Same-version serialization only
@@ -1790,11 +1790,11 @@
/**
* What's returned by
- * AccessibleJEditorPaneHTML.getAccessibleText.
+ * {@code AccessibleJEditorPaneHTML.getAccessibleText}.
*
- * Provides support for AccessibleHypertext in case
+ * Provides support for {@code AccessibleHypertext} in case
* there is an HTML document being displayed in this
- * JEditorPane.
+ * {@code JEditorPane}.
*
*/
protected class JEditorPaneAccessibleHypertextSupport
--- old/src/java.desktop/share/classes/javax/swing/JFileChooser.java 2015-10-04 22:56:47.189263214 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JFileChooser.java 2015-10-04 22:56:47.001263222 +0400
@@ -55,9 +55,9 @@
import java.lang.ref.WeakReference;
/**
- * JFileChooser provides a simple mechanism for the user to
+ * {@code JFileChooser} provides a simple mechanism for the user to
* choose a file.
- * For information about using JFileChooser, see
+ * For information about using {@code JFileChooser}, see
* How to Use File Choosers,
* a section in The Java Tutorial.
@@ -104,19 +104,19 @@
// ************************
/**
- * Type value indicating that the JFileChooser supports an
+ * Type value indicating that the {@code JFileChooser} supports an
* "Open" file operation.
*/
public static final int OPEN_DIALOG = 0;
/**
- * Type value indicating that the JFileChooser supports a
+ * Type value indicating that the {@code JFileChooser} supports a
* "Save" file operation.
*/
public static final int SAVE_DIALOG = 1;
/**
- * Type value indicating that the JFileChooser supports a
+ * Type value indicating that the {@code JFileChooser} supports a
* developer-specified file operation.
*/
public static final int CUSTOM_DIALOG = 2;
@@ -290,7 +290,7 @@
// *************************************
/**
- * Constructs a JFileChooser pointing to the user's
+ * Constructs a {@code JFileChooser} pointing to the user's
* default directory. This default depends on the operating system.
* It is typically the "My Documents" folder on Windows, and the
* user's home directory on Unix.
@@ -300,14 +300,14 @@
}
/**
- * Constructs a JFileChooser using the given path.
- * Passing in a null
+ * Constructs a {@code JFileChooser} using the given path.
+ * Passing in a {@code null}
* string causes the file chooser to point to the user's default directory.
* This default depends on the operating system. It is
* typically the "My Documents" folder on Windows, and the user's
* home directory on Unix.
*
- * @param currentDirectoryPath a String giving the path
+ * @param currentDirectoryPath a {@code String} giving the path
* to a file or directory
*/
public JFileChooser(String currentDirectoryPath) {
@@ -315,14 +315,14 @@
}
/**
- * Constructs a JFileChooser using the given File
- * as the path. Passing in a null file
+ * Constructs a {@code JFileChooser} using the given {@code File}
+ * as the path. Passing in a {@code null} file
* causes the file chooser to point to the user's default directory.
* This default depends on the operating system. It is
* typically the "My Documents" folder on Windows, and the user's
* home directory on Unix.
*
- * @param currentDirectory a File object specifying
+ * @param currentDirectory a {@code File} object specifying
* the path to a file or directory
*/
public JFileChooser(File currentDirectory) {
@@ -330,8 +330,8 @@
}
/**
- * Constructs a JFileChooser using the given
- * FileSystemView.
+ * Constructs a {@code JFileChooser} using the given
+ * {@code FileSystemView}.
*
* @param fsv a {@code FileSystemView}
*/
@@ -341,8 +341,8 @@
/**
- * Constructs a JFileChooser using the given current directory
- * and FileSystemView.
+ * Constructs a {@code JFileChooser} using the given current directory
+ * and {@code FileSystemView}.
*
* @param currentDirectory a {@code File} object specifying the path to a
* file or directory
@@ -354,8 +354,8 @@
}
/**
- * Constructs a JFileChooser using the given current directory
- * path and FileSystemView.
+ * Constructs a {@code JFileChooser} using the given current directory
+ * path and {@code FileSystemView}.
*
* @param currentDirectoryPath a {@code String} specifying the path to a file
* or directory
@@ -418,15 +418,15 @@
}
/**
- * Sets the dragEnabled property,
- * which must be true to enable
+ * Sets the {@code dragEnabled} property,
+ * which must be {@code true} to enable
* automatic drag handling (the first part of drag and drop)
* on this component.
- * The transferHandler property needs to be set
- * to a non-null value for the drag to do
- * anything. The default value of the dragEnabled
+ * The {@code transferHandler} property needs to be set
+ * to a non-{@code null} value for the drag to do
+ * anything. The default value of the {@code dragEnabled}
* property
- * is false.
+ * is {@code false}.
*
* true
+ * Setting this property to {@code true}
* can therefore have a subtle effect on
* how selections behave.
*
@@ -443,14 +443,14 @@
* Some look and feels might not support automatic drag and drop;
* they will ignore this property. You can work around such
* look and feels by modifying the component
- * to directly call the exportAsDrag method of a
- * TransferHandler.
+ * to directly call the {@code exportAsDrag} method of a
+ * {@code TransferHandler}.
*
- * @param b the value to set the dragEnabled property to
+ * @param b the value to set the {@code dragEnabled} property to
* @exception HeadlessException if
- * b is true and
- * GraphicsEnvironment.isHeadless()
- * returns true
+ * {@code b} is {@code true} and
+ * {@code GraphicsEnvironment.isHeadless()}
+ * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #getDragEnabled
* @see #setTransferHandler
@@ -473,9 +473,9 @@
}
/**
- * Gets the value of the dragEnabled property.
+ * Gets the value of the {@code dragEnabled} property.
*
- * @return the value of the dragEnabled property
+ * @return the value of the {@code dragEnabled} property
* @see #setDragEnabled
* @since 1.4
*/
@@ -489,7 +489,7 @@
/**
* Returns the selected file. This can be set either by the
- * programmer via setSelectedFile or by a user action, such as
+ * programmer via {@code setSelectedFile} or by a user action, such as
* either typing the filename into the UI or selecting the
* file from a list in the UI.
*
@@ -574,13 +574,13 @@
}
/**
- * Sets the current directory. Passing in null sets the
+ * Sets the current directory. Passing in {@code null} sets the
* file chooser to point to the user's default directory.
* This default depends on the operating system. It is
* typically the "My Documents" folder on Windows, and the user's
* home directory on Unix.
*
- * If the file passed in as currentDirectory is not a
+ * If the file passed in as {@code currentDirectory} is not a
* directory, the parent of the file will be used as the currentDirectory.
* If the parent is not traversable, then it will walk up the parent tree
* until it finds a traversable directory, or hits the root of the
@@ -659,8 +659,8 @@
* the L&F.
*
* @param parent the parent component of the dialog,
- * can be null;
- * see showDialog for details
+ * can be {@code null};
+ * see {@code showDialog} for details
* @return the return state of the file chooser on popdown:
*
*
null;
- * see showDialog for details
+ * can be {@code null};
+ * see {@code showDialog} for details
* @return the return state of the file chooser on popdown:
*
*
parent argument determines two things:
+ * The {@code parent} argument determines two things:
* the frame on which the open dialog depends and
* the component whose position the look and feel
* should consider when placing the dialog. If the parent
- * is a Frame object (such as a JFrame)
+ * is a {@code Frame} object (such as a {@code JFrame})
* then the dialog depends on the frame and
* the look and feel positions the dialog
* relative to the frame (for example, centered over the frame).
@@ -738,14 +738,14 @@
* depends on the frame containing the component,
* and is positioned relative to the component
* (for example, centered over the component).
- * If the parent is null, then the dialog depends on
+ * If the parent is {@code null}, then the dialog depends on
* no visible window, and it's placed in a
* look-and-feel-dependent position
* such as the center of the screen.
*
* @param parent the parent component of the dialog;
- * can be null
- * @param approveButtonText the text of the ApproveButton
+ * can be {@code null}
+ * @param approveButtonText the text of the {@code ApproveButton}
* @return the return state of the file chooser on popdown:
*
*
JDialog wrapping
- * this centered on the parent
- * in the parent's frame.
+ * Creates and returns a new {@code JDialog} wrapping
+ * {@code this} centered on the {@code parent}
+ * in the {@code parent}'s frame.
* This method can be overriden to further manipulate the dialog,
* to disable resizing, set the location, etc. Example:
*
@@ -808,8 +808,8 @@
*
*
* @param parent the parent component of the dialog;
- * can be null
- * @return a new JDialog containing this instance
+ * can be {@code null}
+ * @return a new {@code JDialog} containing this instance
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -852,10 +852,10 @@
// **************************
/**
- * Returns the value of the controlButtonsAreShown
+ * Returns the value of the {@code controlButtonsAreShown}
* property.
*
- * @return the value of the controlButtonsAreShown
+ * @return the value of the {@code controlButtonsAreShown}
* property
*
* @see #setControlButtonsAreShown
@@ -870,16 +870,16 @@
* Sets the property
* that indicates whether the approve and cancel
* buttons are shown in the file chooser. This property
- * is true by default. Look and feels
+ * is {@code true} by default. Look and feels
* that always show these buttons will ignore the value
* of this property.
* This method fires a property-changed event,
* using the string value of
- * CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
+ * {@code CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY}
* as the name of the property.
*
- * @param b false if control buttons should not be
- * shown; otherwise, true
+ * @param b {@code false} if control buttons should not be
+ * shown; otherwise, {@code true}
*
* @beaninfo
* preferred: true
@@ -901,7 +901,7 @@
/**
* Returns the type of this dialog. The default is
- * JFileChooser.OPEN_DIALOG.
+ * {@code JFileChooser.OPEN_DIALOG}.
*
* @return the type of dialog to be displayed:
*
@@ -917,18 +917,18 @@
}
/**
- * Sets the type of this dialog. Use
OPEN_DIALOG when you
+ * Sets the type of this dialog. Use {@code OPEN_DIALOG} when you
* want to bring up a file chooser that the user can use to open a file.
- * Likewise, use SAVE_DIALOG for letting the user choose
+ * Likewise, use {@code SAVE_DIALOG} for letting the user choose
* a file for saving.
- * Use CUSTOM_DIALOG when you want to use the file
+ * Use {@code CUSTOM_DIALOG} when you want to use the file
* chooser in a context other than "Open" or "Save".
* For instance, you might want to bring up a file chooser that allows
* the user to choose a file to execute. Note that you normally would not
- * need to set the JFileChooser to use
- * CUSTOM_DIALOG
- * since a call to setApproveButtonText does this for you.
- * The default dialog type is JFileChooser.OPEN_DIALOG.
+ * need to set the {@code JFileChooser} to use
+ * {@code CUSTOM_DIALOG}
+ * since a call to {@code setApproveButtonText} does this for you.
+ * The default dialog type is {@code JFileChooser.OPEN_DIALOG}.
*
* @param dialogType the type of dialog to be displayed:
*
@@ -937,7 +937,7 @@
*
*
- * @exception IllegalArgumentException if dialogType is
+ * @exception IllegalArgumentException if {@code dialogType} is
* not legal
* @beaninfo
* preferred: true
@@ -974,10 +974,10 @@
}
/**
- * Sets the string that goes in the JFileChooser window's
+ * Sets the string that goes in the {@code JFileChooser} window's
* title bar.
*
- * @param dialogTitle the new String for the title bar
+ * @param dialogTitle the new {@code String} for the title bar
*
* @beaninfo
* preferred: true
@@ -997,7 +997,7 @@
}
/**
- * Gets the string that goes in the JFileChooser's titlebar.
+ * Gets the string that goes in the {@code JFileChooser}'s titlebar.
*
* @return the string from the {@code JFileChooser} window's title bar
* @see #setDialogTitle
@@ -1013,8 +1013,8 @@
/**
- * Sets the tooltip text used in the ApproveButton.
- * If null, the UI object will determine the button's text.
+ * Sets the tooltip text used in the {@code ApproveButton}.
+ * If {@code null}, the UI object will determine the button's text.
*
* @beaninfo
* preferred: true
@@ -1037,8 +1037,8 @@
/**
- * Returns the tooltip text used in the ApproveButton.
- * If null, the UI object will determine the button's text.
+ * Returns the tooltip text used in the {@code ApproveButton}.
+ * If {@code null}, the UI object will determine the button's text.
*
* @return the tooltip text used for the approve button
*
@@ -1097,15 +1097,15 @@
/**
- * Sets the text used in the ApproveButton in the
- * FileChooserUI.
+ * Sets the text used in the {@code ApproveButton} in the
+ * {@code FileChooserUI}.
*
* @beaninfo
* preferred: true
* bound: true
* description: The text that goes in the ApproveButton.
*
- * @param approveButtonText the text used in the ApproveButton
+ * @param approveButtonText the text used in the {@code ApproveButton}
*
* @see #getApproveButtonText
* @see #setDialogType
@@ -1122,13 +1122,13 @@
}
/**
- * Returns the text used in the ApproveButton in the
- * FileChooserUI.
- * If null, the UI object will determine the button's text.
+ * Returns the text used in the {@code ApproveButton} in the
+ * {@code FileChooserUI}.
+ * If {@code null}, the UI object will determine the button's text.
*
* Typically, this would be "Open" or "Save".
*
- * @return the text used in the ApproveButton
+ * @return the text used in the {@code ApproveButton}
*
* @see #setApproveButtonText
* @see #setDialogType
@@ -1141,7 +1141,7 @@
/**
* Gets the list of user choosable file filters.
*
- * @return a FileFilter array containing all the choosable
+ * @return a {@code FileFilter} array containing all the choosable
* file filters
*
* @see #addChoosableFileFilter
@@ -1159,7 +1159,7 @@
* For information on setting the file selection mode, see
* {@link #setFileSelectionMode setFileSelectionMode}.
*
- * @param filter the FileFilter to add to the choosable file
+ * @param filter the {@code FileFilter} to add to the choosable file
* filter list
*
* @beaninfo
@@ -1227,7 +1227,7 @@
/**
* Resets the choosable file filter list to its starting state. Normally,
* this removes all added file filters while leaving the
- * AcceptAll file filter.
+ * {@code AcceptAll} file filter.
*
* @see #addChoosableFileFilter
* @see #getChoosableFileFilters
@@ -1244,7 +1244,7 @@
}
/**
- * Returns the AcceptAll file filter.
+ * Returns the {@code AcceptAll} file filter.
* For example, on Microsoft Windows this would be All Files (*.*).
*
* @return the {@code AcceptAll} file filter
@@ -1258,8 +1258,8 @@
}
/**
- * Returns whether the AcceptAll FileFilter is used.
- * @return true if the AcceptAll FileFilter is used
+ * Returns whether the {@code AcceptAll FileFilter} is used.
+ * @return true if the {@code AcceptAll FileFilter} is used
* @see #setAcceptAllFileFilterUsed
* @since 1.3
*/
@@ -1268,11 +1268,11 @@
}
/**
- * Determines whether the AcceptAll FileFilter is used
+ * Determines whether the {@code AcceptAll FileFilter} is used
* as an available choice in the choosable filter list.
- * If false, the AcceptAll file filter is removed from
+ * If false, the {@code AcceptAll} file filter is removed from
* the list of available file filters.
- * If true, the AcceptAll file filter will become the
+ * If true, the {@code AcceptAll} file filter will become the
* actively used file filter.
*
* @param b a {@code boolean} which determines whether the {@code AcceptAll}
@@ -1332,10 +1332,10 @@
}
/**
- * Sets the JFileChooser to allow the user to just
+ * Sets the {@code JFileChooser} to allow the user to just
* select files, just select
* directories, or select both files and directories. The default is
- * JFilesChooser.FILES_ONLY.
+ * {@code JFilesChooser.FILES_ONLY}.
*
* @param mode the type of files to be displayed:
*
@@ -1344,7 +1344,7 @@
*
*
- * @exception IllegalArgumentException if mode is an
+ * @exception IllegalArgumentException if {@code mode} is an
* illegal file selection mode
* @beaninfo
* preferred: true
@@ -1378,7 +1378,7 @@
/**
* Returns the current file-selection mode. The default is
- * JFilesChooser.FILES_ONLY.
+ * {@code JFilesChooser.FILES_ONLY}.
*
* @return the type of files to be displayed, one of the following:
*
@@ -1459,7 +1459,7 @@
/**
* Sets file hiding on or off. If true, hidden files are not shown
* in the file chooser. The job of determining which files are
- * shown is done by the
FileView.
+ * shown is done by the {@code FileView}.
*
* @beaninfo
* preferred: true
@@ -1568,9 +1568,9 @@
/**
* Returns the filename.
- * @param f the File
- * @return the String containing the filename for
- * f
+ * @param f the {@code File}
+ * @return the {@code String} containing the filename for
+ * {@code f}
* @see FileView#getName
*/
public String getName(File f) {
@@ -1591,9 +1591,9 @@
/**
* Returns the file description.
- * @param f the File
- * @return the String containing the file description for
- * f
+ * @param f the {@code File}
+ * @return the {@code String} containing the file description for
+ * {@code f}
* @see FileView#getDescription
*/
public String getDescription(File f) {
@@ -1614,9 +1614,9 @@
/**
* Returns the file type.
- * @param f the File
- * @return the String containing the file type description for
- * f
+ * @param f the {@code File}
+ * @return the {@code String} containing the file type description for
+ * {@code f}
* @see FileView#getTypeDescription
*/
public String getTypeDescription(File f) {
@@ -1638,8 +1638,8 @@
/**
* Returns the icon for this file or type of file, depending
* on the system.
- * @param f the File
- * @return the Icon for this file, or type of file
+ * @param f the {@code File}
+ * @return the {@code Icon} for this file, or type of file
* @see FileView#getIcon
*/
public Icon getIcon(File f) {
@@ -1661,7 +1661,7 @@
/**
* Returns true if the file (directory) can be visited.
* Returns false if the directory cannot be traversed.
- * @param f the File
+ * @param f the {@code File}
* @return true if the file/directory can be traversed, otherwise false
* @see FileView#isTraversable
*/
@@ -1686,7 +1686,7 @@
/**
* Returns true if the file should be displayed.
- * @param f the File
+ * @param f the {@code File}
* @return true if the file should be displayed, otherwise false
* @see FileFilter#accept
*/
@@ -1699,10 +1699,10 @@
}
/**
- * Sets the file system view that the JFileChooser uses for
+ * Sets the file system view that the {@code JFileChooser} uses for
* accessing and creating file system resources, such as finding
* the floppy drive and getting a list of root drives.
- * @param fsv the new FileSystemView
+ * @param fsv the new {@code FileSystemView}
*
* @beaninfo
* expert: true
@@ -1719,7 +1719,7 @@
/**
* Returns the file system view.
- * @return the FileSystemView object
+ * @return the {@code FileSystemView} object
* @see #setFileSystemView
*/
public FileSystemView getFileSystemView() {
@@ -1736,7 +1736,7 @@
* called by the programmer.
* This method causes an action event to fire
* with the command string equal to
- * APPROVE_SELECTION.
+ * {@code APPROVE_SELECTION}.
*
* @see #APPROVE_SELECTION
*/
@@ -1753,7 +1753,7 @@
* This can also be called by the programmer.
* This method causes an action event to fire
* with the command string equal to
- * CANCEL_SELECTION.
+ * {@code CANCEL_SELECTION}.
*
* @see #CANCEL_SELECTION
*/
@@ -1766,7 +1766,7 @@
}
/**
- * Adds an ActionListener to the file chooser.
+ * Adds an {@code ActionListener} to the file chooser.
*
* @param l the listener to be added
*
@@ -1778,7 +1778,7 @@
}
/**
- * Removes an ActionListener from the file chooser.
+ * Removes an {@code ActionListener} from the file chooser.
*
* @param l the listener to be removed
*
@@ -1792,7 +1792,7 @@
* Returns an array of all the action listeners
* registered on this file chooser.
*
- * @return all of this file chooser's ActionListeners
+ * @return all of this file chooser's {@code ActionListener}s
* or an empty
* array if no action listeners are currently registered
*
@@ -1808,7 +1808,7 @@
/**
* Notifies all listeners that have registered interest for
* notification on this event type. The event instance
- * is lazily created using the command parameter.
+ * is lazily created using the {@code command} parameter.
*
* @param command a string that may specify a command associated with
* the event
@@ -1913,8 +1913,8 @@
}
/**
- * See readObject and writeObject in
- * JComponent for more
+ * See {@code readObject} and {@code writeObject} in
+ * {@code JComponent} for more
* information about serialization in Swing.
*/
private void readObject(java.io.ObjectInputStream in)
@@ -1960,8 +1960,8 @@
}
/**
- * See readObject and writeObject in
- * JComponent for more
+ * See {@code readObject} and {@code writeObject} in
+ * {@code JComponent} for more
* information about serialization in Swing.
*/
private void writeObject(ObjectOutputStream s) throws IOException {
@@ -1996,14 +1996,14 @@
/**
- * Returns a string representation of this JFileChooser.
+ * Returns a string representation of this {@code JFileChooser}.
* This method
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JFileChooser
+ * @return a string representation of this {@code JFileChooser}
*/
protected String paramString() {
String approveButtonTextString = (approveButtonText != null ?
@@ -2079,7 +2079,7 @@
/**
* This class implements accessibility support for the
- * JFileChooser class. It provides an implementation of the
+ * {@code JFileChooser} class. It provides an implementation of the
* Java Accessibility API appropriate to file chooser user-interface
* elements.
*/
--- old/src/java.desktop/share/classes/javax/swing/JFormattedTextField.java 2015-10-04 22:56:47.753263188 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JFormattedTextField.java 2015-10-04 22:56:47.565263197 +0400
@@ -35,49 +35,49 @@
import javax.swing.text.*;
/**
- * JFormattedTextField extends JTextField adding
+ * {@code JFormattedTextField} extends {@code JTextField} adding
* support for formatting arbitrary values, as well as retrieving a particular
* object once the user has edited the text. The following illustrates
- * configuring a JFormattedTextField to edit dates:
+ * configuring a {@code JFormattedTextField} to edit dates:
*
* JFormattedTextField ftf = new JFormattedTextField();
* ftf.setValue(new Date());
*
* JFormattedTextField has been created, you can
+ * Once a {@code JFormattedTextField} has been created, you can
* listen for editing changes by way of adding
- * a PropertyChangeListener and listening for
- * PropertyChangeEvents with the property name value.
+ * a {@code PropertyChangeListener} and listening for
+ * {@code PropertyChangeEvent}s with the property name {@code value}.
* JFormattedTextField allows
+ * {@code JFormattedTextField} allows
* configuring what action should be taken when focus is lost. The possible
* configurations are:
*
*
- * The default is JFormattedTextField.REVERT
- * Revert the display to match that of getValue,
+ * Revert the display to match that of {@code getValue},
* possibly losing the current edit.
* JFormattedTextField.COMMIT
* Commits the current value. If the value being edited
* isn't considered a legal value by the
- * AbstractFormatter that is, a
- * ParseException is thrown, then the value
+ * {@code AbstractFormatter} that is, a
+ * {@code ParseException} is thrown, then the value
* will not change, and then edited value will persist.
* JFormattedTextField.COMMIT_OR_REVERT
- * Similar to COMMIT, but if the value isn't
- * legal, behave like REVERT.
+ * Similar to {@code COMMIT}, but if the value isn't
+ * legal, behave like {@code REVERT}.
* JFormattedTextField.PERSIST
* Do nothing, don't obtain a new
- * AbstractFormatter, and don't update the value.
+ * {@code AbstractFormatter}, and don't update the value.
* JFormattedTextField.COMMIT_OR_REVERT,
+ * The default is {@code JFormattedTextField.COMMIT_OR_REVERT},
* refer to {@link #setFocusLostBehavior} for more information on this.
* JFormattedTextField allows the focus to leave, even if
+ * {@code JFormattedTextField} allows the focus to leave, even if
* the currently edited value is invalid. To lock the focus down while the
- * JFormattedTextField is an invalid edit state
- * you can attach an InputVerifier. The following code snippet
- * shows a potential implementation of such an InputVerifier:
+ * {@code JFormattedTextField} is an invalid edit state
+ * you can attach an {@code InputVerifier}. The following code snippet
+ * shows a potential implementation of such an {@code InputVerifier}:
*
* public class FormattedTextFieldVerifier extends InputVerifier {
* public boolean verify(JComponent input) {
@@ -102,63 +102,63 @@
* }
*
* commitEdit, which would also
+ * Alternatively, you could invoke {@code commitEdit}, which would also
* commit the value.
* JFormattedTextField does not do the formatting it self,
+ * {@code JFormattedTextField} does not do the formatting it self,
* rather formatting is done through an instance of
- * JFormattedTextField.AbstractFormatter which is obtained from
- * an instance of JFormattedTextField.AbstractFormatterFactory.
- * Instances of JFormattedTextField.AbstractFormatter are
+ * {@code JFormattedTextField.AbstractFormatter} which is obtained from
+ * an instance of {@code JFormattedTextField.AbstractFormatterFactory}.
+ * Instances of {@code JFormattedTextField.AbstractFormatter} are
* notified when they become active by way of the
- * install method, at which point the
- * JFormattedTextField.AbstractFormatter can install whatever
- * it needs to, typically a DocumentFilter. Similarly when
- * JFormattedTextField no longer
- * needs the AbstractFormatter, it will invoke
- * uninstall.
+ * {@code install} method, at which point the
+ * {@code JFormattedTextField.AbstractFormatter} can install whatever
+ * it needs to, typically a {@code DocumentFilter}. Similarly when
+ * {@code JFormattedTextField} no longer
+ * needs the {@code AbstractFormatter}, it will invoke
+ * {@code uninstall}.
* JFormattedTextField typically
- * queries the AbstractFormatterFactory for an
- * AbstractFormat when it gains or loses focus. Although this
+ * {@code JFormattedTextField} typically
+ * queries the {@code AbstractFormatterFactory} for an
+ * {@code AbstractFormat} when it gains or loses focus. Although this
* can change based on the focus lost policy. If the focus lost
- * policy is JFormattedTextField.PERSIST
- * and the JFormattedTextField has been edited, the
- * AbstractFormatterFactory will not be queried until the
+ * policy is {@code JFormattedTextField.PERSIST}
+ * and the {@code JFormattedTextField} has been edited, the
+ * {@code AbstractFormatterFactory} will not be queried until the
* value has been committed. Similarly if the focus lost policy is
- * JFormattedTextField.COMMIT and an exception
- * is thrown from stringToValue, the
- * AbstractFormatterFactory will not be queried when focus is
+ * {@code JFormattedTextField.COMMIT} and an exception
+ * is thrown from {@code stringToValue}, the
+ * {@code AbstractFormatterFactory} will not be queried when focus is
* lost or gained.
* JFormattedTextField.AbstractFormatter
+ * {@code JFormattedTextField.AbstractFormatter}
* is also responsible for determining when values are committed to
- * the JFormattedTextField. Some
- * JFormattedTextField.AbstractFormatters will make new values
+ * the {@code JFormattedTextField}. Some
+ * {@code JFormattedTextField.AbstractFormatter}s will make new values
* available on every edit, and others will never commit the value. You can
* force the current value to be obtained
- * from the current JFormattedTextField.AbstractFormatter
- * by way of invoking commitEdit. commitEdit will
+ * from the current {@code JFormattedTextField.AbstractFormatter}
+ * by way of invoking {@code commitEdit}. {@code commitEdit} will
* be invoked whenever return is pressed in the
- * JFormattedTextField.
+ * {@code JFormattedTextField}.
* AbstractFormatterFactory has not been explicitly
- * set, one will be set based on the Class of the value type after
- * setValue has been invoked (assuming value is non-null).
+ * If an {@code AbstractFormatterFactory} has not been explicitly
+ * set, one will be set based on the {@code Class} of the value type after
+ * {@code setValue} has been invoked (assuming value is non-null).
* For example, in the following code an appropriate
- * AbstractFormatterFactory and AbstractFormatter
+ * {@code AbstractFormatterFactory} and {@code AbstractFormatter}
* will be created to handle formatting of numbers:
*
* JFormattedTextField tf = new JFormattedTextField();
* tf.setValue(100);
*
* AbstractFormatter will
- * typically install a DocumentFilter on the
- * Document, and a NavigationFilter on the
- * JFormattedTextField you should not install your own. If you do,
+ * Warning: As the {@code AbstractFormatter} will
+ * typically install a {@code DocumentFilter} on the
+ * {@code Document}, and a {@code NavigationFilter} on the
+ * {@code JFormattedTextField} you should not install your own. If you do,
* you are likely to see odd behavior in that the editing policy of the
- * AbstractFormatter will not be enforced.
+ * {@code AbstractFormatter} will not be enforced.
* commitEdit should be invoked. If in committing the
- * new value a ParseException is thrown, the invalid
+ * {@code commitEdit} should be invoked. If in committing the
+ * new value a {@code ParseException} is thrown, the invalid
* value will remain.
*
* @see #setFocusLostBehavior
@@ -194,8 +194,8 @@
/**
* Constant identifying that when focus is lost,
- * commitEdit should be invoked. If in committing the new
- * value a ParseException is thrown, the value will be
+ * {@code commitEdit} should be invoked. If in committing the new
+ * value a {@code ParseException} is thrown, the value will be
* reverted.
*
* @see #setFocusLostBehavior
@@ -205,7 +205,7 @@
/**
* Constant identifying that when focus is lost, editing value should
* be reverted to current value set on the
- * JFormattedTextField.
+ * {@code JFormattedTextField}.
*
* @see #setFocusLostBehavior
*/
@@ -267,10 +267,10 @@
/**
- * Creates a JFormattedTextField with no
- * AbstractFormatterFactory. Use setMask or
- * setFormatterFactory to configure the
- * JFormattedTextField to edit a particular type of
+ * Creates a {@code JFormattedTextField} with no
+ * {@code AbstractFormatterFactory}. Use {@code setMask} or
+ * {@code setFormatterFactory} to configure the
+ * {@code JFormattedTextField} to edit a particular type of
* value.
*/
public JFormattedTextField() {
@@ -281,8 +281,8 @@
/**
* Creates a JFormattedTextField with the specified value. This will
- * create an AbstractFormatterFactory based on the
- * type of value.
+ * create an {@code AbstractFormatterFactory} based on the
+ * type of {@code value}.
*
* @param value Initial value for the JFormattedTextField
*/
@@ -292,9 +292,9 @@
}
/**
- * Creates a JFormattedTextField. format is
- * wrapped in an appropriate AbstractFormatter which is
- * then wrapped in an AbstractFormatterFactory.
+ * Creates a {@code JFormattedTextField}. {@code format} is
+ * wrapped in an appropriate {@code AbstractFormatter} which is
+ * then wrapped in an {@code AbstractFormatterFactory}.
*
* @param format Format used to look up an AbstractFormatter
*/
@@ -304,9 +304,9 @@
}
/**
- * Creates a JFormattedTextField with the specified
- * AbstractFormatter. The AbstractFormatter
- * is placed in an AbstractFormatterFactory.
+ * Creates a {@code JFormattedTextField} with the specified
+ * {@code AbstractFormatter}. The {@code AbstractFormatter}
+ * is placed in an {@code AbstractFormatterFactory}.
*
* @param formatter AbstractFormatter to use for formatting.
*/
@@ -315,8 +315,8 @@
}
/**
- * Creates a JFormattedTextField with the specified
- * AbstractFormatterFactory.
+ * Creates a {@code JFormattedTextField} with the specified
+ * {@code AbstractFormatterFactory}.
*
* @param factory AbstractFormatterFactory used for formatting.
*/
@@ -326,10 +326,10 @@
}
/**
- * Creates a JFormattedTextField with the specified
- * AbstractFormatterFactory and initial value.
+ * Creates a {@code JFormattedTextField} with the specified
+ * {@code AbstractFormatterFactory} and initial value.
*
- * @param factory AbstractFormatterFactory used for
+ * @param factory {@code AbstractFormatterFactory} used for
* formatting.
* @param currentValue Initial value to use
*/
@@ -341,18 +341,18 @@
/**
* Sets the behavior when focus is lost. This will be one of
- * JFormattedTextField.COMMIT_OR_REVERT,
- * JFormattedTextField.REVERT,
- * JFormattedTextField.COMMIT or
- * JFormattedTextField.PERSIST
- * Note that some AbstractFormatters may push changes as
+ * {@code JFormattedTextField.COMMIT_OR_REVERT},
+ * {@code JFormattedTextField.REVERT},
+ * {@code JFormattedTextField.COMMIT} or
+ * {@code JFormattedTextField.PERSIST}
+ * Note that some {@code AbstractFormatter}s may push changes as
* they occur, so that the value of this will have no effect.
* IllegalArgumentException if the object
+ * This will throw an {@code IllegalArgumentException} if the object
* passed in is not one of the afore mentioned values.
* JFormattedTextField.COMMIT_OR_REVERT.
+ * {@code JFormattedTextField.COMMIT_OR_REVERT}.
*
* @param behavior Identifies behavior when focus is lost
* @throws IllegalArgumentException if behavior is not one of the known
@@ -374,11 +374,11 @@
/**
* Returns the behavior when focus is lost. This will be one of
- * COMMIT_OR_REVERT,
- * COMMIT,
- * REVERT or
- * PERSIST
- * Note that some AbstractFormatters may push changes as
+ * {@code COMMIT_OR_REVERT},
+ * {@code COMMIT},
+ * {@code REVERT} or
+ * {@code PERSIST}
+ * Note that some {@code AbstractFormatter}s may push changes as
* they occur, so that the value of this will have no effect.
*
* @return returns behavior when focus is lost
@@ -388,25 +388,25 @@
}
/**
- * Sets the AbstractFormatterFactory.
- * AbstractFormatterFactory is
- * able to return an instance of AbstractFormatter that is
+ * Sets the {@code AbstractFormatterFactory}.
+ * {@code AbstractFormatterFactory} is
+ * able to return an instance of {@code AbstractFormatter} that is
* used to format a value for display, as well an enforcing an editing
* policy.
* AbstractFormatterFactory
+ * If you have not explicitly set an {@code AbstractFormatterFactory}
* by way of this method (or a constructor) an
- * AbstractFormatterFactory and consequently an
- * AbstractFormatter will be used based on the
- * Class of the value. NumberFormatter will
- * be used for Numbers, DateFormatter will
- * be used for Dates, otherwise DefaultFormatter
+ * {@code AbstractFormatterFactory} and consequently an
+ * {@code AbstractFormatter} will be used based on the
+ * {@code Class} of the value. {@code NumberFormatter} will
+ * be used for {@code Number}s, {@code DateFormatter} will
+ * be used for {@code Dates}, otherwise {@code DefaultFormatter}
* will be used.
* AbstractFormatterFactory used to lookup
- * instances of AbstractFormatter
+ * @param tf {@code AbstractFormatterFactory} used to lookup
+ * instances of {@code AbstractFormatter}
* @beaninfo
* bound: true
* attribute: visualUpdate true
@@ -422,27 +422,27 @@
}
/**
- * Returns the current AbstractFormatterFactory.
+ * Returns the current {@code AbstractFormatterFactory}.
*
* @see #setFormatterFactory
- * @return AbstractFormatterFactory used to determine
- * AbstractFormatters
+ * @return {@code AbstractFormatterFactory} used to determine
+ * {@code AbstractFormatter}s
*/
public AbstractFormatterFactory getFormatterFactory() {
return factory;
}
/**
- * Sets the current AbstractFormatter.
+ * Sets the current {@code AbstractFormatter}.
* AbstractFormatterFactory or set the value.
- * JFormattedTextField will
- * invoke this as the state of the JFormattedTextField
+ * {@code AbstractFormatterFactory} or set the value.
+ * {@code JFormattedTextField} will
+ * invoke this as the state of the {@code JFormattedTextField}
* changes and requires the value to be reset.
- * JFormattedTextField passes in the
- * AbstractFormatter obtained from the
- * AbstractFormatterFactory.
+ * {@code JFormattedTextField} passes in the
+ * {@code AbstractFormatter} obtained from the
+ * {@code AbstractFormatterFactory}.
* AbstractFormatter that is used to format and
+ * Returns the {@code AbstractFormatter} that is used to format and
* parse the current value.
*
* @return AbstractFormatter used for formatting
@@ -480,10 +480,10 @@
/**
* Sets the value that will be formatted by an
- * AbstractFormatter obtained from the current
- * AbstractFormatterFactory. If no
- * AbstractFormatterFactory has been specified, this will
- * attempt to create one based on the type of value.
+ * {@code AbstractFormatter} obtained from the current
+ * {@code AbstractFormatterFactory}. If no
+ * {@code AbstractFormatterFactory} has been specified, this will
+ * attempt to create one based on the type of {@code value}.
* AbstractFormatter this may not return the current
+ * the {@code AbstractFormatter} this may not return the current
* value. The currently edited value can be obtained by invoking
- * commitEdit followed by getValue.
+ * {@code commitEdit} followed by {@code getValue}.
*
* @return Last valid value
*/
@@ -516,11 +516,11 @@
/**
* Forces the current value to be taken from the
- * AbstractFormatter and set as the current value.
+ * {@code AbstractFormatter} and set as the current value.
* This has no effect if there is no current
- * AbstractFormatter installed.
+ * {@code AbstractFormatter} installed.
*
- * @throws ParseException if the AbstractFormatter is not able
+ * @throws ParseException if the {@code AbstractFormatter} is not able
* to format the current value
*/
public void commitEdit() throws ParseException {
@@ -534,7 +534,7 @@
/**
* Sets the validity of the edit on the receiver. You should not normally
* invoke this. This will be invoked by the
- * AbstractFormatter as the user edits the value.
+ * {@code AbstractFormatter} as the user edits the value.
* AbstractFormatter, as such
+ * this is managed by the current {@code AbstractFormatter}, as such
* there is no public setter for it.
*
* @return true if the current value being edited is valid.
@@ -579,10 +579,10 @@
/**
* Processes any input method events, such as
- * InputMethodEvent.INPUT_METHOD_TEXT_CHANGED or
- * InputMethodEvent.CARET_POSITION_CHANGED.
+ * {@code InputMethodEvent.INPUT_METHOD_TEXT_CHANGED} or
+ * {@code InputMethodEvent.CARET_POSITION_CHANGED}.
*
- * @param e the InputMethodEvent
+ * @param e the {@code InputMethodEvent}
* @see InputMethodEvent
*/
protected void processInputMethodEvent(InputMethodEvent e) {
@@ -603,10 +603,10 @@
/**
* Processes any focus events, such as
- * FocusEvent.FOCUS_GAINED or
- * FocusEvent.FOCUS_LOST.
+ * {@code FocusEvent.FOCUS_GAINED} or
+ * {@code FocusEvent.FOCUS_LOST}.
*
- * @param e the FocusEvent
+ * @param e the {@code FocusEvent}
* @see FocusEvent
*/
protected void processFocusEvent(FocusEvent e) {
@@ -730,7 +730,7 @@
/**
* Resets the Actions that come from the TextFormatter to
- * actions.
+ * {@code actions}.
*/
private void setFormatterActions(Action[] actions) {
if (actions == null) {
@@ -766,10 +766,10 @@
}
/**
- * Does the setting of the value. If createFormat is true,
- * this will also obtain a new AbstractFormatter from the
+ * Does the setting of the value. If {@code createFormat} is true,
+ * this will also obtain a new {@code AbstractFormatter} from the
* current factory. The property change event will be fired if
- * firePC is true.
+ * {@code firePC} is true.
*/
private void setValue(Object value, boolean createFormat, boolean firePC) {
Object oldValue = this.value;
@@ -849,21 +849,21 @@
/**
- * Instances of AbstractFormatterFactory are used by
- * JFormattedTextField to obtain instances of
- * AbstractFormatter which in turn are used to format values.
- * AbstractFormatterFactory can return different
- * AbstractFormatters based on the state of the
- * JFormattedTextField, perhaps returning different
- * AbstractFormatters when the
- * JFormattedTextField has focus vs when it
+ * Instances of {@code AbstractFormatterFactory} are used by
+ * {@code JFormattedTextField} to obtain instances of
+ * {@code AbstractFormatter} which in turn are used to format values.
+ * {@code AbstractFormatterFactory} can return different
+ * {@code AbstractFormatter}s based on the state of the
+ * {@code JFormattedTextField}, perhaps returning different
+ * {@code AbstractFormatter}s when the
+ * {@code JFormattedTextField} has focus vs when it
* doesn't have focus.
* @since 1.4
*/
public abstract static class AbstractFormatterFactory {
/**
- * Returns an AbstractFormatter that can handle formatting
- * of the passed in JFormattedTextField.
+ * Returns an {@code AbstractFormatter} that can handle formatting
+ * of the passed in {@code JFormattedTextField}.
*
* @param tf JFormattedTextField requesting AbstractFormatter
* @return AbstractFormatter to handle formatting duties, a null
@@ -875,31 +875,31 @@
/**
- * Instances of AbstractFormatter are used by
- * JFormattedTextField to handle the conversion both
+ * Instances of {@code AbstractFormatter} are used by
+ * {@code JFormattedTextField} to handle the conversion both
* from an Object to a String, and back from a String to an Object.
- * AbstractFormatters can also enforce editing policies,
+ * {@code AbstractFormatter}s can also enforce editing policies,
* or navigation policies, or manipulate the
- * JFormattedTextField in any way it sees fit to
+ * {@code JFormattedTextField} in any way it sees fit to
* enforce the desired policy.
* AbstractFormatter can only be active in
- * one JFormattedTextField at a time.
- * JFormattedTextField invokes
- * install when it is ready to use it followed
- * by uninstall when done. Subclasses
+ * An {@code AbstractFormatter} can only be active in
+ * one {@code JFormattedTextField} at a time.
+ * {@code JFormattedTextField} invokes
+ * {@code install} when it is ready to use it followed
+ * by {@code uninstall} when done. Subclasses
* that wish to install additional state should override
- * install and message super appropriately.
+ * {@code install} and message super appropriately.
* stringToValue and valueToString. Optionally
- * they can override getActions,
- * getNavigationFilter and getDocumentFilter
- * to restrict the JFormattedTextField in a particular
+ * {@code stringToValue} and {@code valueToString}. Optionally
+ * they can override {@code getActions},
+ * {@code getNavigationFilter} and {@code getDocumentFilter}
+ * to restrict the {@code JFormattedTextField} in a particular
* way.
* JFormattedTextField to be in
- * a temporarily invalid state should invoke setEditValid
+ * Subclasses that allow the {@code JFormattedTextField} to be in
+ * a temporarily invalid state should invoke {@code setEditValid}
* at the appropriate times.
* @since 1.4
*/
@@ -907,34 +907,34 @@
private JFormattedTextField ftf;
/**
- * Installs the AbstractFormatter onto a particular
- * JFormattedTextField.
- * This will invoke valueToString to convert the
- * current value from the JFormattedTextField to
- * a String. This will then install the Actions from
- * getActions, the DocumentFilter
- * returned from getDocumentFilter and the
- * NavigationFilter returned from
- * getNavigationFilter onto the
- * JFormattedTextField.
+ * Installs the {@code AbstractFormatter} onto a particular
+ * {@code JFormattedTextField}.
+ * This will invoke {@code valueToString} to convert the
+ * current value from the {@code JFormattedTextField} to
+ * a String. This will then install the {@code Action}s from
+ * {@code getActions}, the {@code DocumentFilter}
+ * returned from {@code getDocumentFilter} and the
+ * {@code NavigationFilter} returned from
+ * {@code getNavigationFilter} onto the
+ * {@code JFormattedTextField}.
* JFormattedTextField.
+ * {@code JFormattedTextField}.
* ParseException in converting the
+ * If there is a {@code ParseException} in converting the
* current value to a String, this will set the text to an empty
- * String, and mark the JFormattedTextField as being
+ * String, and mark the {@code JFormattedTextField} as being
* in an invalid state.
* JFormattedTextField.
- * JFormattedTextField will invoke this method at
+ * for subclassers of {@code JFormattedTextField}.
+ * {@code JFormattedTextField} will invoke this method at
* the appropriate times when the value changes, or its internal
* state changes. You will only need to invoke this yourself if
- * you are subclassing JFormattedTextField and
- * installing/uninstalling AbstractFormatter at a
- * different time than JFormattedTextField does.
+ * you are subclassing {@code JFormattedTextField} and
+ * installing/uninstalling {@code AbstractFormatter} at a
+ * different time than {@code JFormattedTextField} does.
*
* @param ftf JFormattedTextField to format for, may be null indicating
* uninstall from current JFormattedTextField.
@@ -958,11 +958,11 @@
}
/**
- * Uninstalls any state the AbstractFormatter may have
- * installed on the JFormattedTextField. This resets the
- * DocumentFilter, NavigationFilter
- * and additional Actions installed on the
- * JFormattedTextField.
+ * Uninstalls any state the {@code AbstractFormatter} may have
+ * installed on the {@code JFormattedTextField}. This resets the
+ * {@code DocumentFilter}, {@code NavigationFilter}
+ * and additional {@code Action}s installed on the
+ * {@code JFormattedTextField}.
*/
public void uninstall() {
if (this.ftf != null) {
@@ -973,7 +973,7 @@
}
/**
- * Parses text returning an arbitrary Object. Some
+ * Parses {@code text} returning an arbitrary Object. Some
* formatters may return null.
*
* @throws ParseException if there is an error in the conversion
@@ -984,7 +984,7 @@
ParseException;
/**
- * Returns the string value to display for value.
+ * Returns the string value to display for {@code value}.
*
* @throws ParseException if there is an error in the conversion
* @param value Value to convert
@@ -994,8 +994,8 @@
ParseException;
/**
- * Returns the current JFormattedTextField the
- * AbstractFormatter is installed on.
+ * Returns the current {@code JFormattedTextField} the
+ * {@code AbstractFormatter} is installed on.
*
* @return JFormattedTextField formatting for.
*/
@@ -1016,9 +1016,9 @@
}
/**
- * Invoke this to update the editValid property of the
- * JFormattedTextField. If you an enforce a policy
- * such that the JFormattedTextField is always in a
+ * Invoke this to update the {@code editValid} property of the
+ * {@code JFormattedTextField}. If you an enforce a policy
+ * such that the {@code JFormattedTextField} is always in a
* valid state, you will never need to invoke this.
*
* @param valid Valid state of the JFormattedTextField
@@ -1033,8 +1033,8 @@
/**
* Subclass and override if you wish to provide a custom set of
- * Actions. install will install these
- * on the JFormattedTextField's ActionMap.
+ * {@code Action}s. {@code install} will install these
+ * on the {@code JFormattedTextField}'s {@code ActionMap}.
*
* @return Array of Actions to install on JFormattedTextField
*/
@@ -1044,9 +1044,9 @@
/**
* Subclass and override if you wish to provide a
- * DocumentFilter to restrict what can be input.
- * install will install the returned value onto
- * the JFormattedTextField.
+ * {@code DocumentFilter} to restrict what can be input.
+ * {@code install} will install the returned value onto
+ * the {@code JFormattedTextField}.
*
* @return DocumentFilter to restrict edits
*/
@@ -1057,8 +1057,8 @@
/**
* Subclass and override if you wish to provide a filter to restrict
* where the user can navigate to.
- * install will install the returned value onto
- * the JFormattedTextField.
+ * {@code install} will install the returned value onto
+ * the {@code JFormattedTextField}.
*
* @return NavigationFilter to restrict navigation
*/
@@ -1067,8 +1067,8 @@
}
/**
- * Clones the AbstractFormatter. The returned instance
- * is not associated with a JFormattedTextField.
+ * Clones the {@code AbstractFormatter}. The returned instance
+ * is not associated with a {@code JFormattedTextField}.
*
* @return Copy of the AbstractFormatter
*/
@@ -1080,8 +1080,8 @@
}
/**
- * Installs the DocumentFilter filter
- * onto the current JFormattedTextField.
+ * Installs the {@code DocumentFilter filter}
+ * onto the current {@code JFormattedTextField}.
*
* @param filter DocumentFilter to install on the Document.
*/
@@ -1102,8 +1102,8 @@
/**
* Used to commit the edit. This extends JTextField.NotifyAction
- * so that isEnabled is true while a JFormattedTextField
- * has focus, and extends actionPerformed to invoke
+ * so that {@code isEnabled} is true while a JFormattedTextField
+ * has focus, and extends {@code actionPerformed} to invoke
* commitEdit.
*/
static class CommitAction extends JTextField.NotifyAction {
@@ -1140,7 +1140,7 @@
/**
* CancelAction will reset the value in the JFormattedTextField when
- * actionPerformed is invoked. It will only be
+ * {@code actionPerformed} is invoked. It will only be
* enabled if the focused component is an instance of
* JFormattedTextField.
*/
--- old/src/java.desktop/share/classes/javax/swing/JFrame.java 2015-10-04 22:56:48.305263164 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JFrame.java 2015-10-04 22:56:48.117263172 +0400
@@ -43,21 +43,21 @@
/**
- * An extended version of java.awt.Frame that adds support for
+ * An extended version of {@code java.awt.Frame} that adds support for
* the JFC/Swing component architecture.
- * You can find task-oriented documentation about using JFrame
+ * You can find task-oriented documentation about using {@code JFrame}
* in The Java Tutorial, in the section
* How to Make Frames.
*
* JFrame class is slightly incompatible with Frame.
+ * The {@code JFrame} class is slightly incompatible with {@code Frame}.
* Like all other JFC/Swing top-level containers,
- * a JFrame contains a JRootPane as its only child.
+ * a {@code JFrame} contains a {@code JRootPane} as its only child.
* The content pane provided by the root pane should,
* as a rule, contain
- * all the non-menu components displayed by the JFrame.
- * This is different from the AWT Frame case.
+ * all the non-menu components displayed by the {@code JFrame}.
+ * This is different from the AWT {@code Frame} case.
* As a convenience, the {@code add}, {@code remove}, and {@code setLayout}
* methods of this class are overridden, so that they delegate calls
* to the corresponding methods of the {@code ContentPane}.
@@ -71,24 +71,24 @@
* to throw an exception. The default content pane will have a BorderLayout
* manager set on it.
* Refer to {@link javax.swing.RootPaneContainer}
- * for details on adding, removing and setting the LayoutManager
- * of a JFrame.
+ * for details on adding, removing and setting the {@code LayoutManager}
+ * of a {@code JFrame}.
* Frame, a JFrame has some notion of how to
+ * Unlike a {@code Frame}, a {@code JFrame} has some notion of how to
* respond when the user attempts to close the window. The default behavior
* is to simply hide the JFrame when the user closes the window. To change the
* default behavior, you invoke the method
* {@link #setDefaultCloseOperation}.
- * To make the JFrame behave the same as a Frame
+ * To make the {@code JFrame} behave the same as a {@code Frame}
* instance, use
- * setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE).
+ * {@code setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE)}.
* JFrame
+ * In a multi-screen environment, you can create a {@code JFrame}
* on a different screen device. See {@link java.awt.Frame} for more
* information.
* java.beans package.
+ * has been added to the {@code java.beans} package.
* Please see {@link java.beans.XMLEncoder}.
*
* @see JRootPane
@@ -137,15 +137,15 @@
private int defaultCloseOperation = HIDE_ON_CLOSE;
/**
- * The TransferHandler for this frame.
+ * The {@code TransferHandler} for this frame.
*/
private TransferHandler transferHandler;
/**
- * The JRootPane instance that manages the
- * contentPane
- * and optional menuBar for this frame, as well as the
- * glassPane.
+ * The {@code JRootPane} instance that manages the
+ * {@code contentPane}
+ * and optional {@code menuBar} for this frame, as well as the
+ * {@code glassPane}.
*
* @see JRootPane
* @see RootPaneContainer
@@ -153,9 +153,9 @@
protected JRootPane rootPane;
/**
- * If true then calls to add and setLayout
- * will be forwarded to the contentPane. This is initially
- * false, but is set to true when the JFrame is constructed.
+ * If true then calls to {@code add} and {@code setLayout}
+ * will be forwarded to the {@code contentPane}. This is initially
+ * false, but is set to true when the {@code JFrame} is constructed.
*
* @see #isRootPaneCheckingEnabled
* @see #setRootPaneCheckingEnabled
@@ -168,7 +168,7 @@
* Constructs a new frame that is initially invisible.
* JComponent.getDefaultLocale.
+ * returned by {@code JComponent.getDefaultLocale}.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true.
@@ -183,18 +183,18 @@
}
/**
- * Creates a Frame in the specified
- * GraphicsConfiguration of
+ * Creates a {@code Frame} in the specified
+ * {@code GraphicsConfiguration} of
* a screen device and a blank title.
* JComponent.getDefaultLocale.
+ * returned by {@code JComponent.getDefaultLocale}.
*
- * @param gc the GraphicsConfiguration that is used
- * to construct the new Frame;
- * if gc is null, the system
- * default GraphicsConfiguration is assumed
- * @exception IllegalArgumentException if gc is not from
+ * @param gc the {@code GraphicsConfiguration} that is used
+ * to construct the new {@code Frame};
+ * if {@code gc} is {@code null}, the system
+ * default {@code GraphicsConfiguration} is assumed
+ * @exception IllegalArgumentException if {@code gc} is not from
* a screen device. This exception is always thrown when
* GraphicsEnvironment.isHeadless() returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -207,11 +207,11 @@
}
/**
- * Creates a new, initially invisible Frame with the
+ * Creates a new, initially invisible {@code Frame} with the
* specified title.
* JComponent.getDefaultLocale.
+ * returned by {@code JComponent.getDefaultLocale}.
*
* @param title the title for the frame
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
@@ -227,20 +227,20 @@
}
/**
- * Creates a JFrame with the specified title and the
- * specified GraphicsConfiguration of a screen device.
+ * Creates a {@code JFrame} with the specified title and the
+ * specified {@code GraphicsConfiguration} of a screen device.
* JComponent.getDefaultLocale.
+ * returned by {@code JComponent.getDefaultLocale}.
*
* @param title the title to be displayed in the
- * frame's border. A null value is treated as
+ * frame's border. A {@code null} value is treated as
* an empty string, "".
- * @param gc the GraphicsConfiguration that is used
- * to construct the new JFrame with;
- * if gc is null, the system
- * default GraphicsConfiguration is assumed
- * @exception IllegalArgumentException if gc is not from
+ * @param gc the {@code GraphicsConfiguration} that is used
+ * to construct the new {@code JFrame} with;
+ * if {@code gc} is {@code null}, the system
+ * default {@code GraphicsConfiguration} is assumed
+ * @exception IllegalArgumentException if {@code gc} is not from
* a screen device. This exception is always thrown when
* GraphicsEnvironment.isHeadless() returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -252,7 +252,7 @@
frameInit();
}
- /** Called by the constructors to init the JFrame properly. */
+ /** Called by the constructors to init the {@code JFrame} properly. */
protected void frameInit() {
enableEvents(AWTEvent.KEY_EVENT_MASK | AWTEvent.WINDOW_EVENT_MASK);
setLocale( JComponent.getDefaultLocale() );
@@ -272,7 +272,7 @@
/**
* Called by the constructor methods to create the default
- * rootPane.
+ * {@code rootPane}.
*
* @return a new {@code JRootPane}
*/
@@ -289,7 +289,7 @@
/**
* Processes window events occurring on this component.
* Hides the window or disposes of it, as specified by the setting
- * of the defaultCloseOperation property.
+ * of the {@code defaultCloseOperation} property.
*
* @param e the window event
* @see #setDefaultCloseOperation
@@ -323,31 +323,31 @@
* You must specify one of the following choices:
*
*
- *
* DO_NOTHING_ON_CLOSE
- * (defined in WindowConstants):
+ * windowClosing
- * method of a registered WindowListener object.
+ * program to handle the operation in the {@code windowClosing}
+ * method of a registered {@code WindowListener} object.
*
- * HIDE_ON_CLOSE
- * (defined in WindowConstants):
+ * WindowListener
+ * invoking any registered {@code WindowListener}
* objects.
*
- * DISPOSE_ON_CLOSE
- * (defined in WindowConstants):
+ * WindowListener
+ * frame after invoking any registered {@code WindowListener}
* objects.
*
- * EXIT_ON_CLOSE
- * (defined in WindowConstants):
- * Exit the application using the System
- * exit method. Use this only in applications.
+ * HIDE_ON_CLOSE by default. Changes
+ * The value is set to {@code HIDE_ON_CLOSE} by default. Changes
* to the value of this property cause the firing of a property
* change event, with property name "defaultCloseOperation".
* EXIT_ON_CLOSE has been specified and the
- * SecurityManager will
- * not allow the caller to invoke System.exit
+ * if {@code EXIT_ON_CLOSE} has been specified and the
+ * {@code SecurityManager} will
+ * not allow the caller to invoke {@code System.exit}
* @see java.lang.Runtime#exit(int)
*
* @beaninfo
@@ -454,9 +454,9 @@
}
/**
- * Gets the transferHandler property.
+ * Gets the {@code transferHandler} property.
*
- * @return the value of the transferHandler property
+ * @return the value of the {@code transferHandler} property
*
* @see TransferHandler
* @see #setTransferHandler
@@ -467,7 +467,7 @@
}
/**
- * Just calls paint(g). This method was overridden to
+ * Just calls {@code paint(g)}. This method was overridden to
* prevent an unnecessary call to clear the background.
*
* @param g the Graphics context in which to paint
@@ -501,10 +501,10 @@
}
/**
- * Returns whether calls to add and
- * setLayout are forwarded to the contentPane.
+ * Returns whether calls to {@code add} and
+ * {@code setLayout} are forwarded to the {@code contentPane}.
*
- * @return true if add and setLayout
+ * @return true if {@code add} and {@code setLayout}
* are forwarded; false otherwise
*
* @see #addImpl
@@ -518,12 +518,12 @@
/**
- * Sets whether calls to add and
- * setLayout are forwarded to the contentPane.
+ * Sets whether calls to {@code add} and
+ * {@code setLayout} are forwarded to the {@code contentPane}.
*
- * @param enabled true if add and setLayout
+ * @param enabled true if {@code add} and {@code setLayout}
* are forwarded, false if they should operate directly on the
- * JFrame.
+ * {@code JFrame}.
*
* @see #addImpl
* @see #setLayout
@@ -539,17 +539,17 @@
/**
- * Adds the specified child Component.
+ * Adds the specified child {@code Component}.
* This method is overridden to conditionally forward calls to the
- * contentPane.
- * By default, children are added to the contentPane instead
+ * {@code contentPane}.
+ * By default, children are added to the {@code contentPane} instead
* of the frame, refer to {@link javax.swing.RootPaneContainer} for
* details.
*
* @param comp the component to be enhanced
* @param constraints the constraints to be respected
* @param index the index
- * @exception IllegalArgumentException if index is invalid
+ * @exception IllegalArgumentException if {@code index} is invalid
* @exception IllegalArgumentException if adding the container's parent
* to itself
* @exception IllegalArgumentException if adding a window to a container
@@ -569,13 +569,13 @@
/**
* Removes the specified component from the container. If
- * comp is not the rootPane, this will forward
- * the call to the contentPane. This will do nothing if
- * comp is not a child of the JFrame or
- * contentPane.
+ * {@code comp} is not the {@code rootPane}, this will forward
+ * the call to the {@code contentPane}. This will do nothing if
+ * {@code comp} is not a child of the {@code JFrame} or
+ * {@code contentPane}.
*
* @param comp the component to be removed
- * @throws NullPointerException if comp is null
+ * @throws NullPointerException if {@code comp} is null
* @see #add
* @see javax.swing.RootPaneContainer
*/
@@ -589,13 +589,13 @@
/**
- * Sets the LayoutManager.
+ * Sets the {@code LayoutManager}.
* Overridden to conditionally forward the call to the
- * contentPane.
+ * {@code contentPane}.
* Refer to {@link javax.swing.RootPaneContainer} for
* more information.
*
- * @param manager the LayoutManager
+ * @param manager the {@code LayoutManager}
* @see #setRootPaneCheckingEnabled
* @see javax.swing.RootPaneContainer
*/
@@ -610,8 +610,8 @@
/**
- * Returns the rootPane object for this frame.
- * @return the rootPane property
+ * Returns the {@code rootPane} object for this frame.
+ * @return the {@code rootPane} property
*
* @see #setRootPane
* @see RootPaneContainer#getRootPane
@@ -622,9 +622,9 @@
/**
- * Sets the rootPane property.
+ * Sets the {@code rootPane} property.
* This method is called by the constructor.
- * @param root the rootPane object for this frame
+ * @param root the {@code rootPane} object for this frame
*
* @see #getRootPane
*
@@ -658,8 +658,8 @@
}
/**
- * Returns the contentPane object for this frame.
- * @return the contentPane property
+ * Returns the {@code contentPane} object for this frame.
+ * @return the {@code contentPane} property
*
* @see #setContentPane
* @see RootPaneContainer#getContentPane
@@ -669,18 +669,18 @@
}
/**
- * Sets the contentPane property.
+ * Sets the {@code contentPane} property.
* This method is called by the constructor.
* JComponent
+ * Swing's painting architecture requires an opaque {@code JComponent}
* in the containment hierarchy. This is typically provided by the
* content pane. If you replace the content pane it is recommended you
- * replace it with an opaque JComponent.
+ * replace it with an opaque {@code JComponent}.
*
- * @param contentPane the contentPane object for this frame
+ * @param contentPane the {@code contentPane} object for this frame
*
* @exception java.awt.IllegalComponentStateException (a runtime
- * exception) if the content pane parameter is null
+ * exception) if the content pane parameter is {@code null}
* @see #getContentPane
* @see RootPaneContainer#setContentPane
* @see JRootPane
@@ -695,8 +695,8 @@
}
/**
- * Returns the layeredPane object for this frame.
- * @return the layeredPane property
+ * Returns the {@code layeredPane} object for this frame.
+ * @return the {@code layeredPane} property
*
* @see #setLayeredPane
* @see RootPaneContainer#getLayeredPane
@@ -706,12 +706,12 @@
}
/**
- * Sets the layeredPane property.
+ * Sets the {@code layeredPane} property.
* This method is called by the constructor.
- * @param layeredPane the layeredPane object for this frame
+ * @param layeredPane the {@code layeredPane} object for this frame
*
* @exception java.awt.IllegalComponentStateException (a runtime
- * exception) if the layered pane parameter is null
+ * exception) if the layered pane parameter is {@code null}
* @see #getLayeredPane
* @see RootPaneContainer#setLayeredPane
*
@@ -724,8 +724,8 @@
}
/**
- * Returns the glassPane object for this frame.
- * @return the glassPane property
+ * Returns the {@code glassPane} object for this frame.
+ * @return the {@code glassPane} property
*
* @see #setGlassPane
* @see RootPaneContainer#getGlassPane
@@ -735,9 +735,9 @@
}
/**
- * Sets the glassPane property.
+ * Sets the {@code glassPane} property.
* This method is called by the constructor.
- * @param glassPane the glassPane object for this frame
+ * @param glassPane the {@code glassPane} object for this frame
*
* @see #getGlassPane
* @see RootPaneContainer#setGlassPane
@@ -762,7 +762,7 @@
/**
* Repaints the specified rectangle of this component within
- * time milliseconds. Refer to RepaintManager
+ * {@code time} milliseconds. Refer to {@code RepaintManager}
* for details on how the repaint is handled.
*
* @param time maximum time in milliseconds before update
@@ -784,15 +784,15 @@
}
/**
- * Provides a hint as to whether or not newly created JFrames
+ * Provides a hint as to whether or not newly created {@code JFrame}s
* should have their Window decorations (such as borders, widgets to
* close the window, title...) provided by the current look
- * and feel. If defaultLookAndFeelDecorated is true,
- * the current LookAndFeel supports providing window
+ * and feel. If {@code defaultLookAndFeelDecorated} is true,
+ * the current {@code LookAndFeel} supports providing window
* decorations, and the current window manager supports undecorated
- * windows, then newly created JFrames will have their
- * Window decorations provided by the current LookAndFeel.
- * Otherwise, newly created JFrames will have their
+ * windows, then newly created {@code JFrame}s will have their
+ * Window decorations provided by the current {@code LookAndFeel}.
+ * Otherwise, newly created {@code JFrame}s will have their
* Window decorations provided by the current window manager.
* JFrames should have their
+ * Returns true if newly created {@code JFrame}s should have their
* Window decorations provided by the current look and feel. This is only
* a hint, as certain look and feels may not support this feature.
*
@@ -834,14 +834,14 @@
}
/**
- * Returns a string representation of this JFrame.
+ * Returns a string representation of this {@code JFrame}.
* This method
* is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not
- * be null.
+ * be {@code null}.
*
- * @return a string representation of this JFrame
+ * @return a string representation of this {@code JFrame}
*/
protected String paramString() {
String defaultCloseOperationString;
@@ -894,7 +894,7 @@
/**
* This class implements accessibility support for the
- * JFrame class. It provides an implementation of the
+ * {@code JFrame} class. It provides an implementation of the
* Java Accessibility API appropriate to frame user-interface
* elements.
*/
--- old/src/java.desktop/share/classes/javax/swing/JInternalFrame.java 2015-10-04 22:56:48.853263139 +0400
+++ new/src/java.desktop/share/classes/javax/swing/JInternalFrame.java 2015-10-04 22:56:48.661263148 +0400
@@ -55,12 +55,12 @@
* JInternalFrames to a JDesktopPane. The UI
+ * you add {@code JInternalFrame}s to a {@code JDesktopPane}. The UI
* delegates the look-and-feel-specific actions to the
- * DesktopManager
- * object maintained by the JDesktopPane.
+ * {@code DesktopManager}
+ * object maintained by the {@code JDesktopPane}.
* JInternalFrame content pane
+ * The {@code JInternalFrame} content pane
* is where you add child components.
* As a convenience, the {@code add}, {@code remove}, and {@code setLayout}
* methods of this class are overridden, so that they delegate calls
@@ -71,14 +71,14 @@
*
* And the child will be added to the contentPane.
* The content pane is actually managed by an instance of
- * JRootPane,
+ * {@code JRootPane},
* which also manages a layout pane, glass pane, and
* optional menu bar for the internal frame. Please see the
- * JRootPane
+ * {@code JRootPane}
* documentation for a complete description of these components.
* Refer to {@link javax.swing.RootPaneContainer}
- * for details on adding, removing and setting the LayoutManager
- * of a JInternalFrame.
+ * for details on adding, removing and setting the {@code LayoutManager}
+ * of a {@code JInternalFrame}.
* JLayeredPane divides the depth-range
+ * For convenience, {@code JLayeredPane} divides the depth-range
* into several different layers. Putting a component into one of those
* layers makes it easy to ensure that components overlap properly,
* without having to worry about specifying numbers for specific depths:
@@ -76,21 +76,21 @@
* that it is positioned over every other component in the container. When
* finished dragging, it can be reassigned to its normal layer.
*
@@ -157,15 +157,15 @@
* Document implementations will generally have some set of properties
* associated with them at runtime. Two well known properties are the
*