From c8f96b5b4c08f29e8c7ac7d31fc7d83d16f46ec2 Mon Sep 17 00:00:00 2001
From: "arg@mig29" <unknown>
Date: Wed, 13 Dec 2006 13:42:17 +0100
Subject: added the java odyssee to CAVEATS section

---
 dwm.1 | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

(limited to 'dwm.1')

diff --git a/dwm.1 b/dwm.1
index a8fb40a8..6497655b 100644
--- a/dwm.1
+++ b/dwm.1
@@ -123,8 +123,16 @@ code. This keeps it fast, secure and simple.
 .SH CAVEATS
 The status bar may display
 .BR "broken pipe"
-when dwm has been started by
+when dwm has been started by an X session manager like
 .BR xdm (1),
-because it closes standard output before executing dwm.
+because those close standard output before executing dwm.
+.P
+Java applications which use the XToolkit/XAWT backend may draw grey windows
+only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
+JDK 1.6 versions, because it assumes a reparenting window manager. As workaround
+wether you use JDK 1.4 (which don't contains the XToolkit/XAWT backend) or you
+define the following environment variable accordingly (to use the older Motif
+backend instead):
+.BR AWT_TOOLKIT=MToolkit .
 .SH SEE ALSO
 .BR dmenu (1)
-- 
cgit v1.2.3