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.