Index: includes/form.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/form.inc,v
retrieving revision 1.400
diff -u -r1.400 form.inc
--- includes/form.inc	16 Nov 2009 05:11:01 -0000	1.400
+++ includes/form.inc	17 Nov 2009 21:18:59 -0000
@@ -1405,7 +1405,7 @@
  *
  * @param $form
  *   The form element whose value is being populated.
-*  @param $input
+ *  @param $input
  *   The incoming input to populate the form element. If this is FALSE,
  *   the element's default value should be returned.
  * @return
@@ -1583,6 +1583,9 @@
   }
 }
 
+/**
+ * Flattens an object or nested array into a depth 1 array.
+ */
 function form_options_flatten($array, $reset = TRUE) {
   // $reset has been ignored here as the function recurses, retaining
   // its value while recursing and resetting itself when called.
@@ -1817,7 +1820,7 @@
 }
 
 /**
- * Expand a password_confirm field into two text boxes.
+ * Expands a password_confirm field into two text boxes.
  */
 function form_process_password_confirm($element) {
   $element['pass1'] =  array(
@@ -2183,6 +2186,9 @@
   return $element;
 }
 
+/**
+ * Processes checkboxes elements into individual checkbox elements.
+ */
 function form_process_checkboxes($element) {
   $value = is_array($element['#value']) ? $element['#value'] : array();
   $element['#tree'] = TRUE;