changeset 47497:328167c4ef32

8187399: Different problems in the javadoc's links in java.desktop package Reviewed-by: azvegint
author serb
date Fri, 20 Oct 2017 15:12:45 -0700
parents 251676148c62
children aa0344e6f39b
files src/java.desktop/share/classes/java/awt/Desktop.java src/java.desktop/share/classes/java/awt/event/MouseEvent.java src/java.desktop/share/classes/javax/print/attribute/standard/PresentationDirection.java src/java.desktop/share/classes/javax/swing/JComponent.java src/java.desktop/share/classes/javax/swing/JEditorPane.java src/java.desktop/share/classes/javax/swing/JOptionPane.java src/java.desktop/share/classes/javax/swing/SpinnerNumberModel.java src/java.desktop/share/classes/javax/swing/text/Document.java
diffstat 8 files changed, 32 insertions(+), 32 deletions(-) [+]
line wrap: on
line diff
--- 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:
+             *   &lt;a href="http://openjdk.java.net"&gt;OpenJDK&lt;/a&gt;
              * this method would return a String containing the text:
-             * 'Accessibility'.
-             *
+             * 'OpenJDK'.
+             * <p>
              * Similarly, from this HTML:
              *   &lt;a HREF="#top"&gt;&lt;img src="top-hat.gif" alt="top hat"&gt;&lt;/a&gt;
              * 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>