From 7ea8aa31e055ba95a062c87ec4d606f73c2504fa Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Tue, 6 Sep 2011 02:42:11 +0200
Subject: NativeWindow/NEWT: Cont. refinement of Insets usage

Completes commit d4670328991c02a6f11f8873ea7a2331f17d0ef0
---
 src/newt/classes/com/jogamp/newt/Window.java | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

(limited to 'src/newt')

diff --git a/src/newt/classes/com/jogamp/newt/Window.java b/src/newt/classes/com/jogamp/newt/Window.java
index c8eb2b1f5..ed1cd93a9 100644
--- a/src/newt/classes/com/jogamp/newt/Window.java
+++ b/src/newt/classes/com/jogamp/newt/Window.java
@@ -179,8 +179,12 @@ public interface Window extends NativeWindow, WindowClosingProtocol {
     void setSize(int width, int height);
 
     /**
-     * Sets the size of the top-level window including decorations.
+     * Sets the size of the top-level window including insets (window decorations).
      * 
+     * <p>
+     * Note: Insets (if supported) are available only after the window is set visible and hence has been created.
+     * </p>
+     *
      * @param width of the top-level window area
      * @param height of the top-level window area
      * 
@@ -190,7 +194,7 @@ public interface Window extends NativeWindow, WindowClosingProtocol {
     void setTopLevelSize(int width, int height);
     
     /**
-     * Sets the location of the window's client area, excluding decorations.<br>
+     * Sets the location of the window's client area, excluding insets (window decorations).<br>
      * 
      * This call is ignored if in fullscreen mode.<br>
      *
@@ -202,7 +206,11 @@ public interface Window extends NativeWindow, WindowClosingProtocol {
     void setPosition(int x, int y);
     
     /**
-     * Sets the location of the top-level window inclusive decorations.<br>
+     * Sets the location of the top-level window inclusive insets (window decorations).<br>
+     * 
+     * <p>
+     * Note: Insets (if supported) are available only after the window is set visible and hence has been created.
+     * </p>
      * 
      * This call is ignored if in fullscreen mode.<br>
      *
-- 
cgit v1.2.3