A DESCRIPTION OF THE PROBLEM :
Please consider replacing the GroupLayout Javadoc with the article found at http://java.sun.com/docs/books/tutorial/uiswing/layout/group.html or at the very least linking to it from the Javadoc. I find the latter article to be much better structured and easier to read. The problem with the Javadoc is that it tries to introduce too many new concepts at once, and some of them out of order (referring heavily to horizontal and parallel groups without discussed them in detail first).


URL OF FAULTY DOCUMENTATION :
http://java.sun.com/javase/6/docs/api/javax/swing/GroupLayout.html