Index: includes/form.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/form.inc,v
retrieving revision 1.265.2.33
diff -u -r1.265.2.33 form.inc
--- includes/form.inc	19 May 2010 15:02:32 -0000	1.265.2.33
+++ includes/form.inc	14 Jul 2010 22:39:39 -0000
@@ -248,9 +248,12 @@
 }
 
 /**
- * Retrieves a form using a form_id, populates it with $form_state['values'],
- * processes it, and returns any validation errors encountered. This
- * function is the programmatic counterpart to drupal_get_form().
+ * Retrieves, populates, and processes a form.
+ *
+ * Uses a unique form_id, populates it with $form_state['values'], and
+ * processes it. There is no return value, but you can check to see if there
+ * are errors by calling form_get_errors(). This function is the programmatic
+ * counterpart to drupal_get_form().
  *
  * @param $form_id
  *   The unique string identifying the desired form. If a function
@@ -270,7 +273,6 @@
  *   For example, the node_edit form requires that a node object be passed
  *   in here when it is called.
  * For example:
- *
  * @code
  * // register a new user
  * $form_state = array();