- Patch #891476 by solotandem: improved code comments

includes/form.inc

@@ -2977,12 +2977,13 @@ function theme_tableselect($variables) {
     // Add an empty header or a "Select all" checkbox to provide room for the
     // checkboxes/radios in the first table column.
     if ($element['#js_select']) {
-      // Add a "Select all" checkbox when checkboxes are displayed.
+      // Add a "Select all" checkbox.
       drupal_add_js('misc/tableselect.js');
       array_unshift($header, array('class' => array('select-all')));
     }
     else {
-      // Add an empty header when radio buttons are displayed.
+      // Add an empty header when radio buttons are displayed or a "Select all"
+      // checkbox is not desired.
       array_unshift($header, '');
     }
   }