Index: includes/form.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/form.inc,v
retrieving revision 1.355
diff -u -r1.355 form.inc
--- includes/form.inc	4 Aug 2009 06:38:56 -0000	1.355
+++ includes/form.inc	5 Aug 2009 13:56:10 -0000
@@ -851,7 +851,7 @@
 }
 
 /**
- * File an error against a form element.
+ * Files an error against a form element.
  *
  * @param $name
  *   The name of the form element. If the #parents property of your form
@@ -860,11 +860,9 @@
  *   element where the #parents array starts with 'foo'.
  * @param $message
  *   The error message to present to the user.
- * @param $reset
- *   Reset the form errors static cache.
  * @return
- *   Never use the return value of this function, use form_get_errors and
- *   form_get_error instead.
+ *   Return value is for internal use only. To get a list of errors, use 
+ *   form_get_errors() or form_get_error().
  */
 function form_set_error($name = NULL, $message = '') {
   $form = &drupal_static(__FUNCTION__, array());