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-27 21:48:41.148203781 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaInternalFrameUI.java 2015-10-27 21:48:40.956203789 +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-27 21:48:41.704203756 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaLookAndFeel.java 2015-10-27 21:48:41.512203764 +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-27 21:48:42.268203730 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaOptionPaneUI.java 2015-10-27 21:48:42.076203739 +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-27 21:48:42.820203706 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaRootPaneUI.java 2015-10-27 21:48:42.608203715 +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-27 21:48:43.356203682 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaTabbedPaneCopyFromBasicUI.java 2015-10-27 21:48:43.164203690 +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-27 21:48:43.948203655 +0400
+++ new/src/java.desktop/macosx/classes/com/apple/laf/AquaTreeUI.java 2015-10-27 21:48:43.756203664 +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-27 21:48:44.500203630 +0400
+++ new/src/java.desktop/macosx/classes/sun/font/NativeFont.java 2015-10-27 21:48:44.292203639 +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-27 21:48:45.036203606 +0400
+++ new/src/java.desktop/macosx/classes/sun/java2d/DataBufferNIOInt.java 2015-10-27 21:48:44.844203615 +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-27 21:48:45.592203581 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CDesktopPeer.java 2015-10-27 21:48:45.380203591 +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-27 21:48:46.136203557 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CInputMethod.java 2015-10-27 21:48:45.944203565 +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-27 21:48:46.680203532 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterDevice.java 2015-10-27 21:48:46.488203541 +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-27 21:48:47.228203508 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterGraphicsConfig.java 2015-10-27 21:48:47.036203516 +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-27 21:48:47.772203483 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CPrinterJob.java 2015-10-27 21:48:47.580203492 +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-27 21:48:48.312203459 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/CRobot.java 2015-10-27 21:48:48.120203468 +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-27 21:48:48.856203435 +0400
+++ new/src/java.desktop/macosx/classes/sun/lwawt/macosx/LWCToolkit.java 2015-10-27 21:48:48.664203443 +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-27 21:48:49.396203410 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/bmp/BMPImageReader.java 2015-10-27 21:48:49.204203419 +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);
@@ -1681,8 +1681,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-27 21:48:49.948203385 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/bmp/BMPImageWriter.java 2015-10-27 21:48:49.756203394 +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-27 21:48:50.496203361 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/BogusColorSpace.java 2015-10-27 21:48:50.304203369 +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-27 21:48:51.028203337 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/I18NImpl.java 2015-10-27 21:48:50.836203346 +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-27 21:48:51.560203313 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/ImageUtil.java 2015-10-27 21:48:51.368203322 +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 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.
*
@@ -385,17 +385,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.
*
@@ -413,11 +413,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
@@ -1482,7 +1482,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,
@@ -2128,7 +2128,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.
@@ -2160,12 +2160,12 @@
/**
* Returns the size of this component in the form of a
- *
* This method changes layout-related information, and therefore,
* invalidates the component hierarchy.
@@ -2212,7 +2212,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.
@@ -2247,7 +2247,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.
@@ -2460,8 +2460,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,
@@ -3280,21 +3280,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
@@ -3375,8 +3375,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
@@ -3396,9 +3396,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
@@ -3418,12 +3418,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
@@ -3481,10 +3481,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.
@@ -5304,7 +5304,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.
@@ -5326,7 +5326,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.
@@ -5372,7 +5372,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.
@@ -5395,7 +5395,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.
@@ -5449,7 +5449,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.
@@ -5486,7 +5486,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.
@@ -5542,7 +5542,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.
@@ -5648,7 +5648,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.
@@ -5727,7 +5727,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.
@@ -5773,7 +5773,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.
@@ -5796,7 +5796,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.
@@ -5842,7 +5842,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.
@@ -5865,7 +5865,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.
@@ -5938,7 +5938,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.
@@ -5982,7 +5982,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.
@@ -6005,7 +6005,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.
*
@@ -6398,17 +6398,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.
*
@@ -6443,33 +6443,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.
*
@@ -6500,39 +6500,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.
*
@@ -6569,17 +6569,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.
*
@@ -6617,17 +6617,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.
*
@@ -6656,21 +6656,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.
*
@@ -6739,17 +6739,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.
*
@@ -6775,17 +6775,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.
*
@@ -6972,7 +6972,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
@@ -7434,15 +7434,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
@@ -7543,9 +7543,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
@@ -8999,8 +8999,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,
@@ -9023,7 +9023,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
@@ -3186,16 +3186,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,
@@ -3547,7 +3547,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
@@ -727,9 +727,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
@@ -1700,7 +1700,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
@@ -1730,7 +1730,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
@@ -1821,7 +1821,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.
@@ -1946,30 +1946,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-27 21:49:59.996200240 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ICC_ProfileRGB.java 2015-10-27 21:49:59.804200248 +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-27 21:50:17.228199466 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/FocusAdapter.java 2015-10-27 21:50:17.036199474 +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-27 21:50:21.520199273 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/InputMethodEvent.java 2015-10-27 21:50:21.324199282 +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-27 21:50:27.492199005 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseWheelListener.java 2015-10-27 21:50:27.296199014 +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-27 21:50:28.028198981 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/PaintEvent.java 2015-10-27 21:50:27.836198989 +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.
* This method is useful for clients which have only dimensions and
* want to find a Media which corresponds to the dimensions.
- * @param x - X dimension
- * @param y - Y dimension.
+ * @param x X dimension
+ * @param y Y dimension.
* @param units
- * Unit conversion factor, 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
*
* @param name the resource name
- * @return an input stream for reading the resource, or
*
* @param name the resource name
- * @return an input stream for reading the resource, or
- * This method is used by the
- * The
- * This method calls
* AWT is considered to be in ready-to-shutdown state when
- *
- *
+ * }
+ * }
*
* The problem with the above is that the Foo service is global in scope,
* so that applets and other untrusted code can execute methods on the
@@ -90,7 +91,7 @@
* executes it.
*
* Here's the Foo class written to use the AppContext:
- *
+ * }
+ * }
*
* Since a separate AppContext can exist for each ThreadGroup, trusted
* and untrusted code have access to different Foo instances. This allows
@@ -159,7 +161,7 @@
Collections.synchronizedMap(new IdentityHashMap
- * The value can be retrieved by calling the
* setLocation() and setBounds() for EmbeddedFrame really don't move it
@@ -418,9 +418,9 @@
/**
* Moves and resizes this embedded frame. The new location of the top-left
- * corner is specified by
* setLocation() and setBounds() for EmbeddedFrame really don't move it
* within the native parent. These methods always put embedded frame to
@@ -437,8 +437,8 @@
*
*
* (1) InputEvent updates which are outdated are discarded by
- *
+ * {@code updateCursorImmediately(InputEvent)}.
*
* (2) If 'useCache' is true, the native code is free to use a cached
* value to determine the most specific, visible, enabled heavyweight
--- old/src/java.desktop/share/classes/sun/awt/LightweightFrame.java 2015-10-27 21:53:22.564191143 +0400
+++ new/src/java.desktop/share/classes/sun/awt/LightweightFrame.java 2015-10-27 21:53:22.372191151 +0400
@@ -112,7 +112,7 @@
* frame. Peers should override this method if they are to implement
* this functionality.
*
- * @param activate if
* WARNING: This is invoked from the native thread, be careful
* what methods you end up invoking here.
--- old/src/java.desktop/share/classes/sun/awt/RepaintArea.java 2015-10-27 21:53:23.636191094 +0400
+++ new/src/java.desktop/share/classes/sun/awt/RepaintArea.java 2015-10-27 21:53:23.440191103 +0400
@@ -31,7 +31,7 @@
import java.awt.event.PaintEvent;
/**
- * The
@@ -521,7 +521,7 @@
/*
* Execute a chunk of code on the Java event handler thread. The
* method takes into account provided AppContext and sets
- * This method allows to write tests without explicit timeouts
* or wait for some event. Example:
- * After realSync, After realSync, {@code f} will be completely visible
* on the screen, its getLocationOnScreen will be returning the
* right result and it will be the focus owner.
*
* Another example:
- * After realSync, After realSync, {@code b} will be focus owner.
*
* Notice that realSync isn't guaranteed to work if recurring
* actions occur, such as if during processing of some event
@@ -1529,8 +1529,8 @@
* sync of the native queue. The method should wait until native
* requests are processed, all native events are processed and
* corresponding Java events are generated. Should return
- *
* Currently is only called from native code to prepend palette data to
* platform-specific image data during image transfer on Win32.
*
* @param obj1 the first object to be concatenated.
* @param obj2 the second object to be concatenated.
- * @return a byte array or an
* If we examine the parametric equation in t, we have:
* Py(t) = C0*(1-t)^2 + 2*CP*t*(1-t) + C1*t^2
--- old/src/java.desktop/share/classes/sun/awt/geom/Order3.java 2015-10-27 21:53:26.952190946 +0400
+++ new/src/java.desktop/share/classes/sun/awt/geom/Order3.java 2015-10-27 21:53:26.756190954 +0400
@@ -123,7 +123,7 @@
/*
* Return the count of the number of horizontal sections of the
* specified cubic Bezier curve. Put the parameters for the
- * horizontal sections into the specified
* If we examine the parametric equation in t, we have:
* Py(t) = C0(1-t)^3 + 3CP0 t(1-t)^2 + 3CP1 t^2(1-t) + C1 t^3
--- old/src/java.desktop/share/classes/sun/awt/im/ExecutableInputMethodManager.java 2015-10-27 21:53:27.488190921 +0400
+++ new/src/java.desktop/share/classes/sun/awt/im/ExecutableInputMethodManager.java 2015-10-27 21:53:27.292190930 +0400
@@ -57,11 +57,11 @@
import sun.awt.SunToolkit;
/**
- *
- * In comparison the act of setting the
--- old/src/java.desktop/share/classes/sun/java2d/SunGraphics2D.java 2015-10-27 21:53:37.736190461 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/SunGraphics2D.java 2015-10-27 21:53:37.524190471 +0400
@@ -2759,8 +2759,8 @@
}
/**
- * Intersects
* This method can also be used to initialize a simple rectangular
* region.
@@ -637,7 +637,7 @@
* object with the specified Region object.
*
* If {@code A} and {@code B} are both Region Objects and
- *
@@ -666,7 +666,7 @@
* object with the specified Region object.
*
* If {@code A} and {@code B} are both Region Objects and
- *
@@ -693,7 +693,7 @@
* specified Region object subtracted from this object.
*
* If {@code A} and {@code B} are both Region Objects and
- *
@@ -717,7 +717,7 @@
* object with the specified Region object.
*
* If {@code A} and {@code B} are both Region Objects and
- *
--- old/src/java.desktop/share/classes/sun/java2d/pipe/RenderQueue.java 2015-10-27 21:53:40.484190338 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/pipe/RenderQueue.java 2015-10-27 21:53:40.292190346 +0400
@@ -115,7 +115,7 @@
/**
* Attempts to lock the queue. If successful, this method returns true,
* indicating that the caller is responsible for calling
- * Issues: in J2Se, a zero length dash segment as drawn as a very
@@ -60,11 +60,11 @@
private float[] curCurvepts;
/**
- * Constructs a
* For class DialogOwner the category name is
- *
* 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 not yet been completely loaded, then
- *
* A scaled version of an image will not necessarily be
* available immediately just because an unscaled version of the
@@ -1450,11 +1450,11 @@
* and converted for the current output device.
*
* If the image has not yet been completely loaded, then
- *
@@ -1517,7 +1517,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
@@ -1628,7 +1628,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
- *
@@ -1642,7 +1642,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
* 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 not yet been completely loaded, then
- *
* A scaled version of an image will not necessarily be
* available immediately just because an unscaled version of the
@@ -1027,7 +1027,7 @@
* and converted for the current output device.
*
* If the image has not yet been completely loaded, then
- *
@@ -1127,7 +1127,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
- *
@@ -1199,7 +1199,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
- *
@@ -1304,10 +1304,10 @@
/**
* Disposes of this graphics context and releases
* any system resources that it is using.
- * A
- * When a Java program runs, a large number of
* Graphics objects which are provided as arguments to the
- *
*
@@ -231,12 +231,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
* 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 not yet been completely loaded, then
- *
* A scaled version of an image will not necessarily be
* available immediately just because an unscaled version of the
@@ -877,7 +877,7 @@
* and converted for the current output device.
*
* If the image has not yet been completely loaded, then
- *
@@ -953,7 +953,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
- *
@@ -1014,7 +1014,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
- *
@@ -1068,10 +1068,10 @@
/**
* Disposes of this graphics context and releases
* any system resources that it is using.
- * A
- * When a Java program runs, a large number of
* Graphics objects which are provided as arguments to the
- *
* 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 not yet been completely loaded, then
- *
* A scaled version of an image will not necessarily be
* available immediately just because an unscaled version of the
@@ -872,7 +872,7 @@
* and converted for the current output device.
*
* If the image has not yet been completely loaded, then
- *
@@ -978,7 +978,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
- *
@@ -1038,7 +1038,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
- *
@@ -1106,7 +1106,7 @@
}
/**
- * Return true if drawing
- * When a Java program runs, a large number of
* Graphics objects which are provided as arguments to the
- *
+ * by the XServer and an {@code XAtom} object is returned. An {@code XAtom} can also be created
+ * by using a pre-exisiting atom like {@code XA_WM_CLASS}. A {@code display} has to be specified
+ * in order to create an {@code XAtom}.
*
- * Once an
*
*
* Example usage : To set the window name for a top level:
- *
- * xa.setProperty(window,"Hello World");
- *
- * To get the cut buffer :
- *
- * String selection = xa.getProperty(root_window);
+ *
+ * To get the cut buffer:
+ *
* NB: This could be called from any thread if triggered by
- * 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-27 21:48:52.108203288 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/LZWStringTable.java 2015-10-27 21:48:51.916203297 +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-27 21:48:52.644203264 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/PaletteBuilder.java 2015-10-27 21:48:52.452203273 +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-27 21:48:53.184203240 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/common/ReaderUtil.java 2015-10-27 21:48:52.988203249 +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-27 21:48:53.720203216 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFImageReader.java 2015-10-27 21:48:53.528203225 +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-27 21:48:54.332203189 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFImageWriter.java 2015-10-27 21:48:54.140203197 +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-27 21:48:54.880203164 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/gif/GIFMetadata.java 2015-10-27 21:48:54.688203173 +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-27 21:48:55.416203140 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/COMMarkerSegment.java 2015-10-27 21:48:55.224203149 +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-27 21:48:55.948203116 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JFIFMarkerSegment.java 2015-10-27 21:48:55.756203125 +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-27 21:48:56.496203091 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEG.java 2015-10-27 21:48:56.304203100 +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-27 21:48:57.032203067 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGBuffer.java 2015-10-27 21:48:56.840203076 +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-27 21:48:57.568203043 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGImageReader.java 2015-10-27 21:48:57.376203052 +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-27 21:48:58.120203018 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGImageWriter.java 2015-10-27 21:48:57.928203027 +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-27 21:48:58.672202994 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGMetadata.java 2015-10-27 21:48:58.480203002 +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-27 21:48:59.236202968 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/JPEGMetadataFormat.java 2015-10-27 21:48:59.044202977 +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-27 21:48:59.768202944 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/jpeg/MarkerSegment.java 2015-10-27 21:48:59.576202953 +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-27 21:49:00.304202920 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/png/PNGMetadata.java 2015-10-27 21:49:00.112202929 +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-27 21:49:00.856202896 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/wbmp/WBMPImageReader.java 2015-10-27 21:49:00.664202904 +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-27 21:49:01.392202872 +0400
+++ new/src/java.desktop/share/classes/com/sun/imageio/plugins/wbmp/WBMPImageWriter.java 2015-10-27 21:49:01.200202880 +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/media/sound/AudioSynthesizer.java 2015-10-27 21:49:01.968202846 +0400
+++ new/src/java.desktop/share/classes/com/sun/media/sound/AudioSynthesizer.java 2015-10-27 21:49:01.732202856 +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-27 21:49:02.500202822 +0400
+++ new/src/java.desktop/share/classes/com/sun/media/sound/AudioSynthesizerPropertyInfo.java 2015-10-27 21:49:02.308202830 +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/MidiUtils.java 2015-10-27 21:49:03.052202797 +0400
+++ new/src/java.desktop/share/classes/com/sun/media/sound/MidiUtils.java 2015-10-27 21:49:02.840202806 +0400
@@ -250,7 +250,7 @@
/**
* Binary search for the event indexes of the track
*
- * @param tick - tick number of index to be found in array
+ * @param tick tick number of index to be found in array
* @return index in track which is on or after "tick".
* if no entries are found that follow after tick, track.size() is returned
*/
--- old/src/java.desktop/share/classes/com/sun/media/sound/SoftControl.java 2015-10-27 21:49:03.588202773 +0400
+++ new/src/java.desktop/share/classes/com/sun/media/sound/SoftControl.java 2015-10-27 21:49:03.396202782 +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-27 21:49:04.144202748 +0400
+++ new/src/java.desktop/share/classes/java/applet/Applet.java 2015-10-27 21:49:03.932202757 +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-27 21:49:04.684202724 +0400
+++ new/src/java.desktop/share/classes/java/applet/AudioClip.java 2015-10-27 21:49:04.492202732 +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-27 21:49:05.216202700 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTError.java 2015-10-27 21:49:05.024202708 +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-27 21:49:05.748202676 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTEvent.java 2015-10-27 21:49:05.556202685 +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-27 21:49:06.284202652 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java 2015-10-27 21:49:06.092202660 +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-27 21:49:06.828202627 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTException.java 2015-10-27 21:49:06.636202636 +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-27 21:49:07.364202603 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTKeyStroke.java 2015-10-27 21:49:07.168202612 +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-27 21:49:07.912202579 +0400
+++ new/src/java.desktop/share/classes/java/awt/AWTPermission.java 2015-10-27 21:49:07.716202588 +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-27 21:49:08.452202554 +0400
+++ new/src/java.desktop/share/classes/java/awt/ActiveEvent.java 2015-10-27 21:49:08.256202563 +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-27 21:49:08.984202531 +0400
+++ new/src/java.desktop/share/classes/java/awt/Adjustable.java 2015-10-27 21:49:08.792202539 +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-27 21:49:09.520202507 +0400
+++ new/src/java.desktop/share/classes/java/awt/AlphaComposite.java 2015-10-27 21:49:09.328202515 +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-27 21:49:10.064202482 +0400
+++ new/src/java.desktop/share/classes/java/awt/BorderLayout.java 2015-10-27 21:49:09.872202491 +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-27 21:49:11.160202433 +0400
+++ new/src/java.desktop/share/classes/java/awt/Button.java 2015-10-27 21:49:10.968202441 +0400
@@ -37,7 +37,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
@@ -144,7 +144,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
@@ -182,7 +182,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
*/
@@ -193,7 +193,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
*/
@@ -225,7 +225,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
@@ -236,7 +236,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
@@ -292,7 +292,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
*
@@ -308,16 +308,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));
@@ -326,14 +326,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
@@ -362,10 +362,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
*/
@@ -437,19 +437,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)
@@ -464,15 +464,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)
@@ -503,15 +503,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}
* @since 1.3
*/
@BeanProperty(expert = true, description
@@ -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-27 21:49:11.704202408 +0400
+++ new/src/java.desktop/share/classes/java/awt/Canvas.java 2015-10-27 21:49:11.512202417 +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-27 21:49:12.240202384 +0400
+++ new/src/java.desktop/share/classes/java/awt/CardLayout.java 2015-10-27 21:49:12.048202393 +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-27 21:49:12.780202360 +0400
+++ new/src/java.desktop/share/classes/java/awt/Checkbox.java 2015-10-27 21:49:12.588202369 +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-27 21:49:13.332202335 +0400
+++ new/src/java.desktop/share/classes/java/awt/CheckboxMenuItem.java 2015-10-27 21:49:13.136202344 +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-27 21:49:13.876202311 +0400
+++ new/src/java.desktop/share/classes/java/awt/Choice.java 2015-10-27 21:49:13.684202320 +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-27 21:49:14.428202286 +0400
+++ new/src/java.desktop/share/classes/java/awt/Color.java 2015-10-27 21:49:14.236202295 +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-27 21:49:14.992202261 +0400
+++ new/src/java.desktop/share/classes/java/awt/ColorPaintContext.java 2015-10-27 21:49:14.796202270 +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-27 21:49:15.544202236 +0400
+++ new/src/java.desktop/share/classes/java/awt/Component.java 2015-10-27 21:49:15.328202246 +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 volatile GraphicsConfiguration graphicsConfig;
/**
- * 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() {
@@ -1176,8 +1176,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) {
@@ -1243,7 +1243,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
@@ -1268,8 +1268,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
@@ -1285,9 +1285,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
*/
@@ -1301,9 +1301,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());
@@ -1368,30 +1368,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 {
@@ -1436,8 +1436,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
*/
@@ -1453,9 +1453,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
*/
@@ -1473,7 +1473,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
@@ -1494,7 +1494,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public void enable() {
@@ -1524,7 +1524,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) {
@@ -1537,7 +1537,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setEnabled(boolean).
+ * replaced by {@code setEnabled(boolean)}.
*/
@Deprecated
public void disable() {
@@ -1627,12 +1627,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
@@ -1644,7 +1644,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setVisible(boolean).
+ * replaced by {@code setVisible(boolean)}.
*/
@Deprecated
public void show() {
@@ -1687,7 +1687,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) {
@@ -1712,7 +1712,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by setVisible(boolean).
+ * replaced by {@code setVisible(boolean)}.
*/
@Deprecated
public void hide() {
@@ -1775,7 +1775,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
@@ -1798,11 +1798,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() {
@@ -1835,7 +1835,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
@@ -1857,11 +1857,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() {
@@ -1900,7 +1900,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
@@ -1935,11 +1935,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() {
@@ -1951,7 +1951,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
@@ -1995,7 +1995,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
@@ -2020,13 +2020,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
@@ -2041,7 +2041,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
@@ -2087,7 +2087,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() {
@@ -2100,7 +2100,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) {
@@ -2140,8 +2140,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
@@ -2181,7 +2181,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() {
@@ -2189,8 +2189,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) {
@@ -2223,8 +2223,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) {
@@ -2256,7 +2256,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
@@ -2273,7 +2273,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() {
@@ -2282,16 +2282,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)
@@ -2314,7 +2314,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) {
@@ -2434,10 +2434,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
@@ -2475,8 +2475,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
@@ -2490,8 +2490,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
@@ -2505,8 +2505,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
@@ -2518,10 +2518,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
@@ -2539,10 +2539,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
@@ -2559,10 +2559,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
@@ -2607,12 +2607,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.
*
@@ -2628,8 +2628,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
@@ -2656,9 +2656,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
*/
@@ -2683,7 +2683,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() {
@@ -2704,8 +2704,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
@@ -2730,10 +2730,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
*/
@@ -2756,7 +2756,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() {
@@ -2777,11 +2777,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
@@ -2804,10 +2804,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
*/
@@ -2858,16 +2858,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
@@ -2893,15 +2893,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
@@ -2925,7 +2925,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by doLayout().
+ * replaced by {@code doLayout()}.
*/
@Deprecated
public void layout() {
@@ -3074,9 +3074,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
@@ -3138,7 +3138,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)
@@ -3161,19 +3161,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
@@ -3213,7 +3213,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
@@ -3238,11 +3238,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() {
@@ -3255,12 +3255,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.
*
@@ -3317,7 +3317,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.
*
@@ -3355,9 +3355,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
@@ -3499,7 +3499,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
@@ -3542,41 +3542,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)
@@ -3699,12 +3699,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) {
@@ -3718,14 +3718,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
*/
@@ -3748,17 +3748,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)
@@ -3774,27 +3774,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)
@@ -3819,7 +3819,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
@@ -3880,17 +3880,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
@@ -3975,7 +3975,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
@@ -4026,8 +4026,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
@@ -4064,14 +4064,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)
@@ -4152,7 +4152,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
@@ -4266,7 +4266,7 @@
/**
* @return whether the drawing buffer was lost since the last call to
- * getDrawGraphics
+ * {@code getDrawGraphics}
*/
public boolean contentsLost() {
if (drawVBuffer == null) {
@@ -4553,7 +4553,7 @@
/**
* @return whether the drawing buffer was lost since the last call to
- * getDrawGraphics
+ * {@code getDrawGraphics}
*/
public boolean contentsLost() {
if (backBuffers == null) {
@@ -4632,7 +4632,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
@@ -4700,7 +4700,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
@@ -4753,15 +4753,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
@@ -4801,7 +4801,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) {
@@ -4810,8 +4810,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) {
@@ -5279,7 +5279,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
*
@@ -5341,7 +5341,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
*
@@ -5411,7 +5411,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
*
@@ -5502,7 +5502,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
*
@@ -5704,7 +5704,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
*
@@ -5742,7 +5742,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
*
@@ -5811,7 +5811,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
*
@@ -5885,7 +5885,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
*
@@ -5954,9 +5954,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
*
@@ -6020,16 +6020,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));
@@ -6039,13 +6039,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
@@ -6091,11 +6091,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
*/
@@ -6111,7 +6111,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() {
@@ -6131,8 +6131,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
@@ -6304,28 +6304,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,
@@ -6338,7 +6338,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.
*
@@ -6700,17 +6700,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.
@@ -7076,12 +7076,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
@@ -7193,14 +7193,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() {
@@ -7213,8 +7213,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
*/
@@ -7334,7 +7334,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
@@ -7515,12 +7515,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
@@ -7557,29 +7557,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.
@@ -7592,8 +7592,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
@@ -7619,31 +7619,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
@@ -7661,9 +7661,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
@@ -7671,26 +7671,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
@@ -7707,8 +7707,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
@@ -7943,8 +7943,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
*/
@@ -8125,12 +8125,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() {
@@ -8139,11 +8139,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() {
@@ -8222,7 +8222,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
@@ -8247,7 +8247,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
*/
@@ -8342,10 +8342,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
@@ -8394,7 +8394,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
*
@@ -8431,10 +8431,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
@@ -8459,12 +8459,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
@@ -8490,9 +8490,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)
@@ -8693,7 +8693,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");
@@ -8747,31 +8747,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
@@ -8813,12 +8813,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)
@@ -8960,15 +8960,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.
*
@@ -9014,7 +9014,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
@@ -9091,7 +9091,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
*/
@@ -9118,16 +9118,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() {
@@ -9228,7 +9228,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
*/
@@ -9265,7 +9265,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
@@ -9274,7 +9274,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
*/
@@ -9294,7 +9294,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() {
@@ -9304,7 +9304,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
*/
@@ -9315,7 +9315,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
*/
@@ -9324,13 +9324,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) {
@@ -9357,7 +9357,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
@@ -9367,10 +9367,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
@@ -9386,9 +9386,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
*/
@@ -9403,7 +9403,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();
@@ -9411,9 +9411,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) {
@@ -9424,7 +9424,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();
@@ -9433,59 +9433,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) {
@@ -9533,7 +9533,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
*/
@@ -9582,9 +9582,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);
@@ -9594,7 +9594,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()) {
@@ -9613,7 +9613,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();
@@ -9633,7 +9633,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();
@@ -9641,7 +9641,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.
*
@@ -9653,13 +9653,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() {
@@ -9669,23 +9669,23 @@
/**
* Resizes this object so that it has width and height.
*
- * @param d - the dimension specifying the new size of the object
+ * @param d the dimension specifying the new size of the object
*/
public void setSize(Dimension d) {
Component.this.setSize(d);
}
/**
- * 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
@@ -9759,7 +9759,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-27 21:49:16.556202191 +0400
+++ new/src/java.desktop/share/classes/java/awt/ComponentOrientation.java 2015-10-27 21:49:16.364202199 +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-27 21:49:17.092202166 +0400
+++ new/src/java.desktop/share/classes/java/awt/Composite.java 2015-10-27 21:49:16.900202175 +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-27 21:49:17.628202142 +0400
+++ new/src/java.desktop/share/classes/java/awt/CompositeContext.java 2015-10-27 21:49:17.436202151 +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-27 21:49:18.164202118 +0400
+++ new/src/java.desktop/share/classes/java/awt/Container.java 2015-10-27 21:49:17.964202127 +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
@@ -3147,7 +3147,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,
@@ -3218,12 +3218,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
*/
@@ -3390,11 +3390,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() {
@@ -3458,7 +3458,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
@@ -3478,7 +3478,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
@@ -3488,8 +3488,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
*/
public final boolean isFocusTraversalPolicyProvider() {
@@ -3539,7 +3539,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
@@ -3650,26 +3650,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
@@ -3698,8 +3698,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)
@@ -3796,7 +3796,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
@@ -3806,24 +3806,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);
@@ -3842,7 +3842,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
*/
@@ -3898,15 +3898,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()) {
@@ -3962,7 +3962,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
@@ -3981,10 +3981,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-27 21:49:18.796202090 +0400
+++ new/src/java.desktop/share/classes/java/awt/ContainerOrderFocusTraversalPolicy.java 2015-10-27 21:49:18.604202099 +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-27 21:49:19.336202066 +0400
+++ new/src/java.desktop/share/classes/java/awt/Cursor.java 2015-10-27 21:49:19.144202074 +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-27 21:49:19.872202042 +0400
+++ new/src/java.desktop/share/classes/java/awt/DefaultFocusTraversalPolicy.java 2015-10-27 21:49:19.680202050 +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-27 21:49:20.428202017 +0400
+++ new/src/java.desktop/share/classes/java/awt/DefaultKeyboardFocusManager.java 2015-10-27 21:49:20.216202026 +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-27 21:49:20.972201992 +0400
+++ new/src/java.desktop/share/classes/java/awt/Desktop.java 2015-10-27 21:49:20.780202001 +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-27 21:49:24.808201820 +0400
+++ new/src/java.desktop/share/classes/java/awt/FileDialog.java 2015-10-27 21:49:24.612201829 +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-27 21:49:25.352201796 +0400
+++ new/src/java.desktop/share/classes/java/awt/FlowLayout.java 2015-10-27 21:49:25.160201804 +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-27 21:49:25.900201771 +0400
+++ new/src/java.desktop/share/classes/java/awt/FocusTraversalPolicy.java 2015-10-27 21:49:25.708201780 +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-27 21:49:26.448201746 +0400
+++ new/src/java.desktop/share/classes/java/awt/Font.java 2015-10-27 21:49:26.240201756 +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-27 21:49:27.068201718 +0400
+++ new/src/java.desktop/share/classes/java/awt/FontFormatException.java 2015-10-27 21:49:26.876201727 +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-27 21:49:27.632201693 +0400
+++ new/src/java.desktop/share/classes/java/awt/FontMetrics.java 2015-10-27 21:49:27.420201703 +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-27 21:49:28.180201669 +0400
+++ new/src/java.desktop/share/classes/java/awt/Frame.java 2015-10-27 21:49:27.984201677 +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-27 21:49:28.740201643 +0400
+++ new/src/java.desktop/share/classes/java/awt/GradientPaint.java 2015-10-27 21:49:28.548201652 +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-27 21:49:29.280201619 +0400
+++ new/src/java.desktop/share/classes/java/awt/Graphics.java 2015-10-27 21:49:29.084201628 +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-27 21:49:29.840201594 +0400
+++ new/src/java.desktop/share/classes/java/awt/Graphics2D.java 2015-10-27 21:49:29.648201603 +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-27 21:49:30.424201568 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsConfigTemplate.java 2015-10-27 21:49:30.232201576 +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-27 21:49:30.960201544 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsConfiguration.java 2015-10-27 21:49:30.768201552 +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-27 21:49:31.500201519 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsDevice.java 2015-10-27 21:49:31.308201528 +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-27 21:49:32.044201495 +0400
+++ new/src/java.desktop/share/classes/java/awt/GraphicsEnvironment.java 2015-10-27 21:49:31.852201504 +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-27 21:49:32.584201471 +0400
+++ new/src/java.desktop/share/classes/java/awt/GridBagConstraints.java 2015-10-27 21:49:32.392201479 +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-27 21:49:33.148201445 +0400
+++ new/src/java.desktop/share/classes/java/awt/GridBagLayout.java 2015-10-27 21:49:32.936201455 +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-27 21:49:33.728201419 +0400
+++ new/src/java.desktop/share/classes/java/awt/Image.java 2015-10-27 21:49:33.536201428 +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-27 21:49:34.264201395 +0400
+++ new/src/java.desktop/share/classes/java/awt/ImageCapabilities.java 2015-10-27 21:49:34.072201404 +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-27 21:49:34.800201371 +0400
+++ new/src/java.desktop/share/classes/java/awt/Insets.java 2015-10-27 21:49:34.608201380 +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-27 21:49:35.336201347 +0400
+++ new/src/java.desktop/share/classes/java/awt/ItemSelectable.java 2015-10-27 21:49:35.144201356 +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-27 21:49:35.868201323 +0400
+++ new/src/java.desktop/share/classes/java/awt/JobAttributes.java 2015-10-27 21:49:35.676201332 +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-27 21:49:36.420201298 +0400
+++ new/src/java.desktop/share/classes/java/awt/KeyEventDispatcher.java 2015-10-27 21:49:36.228201307 +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-27 21:49:36.956201274 +0400
+++ new/src/java.desktop/share/classes/java/awt/KeyEventPostProcessor.java 2015-10-27 21:49:36.764201283 +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-27 21:49:37.492201250 +0400
+++ new/src/java.desktop/share/classes/java/awt/KeyboardFocusManager.java 2015-10-27 21:49:37.300201259 +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
@@ -603,7 +603,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
@@ -828,9 +828,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
@@ -932,9 +932,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
@@ -1156,16 +1156,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
@@ -1355,7 +1355,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
*
@@ -1442,11 +1442,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.
*
@@ -1538,7 +1538,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
*
@@ -1612,11 +1612,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.
*
@@ -1645,8 +1645,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)
@@ -1669,8 +1669,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.
@@ -1756,8 +1756,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.
@@ -1790,7 +1790,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
@@ -1910,14 +1910,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
*/
@@ -1927,9 +1927,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
@@ -2001,8 +2001,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
@@ -2018,16 +2018,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
*/
@@ -2037,11 +2037,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-27 21:49:38.072201224 +0400
+++ new/src/java.desktop/share/classes/java/awt/Label.java 2015-10-27 21:49:37.880201233 +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-27 21:49:38.612201200 +0400
+++ new/src/java.desktop/share/classes/java/awt/LayoutManager.java 2015-10-27 21:49:38.416201209 +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-27 21:49:39.148201176 +0400
+++ new/src/java.desktop/share/classes/java/awt/LinearGradientPaintContext.java 2015-10-27 21:49:38.956201185 +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-27 21:49:39.680201152 +0400
+++ new/src/java.desktop/share/classes/java/awt/List.java 2015-10-27 21:49:39.488201161 +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-27 21:49:40.256201126 +0400
+++ new/src/java.desktop/share/classes/java/awt/MediaTracker.java 2015-10-27 21:49:40.060201135 +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-27 21:49:40.808201101 +0400
+++ new/src/java.desktop/share/classes/java/awt/Menu.java 2015-10-27 21:49:40.616201110 +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-27 21:49:41.360201077 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuBar.java 2015-10-27 21:49:41.168201085 +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-27 21:49:41.900201052 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuComponent.java 2015-10-27 21:49:41.708201061 +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-27 21:49:42.456201027 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuItem.java 2015-10-27 21:49:42.264201036 +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
@@ -124,9 +124,9 @@
String label;
/**
- * This field indicates the command tha has been issued
+ * This field indicates the command that 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-27 21:49:43.008201003 +0400
+++ new/src/java.desktop/share/classes/java/awt/MenuShortcut.java 2015-10-27 21:49:42.812201011 +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-27 21:49:43.548200978 +0400
+++ new/src/java.desktop/share/classes/java/awt/MouseInfo.java 2015-10-27 21:49:43.348200987 +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-27 21:49:44.088200954 +0400
+++ new/src/java.desktop/share/classes/java/awt/PageAttributes.java 2015-10-27 21:49:43.892200963 +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-27 21:49:44.632200930 +0400
+++ new/src/java.desktop/share/classes/java/awt/Paint.java 2015-10-27 21:49:44.440200938 +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-27 21:49:45.164200906 +0400
+++ new/src/java.desktop/share/classes/java/awt/PaintContext.java 2015-10-27 21:49:44.972200914 +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-27 21:49:45.696200882 +0400
+++ new/src/java.desktop/share/classes/java/awt/Panel.java 2015-10-27 21:49:45.504200891 +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-27 21:49:46.228200858 +0400
+++ new/src/java.desktop/share/classes/java/awt/Point.java 2015-10-27 21:49:46.036200867 +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-27 21:49:46.764200834 +0400
+++ new/src/java.desktop/share/classes/java/awt/Polygon.java 2015-10-27 21:49:46.568200843 +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-27 21:49:47.308200809 +0400
+++ new/src/java.desktop/share/classes/java/awt/PopupMenu.java 2015-10-27 21:49:47.116200818 +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-27 21:49:47.844200785 +0400
+++ new/src/java.desktop/share/classes/java/awt/Rectangle.java 2015-10-27 21:49:47.648200794 +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-27 21:49:51.192200635 +0400
+++ new/src/java.desktop/share/classes/java/awt/Shape.java 2015-10-27 21:49:50.996200644 +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-27 21:49:51.736200611 +0400
+++ new/src/java.desktop/share/classes/java/awt/SplashScreen.java 2015-10-27 21:49:51.540200619 +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-27 21:49:52.272200587 +0400
+++ new/src/java.desktop/share/classes/java/awt/Stroke.java 2015-10-27 21:49:52.080200595 +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-27 21:49:52.808200562 +0400
+++ new/src/java.desktop/share/classes/java/awt/SystemColor.java 2015-10-27 21:49:52.616200571 +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-27 21:49:53.348200538 +0400
+++ new/src/java.desktop/share/classes/java/awt/SystemTray.java 2015-10-27 21:49:53.152200547 +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-27 21:49:53.888200514 +0400
+++ new/src/java.desktop/share/classes/java/awt/TextArea.java 2015-10-27 21:49:53.696200523 +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-27 21:49:54.436200489 +0400
+++ new/src/java.desktop/share/classes/java/awt/TextComponent.java 2015-10-27 21:49:54.244200498 +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-27 21:49:54.988200465 +0400
+++ new/src/java.desktop/share/classes/java/awt/TextField.java 2015-10-27 21:49:54.796200473 +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-27 21:49:55.540200440 +0400
+++ new/src/java.desktop/share/classes/java/awt/TexturePaint.java 2015-10-27 21:49:55.348200448 +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-27 21:49:56.108200414 +0400
+++ new/src/java.desktop/share/classes/java/awt/Toolkit.java 2015-10-27 21:49:55.896200424 +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-27 21:49:56.696200388 +0400
+++ new/src/java.desktop/share/classes/java/awt/Transparency.java 2015-10-27 21:49:56.500200397 +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-27 21:49:57.228200364 +0400
+++ new/src/java.desktop/share/classes/java/awt/TrayIcon.java 2015-10-27 21:49:57.036200373 +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-27 21:49:57.780200339 +0400
+++ new/src/java.desktop/share/classes/java/awt/Window.java 2015-10-27 21:49:57.584200348 +0400
@@ -1926,7 +1926,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-27 21:49:58.360200313 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ColorSpace.java 2015-10-27 21:49:58.160200322 +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-27 21:49:58.904200289 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ICC_ColorSpace.java 2015-10-27 21:49:58.708200298 +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-27 21:49:59.440200265 +0400
+++ new/src/java.desktop/share/classes/java/awt/color/ICC_Profile.java 2015-10-27 21:49:59.248200273 +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-27 21:50:00.540200215 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/Autoscroll.java 2015-10-27 21:50:00.344200224 +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-27 21:50:01.072200191 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DnDConstants.java 2015-10-27 21:50:00.880200200 +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-27 21:50:01.604200167 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DnDEventMulticaster.java 2015-10-27 21:50:01.412200176 +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-27 21:50:02.144200143 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragGestureEvent.java 2015-10-27 21:50:01.952200152 +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-27 21:50:02.688200119 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragGestureListener.java 2015-10-27 21:50:02.492200128 +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-27 21:50:03.224200095 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragGestureRecognizer.java 2015-10-27 21:50:03.028200104 +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-27 21:50:03.768200070 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSource.java 2015-10-27 21:50:03.572200079 +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-27 21:50:04.328200045 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceAdapter.java 2015-10-27 21:50:04.132200054 +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-27 21:50:04.864200021 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceContext.java 2015-10-27 21:50:04.672200030 +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-27 21:50:05.416199996 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceDragEvent.java 2015-10-27 21:50:05.220200005 +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-27 21:50:05.956199972 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceDropEvent.java 2015-10-27 21:50:05.760199981 +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-27 21:50:06.496199948 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceEvent.java 2015-10-27 21:50:06.304199956 +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-27 21:50:07.032199924 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceListener.java 2015-10-27 21:50:06.840199932 +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-27 21:50:07.564199900 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DragSourceMotionListener.java 2015-10-27 21:50:07.372199908 +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-27 21:50:08.096199876 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTarget.java 2015-10-27 21:50:07.904199885 +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-27 21:50:08.648199851 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetAdapter.java 2015-10-27 21:50:08.456199860 +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-27 21:50:09.180199827 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetDragEvent.java 2015-10-27 21:50:08.988199836 +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-27 21:50:09.716199803 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetDropEvent.java 2015-10-27 21:50:09.524199812 +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-27 21:50:10.264199779 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetEvent.java 2015-10-27 21:50:10.060199788 +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-27 21:50:10.800199754 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/DropTargetListener.java 2015-10-27 21:50:10.608199763 +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-27 21:50:11.340199730 +0400
+++ new/src/java.desktop/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java 2015-10-27 21:50:11.144199739 +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-27 21:50:11.876199706 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/AWTEventListener.java 2015-10-27 21:50:11.684199715 +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-27 21:50:12.412199682 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ActionEvent.java 2015-10-27 21:50:12.216199691 +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-27 21:50:12.948199658 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ActionListener.java 2015-10-27 21:50:12.756199667 +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-27 21:50:13.484199634 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/AdjustmentEvent.java 2015-10-27 21:50:13.292199643 +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-27 21:50:14.020199610 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ComponentAdapter.java 2015-10-27 21:50:13.828199619 +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-27 21:50:14.556199586 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ComponentEvent.java 2015-10-27 21:50:14.364199594 +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-27 21:50:15.092199562 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ComponentListener.java 2015-10-27 21:50:14.900199570 +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-27 21:50:15.624199538 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ContainerAdapter.java 2015-10-27 21:50:15.432199546 +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-27 21:50:16.156199514 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ContainerEvent.java 2015-10-27 21:50:15.964199523 +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-27 21:50:16.696199490 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ContainerListener.java 2015-10-27 21:50:16.500199499 +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-27 21:50:17.760199442 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/FocusEvent.java 2015-10-27 21:50:17.568199451 +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-27 21:50:18.300199418 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/FocusListener.java 2015-10-27 21:50:18.104199426 +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-27 21:50:18.832199394 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyBoundsAdapter.java 2015-10-27 21:50:18.640199402 +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-27 21:50:19.364199370 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyBoundsListener.java 2015-10-27 21:50:19.172199379 +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-27 21:50:19.896199346 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyEvent.java 2015-10-27 21:50:19.704199355 +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
- * {@link java.awt.MouseInfo#getNumberOfButtons() current number of buttons} and the support
- * for extended mouse buttons is {@link Toolkit#areExtraMouseButtonsEnabled() enabled}
+ * @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
* @throws IllegalArgumentException if an invalid {@code button}
* value is passed in
@@ -701,12 +703,14 @@
* {@link java.awt.MouseInfo#getNumberOfButtons() MouseInfo.getNumberOfButtons()}
* if the mouse has more than three buttons.
*
- * @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
- * {@link java.awt.MouseInfo#getNumberOfButtons() current number of buttons} and the support
+ * @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
* @throws IllegalArgumentException if an invalid {@code button}
@@ -865,7 +869,8 @@
*
@@ -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-27 21:50:20.440199322 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/HierarchyListener.java 2015-10-27 21:50:20.244199330 +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-27 21:50:20.976199297 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/InputEvent.java 2015-10-27 21:50:20.784199306 +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-27 21:50:22.060199249 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ItemEvent.java 2015-10-27 21:50:21.864199258 +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-27 21:50:22.596199225 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/ItemListener.java 2015-10-27 21:50:22.404199233 +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-27 21:50:23.132199201 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/KeyAdapter.java 2015-10-27 21:50:22.936199209 +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-27 21:50:23.668199177 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/KeyEvent.java 2015-10-27 21:50:23.472199185 +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-27 21:50:24.228199151 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/KeyListener.java 2015-10-27 21:50:24.036199160 +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-27 21:50:24.764199127 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseEvent.java 2015-10-27 21:50:24.572199136 +0400
@@ -526,13 +526,15 @@
* {@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-27 21:50:25.880199077 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseMotionAdapter.java 2015-10-27 21:50:25.668199087 +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-27 21:50:26.412199053 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseMotionListener.java 2015-10-27 21:50:26.216199062 +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-27 21:50:26.948199029 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/MouseWheelEvent.java 2015-10-27 21:50:26.756199038 +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-27 21:50:28.564198957 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/TextEvent.java 2015-10-27 21:50:28.372198965 +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-27 21:50:29.108198932 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/TextListener.java 2015-10-27 21:50:28.912198941 +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-27 21:50:29.644198908 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowAdapter.java 2015-10-27 21:50:29.448198917 +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-27 21:50:30.200198883 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowEvent.java 2015-10-27 21:50:29.988198893 +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-27 21:50:30.744198859 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowFocusListener.java 2015-10-27 21:50:30.548198868 +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-27 21:50:31.280198835 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowListener.java 2015-10-27 21:50:31.088198843 +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-27 21:50:31.816198811 +0400
+++ new/src/java.desktop/share/classes/java/awt/event/WindowStateListener.java 2015-10-27 21:50:31.624198819 +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-27 21:50:32.356198786 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/FontRenderContext.java 2015-10-27 21:50:32.160198795 +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-27 21:50:32.916198761 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GlyphJustificationInfo.java 2015-10-27 21:50:32.700198771 +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-27 21:50:33.452198737 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GlyphMetrics.java 2015-10-27 21:50:33.260198746 +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-27 21:50:33.996198713 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GlyphVector.java 2015-10-27 21:50:33.804198721 +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-27 21:50:34.548198688 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/GraphicAttribute.java 2015-10-27 21:50:34.356198697 +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-27 21:50:35.088198664 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/ImageGraphicAttribute.java 2015-10-27 21:50:34.892198673 +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-27 21:50:35.628198639 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/LayoutPath.java 2015-10-27 21:50:35.436198648 +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-27 21:50:36.168198615 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/LineBreakMeasurer.java 2015-10-27 21:50:35.972198624 +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-27 21:50:36.712198591 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/LineMetrics.java 2015-10-27 21:50:36.520198599 +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-27 21:50:37.248198567 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/MultipleMaster.java 2015-10-27 21:50:37.056198575 +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-27 21:50:37.800198542 +0400
+++ new/src/java.desktop/share/classes/java/awt/font/NumericShaper.java 2015-10-27 21:50:37.592198551 +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
*
- * "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-27 21:52:26.196193674 +0400
+++ new/src/java.desktop/share/classes/javax/print/DocPrintJob.java 2015-10-27 21:52:26.000193683 +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-27 21:52:26.756193649 +0400
+++ new/src/java.desktop/share/classes/javax/print/MimeType.java 2015-10-27 21:52:26.536193659 +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-27 21:52:27.312193624 +0400
+++ new/src/java.desktop/share/classes/javax/print/PrintService.java 2015-10-27 21:52:27.120193633 +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-27 21:52:27.852193600 +0400
+++ new/src/java.desktop/share/classes/javax/print/PrintServiceLookup.java 2015-10-27 21:52:27.660193608 +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/ServiceUI.java 2015-10-27 21:52:28.404193575 +0400
+++ new/src/java.desktop/share/classes/javax/print/ServiceUI.java 2015-10-27 21:52:28.208193584 +0400
@@ -136,8 +136,8 @@
* @param x location of dialog including border in screen coordinates
* @param y location of dialog including border in screen coordinates
* @param services to be browsable, must be non-null.
- * @param defaultService - initial PrintService to display.
- * @param flavor - the flavor to be printed, or null.
+ * @param defaultService initial PrintService to display.
+ * @param flavor the flavor to be printed, or null.
* @param attributes on input is the initial application supplied
* preferences. This cannot be null but may be empty.
* On output the attributes reflect changes made by the user.
--- old/src/java.desktop/share/classes/javax/print/SimpleDoc.java 2015-10-27 21:52:28.940193551 +0400
+++ new/src/java.desktop/share/classes/javax/print/SimpleDoc.java 2015-10-27 21:52:28.748193559 +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-27 21:52:29.492193526 +0400
+++ new/src/java.desktop/share/classes/javax/print/StreamPrintService.java 2015-10-27 21:52:29.288193535 +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-27 21:52:30.024193502 +0400
+++ new/src/java.desktop/share/classes/javax/print/StreamPrintServiceFactory.java 2015-10-27 21:52:29.832193511 +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.
*/
@@ -101,7 +101,7 @@
* @param outputMimeType representing the required output format, used to
* identify suitable stream printer factories. A value of null means
* match all formats.
- * @return - matching factories for stream print service instance,
+ * @return matching factories for stream print service instance,
* empty if no suitable factories could be located.
*/
public static StreamPrintServiceFactory[]
@@ -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-27 21:52:30.580193477 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/Attribute.java 2015-10-27 21:52:30.364193487 +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-27 21:52:31.108193453 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/AttributeSetUtilities.java 2015-10-27 21:52:30.916193462 +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-27 21:52:31.644193429 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/DateTimeSyntax.java 2015-10-27 21:52:31.452193438 +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-27 21:52:32.184193405 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/DocAttribute.java 2015-10-27 21:52:31.988193414 +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-27 21:52:32.712193381 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/EnumSyntax.java 2015-10-27 21:52:32.520193390 +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-27 21:52:33.248193357 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashDocAttributeSet.java 2015-10-27 21:52:33.052193366 +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-27 21:52:33.788193333 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashPrintJobAttributeSet.java 2015-10-27 21:52:33.588193342 +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-27 21:52:34.320193309 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashPrintRequestAttributeSet.java 2015-10-27 21:52:34.128193318 +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-27 21:52:34.848193285 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/HashPrintServiceAttributeSet.java 2015-10-27 21:52:34.656193294 +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-27 21:52:35.384193261 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/IntegerSyntax.java 2015-10-27 21:52:35.192193270 +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-27 21:52:35.916193237 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/PrintRequestAttribute.java 2015-10-27 21:52:35.724193246 +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-27 21:52:36.448193214 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/ResolutionSyntax.java 2015-10-27 21:52:36.256193222 +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-27 21:52:36.984193190 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/SetOfIntegerSyntax.java 2015-10-27 21:52:36.792193198 +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-27 21:52:37.524193165 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/Size2DSyntax.java 2015-10-27 21:52:37.332193174 +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-27 21:52:38.060193141 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/TextSyntax.java 2015-10-27 21:52:37.868193150 +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-27 21:52:38.592193117 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/URISyntax.java 2015-10-27 21:52:38.400193126 +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-27 21:52:39.128193093 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Chromaticity.java 2015-10-27 21:52:38.936193102 +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-27 21:52:39.660193069 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/ColorSupported.java 2015-10-27 21:52:39.468193078 +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-27 21:52:40.196193045 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Compression.java 2015-10-27 21:52:40.000193054 +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-27 21:52:40.728193021 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Copies.java 2015-10-27 21:52:40.536193030 +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-27 21:52:41.260192998 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/CopiesSupported.java 2015-10-27 21:52:41.068193006 +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-27 21:52:41.796192973 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtCompleted.java 2015-10-27 21:52:41.604192982 +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-27 21:52:42.328192950 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtCreation.java 2015-10-27 21:52:42.132192958 +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-27 21:52:42.860192926 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DateTimeAtProcessing.java 2015-10-27 21:52:42.668192934 +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-27 21:52:43.392192902 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Destination.java 2015-10-27 21:52:43.200192910 +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-27 21:52:43.932192878 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DialogTypeSelection.java 2015-10-27 21:52:43.728192887 +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-27 21:52:44.484192853 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/DocumentName.java 2015-10-27 21:52:44.284192862 +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-27 21:52:45.016192829 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Fidelity.java 2015-10-27 21:52:44.824192837 +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-27 21:52:45.552192805 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Finishings.java 2015-10-27 21:52:45.360192813 +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-27 21:52:46.088192781 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobHoldUntil.java 2015-10-27 21:52:45.896192789 +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-27 21:52:46.640192756 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressions.java 2015-10-27 21:52:46.428192765 +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-27 21:52:47.172192732 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressionsCompleted.java 2015-10-27 21:52:46.980192741 +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-27 21:52:47.704192708 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobImpressionsSupported.java 2015-10-27 21:52:47.512192717 +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-27 21:52:48.240192684 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctets.java 2015-10-27 21:52:48.048192693 +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-27 21:52:48.772192660 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctetsProcessed.java 2015-10-27 21:52:48.580192669 +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-27 21:52:49.304192636 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctetsSupported.java 2015-10-27 21:52:49.112192645 +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-27 21:52:49.836192612 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheets.java 2015-10-27 21:52:49.644192621 +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-27 21:52:50.368192588 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheetsCompleted.java 2015-10-27 21:52:50.176192597 +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-27 21:52:50.900192565 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMediaSheetsSupported.java 2015-10-27 21:52:50.708192573 +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-27 21:52:51.432192541 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobMessageFromOperator.java 2015-10-27 21:52:51.240192549 +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-27 21:52:51.964192517 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobName.java 2015-10-27 21:52:51.772192525 +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-27 21:52:52.496192493 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobOriginatingUserName.java 2015-10-27 21:52:52.304192502 +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-27 21:52:53.032192469 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobPriority.java 2015-10-27 21:52:52.840192477 +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-27 21:52:53.568192445 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobPrioritySupported.java 2015-10-27 21:52:53.376192453 +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-27 21:52:54.104192421 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobSheets.java 2015-10-27 21:52:53.908192429 +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-27 21:52:54.636192397 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobState.java 2015-10-27 21:52:54.440192406 +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-27 21:52:55.168192373 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/JobStateReason.java 2015-10-27 21:52:54.976192382 +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-27 21:52:55.704192349 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Media.java 2015-10-27 21:52:55.508192358 +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-27 21:52:56.240192325 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/MediaPrintableArea.java 2015-10-27 21:52:56.048192333 +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-27 21:52:56.772192301 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/MediaSize.java 2015-10-27 21:52:56.580192309 +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
@@ -168,7 +168,7 @@
/**
* Get the MediaSize for the specified named media.
*
- * @param media - the name of the media for which the size is sought
+ * @param media the name of the media for which the size is sought
* @return size of the media, or null if this media is not associated
* with any size.
*/
@@ -187,11 +187,11 @@
* 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-27 21:52:57.320192276 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java 2015-10-27 21:52:57.128192285 +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-27 21:52:57.860192252 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberOfDocuments.java 2015-10-27 21:52:57.668192261 +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-27 21:52:58.392192228 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberOfInterveningJobs.java 2015-10-27 21:52:58.200192237 +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-27 21:52:58.928192204 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberUp.java 2015-10-27 21:52:58.736192213 +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-27 21:52:59.472192180 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/NumberUpSupported.java 2015-10-27 21:52:59.280192188 +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-27 21:53:00.004192156 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/OrientationRequested.java 2015-10-27 21:52:59.812192164 +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-27 21:53:00.540192132 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/OutputDeviceAssigned.java 2015-10-27 21:53:00.344192140 +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-27 21:53:01.068192108 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PDLOverrideSupported.java 2015-10-27 21:53:00.876192117 +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-27 21:53:01.600192084 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PageRanges.java 2015-10-27 21:53:01.408192093 +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-27 21:53:02.136192060 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PagesPerMinute.java 2015-10-27 21:53:01.944192069 +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-27 21:53:02.672192036 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PagesPerMinuteColor.java 2015-10-27 21:53:02.476192045 +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-27 21:53:03.204192012 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PresentationDirection.java 2015-10-27 21:53:03.012192021 +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-27 21:53:03.736191988 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrintQuality.java 2015-10-27 21:53:03.544191997 +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-27 21:53:04.268191964 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterInfo.java 2015-10-27 21:53:04.076191973 +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-27 21:53:04.804191940 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterIsAcceptingJobs.java 2015-10-27 21:53:04.608191949 +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-27 21:53:05.336191916 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterLocation.java 2015-10-27 21:53:05.144191925 +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-27 21:53:05.868191892 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMakeAndModel.java 2015-10-27 21:53:05.676191901 +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-27 21:53:06.400191868 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMessageFromOperator.java 2015-10-27 21:53:06.208191877 +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-27 21:53:06.932191845 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMoreInfo.java 2015-10-27 21:53:06.740191853 +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-27 21:53:07.464191821 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterMoreInfoManufacturer.java 2015-10-27 21:53:07.272191829 +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-27 21:53:08.000191797 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterName.java 2015-10-27 21:53:07.808191805 +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-27 21:53:08.532191773 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterResolution.java 2015-10-27 21:53:08.340191781 +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-27 21:53:09.068191749 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterState.java 2015-10-27 21:53:08.876191757 +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-27 21:53:09.600191725 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterStateReason.java 2015-10-27 21:53:09.408191733 +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-27 21:53:10.136191701 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterURI.java 2015-10-27 21:53:09.944191709 +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-27 21:53:10.668191677 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/QueuedJobCount.java 2015-10-27 21:53:10.476191685 +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-27 21:53:11.200191653 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/ReferenceUriSchemesSupported.java 2015-10-27 21:53:11.008191662 +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-27 21:53:11.732191629 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/RequestingUserName.java 2015-10-27 21:53:11.540191638 +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-27 21:53:12.268191605 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Severity.java 2015-10-27 21:53:12.076191614 +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-27 21:53:12.804191581 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/SheetCollate.java 2015-10-27 21:53:12.608191590 +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-27 21:53:13.340191557 +0400
+++ new/src/java.desktop/share/classes/javax/print/attribute/standard/Sides.java 2015-10-27 21:53:13.148191565 +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-27 21:53:13.892191532 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintEvent.java 2015-10-27 21:53:13.684191541 +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-27 21:53:14.436191508 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintJobAttributeEvent.java 2015-10-27 21:53:14.244191516 +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-27 21:53:14.968191484 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintJobAttributeListener.java 2015-10-27 21:53:14.776191492 +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-27 21:53:15.500191460 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintJobEvent.java 2015-10-27 21:53:15.304191469 +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-27 21:53:16.028191436 +0400
+++ new/src/java.desktop/share/classes/javax/print/event/PrintServiceAttributeEvent.java 2015-10-27 21:53:15.836191445 +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/sun/applet/AppletClassLoader.java 2015-10-27 21:53:16.620191410 +0400
+++ new/src/java.desktop/share/classes/sun/applet/AppletClassLoader.java 2015-10-27 21:53:16.368191421 +0400
@@ -358,7 +358,7 @@
* #getResource(String)}.null
+ * @return an input stream for reading the resource, or {@code null}
* if the resource could not be found
* @since 1.1
*/
@@ -418,7 +418,7 @@
* #getResource(String)}.null
+ * @return an input stream for reading the resource, or {@code null}
* if the resource could not be found
* @since 1.1
*/
--- old/src/java.desktop/share/classes/sun/applet/AppletSecurity.java 2015-10-27 21:53:17.176191385 +0400
+++ new/src/java.desktop/share/classes/sun/applet/AppletSecurity.java 2015-10-27 21:53:16.960191394 +0400
@@ -260,17 +260,17 @@
/**
- * Throws a SecurityException if the
+ * Throws a {@code SecurityException} if the
* calling thread is not allowed to access the package specified by
* the argument.
* loadClass method of class
+ * This method is used by the {@code loadClass} method of class
* loaders.
* checkPackageAccess method for class
- * SecurityManager calls
- * checkPermission with the
- * RuntimePermission("accessClassInPackage."+ pkgname)
+ * The {@code checkPackageAccess} method for class
+ * {@code SecurityManager} calls
+ * {@code checkPermission} with the
+ * {@code RuntimePermission("accessClassInPackage."+ pkgname)}
* permission.
*
* @param pkgname the package name.
@@ -302,8 +302,8 @@
/**
* Tests if a client can get access to the AWT event queue.
* checkPermission with the
- * AWTPermission("accessEventQueue") permission.
+ * This method calls {@code checkPermission} with the
+ * {@code AWTPermission("accessEventQueue")} permission.
*
* @since 1.1
* @exception SecurityException if the caller does not have
--- old/src/java.desktop/share/classes/sun/applet/AppletThreadGroup.java 2015-10-27 21:53:17.724191360 +0400
+++ new/src/java.desktop/share/classes/sun/applet/AppletThreadGroup.java 2015-10-27 21:53:17.516191369 +0400
@@ -51,7 +51,7 @@
* @param parent the parent thread group.
* @param name the name of the new thread group.
* @exception NullPointerException if the thread group argument is
- * null.
+ * {@code null}.
* @exception SecurityException if the current thread cannot create a
* thread in the specified thread group.
* @see java.lang.SecurityException
--- old/src/java.desktop/share/classes/sun/applet/Main.java 2015-10-27 21:53:18.256191336 +0400
+++ new/src/java.desktop/share/classes/sun/applet/Main.java 2015-10-27 21:53:18.064191345 +0400
@@ -229,7 +229,7 @@
*
* @param url a string which represents either a relative or absolute URL.
* @return a URL when the passed in string can be interpreted according
- * to the RFC, null otherwise.
+ * to the RFC, {@code null} otherwise.
* @exception ParseException
* Thrown when we are unable to construct a proper URL from the
* passed in string.
@@ -270,8 +270,8 @@
* Invoke the debugger with the arguments passed in to appletviewer.
*
* @param args The arguments passed into the debugger.
- * @return 0 if the debugger is invoked successfully,
- * 1 otherwise.
+ * @return {@code 0} if the debugger is invoked successfully,
+ * {@code 1} otherwise.
*/
private int invokeDebugger(String [] args) {
// CONSTRUCT THE COMMAND LINE
--- old/src/java.desktop/share/classes/sun/awt/AWTAccessor.java 2015-10-27 21:53:18.792191312 +0400
+++ new/src/java.desktop/share/classes/sun/awt/AWTAccessor.java 2015-10-27 21:53:18.600191321 +0400
@@ -85,7 +85,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.
*/
--- old/src/java.desktop/share/classes/sun/awt/AWTAutoShutdown.java 2015-10-27 21:53:19.336191288 +0400
+++ new/src/java.desktop/share/classes/sun/awt/AWTAutoShutdown.java 2015-10-27 21:53:19.144191296 +0400
@@ -41,20 +41,20 @@
* This class is to let AWT shutdown automatically when a user is done
* with AWT. It tracks AWT state using the following parameters:
*
- *
peerMap - the map between the existing peer objects
+ * toolkitThreadBusy - whether the toolkit thread
+ * busyThreadSet - a set of all the event dispatch
+ * peerMap is empty and toolkitThreadBusy
- * is false and busyThreadSet is empty.
+ * {@code peerMap} is empty and {@code toolkitThreadBusy}
+ * is false and {@code busyThreadSet} is empty.
* The internal AWTAutoShutdown logic secures that the single non-daemon
- * thread (blockerThread) is running when AWT is not in
+ * thread ({@code blockerThread}) is running when AWT is not in
* ready-to-shutdown state. This blocker thread is to prevent AWT from
* exiting since the toolkit thread is now daemon and all the event
* dispatch threads are started only when needed. Once it is detected
@@ -229,8 +229,8 @@
/**
* Determine whether AWT is currently in ready-to-shutdown state.
* AWT is considered to be in ready-to-shutdown state if
- * peerMap is empty and toolkitThreadBusy
- * is false and busyThreadSet is empty.
+ * {@code peerMap} is empty and {@code toolkitThreadBusy}
+ * is false and {@code busyThreadSet} is empty.
*
* @return true if AWT is in ready-to-shutdown state.
*/
--- old/src/java.desktop/share/classes/sun/awt/AppContext.java 2015-10-27 21:53:19.892191263 +0400
+++ new/src/java.desktop/share/classes/sun/awt/AppContext.java 2015-10-27 21:53:19.680191272 +0400
@@ -71,7 +71,7 @@
*
* For example, here we have a Foo service, with its pre-AppContext
* code:
+ *
{@code
* public class Foo {
* private static Foo defaultFoo = new Foo();
*
@@ -80,7 +80,8 @@
* }
*
* ... Foo service methods
- * }
+ *
{@code
* public class Foo {
* public static Foo getDefaultFoo() {
* Foo foo = (Foo)AppContext.getAppContext().get(Foo.class);
@@ -102,7 +103,8 @@
* }
*
* ... Foo service methods
- * }AppContexts.
+ * Returns a set containing all {@code AppContext}s.
*/
public static SetPropertyChangeListeners have been registered,
- * the changeSupport field describes them.
+ * If any {@code PropertyChangeListeners} have been registered,
+ * the {@code changeSupport} field describes them.
*
* @see #addPropertyChangeListener
* @see #removePropertyChangeListener
@@ -633,7 +635,7 @@
*
* @param key a key in the AppContext.
* @return the value to which the key is mapped in this AppContext;
- * null if the key is not mapped to any value.
+ * {@code null} if the key is not mapped to any value.
* @see #put(Object, Object)
* @since 1.2
*/
@@ -670,19 +672,19 @@
}
/**
- * Maps the specified key to the specified
- * value in this AppContext. Neither the key nor the
- * value can be null.
+ * Maps the specified {@code key} to the specified
+ * {@code value} in this AppContext. Neither the key nor the
+ * value can be {@code null}.
* get method
+ * The value can be retrieved by calling the {@code get} method
* with a key that is equal to the original key.
*
* @param key the AppContext key.
* @param value the value.
* @return the previous value of the specified key in this
- * AppContext, or null if it did not have one.
+ * AppContext, or {@code null} if it did not have one.
* @exception NullPointerException if the key or value is
- * null.
+ * {@code null}.
* @see #get(Object)
* @since 1.2
*/
@@ -702,7 +704,7 @@
*
* @param key the key that needs to be removed.
* @return the value to which the key had been mapped in this AppContext,
- * or null if the key did not have a mapping.
+ * or {@code null} if the key did not have a mapping.
* @since 1.2
*/
public Object remove(Object key) {
@@ -746,7 +748,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
*
@@ -825,7 +827,7 @@
* Returns an array of all the listeners which have been associated
* with the named property.
*
- * @return all of the PropertyChangeListeners associated with
+ * @return all of the {@code PropertyChangeListeners} associated with
* the named property or an empty array if no listeners have
* been added
*
--- old/src/java.desktop/share/classes/sun/awt/DisplayChangedListener.java 2015-10-27 21:53:20.436191238 +0400
+++ new/src/java.desktop/share/classes/sun/awt/DisplayChangedListener.java 2015-10-27 21:53:20.240191247 +0400
@@ -37,7 +37,7 @@
* screens.
*
* For win32, the listener object created from that class is then registered
- * with the WToolkit object using its addDisplayChangeListener
+ * with the WToolkit object using its {@code addDisplayChangeListener}
* method. When the display resolution is changed (which occurs,
* in Windows, either by the user changing the properties of the
* display through the control panel or other utility or by
--- old/src/java.desktop/share/classes/sun/awt/EmbeddedFrame.java 2015-10-27 21:53:20.968191214 +0400
+++ new/src/java.desktop/share/classes/sun/awt/EmbeddedFrame.java 2015-10-27 21:53:20.772191223 +0400
@@ -348,17 +348,17 @@
/**
* Synthesize native message to activate or deactivate EmbeddedFrame window
- * depending on the value of parameter b.
+ * depending on the value of parameter {@code b}.
* Peers should override this method if they are to implement
* this functionality.
- * @param doActivate if true, activates the window;
+ * @param doActivate if {@code true}, activates the window;
* otherwise, deactivates the window
*/
public void synthesizeWindowActivation(boolean doActivate) {}
/**
* Moves this embedded frame 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 relative to the native parent component.
* x and y parameters
+ * corner is specified by {@code x} and {@code y} parameters
* relative to the native parent component. The new size is specified by
- * width and height.
+ * {@code width} and {@code height}.
* width of this embedded frame
- * @param height the new height of this embedded frame
+ * @param width the new {@code width} of this embedded frame
+ * @param height the new {@code height} of this embedded frame
* @see java.awt.Component#setBounds
* @see #setLocationPrivate
* @see #getLocationPrivate
--- old/src/java.desktop/share/classes/sun/awt/FwDispatcher.java 2015-10-27 21:53:21.500191190 +0400
+++ new/src/java.desktop/share/classes/sun/awt/FwDispatcher.java 2015-10-27 21:53:21.308191199 +0400
@@ -48,7 +48,7 @@
/**
* Forwards a runnable to the delegate, which executes it on an appropriate thread.
- * @param r - a runnable calling {@link EventQueue#dispatchEventImpl(java.awt.AWTEvent, Object)}
+ * @param r a runnable calling {@link EventQueue#dispatchEventImpl(java.awt.AWTEvent, Object)}
*/
void scheduleDispatch(Runnable r);
--- old/src/java.desktop/share/classes/sun/awt/GlobalCursorManager.java 2015-10-27 21:53:22.032191166 +0400
+++ new/src/java.desktop/share/classes/sun/awt/GlobalCursorManager.java 2015-10-27 21:53:21.840191175 +0400
@@ -153,7 +153,7 @@
* updates:updateCursorImmediately(InputEvent).true, activates the frame;
+ * @param activate if {@code true}, activates the frame;
* otherwise, deactivates the frame
*/
public void emulateActivation(boolean activate) {
--- old/src/java.desktop/share/classes/sun/awt/PaintEventDispatcher.java 2015-10-27 21:53:23.100191119 +0400
+++ new/src/java.desktop/share/classes/sun/awt/PaintEventDispatcher.java 2015-10-27 21:53:22.908191127 +0400
@@ -40,7 +40,7 @@
private static PaintEventDispatcher dispatcher;
/**
- * Sets the current PaintEventDispatcher.
+ * Sets the current {@code PaintEventDispatcher}.
*
* @param dispatcher PaintEventDispatcher
*/
@@ -52,7 +52,7 @@
}
/**
- * Returns the currently active PaintEventDispatcher. This
+ * Returns the currently active {@code PaintEventDispatcher}. This
* will never return null.
*
* @return PaintEventDispatcher
@@ -67,9 +67,9 @@
}
/**
- * Creates and returns the PaintEvent that should be
+ * Creates and returns the {@code PaintEvent} that should be
* dispatched for the specified component. If this returns null
- * no PaintEvent is dispatched.
+ * no {@code PaintEvent} is dispatched.
* RepaintArea is a geometric construct created for the
+ * The {@code RepaintArea} is a geometric construct created for the
* purpose of holding the geometry of several coalesced paint events.
* This geometry is accessed synchronously, although it is written such
* that painting may still be executed asynchronously.
@@ -59,17 +59,17 @@
/**
- * Constructs a new RepaintArea
+ * Constructs a new {@code RepaintArea}
* @since 1.3
*/
public RepaintArea() {
}
/**
- * Constructs a new RepaintArea initialized to match
+ * Constructs a new {@code RepaintArea} initialized to match
* the values of the specified RepaintArea.
*
- * @param ra the RepaintArea from which to copy initial
+ * @param ra the {@code RepaintArea} from which to copy initial
* values to a newly constructed RepaintArea
* @since 1.3
*/
@@ -82,12 +82,12 @@
}
/**
- * Adds a Rectangle to this RepaintArea.
+ * Adds a {@code Rectangle} to this {@code RepaintArea}.
* PAINT Rectangles are divided into mostly vertical and mostly horizontal.
* Each group is unioned together.
* UPDATE Rectangles are unioned.
*
- * @param r the specified Rectangle
+ * @param r the specified {@code Rectangle}
* @param id possible values PaintEvent.UPDATE or PaintEvent.PAINT
* @since 1.3
*/
@@ -109,11 +109,11 @@
/**
- * Creates a new RepaintArea with the same geometry as this
+ * Creates a new {@code RepaintArea} with the same geometry as this
* RepaintArea, then removes all of the geometry from this
* RepaintArea and restores it to an empty RepaintArea.
*
- * @return ra a new RepaintArea having the same geometry as
+ * @return ra a new {@code RepaintArea} having the same geometry as
* this RepaintArea.
* @since 1.3
*/
@@ -186,7 +186,7 @@
* MAX_BENEFIT_RATIO times the benefit, then the vertical and horizontal unions are
* painted separately. Otherwise the entire bounding rectangle is painted.
*
- * @param target Component to paint or update
+ * @param target Component to {@code paint} or {@code update}
* @since 1.4
*/
public void paint(Object target, boolean shouldClearRectBeforePaint) {
@@ -248,7 +248,7 @@
}
/**
- * Calls Component.update(Graphics) with given Graphics.
+ * Calls {@code Component.update(Graphics)} with given Graphics.
*/
protected void updateComponent(Component comp, Graphics g) {
if (comp != null) {
@@ -257,7 +257,7 @@
}
/**
- * Calls Component.paint(Graphics) with given Graphics.
+ * Calls {@code Component.paint(Graphics)} with given Graphics.
*/
protected void paintComponent(Component comp, Graphics g) {
if (comp != null) {
--- old/src/java.desktop/share/classes/sun/awt/SunToolkit.java 2015-10-27 21:53:24.176191070 +0400
+++ new/src/java.desktop/share/classes/sun/awt/SunToolkit.java 2015-10-27 21:53:23.984191079 +0400
@@ -339,9 +339,9 @@
/**
* Sets the synchronous status of focus requests on lightweight
* components in the specified window to the specified value.
- * If the boolean parameter is true then the focus
+ * If the boolean parameter is {@code true} then the focus
* requests on lightweight components will be performed
- * synchronously, if it is false, then asynchronously.
+ * synchronously, if it is {@code false}, then asynchronously.
* By default, all windows have their lightweight request status
* set to asynchronous.
* SunToolkit.getDefaultToolkit() as a target of the
+ * {@code SunToolkit.getDefaultToolkit()} as a target of the
* event. See 6451487 for detailes.
* Does not wait for the execution to occur before returning to
* the caller.
@@ -1173,7 +1173,7 @@
/**
* Returns whether default toolkit needs the support of the xembed
* from embedding host(if any).
- * @return true, if XEmbed is needed, false otherwise
+ * @return {@code true}, if XEmbed is needed, {@code false} otherwise
*/
public static boolean needsXEmbed() {
String noxembed = AccessController.
@@ -1196,7 +1196,7 @@
/**
* Returns whether this toolkit needs the support of the xembed
* from embedding host(if any).
- * @return true, if XEmbed is needed, false otherwise
+ * @return {@code true}, if XEmbed is needed, {@code false} otherwise
*/
protected boolean needsXEmbedImpl() {
return false;
@@ -1215,8 +1215,8 @@
/**
* Returns whether the modal exclusion API is supported by the current toolkit.
- * When it isn't supported, calling setModalExcluded has no
- * effect, and isModalExcluded returns false for all windows.
+ * When it isn't supported, calling {@code setModalExcluded} has no
+ * effect, and {@code isModalExcluded} returns false for all windows.
*
* @return true if modal exclusion is supported by the toolkit, false otherwise
*
@@ -1249,7 +1249,7 @@
* events, focus transfer and z-order will continue to work for the
* window, it's owned windows and child components, even in the
* presence of a modal dialog.
- * For details on which Windows are normally blocked
+ * For details on which {@code Window}s are normally blocked
* by modal dialog, see {@link java.awt.Dialog}.
* Invoking this method when the modal exclusion API is not supported by
* the current toolkit has no effect.
@@ -1438,23 +1438,23 @@
*
*
+ *
+ * }
*
- * {@code
* Frame f = ...;
* f.setVisible(true);
* ((SunToolkit)Toolkit.getDefaultToolkit()).realSync();
- * f will be completely visible
+ *
+ *
+ * }
*
- * {@code
* b.requestFocus();
* ((SunToolkit)Toolkit.getDefaultToolkit()).realSync();
- * b will be focus owner.
+ * true if some events were processed,
- * false otherwise.
+ * {@code true} if some events were processed,
+ * {@code false} otherwise.
*/
protected abstract boolean syncNativeQueue(final long timeout);
@@ -1547,8 +1547,8 @@
* Waits for the Java event queue to empty. Ensures that all
* events are processed (including paint events), and that if
* recursive events were generated, they are also processed.
- * Should return true if more processing is
- * necessary, false otherwise.
+ * Should return {@code true} if more processing is
+ * necessary, {@code false} otherwise.
*/
@SuppressWarnings("serial")
protected final boolean waitForIdle(final long timeout) {
@@ -1813,7 +1813,7 @@
}
/**
- * Returns the Window ancestor of the component comp.
+ * Returns the {@code Window} ancestor of the component {@code comp}.
* @return Window ancestor of the component or component by itself if it is Window;
* null, if component is not a part of window hierarchy
*/
--- old/src/java.desktop/share/classes/sun/awt/datatransfer/DataTransferer.java 2015-10-27 21:53:24.736191045 +0400
+++ new/src/java.desktop/share/classes/sun/awt/datatransfer/DataTransferer.java 2015-10-27 21:53:24.544191054 +0400
@@ -124,7 +124,7 @@
*/
public abstract class DataTransferer {
/**
- * The DataFlavor representing a Java text encoding String
+ * The {@code DataFlavor} representing a Java text encoding String
* encoded in UTF-8, where
*
* representationClass = [B
@@ -323,7 +323,7 @@
* @param flavors the data flavors
* @param map the FlavorTable which contains mappings between
* DataFlavors and data formats
- * @throws NullPointerException if flavors or map is null
+ * @throws NullPointerException if flavors or map is {@code null}
*/
public SortedMapnull
+ * @throws NullPointerException if formats or map is {@code null}
*/
public SetDataFlavorComparator created with the specified
+ * {@code DataFlavorComparator} created with the specified
* map as an argument.
*
* @param formats the data formats
* @param map the FlavorTable which contains mappings between
* DataFlavors and data formats
- * @throws NullPointerException if formats or map is null
+ * @throws NullPointerException if formats or map is {@code null}
*/
public DataFlavor[] getFlavorsForFormatsAsArray(long[] formats,
FlavorTable map) {
@@ -1805,21 +1805,21 @@
/**
* Concatenates the data represented by two objects. Objects can be either
- * byte arrays or instances of InputStream. If both arguments
+ * byte arrays or instances of {@code InputStream}. If both arguments
* are byte arrays byte array will be returned. Otherwise an
- * InputStream will be returned.
+ * {@code InputStream} will be returned.
* InputStream which represents
+ * @return a byte array or an {@code InputStream} which represents
* a logical concatenation of the two arguments.
* @throws NullPointerException is either of the arguments is
- * null
+ * {@code null}
* @throws ClassCastException is either of the arguments is
- * neither byte array nor an instance of InputStream.
+ * neither byte array nor an instance of {@code InputStream}.
*/
private Object concatData(Object obj1, Object obj2) {
InputStream str1 = null;
@@ -1962,7 +1962,7 @@
/**
* Helper function to convert a Set of DataFlavors to a sorted array.
- * The array will be sorted according to DataFlavorComparator.
+ * The array will be sorted according to {@code DataFlavorComparator}.
*/
public static DataFlavor[] setToSortedDataFlavorArray(SetList.
+ * returns an empty {@code List}.
*/
public LinkedHashSetList.
+ * returns an empty {@code List}.
*/
public LinkedHashSetFlavorListeners currently registered
- * on this clipboard across all AppContexts.
+ * A number of {@code FlavorListener}s currently registered
+ * on this clipboard across all {@code AppContext}s.
*/
private volatile int numberOfFlavorListeners = 0;
@@ -262,11 +262,11 @@
/**
* Clears the clipboard state (contents, owner and contents context) and
* notifies the current owner that ownership is lost. Does nothing if the
- * argument is not null and is not equal to the current
+ * argument is not {@code null} and is not equal to the current
* contents context.
*
* @param disposedContext the AppContext that is disposed or
- * null if the ownership is lost because another
+ * {@code null} if the ownership is lost because another
* application acquired ownership.
*/
protected void lostOwnershipLater(final AppContext disposedContext) {
@@ -405,10 +405,10 @@
protected abstract void unregisterClipboardViewerChecked();
/**
- * Checks change of the DataFlavors and, if necessary,
- * posts notifications on FlavorEvents to the
+ * Checks change of the {@code DataFlavor}s and, if necessary,
+ * posts notifications on {@code FlavorEvent}s to the
* AppContexts' EDTs.
- * The parameter formats is null iff we have just
+ * The parameter {@code formats} is null iff we have just
* failed to get formats available on the clipboard.
*
* @param formats data formats that have just been retrieved from
--- old/src/java.desktop/share/classes/sun/awt/event/IgnorePaintEvent.java 2015-10-27 21:53:25.832190996 +0400
+++ new/src/java.desktop/share/classes/sun/awt/event/IgnorePaintEvent.java 2015-10-27 21:53:25.636191005 +0400
@@ -32,7 +32,7 @@
* PaintEvents that are effectively ignored. This class is used only for
* tagging. If a heavy weight peer is asked to handle an event of this
* class it'll ignore it. This class is used by Swing.
- * Look at javax.swing.SwingPaintEventDispatcher for more.
+ * Look at {@code javax.swing.SwingPaintEventDispatcher} for more.
*
*/
@SuppressWarnings("serial") // JDK-implementation class
--- old/src/java.desktop/share/classes/sun/awt/geom/Order2.java 2015-10-27 21:53:26.360190972 +0400
+++ new/src/java.desktop/share/classes/sun/awt/geom/Order2.java 2015-10-27 21:53:26.168190981 +0400
@@ -89,7 +89,7 @@
/*
* Return the count of the number of horizontal sections of the
* specified quadratic Bezier curve. Put the parameters for the
- * horizontal sections into the specified ret array.
+ * horizontal sections into the specified {@code ret} array.
* ret array.
+ * horizontal sections into the specified {@code ret} array.
* ExecutableInputMethodManager is the implementation of the
- * InputMethodManager class. It is runnable as a separate
+ * {@code ExecutableInputMethodManager} is the implementation of the
+ * {@code InputMethodManager} class. It is runnable as a separate
* thread in the AWT environment.
- * InputMethodManager.getInstance() creates an instance of
- * ExecutableInputMethodManager and executes it as a deamon
+ * {@code InputMethodManager.getInstance()} creates an instance of
+ * {@code ExecutableInputMethodManager} and executes it as a deamon
* thread.
*
* @see InputMethodManager
--- old/src/java.desktop/share/classes/sun/awt/im/InputMethodManager.java 2015-10-27 21:53:28.028190897 +0400
+++ new/src/java.desktop/share/classes/sun/awt/im/InputMethodManager.java 2015-10-27 21:53:27.828190906 +0400
@@ -59,10 +59,10 @@
import sun.misc.ManagedLocalsThread;
/**
- * InputMethodManager is an abstract class that manages the input
- * method environment of JVM. There is only one InputMethodManager
+ * {@code InputMethodManager} is an abstract class that manages the input
+ * method environment of JVM. There is only one {@code InputMethodManager}
* instance in JVM that is executed under a separate daemon thread.
- * InputMethodManager performs the following:
+ * {@code InputMethodManager} performs the following:
*
*
getTriggerMenuString(). If null is returned by this method, it
+ * {@code getTriggerMenuString()}. If null is returned by this method, it
* means that there is only input method or none in the environment. Frame and Dialog
* invoke this method.notifyChangeRequest() to notify
- * InputMethodManager that the user wants to switch input methods.InputMethodManager displays a pop-up menu to choose an input method.InputMethodManager notifies the current InputContext of
- * the selected InputMethod.
@@ -116,8 +116,8 @@
*
*
notifyChangeRequestByHotKey() to notify
- * InputMethodManager that the user wants to switch input methods.InputMethodPopupMenu provides the popup selection menu
+ * {@code InputMethodPopupMenu} provides the popup selection menu
*/
abstract class InputMethodPopupMenu implements ActionListener {
--- old/src/java.desktop/share/classes/sun/awt/image/BufferedImageDevice.java 2015-10-27 21:53:29.096190849 +0400
+++ new/src/java.desktop/share/classes/sun/awt/image/BufferedImageDevice.java 2015-10-27 21:53:28.904190858 +0400
@@ -37,8 +37,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
@@ -50,30 +50,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 ("BufferedImage");
}
/**
- * 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/share/classes/sun/awt/image/DataBufferNative.java 2015-10-27 21:53:29.628190825 +0400
+++ new/src/java.desktop/share/classes/sun/awt/image/DataBufferNative.java 2015-10-27 21:53:29.436190834 +0400
@@ -31,7 +31,7 @@
import java.awt.Rectangle;
/**
- * This class extends DataBuffer and allows access to
+ * This class extends {@code DataBuffer} and allows access to
* native data via the DataBuffer methods. Note that, unlike other
* DataBuffer classes, the data is not stored in this class but
* has been created and stored elsewhere and this class is used
--- old/src/java.desktop/share/classes/sun/awt/shell/DefaultShellFolder.java 2015-10-27 21:53:30.164190801 +0400
+++ new/src/java.desktop/share/classes/sun/awt/shell/DefaultShellFolder.java 2015-10-27 21:53:29.968190810 +0400
@@ -46,9 +46,9 @@
/**
* This method is implemented to make sure that no instances
- * of ShellFolder are ever serialized. An instance of
+ * of {@code ShellFolder} are ever serialized. An instance of
* this default implementation can always be represented with a
- * java.io.File object instead.
+ * {@code java.io.File} object instead.
*
* @return a java.io.File replacement object.
*/
--- old/src/java.desktop/share/classes/sun/awt/shell/ShellFolder.java 2015-10-27 21:53:30.692190778 +0400
+++ new/src/java.desktop/share/classes/sun/awt/shell/ShellFolder.java 2015-10-27 21:53:30.500190786 +0400
@@ -62,9 +62,9 @@
/**
* This method must be implemented to make sure that no instances
- * of ShellFolder are ever serialized. If isFileSystem() returns
- * true, then the object should be representable with an instance of
- * java.io.File instead. If not, then the object is most likely
+ * of {@code ShellFolder} are ever serialized. If {@code isFileSystem()} returns
+ * {@code true}, then the object should be representable with an instance of
+ * {@code java.io.File} instead. If not, then the object is most likely
* depending on some internal (native) state and cannot be serialized.
*
* @return a java.io.File replacement object, or null
@@ -74,11 +74,11 @@
/**
* Returns the path for this object's parent,
- * or null if this object does not name a parent
+ * or {@code null} if this object does not name a parent
* folder.
*
* @return the path as a String for this object's parent,
- * or null if this object does not name a parent
+ * or {@code null} if this object does not name a parent
* folder
*
* @see java.io.File#getParent()
@@ -97,11 +97,11 @@
/**
* Returns a File object representing this object's parent,
- * or null if this object does not name a parent
+ * or {@code null} if this object does not name a parent
* folder.
*
* @return a File object representing this object's parent,
- * or null if this object does not name a parent
+ * or {@code null} if this object does not name a parent
* folder
*
* @see java.io.File#getParentFile()
@@ -250,8 +250,8 @@
}
/**
- * @param key a String
- * @return An Object matching the string key.
+ * @param key a {@code String}
+ * @return An Object matching the string {@code key}.
* @see ShellFolderManager#get(String)
*/
public static Object get(String key) {
@@ -259,7 +259,7 @@
}
/**
- * Does dir represent a "computer" such as a node on the network, or
+ * Does {@code dir} represent a "computer" such as a node on the network, or
* "My Computer" on the desktop.
*/
public static boolean isComputerNode(File dir) {
--- old/src/java.desktop/share/classes/sun/awt/shell/ShellFolderColumnInfo.java 2015-10-27 21:53:31.232190753 +0400
+++ new/src/java.desktop/share/classes/sun/awt/shell/ShellFolderColumnInfo.java 2015-10-27 21:53:31.036190762 +0400
@@ -40,8 +40,8 @@
private SortOrder sortOrder;
private Comparator comparator;
/**
- * false (default) if the {@link #comparator} expects folders as arguments,
- * and true if folder's column values. The first option is used default for comparison
+ * {@code false} (default) if the {@link #comparator} expects folders as arguments,
+ * and {@code true} if folder's column values. The first option is used default for comparison
* on Windows and also for separating files from directories when sorting using
* ShellFolderManager's inner comparator.
*/
--- old/src/java.desktop/share/classes/sun/awt/shell/ShellFolderManager.java 2015-10-27 21:53:31.764190729 +0400
+++ new/src/java.desktop/share/classes/sun/awt/shell/ShellFolderManager.java 2015-10-27 21:53:31.568190738 +0400
@@ -44,21 +44,21 @@
}
/**
- * @param key a String
+ * @param key a {@code String}
* "fileChooserDefaultFolder":
- * Returns a File - the default shellfolder for a new filechooser
+ * Returns a {@code File} - the default shellfolder for a new filechooser
* "roots":
- * Returns a File[] - containing the root(s) of the displayable hierarchy
+ * Returns a {@code File[]} - containing the root(s) of the displayable hierarchy
* "fileChooserComboBoxFolders":
- * Returns a File[] - an array of shellfolders representing the list to
+ * Returns a {@code File[]} - an array of shellfolders representing the list to
* show by default in the file chooser's combobox
* "fileChooserShortcutPanelFolders":
- * Returns a File[] - an array of shellfolders representing well-known
+ * Returns a {@code File[]} - an array of shellfolders representing well-known
* folders, such as Desktop, Documents, History, Network, Home, etc.
* This is used in the shortcut panel of the filechooser on Windows 2000
* and Windows Me.
* "fileChooserIcon Image - icon can be ListView, DetailsView, UpFolder, NewFolder or
+ * Returns an {@code Image} - icon can be ListView, DetailsView, UpFolder, NewFolder or
* ViewMenu (Windows only).
*
* @return An Object matching the key string.
@@ -90,7 +90,7 @@
}
/**
- * Does dir represent a "computer" such as a node on the network, or
+ * Does {@code dir} represent a "computer" such as a node on the network, or
* "My Computer" on the desktop.
*/
public boolean isComputerNode(File dir) {
--- old/src/java.desktop/share/classes/sun/font/BidiUtils.java 2015-10-27 21:53:32.312190705 +0400
+++ new/src/java.desktop/share/classes/sun/font/BidiUtils.java 2015-10-27 21:53:32.104190714 +0400
@@ -48,8 +48,8 @@
*
* @param levels the array to receive the character levels
* @param start the starting offset into the array
- * @throws IndexOutOfBoundsException if start is less than 0 or
- * start + getLength() is greater than levels.length.
+ * @throws IndexOutOfBoundsException if {@code start} is less than 0 or
+ * {@code start + getLength()} is greater than {@code levels.length}.
*/
public static void getLevels(Bidi bidi, byte[] levels, int start) {
int limit = start + bidi.getLength();
@@ -87,7 +87,7 @@
* Given level data, compute a a visual to logical mapping.
* The leftmost (or topmost) character is at visual index zero. The
* logical index of the character is derived from the visual index
- * by the expression li = map[vi];.
+ * by the expression {@code li = map[vi];}.
* @param levels the levels array
* @return the mapping array from visual to logical
*/
@@ -148,7 +148,7 @@
/**
* Return the inverse position map. The source array must map one-to-one (each value
* is distinct and the values run from zero to the length of the array minus one).
- * For example, if values[i] = j, then inverse[j] = i.
+ * For example, if {@code values[i] = j}, then {@code inverse[j] = i}.
* @param values the source ordering array
* @return the inverse array
*/
--- old/src/java.desktop/share/classes/sun/font/FileFont.java 2015-10-27 21:53:32.848190681 +0400
+++ new/src/java.desktop/share/classes/sun/font/FileFont.java 2015-10-27 21:53:32.656190689 +0400
@@ -80,7 +80,7 @@
protected NativeFont[] nativeFonts;
protected char[] glyphToCharMap;
/*
- * @throws FontFormatException - if the font can't be opened
+ * @throws FontFormatException if the font can't be opened
*/
FileFont(String platname, Object nativeNames)
throws FontFormatException {
--- old/src/java.desktop/share/classes/sun/font/FontDesignMetrics.java 2015-10-27 21:53:33.388190656 +0400
+++ new/src/java.desktop/share/classes/sun/font/FontDesignMetrics.java 2015-10-27 21:53:33.196190665 +0400
@@ -520,14 +520,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.
*/
// More efficient than base class implementation - reuses existing cache
public int[] getWidths() {
--- old/src/java.desktop/share/classes/sun/font/PhysicalFont.java 2015-10-27 21:53:33.924190632 +0400
+++ new/src/java.desktop/share/classes/sun/font/PhysicalFont.java 2015-10-27 21:53:33.732190641 +0400
@@ -52,7 +52,7 @@
/**
* Opens the file (temporarily) and does basic verification.
* Initializes the CMAP
- * @throws FontFormatException - if the font can't be opened
+ * @throws FontFormatException if the font can't be opened
* or fails verification, or there's no usable cmap
*/
PhysicalFont(String platname, Object nativeNames)
--- old/src/java.desktop/share/classes/sun/font/ScriptRun.java 2015-10-27 21:53:34.456190609 +0400
+++ new/src/java.desktop/share/classes/sun/font/ScriptRun.java 2015-10-27 21:53:34.264190617 +0400
@@ -35,10 +35,10 @@
package sun.font;
/**
- * ScriptRun is used to find runs of characters in
- * the same script, as defined in the Script class.
+ * {@code ScriptRun} is used to find runs of characters in
+ * the same script, as defined in the {@code Script} class.
* It implements a simple iterator over an array of characters.
- * The iterator will assign COMMON and INHERITED
+ * The iterator will assign {@code COMMON} and {@code INHERITED}
* characters to the same script as the preceding characters. If the
* COMMON and INHERITED characters are first, they will be assigned to
* the same script as the following characters.
@@ -88,7 +88,7 @@
}
/**
- * Construct a ScriptRun object which iterates over a subrange
+ * Construct a {@code ScriptRun} object which iterates over a subrange
* of the given characetrs.
*
* @param chars the array of characters over which to iterate.
@@ -145,10 +145,10 @@
}
/**
- * Find the next script run. Returns false if there
- * isn't another run, returns true if there is.
+ * Find the next script run. Returns {@code false} if there
+ * isn't another run, returns {@code true} if there is.
*
- * @return false if there isn't another run, true if there is.
+ * @return {@code false} if there isn't another run, {@code true} if there is.
*/
public boolean next() {
int startSP = parenSP; // used to find the first new open character
@@ -273,7 +273,7 @@
*
* @param scriptOne one of the script codes.
* @param scriptTwo the other script code.
- * @return true if the two scripts are the same.
+ * @return {@code true} if the two scripts are the same.
* @see Script
*/
private static boolean sameScript(int scriptOne, int scriptTwo) {
--- old/src/java.desktop/share/classes/sun/font/StandardGlyphVector.java 2015-10-27 21:53:34.996190584 +0400
+++ new/src/java.desktop/share/classes/sun/font/StandardGlyphVector.java 2015-10-27 21:53:34.800190593 +0400
@@ -1252,20 +1252,20 @@
// internal use only for possible future extension
/**
- * A flag used with getLayoutFlags that indicates whether this GlyphVector uses
+ * A flag used with getLayoutFlags that indicates whether this {@code GlyphVector} uses
* a vertical baseline.
*/
public static final int FLAG_USES_VERTICAL_BASELINE = 128;
/**
- * A flag used with getLayoutFlags that indicates whether this GlyphVector uses
- * vertical glyph metrics. A GlyphVector can use vertical metrics on a
+ * A flag used with getLayoutFlags that indicates whether this {@code GlyphVector} uses
+ * vertical glyph metrics. A {@code GlyphVector} can use vertical metrics on a
* horizontal line, or vice versa.
*/
public static final int FLAG_USES_VERTICAL_METRICS = 256;
/**
- * A flag used with getLayoutFlags that indicates whether this GlyphVector uses
+ * A flag used with getLayoutFlags that indicates whether this {@code GlyphVector} uses
* the 'alternate orientation.' Glyphs have a default orientation given a
* particular baseline and metrics orientation, this is the orientation appropriate
* for left-to-right text. For example, the letter 'A' can have four orientations,
--- old/src/java.desktop/share/classes/sun/font/TrueTypeFont.java 2015-10-27 21:53:35.552190559 +0400
+++ new/src/java.desktop/share/classes/sun/font/TrueTypeFont.java 2015-10-27 21:53:35.360190568 +0400
@@ -181,7 +181,7 @@
* - reads the names (full, family).
* - determines the style of the font.
* - initializes the CMAP
- * @throws FontFormatException - if the font can't be opened
+ * @throws FontFormatException if the font can't be opened
* or fails verification, or there's no usable cmap
*/
public TrueTypeFont(String platname, Object nativeNames, int fIndex,
--- old/src/java.desktop/share/classes/sun/font/Type1Font.java 2015-10-27 21:53:36.104190535 +0400
+++ new/src/java.desktop/share/classes/sun/font/Type1Font.java 2015-10-27 21:53:35.912190543 +0400
@@ -161,7 +161,7 @@
* - does basic verification of the file
* - reads the names (full, family).
* - determines the style of the font.
- * @throws FontFormatException - if the font can't be opened
+ * @throws FontFormatException if the font can't be opened
* or fails verification, or there's no usable cmap
*/
public Type1Font(String platname, Object nativeNames, boolean createdCopy)
--- old/src/java.desktop/share/classes/sun/java2d/Spans.java 2015-10-27 21:53:36.644190510 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/Spans.java 2015-10-27 21:53:36.448190519 +0400
@@ -41,7 +41,7 @@
/**
* This class will sort and collapse its span
* entries after this many span additions via
- * the add method.
+ * the {@code add} method.
*/
private static final int kMaxAddsSinceSort = 256;
@@ -52,7 +52,7 @@
private List mSpans = new Vector<>(kMaxAddsSinceSort);
/**
- * The number of Span
+ * The number of {@code Span}
* instances that have been added
* to this object without a sort
* and collapse taking place.
@@ -65,8 +65,8 @@
/**
* Add a span covering the half open interval
- * including start up to
- * but not including end.
+ * including {@code start} up to
+ * but not including {@code end}.
*/
public void add(float start, float end) {
@@ -82,10 +82,10 @@
/**
* Add a span which covers the entire range.
* This call is logically equivalent to
- * add(Float.NEGATIVE_INFINITY, Float.POSITIVE_INFINITY)
+ * {@code add(Float.NEGATIVE_INFINITY, Float.POSITIVE_INFINITY)}
* The result of making this call is that
- * all future add calls are ignored
- * and the intersects method always
+ * all future {@code add} calls are ignored
+ * and the {@code intersects} method always
* returns true.
*/
public void addInfinite() {
@@ -94,8 +94,8 @@
/**
* Returns true if the span defined by the half-open
- * interval from start up to,
- * but not including, end intersects
+ * interval from {@code start} up to,
+ * but not including, {@code end} intersects
* any of the spans defined by this instance.
*/
public boolean intersects(float start, float end) {
@@ -231,8 +231,8 @@
/**
* Create a half-open interval including
- * start but not including
- * end.
+ * {@code start} but not including
+ * {@code end}.
*/
Span(float start, float end) {
mStart = start;
@@ -240,7 +240,7 @@
}
/**
- * Return the start of the Span.
+ * Return the start of the {@code Span}.
* The start is considered part of the
* half-open interval.
*/
@@ -249,7 +249,7 @@
}
/**
- * Return the end of the Span.
+ * Return the end of the {@code Span}.
* The end is not considered part of the
* half-open interval.
*/
@@ -259,7 +259,7 @@
/**
* Change the initial position of the
- * Span.
+ * {@code Span}.
*/
final void setStart(float start) {
mStart = start;
@@ -267,18 +267,18 @@
/**
* Change the terminal position of the
- * Span.
+ * {@code Span}.
*/
final void setEnd(float end) {
mEnd = end;
}
/**
- * Attempt to alter this Span
- * to include otherSpan without
+ * Attempt to alter this {@code Span}
+ * to include {@code otherSpan} without
* altering this span's starting position.
- * If otherSpan can be so consumed
- * by this Span then true
+ * If {@code otherSpan} can be so consumed
+ * by this {@code Span} then {@code true}
* is returned.
*/
boolean subsume(Span otherSpan) {
@@ -304,7 +304,7 @@
/**
* Return true if the passed in position
* lies in the half-open interval defined
- * by this Span.
+ * by this {@code Span}.
*/
boolean contains(float pos) {
return mStart <= pos && pos < mEnd;
@@ -337,11 +337,11 @@
}
/**
- * This class ranks a pair of Span
+ * This class ranks a pair of {@code Span}
* instances. If the instances intersect they
* are deemed equal otherwise they are ranked
* by their relative position. Use
- * SpanIntersection.instance to
+ * {@code SpanIntersection.instance} to
* get the single instance of this class.
*/
static class SpanIntersection implements Comparator {
--- old/src/java.desktop/share/classes/sun/java2d/StateTrackable.java 2015-10-27 21:53:37.180190486 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/StateTrackable.java 2015-10-27 21:53:36.988190495 +0400
@@ -129,9 +129,9 @@
* time period of the modifications would be small in most cases
* and the 2 changes of state would each require synchronization.
* curTracker
+ * In comparison the act of setting the {@code curTracker}
* reference to null in the usage pattern above effectively invalidates
- * all outstanding Tracker objects as soon as possible
+ * all outstanding {@code Tracker} objects as soon as possible
* after the change to the data and requires very little code and no
* synchronization to implement.
* destRect with clip and
- * overwrites destRect with the result.
+ * Intersects {@code destRect} with {@code clip} and
+ * overwrites {@code destRect} with the result.
* Returns false if the intersection was empty, true otherwise.
*/
private boolean clipTo(Rectangle destRect, Rectangle clip) {
--- old/src/java.desktop/share/classes/sun/java2d/SunGraphicsEnvironment.java 2015-10-27 21:53:38.300190436 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/SunGraphicsEnvironment.java 2015-10-27 21:53:38.108190445 +0400
@@ -155,7 +155,7 @@
/**
* Create and return the screen device with the specified number. The
- * device with number 0 will be the default device (returned
+ * device with number {@code 0} will be the default device (returned
* by {@link #getDefaultScreenDevice()}.
*
* @param screennum the number of the screen to create
--- old/src/java.desktop/share/classes/sun/java2d/SurfaceData.java 2015-10-27 21:53:38.836190412 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/SurfaceData.java 2015-10-27 21:53:38.640190421 +0400
@@ -922,8 +922,8 @@
}
/**
- * 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/sun/java2d/opengl/OGLUtilities.java 2015-10-27 21:53:39.392190387 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/opengl/OGLUtilities.java 2015-10-27 21:53:39.180190396 +0400
@@ -81,7 +81,7 @@
*
* In order to avoid deadlock, it is important that the given Runnable
* does not attempt to acquire the AWT lock, as that will be handled
- * automatically as part of the rq.flushAndInvokeNow() step.
+ * automatically as part of the {@code rq.flushAndInvokeNow()} step.
*
* @param g the Graphics object for the corresponding destination surface;
* if null, the step making a context current to the destination surface
@@ -134,7 +134,7 @@
*
* In order to avoid deadlock, it is important that the given Runnable
* does not attempt to acquire the AWT lock, as that will be handled
- * automatically as part of the rq.flushAndInvokeNow() step.
+ * automatically as part of the {@code rq.flushAndInvokeNow()} step.
*
* @param config the GraphicsConfiguration object whose "shared"
* context will be made current during this operation; if this value is
@@ -297,7 +297,7 @@
* @return a constant that describes the surface associated with the
* given Graphics object; if the given Graphics object is invalid (i.e.
* is not associated with an OpenGL surface) this method will return
- * OGLUtilities.UNDEFINED
+ * {@code OGLUtilities.UNDEFINED}
*/
public static int getOGLSurfaceType(Graphics g) {
if (!(g instanceof SunGraphics2D)) {
--- old/src/java.desktop/share/classes/sun/java2d/pipe/Region.java 2015-10-27 21:53:39.940190362 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/pipe/Region.java 2015-10-27 21:53:39.728190372 +0400
@@ -104,11 +104,11 @@
}
/**
- * Adds the dimension dim to the coordinate
- * start with appropriate clipping. If
- * dim is non-positive then the method returns
+ * Adds the dimension {@code dim} to the coordinate
+ * {@code start} with appropriate clipping. If
+ * {@code dim} is non-positive then the method returns
* the start coordinate. If the sum overflows an integer
- * data type then the method returns Integer.MAX_VALUE.
+ * data type then the method returns {@code Integer.MAX_VALUE}.
*/
public static int dimAdd(int start, int dim) {
if (dim <= 0) return start;
@@ -179,9 +179,9 @@
*
* @param s a non-null Shape object specifying the geometry enclosing
* the pixels of interest
- * @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
*/
public static Region getInstance(Shape s, AffineTransform at) {
return getInstance(WHOLE_REGION, false, s, at);
@@ -205,9 +205,9 @@
* clip the geometry to
* @param s a non-null Shape object specifying the geometry enclosing
* the pixels of interest
- * @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
*/
public static Region getInstance(Region devBounds,
Shape s, AffineTransform at)
@@ -238,9 +238,9 @@
* normalization
* @param s a non-null Shape object specifying the geometry enclosing
* the pixels of interest
- * @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
*/
public static Region getInstance(Region devBounds, boolean normalize,
Shape s, AffineTransform at)
@@ -363,7 +363,7 @@
* Sets the rectangle of interest for storing and returning
* region bands. The rectangle is specified in x, y, width, height
* format and appropriate clipping is performed as per the method
- * dimAdd.
+ * {@code dimAdd}.
* C = A.getIntersection(B); then a point will
+ * {@code C = A.getIntersection(B);} then a point will
* be contained in {@code C} iff it is contained in both
* {@code A} and {@code B}.
* C = A.getUnion(B); then a point will
+ * {@code C = A.getUnion(B);} then a point will
* be contained in {@code C} iff it is contained in either
* {@code A} or {@code B}.
* C = A.getDifference(B); then a point will
+ * {@code C = A.getDifference(B);} then a point will
* be contained in {@code C} iff it is contained in
* {@code A} but not contained in {@code B}.
* C = A.getExclusiveOr(B); then a point will
+ * {@code C = A.getExclusiveOr(B);} then a point will
* be contained in {@code C} iff it is contained in either
* {@code A} or {@code B}, but not if it is contained in both.
* unlock; otherwise this method returns false.
+ * {@code unlock}; otherwise this method returns false.
*/
public final boolean tryLock() {
return SunToolkit.awtTryLock();
--- old/src/java.desktop/share/classes/sun/java2d/pisces/Dasher.java 2015-10-27 21:53:41.016190314 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/pisces/Dasher.java 2015-10-27 21:53:40.824190323 +0400
@@ -28,9 +28,9 @@
import sun.awt.geom.PathConsumer2D;
/**
- * The Dasher class takes a series of linear commands
- * (moveTo, lineTo, close and
- * end) and breaks them into smaller segments according to a
+ * The {@code Dasher} class takes a series of linear commands
+ * ({@code moveTo}, {@code lineTo}, {@code close} and
+ * {@code end}) and breaks them into smaller segments according to a
* dash pattern array and a starting dash phase.
*
* Dasher.
+ * Constructs a {@code Dasher}.
*
- * @param out an output PathConsumer2D.
- * @param dash an array of floats containing the dash pattern
- * @param phase a float containing the dash phase
+ * @param out an output {@code PathConsumer2D}.
+ * @param dash an array of {@code float}s containing the dash pattern
+ * @param phase a {@code float} containing the dash phase
*/
public Dasher(PathConsumer2D out, float[] dash, float phase) {
if (phase < 0) {
--- old/src/java.desktop/share/classes/sun/java2d/pisces/Helpers.java 2015-10-27 21:53:41.556190290 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/pisces/Helpers.java 2015-10-27 21:53:41.360190298 +0400
@@ -239,18 +239,18 @@
// QuadCurve2D don't provide them.
/**
* Subdivides the cubic curve specified by the coordinates
- * stored in the src array at indices srcoff
- * through (srcoff + 7) and stores the
+ * stored in the {@code src} array at indices {@code srcoff}
+ * through ({@code srcoff} + 7) and stores the
* resulting two subdivided curves into the two result arrays at the
* corresponding indices.
- * Either or both of the left and right
- * arrays may be null or a reference to the same array
- * as the src array.
+ * Either or both of the {@code left} and {@code right}
+ * arrays may be {@code null} or a reference to the same array
+ * as the {@code src} array.
* Note that the last point in the first subdivided curve is the
* same as the first point in the second subdivided curve. Thus,
- * it is possible to pass the same array for left
- * and right and to use offsets, such as rightoff
- * equals (leftoff + 6), in order
+ * it is possible to pass the same array for {@code left}
+ * and {@code right} and to use offsets, such as {@code rightoff}
+ * equals ({@code leftoff} + 6), in order
* to avoid allocating extra storage for this common point.
* @param src the array holding the coordinates for the source curve
* @param srcoff the offset into the array of the beginning of the
--- old/src/java.desktop/share/classes/sun/java2d/pisces/Stroker.java 2015-10-27 21:53:42.092190266 +0400
+++ new/src/java.desktop/share/classes/sun/java2d/pisces/Stroker.java 2015-10-27 21:53:41.896190274 +0400
@@ -99,16 +99,16 @@
private final PolyStack reverse = new PolyStack();
/**
- * Constructs a Stroker.
+ * Constructs a {@code Stroker}.
*
- * @param pc2d an output PathConsumer2D.
+ * @param pc2d an output {@code PathConsumer2D}.
* @param lineWidth the desired line width in pixels
* @param capStyle the desired end cap style, one of
- * CAP_BUTT, CAP_ROUND or
- * CAP_SQUARE.
+ * {@code CAP_BUTT}, {@code CAP_ROUND} or
+ * {@code CAP_SQUARE}.
* @param joinStyle the desired line join style, one of
- * JOIN_MITER, JOIN_ROUND or
- * JOIN_BEVEL.
+ * {@code JOIN_MITER}, {@code JOIN_ROUND} or
+ * {@code JOIN_BEVEL}.
* @param miterLimit the desired miter limit
*/
public Stroker(PathConsumer2D pc2d,
--- old/src/java.desktop/share/classes/sun/print/DialogOwner.java 2015-10-27 21:53:42.636190241 +0400
+++ new/src/java.desktop/share/classes/sun/print/DialogOwner.java 2015-10-27 21:53:42.440190250 +0400
@@ -82,7 +82,7 @@
* instance.
* "dialog-owner".
+ * {@code "dialog-owner"}.
*
* @return Attribute category name.
*/
--- old/src/java.desktop/share/classes/sun/print/PSPathGraphics.java 2015-10-27 21:53:43.168190217 +0400
+++ new/src/java.desktop/share/classes/sun/print/PSPathGraphics.java 2015-10-27 21:53:42.972190226 +0400
@@ -72,8 +72,8 @@
}
/**
- * 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.
* @since 1.0
@@ -115,19 +115,19 @@
}
/**
- * Renders the text specified by the specified String,
- * using the current Font and Paint attributes
- * in the Graphics2D context.
+ * Renders the text specified by the specified {@code String},
+ * using the current {@code Font} and {@code Paint} attributes
+ * 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 x, y the coordinates where the String
+ * @param str the {@code String} to be rendered
+ * @param x, y the coordinates where the {@code String}
* should be rendered
* @see #setPaint
* @see java.awt.Graphics#setColor
@@ -248,16 +248,16 @@
}
/**
- * The various drawImage() methods for
- * WPathGraphics are all decomposed
- * into an invocation of drawImageToPlatform.
+ * The various {@code drawImage()} methods for
+ * {@code WPathGraphics} are all decomposed
+ * into an invocation of {@code drawImageToPlatform}.
* The portion of the passed in image defined by
- * srcX, srcY, srcWidth, and srcHeight
+ * {@code srcX, srcY, srcWidth, and srcHeight}
* is transformed by the supplied AffineTransform and
* drawn using PS to the printer context.
*
* @param image The image to be drawn.
- * This method does nothing if img is null.
+ * This method does nothing if {@code img} is null.
* @param xform Used to transform the image before drawing.
* This can be null.
* @param bgcolor This color is drawn where the image has transparent
@@ -730,7 +730,7 @@
/*
- * Fill the path defined by pathIter
+ * Fill the path defined by {@code pathIter}
* with the specified color.
* The path is provided in current user space.
*/
--- old/src/java.desktop/share/classes/sun/print/PSPrinterJob.java 2015-10-27 21:53:43.712190193 +0400
+++ new/src/java.desktop/share/classes/sun/print/PSPrinterJob.java 2015-10-27 21:53:43.516190202 +0400
@@ -116,14 +116,14 @@
/* Class Constants */
/**
- * Passed to the setFillMode
+ * Passed to the {@code setFillMode}
* method this value forces fills to be
* done using the even-odd fill rule.
*/
protected static final int FILL_EVEN_ODD = 1;
/**
- * Passed to the setFillMode
+ * Passed to the {@code setFillMode}
* method this value forces fills to be
* done using the non-zero winding rule.
*/
@@ -294,14 +294,14 @@
/**
* This string holds the PostScript operator to
* be used to fill a path. It can be changed
- * by the setFillMode method.
+ * by the {@code setFillMode} method.
*/
private String mFillOpStr = WINDING_FILL_STR;
/**
* This string holds the PostScript operator to
* be used to clip to a path. It can be changed
- * by the setFillMode method.
+ * by the {@code setFillMode} method.
*/
private String mClipOpStr = WINDING_CLIP_STR;
@@ -876,14 +876,14 @@
/**
* Convert the 24 bit BGR image buffer represented by
- * image to PostScript. The image is drawn at
- * (destX, destY) in device coordinates.
+ * {@code image} to PostScript. The image is drawn at
+ * {@code (destX, destY)} in device coordinates.
* The image is scaled into a square of size
- * specified by destWidth and
- * destHeight. The portion of the
+ * specified by {@code destWidth} and
+ * {@code destHeight}. The portion of the
* source image copied into that square is specified
- * by srcX, srcY,
- * srcWidth, and srcHeight.
+ * by {@code srcX}, {@code srcY},
+ * {@code srcWidth}, and srcHeight.
*/
protected void drawImageBGR(byte[] bgrData,
float destX, float destY,
@@ -1026,14 +1026,14 @@
/**
* Examine the metrics captured by the
- * PeekGraphics instance and
+ * {@code PeekGraphics} instance and
* if capable of directly converting this
* print job to the printer's control language
* or the native OS's graphics primitives, then
- * return a PSPathGraphics to perform
+ * return a {@code PSPathGraphics} to perform
* that conversion. If there is not an object
* capable of the conversion then return
- * null. Returning null
+ * {@code null}. Returning {@code null}
* causes the print job to be rasterized.
*/
@@ -1349,8 +1349,8 @@
}
/**
* Set the current path rule to be either
- * FILL_EVEN_ODD (using the
- * even-odd file rule) or FILL_WINDING
+ * {@code FILL_EVEN_ODD} (using the
+ * even-odd file rule) or {@code FILL_WINDING}
* (using the non-zero winding rule.)
*/
protected void setFillMode(int fillRule) {
@@ -1375,7 +1375,7 @@
/**
* Set the printer's current color to be that
- * defined by color
+ * defined by {@code color}
*/
protected void setColor(Color color) {
mLastColor = color;
@@ -1418,7 +1418,7 @@
/**
* Generate PostScript to move the current pen
- * position to (x, y).
+ * position to {@code (x, y)}.
*/
protected void moveTo(float x, float y) {
@@ -1437,7 +1437,7 @@
}
/**
* Generate PostScript to draw a line from the
- * current pen position to (x, y).
+ * current pen position to {@code (x, y)}.
*/
protected void lineTo(float x, float y) {
@@ -1861,7 +1861,7 @@
}
/**
- * Given a Java2D PathIterator instance,
+ * Given a Java2D {@code PathIterator} instance,
* this method translates that into a PostScript path..
*/
void convertToPSPath(PathIterator pathIter) {
@@ -1926,7 +1926,7 @@
}
/*
- * Fill the path defined by pathIter
+ * Fill the path defined by {@code pathIter}
* with the specified color.
* The path is provided in current user space.
*/
--- old/src/java.desktop/share/classes/sun/print/PathGraphics.java 2015-10-27 21:53:44.268190168 +0400
+++ new/src/java.desktop/share/classes/sun/print/PathGraphics.java 2015-10-27 21:53:44.076190177 +0400
@@ -177,9 +177,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.
@@ -211,12 +211,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.
@@ -251,7 +251,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.
@@ -271,9 +271,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.
@@ -296,9 +296,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.
@@ -320,8 +320,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
@@ -359,8 +359,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
@@ -368,7 +368,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -403,8 +403,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
@@ -412,7 +412,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -478,16 +478,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
@@ -500,7 +500,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
@@ -513,19 +513,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)
*/
@@ -1089,7 +1089,7 @@
}
/**
- * Fill the path defined by pathIter
+ * Fill the path defined by {@code pathIter}
* with the specified color.
* The path is provided in device coordinates.
*/
@@ -1097,7 +1097,7 @@
/*
* Set the clipping path to that defined by
- * the passed in PathIterator.
+ * the passed in {@code PathIterator}.
*/
protected abstract void deviceClip(PathIterator pathIter);
@@ -1326,16 +1326,16 @@
/**
- * The various drawImage() methods for
- * PathGraphics are all decomposed
- * into an invocation of drawImageToPlatform.
+ * The various {@code drawImage()} methods for
+ * {@code PathGraphics} are all decomposed
+ * into an invocation of {@code drawImageToPlatform}.
* The portion of the passed in image defined by
- * srcX, srcY, srcWidth, and srcHeight
+ * {@code srcX, srcY, srcWidth, and srcHeight}
* is transformed by the supplied AffineTransform and
* drawn using PS to the printer context.
*
* @param img The image to be drawn.
- * This method does nothing if img is null.
+ * This method does nothing if {@code img} is null.
* @param xform Used to transform the image before drawing.
* This can be null.
* @param bgcolor This color is drawn where the image has transparent
@@ -1373,7 +1373,7 @@
* and converted for the current output device.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
@@ -1405,9 +1405,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 draws the image notifies
- * the image observer by calling its imageUpdate method.
+ * the image observer by calling its {@code imageUpdate} method.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
- * This method does nothing if img is null.
+ * This method does 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
@@ -1507,7 +1507,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 draws the image notifies
* the specified image observer.
* img is null.
+ * This method does nothing if {@code img} is null.
* @param x the x coordinate.
* @param y the y coordinate.
* @param width the width of the rectangle.
@@ -1566,7 +1566,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 draws the image notifies
* the specified image observer.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* img is null.
+ * This method does 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
@@ -1767,7 +1767,7 @@
* and composite attributes. Note that the result is
* undefined, if the given transform is noninvertible.
* @param img The image to be drawn.
- * 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 image observer to be notified as more of the image
* is converted.
@@ -1809,7 +1809,7 @@
*
* @param op The filter to be applied to the image before drawing.
* @param img The BufferedImage to be drawn.
- * This method does nothing if img is null.
+ * This method does nothing if {@code img} is null.
* @param x,y The location in user space where the image should be drawn.
* @see #transform
* @see #setTransform
@@ -1853,7 +1853,7 @@
* and composite attributes. Note that the result is
* undefined, if the given transform is noninvertible.
* @param img The image to be drawn.
- * 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.
* @see #transform
* @see #setTransform
--- old/src/java.desktop/share/classes/sun/print/PeekGraphics.java 2015-10-27 21:53:44.832190143 +0400
+++ new/src/java.desktop/share/classes/sun/print/PeekGraphics.java 2015-10-27 21:53:44.640190151 +0400
@@ -162,8 +162,8 @@
/* The Delegated Graphics Methods */
/**
- * 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.
* @since 1.0
@@ -444,7 +444,7 @@
/**
* Gets the current clipping area.
- * @return a Shape object representing the
+ * @return a {@code Shape} object representing the
* current clipping area.
* @see java.awt.Graphics#getClipBounds
* @see java.awt.Graphics#clipRect
@@ -459,12 +459,12 @@
/**
* Sets the current clipping area to an arbitrary clip shape.
- * Not all objects which implement the Shape
+ * Not all objects which implement the {@code Shape}
* interface can be used to set the clip. The only
- * Shape objects which are guaranteed to be
- * supported are Shape objects which are
- * obtained via the getClip method and via
- * Rectangle objects.
+ * {@code Shape} objects which are guaranteed to be
+ * supported are {@code Shape} objects which are
+ * obtained via the {@code getClip} method and via
+ * {@code Rectangle} objects.
* @see java.awt.Graphics#getClip()
* @see java.awt.Graphics#clipRect
* @see java.awt.Graphics#setClip(int, int, int, int)
@@ -477,16 +477,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.
@@ -520,12 +520,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.
@@ -551,7 +551,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.
@@ -573,9 +573,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.
@@ -597,9 +597,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.
@@ -621,8 +621,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
@@ -665,8 +665,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
@@ -674,7 +674,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -701,8 +701,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
@@ -710,7 +710,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -767,16 +767,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
@@ -796,19 +796,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)
* @since 1.0
@@ -931,7 +931,7 @@
* and converted for the current output device.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
@@ -976,9 +976,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 draws the image notifies
- * the image observer by calling its imageUpdate method.
+ * the image observer by calling its {@code imageUpdate} method.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
@@ -1078,7 +1078,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 draws the image notifies
* the specified image observer.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* 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
@@ -1316,12 +1316,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
@@ -1735,7 +1735,7 @@
}
/**
- * Return true if the Rectangle rect
+ * Return true if the Rectangle {@code rect}
* intersects the area into which the application
* has drawn.
*/
--- old/src/java.desktop/share/classes/sun/print/PeekMetrics.java 2015-10-27 21:53:45.428190116 +0400
+++ new/src/java.desktop/share/classes/sun/print/PeekMetrics.java 2015-10-27 21:53:45.208190126 +0400
@@ -52,9 +52,9 @@
private boolean mHasImages;
/**
- * Return true if the application
+ * Return {@code true} if the application
* has done any drawing with a Paint that
- * is not an instance of Color
+ * is not an instance of {@code Color}
*/
public boolean hasNonSolidColors() {
return mHasNonSolidColors;
@@ -119,7 +119,7 @@
/**
* The application is drawing text
- * defined by TextLayout
+ * defined by {@code TextLayout}
* so record the needed information.
*/
public void drawText(Graphics2D g, TextLayout textLayout) {
@@ -164,7 +164,7 @@
/**
* Record information about drawing done
- * with the supplied Paint.
+ * with the supplied {@code Paint}.
*/
private void checkPaint(Paint paint) {
@@ -179,7 +179,7 @@
/**
* Record information about drawing done
- * with the supplied Composite.
+ * with the supplied {@code Composite}.
*/
private void checkAlpha(Composite composite) {
--- old/src/java.desktop/share/classes/sun/print/PrintJob2D.java 2015-10-27 21:53:45.976190091 +0400
+++ new/src/java.desktop/share/classes/sun/print/PrintJob2D.java 2015-10-27 21:53:45.764190101 +0400
@@ -928,23 +928,23 @@
/**
* Prints the page at the specified index into the specified
* {@link Graphics} context in the specified
- * format. A PrinterJob calls the
- * Printable interface to request that a page be
+ * format. A {@code PrinterJob} calls the
+ * {@code Printable} interface to request that a page be
* rendered into the context specified by
- * graphics. The format of the page to be drawn is
- * specified by pageFormat. The zero based index
- * of the requested page is specified by pageIndex.
+ * {@code graphics}. The format of the page to be drawn is
+ * specified by {@code pageFormat}. The zero based index
+ * of the requested page is specified by {@code pageIndex}.
* If the requested page does not exist then this method returns
* NO_SUCH_PAGE; otherwise PAGE_EXISTS is returned.
- * The Graphics class or subclass implements the
+ * The {@code Graphics} class or subclass implements the
* {@link java.awt.PrintGraphics} interface to provide additional
- * information. If the Printable object
+ * information. If the {@code Printable} object
* aborts the print job then it throws a {@link PrinterException}.
* @param graphics the context into which the page is drawn
* @param pageFormat the size and orientation of the page being drawn
* @param pageIndex the zero based index of the page to be drawn
* @return PAGE_EXISTS if the page is rendered successfully
- * or NO_SUCH_PAGE if pageIndex specifies a
+ * or NO_SUCH_PAGE if {@code pageIndex} specifies a
* non-existent page.
* @exception java.awt.print.PrinterException
* thrown when the print job is terminated.
--- old/src/java.desktop/share/classes/sun/print/ProxyGraphics.java 2015-10-27 21:53:46.568190065 +0400
+++ new/src/java.desktop/share/classes/sun/print/ProxyGraphics.java 2015-10-27 21:53:46.360190074 +0400
@@ -63,8 +63,8 @@
}
/**
- * 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.
*/
@@ -73,28 +73,28 @@
}
/**
- * 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:
*
*
* 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)
@@ -252,7 +252,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.
@@ -293,10 +293,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
@@ -310,15 +310,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)
@@ -330,16 +330,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.
@@ -368,12 +368,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.
@@ -391,9 +391,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.
@@ -415,7 +415,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.
@@ -434,9 +434,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.
@@ -455,9 +455,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.
@@ -520,8 +520,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
@@ -557,8 +557,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
@@ -566,7 +566,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -598,8 +598,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
@@ -607,7 +607,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -659,16 +659,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
@@ -680,7 +680,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
@@ -693,19 +693,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)
*/
@@ -805,7 +805,7 @@
* and converted for the current output device.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
@@ -835,9 +835,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 draws the image notifies
- * the image observer by calling its imageUpdate method.
+ * the image observer by calling its {@code imageUpdate} method.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
@@ -913,7 +913,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 draws the image notifies
* the specified image observer.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* 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
@@ -1080,12 +1080,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
@@ -1103,8 +1103,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() {
@@ -1113,7 +1113,7 @@
/**
* @deprecated As of JDK version 1.1,
- * replaced by getClipBounds().
+ * replaced by {@code getClipBounds()}.
*/
@Deprecated
public Rectangle getClipRect() {
@@ -1144,8 +1144,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/sun/print/ProxyGraphics2D.java 2015-10-27 21:53:47.128190039 +0400
+++ new/src/java.desktop/share/classes/sun/print/ProxyGraphics2D.java 2015-10-27 21:53:46.932190048 +0400
@@ -111,8 +111,8 @@
/* The Delegated Graphics Methods */
/**
- * 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.
* @since 1.0
@@ -380,7 +380,7 @@
/**
* Gets the current clipping area.
- * @return a Shape object representing the
+ * @return a {@code Shape} object representing the
* current clipping area.
* @see java.awt.Graphics#getClipBounds
* @see java.awt.Graphics#clipRect
@@ -395,12 +395,12 @@
/**
* Sets the current clipping area to an arbitrary clip shape.
- * Not all objects which implement the Shape
+ * Not all objects which implement the {@code Shape}
* interface can be used to set the clip. The only
- * Shape objects which are guaranteed to be
- * supported are Shape objects which are
- * obtained via the getClip method and via
- * Rectangle objects.
+ * {@code Shape} objects which are guaranteed to be
+ * supported are {@code Shape} objects which are
+ * obtained via the {@code getClip} method and via
+ * {@code Rectangle} objects.
* @see java.awt.Graphics#getClip()
* @see java.awt.Graphics#clipRect
* @see java.awt.Graphics#setClip(int, int, int, int)
@@ -413,16 +413,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.
@@ -454,12 +454,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.
@@ -482,7 +482,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.
@@ -502,9 +502,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.
@@ -524,9 +524,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.
@@ -546,8 +546,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
@@ -585,8 +585,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
@@ -594,7 +594,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -619,8 +619,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
@@ -628,7 +628,7 @@
* width and height arguments.
+ * {@code width} and {@code height} arguments.
* width + 1 pixels wide
@@ -672,16 +672,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
@@ -696,19 +696,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)
* @since 1.0
@@ -796,7 +796,7 @@
* and converted for the current output device.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
@@ -828,9 +828,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 draws the image notifies
- * the image observer by calling its imageUpdate method.
+ * the image observer by calling its {@code imageUpdate} method.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* @param img the specified image to be drawn.
@@ -923,7 +923,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 draws the image notifies
* the specified image observer.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* drawImage returns false. As more of
+ * {@code drawImage} returns {@code false}. As more of
* the image becomes available, the process that draws the image notifies
* the specified image observer.
* img will
+ * Return true if drawing {@code img} will
* invoke a Java2D bug (#4258675). The bug in question
* occurs when a draw image call with a background color
* parameter tries to render a sheared
@@ -1126,14 +1126,14 @@
}
/**
- * Return a new BufferedImage
+ * Return a new {@code BufferedImage}
* that contains a copy of the provided
- * Image where its
+ * {@code Image} where its
* transparent pixels have been replaced by
- * bgcolor. If the new
- * BufferedImage can not be created,
+ * {@code bgcolor}. If the new
+ * {@code BufferedImage} can not be created,
* probably because the original image has not
- * finished loading, then null is
+ * finished loading, then {@code null} is
* returned.
*/
private BufferedImage getBufferedImageCopy(Image img, Color bgcolor) {
@@ -1232,10 +1232,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
@@ -1244,12 +1244,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
--- old/src/java.desktop/share/classes/sun/print/ProxyPrintGraphics.java 2015-10-27 21:53:47.684190014 +0400
+++ new/src/java.desktop/share/classes/sun/print/ProxyPrintGraphics.java 2015-10-27 21:53:47.492190023 +0400
@@ -54,8 +54,8 @@
}
/**
- * 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.
*/
@@ -65,8 +65,8 @@
/**
- * Creates a new Graphics object based on this
- * Graphics object, but with a new translation and
+ * Creates a new {@code Graphics} object based on this
+ * {@code Graphics} object, but with a new translation and
* clip area.
* Refer to
* {@link sun.print.ProxyGraphics#create(int, int, int, int)}
--- old/src/java.desktop/share/classes/sun/print/RasterPrinterJob.java 2015-10-27 21:53:48.224189990 +0400
+++ new/src/java.desktop/share/classes/sun/print/RasterPrinterJob.java 2015-10-27 21:53:48.024189999 +0400
@@ -431,7 +431,7 @@
/*
* A convenience method which returns the default service
- * for 2D PrinterJobs.
+ * for 2D {@code PrinterJob}s.
* May return null if there is no suitable default (although there
* may still be 2D services available).
* @return default 2D print service, or null.
@@ -495,9 +495,9 @@
/**
* Associate this PrinterJob with a new PrintService.
*
- * Throws PrinterException if the specified service
- * cannot support the Pageable and
- * Printable interfaces necessary to support 2D printing.
+ * Throws {@code PrinterException} if the specified service
+ * cannot support the {@code Pageable} and
+ * {@code Printable} interfaces necessary to support 2D printing.
* @param service print service which supports 2D printing.
*
* @throws PrinterException if the specified service does not support
@@ -694,17 +694,17 @@
/**
* Display a dialog to the user allowing the modification of a
* PageFormat instance.
- * The page argument is used to initialize controls
+ * The {@code page} argument is used to initialize controls
* in the page setup dialog.
* If the user cancels the dialog, then the method returns the
- * original page object unmodified.
+ * original {@code page} object unmodified.
* If the user okays the dialog then the method returns a new
* PageFormat object with the indicated changes.
- * In either case the original page object will
+ * In either case the original {@code page} object will
* not be modified.
* @param page the default PageFormat presented to the user
* for modification
- * @return the original page object if the dialog
+ * @return the original {@code page} object if the dialog
* is cancelled, or a new PageFormat object containing
* the format indicated by the user if the dialog is
* acknowledged
@@ -2331,14 +2331,14 @@
/**
* Examine the metrics captured by the
- * PeekGraphics instance and
+ * {@code PeekGraphics} instance and
* if capable of directly converting this
* print job to the printer's control language
* or the native OS's graphics primitives, then
- * return a PathGraphics to perform
+ * return a {@code PathGraphics} to perform
* that conversion. If there is not an object
* capable of the conversion then return
- * null. Returning null
+ * {@code null}. Returning {@code null}
* causes the print job to be rasterized.
*/
protected Graphics2D createPathGraphics(PeekGraphics graphics,
@@ -2353,11 +2353,11 @@
/**
* Create and return an object that will
* gather and hold metrics about the print
- * job. This method is passed a Graphics2D
+ * job. This method is passed a {@code Graphics2D}
* object that can be used as a proxy for the
* object gathering the print job matrics. The
* method is also supplied with the instance
- * controlling the print job, printerJob.
+ * controlling the print job, {@code printerJob}.
*/
protected PeekGraphics createPeekGraphics(Graphics2D graphics,
PrinterJob printerJob) {
--- old/src/java.desktop/share/native/libsplashscreen/libpng/pngrtran.c 2015-10-27 21:53:48.908189960 +0400
+++ new/src/java.desktop/share/native/libsplashscreen/libpng/pngrtran.c 2015-10-27 21:53:48.712189968 +0400
@@ -422,7 +422,7 @@
/* Dither file to 8-bit. Supply a palette, the current number
* of elements in the palette, the maximum number of elements
* allowed, and a histogram if possible. If the current number
- * of colors is greater then the maximum number, the palette will be
+ * of colors is greater than the maximum number, the palette will be
* modified to fit in the maximum number. "full_quantize" indicates
* whether we need a quantizing cube set up for RGB images, or if we
* simply are reducing the number of colors in a paletted image.
--- old/src/java.desktop/unix/classes/sun/awt/UNIXToolkit.java 2015-10-27 21:53:49.616189928 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/UNIXToolkit.java 2015-10-27 21:53:49.400189937 +0400
@@ -118,8 +118,8 @@
* Load a native Gtk stock icon.
*
* @param longname a desktop property name. This contains icon name, size
- * and orientation, e.g. "gtk.icon.gtk-add.4.rtl"
- * @return an Image for the icon, or null if the
+ * and orientation, e.g. {@code "gtk.icon.gtk-add.4.rtl"}
+ * @return an {@code Image} for the icon, or {@code null} if the
* icon could not be loaded
*/
protected Object lazilyLoadGTKIcon(String longname) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/MotifDnDDragSourceProtocol.java 2015-10-27 21:53:50.144189904 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/MotifDnDDragSourceProtocol.java 2015-10-27 21:53:49.952189913 +0400
@@ -55,7 +55,7 @@
/**
* Creates an instance associated with the specified listener.
*
- * @throws NullPointerException if listener is null.
+ * @throws NullPointerException if listener is {@code null}.
*/
static XDragSourceProtocol createInstance(XDragSourceProtocolListener listener) {
return new MotifDnDDragSourceProtocol(listener);
--- old/src/java.desktop/unix/classes/sun/awt/X11/MotifDnDDropTargetProtocol.java 2015-10-27 21:53:50.680189880 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/MotifDnDDropTargetProtocol.java 2015-10-27 21:53:50.484189889 +0400
@@ -62,7 +62,7 @@
/**
* Creates an instance associated with the specified listener.
*
- * @throws NullPointerException if listener is null.
+ * @throws NullPointerException if listener is {@code null}.
*/
static XDropTargetProtocol createInstance(XDropTargetProtocolListener listener) {
return new MotifDnDDropTargetProtocol(listener);
--- old/src/java.desktop/unix/classes/sun/awt/X11/Native.java 2015-10-27 21:53:51.220189856 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/Native.java 2015-10-27 21:53:51.024189864 +0400
@@ -63,7 +63,7 @@
/**
* Set of helper function to read data of different PLATFORM types
- * from memory pointer by ptr
+ * from memory pointer by {@code ptr}
* Note, names of types in function are NATIVE PLATFORM types
* and they have the same size as they would have in C compiler
* on the same platform.
@@ -93,7 +93,7 @@
putByte(ptr+index, data);
}
/**
- * Converts length bytes of data pointed by data into byte array
+ * Converts length bytes of data pointed by {@code data} into byte array
* Returns null if data is zero
* @param data native pointer to native memory
* @param length size in bytes of native memory
@@ -143,7 +143,7 @@
}
/**
- * Converts length usnigned bytes of data pointed by data into
+ * Converts length usnigned bytes of data pointed by {@code data} into
* short array
* Returns null if data is zero
* @param data native pointer to native memory
@@ -297,8 +297,8 @@
}
/**
* Stores to C long data(four bytes)
- * Note: data has long type
- * to be able to keep 64-bit C long data
+ * Note: {@code data} has {@code long} type
+ * to be able to keep 64-bit C {@code long} data
*/
static void putLong(long ptr, long data) {
if (XlibWrapper.dataModel == 32) {
@@ -320,7 +320,7 @@
}
/**
* Stores Java long[] array into memory. Memory location is treated as array
- * of native longs
+ * of native {@code long}s
*/
static void put(long ptr, long[] arr) {
for (int i = 0; i < arr.length; i ++, ptr += getLongSize()) {
@@ -330,7 +330,7 @@
/**
* Stores Java Vector of Longs into memory. Memory location is treated as array
- * of native longs
+ * of native {@code long}s
*/
static void putLong(long ptr, Vectorlongs. Array is stored in reverse order
+ * of native {@code long}s. Array is stored in reverse order
*/
static void putLongReverse(long ptr, Vectordata into byte array
+ * Converts length bytes of data pointed by {@code data} into byte array
* Returns null if data is zero
* @param data native pointer to native memory
* @param length size in longs(platform dependent) of native memory
@@ -393,7 +393,7 @@
}
/**
- * Allocates memory for array of native longs of the size length
+ * Allocates memory for array of native {@code long}s of the size {@code length}
*/
static long allocateLongArray(int length) {
return unsafe.allocateMemory(getLongSize() * length);
--- old/src/java.desktop/unix/classes/sun/awt/X11/XAtom.java 2015-10-27 21:53:51.756189832 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XAtom.java 2015-10-27 21:53:51.564189840 +0400
@@ -29,28 +29,31 @@
* XAtom is a class that allows you to create and modify X Window properties.
* An X Atom is an identifier for a property that you can set on any X Window.
* Standard X Atom are defined by X11 and these atoms are defined in this class
- * for convenience. Common X Atoms like XA_WM_NAME are used to communicate with the
+ * for convenience. Common X Atoms like {@code XA_WM_NAME} are used to communicate with the
* Window manager to let it know the Window name. The use and protocol for these
* atoms are defined in the Inter client communications converntions manual.
* User specified XAtoms are defined by specifying a name that gets Interned
- * by the XServer and an XAtom object is returned. An XAtom can also be created
- * by using a pre-exisiting atom like XA_WM_CLASS. A display has to be specified
- * in order to create an XAtom. XAtom instance is created, you can call get and set property methods to
+ * Once an {@code XAtom} instance is created, you can call get and set property methods to
* set the values for a particular window.
- * XAtom xa = new XAtom(display,XAtom.XA_WM_NAME);
- *
- * XAtom xa = new XAtom(display,XAtom.XA_CUT_BUFFER0);
+ * {@code
+ * XAtom xa = new XAtom(display,XAtom.XA_WM_NAME);
+ * xa.setProperty(window,"Hello World");
+ * }
+ * {@code
+ * XAtom xa = new XAtom(display,XAtom.XA_CUT_BUFFER0);
+ * String selection = xa.getProperty(root_window);
+ * }
+ *
* @author Bino George
* @since 1.5
*/
@@ -237,7 +240,7 @@
}
/** This constructor will create an instance of XAtom that is specified
- * by the predefined XAtom specified by u latom
+ * by the predefined XAtom specified by u {@code latom}
*
* @param display X display to use.
* @param atom a predefined XAtom.
@@ -250,7 +253,7 @@
}
/** This constructor will create the instance,
- * and if autoIntern is true intern a new XAtom that is specified
+ * and if {@code autoIntern} is true intern a new XAtom that is specified
* by the supplied name.
*
* @param display X display to use
@@ -450,7 +453,7 @@
/**
* Gets uninterpreted set of data from property and stores them in data_ptr.
- * Property type is type, property is current atom.
+ * Property type is {@code type}, property is current atom.
* Property format is 32. Property 'delete' is false.
* Returns boolean if requested type, format, length match returned values
* and returned data pointer is not null.
@@ -505,7 +508,7 @@
/**
* Sets uninterpreted set of data into property from data_ptr.
- * Property type is type, property is current atom.
+ * Property type is {@code type}, property is current atom.
* Property format is 32. Mode is PropModeReplace. length is a number
* of items pointer by data_ptr.
*/
@@ -526,7 +529,7 @@
/**
* Sets uninterpreted set of data into property from data_ptr.
- * Property type is type, property is current atom.
+ * Property type is {@code type}, property is current atom.
* Property format is 8. Mode is PropModeReplace. length is a number
* of bytes pointer by data_ptr.
*/
@@ -784,7 +787,7 @@
}
/**
- * Sets property on the window to the value window_value
+ * Sets property on the {@code window} to the value {@code window_value}
* Property is assumed to be of type WINDOW/32
*/
public void setWindowProperty(long window, long window_value) {
@@ -807,7 +810,7 @@
}
/**
- * Gets property on the Printable interfaces necessary to support 2D printing.
* @param service print service which supports 2D printing.
*
@@ -763,14 +763,14 @@
/**
* Examine the metrics captured by the
- * window. Property is assumed to be
+ * Gets property on the {@code window}. Property is assumed to be
* of type WINDOW/32.
*/
public long getWindowProperty(long window) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/XAtomList.java 2015-10-27 21:53:52.296189807 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XAtomList.java 2015-10-27 21:53:52.104189816 +0400
@@ -41,7 +41,7 @@
/**
* Creates instance of XAtomList and initializes it with
- * the contents pointer by data.
+ * the contents pointer by {@code data}.
* Uses default display to initialize atoms.
*/
public XAtomList(long data, int count) {
@@ -90,7 +90,7 @@
}
/**
- * Returns true if this list contains the atom atom
+ * Returns true if this list contains the atom {@code atom}
*/
public boolean contains(XAtom atom) {
return atoms.contains(atom);
@@ -119,8 +119,8 @@
}
/**
- * Returns a subset of a list which is intersection of this set and set build by mapping mask in
- * mapping.
+ * Returns a subset of a list which is intersection of this set and set build by mapping {@code mask} in
+ * {@code mapping}.
*/
public XAtomList subset(int mask, Mapparams
+ * Creates window using parameters {@code params}
* If params contain flag DELAYED doesn't do anything.
* Note: Descendants can call this method to create the window
* at the time different to instance construction.
@@ -300,7 +300,7 @@
}
/**
- * Creates window with parameters specified by params
+ * Creates window with parameters specified by {@code params}
* @see #init
*/
private final void create(XCreateWindowParams params) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/XComponentPeer.java 2015-10-27 21:53:53.396189758 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XComponentPeer.java 2015-10-27 21:53:53.180189768 +0400
@@ -678,7 +678,7 @@
* Gets the font metrics for the specified font.
* @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)
@@ -722,8 +722,8 @@
/*
* The method changes the cursor.
- * @param cursor - a new cursor to change to.
- * @param ignoreSubComponents - if {@code true} is passed then
+ * @param cursor a new cursor to change to.
+ * @param ignoreSubComponents if {@code true} is passed then
* the new cursor will be installed on window.
* if {@code false} is passed then
* subsequent components will try to handle
--- old/src/java.desktop/unix/classes/sun/awt/X11/XDesktopPeer.java 2015-10-27 21:53:53.936189734 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XDesktopPeer.java 2015-10-27 21:53:53.740189743 +0400
@@ -39,7 +39,7 @@
/**
- * Concrete implementation of the interface DesktopPeer for
+ * Concrete implementation of the interface {@code DesktopPeer} for
* the Gnome desktop on Linux and Unix platforms.
*
* @see DesktopPeer
--- old/src/java.desktop/unix/classes/sun/awt/X11/XDnDDragSourceProtocol.java 2015-10-27 21:53:54.472189710 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XDnDDragSourceProtocol.java 2015-10-27 21:53:54.276189718 +0400
@@ -55,7 +55,7 @@
/**
* Creates an instance associated with the specified listener.
*
- * @throws NullPointerException if listener is null.
+ * @throws NullPointerException if listener is {@code null}.
*/
static XDragSourceProtocol createInstance(XDragSourceProtocolListener listener) {
return new XDnDDragSourceProtocol(listener);
--- old/src/java.desktop/unix/classes/sun/awt/X11/XDnDDropTargetProtocol.java 2015-10-27 21:53:55.004189686 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XDnDDropTargetProtocol.java 2015-10-27 21:53:54.808189695 +0400
@@ -70,7 +70,7 @@
/**
* Creates an instance associated with the specified listener.
*
- * @throws NullPointerException if listener is null.
+ * @throws NullPointerException if listener is {@code null}.
*/
static XDropTargetProtocol createInstance(XDropTargetProtocolListener listener) {
return new XDnDDropTargetProtocol(listener);
--- old/src/java.desktop/unix/classes/sun/awt/X11/XDragSourceProtocol.java 2015-10-27 21:53:55.544189661 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XDragSourceProtocol.java 2015-10-27 21:53:55.348189670 +0400
@@ -74,7 +74,7 @@
* Initializes a drag operation with the specified supported drop actions,
* contents and data formats.
*
- * @param actions a bitwise mask of DnDConstants that represent
+ * @param actions a bitwise mask of {@code DnDConstants} that represent
* the supported drop actions.
* @param contents the contents for the drag operation.
* @param formats an array of Atoms that represent the supported data formats.
--- old/src/java.desktop/unix/classes/sun/awt/X11/XEmbedServerTester.java 2015-10-27 21:53:56.076189638 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XEmbedServerTester.java 2015-10-27 21:53:55.884189646 +0400
@@ -570,7 +570,7 @@
}
}
/**
- * Checks if the event is already in a list at position >= position
+ * Checks if the {@code event} is already in a list at position >= {@code position}
*/
private int checkEventList(int position, int event) {
if (position == -1) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/XRepaintArea.java 2015-10-27 21:53:56.616189613 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XRepaintArea.java 2015-10-27 21:53:56.420189622 +0400
@@ -33,7 +33,7 @@
import sun.awt.RepaintArea;
/**
- * The RepaintArea is a geometric construct created for the
+ * The {@code RepaintArea} is a geometric construct created for the
* purpose of holding the geometry of several coalesced paint events.
* This geometry is accessed synchronously, although it is written such
* that painting may still be executed asynchronously.
@@ -43,7 +43,7 @@
final class XRepaintArea extends RepaintArea {
/**
- * Calls Component.update(Graphics) with given Graphics.
+ * Calls {@code Component.update(Graphics)} with given Graphics.
*/
protected void updateComponent(Component comp, Graphics g) {
if (comp != null) {
@@ -54,7 +54,7 @@
}
/**
- * Calls Component.paint(Graphics) with given Graphics.
+ * Calls {@code Component.paint(Graphics)} with given Graphics.
*/
protected void paintComponent(Component comp, Graphics g) {
if (comp != null) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/XSelection.java 2015-10-27 21:53:57.148189589 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XSelection.java 2015-10-27 21:53:56.952189598 +0400
@@ -110,7 +110,7 @@
/*
* Returns the XSelection object for the specified selection atom or
- * null if none exists.
+ * {@code null} if none exists.
*/
static XSelection getSelection(XAtom atom) {
return table.get(atom);
--- old/src/java.desktop/unix/classes/sun/awt/X11/XStateProtocol.java 2015-10-27 21:53:57.684189565 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XStateProtocol.java 2015-10-27 21:53:57.492189574 +0400
@@ -30,7 +30,7 @@
/**
* Returns whether or not the protocol supports the transition to the state
- * represented by state. State contains encoded state
+ * represented by {@code state}. {@code State} contains encoded state
* as a bit mask of state defined in java.awt.Frame
*/
boolean supportsState(int state);
--- old/src/java.desktop/unix/classes/sun/awt/X11/XTextAreaPeer.java 2015-10-27 21:53:58.320189537 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XTextAreaPeer.java 2015-10-27 21:53:58.124189546 +0400
@@ -127,7 +127,7 @@
int end = target.getSelectionEnd();
// Fix for 5100200
// Restoring Motif behaviour
- // Since the end position of the selected text can be greater then the length of the text,
+ // Since the end position of the selected text can be greater than the length of the text,
// so we should set caret to max position of the text
setCaretPosition(Math.min(end, text.length()));
if (end > start) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/XTextFieldPeer.java 2015-10-27 21:53:59.072189503 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XTextFieldPeer.java 2015-10-27 21:53:58.880189512 +0400
@@ -83,7 +83,7 @@
int end = target.getSelectionEnd();
// Fix for 5100200
// Restoring Motif behaviour
- // Since the end position of the selected text can be greater then the length of the text,
+ // Since the end position of the selected text can be greater than the length of the text,
// so we should set caret to max position of the text
setCaretPosition(Math.min(end, text.length()));
if (end > start) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/XToolkit.java 2015-10-27 21:53:59.732189473 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XToolkit.java 2015-10-27 21:53:59.520189483 +0400
@@ -405,7 +405,7 @@
/**
* Returns whether there is last remembered cursor position. The
* position is remembered from X mouse events on our peers. The
- * position is stored in p.
+ * position is stored in {@code p}.
* @return true, if there is remembered last cursor position,
* false otherwise
*/
@@ -1665,11 +1665,11 @@
/**
* Callback from the native side indicating some, or all, of the
* desktop properties have changed and need to be reloaded.
- * data is the byte array directly from the x server and
+ * {@code data} is the byte array directly from the x server and
* may be in little endian format.
* loadXSettings. It is called from the System EDT
+ * {@code loadXSettings}. It is called from the System EDT
* if triggered by an XSETTINGS change.
*/
void parseXSettings(int screen_XXX_ignored,Maprun() method will be called
+ * Registers a Runnable which {@code run()} method will be called
* once on the toolkit thread when a specified interval of time elapses.
*
- * @param task a Runnable which run method will be called
- * on the toolkit thread when interval milliseconds
+ * @param task a Runnable which {@code run} method will be called
+ * on the toolkit thread when {@code interval} milliseconds
* elapse
* @param interval an interal in milliseconds
*
- * @throws NullPointerException if task is null
- * @throws IllegalArgumentException if interval is not positive
+ * @throws NullPointerException if {@code task} is {@code null}
+ * @throws IllegalArgumentException if {@code interval} is not positive
*/
static void schedule(Runnable task, long interval) {
if (task == null) {
--- old/src/java.desktop/unix/classes/sun/awt/X11/XWindowPeer.java 2015-10-27 21:54:00.292189448 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/X11/XWindowPeer.java 2015-10-27 21:54:00.096189457 +0400
@@ -1620,7 +1620,7 @@
* @param transientForWindow the top-level window
* @param updateChain specifies if next/prevTransientFor fields are
* to be updated
- * @param allStates if set to true then TRANSIENT_FOR hint
+ * @param allStates if set to {@code true} then TRANSIENT_FOR hint
* is set regardless of the state of window and transientForWindow,
* otherwise it is set only if both are in the same state
*/
--- old/src/java.desktop/unix/classes/sun/awt/XSettings.java 2015-10-27 21:54:00.860189423 +0400
+++ new/src/java.desktop/unix/classes/sun/awt/XSettings.java 2015-10-27 21:54:00.664189432 +0400
@@ -44,13 +44,13 @@
/**
- * Update these settings with data obtained from
+ * Update these settings with {@code data} obtained from
* XSETTINGS manager.
*
* @param data settings data obtained from
- * _XSETTINGS_SETTINGS window property of the
+ * {@code _XSETTINGS_SETTINGS} window property of the
* settings manager.
- * @return a Map of changed settings.
+ * @return a {@code Map} of changed settings.
*/
public Map_XSETTINGS_SETTINGS property of the XSETTINGS
+ * {@code _XSETTINGS_SETTINGS} property of the XSETTINGS
* selection owner.
*
- * @param data _XSETTINGS_SETTINGS contents.
+ * @param data {@code _XSETTINGS_SETTINGS} contents.
*/
Update(byte[] data) {
this.data = data;
--- old/src/java.desktop/unix/classes/sun/font/NativeFont.java 2015-10-27 21:54:01.412189398 +0400
+++ new/src/java.desktop/unix/classes/sun/font/NativeFont.java 2015-10-27 21:54:01.200189407 +0400
@@ -64,7 +64,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 bitmapDelegate)
throws FontFormatException {
--- old/src/java.desktop/windows/classes/sun/awt/Win32GraphicsConfig.java 2015-10-27 21:54:02.012189371 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/Win32GraphicsConfig.java 2015-10-27 21:54:01.768189382 +0400
@@ -94,7 +94,7 @@
/**
* @deprecated as of JDK version 1.3
- * replaced by getConfig()
+ * replaced by {@code getConfig()}
*/
@Deprecated
public Win32GraphicsConfig(GraphicsDevice device, int visualnum) {
--- old/src/java.desktop/windows/classes/sun/awt/shell/Win32ShellFolder2.java 2015-10-27 21:54:02.564189346 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/shell/Win32ShellFolder2.java 2015-10-27 21:54:02.360189355 +0400
@@ -347,12 +347,12 @@
/**
* This method is implemented to make sure that no instances
- * of ShellFolder are ever serialized. If isFileSystem() returns
- * true, then the object is representable with an instance of
- * java.io.File instead. If not, then the object depends
+ * of {@code ShellFolder} are ever serialized. If {@code isFileSystem()} returns
+ * {@code true}, then the object is representable with an instance of
+ * {@code java.io.File} instead. If not, then the object depends
* on native PIDL state and should not be serialized.
*
- * @return a java.io.File replacement object. If the folder
+ * @return a {@code java.io.File} replacement object. If the folder
* is a not a normal directory, then returns the first non-removable
* drive (normally "C:\").
*/
@@ -715,7 +715,7 @@
/**
* @return An array of shell folders that are children of this shell folder
* object. The array will be empty if the folder is empty. Returns
- * null if this shellfolder does not denote a directory.
+ * {@code null} if this shellfolder does not denote a directory.
*/
public File[] listFiles(final boolean includeHiddenFiles) {
SecurityManager security = System.getSecurityManager();
@@ -1088,7 +1088,7 @@
}
/**
- * Gets an icon from the Windows system icon list as an Image
+ * Gets an icon from the Windows system icon list as an {@code Image}
*/
static Image getSystemIcon(SystemIcon iconType) {
long hIcon = getSystemIcon(iconType.getIconID());
@@ -1098,7 +1098,7 @@
}
/**
- * Gets an icon from the Windows system icon list as an Image
+ * Gets an icon from the Windows system icon list as an {@code Image}
*/
static Image getShell32Icon(int iconID, boolean getLargeIcon) {
boolean useVGAColors = true; // Will be ignored on XP and later
--- old/src/java.desktop/windows/classes/sun/awt/shell/Win32ShellFolderManager2.java 2015-10-27 21:54:03.136189321 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/shell/Win32ShellFolderManager2.java 2015-10-27 21:54:02.940189329 +0400
@@ -225,24 +225,24 @@
private static File[] roots;
/**
- * @param key a String
+ * @param key a {@code String}
* "fileChooserDefaultFolder":
- * Returns a File - the default shellfolder for a new filechooser
+ * Returns a {@code File} - the default shellfolder for a new filechooser
* "roots":
- * Returns a File[] - containing the root(s) of the displayable hierarchy
+ * Returns a {@code File[]} - containing the root(s) of the displayable hierarchy
* "fileChooserComboBoxFolders":
- * Returns a File[] - an array of shellfolders representing the list to
+ * Returns a {@code File[]} - an array of shellfolders representing the list to
* show by default in the file chooser's combobox
* "fileChooserShortcutPanelFolders":
- * Returns a File[] - an array of shellfolders representing well-known
+ * Returns a {@code File[]} - an array of shellfolders representing well-known
* folders, such as Desktop, Documents, History, Network, Home, etc.
* This is used in the shortcut panel of the filechooser on Windows 2000
* and Windows Me.
* "fileChooserIcon Image - icon can be ListView, DetailsView, UpFolder, NewFolder or
+ * Returns an {@code Image} - icon can be ListView, DetailsView, UpFolder, NewFolder or
* ViewMenu (Windows only).
* "optionPaneIcon iconName":
- * Returns an Image - icon from the system icon list
+ * Returns an {@code Image} - icon from the system icon list
*
* @return An Object matching the key string.
*/
@@ -415,7 +415,7 @@
}
/**
- * Does dir represent a "computer" such as a node on the network, or
+ * Does {@code dir} represent a "computer" such as a node on the network, or
* "My Computer" on the desktop.
*/
public boolean isComputerNode(final File dir) {
--- old/src/java.desktop/windows/classes/sun/awt/windows/WDesktopPeer.java 2015-10-27 21:54:03.700189295 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/windows/WDesktopPeer.java 2015-10-27 21:54:03.500189304 +0400
@@ -34,7 +34,7 @@
/**
- * Concrete implementation of the interface DesktopPeer for
+ * Concrete implementation of the interface {@code DesktopPeer} for
* the Windows platform.
*
* @see DesktopPeer
--- old/src/java.desktop/windows/classes/sun/awt/windows/WPathGraphics.java 2015-10-27 21:54:04.304189268 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/windows/WPathGraphics.java 2015-10-27 21:54:04.104189277 +0400
@@ -116,8 +116,8 @@
}
/**
- * 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.
* @since 1.0
@@ -375,19 +375,19 @@
}
/**
- * Renders the text specified by the specified String,
- * using the current Font and Paint attributes
- * in the Graphics2D context.
+ * Renders the text specified by the specified {@code String},
+ * using the current {@code Font} and {@code Paint} attributes
+ * 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 x, y the coordinates where the String
+ * @param str the {@code String} to be rendered
+ * @param x, y the coordinates where the {@code String}
* should be rendered
* @see #setPaint
* @see java.awt.Graphics#setColor
@@ -914,11 +914,11 @@
}
/**
- * The various drawImage() methods for
- * WPathGraphics are all decomposed
- * into an invocation of drawImageToPlatform.
+ * The various {@code drawImage()} methods for
+ * {@code WPathGraphics} are all decomposed
+ * into an invocation of {@code drawImageToPlatform}.
* The portion of the passed in image defined by
- * srcX, srcY, srcWidth, and srcHeight
+ * {@code srcX, srcY, srcWidth, and srcHeight}
* is transformed by the supplied AffineTransform and
* drawn using GDI to the printer context.
*
@@ -1379,7 +1379,7 @@
/**
* Have the printing application redraw everything that falls
- * within the page bounds defined by region.
+ * within the page bounds defined by {@code region}.
*/
@Override
public void redrawRegion(Rectangle2D region, double scaleX, double scaleY,
@@ -1479,7 +1479,7 @@
}
/*
- * Fill the path defined by pathIter
+ * Fill the path defined by {@code pathIter}
* with the specified color.
* The path is provided in device coordinates.
*/
@@ -1495,7 +1495,7 @@
/*
* Set the printer device's clip to be the
- * path defined by pathIter
+ * path defined by {@code pathIter}
* The path is provided in device coordinates.
*/
@Override
@@ -1719,7 +1719,7 @@
/**
- * Given a Java2D PathIterator instance,
+ * Given a Java2D {@code PathIterator} instance,
* this method translates that into a Window's path
* in the printer device context.
*/
--- old/src/java.desktop/windows/classes/sun/awt/windows/WPrinterJob.java 2015-10-27 21:54:04.868189243 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/windows/WPrinterJob.java 2015-10-27 21:54:04.672189252 +0400
@@ -336,13 +336,13 @@
/**
* The last color set into the print device context or
- * null if no color has been set.
+ * {@code null} if no color has been set.
*/
private Color mLastColor;
/**
* The last text color set into the print device context or
- * null if no color has been set.
+ * {@code null} if no color has been set.
*/
private Color mLastTextColor;
@@ -402,17 +402,17 @@
/**
* Display a dialog to the user allowing the modification of a
* PageFormat instance.
- * The page argument is used to initialize controls
+ * The {@code page} argument is used to initialize controls
* in the page setup dialog.
* If the user cancels the dialog, then the method returns the
- * original page object unmodified.
+ * original {@code page} object unmodified.
* If the user okays the dialog then the method returns a new
* PageFormat object with the indicated changes.
- * In either case the original page object will
+ * In either case the original {@code page} object will
* not be modified.
* @param page the default PageFormat presented to the user
* for modification
- * @return the original page object if the dialog
+ * @return the original {@code page} object if the dialog
* is cancelled, or a new PageFormat object containing
* the format indicated by the user if the dialog is
* acknowledged
@@ -588,8 +588,8 @@
/**
* Associate this PrinterJob with a new PrintService.
*
- * Throws PrinterException if the specified service
- * cannot support the Pageable and
+ * Throws {@code PrinterException} if the specified service
+ * cannot support the {@code Pageable} and
* PeekGraphics instance and
+ * {@code PeekGraphics} instance and
* if capable of directly converting this
* print job to the printer's control language
* or the native OS's graphics primitives, then
- * return a PathGraphics to perform
+ * return a {@code PathGraphics} to perform
* that conversion. If there is not an object
* capable of the conversion then return
- * null. Returning null
+ * {@code null}. Returning {@code null}
* causes the print job to be rasterized.
*/
@@ -976,9 +976,9 @@
/**
* Set the current polgon fill rule into the printer device context.
- * The fillRule should
+ * The {@code fillRule} should
* be one of the following Windows constants:
- * ALTERNATE or WINDING.
+ * {@code ALTERNATE} or {@code WINDING}.
*/
protected void setPolyFillMode(int fillRule) {
setPolyFillMode(getPrintDC(), fillRule);
@@ -986,7 +986,7 @@
/*
* Create a Window's solid brush for the color specified
- * by (red, green, blue). Once the brush
+ * by {@code (red, green, blue)}. Once the brush
* is created, select it in the current printing device
* context and free the old brush.
*/
@@ -1146,7 +1146,7 @@
}
/**
- * Draw the string text to the printer's
+ * Draw the string {@code text} to the printer's
* device context at the specified position.
*/
protected void textOut(String str, float x, float y,
@@ -1166,7 +1166,7 @@
}
/**
- * Draw the glyphs glyphs to the printer's
+ * Draw the glyphs {@code glyphs} to the printer's
* device context at the specified position.
*/
protected void glyphsOut(int []glyphs, float x, float y,
@@ -1208,15 +1208,15 @@
/**
* Draw the 24 bit BGR image buffer represented by
- * image to the GDI device context
- * printDC. The image is drawn at
- * (destX, destY) in device coordinates.
+ * {@code image} to the GDI device context
+ * {@code printDC}. The image is drawn at
+ * {@code (destX, destY)} in device coordinates.
* The image is scaled into a square of size
- * specified by destWidth and
- * destHeight. The portion of the
+ * specified by {@code destWidth} and
+ * {@code destHeight}. The portion of the
* source image copied into that square is specified
- * by srcX, srcY,
- * srcWidth, and srcHeight.
+ * by {@code srcX}, {@code srcY},
+ * {@code srcWidth}, and srcHeight.
*/
protected void drawImage3ByteBGR(byte[] image,
float destX, float destY,
@@ -1412,37 +1412,37 @@
/**
* Begin a Window's rendering path in the device
- * context printDC.
+ * context {@code printDC}.
*/
protected native void beginPath(long printDC);
/**
* End a Window's rendering path in the device
- * context printDC.
+ * context {@code printDC}.
*/
protected native void endPath(long printDC);
/**
* Close a subpath in a Window's rendering path in the device
- * context printDC.
+ * context {@code printDC}.
*/
protected native void closeFigure(long printDC);
/**
* Fill a defined Window's rendering path in the device
- * context printDC.
+ * context {@code printDC}.
*/
protected native void fillPath(long printDC);
/**
- * Move the Window's pen position to (x,y)
- * in the device context printDC.
+ * Move the Window's pen position to {@code (x,y)}
+ * in the device context {@code printDC}.
*/
protected native void moveTo(long printDC, float x, float y);
/**
* Draw a line from the current pen position to
- * (x,y) in the device context printDC.
+ * {@code (x,y)} in the device context {@code printDC}.
*/
protected native void lineTo(long printDC, float x, float y);
@@ -1453,17 +1453,17 @@
/**
* Set the current polgon fill rule into the device context
- * printDC. The fillRule should
+ * {@code printDC}. The {@code fillRule} should
* be one of the following Windows constants:
- * ALTERNATE or WINDING.
+ * {@code ALTERNATE} or {@code WINDING}.
*/
protected native void setPolyFillMode(long printDC, int fillRule);
/**
* Create a Window's solid brush for the color specified
- * by (red, green, blue). Once the brush
+ * by {@code (red, green, blue)}. Once the brush
* is created, select it in the device
- * context printDC and free the old brush.
+ * context {@code printDC} and free the old brush.
*/
protected native void selectSolidBrush(long printDC,
int red, int green, int blue);
@@ -1471,14 +1471,14 @@
/**
* Return the x coordinate of the current pen
* position in the device context
- * printDC.
+ * {@code printDC}.
*/
protected native int getPenX(long printDC);
/**
* Return the y coordinate of the current pen
* position in the device context
- * printDC.
+ * {@code printDC}.
*/
protected native int getPenY(long printDC);
@@ -1537,8 +1537,8 @@
/**
- * Draw the string text into the device
- * context printDC at the specified
+ * Draw the string {@code text} into the device
+ * context {@code printDC} at the specified
* position.
*/
protected native void textOut(long printDC, String text,
@@ -1550,15 +1550,15 @@
/**
* Draw the DIB compatible image buffer represented by
- * image to the GDI device context
- * printDC. The image is drawn at
- * (destX, destY) in device coordinates.
+ * {@code image} to the GDI device context
+ * {@code printDC}. The image is drawn at
+ * {@code (destX, destY)} in device coordinates.
* The image is scaled into a square of size
- * specified by destWidth and
- * destHeight. The portion of the
+ * specified by {@code destWidth} and
+ * {@code destHeight}. The portion of the
* source image copied into that square is specified
- * by srcX, srcY,
- * srcWidth, and srcHeight.
+ * by {@code srcX}, {@code srcY},
+ * {@code srcWidth}, and srcHeight.
* Note that the image isn't completely compatible with DIB format.
* At the very least it needs to be padded so each scanline is
* DWORD aligned. Also we "flip" the image to make it a bottom-up DIB.
--- old/src/java.desktop/windows/classes/sun/awt/windows/WToolkit.java 2015-10-27 21:54:05.444189217 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/windows/WToolkit.java 2015-10-27 21:54:05.252189226 +0400
@@ -587,7 +587,7 @@
}
/**
- * Returns true if this frame state is supported.
+ * Returns {@code true} if this frame state is supported.
*/
@Override
public boolean isFrameStateSupported(int state) {
--- old/src/java.desktop/windows/classes/sun/awt/windows/WTrayIconPeer.java 2015-10-27 21:54:06.004189192 +0400
+++ new/src/java.desktop/windows/classes/sun/awt/windows/WTrayIconPeer.java 2015-10-27 21:54:05.808189201 +0400
@@ -180,7 +180,7 @@
/*
* Updates/adds the icon in/to the system tray.
- * @param doUpdate if true, updates the icon,
+ * @param doUpdate if {@code true}, updates the icon,
* otherwise, adds the icon
*/
native void updateNativeIcon(boolean doUpdate);
--- old/src/java.desktop/windows/classes/sun/font/NativeFont.java 2015-10-27 21:54:06.616189164 +0400
+++ new/src/java.desktop/windows/classes/sun/font/NativeFont.java 2015-10-27 21:54:06.416189173 +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/windows/classes/sun/java2d/d3d/D3DScreenUpdateManager.java 2015-10-27 21:54:07.164189140 +0400
+++ new/src/java.desktop/windows/classes/sun/java2d/d3d/D3DScreenUpdateManager.java 2015-10-27 21:54:06.968189148 +0400
@@ -140,8 +140,8 @@
* method returns GDI surface (we don't want to have two swap chains)
* @param isResize whether this surface is being created in response to
* a component resize event. This determines whether a repaint event will
- * be issued after a surface is created: it will be if isResize
- * is true.
+ * be issued after a surface is created: it will be if {@code isResize}
+ * is {@code true}.
* @return surface data to be use for onscreen rendering
*/
@Override
--- old/test/java/awt/Mouse/MouseModifiersUnitTest/MouseModifiersUnitTest_Extra.java 2015-10-27 21:54:07.812189111 +0400
+++ new/test/java/awt/Mouse/MouseModifiersUnitTest/MouseModifiersUnitTest_Extra.java 2015-10-27 21:54:07.612189120 +0400
@@ -446,7 +446,7 @@
public static void main(String []s){
if (MouseInfo.getNumberOfButtons() < 4){
- System.out.println("There are less then 4 buttons on the mouse. The test may not be accomplished. Skipping.");
+ System.out.println("There are less than 4 buttons on the mouse. The test may not be accomplished. Skipping.");
return;
}
initVars();
--- old/test/java/awt/event/InputEvent/ButtonArraysEquality/ButtonArraysEquality.java 2015-10-27 21:54:08.560189077 +0400
+++ new/test/java/awt/event/InputEvent/ButtonArraysEquality/ButtonArraysEquality.java 2015-10-27 21:54:08.356189086 +0400
@@ -72,7 +72,7 @@
//check lengths: array shouldn't contain less elements then the number of buttons on a mouse
if (buttonDownMasks.length < buttonDownMasksAPI.length){
- throw new RuntimeException("Test failed. The lengths array is less then the number of buttons");
+ throw new RuntimeException("Test failed. The lengths array is less than the number of buttons");
}
// verify values for first three buttons
--- old/test/java/rmi/registry/altSecurityManager/AltSecurityManager.java 2015-10-27 21:54:09.304189044 +0400
+++ new/test/java/rmi/registry/altSecurityManager/AltSecurityManager.java 2015-10-27 21:54:09.100189053 +0400
@@ -58,7 +58,7 @@
public AltSecurityManager(int port) {
if (port <= 0) {
- TestLibrary.bomb("Port must be greater then 0.");
+ TestLibrary.bomb("Port must be greater than 0.");
}
this.regPort = port;
--- old/test/java/util/Collections/EmptyNavigableMap.java 2015-10-27 21:54:10.012189012 +0400
+++ new/test/java/util/Collections/EmptyNavigableMap.java 2015-10-27 21:54:09.752189023 +0400
@@ -265,7 +265,7 @@
navigableMap.subMap(last, true, first, false);
},
IllegalArgumentException.class, description
- + ": Must throw IllegalArgumentException when fromElement is not less then then toElement.");
+ + ": Must throw IllegalArgumentException when fromElement is not less than toElement.");
navigableMap.subMap(first, true, last, false);
}
--- old/test/java/util/Collections/EmptyNavigableSet.java 2015-10-27 21:54:10.556188987 +0400
+++ new/test/java/util/Collections/EmptyNavigableSet.java 2015-10-27 21:54:10.352188996 +0400
@@ -284,7 +284,7 @@
navigableSet.subSet(last, true, first, false);
},
IllegalArgumentException.class, description
- + ": Must throw IllegalArgumentException when fromElement is not less then then toElement.");
+ + ": Must throw IllegalArgumentException when fromElement is not less than toElement.");
navigableSet.subSet(first, true, last, false);
}