Mostly superficial/aesthetic improvements to the doc build and javadoc content: - The doc build now produces no warnings (fixed up broken links, etc.) - @deprecated javadoc comments changed to begin with capital letters, which looks a lot better in the rendered javadoc - Shortened the text shown for some method @links because the overloaded signature create monster-huge hyperlinks in javadoc html - Reworded a few things related to deprecations for GWT 1.6 Review by: scottb (TBR) git-svn-id: https://google-web-toolkit.googlecode.com/svn/releases/1.6@4700 8db76d5a-ed1c-0410-87a9-c151d255dfc7
diff --git a/dev/core/src/com/google/gwt/core/ext/typeinfo/JParameterizedType.java b/dev/core/src/com/google/gwt/core/ext/typeinfo/JParameterizedType.java index 994a427..19d59ee 100644 --- a/dev/core/src/com/google/gwt/core/ext/typeinfo/JParameterizedType.java +++ b/dev/core/src/com/google/gwt/core/ext/typeinfo/JParameterizedType.java
@@ -184,7 +184,7 @@ } /** - * @deprecated see {@link #getQualifiedSourceName()} + * @deprecated See {@link #getQualifiedSourceName()} */ @Deprecated public String getNonParameterizedQualifiedSourceName() {
diff --git a/dev/core/src/com/google/gwt/dev/GWTCompiler.java b/dev/core/src/com/google/gwt/dev/GWTCompiler.java index 5cbe5cd..7cdcf18 100644 --- a/dev/core/src/com/google/gwt/dev/GWTCompiler.java +++ b/dev/core/src/com/google/gwt/dev/GWTCompiler.java
@@ -38,7 +38,7 @@ /** * The main executable entry point for the GWT Java to JavaScript compiler. * - * @deprecated use {@link Compiler} instead + * @deprecated Use {@link Compiler} instead */ @Deprecated public class GWTCompiler {
diff --git a/dev/core/src/com/google/gwt/dev/GWTShell.java b/dev/core/src/com/google/gwt/dev/GWTShell.java index e0a510b..05b9b9e 100644 --- a/dev/core/src/com/google/gwt/dev/GWTShell.java +++ b/dev/core/src/com/google/gwt/dev/GWTShell.java
@@ -33,7 +33,7 @@ /** * The main executable class for the hosted mode shell. * - * @deprecated use {@link HostedMode} instead + * @deprecated Use {@link HostedMode} instead */ @Deprecated public class GWTShell extends SwtHostedModeBase {
diff --git a/dev/core/src/com/google/gwt/dev/shell/BrowserWidgetHost.java b/dev/core/src/com/google/gwt/dev/shell/BrowserWidgetHost.java index 74c2175..8e73ae9 100644 --- a/dev/core/src/com/google/gwt/dev/shell/BrowserWidgetHost.java +++ b/dev/core/src/com/google/gwt/dev/shell/BrowserWidgetHost.java
@@ -36,7 +36,7 @@ * * @param modules the names of the modules to compile * @throws UnableToCompleteException - * @deprecated will be removed when legacy shell mode is removed + * @deprecated Will be removed when legacy shell mode is removed */ @Deprecated void compile(String[] modules) throws UnableToCompleteException; @@ -62,7 +62,7 @@ /** * Returns <code>true</code> if running in legacy mode. * - * @deprecated will be removed when legacy shell mode is removed + * @deprecated Will be removed when legacy shell mode is removed */ @Deprecated boolean isLegacyMode();
diff --git a/doc/build.xml b/doc/build.xml index 7241eaa..622d0cb 100644 --- a/doc/build.xml +++ b/doc/build.xml
@@ -120,7 +120,7 @@ <arg value="-classpath" /> <arg pathref="USER_CLASS_PATH" /> <arg value="-sourcepath" /> - <arg path="${gwt.root}/user/super/com/google/gwt/emul" /> + <arg path="${gwt.root}/user/super/com/google/gwt/emul:${gwt.root}/dev/core/super/com/google/gwt/dev/jjs/intrinsic" /> <arg value="-packages" /> <arg value="${LANG_PKGS}" /> </java>
diff --git a/user/src/com/google/gwt/benchmarks/client/Benchmark.java b/user/src/com/google/gwt/benchmarks/client/Benchmark.java index 32d69b7..43d7638 100644 --- a/user/src/com/google/gwt/benchmarks/client/Benchmark.java +++ b/user/src/com/google/gwt/benchmarks/client/Benchmark.java
@@ -75,17 +75,15 @@ * <h2>Examples of benchmarking in action</h2> * * <h3>A simple benchmark example</h3> - * {@link com.google.gwt.examples.benchmarks.AllocBenchmark} is a simple example - * of a basic benchmark that doesn't take advantage of most of benchmarking's - * advanced features. + * <code>AllocBenchmark</code> is an example of a basic benchmark that doesn't + * take advantage of most of benchmarking's advanced features. * * {@example com.google.gwt.examples.benchmarks.AllocBenchmark} * * <h3>An advanced benchmark example</h3> - * {@link com.google.gwt.examples.benchmarks.ArrayListBenchmark} is a more - * sophisticated example of benchmarking. It demonstrates the use of - * {@code Setup} and {@code Teardown} test methods, parameterized test methods, - * and time limits. + * <code>ArrayListBenchmark</code> is a more sophisticated example of + * benchmarking. It demonstrates the use of {@code Setup} and {@code Teardown} + * test methods, parameterized test methods, and time limits. * * {@example com.google.gwt.examples.benchmarks.ArrayListBenchmark} */
diff --git a/user/src/com/google/gwt/core/client/GWT.java b/user/src/com/google/gwt/core/client/GWT.java index c20e7ba..a1c5c0b 100644 --- a/user/src/com/google/gwt/core/client/GWT.java +++ b/user/src/com/google/gwt/core/client/GWT.java
@@ -123,7 +123,7 @@ } /** - * @deprecated Use {@link Object#getClass()}, {@link Class#getName()}. + * @deprecated Use {@link Object#getClass()}, {@link Class#getName()} */ @Deprecated public static String getTypeName(Object o) {
diff --git a/user/src/com/google/gwt/core/client/JavaScriptException.java b/user/src/com/google/gwt/core/client/JavaScriptException.java index 8bb9b72..ba1d750 100644 --- a/user/src/com/google/gwt/core/client/JavaScriptException.java +++ b/user/src/com/google/gwt/core/client/JavaScriptException.java
@@ -117,7 +117,7 @@ /** * Used for server-side instantiation during JUnit runs. Exceptions are * manually marshaled through - * {@link com.google.gwt.junit.client.impl.ExceptionWrapper} objects. + * <code>com.google.gwt.junit.client.impl.ExceptionWrapper</code> objects. * * @param message the detail message */
diff --git a/user/src/com/google/gwt/dom/client/Document.java b/user/src/com/google/gwt/dom/client/Document.java index b19540e..4c53f3a 100644 --- a/user/src/com/google/gwt/dom/client/Document.java +++ b/user/src/com/google/gwt/dom/client/Document.java
@@ -574,7 +574,7 @@ * @param shiftKey <code>true</code> if the shift key is depressed * @param metaKey <code>true</code> if the meta key is depressed * @param button the event's button property (values from - * {@link Event#BUTTON_LEFT} et al) + * {@link NativeEvent#BUTTON_LEFT} et al) * @return the event object */ public final NativeEvent createMouseDownEvent(int detail, int screenX, int screenY, @@ -613,7 +613,7 @@ * @param shiftKey <code>true</code> if the shift key is depressed * @param metaKey <code>true</code> if the meta key is depressed * @param button the event's button property (values from - * {@link Event#BUTTON_LEFT} et al) + * {@link NativeEvent#BUTTON_LEFT} et al) * @param relatedTarget the event's related target (only relevant for * mouseover and mouseout events) * @return the event object @@ -640,7 +640,7 @@ * @param shiftKey <code>true</code> if the shift key is depressed * @param metaKey <code>true</code> if the meta key is depressed * @param button the event's button property (values from - * {@link Event#BUTTON_LEFT} et al) + * {@link NativeEvent#BUTTON_LEFT} et al) * @return the event object */ public final NativeEvent createMouseMoveEvent(int detail, int screenX, int screenY, @@ -666,7 +666,7 @@ * @param shiftKey <code>true</code> if the shift key is depressed * @param metaKey <code>true</code> if the meta key is depressed * @param button the event's button property (values from - * {@link Event#BUTTON_LEFT} et al) + * {@link NativeEvent#BUTTON_LEFT} et al) * @param relatedTarget the event's related target * @return the event object */ @@ -694,7 +694,7 @@ * @param shiftKey <code>true</code> if the shift key is depressed * @param metaKey <code>true</code> if the meta key is depressed * @param button the event's button property (values from - * {@link Event#BUTTON_LEFT} et al) + * {@link NativeEvent#BUTTON_LEFT} et al) * @param relatedTarget the event's related target * @return the event object */ @@ -719,7 +719,7 @@ * @param shiftKey <code>true</code> if the shift key is depressed * @param metaKey <code>true</code> if the meta key is depressed * @param button the event's button property (values from - * {@link Event#BUTTON_LEFT} et al) + * {@link NativeEvent#BUTTON_LEFT} et al) * @return the event object */ public final NativeEvent createMouseUpEvent(int detail, int screenX, int screenY,
diff --git a/user/src/com/google/gwt/dom/client/Element.java b/user/src/com/google/gwt/dom/client/Element.java index 0559099..5bcfd0c 100644 --- a/user/src/com/google/gwt/dom/client/Element.java +++ b/user/src/com/google/gwt/dom/client/Element.java
@@ -39,7 +39,8 @@ * Note: Because the browser's normal dispatch mechanism is used, exceptions * thrown from within handlers triggered by this method cannot be caught by * wrapping this method in a try/catch block. Such exceptions will be caught - * by the {@link GWT#setUncaughtExceptionHandler() uncaught exception handler} + * by the + * {@link com.google.gwt.core.client.GWT#setUncaughtExceptionHandler(com.google.gwt.core.client.GWT.UncaughtExceptionHandler) uncaught exception handler} * as usual. * * @param evt the event to be dispatched @@ -72,26 +73,28 @@ * does not have a specified or default value */ public final native String getAttribute(String name) /*-{ - return this.getAttribute(name) || ''; - }-*/; + return this.getAttribute(name) || ''; + }-*/; /** * The class attribute of the element. This attribute has been renamed due to * conflicts with the "class" keyword exposed by many languages. * - * @see <a href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-class">W3C HTML Specification</a> + * @see <a + * href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-class">W3C + * HTML Specification</a> */ public final native String getClassName() /*-{ - return this.className; - }-*/; + return this.className; + }-*/; /** * Specifies the base direction of directionally neutral text and the * directionality of tables. */ public final native String getDir() /*-{ - return this.dir; - }-*/; + return this.dir; + }-*/; /** * Returns a NodeList of all descendant Elements with a given tag name, in the @@ -103,8 +106,8 @@ * @return A list of matching Element nodes */ public final native NodeList<Element> getElementsByTagName(String name) /*-{ - return this.getElementsByTagName(name); - }-*/; + return this.getElementsByTagName(name); + }-*/; /** * The first child of element this element. If there is no such element, this @@ -117,11 +120,13 @@ /** * The element's identifier. * - * @see <a href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-id">W3C HTML Specification</a> + * @see <a + * href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-id">W3C + * HTML Specification</a> */ public final native String getId() /*-{ - return this.id; - }-*/; + return this.id; + }-*/; /** * All of the markup and content within a given element. @@ -141,8 +146,8 @@ * Language code defined in RFC 1766. */ public final native String getLang() /*-{ - return this.lang; - }-*/; + return this.lang; + }-*/; /** * The element immediately following this element. If there is no such @@ -156,39 +161,39 @@ * The height of an element relative to the layout. */ public final native int getOffsetHeight() /*-{ - return this.offsetHeight || 0; - }-*/; + return this.offsetHeight || 0; + }-*/; /** * The number of pixels that the upper left corner of the current element is * offset to the left within the offsetParent node. */ public final native int getOffsetLeft() /*-{ - return this.offsetLeft || 0; - }-*/; + return this.offsetLeft || 0; + }-*/; /** * Returns a reference to the object which is the closest (nearest in the * containment hierarchy) positioned containing element. */ public final native Element getOffsetParent() /*-{ - return this.offsetParent; - }-*/; + return this.offsetParent; + }-*/; /** * The number of pixels that the upper top corner of the current element is * offset to the top within the offsetParent node. */ public final native int getOffsetTop() /*-{ - return this.offsetTop || 0; - }-*/; + return this.offsetTop || 0; + }-*/; /** * The width of an element relative to the layout. */ public final native int getOffsetWidth() /*-{ - return this.offsetWidth || 0; - }-*/; + return this.offsetWidth || 0; + }-*/; /** * The parent element of this element. @@ -204,8 +209,8 @@ * @return the property value */ public final native boolean getPropertyBoolean(String name) /*-{ - return !!this[name]; - }-*/; + return !!this[name]; + }-*/; /** * Gets a double property from this element. @@ -214,8 +219,8 @@ * @return the property value */ public final native double getPropertyDouble(String name) /*-{ - return parseFloat(this[name]) || 0.0; - }-*/; + return parseFloat(this[name]) || 0.0; + }-*/; /** * Gets an integer property from this element. @@ -224,8 +229,8 @@ * @return the property value */ public final native int getPropertyInt(String name) /*-{ - return parseInt(this[name]) || 0; - }-*/; + return parseInt(this[name]) || 0; + }-*/; /** * Gets a property from this element. @@ -234,36 +239,36 @@ * @return the property value */ public final native String getPropertyString(String name) /*-{ - return (this[name] == null) ? null : String(this[name]); - }-*/; + return (this[name] == null) ? null : String(this[name]); + }-*/; /** * The height of the scroll view of an element. */ public final native int getScrollHeight() /*-{ - return this.scrollHeight || 0; - }-*/; + return this.scrollHeight || 0; + }-*/; /** * The number of pixels that an element's content is scrolled to the left. */ public final native int getScrollLeft() /*-{ - return this.scrollLeft || 0; - }-*/; + return this.scrollLeft || 0; + }-*/; /** * The number of pixels that an element's content is scrolled to the top. */ public final native int getScrollTop() /*-{ - return this.scrollTop || 0; - }-*/; + return this.scrollTop || 0; + }-*/; /** * The height of the scroll view of an element. */ public final native int getScrollWidth() /*-{ - return this.scrollWidth || 0; - }-*/; + return this.scrollWidth || 0; + }-*/; /** * Gets a string representation of this element (as outer HTML). @@ -281,22 +286,22 @@ * Gets this element's {@link Style} object. */ public final native Style getStyle() /*-{ - return this.style; - }-*/; + return this.style; + }-*/; /** * The name of the element. */ public final native String getTagName() /*-{ - return this.tagName; - }-*/; + return this.tagName; + }-*/; /** * The element's advisory title. */ public final native String getTitle() /*-{ - return this.title; - }-*/; + return this.title; + }-*/; /** * Determine whether an element is equal to, or the child of, this element. @@ -312,8 +317,8 @@ * Removes an attribute by name. */ public final native void removeAttribute(String name) /*-{ - this.removeAttribute(name); - }-*/; + this.removeAttribute(name); + }-*/; /** * Scrolls this element into view. @@ -337,42 +342,46 @@ * @param value Value to set in string form */ public final native void setAttribute(String name, String value) /*-{ - this.setAttribute(name, value); - }-*/; + this.setAttribute(name, value); + }-*/; /** * The class attribute of the element. This attribute has been renamed due to * conflicts with the "class" keyword exposed by many languages. * - * @see <a href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-class">W3C HTML Specification</a> + * @see <a + * href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-class">W3C + * HTML Specification</a> */ public final native void setClassName(String className) /*-{ - this.className = className; - }-*/; + this.className = className; + }-*/; /** * Specifies the base direction of directionally neutral text and the * directionality of tables. */ public final native void setDir(String dir) /*-{ - this.dir = dir; - }-*/; + this.dir = dir; + }-*/; /** * The element's identifier. * - * @see <a href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-id">W3C HTML Specification</a> + * @see <a + * href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/global.html#adef-id">W3C + * HTML Specification</a> */ public final native void setId(String id) /*-{ - this.id = id; - }-*/; + this.id = id; + }-*/; /** * All of the markup and content within a given element. */ public final native void setInnerHTML(String html) /*-{ - this.innerHTML = html || ''; - }-*/; + this.innerHTML = html || ''; + }-*/; /** * The text between the start and end tags of the object. @@ -385,8 +394,8 @@ * Language code defined in RFC 1766. */ public final native void setLang(String lang) /*-{ - this.lang = lang; - }-*/; + this.lang = lang; + }-*/; /** * Sets a boolean property on this element. @@ -395,8 +404,8 @@ * @param value the new property value */ public final native void setPropertyBoolean(String name, boolean value) /*-{ - this[name] = value; - }-*/; + this[name] = value; + }-*/; /** * Sets a double property on this element. @@ -405,8 +414,8 @@ * @param value the new property value */ public final native void setPropertyDouble(String name, double value) /*-{ - this[name] = value; - }-*/; + this[name] = value; + }-*/; /** * Sets an integer property on this element. @@ -415,8 +424,8 @@ * @param value the new property value */ public final native void setPropertyInt(String name, int value) /*-{ - this[name] = value; - }-*/; + this[name] = value; + }-*/; /** * Sets a property on this element. @@ -425,29 +434,29 @@ * @param value the new property value */ public final native void setPropertyString(String name, String value) /*-{ - this[name] = value; - }-*/; + this[name] = value; + }-*/; /** * The number of pixels that an element's content is scrolled to the left. */ public final native void setScrollLeft(int scrollLeft) /*-{ - this.scrollLeft = scrollLeft; - }-*/; + this.scrollLeft = scrollLeft; + }-*/; /** * The number of pixels that an element's content is scrolled to the top. */ public final native void setScrollTop(int scrollTop) /*-{ - this.scrollTop = scrollTop; - }-*/; + this.scrollTop = scrollTop; + }-*/; /** * The element's advisory title. */ public final native void setTitle(String title) /*-{ - // Setting the title to null results in the string "null" being displayed - // on some browsers. - this.title = title || ''; - }-*/; + // Setting the title to null results in the string "null" being displayed + // on some browsers. + this.title = title || ''; + }-*/; }
diff --git a/user/src/com/google/gwt/event/logical/shared/HasHandlers.java b/user/src/com/google/gwt/event/logical/shared/HasHandlers.java index f16eb52..62b6912 100644 --- a/user/src/com/google/gwt/event/logical/shared/HasHandlers.java +++ b/user/src/com/google/gwt/event/logical/shared/HasHandlers.java
@@ -21,7 +21,7 @@ * HasHandlers has moved to com.google.gwt.event.shared.HasHandlers. This * interface will be removed before the first GWT 1.6 milestone. * - * @deprecated use com.google.gwt.event.shared.HasHandlers instead. + * @deprecated Use {@link com.google.gwt.event.shared.HasHandlers} instead */ @Deprecated public interface HasHandlers extends com.google.gwt.event.shared.HasHandlers {
diff --git a/user/src/com/google/gwt/event/shared/HandlerManager.java b/user/src/com/google/gwt/event/shared/HandlerManager.java index f180f96..db8617e 100644 --- a/user/src/com/google/gwt/event/shared/HandlerManager.java +++ b/user/src/com/google/gwt/event/shared/HandlerManager.java
@@ -236,9 +236,10 @@ * * @param type the event type * @param handler the handler - * @deprecated We currently believe this method will not be needed after - * listeners are removed in GWT 2.0. If you have a use case for it - * after that time, please add your comments to gwt issue 3102 + * @deprecated This method is likely to be removed along with "listener" + * interfaces in a future release. If you have a reason it should + * be retained beyond that time, please add your comments to GWT + * <a href="http://code.google.com/p/google-web-toolkit/issues/detail?id=3102">issue 3102</a> */ @Deprecated public <H extends EventHandler> void removeHandler(GwtEvent.Type<H> type,
diff --git a/user/src/com/google/gwt/i18n/client/NumberFormat.java b/user/src/com/google/gwt/i18n/client/NumberFormat.java index 56c2dda..a589e86 100644 --- a/user/src/com/google/gwt/i18n/client/NumberFormat.java +++ b/user/src/com/google/gwt/i18n/client/NumberFormat.java
@@ -473,7 +473,6 @@ * @param pattern pattern that specify how number should be formatted * @param cdata currency data that should be used * @param userSuppliedPattern true if the pattern was supplied by the user - * @skip */ protected NumberFormat(NumberConstants numberConstants, String pattern, CurrencyData cdata, boolean userSuppliedPattern) { @@ -500,7 +499,6 @@ * @param pattern pattern that specify how number should be formatted * @param cdata currency data that should be used * @param userSuppliedPattern true if the pattern was supplied by the user - * @skip */ protected NumberFormat(String pattern, CurrencyData cdata, boolean userSuppliedPattern) { this(defaultNumberConstants, pattern, cdata, userSuppliedPattern);
diff --git a/user/src/com/google/gwt/json/client/JSONNumber.java b/user/src/com/google/gwt/json/client/JSONNumber.java index 2bd6682..1b9eea3 100644 --- a/user/src/com/google/gwt/json/client/JSONNumber.java +++ b/user/src/com/google/gwt/json/client/JSONNumber.java
@@ -57,7 +57,7 @@ /** * Gets the double value this JSONNumber represents. * - * @deprecated use {@link #doubleValue()} + * @deprecated See {@link #doubleValue()} */ @Deprecated public double getValue() {
diff --git a/user/src/com/google/gwt/junit/client/GWTTestCase.java b/user/src/com/google/gwt/junit/client/GWTTestCase.java index 2158542..9c8fa25 100644 --- a/user/src/com/google/gwt/junit/client/GWTTestCase.java +++ b/user/src/com/google/gwt/junit/client/GWTTestCase.java
@@ -89,9 +89,9 @@ * Clears the accumulated list of checkpoint messages. * * @see #addCheckpoint(String) - * @deprecated This method will be removed when web mode supports stack + * @deprecated This method will be removed if and when web mode supports stack * traces. It can be useful for debugging web mode failures, but - * production code should not depend on it. + * production code should not depend on it */ @Deprecated public final void clearCheckpoints() { @@ -103,9 +103,9 @@ * * @return a non-<code>null</code> array of checkpoint messages * @see #addCheckpoint(String) - * @deprecated This method will be removed when web mode supports stack + * @deprecated This method will be removed if and when web mode supports stack * traces. It can be useful for debugging web mode failures, but - * production code should not depend on it. + * production code should not depend on it */ @Deprecated public final String[] getCheckpoints() {
diff --git a/user/src/com/google/gwt/user/client/rpc/SerializableException.java b/user/src/com/google/gwt/user/client/rpc/SerializableException.java index eec580d..ab32851 100644 --- a/user/src/com/google/gwt/user/client/rpc/SerializableException.java +++ b/user/src/com/google/gwt/user/client/rpc/SerializableException.java
@@ -21,7 +21,7 @@ * * @deprecated As of GWT 1.5, {@link Exception} implements * {@link java.io.Serializable Serializable} and can be used in place - * of this class. + * of this class */ @Deprecated public class SerializableException extends Exception implements IsSerializable {
diff --git a/user/src/com/google/gwt/user/client/ui/Button.java b/user/src/com/google/gwt/user/client/ui/Button.java index 3eb189f..0f7863c 100644 --- a/user/src/com/google/gwt/user/client/ui/Button.java +++ b/user/src/com/google/gwt/user/client/ui/Button.java
@@ -95,7 +95,7 @@ * * @param html the HTML caption * @param listener the click listener - * @deprecated use {@link Button#Button(String, ClickHandler)} instead + * @deprecated Use {@link Button#Button(String, ClickHandler)} instead */ @Deprecated public Button(String html, ClickListener listener) {
diff --git a/user/src/com/google/gwt/user/client/ui/ChangeListener.java b/user/src/com/google/gwt/user/client/ui/ChangeListener.java index c93a7e1..d1b4ebf 100644 --- a/user/src/com/google/gwt/user/client/ui/ChangeListener.java +++ b/user/src/com/google/gwt/user/client/ui/ChangeListener.java
@@ -20,10 +20,12 @@ /** * Event listener interface for 'change' events. * - * @deprecated we have now separated dom and logical change events. Use {@link com.google.gwt.event.dom.client.ChangeHandler} if the - * change listener was triggered by a dom change event or - * {@link com.google.gwt.event.logical.shared.ValueChangeHandler} if - * it was based on a logical event + * @deprecated As of GWT 1.6, DOM and logical change events are separate. Use + * {@link com.google.gwt.event.dom.client.ChangeHandler} for changes + * triggered by a DOM-based change event and + * {@link com.google.gwt.event.logical.shared.ValueChangeHandler} + * for changes resulting from a logical event such as a method call + * that changes state */ @Deprecated public interface ChangeListener extends EventListener { @@ -34,11 +36,7 @@ * * @param sender the widget that has changed * - * @deprecated use - * {@link com.google.gwt.event.dom.client.ChangeHandler#onChange(com.google.gwt.event.dom.client.ChangeEvent)} - * if the change listener was triggered by a dom change event or - * {@link com.google.gwt.event.logical.shared.ValueChangeHandler#onValueChange(com.google.gwt.event.logical.shared.ValueChangeEvent)} - * if it was based on a logical event + * @deprecated See the deprecation message on the enclosing interface for details. */ @Deprecated void onChange(Widget sender);
diff --git a/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java b/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java index c0504e2..b095bac 100644 --- a/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/ChangeListenerCollection.java
@@ -22,11 +22,11 @@ * subclass of {@link ArrayList} assumes that all objects added to it will be of * type {@link com.google.gwt.user.client.ui.ChangeListener}. * - * @deprecated use <code>addDomHandler(myHandler, ChangeEvent.getType())</code> - * for dom based change events and use - * <code>addHandler(myHandler, ValueChangeEvent.getType())</code> - * for logical change events instead to manage handlers for your - * widget + * @deprecated As of GWT 1.6, to manage handlers for your widget, call + * <code>{@link Widget#addDomHandler(com.google.gwt.event.shared.EventHandler, com.google.gwt.event.dom.client.DomEvent.Type) addDomHandler}(myHandler, ChangeEvent.getType())</code> + * for DOM-based change events, and call + * <code>{@link Widget#addHandler(com.google.gwt.event.shared.EventHandler, com.google.gwt.event.shared.GwtEvent.Type) addHandler}(myHandler, ValueChangeEvent.getType())</code> + * for logical change events */ @Deprecated public class ChangeListenerCollection extends ArrayList<ChangeListener> {
diff --git a/user/src/com/google/gwt/user/client/ui/CheckBox.java b/user/src/com/google/gwt/user/client/ui/CheckBox.java index 40386ff..549107c 100644 --- a/user/src/com/google/gwt/user/client/ui/CheckBox.java +++ b/user/src/com/google/gwt/user/client/ui/CheckBox.java
@@ -134,8 +134,6 @@ * <p> * Don't confuse this with {@link #getValue}, which returns true or false if * the widget is checked. - * - * @return */ public String getFormValue() { return inputElem.getValue(); @@ -182,7 +180,7 @@ * Determines whether this check box is currently checked. * * @return <code>true</code> if the check box is checked - * @deprecated use {@link #getValue} instead + * @deprecated Use {@link #getValue} instead */ @Deprecated public boolean isChecked() { @@ -278,8 +276,8 @@ * input element wrapped by this widget. For access to that property, see * {@link #setFormValue(String)} * - * @param value true to check, false to uncheck. Must not be null. - * @thows IllegalArgumentException if value is null + * @param value true to check, false to uncheck; must not be null + * @throws IllegalArgumentException if value is null */ public void setValue(Boolean value) { setValue(value, false); @@ -293,10 +291,10 @@ * input element wrapped by this widget. For access to that property, see * {@link #setFormValue(String)} * - * @param value true to check, false to uncheck. Must not be null. + * @param value true to check, false to uncheck; must not be null * @param fireEvents If true, and value has changed, fire a * {@link ValueChangeEvent} - * @thows IllegalArgumentException if value is null + * @throws IllegalArgumentException if value is null */ public void setValue(Boolean value, boolean fireEvents) { if (value == null) {
diff --git a/user/src/com/google/gwt/user/client/ui/ClickListener.java b/user/src/com/google/gwt/user/client/ui/ClickListener.java index 1c5e15d..6a2e222 100644 --- a/user/src/com/google/gwt/user/client/ui/ClickListener.java +++ b/user/src/com/google/gwt/user/client/ui/ClickListener.java
@@ -20,7 +20,7 @@ /** * Event listener interface for click events. * - * @deprecated use {@link com.google.gwt.event.dom.client.ClickHandler} instead + * @deprecated Use {@link com.google.gwt.event.dom.client.ClickHandler} instead */ @Deprecated public interface ClickListener extends EventListener {
diff --git a/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java b/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java index 9d13313..40c6ba0 100644 --- a/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/ClickListenerCollection.java
@@ -22,7 +22,8 @@ * subclass of {@link ArrayList} assumes that all objects added to it will be of * type {@link com.google.gwt.user.client.ui.ClickListener}. * - * @deprecated use <code>addDomHandler(myHandler, ClickEvent.getType())</code> + * @deprecated As of GWT 1.6, call + * <code>{@link Widget#addDomHandler(com.google.gwt.event.shared.EventHandler, com.google.gwt.event.dom.client.DomEvent.Type) addDomHandler}(myHandler, ClickEvent.getType())</code> * to manage handlers for your widget instead */ @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/Composite.java b/user/src/com/google/gwt/user/client/ui/Composite.java index a628c78..4f2c795 100644 --- a/user/src/com/google/gwt/user/client/ui/Composite.java +++ b/user/src/com/google/gwt/user/client/ui/Composite.java
@@ -127,8 +127,7 @@ * This method was for initializing the Widget to be wrapped by this * Composite, but has been deprecated in favor of {@link #initWidget(Widget)}. * - * @deprecated this method is deprecated, and will be removed (use - * {@link #initWidget(Widget)} instead) + * @deprecated Use {@link #initWidget(Widget)} instead */ @Deprecated protected void setWidget(Widget widget) {
diff --git a/user/src/com/google/gwt/user/client/ui/DelegatingChangeListenerCollection.java b/user/src/com/google/gwt/user/client/ui/DelegatingChangeListenerCollection.java index c32c990..3cf91bc 100644 --- a/user/src/com/google/gwt/user/client/ui/DelegatingChangeListenerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/DelegatingChangeListenerCollection.java
@@ -39,7 +39,7 @@ * } *</pre> * - * @deprecated use <code>Widget#delegateEvent</code> instead + * @deprecated Use {@link Widget#delegateEvent Widget.delegateEvent} instead */ @Deprecated public class DelegatingChangeListenerCollection extends
diff --git a/user/src/com/google/gwt/user/client/ui/DelegatingClickListenerCollection.java b/user/src/com/google/gwt/user/client/ui/DelegatingClickListenerCollection.java index f6feae8..0374d2c 100644 --- a/user/src/com/google/gwt/user/client/ui/DelegatingClickListenerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/DelegatingClickListenerCollection.java
@@ -39,7 +39,7 @@ * } *</pre> * - * @deprecated use <code>Widget#delegateEvent</code> instead + * @deprecated Use <code>Widget#delegateEvent</code> instead */ @Deprecated public class DelegatingClickListenerCollection extends ClickListenerCollection
diff --git a/user/src/com/google/gwt/user/client/ui/DelegatingFocusListenerCollection.java b/user/src/com/google/gwt/user/client/ui/DelegatingFocusListenerCollection.java index 9d26eee..eca071d 100644 --- a/user/src/com/google/gwt/user/client/ui/DelegatingFocusListenerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/DelegatingFocusListenerCollection.java
@@ -39,7 +39,7 @@ * } *</pre> * - * @deprecated use <code>Widget#delegateEvent</code> instead + * @deprecated Use {@link Widget#delegateEvent Widget.delegateEvent} instead */ @Deprecated public class DelegatingFocusListenerCollection extends FocusListenerCollection
diff --git a/user/src/com/google/gwt/user/client/ui/DelegatingKeyboardListenerCollection.java b/user/src/com/google/gwt/user/client/ui/DelegatingKeyboardListenerCollection.java index ccae9d2..38b40cc 100644 --- a/user/src/com/google/gwt/user/client/ui/DelegatingKeyboardListenerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/DelegatingKeyboardListenerCollection.java
@@ -40,7 +40,7 @@ * } *</pre> * - * @deprecated use <code>Widget#delegateEvent</code> instead + * @deprecated Use {@link Widget#delegateEvent Widget.delegateEvent} instead */ @Deprecated public class DelegatingKeyboardListenerCollection extends
diff --git a/user/src/com/google/gwt/user/client/ui/DisclosureEvent.java b/user/src/com/google/gwt/user/client/ui/DisclosureEvent.java index 8488ed5..e19ecfe 100644 --- a/user/src/com/google/gwt/user/client/ui/DisclosureEvent.java +++ b/user/src/com/google/gwt/user/client/ui/DisclosureEvent.java
@@ -20,7 +20,7 @@ /** * Event object containing information about {@link DisclosurePanel} changes. * - * @deprecated use + * @deprecated Use * {@link com.google.gwt.event.logical.shared.CloseEvent} and * {@link com.google.gwt.event.logical.shared.OpenEvent} instead */
diff --git a/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java b/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java index 3145353..8f74daa 100644 --- a/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java +++ b/user/src/com/google/gwt/user/client/ui/DisclosureHandler.java
@@ -20,7 +20,7 @@ /** * Event handler interface for {@link DisclosureEvent}. * - * @deprecated use {@link com.google.gwt.event.logical.shared.CloseHandler} + * @deprecated Use {@link com.google.gwt.event.logical.shared.CloseHandler} * and/or {@link com.google.gwt.event.logical.shared.OpenHandler} * instead * @see DisclosurePanel @@ -31,7 +31,7 @@ * Fired when the panel is closed. * * @param event event representing this action. - * @deprecated use {@link com.google.gwt.event.logical.shared.CloseHandler} + * @deprecated Use {@link com.google.gwt.event.logical.shared.CloseHandler} * instead */ @Deprecated @@ -41,7 +41,7 @@ * Fired when the panel is opened. * * @param event event representing this action. - * @deprecated use {@link com.google.gwt.event.logical.shared.OpenHandler} instead + * @deprecated Use {@link com.google.gwt.event.logical.shared.OpenHandler} instead */ @Deprecated void onOpen(DisclosureEvent event);
diff --git a/user/src/com/google/gwt/user/client/ui/DisclosurePanel.java b/user/src/com/google/gwt/user/client/ui/DisclosurePanel.java index 2c1cf74..621a57f 100644 --- a/user/src/com/google/gwt/user/client/ui/DisclosurePanel.java +++ b/user/src/com/google/gwt/user/client/ui/DisclosurePanel.java
@@ -364,7 +364,7 @@ * notification. * * @param handler the handler to be added (should not be null) - * @deprecated use {@link DisclosurePanel#addOpenHandler(OpenHandler)} and + * @deprecated Use {@link DisclosurePanel#addOpenHandler(OpenHandler)} and * {@link DisclosurePanel#addCloseHandler(CloseHandler)} instead */ @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/FiresDisclosureEvents.java b/user/src/com/google/gwt/user/client/ui/FiresDisclosureEvents.java index b91e4d0..7799054 100644 --- a/user/src/com/google/gwt/user/client/ui/FiresDisclosureEvents.java +++ b/user/src/com/google/gwt/user/client/ui/FiresDisclosureEvents.java
@@ -19,7 +19,7 @@ * A widget that implements this interface fires the events defined by the * {@link DisclosureHandler} interface. * - * @deprecated use {@link com.google.gwt.event.logical.shared.HasOpenHandlers} + * @deprecated Use {@link com.google.gwt.event.logical.shared.HasOpenHandlers} * and {@link com.google.gwt.event.logical.shared.HasCloseHandlers} * instead */ @@ -30,7 +30,7 @@ * Adds a handler interface to receive open events. * * @param handler the handler to add - * @deprecated add an open or close handler to the event source instead + * @deprecated Add an open or close handler to the event source instead */ @Deprecated void addEventHandler(DisclosureHandler handler);
diff --git a/user/src/com/google/gwt/user/client/ui/FiresFormEvents.java b/user/src/com/google/gwt/user/client/ui/FiresFormEvents.java index a99535e..47e1936 100644 --- a/user/src/com/google/gwt/user/client/ui/FiresFormEvents.java +++ b/user/src/com/google/gwt/user/client/ui/FiresFormEvents.java
@@ -19,9 +19,9 @@ * A widget that implements this interface fires the events defined by the * {@link com.google.gwt.user.client.ui.FormHandler} interface. * - * @deprecated Only {@link FormPanel} was expected to use this interface. - * Instead, it now uses {@link FormPanel.SubmitCompleteEvent} and - * {@link SubmitEvent}. + * @deprecated This interface was specific to {@link FormPanel}; it is not generally useful and will be removed in a future version. + * Use {@link FormPanel#addSubmitHandler(com.google.gwt.user.client.ui.FormPanel.SubmitHandler) FormPanel.addSubmitHandler} and + * {@link com.google.gwt.user.client.ui.FormPanel#addSubmitCompleteHandler(com.google.gwt.user.client.ui.FormPanel.SubmitCompleteHandler) FormPanel.addSubmitCompleteHandler} instead */ @Deprecated public interface FiresFormEvents { @@ -29,8 +29,8 @@ /** * Adds a handler interface to receive click events. * - * @deprecated use {@link FormPanel#addSubmitCompleteHandler} and - * {@link FormPanel#addSubmitHandler} instead + * @deprecated Use {@link FormPanel#addSubmitCompleteHandler FormPanel.addSubmitCompleteHandler} and + * {@link FormPanel#addSubmitHandler FormPanel.addSubmitHandler} instead * @param handler the handler interface to add */ @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/FiresSuggestionEvents.java b/user/src/com/google/gwt/user/client/ui/FiresSuggestionEvents.java index 0627a6f..176b136 100644 --- a/user/src/com/google/gwt/user/client/ui/FiresSuggestionEvents.java +++ b/user/src/com/google/gwt/user/client/ui/FiresSuggestionEvents.java
@@ -19,7 +19,7 @@ * A widget that implements this interface fires the events defined by the * {@link SuggestionHandler} interface. * - * @deprecated use + * @deprecated Use * {@link com.google.gwt.event.logical.shared.HasSelectionHandlers} * instead. */ @@ -29,7 +29,7 @@ /** * Adds a handler interface to receive suggestion events. * - * @deprecated add a selection handler instead + * @deprecated Add a selection handler instead * @param handler the handler to add */ @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/FocusListener.java b/user/src/com/google/gwt/user/client/ui/FocusListener.java index fa82aca..9f175fc 100644 --- a/user/src/com/google/gwt/user/client/ui/FocusListener.java +++ b/user/src/com/google/gwt/user/client/ui/FocusListener.java
@@ -20,7 +20,7 @@ /** * Event listener for focus events. * - * @deprecated use {@link com.google.gwt.event.dom.client.FocusHandler} and/or + * @deprecated Use {@link com.google.gwt.event.dom.client.FocusHandler} and/or * {@link com.google.gwt.event.dom.client.BlurHandler} instead */ @Deprecated @@ -30,7 +30,7 @@ * Fired when a widget receives keyboard focus. * * @param sender the widget receiving focus. - * @deprecated use + * @deprecated Use * {@link com.google.gwt.event.dom.client.FocusHandler#onFocus(com.google.gwt.event.dom.client.FocusEvent)} * instead */ @@ -41,7 +41,7 @@ * Fired when a widget loses keyboard focus. * * @param sender the widget losing focus. - * @deprecated use + * @deprecated Use * {@link com.google.gwt.event.dom.client.BlurHandler#onBlur(com.google.gwt.event.dom.client.BlurEvent)} * instead */
diff --git a/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java b/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java index c72d948..f82aa99 100644 --- a/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java +++ b/user/src/com/google/gwt/user/client/ui/FocusListenerAdapter.java
@@ -19,7 +19,7 @@ * An adapter to simplify focus event listeners that do not need all events * defined on the FocusListener interface. * - * @deprecated use {@link com.google.gwt.event.dom.client.FocusHandler} and + * @deprecated Use {@link com.google.gwt.event.dom.client.FocusHandler} and * {@link com.google.gwt.event.dom.client.BlurHandler} instead */ @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java b/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java index 5488f26..8ec58ad 100644 --- a/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/FocusListenerCollection.java
@@ -26,8 +26,8 @@ * subclass of {@link ArrayList} assumes that all objects added to it will be of * type {@link com.google.gwt.user.client.ui.FocusListener} * - * @deprecated use <code>addDomHandler(myHandler, FocusEvent.getType())</code> - * and <code>addDomHandler(myHandler, BlurEvent.getType())</code> to + * @deprecated Use <code>{@link Widget#addDomHandler(com.google.gwt.event.shared.EventHandler, com.google.gwt.event.dom.client.DomEvent.Type) addDomHandler}(myHandler, FocusEvent.getType())</code> + * and <code>{@link Widget#addDomHandler(com.google.gwt.event.shared.EventHandler, com.google.gwt.event.dom.client.DomEvent.Type) addDomHandler}(myHandler, BlurEvent.getType())</code> to * manage your widget's handlers instead */ @Deprecated
diff --git a/user/src/com/google/gwt/user/client/ui/FormHandler.java b/user/src/com/google/gwt/user/client/ui/FormHandler.java index cc18975..27d7f0c 100644 --- a/user/src/com/google/gwt/user/client/ui/FormHandler.java +++ b/user/src/com/google/gwt/user/client/ui/FormHandler.java
@@ -20,7 +20,7 @@ /** * Handler interface for form submit events. * - * @deprecated use {@link FormPanel.SubmitCompleteHandler} and/or + * @deprecated Use {@link FormPanel.SubmitCompleteHandler} and/or * {@link FormPanel.SubmitHandler} instead */ @Deprecated @@ -37,7 +37,7 @@ * * @param event an event object containing information about the form * submission - * @deprecated use {@link FormPanel.SubmitHandler} instead + * @deprecated Use {@link FormPanel.SubmitHandler} instead */ @Deprecated void onSubmit(FormSubmitEvent event); @@ -47,7 +47,7 @@ * * @param event an event object containing information about the form * submission - * @deprecated use {@link FormPanel.SubmitCompleteHandler} instead + * @deprecated Use {@link FormPanel.SubmitCompleteHandler} instead */ @Deprecated void onSubmitComplete(FormSubmitCompleteEvent event);
diff --git a/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java b/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java index af6a126..7b74c9c 100644 --- a/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java +++ b/user/src/com/google/gwt/user/client/ui/FormHandlerCollection.java
@@ -23,7 +23,7 @@ * of ArrayList assumes that all items added to it will be of type * {@link com.google.gwt.user.client.ui.FormHandler}. * - * @deprecated {@link FormPanel} now handles all handler management internally + * @deprecated {@link FormPanel} now implements all handler management internally */ @Deprecated public class FormHandlerCollection extends ArrayList<FormHandler> {
diff --git a/user/src/com/google/gwt/user/client/ui/FormPanel.java b/user/src/com/google/gwt/user/client/ui/FormPanel.java index c1353c8..5af185e 100644 --- a/user/src/com/google/gwt/user/client/ui/FormPanel.java +++ b/user/src/com/google/gwt/user/client/ui/FormPanel.java
@@ -184,7 +184,7 @@ * This method is used for legacy support and should be removed when * {@link FormHandler} is removed. * - * @deprecated use {@link FormPanel.SubmitEvent#cancel()} instead + * @deprecated Use {@link FormPanel.SubmitEvent#cancel()} instead */ @Deprecated void setCanceled(boolean canceled) { @@ -308,9 +308,9 @@ * <p> * The back-end server is expected to respond with a content-type of * 'text/html', meaning that the text returned will be treated as HTML. If any - * other content-type is specified by the server, then the result html sent in + * other content-type is specified by the server, then the result HTML sent in * the onFormSubmit event will be unpredictable across browsers, and the - * {@link SubmitCompleteHandler#onSubmitComplete(SubmitCompleteEvent)} event + * {@link SubmitCompleteHandler#onSubmitComplete(com.google.gwt.user.client.ui.FormPanel.SubmitCompleteEvent) onSubmitComplete} event * may not fire at all. * </p> *
diff --git a/user/src/com/google/gwt/user/client/ui/HasFocus.java b/user/src/com/google/gwt/user/client/ui/HasFocus.java index e0e999e..24c1be1 100644 --- a/user/src/com/google/gwt/user/client/ui/HasFocus.java +++ b/user/src/com/google/gwt/user/client/ui/HasFocus.java
@@ -18,7 +18,7 @@ /** * A widget that implements this interface can receive keyboard focus. * - * @deprecated use {@link Focusable} instead + * @deprecated Use {@link Focusable} instead */ @Deprecated public interface HasFocus extends Focusable, SourcesFocusEvents,
diff --git a/user/src/com/google/gwt/user/client/ui/HasKeyPreview.java b/user/src/com/google/gwt/user/client/ui/HasKeyPreview.java index 36849c0..927e865 100644 --- a/user/src/com/google/gwt/user/client/ui/HasKeyPreview.java +++ b/user/src/com/google/gwt/user/client/ui/HasKeyPreview.java
@@ -20,7 +20,7 @@ * before they are passed to the focused widget. * * @see com.google.gwt.event.dom.client.KeyCodeEvent - * @deprecated This interface hasn't worked in at least two years. Oops. + * @deprecated This interface has been superseded. */ @Deprecated public interface HasKeyPreview {
diff --git a/user/src/com/google/gwt/user/client/ui/PopupPanel.java b/user/src/com/google/gwt/user/client/ui/PopupPanel.java index b732c69..08fd2b8 100644 --- a/user/src/com/google/gwt/user/client/ui/PopupPanel.java +++ b/user/src/com/google/gwt/user/client/ui/PopupPanel.java
@@ -96,8 +96,8 @@ * * <ul> * <li>CENTER - Expand from the center of the popup</li> - * <li>ONE_WAY_CORNER - Expand from the top left corner, do not animate hiding - * </li> + * <li>ONE_WAY_CORNER - Expand from the top left corner, do not animate + * hiding </li> * </ul> */ static enum AnimationType { @@ -475,8 +475,8 @@ } /** - * Returns <code>true</code> if the popup should be automatically hidden when - * the user clicks outside of it. + * Returns <code>true</code> if the popup should be automatically hidden + * when the user clicks outside of it. * * @return true if autoHide is enabled, false if disabled */ @@ -530,7 +530,8 @@ } /** - * @deprecated use {@link #onPreviewNativeEvent(NativePreviewEvent)} instead + * @deprecated Use <code>onPreviewNativeEvent(NativePreviewEvent)</code> + * instead */ @Deprecated public boolean onEventPreview(Event event) { @@ -545,7 +546,8 @@ * @param modifiers keyboard modifiers, as specified in * {@link com.google.gwt.event.dom.client.KeyCodes}. * @return <code>false</code> to suppress the event - * @deprecated use {@link #onPreviewNativeEvent(NativePreviewEvent)} instead + * @deprecated Use <code>onPreviewNativeEvent(NativePreviewEvent)</code> + * instead */ @Deprecated public boolean onKeyDownPreview(char key, int modifiers) { @@ -560,7 +562,8 @@ * @param modifiers keyboard modifiers, as specified in * {@link com.google.gwt.event.dom.client.KeyCodes}. * @return <code>false</code> to suppress the event - * @deprecated use {@link #onPreviewNativeEvent(NativePreviewEvent)} instead + * @deprecated Use <code>onPreviewNativeEvent(NativePreviewEvent)</code> + * instead */ @Deprecated public boolean onKeyPressPreview(char key, int modifiers) { @@ -575,7 +578,8 @@ * @param modifiers keyboard modifiers, as specified in * {@link com.google.gwt.event.dom.client.KeyCodes}. * @return <code>false</code> to suppress the event - * @deprecated use {@link #onPreviewNativeEvent(NativePreviewEvent)} instead + * @deprecated Use <code>onPreviewNativeEvent(NativePreviewEvent)</code> + * instead */ @Deprecated public boolean onKeyUpPreview(char key, int modifiers) { @@ -722,8 +726,8 @@ * <code>visibility</code> style attribute. You need to call {@link #show()} * to actually attached/detach the {@link PopupPanel} to the page. * - * @param visible <code>true</code> to show the object, <code>false</code> to - * hide it + * @param visible <code>true</code> to show the object, <code>false</code> + * to hide it * @see #show() * @see #hide() */ @@ -881,11 +885,11 @@ * @param elt The Element on which <code>blur()</code> will be invoked */ private native void blur(Element elt) /*-{ - // Issue 2390: blurring the body causes IE to disappear to the background - if (elt.blur && elt != $doc.body) { - elt.blur(); - } - }-*/; + // Issue 2390: blurring the body causes IE to disappear to the background + if (elt.blur && elt != $doc.body) { + elt.blur(); + } + }-*/; /** * Does the event target one of the partner elements?
diff --git a/user/src/com/google/gwt/user/client/ui/Tree.java b/user/src/com/google/gwt/user/client/ui/Tree.java index 0f96566..3fde2f4 100644 --- a/user/src/com/google/gwt/user/client/ui/Tree.java +++ b/user/src/com/google/gwt/user/client/ui/Tree.java
@@ -428,10 +428,9 @@ * Gets this tree's default image package. * * @return the tree's image package - * @see #setImageBase - * @deprecated Use {@link #Tree(TreeImages)} as it provides a more efficent + * @deprecated Use {@link #Tree(TreeImages)} as it provides a more efficient * and manageable way to supply a set of images to be used within - * a tree. + * a tree */ @Deprecated public String getImageBase() {