Index: includes/theme.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/theme.inc,v
retrieving revision 1.442
diff -u -p -r1.442 theme.inc
--- includes/theme.inc	20 Oct 2008 11:34:32 -0000	1.442
+++ includes/theme.inc	22 Oct 2008 03:34:08 -0000
@@ -1224,7 +1224,9 @@ function theme_submenu($links) {
  *   - "data": The localized title of the table column.
  *   - "field": The database field represented in the table column (required if
  *     user is to be able to sort on this column).
- *   - "sort": A default sort order for this column ("asc" or "desc").
+ *   - "sort": A default sort order for this column ("asc" or "desc"). This
+ *     depends on tablesort_sql() appending sort data when forming queries
+ *     before being passed to theme_table().
  *   - Any HTML attributes, such as "colspan", to apply to the column header cell.
  * @param $rows
  *   An array of table rows. Every row is an array of cells, or an associative