The current documentation on use of JAWT is a little sketchy and hard to find.
We should provide more docs in some form (a whitepaper, swing connection
article, etc.) explaining:
1) What JAWT is used for and how to use it.
2) How to use JAWT when you want to make Xlib calls on multiple threads
(even if you are not doing your own rendering) and why using XInitThreads
is a bad idea.
3) Any interactions with rendering, known issues, or recommendations for
customers who want to use it.