From 6cd26568d5b8be2252ac0def36cd194b4fb2d7c3 Mon Sep 17 00:00:00 2001
From: fauxmight <fauxmight@noreply.codeberg.org>
Date: Mon, 29 Sep 2025 05:56:22 +0200
Subject: [PATCH] Update README.md

Document Java nonreparenting WM issue

Closes #722
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index d131bb0..390788d 100644
--- a/README.md
+++ b/README.md
@@ -118,6 +118,15 @@ script with the line
 
 To get a list of status bars that work with dwl consult our [wiki].
 
+### (Known) Java nonreparenting WM issue
+Certain IDEs don't display correctly unless an environmental variable for Java AWT
+indicates that the WM is nonreparenting.
+
+For some Java AWT-based IDEs, such as Xilinx Vivado and Microchip MPLAB X, the
+following environment variable needs to be set before running the IDE or dwl:
+
+    export _JAVA_AWT_WM_NONREPARENTING=1
+
 ## Replacements for X applications
 
 You can find a [list of useful resources on our wiki].