Revision: 9686
Author: jlaba...@google.com
Date: Tue Feb 8 04:39:12 2011
Log: 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: rchan...@google.com
http://code.google.com/p/google-web-toolkit/source/detail?r=9686
Modified:
/trunk/user/src/com/google/gwt/user/client/ui/DockPanel.java
=======================================
--- /trunk/user/src/com/google/gwt/user/client/ui/DockPanel.java Mon Jun 7
12:20:31 2010
+++ /trunk/user/src/com/google/gwt/user/client/ui/DockPanel.java Tue Feb 8
04:39:12 2011
@@ -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 {
/**
--
http://groups.google.com/group/Google-Web-Toolkit-Contributors
