theme_table() [and other HTML element theme functions?] should document class attributes being an array

API page: http://api.drupal.org/api/drupal/includes--theme.inc/function/theme_table/7

Describe the problem you have found:

The examples for $rows[] and cells state that you can add any html attributes - and especially class attributes.

• Any HTML attributes, such as "class", to apply to the table row.

It should be noted that you should use an array for html "class" attributes, because if you don't you will break the default tablesorters.

The docs should read something like:

• Any HTML attributes, such as "id", to apply to the table row. To add a "class" attribute you should add an array as follows: 'class' => array('extraclassname').

(the attached file has a non working and a working scenario)