# HG changeset patch
# User arg@mig29
# Date 1166013737 -3600
# Node ID 3afe7c74ceb98bdb1b3ca4f3691b3e64698d76b1
# Parent  d6fbb669fef2bfa72478a8de12d998f5aeba02ad
added the java odyssee to CAVEATS section

diff -r d6fbb669fef2 -r 3afe7c74ceb9 dwm.1
--- a/dwm.1	Tue Dec 12 19:14:38 2006 +0100
+++ b/dwm.1	Wed Dec 13 13:42:17 2006 +0100
@@ -123,8 +123,16 @@
 .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)