From d6c16939d7f5f539150621398c282448c555e044 Mon Sep 17 00:00:00 2001
From: Matti Tahvonen <matti.tahvonen@itmill.com>
Date: Thu, 18 Dec 2008 06:12:04 +0000
Subject: [PATCH] docs

svn changeset:6256/svn branch:trunk
---
 .../itmill/toolkit/terminal/gwt/client/Util.java | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/com/itmill/toolkit/terminal/gwt/client/Util.java b/src/com/itmill/toolkit/terminal/gwt/client/Util.java
index 29854057ca..278c046068 100644
--- a/src/com/itmill/toolkit/terminal/gwt/client/Util.java
+++ b/src/com/itmill/toolkit/terminal/gwt/client/Util.java
@@ -650,10 +650,11 @@ public class Util {
     }
 
     /**
-     * Detects what is currently the oveflow style attribute in given element.
+     * Detects what is currently the overflow style attribute in given element.
      * 
      * @param pe
-     * @return
+     *            the element to detect
+     * @return true if auto or scroll
      */
     public static boolean mayHaveScrollBars(com.google.gwt.dom.client.Element pe) {
         String overflow = getComputedStyle(pe, "overflow");
@@ -668,6 +669,17 @@ public class Util {
         }
     }
 
+    /**
+     * A simple helper method to detect "computed style" (aka style sheets +
+     * element styles). Values returned differ a lot depending on browsers.
+     * Always be very careful when using this.
+     * 
+     * @param el
+     *            the element from which the style property is detected
+     * @param p
+     *            the property to detect
+     * @return String value of style property
+     */
     private static native String getComputedStyle(
             com.google.gwt.dom.client.Element el, String p)
     /*-{
-- 
2.39.5