From 30e2ffcf775a82071910f973e52819e188f25452 Mon Sep 17 00:00:00 2001 From: Pavel Porvatov Date: Tue, 11 Jan 2011 12:51:33 +0300 Subject: [PATCH] 6589952: Swing: dead links in API documentation Reviewed-by: alexp --- .../classes/javax/swing/AbstractButton.java | 1 - .../classes/javax/swing/JEditorPane.java | 4 +-- .../classes/javax/swing/SizeSequence.java | 2 +- .../classes/javax/swing/TransferHandler.java | 12 ++++---- .../swing/event/InternalFrameAdapter.java | 3 +- .../swing/event/InternalFrameListener.java | 4 +-- .../swing/plaf/multi/doc-files/multi_tsc.html | 2 +- .../plaf/synth/doc-files/synthFileFormat.html | 8 +++--- .../javax/swing/text/AsyncBoxView.java | 2 +- .../javax/swing/text/DefaultCaret.java | 2 +- .../classes/javax/swing/text/TableView.java | 2 +- .../share/classes/javax/swing/text/View.java | 28 +++++++++---------- .../javax/swing/text/html/HTMLEditorKit.java | 4 +-- .../javax/swing/text/html/ParagraphView.java | 2 +- .../javax/swing/text/html/StyleSheet.java | 2 +- 15 files changed, 37 insertions(+), 41 deletions(-) diff --git a/jdk/src/share/classes/javax/swing/AbstractButton.java b/jdk/src/share/classes/javax/swing/AbstractButton.java index aac3be32aa4..7aff31b4c67 100644 --- a/jdk/src/share/classes/javax/swing/AbstractButton.java +++ b/jdk/src/share/classes/javax/swing/AbstractButton.java @@ -1335,7 +1335,6 @@ public abstract class AbstractButton extends JComponent implements ItemSelectabl * * @param a the button's action * @since 1.3 - * @see Actions * @see Action * @see #setAction */ diff --git a/jdk/src/share/classes/javax/swing/JEditorPane.java b/jdk/src/share/classes/javax/swing/JEditorPane.java index acc91080086..056cc36b394 100644 --- a/jdk/src/share/classes/javax/swing/JEditorPane.java +++ b/jdk/src/share/classes/javax/swing/JEditorPane.java @@ -145,8 +145,8 @@ import javax.accessibility.*; *
  • * One way is to specify the character set as a parameter of the MIME * type. This will be established by a call to the - * setContentType method. If the content - * is loaded by the setPage method the content + * {@link #setContentType setContentType} method. If the content + * is loaded by the {@link #setPage setPage} method the content * type will have been set according to the specification of the URL. * It the file is loaded directly, the content type would be expected to * have been set prior to loading. diff --git a/jdk/src/share/classes/javax/swing/SizeSequence.java b/jdk/src/share/classes/javax/swing/SizeSequence.java index 5667a66ce08..1ec97520827 100644 --- a/jdk/src/share/classes/javax/swing/SizeSequence.java +++ b/jdk/src/share/classes/javax/swing/SizeSequence.java @@ -132,7 +132,7 @@ public class SizeSequence { * can use insertEntries or setSizes. * * @see #insertEntries - * @see #setSizes + * @see #setSizes(int[]) */ public SizeSequence() { a = emptyArray; diff --git a/jdk/src/share/classes/javax/swing/TransferHandler.java b/jdk/src/share/classes/javax/swing/TransferHandler.java index 4854fdc75bf..eb7f8d1a644 100644 --- a/jdk/src/share/classes/javax/swing/TransferHandler.java +++ b/jdk/src/share/classes/javax/swing/TransferHandler.java @@ -344,7 +344,7 @@ public class TransferHandler implements Serializable { * * @return the drop location * @throws IllegalStateException if this is not a drop - * @see #isDrop + * @see #isDrop() */ public DropLocation getDropLocation() { assureIsDrop(); @@ -380,7 +380,7 @@ public class TransferHandler implements Serializable { * * @param showDropLocation whether or not to indicate the drop location * @throws IllegalStateException if this is not a drop - * @see #isDrop + * @see #isDrop() */ public void setShowDropLocation(boolean showDropLocation) { assureIsDrop(); @@ -406,7 +406,7 @@ public class TransferHandler implements Serializable { * @see #getDropAction * @see #getUserDropAction * @see #getSourceDropActions - * @see #isDrop + * @see #isDrop() */ public void setDropAction(int dropAction) { assureIsDrop(); @@ -440,7 +440,7 @@ public class TransferHandler implements Serializable { * @throws IllegalStateException if this is not a drop * @see #setDropAction * @see #getUserDropAction - * @see #isDrop + * @see #isDrop() */ public int getDropAction() { return dropAction == -1 ? getUserDropAction() : dropAction; @@ -468,7 +468,7 @@ public class TransferHandler implements Serializable { * @throws IllegalStateException if this is not a drop * @see #setDropAction * @see #getDropAction - * @see #isDrop + * @see #isDrop() */ public int getUserDropAction() { assureIsDrop(); @@ -501,7 +501,7 @@ public class TransferHandler implements Serializable { * * @return the drag source's supported drop actions * @throws IllegalStateException if this is not a drop - * @see #isDrop + * @see #isDrop() */ public int getSourceDropActions() { assureIsDrop(); diff --git a/jdk/src/share/classes/javax/swing/event/InternalFrameAdapter.java b/jdk/src/share/classes/javax/swing/event/InternalFrameAdapter.java index 071942e8ca7..47ed2c69c95 100644 --- a/jdk/src/share/classes/javax/swing/event/InternalFrameAdapter.java +++ b/jdk/src/share/classes/javax/swing/event/InternalFrameAdapter.java @@ -32,8 +32,7 @@ package javax.swing.event; * equivalent to the WindowAdapter class in the AWT. *

    * See How to Write an Internal Frame Listener - * in The Java Tutorial and - * The Java Class Libraries (update) + * in The Java Tutorial * * @see InternalFrameEvent * @see InternalFrameListener diff --git a/jdk/src/share/classes/javax/swing/event/InternalFrameListener.java b/jdk/src/share/classes/javax/swing/event/InternalFrameListener.java index 22258be8b8b..c156767725f 100644 --- a/jdk/src/share/classes/javax/swing/event/InternalFrameListener.java +++ b/jdk/src/share/classes/javax/swing/event/InternalFrameListener.java @@ -33,9 +33,7 @@ import java.util.EventListener; * in the AWT. *

    * See How to Write an Internal Frame Listener - * in The Java Tutorial and - * The Java Class Libraries (update) - * for further documentation. + * in The Java Tutorial for further documentation. * * @see java.awt.event.WindowListener * diff --git a/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html b/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html index c86476b19c4..5160494f750 100644 --- a/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html +++ b/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html @@ -66,7 +66,7 @@ This document has the following sections: Before reading further, you should be familiar with the concept of pluggable look and feels. For basic information, see -Choosing the Look and Feel, +How to Set the Look and Feel, a section in The Java Tutorial. For architectural details, you can read diff --git a/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html b/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html index f5f66a2d2a1..dfb99f4ef50 100644 --- a/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html +++ b/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html @@ -91,7 +91,7 @@ div.example { 

     <!ELEMENT style (property | defaultsProperty | state | font | graphicsUtils |
-                 insets | painter | imagePainter | opaque | (%beansPersistance;) |
+                 insets | painter | imagePainter | opaque | (%beansPersistance;) |
                  imageIcon)*>
 <!ATTLIST style
           id              ID          #IMPLIED
@@ -250,8 +250,8 @@ div.example {
     
    
       Defines the font for the current state,
       or style. You must
-      specify either an idref or a
-      name and size.
+      specify either an idref or a
+      name and size.
     
    
     
    
       The following example creates a style with a Font of
@@ -797,7 +797,7 @@ div.example {
           path                  CDATA          #REQUIRED
           sourceInsets          CDATA          #IMPLIED
           destinationInsets     CDATA          #IMPLIED
-          paintCenter           (true|false)   "true"
+          paintCenter           (true|false)   "true"
           stretch               (true|false)   "true"
           center                (true|false)   "false"
 >
diff --git a/jdk/src/share/classes/javax/swing/text/AsyncBoxView.java b/jdk/src/share/classes/javax/swing/text/AsyncBoxView.java
index 00cd059cc23..ab3f9c34d1e 100644
--- a/jdk/src/share/classes/javax/swing/text/AsyncBoxView.java
+++ b/jdk/src/share/classes/javax/swing/text/AsyncBoxView.java
@@ -384,7 +384,7 @@ public class AsyncBoxView extends View {
 
     /**
      * Loads all of the children to initialize the view.
-     * This is called by the setParent
+     * This is called by the {@link #setParent setParent}
      * method.  Subclasses can reimplement this to initialize
      * their child views in a different manner.  The default
      * implementation creates a child view for each
diff --git a/jdk/src/share/classes/javax/swing/text/DefaultCaret.java b/jdk/src/share/classes/javax/swing/text/DefaultCaret.java
index 7a3a2807bbb..b51cd4012c8 100644
--- a/jdk/src/share/classes/javax/swing/text/DefaultCaret.java
+++ b/jdk/src/share/classes/javax/swing/text/DefaultCaret.java
@@ -70,7 +70,7 @@ import sun.swing.SwingUtilities2;
  * will render a solid color as specified in the associated text component
  * in the SelectionColor property.  This can easily be changed
  * by reimplementing the
- * getSelectionHighlighter
+ * {@link #getSelectionPainter getSelectionPainter}
  * method.
  * 
    
  * A customized caret appearance can be achieved by reimplementing
diff --git a/jdk/src/share/classes/javax/swing/text/TableView.java b/jdk/src/share/classes/javax/swing/text/TableView.java
index 3c15ba0f41d..bab545c7af5 100644
--- a/jdk/src/share/classes/javax/swing/text/TableView.java
+++ b/jdk/src/share/classes/javax/swing/text/TableView.java
@@ -315,7 +315,7 @@ public abstract class TableView extends BoxView {
      * updated along the minor axis.
      * 
    
      * This is implemented to call the
-     * layoutColumns method, and then
+     * {@link #layoutColumns layoutColumns} method, and then
      * forward to the superclass to actually carry out the layout
      * of the tables rows.
      *
diff --git a/jdk/src/share/classes/javax/swing/text/View.java b/jdk/src/share/classes/javax/swing/text/View.java
index 369907d2e63..60900c03ea6 100644
--- a/jdk/src/share/classes/javax/swing/text/View.java
+++ b/jdk/src/share/classes/javax/swing/text/View.java
@@ -117,7 +117,7 @@ A view has the following responsibilities:
     what it is prepared to deal with.
     
  • The coordinate system is the same as the hosting Component
     (i.e. the Component returned by the
-    getContainer method).
+    {@link #getContainer getContainer} method).
     This means a child view lives in the same coordinate system as the parent
     view unless the parent has explicitly changed the coordinate system.
     To schedule itself to be repainted a view can call repaint on the hosting
@@ -180,9 +180,9 @@ A view has the following responsibilities:
     starting from the root of the view hierarchy.
     The methods for doing this are:
     
     
    
 
@@ -670,15 +670,15 @@ public abstract class View implements SwingConstants {
      * spread out into the following calls that subclasses can
      * reimplement:
      * 
      
-     * 
    1. updateChildren is called
+     * 
    2. {@link #updateChildren updateChildren} is called
      * if there were any changes to the element this view is
      * responsible for.  If this view has child views that are
      * represent the child elements, then this method should do
      * whatever is necessary to make sure the child views correctly
      * represent the model.
-     * 
    3. forwardUpdate is called
+     * 
    4. {@link #forwardUpdate forwardUpdate} is called
      * to forward the DocumentEvent to the appropriate child views.
-     * 
    5. updateLayout is called to
+     * 
    6. {@link #updateLayout updateLayout} is called to
      * give the view a chance to either repair its layout, to reschedule
      * layout, or do nothing.
      * 
    
@@ -711,15 +711,15 @@ public abstract class View implements SwingConstants {
      * spread out into the following calls that subclasses can
      * reimplement:
      * 
      
-     * 
    1. updateChildren is called
+     * 
    2. {@link #updateChildren updateChildren} is called
      * if there were any changes to the element this view is
      * responsible for.  If this view has child views that are
      * represent the child elements, then this method should do
      * whatever is necessary to make sure the child views correctly
      * represent the model.
-     * 
    3. forwardUpdate is called
+     * 
    4. {@link #forwardUpdate forwardUpdate} is called
      * to forward the DocumentEvent to the appropriate child views.
-     * 
    5. updateLayout is called to
+     * 
    6. {@link #updateLayout updateLayout} is called to
      * give the view a chance to either repair its layout, to reschedule
      * layout, or do nothing.
      * 
    
@@ -752,15 +752,15 @@ public abstract class View implements SwingConstants {
      * spread out into the following calls that subclasses can
      * reimplement:
      * 
      
-     * 
    1. updateChildren is called
+     * 
    2. {@link #updateChildren updateChildren} is called
      * if there were any changes to the element this view is
      * responsible for.  If this view has child views that are
      * represent the child elements, then this method should do
      * whatever is necessary to make sure the child views correctly
      * represent the model.
-     * 
    3. forwardUpdate is called
+     * 
    4. {@link #forwardUpdate forwardUpdate} is called
      * to forward the DocumentEvent to the appropriate child views.
-     * 
    5. updateLayout is called to
+     * 
    6. {@link #updateLayout updateLayout} is called to
      * give the view a chance to either repair its layout, to reschedule
      * layout, or do nothing.
      * 
    
@@ -1186,7 +1186,7 @@ public abstract class View implements SwingConstants {
      * simply messages the view with a call to insertUpdate,
      * removeUpdate, or changedUpdate depending
      * upon the type of the event.  This is called by
-     * forwardUpdate to forward
+     * {@link #forwardUpdate forwardUpdate} to forward
      * the event to children that need it.
      *
      * @param v the child view to forward the event to
diff --git a/jdk/src/share/classes/javax/swing/text/html/HTMLEditorKit.java b/jdk/src/share/classes/javax/swing/text/html/HTMLEditorKit.java
index f9642c7bdd7..1c5275e77a3 100644
--- a/jdk/src/share/classes/javax/swing/text/html/HTMLEditorKit.java
+++ b/jdk/src/share/classes/javax/swing/text/html/HTMLEditorKit.java
@@ -123,7 +123,7 @@ import java.lang.ref.*;
  * to load.  By default, this kit produces documents that will be
  * loaded asynchronously if loaded using JEditorPane.setPage.
  * This is controlled by a property on the document.  The method
- * createDefaultDocument can
+ * {@link #createDefaultDocument createDefaultDocument} can
  * be overriden to change this.  The batching of work is done
  * by the HTMLDocument.HTMLReader class.  The actual
  * work is done by the DefaultStyledDocument and
@@ -558,7 +558,7 @@ public class HTMLEditorKit extends StyledEditorKit implements Accessible {
      * automatically or only FormSubmitEvent is fired.
      * By default it is set to true.
      *
-     * @see #isAutoFormSubmission
+     * @see #isAutoFormSubmission()
      * @see FormSubmitEvent
      * @since 1.5
      */
diff --git a/jdk/src/share/classes/javax/swing/text/html/ParagraphView.java b/jdk/src/share/classes/javax/swing/text/html/ParagraphView.java
index f0ee60ea700..e180e0e112e 100644
--- a/jdk/src/share/classes/javax/swing/text/html/ParagraphView.java
+++ b/jdk/src/share/classes/javax/swing/text/html/ParagraphView.java
@@ -61,7 +61,7 @@ public class ParagraphView extends javax.swing.text.ParagraphView {
      * 
    
      * This is implemented
      * to forward to the superclass as well as call the
-     * setPropertiesFromAttributes
+     * {@link #setPropertiesFromAttributes setPropertiesFromAttributes}
      * method to set the paragraph properties from the css
      * attributes.  The call is made at this time to ensure
      * the ability to resolve upward through the parents
diff --git a/jdk/src/share/classes/javax/swing/text/html/StyleSheet.java b/jdk/src/share/classes/javax/swing/text/html/StyleSheet.java
index 8d5bab21515..e82a5dc8ac9 100644
--- a/jdk/src/share/classes/javax/swing/text/html/StyleSheet.java
+++ b/jdk/src/share/classes/javax/swing/text/html/StyleSheet.java
@@ -51,7 +51,7 @@ import javax.swing.text.*;
  * 
    
  * The primary entry point for HTML View implementations
  * to get their attributes is the
- * getViewAttributes
+ * {@link #getViewAttributes getViewAttributes}
  * method.  This should be implemented to establish the
  * desired policy used to associate attributes with the view.
  * Each HTMLEditorKit (i.e. and therefore each associated