### Eclipse Workspace Patch 1.0
#P GHOP Drupal
Index: includes/form.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/form.inc,v
retrieving revision 1.249
diff -u -r1.249 form.inc
--- includes/form.inc	26 Nov 2007 16:36:42 -0000	1.249
+++ includes/form.inc	30 Nov 2007 17:22:35 -0000
@@ -1315,6 +1315,8 @@
  * @return
  *   A themed HTML string representing the form element.
  *
+ * @ingroup themeable
+ *
  * It is possible to group options together; to do this, change the format of
  * $options to an associative array in which the keys are group labels, and the
  * values are associative arrays in the normal $options format.
@@ -1417,6 +1419,8 @@
  *   Properties used: attributes, title, value, description, children, collapsible, collapsed
  * @return
  *   A themed HTML string representing the form item group.
+ *
+ * @ingroup themeable
  */
 function theme_fieldset($element) {
   if ($element['#collapsible']) {
@@ -1443,6 +1447,8 @@
  *   Properties used: required, return_value, value, attributes, title, description
  * @return
  *   A themed HTML string representing the form item group.
+ *
+ * @ingroup themeable
  */
 function theme_radio($element) {
   _form_set_class($element, array('form-radio'));
@@ -1467,6 +1473,8 @@
  *   Properties used: title, value, options, description, required and attributes.
  * @return
  *   A themed HTML string representing the radio button set.
+ *
+ * @ingroup themeable
  */
 function theme_radios($element) {
   $class = 'form-radios';
@@ -1491,6 +1499,8 @@
  *   Properties used: title, value, id, required, error.
  * @return
  *   A themed HTML string representing the form item.
+ *
+ * @ingroup themeable
  */
 function theme_password_confirm($element) {
   return theme('form_element', $element, $element['#children']);
@@ -1557,6 +1567,8 @@
  *   Properties used: title, value, options, description, required and attributes.
  * @return
  *   A themed HTML string representing the date selection boxes.
+ *
+ * @ingroup themeable
  */
 function theme_date($element) {
   return theme('form_element', $element, '<div class="container-inline">'. $element['#children'] .'</div>');
@@ -1748,6 +1760,8 @@
  *   Properties used:  title, value, description, required, error
  * @return
  *   A themed HTML string representing the form item.
+ *
+ * @ingroup themeable
  */
 function theme_item($element) {
   return theme('form_element', $element, $element['#value'] . (!empty($element['#children']) ? $element['#children'] : ''));
@@ -1761,6 +1775,8 @@
  *   Properties used:  title, value, return_value, description, required
  * @return
  *   A themed HTML string representing the checkbox.
+ *
+ * @ingroup themeable
  */
 function theme_checkbox($element) {
   _form_set_class($element, array('form-checkbox'));
@@ -1787,6 +1803,8 @@
  *   An associative array containing the properties of the element.
  * @return
  *   A themed HTML string representing the checkbox set.
+ *
+ * @ingroup themeable
  */
 function theme_checkboxes($element) {
   $class = 'form-checkboxes';
@@ -1819,10 +1837,20 @@
   return $element;
 }
 
+/**
+ * Theme a submit button.
+ *
+ * @ingroup themeable
+ */
 function theme_submit($element) {
   return theme('button', $element);
 }
 
+/**
+ * Theme a button.
+ *
+ * @ingroup themeable
+ */
 function theme_button($element) {
   // Make sure not to overwrite classes.
   if (isset($element['#attributes']['class'])) {
@@ -1837,6 +1865,8 @@
 
 /**
  * Theme an image button.
+ *
+ * @ingroup themeable
  */
 function theme_image_button($element) {
   // Make sure not to overwrite classes.
@@ -1864,11 +1894,18 @@
  *   Properties used:  value, edit
  * @return
  *   A themed HTML string representing the hidden form field.
+ *
+ * @ingroup themeable
  */
 function theme_hidden($element) {
   return '<input type="hidden" name="'. $element['#name'] .'" id="'. $element['#id'] .'" value="'. check_plain($element['#value']) ."\" ". drupal_attributes($element['#attributes']) ." />\n";
 }
 
+/**
+ * Format a form token.
+ *
+ * @ingroup themeable
+ */
 function theme_token($element) {
   return theme('hidden', $element);
 }
@@ -1881,6 +1918,8 @@
  *   Properties used:  title, value, description, size, maxlength, required, attributes autocomplete_path
  * @return
  *   A themed HTML string representing the textfield.
+ *
+ * @ingroup themeable
  */
 function theme_textfield($element) {
   $size = empty($element['#size']) ? '' : ' size="'. $element['#size'] .'"';
@@ -1917,6 +1956,8 @@
  *   Properties used: action, method, attributes, children
  * @return
  *   A themed HTML string representing the form.
+ *
+ * @ingroup themeable
  */
 function theme_form($element) {
   // Anonymous div to satisfy XHTML compliance.
@@ -1932,6 +1973,8 @@
  *   Properties used: title, value, description, rows, cols, required, attributes
  * @return
  *   A themed HTML string representing the textarea.
+ *
+ * @ingroup themeable
  */
 function theme_textarea($element) {
   $class = array('form-textarea');
@@ -1965,6 +2008,8 @@
  *   Properties used: value, children.
  * @return
  *   A themed HTML string representing the HTML markup.
+ *
+ * @ingroup themeable
  */
 
 function theme_markup($element) {
@@ -1979,6 +2024,8 @@
  *   Properties used:  title, value, description, size, maxlength, required, attributes
  * @return
  *   A themed HTML string representing the form.
+ *
+ * @ingroup themeable
  */
 function theme_password($element) {
   $size = $element['#size'] ? ' size="'. $element['#size'] .'" ' : '';
@@ -2019,6 +2066,8 @@
  * @return
  *   A themed HTML string representing the field.
  *
+ * @ingroup themeable
+ *
  * For assistance with handling the uploaded file correctly, see the API
  * provided by file.inc.
  */
@@ -2037,6 +2086,8 @@
  *   The form element's data.
  * @return
  *   A string representing the form element.
+ *
+ * @ingroup themeable
  */
 function theme_form_element($element, $value) {
   // This is also used in the installer, pre-database setup.
Index: includes/theme.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/theme.inc,v
retrieving revision 1.397
diff -u -r1.397 theme.inc
--- includes/theme.inc	26 Nov 2007 16:36:42 -0000	1.397
+++ includes/theme.inc	30 Nov 2007 17:22:43 -0000
@@ -182,6 +182,8 @@
  * in memory it will be returned; otherwise it will attempt to load the
  * registry from cache. If this fails, it will construct the registry and
  * cache it.
+ *
+ * @ingroup themeable
  */
 function theme_get_registry($registry = NULL) {
   static $theme_registry = NULL;
@@ -824,6 +826,8 @@
  *
  * @return
  *   An associative array containing theme settings.
+ *
+ * @ingroup themeable
  */
 function theme_get_settings($key = NULL) {
   $defaults = array(
@@ -880,6 +884,8 @@
  *
  * @return
  *   The value of the requested setting, NULL if the setting does not exist.
+ *
+ * @ingroup themeable
  */
 function theme_get_setting($setting_name, $refresh = FALSE) {
   global $theme_key;
@@ -939,6 +945,8 @@
  *
  * @return
  *   The output generated by the template.
+ *
+ * @ingroup themeable
  */
 function theme_render_template($file, $variables) {
   extract($variables, EXTR_SKIP);  // Extract the variables to a local namespace
@@ -1661,6 +1669,16 @@
   return $output;
 }
 
+/**
+ * Return a themed progress bar.
+ *
+ * @param $percent
+ *   The percentage of the progress.
+ * @param $message
+ *   A string containing information to be displayed.
+ * @return
+ *   A themed HTML string representing the progress bar.
+ */
 function theme_progress_bar($percent, $message) {
   $output = '<div id="progress" class="progress">';
   $output .= '<div class="bar"><div class="filled" style="width: '. $percent .'%"></div></div>';
Index: includes/pager.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/pager.inc,v
retrieving revision 1.62
diff -u -r1.62 pager.inc
--- includes/pager.inc	2 Aug 2007 10:58:41 -0000	1.62
+++ includes/pager.inc	30 Nov 2007 17:22:41 -0000
@@ -369,6 +369,8 @@
  *   An associative array of HTML attributes to apply to a pager anchor tag.
  * @return
  *   An HTML string that generates the link.
+ *
+ * @ingroup themeable
  */
 function theme_pager_link($text, $page_new, $element, $parameters = array(), $attributes = array()) {
   $page = isset($_GET['page']) ? $_GET['page'] : '';
Index: includes/menu.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/menu.inc,v
retrieving revision 1.228
diff -u -r1.228 menu.inc
--- includes/menu.inc	26 Nov 2007 16:19:37 -0000	1.228
+++ includes/menu.inc	30 Nov 2007 17:22:40 -0000
@@ -979,6 +979,8 @@
 
 /**
  * Generate the HTML output for a single menu link.
+ *
+ * @ingroup themeable
  */
 function theme_menu_item_link($link) {
   if (empty($link['options'])) {
@@ -990,6 +992,8 @@
 
 /**
  * Generate the HTML output for a menu tree
+ *
+ * @ingroup themeable
  */
 function theme_menu_tree($tree) {
   return '<ul class="menu">'. $tree .'</ul>';
@@ -997,6 +1001,8 @@
 
 /**
  * Generate the HTML output for a menu item and submenu.
+ *
+ * @ingroup themeable
  */
 function theme_menu_item($link, $has_children, $menu = '', $in_active_trail = FALSE, $extra_class = NULL) {
   $class = ($menu ? 'expanded' : ($has_children ? 'collapsed' : 'leaf'));
@@ -1011,6 +1017,8 @@
 
 /**
  * Generate the HTML output for a single local task link.
+ *
+ * @ingroup themeable
  */
 function theme_menu_local_task($link, $active = FALSE) {
   return '<li '. ($active ? 'class="active" ' : '') .'>'. $link .'</li>';
Index: includes/locale.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/locale.inc,v
retrieving revision 1.166
diff -u -r1.166 locale.inc
--- includes/locale.inc	26 Nov 2007 23:33:03 -0000	1.166
+++ includes/locale.inc	30 Nov 2007 17:22:38 -0000
@@ -63,6 +63,8 @@
 
 /**
  * Theme the language overview form.
+ *
+ * @ingroup themeable
  */
 function theme_locale_languages_overview_form($form) {
   $default = language_default();
Index: modules/system/system.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.admin.inc,v
retrieving revision 1.30
diff -u -r1.30 system.admin.inc
--- modules/system/system.admin.inc	27 Nov 2007 21:06:28 -0000	1.30
+++ modules/system/system.admin.inc	30 Nov 2007 17:22:49 -0000
@@ -1711,7 +1711,8 @@
  * @param $block
  *   An array containing information about the block. It should
  *   include a 'title', a 'description' and a formatted 'content'.
- * @themeable
+ *
+ * @ingroup themeable
  */
 function theme_admin_block($block) {
   // Don't display the block if it has no content to display.
@@ -1741,7 +1742,8 @@
  * @param $block
  *   An array containing information about the block. It should
  *   include a 'title', a 'description' and a formatted 'content'.
- * @themeable
+ *
+ * @ingroup themeable
  */
 function theme_admin_block_content($content) {
   if (!$content) {
@@ -1778,7 +1780,8 @@
  *   'title', a 'description', a formatted 'content' and a
  *   'position' which will control which container it will be
  *   in. This is usually 'left' or 'right'.
- * @themeable
+ *
+ * @ingroup themeable
  */
 function theme_admin_page($blocks) {
   $stripe = 0;
@@ -1818,6 +1821,8 @@
 
 /**
  * Theme output of the dashboard page.
+ *
+ * @ingroup themeable
  */
 function theme_system_admin_by_module($menu_items) {
   $stripe = 0;
Index: modules/node/node.pages.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/node/node.pages.inc,v
retrieving revision 1.12
diff -u -r1.12 node.pages.inc
--- modules/node/node.pages.inc	29 Nov 2007 11:54:37 -0000	1.12
+++ modules/node/node.pages.inc	30 Nov 2007 17:22:46 -0000
@@ -21,6 +21,11 @@
   return theme('node_add_list', $content);
 }
 
+/**
+ * Display the list of available node types for node creation.
+ *
+ * @ingroup themeable
+ */
 function theme_node_add_list($content) {
   $output = '';
 
@@ -309,6 +314,11 @@
   $form_state['node_preview'] = node_preview($node);
 }
 
+/**
+ * Present a node submission form.
+ *
+ * @ingroup themeable
+ */
 function theme_node_form($form) {
   $output = "\n<div class=\"node-form\">\n";
 
@@ -399,6 +409,8 @@
  *
  * @param $node
  *   The node object which is being previewed.
+ *
+ * @ingroup themeable
  */
 function theme_node_preview($node) {
   $output = '<div class="preview">';
Index: modules/node/node.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/node/node.admin.inc,v
retrieving revision 1.11
diff -u -r1.11 node.admin.inc
--- modules/node/node.admin.inc	28 Nov 2007 10:29:20 -0000	1.11
+++ modules/node/node.admin.inc	30 Nov 2007 17:22:45 -0000
@@ -236,6 +236,8 @@
 
 /**
  * Theme node administration filter form.
+ *
+ * @ingroup themeable
  */
 function theme_node_filter_form($form) {
   $output = '';
@@ -248,6 +250,8 @@
 
 /**
  * Theme node administration filter selector.
+ *
+ * @ingroup themeable
  */
 function theme_node_filters($form) {
   $output = '';
@@ -401,6 +405,8 @@
 
 /**
  * Theme node administration overview.
+ *
+ * @ingroup themeable
  */
 function theme_node_admin_nodes($form) {
   // If there are rows in this form, then $form['title'] contains a list of
Index: modules/filter/filter.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/filter/filter.admin.inc,v
retrieving revision 1.4
diff -u -r1.4 filter.admin.inc
--- modules/filter/filter.admin.inc	23 Nov 2007 13:34:55 -0000	1.4
+++ modules/filter/filter.admin.inc	30 Nov 2007 17:22:43 -0000
@@ -350,6 +350,8 @@
 
 /**
  * Theme filter order configuration form.
+ *
+ * @ingroup themeable
  */
 function theme_filter_admin_order($form) {
   $header = array(t('Name'), t('Weight'));
Index: modules/taxonomy/taxonomy.pages.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/taxonomy/taxonomy.pages.inc,v
retrieving revision 1.5
diff -u -r1.5 taxonomy.pages.inc
--- modules/taxonomy/taxonomy.pages.inc	11 Nov 2007 06:56:44 -0000	1.5
+++ modules/taxonomy/taxonomy.pages.inc	30 Nov 2007 17:22:49 -0000
@@ -82,6 +82,8 @@
  *   An array of term ids.
  * @param $result
  *   A pager_query() result, such as that performed by taxonomy_select_nodes().
+ *
+ * @ingroup themeable
  */
 function theme_taxonomy_term_page($tids, $result) {
   $output = '';
Index: modules/update/update.report.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/update/update.report.inc,v
retrieving revision 1.4
diff -u -r1.4 update.report.inc
--- modules/update/update.report.inc	20 Oct 2007 21:57:50 -0000	1.4
+++ modules/update/update.report.inc	30 Nov 2007 17:22:49 -0000
@@ -22,6 +22,8 @@
 
 /**
  * Theme project status report.
+ *
+ * @ingroup themeable
  */
 function theme_update_report($data) {
   $last = variable_get('update_last_check', 0);
@@ -197,6 +199,11 @@
   return $output;
 }
 
+/**
+ * Theme the version display of a project.
+ *
+ * @ingroup themeable
+ */
 function theme_update_version($version, $tag, $class) {
   $output = '';
   $output .= '<table class="version '. $class .'">';
Index: modules/menu/menu.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/menu/menu.admin.inc,v
retrieving revision 1.15
diff -u -r1.15 menu.admin.inc
--- modules/menu/menu.admin.inc	26 Nov 2007 16:36:43 -0000	1.15
+++ modules/menu/menu.admin.inc	30 Nov 2007 17:22:44 -0000
@@ -163,6 +163,8 @@
 
 /**
  * Theme the menu overview form into a table.
+ *
+ * @ingroup themeable
  */
 function theme_menu_overview_form($form) {
   drupal_add_tabledrag('menu-overview', 'match', 'parent', 'menu-plid', 'menu-plid', 'menu-mlid', TRUE, MENU_MAX_DEPTH - 1);
Index: modules/trigger/trigger.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/trigger/trigger.admin.inc,v
retrieving revision 1.1
diff -u -r1.1 trigger.admin.inc
--- modules/trigger/trigger.admin.inc	31 Oct 2007 16:30:14 -0000	1.1
+++ modules/trigger/trigger.admin.inc	30 Nov 2007 17:22:49 -0000
@@ -226,6 +226,8 @@
  *   The fieldset including all assigned actions.
  * @return
  *   The rendered form with the table prepended.
+ *
+ * @ingroup themeable
  */
 function theme_trigger_display($element) {
   $header = array();