added the java odyssee to CAVEATS section
authorarg@mig29
Wed, 13 Dec 2006 13:42:17 +0100
changeset 632 3afe7c74ceb9
parent 631 d6fbb669fef2
child 633 7209e355762c
added the java odyssee to CAVEATS section
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)