From 2965f17f1abd3c3af640407187ebedded29ad105 Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Thu, 7 Aug 2014 00:11:37 +0200
Subject: NEWT Window setSurfaceSize(..): Add API doc comment about setting
 pixel-unit size after creation in multiple monitor mode.

---
 src/newt/classes/com/jogamp/newt/Window.java | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/newt/classes/com/jogamp/newt/Window.java b/src/newt/classes/com/jogamp/newt/Window.java
index 600ecee52..ec6d767fa 100644
--- a/src/newt/classes/com/jogamp/newt/Window.java
+++ b/src/newt/classes/com/jogamp/newt/Window.java
@@ -304,6 +304,11 @@ public interface Window extends NativeWindow, WindowClosingProtocol, ScalableSur
      * Sets the size of the window's surface in pixel units which claims the window's client area excluding decorations.
      *
      * <p>
+     * In multiple monitor mode, setting the window's surface size in pixel units
+     * might not be possible due to unknown <i>scale</i> values of the target display.
+     * Hence re-setting the pixel unit size after window creation is recommended.
+     * </p>
+     * <p>
      * Zero size semantics are respected, see {@link #setVisible(boolean)}:<br>
      * <pre>
      * if ( visible && 0 != windowHandle && ( 0 &ge; width || 0 &ge; height ) ) {
-- 
cgit v1.2.3