OpenJDK / bsd-port / jdk9 / jdk
changeset 3370:63972a313ca4
6589952: Swing: dead links in API documentation
Reviewed-by: alexp
line wrap: on
line diff
--- a/src/share/classes/javax/swing/AbstractButton.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/AbstractButton.java Tue Jan 11 12:51:33 2011 +0300 @@ -1335,7 +1335,6 @@ * * @param a the button's action * @since 1.3 - * @see <a href="#actions">Actions</a> * @see Action * @see #setAction */
--- a/src/share/classes/javax/swing/JEditorPane.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/JEditorPane.java Tue Jan 11 12:51:33 2011 +0300 @@ -145,8 +145,8 @@ * <li> * One way is to specify the character set as a parameter of the MIME * type. This will be established by a call to the - * <a href="#setContentType">setContentType</a> method. If the content - * is loaded by the <a href="#setPage">setPage</a> 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.
--- a/src/share/classes/javax/swing/SizeSequence.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/SizeSequence.java Tue Jan 11 12:51:33 2011 +0300 @@ -132,7 +132,7 @@ * can use <code>insertEntries</code> or <code>setSizes</code>. * * @see #insertEntries - * @see #setSizes + * @see #setSizes(int[]) */ public SizeSequence() { a = emptyArray;
--- a/src/share/classes/javax/swing/TransferHandler.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/TransferHandler.java Tue Jan 11 12:51:33 2011 +0300 @@ -344,7 +344,7 @@ * * @return the drop location * @throws IllegalStateException if this is not a drop - * @see #isDrop + * @see #isDrop() */ public DropLocation getDropLocation() { assureIsDrop(); @@ -380,7 +380,7 @@ * * @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 @@ * @see #getDropAction * @see #getUserDropAction * @see #getSourceDropActions - * @see #isDrop + * @see #isDrop() */ public void setDropAction(int dropAction) { assureIsDrop(); @@ -440,7 +440,7 @@ * @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 @@ * @throws IllegalStateException if this is not a drop * @see #setDropAction * @see #getDropAction - * @see #isDrop + * @see #isDrop() */ public int getUserDropAction() { assureIsDrop(); @@ -501,7 +501,7 @@ * * @return the drag source's supported drop actions * @throws IllegalStateException if this is not a drop - * @see #isDrop + * @see #isDrop() */ public int getSourceDropActions() { assureIsDrop();
--- a/src/share/classes/javax/swing/event/InternalFrameAdapter.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/event/InternalFrameAdapter.java Tue Jan 11 12:51:33 2011 +0300 @@ -32,8 +32,7 @@ * equivalent to the WindowAdapter class in the AWT. * <p> * See <a href="http://java.sun.com/docs/books/tutorial/uiswing/events/internalframelistener.html">How to Write an Internal Frame Listener</a> - * in <em>The Java Tutorial</em> and - * <a href="http://www.awl.com/cp/javaseries/jcl1_2.html">The Java Class Libraries (update)</a> + * in <em>The Java Tutorial</em> * * @see InternalFrameEvent * @see InternalFrameListener
--- a/src/share/classes/javax/swing/event/InternalFrameListener.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/event/InternalFrameListener.java Tue Jan 11 12:51:33 2011 +0300 @@ -33,9 +33,7 @@ * in the AWT. * <p> * See <a href="http://java.sun.com/docs/books/tutorial/uiswing/events/internalframelistener.html">How to Write an Internal Frame Listener</a> - * in <em>The Java Tutorial</em> and - * <a href="http://www.awl.com/cp/javaseries/jcl1_2.html">The Java Class Libraries (update)</a> - * for further documentation. + * in <em>The Java Tutorial</em> for further documentation. * * @see java.awt.event.WindowListener *
--- a/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html Tue Jan 11 12:51:33 2011 +0300 @@ -66,7 +66,7 @@ Before reading further, you should be familiar with the concept of pluggable look and feels. For basic information, see -<a href="http://java.sun.com/docs/books/tutorial/uiswing/start/swingTour.html#plaf">Choosing the Look and Feel</a>, +<a href="http://java.sun.com/docs/books/tutorial/uiswing/lookandfeel/plaf.html">How to Set the Look and Feel</a>, a section in <em>The Java Tutorial</em>. For architectural details, you can read
--- a/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html Tue Jan 11 12:51:33 2011 +0300 @@ -91,7 +91,7 @@ <div class="dtd-fragment"> <pre class="dtd-fragment"> <!ELEMENT <a name="e.style">style</a> (<a href="#e.property">property</a> | <a href="#e.defaultsProperty">defaultsProperty</a> | <a href="#e.state">state</a> | <a href="#e.font">font</a> | <a href="#e.graphicsUtils">graphicsUtils</a> | - <a href="#e.insets">insets</a> | <a href="#e.painter">painter</a> | <a href="#e.imagePainter">imagePainter</a> | <a href="#e.opaque">opaque</a> | (<a href="#beansPersistance">%beansPersistance;</a>) | + <a href="#e.insets">insets</a> | <a href="#e.painter">painter</a> | <a href="#e.imagePainter">imagePainter</a> | <a href="#e.opaque">opaque</a> | (<a href="#ee.beansPersistance">%beansPersistance;</a>) | <a href="#e.imageIcon">imageIcon</a>)*> <!ATTLIST style <a href="#style.id">id</a> ID #IMPLIED @@ -250,8 +250,8 @@ <p> Defines the font for the current <a href="#e.state">state</a>, or <a href="#e.style">style</a>. You must - specify either an <a href="#state.idref">idref</a> or a - <a href="#state.name">name</a> and <a href="#state.size">size</a>. + specify either an <a href="#font.idref">idref</a> or a + <a href="#font.name">name</a> and <a href="#font.size">size</a>. </p> <p> The following example creates a style with a Font of @@ -797,7 +797,7 @@ <a href="#imagePainter.path">path</a> CDATA #REQUIRED <a href="#imagePainter.sourceInsets">sourceInsets</a> CDATA #IMPLIED <a href="#imagePainter.destinationInsets">destinationInsets</a> CDATA #IMPLIED - <a href="#imagePainter.paintCenter">paintCenter</a> (true|false) "true" + <a href="#imagePainter.painterCenter">paintCenter</a> (true|false) "true" <a href="#imagePainter.stretch">stretch</a> (true|false) "true" <a href="#imagePainter.center">center</a> (true|false) "false" >
--- a/src/share/classes/javax/swing/text/AsyncBoxView.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/text/AsyncBoxView.java Tue Jan 11 12:51:33 2011 +0300 @@ -384,7 +384,7 @@ /** * Loads all of the children to initialize the view. - * This is called by the <a href="#setParent">setParent</a> + * 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
--- a/src/share/classes/javax/swing/text/DefaultCaret.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/text/DefaultCaret.java Tue Jan 11 12:51:33 2011 +0300 @@ -70,7 +70,7 @@ * will render a solid color as specified in the associated text component * in the <code>SelectionColor</code> property. This can easily be changed * by reimplementing the - * <a href="#getSelectionHighlighter">getSelectionHighlighter</a> + * {@link #getSelectionPainter getSelectionPainter} * method. * <p> * A customized caret appearance can be achieved by reimplementing
--- a/src/share/classes/javax/swing/text/TableView.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/text/TableView.java Tue Jan 11 12:51:33 2011 +0300 @@ -315,7 +315,7 @@ * updated along the minor axis. * <p> * This is implemented to call the - * <a href="#layoutColumns">layoutColumns</a> method, and then + * {@link #layoutColumns layoutColumns} method, and then * forward to the superclass to actually carry out the layout * of the tables rows. *
--- a/src/share/classes/javax/swing/text/View.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/text/View.java Tue Jan 11 12:51:33 2011 +0300 @@ -117,7 +117,7 @@ what it is prepared to deal with. <li>The coordinate system is the same as the hosting <code>Component</code> (i.e. the <code>Component</code> returned by the - <a href="#getContainer">getContainer</a> 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 @@ starting from the root of the view hierarchy. The methods for doing this are: <ul> - <li><a href="#insertUpdate">insertUpdate</a> - <li><a href="#removeUpdate">removeUpdate</a> - <li><a href="#changedUpdate">changedUpdate</a> + <li>{@link #insertUpdate insertUpdate} + <li>{@link #removeUpdate removeUpdate} + <li>{@link #changedUpdate changedUpdate} </ul> <p> </dl> @@ -670,15 +670,15 @@ * spread out into the following calls that subclasses can * reimplement: * <ol> - * <li><a href="#updateChildren">updateChildren</a> is called + * <li>{@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. - * <li><a href="#forwardUpdate">forwardUpdate</a> is called + * <li>{@link #forwardUpdate forwardUpdate} is called * to forward the DocumentEvent to the appropriate child views. - * <li><a href="#updateLayout">updateLayout</a> is called to + * <li>{@link #updateLayout updateLayout} is called to * give the view a chance to either repair its layout, to reschedule * layout, or do nothing. * </ol> @@ -711,15 +711,15 @@ * spread out into the following calls that subclasses can * reimplement: * <ol> - * <li><a href="#updateChildren">updateChildren</a> is called + * <li>{@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. - * <li><a href="#forwardUpdate">forwardUpdate</a> is called + * <li>{@link #forwardUpdate forwardUpdate} is called * to forward the DocumentEvent to the appropriate child views. - * <li><a href="#updateLayout">updateLayout</a> is called to + * <li>{@link #updateLayout updateLayout} is called to * give the view a chance to either repair its layout, to reschedule * layout, or do nothing. * </ol> @@ -752,15 +752,15 @@ * spread out into the following calls that subclasses can * reimplement: * <ol> - * <li><a href="#updateChildren">updateChildren</a> is called + * <li>{@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. - * <li><a href="#forwardUpdate">forwardUpdate</a> is called + * <li>{@link #forwardUpdate forwardUpdate} is called * to forward the DocumentEvent to the appropriate child views. - * <li><a href="#updateLayout">updateLayout</a> is called to + * <li>{@link #updateLayout updateLayout} is called to * give the view a chance to either repair its layout, to reschedule * layout, or do nothing. * </ol> @@ -1186,7 +1186,7 @@ * simply messages the view with a call to <code>insertUpdate</code>, * <code>removeUpdate</code>, or <code>changedUpdate</code> depending * upon the type of the event. This is called by - * <a href="#forwardUpdate">forwardUpdate</a> to forward + * {@link #forwardUpdate forwardUpdate} to forward * the event to children that need it. * * @param v the child view to forward the event to
--- a/src/share/classes/javax/swing/text/html/HTMLEditorKit.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/text/html/HTMLEditorKit.java Tue Jan 11 12:51:33 2011 +0300 @@ -123,7 +123,7 @@ * to load. By default, this kit produces documents that will be * loaded asynchronously if loaded using <code>JEditorPane.setPage</code>. * This is controlled by a property on the document. The method - * <a href="#createDefaultDocument">createDefaultDocument</a> can + * {@link #createDefaultDocument createDefaultDocument} can * be overriden to change this. The batching of work is done * by the <code>HTMLDocument.HTMLReader</code> class. The actual * work is done by the <code>DefaultStyledDocument</code> and @@ -558,7 +558,7 @@ * automatically or only <code>FormSubmitEvent</code> is fired. * By default it is set to true. * - * @see #isAutoFormSubmission + * @see #isAutoFormSubmission() * @see FormSubmitEvent * @since 1.5 */
--- a/src/share/classes/javax/swing/text/html/ParagraphView.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/text/html/ParagraphView.java Tue Jan 11 12:51:33 2011 +0300 @@ -61,7 +61,7 @@ * <p> * This is implemented * to forward to the superclass as well as call the - * <a href="#setPropertiesFromAttributes">setPropertiesFromAttributes</a> + * {@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
--- a/src/share/classes/javax/swing/text/html/StyleSheet.java Tue Jan 04 23:41:13 2011 -0800 +++ b/src/share/classes/javax/swing/text/html/StyleSheet.java Tue Jan 11 12:51:33 2011 +0300 @@ -51,7 +51,7 @@ * <p> * The primary entry point for HTML View implementations * to get their attributes is the - * <a href="#getViewAttributes">getViewAttributes</a> + * {@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