From 3f783c56cb8ce07853bb3db25bfc26b4264309ac Mon Sep 17 00:00:00 2001
From: Mac_Weber <Mac_Weber@789986.no-reply.drupal.org>
Date: Tue, 18 Oct 2011 20:27:15 -0200
Subject: [PATCH] Issue #570314: more detailed form_set_value() documentation

---
 includes/form.inc |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/includes/form.inc b/includes/form.inc
index 8c3b14a..3481417 100644
--- a/includes/form.inc
+++ b/includes/form.inc
@@ -2403,11 +2403,12 @@ function form_type_token_value($element, $input = FALSE) {
 }
 
 /**
- * Change submitted form values during form validation.
+ * Changes submitted form values in $form_state.
  *
  * Use this function to change the submitted value of a form element in a form
  * validation function, so that the changed value persists in $form_state
- * through to the submission handlers.
+ * the value in $element['#value'], only in $form_state['values'], which is 
+ * where submitted values are always stored.
  *
  * Note that form validation functions are specified in the '#validate'
  * component of the form array (the value of $form['#validate'] is an array of
-- 
1.7.7

