Undeprecating DockPanel because it is still useful and fulfills a purpose that DockLayoutPanel cannot. DockPanel will naturally resize to fit its content, whereas DockLayoutPanel requires the user to specify the dimensions of the content. Issue: 5888 Review at http://gwt-code-reviews.appspot.com/1346802 Review by: rchandia@google.com git-svn-id: https://google-web-toolkit.googlecode.com/svn/trunk@9686 8db76d5a-ed1c-0410-87a9-c151d255dfc7
diff --git a/user/src/com/google/gwt/user/client/ui/DockPanel.java b/user/src/com/google/gwt/user/client/ui/DockPanel.java index abd45b7..f6e1cce 100644 --- a/user/src/com/google/gwt/user/client/ui/DockPanel.java +++ b/user/src/com/google/gwt/user/client/ui/DockPanel.java
@@ -28,22 +28,25 @@ * allows its last widget to take up the remaining space in its center. * * <p> - * This widget will <em>only</em> work in quirks mode. If your application is in - * Standards Mode, use {@link DockLayoutPanel} instead. + * This widget has limitations in standards mode that did not exist in quirks + * mode. The child Widgets contained within a DockPanel cannot be sized using + * percentages. Setting a child widget's height to <code>100%</code> will + * <em>NOT</em> cause the child to fill the available height. + * </p> + * + * <p> + * If you need to work around these limitations, use {@link DockLayoutPanel} + * instead, but understand that it is not a drop in replacement for this class. + * It requires standards mode, and is most easily used under a + * {@link RootLayoutPanel} (as opposed to a {@link RootPanel}). * </p> * * <p> * <img class='gallery' src='doc-files/DockPanel.png'/> * </p> * - * @deprecated Use {@link DockLayoutPanel} instead, but understand that it is - * not a drop in replacement for this class. It requires standards - * mode, and is most easily used under a {@link RootLayoutPanel} (as - * opposed to a {@link RootPanel} - * * @see DockLayoutPanel */ -@Deprecated public class DockPanel extends CellPanel implements HasAlignment { /**