Cs | a color component of the source pixel in premultiplied form
@@ -113,7 +114,8 @@
* the blending equation in the Porter and Duff paper:
*
*
- *
+ *
+ * Factors
* Factor | Definition
* |
---|
Csr | one of the raw color components of the source pixel
* | Cdr | one of the raw color components of the destination pixel
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/Component.java
--- a/src/java.desktop/share/classes/java/awt/Component.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/Component.java Thu Jun 08 22:07:08 2017 -0700
@@ -7237,12 +7237,17 @@
* recommendations for Windows and Unix are listed below. These
* recommendations are used in the Sun AWT implementations.
*
- *
+ *
+ * Recommended default values for a Component's focus traversal
+ * keys
+ *
*
* Identifier |
* Meaning |
* Default |
*
+ *
+ *
*
* KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS |
* Normal forward keyboard traversal |
@@ -7258,6 +7263,7 @@
* Go up one focus traversal cycle |
* none |
*
+ *
*
*
* To disable a traversal key, use an empty Set; Collections.EMPTY_SET is
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/Container.java
--- a/src/java.desktop/share/classes/java/awt/Container.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/Container.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1995, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -3064,12 +3064,17 @@
* recommendations for Windows and Unix are listed below. These
* recommendations are used in the Sun AWT implementations.
*
- *
+ *
+ * Recommended default values for a Container's focus traversal
+ * keys
+ *
*
* Identifier |
* Meaning |
* Default |
*
+ *
+ *
*
* KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS |
* Normal forward keyboard traversal |
@@ -3086,10 +3091,11 @@
* none |
*
*
- * KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS |
+ * | KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS |
* Go down one focus traversal cycle |
* none |
*
+ *
*
*
* To disable a traversal key, use an empty Set; Collections.EMPTY_SET is
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/EventQueue.java
--- a/src/java.desktop/share/classes/java/awt/EventQueue.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/EventQueue.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1996, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -668,12 +668,16 @@
* dispatched depends upon the type of the event and the
* type of the event's source object:
*
- *
+ *
+ * Event types, source types, and dispatch methods
+ *
*
* Event Type |
* Source Type |
* Dispatched To |
*
+ *
+ *
*
* ActiveEvent |
* Any |
@@ -694,6 +698,7 @@
* Other |
* No action (ignored) |
*
+ *
*
*
* @param event an instance of {@code java.awt.AWTEvent},
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/GridBagLayout.java
--- a/src/java.desktop/share/classes/java/awt/GridBagLayout.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/GridBagLayout.java Thu Jun 08 22:07:08 2017 -0700
@@ -122,13 +122,16 @@
* are not. Baseline relative values are calculated relative to the
* baseline. Valid values are:
*
- *
+ *
+ * Absolute, relative and baseline values as described above
+ *
*
- * Absolute Values |
- * Orientation Relative Values |
- * Baseline Relative Values |
+ * Absolute Values |
+ * Orientation Relative Values |
+ * Baseline Relative Values |
*
+ *
+ *
*
*
*
* |
*
- *
+ *
+ *
* {@link GridBagConstraints#weightx},
* {@link GridBagConstraints#weighty}
* Used to determine how to distribute space, which is
@@ -197,13 +201,14 @@
*
* The following figure shows a baseline layout and includes a
* component that spans rows:
- *
+ *
+ * Baseline Layout
*
*
*
* |
- *
+ *
* This layout consists of three components:
* - A panel that starts in row 0 and ends in row 1. The panel
* has a baseline-resize behavior of {@code CONSTANT_DESCENT} and has
@@ -252,7 +257,8 @@
* left-to-right container and Figure 3 shows the layout for a horizontal,
* right-to-left container.
*
- *
+ *
+ * Figures
*
*
*
@@ -264,7 +270,7 @@
* | Figure 2: Horizontal, Left-to-Right |
* Figure 3: Horizontal, Right-to-Left |
*
- *
+ *
*
* Each of the ten components has the {@code fill} field
* of its associated {@code GridBagConstraints} object
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/GridLayout.java
--- a/src/java.desktop/share/classes/java/awt/GridLayout.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/GridLayout.java Thu Jun 08 22:07:08 2017 -0700
@@ -55,7 +55,8 @@
* If the container's {@code ComponentOrientation} property is horizontal
* and right-to-left, the example produces the output shown in Figure 2.
*
- *
+ *
+ * Figures
*
*
+ *
+ * Recommended default values for focus traversal keys
+ *
*
* Identifier |
* Meaning |
* Default |
*
+ *
+ *
*
* {@code KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS} |
* Normal forward keyboard traversal |
@@ -1067,6 +1071,7 @@
* Go down one focus traversal cycle |
* none |
*
+ *
*
*
* To disable a traversal key, use an empty {@code Set};
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/Scrollbar.java
--- a/src/java.desktop/share/classes/java/awt/Scrollbar.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/Scrollbar.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -296,12 +296,16 @@
* The default properties of the scroll bar are listed in
* the following table:
*
- *
+ *
+ * Scrollbar default properties
+ *
*
* Property |
* Description |
* Default Value |
*
+ *
+ *
*
* orientation |
* indicates whether the scroll bar is vertical
@@ -347,6 +351,7 @@
* on either side of the bubble |
* 10 |
*
+ *
*
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/SystemTray.java
--- a/src/java.desktop/share/classes/java/awt/SystemTray.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/SystemTray.java Thu Jun 08 22:07:08 2017 -0700
@@ -368,11 +368,15 @@
* Adds a {@code PropertyChangeListener} to the list of listeners for the
* specific property. The following properties are currently supported:
*
- *
+ *
+ * SystemTray properties
+ *
*
* Property |
* Description |
*
+ *
+ *
*
* {@code trayIcons} |
* The {@code SystemTray}'s array of {@code TrayIcon} objects.
@@ -389,6 +393,7 @@
* when the system tray becomes available or unavailable on the desktop.
* The property is accessed by the {@link #getSystemTray} method. |
*
+ *
*
*
* The {@code listener} listens to property changes only in this context.
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/font/NumericShaper.java
--- a/src/java.desktop/share/classes/java/awt/font/NumericShaper.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/font/NumericShaper.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -106,12 +106,16 @@
* multiple decimal digits sets are specified for the same Unicode
* range, one of the sets will take precedence as follows.
*
- *
+ *
+ * NumericShaper constants precedence
+ *
*
* Unicode Range |
* {@code NumericShaper} Constants |
* Precedence |
*
+ *
+ *
*
* Arabic |
* {@link NumericShaper#ARABIC NumericShaper.ARABIC}
@@ -123,12 +127,15 @@
* {@link NumericShaper.Range#EASTERN_ARABIC} |
* {@link NumericShaper.Range#EASTERN_ARABIC} |
*
+ *
+ *
*
* Tai Tham |
* {@link NumericShaper.Range#TAI_THAM_HORA}
* {@link NumericShaper.Range#TAI_THAM_THAM} |
* {@link NumericShaper.Range#TAI_THAM_THAM} |
*
+ *
*
*
* @since 1.4
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/font/TextAttribute.java
--- a/src/java.desktop/share/classes/java/awt/font/TextAttribute.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/font/TextAttribute.java Thu Jun 08 22:07:08 2017 -0700
@@ -96,15 +96,18 @@
*
*
* Summary of attributes
- *
- *
+ *
+ * Key, value type, principal constants, and
+ * default value behavior of all TextAttributes
+ *
+ *
* Key |
* Value Type |
* Principal Constants |
* Default Value |
*
+ *
+ *
*
* {@link #FAMILY} |
* String |
@@ -114,7 +117,7 @@
*
* "Default" (use platform default) |
*
- *
+ *
* {@link #WEIGHT} |
* Number |
* WEIGHT_REGULAR, WEIGHT_BOLD |
@@ -126,7 +129,7 @@
* WIDTH_CONDENSED, WIDTH_REGULAR, WIDTH_EXTENDED |
* WIDTH_REGULAR |
*
- *
+ *
* {@link #POSTURE} |
* Number |
* POSTURE_REGULAR, POSTURE_OBLIQUE |
@@ -138,7 +141,7 @@
* none |
* 12.0 |
*
- *
+ *
* {@link #TRANSFORM} |
* {@link TransformAttribute} |
* See TransformAttribute {@link TransformAttribute#IDENTITY IDENTITY} |
@@ -150,7 +153,7 @@
* SUPERSCRIPT_SUPER, SUPERSCRIPT_SUB |
* 0 (use the standard glyphs and metrics) |
*
- *
+ *
* {@link #FONT} |
* {@link java.awt.Font} |
* none |
@@ -162,7 +165,7 @@
* none |
* null (draw text using font glyphs) |
*
- *
+ *
* {@link #FOREGROUND} |
* {@link java.awt.Paint} |
* none |
@@ -174,7 +177,7 @@
* none |
* null (do not render background) |
*
- *
+ *
* {@link #UNDERLINE} |
* Integer |
* UNDERLINE_ON |
@@ -186,7 +189,7 @@
* STRIKETHROUGH_ON |
* false (do not render strikethrough) |
*
- *
+ *
* {@link #RUN_DIRECTION} |
* Boolean |
* RUN_DIRECTION_LTR RUN_DIRECTION_RTL |
@@ -198,7 +201,7 @@
* none |
* 0 (use base line direction) |
*
- *
+ *
* {@link #JUSTIFICATION} |
* Number |
* JUSTIFICATION_FULL |
@@ -210,7 +213,7 @@
* (see class) |
* null (do not apply input highlighting) |
*
- *
+ *
* {@link #INPUT_METHOD_UNDERLINE} |
* Integer |
* UNDERLINE_LOW_ONE_PIXEL, UNDERLINE_LOW_TWO_PIXEL |
@@ -222,7 +225,7 @@
* SWAP_COLORS_ON |
* false (do not swap colors) |
*
- *
+ *
* {@link #NUMERIC_SHAPING} |
* {@link java.awt.font.NumericShaper} |
* none |
@@ -234,7 +237,7 @@
* KERNING_ON |
* 0 (do not request kerning) |
*
- *
+ *
* {@link #LIGATURES} |
* Integer |
* LIGATURES_ON |
@@ -246,6 +249,7 @@
* TRACKING_LOOSE, TRACKING_TIGHT |
* 0 (do not add tracking) |
*
+ *
*
*
* @see java.awt.Font
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/java/awt/geom/Path2D.java
--- a/src/java.desktop/share/classes/java/awt/geom/Path2D.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/java/awt/geom/Path2D.java Thu Jun 08 22:07:08 2017 -0700
@@ -876,13 +876,18 @@
*
* The following byte value constants are used in the serialized form
* of {@code Path2D} objects:
- *
+ *
+ *
+ * Constants
+ *
*
* Constant Name |
* Byte Value |
* Followed by |
* Description |
*
+ *
+ *
*
* {@code SERIAL_STORAGE_FLT_ARRAY} |
* 0x30 |
@@ -956,6 +961,7 @@
* 0x61 |
* |
* There are no more path segments following. |
+ *
*
*
* @since 1.6
@@ -1635,13 +1641,17 @@
*
* The following byte value constants are used in the serialized form
* of {@code Path2D} objects:
- *
+ *
+ * Constants
+ *
*
* Constant Name |
* Byte Value |
* Followed by |
* Description |
*
+ *
+ *
*
* {@code SERIAL_STORAGE_FLT_ARRAY} |
* 0x30 |
@@ -1715,6 +1725,7 @@
* 0x61 |
* |
* There are no more path segments following. |
+ *
*
*
* @since 1.6
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/print/DocFlavor.java
--- a/src/java.desktop/share/classes/javax/print/DocFlavor.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/print/DocFlavor.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -194,10 +194,14 @@
* constructor can be used to create an arbitrary doc flavor.
*
* - Preformatted text
- *
+ *
+ * MIME-Types and their descriptions
+ *
*
* MIME-Type | Description |
*
+ *
+ *
*
* {@code "text/plain"} |
* Plain text in the default character set (US-ASCII) |
@@ -214,6 +218,7 @@
* "text/html; charset=xxx" |
* HyperText Markup Language in character set xxx |
*
+ *
*
*
* In general, preformatted text print data is provided either in a character
@@ -222,11 +227,15 @@
*
* - Preformatted page description language (PDL) documents
*
- *
+ *
+ * MIME-Types and their descriptions
+ *
*
* MIME-Type | Description |
*
- *
+ *
+ *
+ *
* {@code "application/pdf"} |
* Portable Document Format document |
*
@@ -238,6 +247,7 @@
* {@code "application/vnd.hp-PCL"} |
* Printer Control Language document |
*
+ *
*
*
* In general, preformatted PDL print data is provided in a byte oriented
@@ -245,11 +255,14 @@
*
* - Preformatted images
*
- *
+ *
+ * MIME-Types and their descriptions
+ *
*
* MIME-Type | Description |
*
- *
+ *
+ *
*
* {@code "image/gif"} |
* Graphics Interchange Format image |
@@ -262,6 +275,7 @@
* {@code "image/png"} |
* Portable Network Graphics image |
*
+ *
*
*
* In general, preformatted image print data is provided in a byte oriented
@@ -269,14 +283,19 @@
*
* - Preformatted autosense print data
*
- *
+ *
+ * MIME-Types and their descriptions
+ *
*
* MIME-Type | Description |
*
- *
+ *
+ *
*
* {@code "application/octet-stream"} |
* The print data format is unspecified (just an octet stream) |
+ *
+ *
*
*
* The printer decides how to interpret the print data; the way this
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/print/attribute/standard/Chromaticity.java
--- a/src/java.desktop/share/classes/javax/print/attribute/standard/Chromaticity.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/print/attribute/standard/Chromaticity.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -42,7 +42,10 @@
* {@link #MONOCHROME MONOCHROME} or {@link #COLOR COLOR}
* for a monochrome or color document.
*
- *
+ *
+ * Shows effects of specifying MONOCHROME or COLOR Chromaticity
+ * attributes
+ *
*
*
* Chromaticity Attribute
@@ -54,6 +57,8 @@
* Effect on Color Document
* |
*
+ *
+ *
*
*
* {@link #MONOCHROME MONOCHROME}
@@ -76,6 +81,7 @@
* Printed as is, in color
* |
*
+ *
*
*
* IPP Compatibility: Chromaticity is not an IPP attribute at present.
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/print/attribute/standard/Finishings.java
--- a/src/java.desktop/share/classes/javax/print/attribute/standard/Finishings.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/print/attribute/standard/Finishings.java Thu Jun 08 22:07:08 2017 -0700
@@ -40,7 +40,8 @@
* for purposes of finishing.
*
* Standard Finishings values are:
- *
+ *
+ * Standard Finishings values
*
*
*
@@ -76,7 +77,8 @@
*
* The following Finishings values are more specific; they indicate a
* corner or an edge as if the document were a portrait document:
- *
+ *
+ * Specific Finishings values
*
*
*
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctets.java
--- a/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctets.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/print/attribute/standard/JobKOctets.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -66,11 +66,15 @@
* specified by the doc's {@link javax.print.DocFlavor DocFlavor}, as
* shown in the table below.
*
- *
+ *
+ * Table showing computation of doc sizes
+ *
*
* Representation Class |
* Document Size |
*
+ *
+ *
*
* byte[] |
* Length of the byte array |
@@ -107,6 +111,7 @@
* java.awt.print.Pageable |
* Implementation dependent* |
*
+ *
*
*
* * In these cases the Print Service itself generates the print data sent
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/sound/midi/MidiSystem.java
--- a/src/java.desktop/share/classes/javax/sound/midi/MidiSystem.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/sound/midi/MidiSystem.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -74,13 +74,16 @@
* following table lists the available property keys and which methods consider
* them:
*
- *
- * MIDI System Property Keys
+ *
+ * MIDI System Property Keys
+ *
*
* Property Key |
* Interface |
* Affected Method |
*
+ *
+ *
*
* {@code javax.sound.midi.Receiver} |
* {@link Receiver} |
@@ -101,6 +104,7 @@
* {@link Transmitter} |
* {@link #getTransmitter} |
*
+ *
*
*
* The property value consists of the provider class name and the device name,
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/sound/sampled/AudioFormat.java
--- a/src/java.desktop/share/classes/javax/sound/sampled/AudioFormat.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/sound/sampled/AudioFormat.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -89,13 +89,16 @@
* The following table lists some common properties which service providers
* should use, if applicable:
*
- *
- * Audio Format Properties
+ *
+ * Audio Format Properties
+ *
*
* Property key |
* Value type |
* Description |
*
+ *
+ *
*
* "bitrate" |
* {@link java.lang.Integer Integer} |
@@ -112,6 +115,7 @@
* {@link java.lang.Integer Integer} |
* encoding/conversion quality, 1..100 |
*
+ *
*
*
* Vendors of service providers (plugins) are encouraged to seek information
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/sound/sampled/AudioPermission.java
--- a/src/java.desktop/share/classes/javax/sound/sampled/AudioPermission.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/sound/sampled/AudioPermission.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -41,13 +41,17 @@
* permission allows, as well as a discussion of the risks of granting code the
* permission.
*
- *
+ *
+ * Permission target name, what the permission allows, and associated
+ * risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
- *
+ *
+ *
*
* play |
* Audio playback through the audio device or devices on the system.
@@ -69,6 +73,7 @@
* using that mixer.
* This permission can enable an applet or application to eavesdrop on a user. |
*
+ *
*
*
* @author Kara Kytle
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/sound/sampled/AudioSystem.java
--- a/src/java.desktop/share/classes/javax/sound/sampled/AudioSystem.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/sound/sampled/AudioSystem.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -72,13 +72,16 @@
* {@link Properties#load(InputStream) Properties.load}. The following table
* lists the available property keys and which methods consider them:
*
- *
- * Audio System Property Keys
+ *
+ * Audio System Property Keys
+ *
*
* Property Key |
* Interface |
* Affected Method(s) |
*
+ *
+ *
*
* {@code javax.sound.sampled.Clip} |
* {@link Clip} |
@@ -99,6 +102,7 @@
* {@link TargetDataLine} |
* {@link #getLine}, {@link #getTargetDataLine} |
*
+ *
*
*
* The property value consists of the provider class name and the mixer name,
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/sound/sampled/ReverbType.java
--- a/src/java.desktop/share/classes/javax/sound/sampled/ReverbType.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/sound/sampled/ReverbType.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -69,12 +69,11 @@
*
* The following table shows what parameter values an implementation might use
* for a representative set of reverberation settings.
- *
*
- * Reverberation Types and Parameters
- *
- *
- *
+ *
+ * Reverb types and params: decay time, late intensity, late delay,
+ * early intensity, and early delay
+ *
*
* Type |
* Decay Time (ms) |
@@ -83,7 +82,8 @@
* Early Intensity (dB) |
* Early Delay(ms) |
*
- *
+ *
+ *
*
* Cavern |
* 2250 |
@@ -128,7 +128,7 @@
* -7.0 |
* 0.6 |
*
- *
+ *
*
*
* @author Kara Kytle
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/Action.java
--- a/src/java.desktop/share/classes/javax/swing/Action.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/Action.java Thu Jun 08 22:07:08 2017 -0700
@@ -94,13 +94,16 @@
* Action that is null ) results in the
* button's corresponding property being set to null .
*
- *
- *
- * Component Property
- * | Components
- * | Action Key
- * | Notes
+ *
+ * Supported Action properties
+ *
+ *
+ * Component Property
+ * | Components
+ * | Action Key
+ * | Notes
+ * |
+ *
*
* enabled
* | All
@@ -191,6 +194,7 @@
* use the same {@code Action} that defines a value for the
* {@code SELECTED_KEY} property with multiple mutually
* exclusive buttons.
+ * |
*
*
* JPopupMenu , JToolBar and JMenu
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/BoxLayout.java
--- a/src/java.desktop/share/classes/javax/swing/BoxLayout.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/BoxLayout.java Thu Jun 08 22:07:08 2017 -0700
@@ -36,7 +36,8 @@
* vertically or horizontally. The components will not wrap so, for
* example, a vertical arrangement of components will stay vertically
* arranged when the frame is resized.
- *
+ *
+ * Example:
*
*
* JFormattedTextField allows
* configuring what action should be taken when focus is lost. The possible
* configurations are:
- *
- * Value | Description |
+ *
+ *
+ * Possible JFormattedTextField configurations and their descriptions
+ *
+ *
+ * Value |
+ * Description |
+ *
+ *
* JFormattedTextField.REVERT
* | Revert the display to match that of getValue ,
* possibly losing the current edit.
@@ -71,6 +78,7 @@
* | JFormattedTextField.PERSIST
* | Do nothing, don't obtain a new
* AbstractFormatter , and don't update the value.
+ * |
*
* The default is JFormattedTextField.COMMIT_OR_REVERT ,
* refer to {@link #setFocusLostBehavior} for more information on this.
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/JLayeredPane.java
--- a/src/java.desktop/share/classes/javax/swing/JLayeredPane.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/JLayeredPane.java Thu Jun 08 22:07:08 2017 -0700
@@ -47,7 +47,8 @@
* How to Use a Layered Pane,
* a section in The Java Tutorial.
*
- *
+ *
+ * Example
*
*
*
* A description of these layouts follows:
*
- *
- * Value | Description |
+ *
+ * Describes layouts VERTICAL,HORIZONTAL_WRAP, and VERTICAL_WRAP
+ *
+ *
+ * Value | Description |
+ *
+ *
* VERTICAL
* | Cells are layed out vertically in a single column.
* | HORIZONTAL_WRAP
@@ -978,7 +982,8 @@
* necessary. If the {@code visibleRowCount} property is less than
* or equal to zero, wrapping is determined by the height of the
* list; otherwise wrapping is done at {@code visibleRowCount} rows.
- * |
+ *
+ *
*
* The default value of this property is VERTICAL .
*
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/JOptionPane.java
--- a/src/java.desktop/share/classes/javax/swing/JOptionPane.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/JOptionPane.java Thu Jun 08 22:07:08 2017 -0700
@@ -73,12 +73,15 @@
* showXxxDialog methods shown below:
*
*
- *
- *
+ *
+ * Common JOptionPane method names and their descriptions
+ *
*
* Method Name |
* Description |
*
+ *
+ *
*
* showConfirmDialog |
* Asks a confirming question, like yes/no/cancel. |
@@ -95,6 +98,7 @@
* showOptionDialog |
* The Grand Unification of the above three. |
*
+ *
*
*
*
@@ -107,7 +111,8 @@
* All dialogs are modal. Each showXxxDialog method blocks
* the caller until the user's interaction is complete.
*
- *
+ *
+ * Common dialog
*
* icon |
* message |
@@ -121,7 +126,7 @@
*
*
* The basic appearance of one of these dialog boxes is generally
- * similar to the picture at the right, although the various
+ * similar to the picture above, although the various
* look-and-feels are
* ultimately responsible for the final result. In particular, the
* look-and-feels will adjust the layout to accommodate the option pane's
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/JRootPane.java
--- a/src/java.desktop/share/classes/javax/swing/JRootPane.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/JRootPane.java Thu Jun 08 22:07:08 2017 -0700
@@ -70,7 +70,9 @@
* can be used to obtain the JRootPane that contains
* a given component.
*
- *
+ *
+ *
+ * Example
*
*
* The Java Tutorial. Note that
* JScrollPane does not support heavyweight components.
*
- *
+ *
+ * Example
*
*
*
+ *
+ *
+ * Describes the preferred size for each layout orientation
+ *
+ *
* Layout Orientation | Preferred Size |
+ *
+ *
*
* JList.VERTICAL
* | The preferredSize of the list is total height of the rows
@@ -626,6 +632,7 @@
* Max cell height is either the fixed
* cell height, or is determined by iterating through all the cells
* to find the maximum height from the ListCellRenderer.
+ * |
*
* The above specifies the raw preferred width and height. The resulting
* preferred width is the above width + insets.left + insets.right and
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/plaf/metal/MetalLookAndFeel.java
--- a/src/java.desktop/share/classes/javax/swing/plaf/metal/MetalLookAndFeel.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/plaf/metal/MetalLookAndFeel.java Thu Jun 08 22:07:08 2017 -0700
@@ -290,11 +290,15 @@
/**
* Populates {@code table} with system colors. The following values are
* added to {@code table}:
- *
- *
- * Key
- * | Value
+ *
+ *
+ * Metal's system color mapping
+ *
+ *
+ * Key
+ * | Value
+ * |
+ *
*
* "desktop"
* | {@code theme.getDesktopColor()}
@@ -373,6 +377,7 @@
* |
* "infoText"
* | {@code theme.getPrimaryControlInfo()}
+ * |
*
* The value {@code theme} corresponds to the current {@code MetalTheme}.
*
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/plaf/metal/MetalTreeUI.java
--- a/src/java.desktop/share/classes/javax/swing/plaf/metal/MetalTreeUI.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/plaf/metal/MetalTreeUI.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -44,9 +44,11 @@
* visually render the spacing and delineation between nodes. The following
* hints are supported:
*
- *
+ *
+ * Descriptions of supported hints: Angled, Horizontal, and None
+ *
*
- * Angled |
+ * Angled |
* A line is drawn connecting the child to the parent. For handling
* of the root node refer to
* {@link javax.swing.JTree#setRootVisible} and
@@ -54,11 +56,11 @@
* |
*
*
- * Horizontal |
+ * Horizontal |
* A horizontal line is drawn dividing the children of the root node. |
*
*
- * None |
+ * None |
* Do not draw any visual indication between nodes. |
*
*
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/text/JTextComponent.java
--- a/src/java.desktop/share/classes/javax/swing/text/JTextComponent.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/text/JTextComponent.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -157,11 +157,15 @@
* Keyboard event and input method events are handled in the following stages,
* with each stage capable of consuming the event:
*
- *
+ *
+ * Stages of keyboard and input method event handling
+ *
*
- * Stage |
- * KeyEvent |
- * InputMethodEvent |
+ * Stage |
+ * KeyEvent |
+ * InputMethodEvent |
+ *
+ *
* 1. |
* input methods |
* (generated here) |
@@ -181,6 +185,7 @@
* 5. | keymap handling using the current keymap |
* 6. | keyboard handling in JComponent (e.g. accelerators, component navigation, etc.) |
* |
+ *
*
*
*
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/text/MaskFormatter.java
--- a/src/java.desktop/share/classes/javax/swing/text/MaskFormatter.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/text/MaskFormatter.java Thu Jun 08 22:07:08 2017 -0700
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -37,11 +37,15 @@
* location in the Document model. The following characters can
* be specified:
*
- *
+ *
+ * Valid characters and their descriptions
+ *
*
* Character |
- * Description |
+ * Description |
*
+ *
+ *
*
* # |
* Any valid number, uses Character.isDigit . |
@@ -66,6 +70,7 @@
*
* * | Anything. |
* H | Any hex character (0-9, a-f or A-F). |
+ *
*
*
*
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/text/html/FormView.java
--- a/src/java.desktop/share/classes/javax/swing/text/html/FormView.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/text/html/FormView.java Thu Jun 08 22:07:08 2017 -0700
@@ -46,11 +46,16 @@
*
* The following table shows what components get built
* by this view.
- *
+ *
+ *
+ * Shows what components get built by this view
+ *
*
* Element Type |
* Component built |
*
+ *
+ *
*
* input, type button |
* JButton |
@@ -99,6 +104,7 @@
* input, type file |
* JTextField |
*
+ *
*
*
* @author Timothy Prinzing
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/text/html/HTMLDocument.java
--- a/src/java.desktop/share/classes/javax/swing/text/html/HTMLDocument.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/text/html/HTMLDocument.java Thu Jun 08 22:07:08 2017 -0700
@@ -183,7 +183,8 @@
* The following table shows the example document and the results
* of various methods described above.
*
- *
+ *
+ * HTML Content of example above
*
* Example |
* insertAfterStart |
@@ -2129,8 +2130,13 @@
*
* The assignment of the actions described is shown in the
* following table for the tags defined in HTML.Tag .
- *
+ *
+ *
+ * HTML tags and assigned actions
+ *
* Tag | Action |
+ *
+ *
* HTML.Tag.A | CharacterAction
* | HTML.Tag.ADDRESS | CharacterAction
* | HTML.Tag.APPLET | HiddenAction
@@ -2203,6 +2209,7 @@
* | HTML.Tag.U | CharacterAction
* | HTML.Tag.UL | BlockAction
* | HTML.Tag.VAR | CharacterAction
+ * |
*
*
* Once </html> is encountered, the Actions are no longer notified.
@@ -3385,10 +3392,17 @@
* be iterated over picking up the data of the form.
* The following are the model assignments for the
* various type of form elements.
- *
+ *
+ *
+ * Model assignments for the various types of form elements
+ *
+ *
*
* Element Type
* | Model Type
+ * |
+ *
+ *
*
* input, type button
* | {@link DefaultButtonModel}
@@ -3419,6 +3433,7 @@
* |
* textarea
* | {@link PlainDocument}
+ * |
*
*
*/
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/text/html/HTMLEditorKit.java
--- a/src/java.desktop/share/classes/javax/swing/text/html/HTMLEditorKit.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/text/html/HTMLEditorKit.java Thu Jun 08 22:07:08 2017 -0700
@@ -1118,10 +1118,17 @@
* table describes what this factory will build by
* default.
*
- *
+ *
+ * Describes the tag and view created by this factory by default
+ *
+ *
*
- * Tag | View created
- * |
+ * Tag
+ * | View created
+ * |
+ *
+ *
+ *
* HTML.Tag.CONTENT | InlineView
* |
* HTML.Tag.IMPLIED | javax.swing.text.html.ParagraphView
@@ -1192,6 +1199,7 @@
* |
* HTML.Tag.FRAME | FrameView
* |
+ *
*
*/
public static class HTMLFactory implements ViewFactory {
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/tree/DefaultTreeCellRenderer.java
--- a/src/java.desktop/share/classes/javax/swing/tree/DefaultTreeCellRenderer.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/tree/DefaultTreeCellRenderer.java Thu Jun 08 22:07:08 2017 -0700
@@ -60,10 +60,16 @@
* that have a value of type {@code UIResource} are refreshed from the
* defaults table. The following table lists the mapping between
* {@code DefaultTreeCellRenderer} property and defaults table key:
- *
- *
- * Property:
- * | Key:
+ *
+ *
+ * Properties
+ *
+ *
+ * Property:
+ * | Key:
+ * |
+ *
+ *
* "leafIcon" | "Tree.leafIcon"
* | "closedIcon" | "Tree.closedIcon"
* | "openIcon" | "Tree.openIcon"
@@ -72,6 +78,7 @@
* | "backgroundSelectionColor" | "Tree.selectionBackground"
* | "backgroundNonSelectionColor" | "Tree.textBackground"
* | "borderSelectionColor" | "Tree.selectionBorderColor"
+ * |
*
*
* Implementation Note:
diff -r 890af73c1fe4 -r 6e591955c8a8 src/java.desktop/share/classes/javax/swing/undo/UndoManager.java
--- a/src/java.desktop/share/classes/javax/swing/undo/UndoManager.java Thu Jun 08 14:53:56 2017 +0200
+++ b/src/java.desktop/share/classes/javax/swing/undo/UndoManager.java Thu Jun 08 22:07:08 2017 -0700
@@ -58,7 +58,8 @@
* and italicized are insignificant.
*
*
- *
+ *
+ * Figure 1
*
*
* | Figure 1
@@ -71,7 +72,8 @@
* figure.
*
*
- *
+ *
+ * Figure 2
*
*
* | Figure 2
@@ -83,7 +85,8 @@
* next edit to 0, as shown in the following figure.
*
*
- *
+ *
+ * Figure 3
*
*
* | Figure 3
@@ -109,7 +112,8 @@
* figure.
*
*
- *
+ *
+ * Figure 4
*
*
* | Figure 4
| | | | | | | | | | | | | |
| |