In the 1.3 API reference for JToolbar, it states that

"A tool bar can be dragged out into a separate window by the user (unless the floatable property is set to false). In order for drag-out to work correctly, it is recommended that you add JToolBar instances to one of the four 'sides' of a container whose layout manager is a BorderLayout, and do not add children to any of the other four 'sides'."

What it does not state is that a "drag texture" is provided with only the Metal Look and Feel. With the Windows and Motif Look and Feels, there is no specific
spot where you can cause a JToolbar to float, you need to grab it between the
buttons, making it much harder to implement. The documentation should state explicitly that JToolbar has a drag texture in Metal but not in the other Look and Feels.

The documentation should also describe the "rollover" feature and state that it
is only available in the Metal Look and Feel.