2006-08-06 Roman Kennke <kennke@aicas.com>

       PR 28571
       * gnu/java/awt/peer/gtk/GtkCanvasPeer.java
       (getPreferredSize): Renamed method to preferredSize(). That's
       the one that gets called from java.awt.*.
       * java/awt/peer/ComponentPeer.java
       (getPreferredSize): Added specnote about this method never
       beeing called in the RI.
       (getMinimumSize): Added specnote about this method never
       beeing called in the RI.

1 files changed, 12 insertions, 0 deletions

diff --git a/java/awt/peer/ComponentPeer.java b/java/awt/peer/ComponentPeer.java
index 95979b8a9..bc6e3a457 100644
--- a/java/awt/peer/ComponentPeer.java
+++ b/java/awt/peer/ComponentPeer.java
@@ -153,6 +153,12 @@ public interface ComponentPeer
    * {@link Component#getMinimumSize()}.
    *
    * @return the minimum size for the component
+   *
+   * @specnote Presumably this method got added to replace minimumSize().
+   *           However, testing shows that this is never called in the RI
+   *           (tested with JDK5), but instead minimumSize() is called
+   *           directly. It is advisable to implement this method to delegate
+   *           to minimumSize() and put the real implementation in there.
    */
   Dimension getMinimumSize();
 
@@ -161,6 +167,12 @@ public interface ComponentPeer
    * {@link Component#getPreferredSize()}.
    *
    * @return the preferred size for the component
+   *
+   * @specnote Presumably this method got added to replace preferredSize().
+   *           However, testing shows that this is never called in the RI
+   *           (tested with JDK5), but instead preferredSize() is called
+   *           directly. It is advisable to implement this method to delegate
+   *           to preferredSize() and put the real implementation in there.
    */
   Dimension getPreferredSize();