8187399: Different problems in the javadoc's links in java.desktop package
Reviewed-by: azvegint
--- a/src/java.desktop/share/classes/java/awt/Desktop.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/java/awt/Desktop.java Fri Oct 20 15:12:45 2017 -0700
@@ -768,13 +768,13 @@
* Installs the handler which is notified when the application is asked to
* open a list of files.
*
- * @implNote Please note that for Mac OS, notifications
+ * @implNote Please note that for macOS, notifications
* are only sent if the Java app is a bundled application,
* with a {@code CFBundleDocumentTypes} array present in its
- * Info.plist. See the
- * <a href="http://developer.apple.com/mac/library/documentation/General/Reference/InfoPlistKeyReference">
- * Info.plist Key Reference</a> for more information about adding a
- * {@code CFBundleDocumentTypes} key to your app's Info.plist.
+ * {@code Info.plist}. Check the
+ * <a href="https://developer.apple.com/documentation">
+ * Apple Developer Documentation</a> for more information about
+ * {@code Info.plist}.
*
* @param openFileHandler handler
*
@@ -800,13 +800,13 @@
* Installs the handler which is notified when the application is asked to
* print a list of files.
*
- * @implNote Please note that for Mac OS, notifications
+ * @implNote Please note that for macOS, notifications
* are only sent if the Java app is a bundled application,
* with a {@code CFBundleDocumentTypes} array present in its
- * Info.plist. See the
- * <a href="http://developer.apple.com/mac/library/documentation/General/Reference/InfoPlistKeyReference">
- * Info.plist Key Reference</a> for more information about adding a
- * {@code CFBundleDocumentTypes} key to your app's Info.plist.
+ * {@code Info.plist}. Check the
+ * <a href="https://developer.apple.com/documentation">
+ * Apple Developer Documentation</a> for more information about
+ * {@code Info.plist}.
*
* @param printFileHandler handler
* @throws SecurityException if a security manager exists and its
@@ -835,13 +835,13 @@
* {@link OpenURIHandler#openURI(OpenURIEvent)} requests to be
* enqueued until another handler is set.
*
- * @implNote Please note that for Mac OS, notifications
+ * @implNote Please note that for macOS, notifications
* are only sent if the Java app is a bundled application,
* with a {@code CFBundleDocumentTypes} array present in its
- * Info.plist. See the
- * <a href="http://developer.apple.com/mac/library/documentation/General/Reference/InfoPlistKeyReference">
- * Info.plist Key Reference</a> for more information about adding a
- * {@code CFBundleDocumentTypes} key to your app's Info.plist.
+ * {@code Info.plist}. Check the
+ * <a href="https://developer.apple.com/documentation">
+ * Apple Developer Documentation</a> for more information about
+ * {@code Info.plist}.
*
* @param openURIHandler handler
*
--- a/src/java.desktop/share/classes/java/awt/event/MouseEvent.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/java/awt/event/MouseEvent.java Fri Oct 20 15:12:45 2017 -0700
@@ -745,7 +745,6 @@
* @see #getClickCount()
* @see #isPopupTrigger()
* @see #getButton()
- * @see #button
* @see Toolkit#areExtraMouseButtonsEnabled()
* @see java.awt.MouseInfo#getNumberOfButtons()
* @see InputEvent#getMaskForButton(int)
--- a/src/java.desktop/share/classes/javax/print/attribute/standard/PresentationDirection.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/javax/print/attribute/standard/PresentationDirection.java Fri Oct 20 15:12:45 2017 -0700
@@ -41,10 +41,10 @@
* <p>
* <b>IPP Compatibility:</b> This attribute is not an IPP 1.1 attribute; it is
* an attribute in the Production Printing Extension
- * (<a href="ftp://ftp.pwg.org/pub/pwg/standards/pwg5100.3.pdf">PDF</a>) of IPP
- * 1.1. The category name returned by {@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
+ * (<a href="ftp://ftp.pwg.org/pub/pwg/standards/temp_archive/pwg5100.3.pdf">
+ * PDF</a>) of IPP 1.1. The category name returned by {@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
--- a/src/java.desktop/share/classes/javax/swing/JComponent.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/javax/swing/JComponent.java Fri Oct 20 15:12:45 2017 -0700
@@ -121,7 +121,7 @@
* both of which are sections in <em>The Java Tutorial</em>.
* </ul>
* For more information on these subjects, see the
- * <a href="package-summary.html#package_description">Swing package description</a>
+ * {@link javax.swing Swing package description}
* and <em>The Java Tutorial</em> section
* <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/jcomponent.html">The JComponent Class</a>.
* <p>
--- a/src/java.desktop/share/classes/javax/swing/JEditorPane.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/javax/swing/JEditorPane.java Fri Oct 20 15:12:45 2017 -0700
@@ -1914,11 +1914,13 @@
/**
* Return an object that represents the link anchor,
- * as appropriate for that link. E.g. from HTML:
- * <a href="http://www.sun.com/access">Accessibility</a>
+ * as appropriate for that link.
+ * <p>
+ * E.g. from HTML:
+ * <a href="http://openjdk.java.net">OpenJDK</a>
* this method would return a String containing the text:
- * 'Accessibility'.
- *
+ * 'OpenJDK'.
+ * <p>
* Similarly, from this HTML:
* <a HREF="#top"><img src="top-hat.gif" alt="top hat"></a>
* this might return the object ImageIcon("top-hat.gif", "top hat");
--- a/src/java.desktop/share/classes/javax/swing/JOptionPane.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/javax/swing/JOptionPane.java Fri Oct 20 15:12:45 2017 -0700
@@ -148,7 +148,7 @@
* in which case a default <code>Frame</code> is used as the parent,
* and the dialog will be
* centered on the screen (depending on the {@literal L&F}).
- * <dt><a id=message>message</a><dd>
+ * <dt>message<dd>
* A descriptive message to be placed in the dialog box.
* In the most common usage, message is just a <code>String</code> or
* <code>String</code> constant.
--- a/src/java.desktop/share/classes/javax/swing/SpinnerNumberModel.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/javax/swing/SpinnerNumberModel.java Fri Oct 20 15:12:45 2017 -0700
@@ -260,8 +260,7 @@
* as the <code>value</code> however it's possible to use any
* <code>Comparable</code> with a <code>compareTo</code>
* method for a <code>Number</code> with the same type as the value.
- * See <a href="#setMinimum(java.lang.Comparable)">
- * <code>setMinimum</code></a> for an example.
+ * See {@link #setMinimum(Comparable)} for an example.
* <p>
* This method fires a <code>ChangeEvent</code> if the
* <code>maximum</code> has changed.
--- a/src/java.desktop/share/classes/javax/swing/text/Document.java Fri Oct 20 11:08:18 2017 -0700
+++ b/src/java.desktop/share/classes/javax/swing/text/Document.java Fri Oct 20 15:12:45 2017 -0700
@@ -146,10 +146,10 @@
* <p>
* The methods related to observing mutations to the document are:
* <ul>
- * <li><a href="#addDocumentListener(javax.swing.event.DocumentListener)">addDocumentListener(DocumentListener)</a>
- * <li><a href="#removeDocumentListener(javax.swing.event.DocumentListener)">removeDocumentListener(DocumentListener)</a>
- * <li><a href="#addUndoableEditListener(javax.swing.event.UndoableEditListener)">addUndoableEditListener(UndoableEditListener)</a>
- * <li><a href="#removeUndoableEditListener(javax.swing.event.UndoableEditListener)">removeUndoableEditListener(UndoableEditListener)</a>
+ * <li>{@link #addDocumentListener(DocumentListener)}
+ * <li>{@link #removeDocumentListener(DocumentListener)}
+ * <li>{@link #addUndoableEditListener(UndoableEditListener)}
+ * <li>{@link #removeUndoableEditListener(UndoableEditListener)}
* </ul>
*
* <p><b>Properties</b>