java.awt.swing.table.DefaultTableSelectionModel spec needs to be updated:
1. descriptions of
getColumn(int)
setColumnMargin(int)
   say nothing about these methods' behavior in case when
   the integer parameter is out of bounds.
2. A lot of important methods have no description at all:
addColumnListener()
removeColumnListener()
createSelectionModel()
getColumnSelectionAllowed()
getSelectedColumnCount()
getSelectedColumns()
getTotalColumnWidth()
setColumnsSelectionAllowed()
3. Methods getColumnMargin() and getSelectionModel have
   confusing descriptions.