Deprecate RootPanel#clear.
RootPanel#clear removes all children of the body element.
Since GWT's code is loaded into an iframe inside of the page this can
cause issues with references in GWT code to the iframe
(e.g. console.log).
Users should be removing specific DOM elements, e.g.:
Document.get().getElementById("myDomElement").removeFromParent();
Change-Id: I1398451b975be157901872a900479884b4c29223
diff --git a/user/src/com/google/gwt/user/client/ui/RootPanel.java b/user/src/com/google/gwt/user/client/ui/RootPanel.java
index 08170c7..cc571e0 100644
--- a/user/src/com/google/gwt/user/client/ui/RootPanel.java
+++ b/user/src/com/google/gwt/user/client/ui/RootPanel.java
@@ -304,7 +304,10 @@
*
* @param clearDom if {@code true} this method will also remove any DOM
* elements that are not widgets.
+ *
+ * @deprecated Simply removing all DOM elements can cause issues with other elements in the page.
*/
+ @Deprecated
public void clear(boolean clearDom) {
clear();
