diff --git a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/graphics/GC.java b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/graphics/GC.java
index 2f5c2385e41..836758a3862 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/graphics/GC.java	
+++ b/bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/graphics/GC.java	
@@ -5695,6 +5695,13 @@ private void setLineWidthInPixels(int lineWidth) {
  * and the destination, and if the argument is <code>false</code>,
  * puts the receiver in a drawing mode where the destination color
  * is replaced with the source color value.
+ * <p>
+ * <b>IMPORTANT:</b> GDI+ has no direct support for raster
+ * operations (ROPs). This means that advanced graphics must be
+ * <b>disabled</b> when using XOR mode. More specifically, this
+ * means that all operations that require advanced mode (e.g.
+ * {@link Transform}) can't be used in combination with XOR mode.
+ * </p>
  *
  * @param xor if <code>true</code>, then <em>xor</em> mode is used, otherwise <em>source copy</em> mode is used
  *