diff --git a/bundles/org.eclipse.jface/src/org/eclipse/jface/window/Window.java b/bundles/org.eclipse.jface/src/org/eclipse/jface/window/Window.java
index 5b0aecf214a..51379ae6234 100644
--- a/bundles/org.eclipse.jface/src/org/eclipse/jface/window/Window.java
+++ b/bundles/org.eclipse.jface/src/org/eclipse/jface/window/Window.java
@@ -832,7 +832,7 @@ private void runEventLoop(Shell loopShell) {
 
 	/**
 	 * Sets whether the <code>open</code> method should block until the window
-	 * closes.
+	 * closes. (May display different behavior depending on the operating system.)
 	 *
 	 * @param shouldBlock
 	 *            <code>true</code> if the <code>open</code> method should