diff --git includes/form.inc includes/form.inc
index bd20510..9fb9921 100644
--- includes/form.inc
+++ includes/form.inc
@@ -47,6 +47,8 @@
  */
 
 /**
+ * Build and process a form based on a form id.
+ *
  * Retrieves a form from a constructor function, or from the cache if
  * the form was built in a previous page-load. The form is then passed
  * on for processing, after and rendered for display if necessary.
@@ -386,6 +388,8 @@ function drupal_retrieve_form($form_id, &$form_state) {
 }
 
 /**
+ * Processes a form submission.
+ *
  * This function is the heart of form API. The form gets built, validated and in
  * appropriate cases, submitted.
  *
@@ -461,6 +465,8 @@ function drupal_process_form($form_id, &$form, &$form_state) {
 }
 
 /**
+ * Prepares form. Adds elements, executes alter hooks & inserts optional token. 
+ *
  * Prepares a structured form array by adding required elements,
  * executing any hook_form_alter functions, and optionally inserting
  * a validation token to prevent tampering.
@@ -554,6 +560,8 @@ function drupal_prepare_form($form_id, &$form, &$form_state) {
 
 
 /**
+ * Verifies form token and calls a helper function to validate form elements.
+ *
  * Validates user-submitted form data from the $form_state using
  * the validate functions defined in a structured form array.
  *
@@ -649,6 +657,8 @@ function drupal_redirect_form($form, $redirect = NULL) {
 }
 
 /**
+ * A helper function who performs validation on form elements.
+ *
  * Performs validation on form elements. First ensures required fields are
  * completed, #maxlength is not exceeded, and selected options were in the
  * list of options given to the user. Then calls user-defined validators.
@@ -741,6 +751,8 @@ function _form_validate($elements, &$form_state, $form_id = NULL) {
 }
 
 /**
+ * Helper which executes custom validation and submission handlers on a form.
+ *
  * A helper function used to execute custom validation and submission
  * handlers for a given form. Button-specific handlers are checked
  * first. If none exist, the function falls back to form-level handlers.
@@ -850,6 +862,8 @@ function form_error(&$element, $message = '') {
 }
 
 /**
+ * Builds form. Adds element properties & maps incoming $_POST to elements.
+ *
  * Walk through the structured form array, adding any required
  * properties to each element and mapping the incoming $_POST
  * data to the proper elements.
@@ -965,6 +979,8 @@ function form_builder($form_id, $form, &$form_state) {
 }
 
 /**
+ * Helper to populate properties of elements and execute attached handlers.
+ *
  * Populate the #value and #name properties of input elements so they
  * can be processed and rendered. Also, execute any #process handlers
  * attached to a specific element.
@@ -1069,8 +1085,7 @@ function _form_builder_handle_input_element($form_id, &$form, &$form_state, $com
 }
 
 /**
- * Helper function to handle the sometimes-convoluted logic of button
- * click detection.
+ * Helper to handle the convoluted logic of button click detection.
  *
  * In Internet Explorer, if ONLY one submit button is present, AND the
  * enter key is used to submit the form, no form value is sent for it
@@ -1098,6 +1113,8 @@ function _form_button_was_clicked($form) {
 }
 
 /**
+ * Helper to handle enter key submission of a form in ie.
+ *
  * In IE, if only one submit button is present, AND the enter key is
  * used to submit the form, no form value is sent for it and our normal
  * button detection code will never detect a match. We call this
@@ -1221,8 +1238,7 @@ function form_type_checkboxes_value($form, $edit = FALSE) {
 }
 
 /**
- * Helper function to determine the value for a password_confirm form
- * element.
+ * Helper function to determine the value for a password_confirm form element.
  *
  * @param $form
  *   The form element whose value is being populated.
@@ -1457,6 +1473,8 @@ function form_select_options($element, $choices = NULL) {
 }
 
 /**
+ * Finds indexes matching given $key in select element's option array.
+ *
  * Traverses a select element's #option array looking for any values
  * that hold the given key. Returns an array of indexes that match.
  *
@@ -1747,8 +1765,7 @@ function weight_value(&$form) {
 }
 
 /**
- * Roll out a single radios element to a list of radios,
- * using the options array as index.
+ * Expand radios element to a list of radios using the options array as index.
  */
 function expand_radios($element) {
   if (count($element['#options']) > 0) {
@@ -1774,6 +1791,8 @@ function expand_radios($element) {
 }
 
 /**
+ * Add AHAH info, events and javascript to the page in support of the element.
+ *
  * Add AHAH information about a form element to the page to communicate with
  * javascript. If #ahah[path] is set on an element, this additional javascript is
  * added to the page header to attach the AHAH behaviors. See ahah.js for more
@@ -1925,6 +1944,9 @@ function theme_checkboxes($element) {
   }
 }
 
+/**
+ * Expand an element into checkboxes based on the #options array.
+ */
 function expand_checkboxes($element) {
   $value = is_array($element['#value']) ? $element['#value'] : array();
   $element['#tree'] = TRUE;