From 9a14f7a3dd24111b1972e407309c6a9fadaacdca Mon Sep 17 00:00:00 2001
From: Marcin Wosinek <marcin.wosinek@gmail.com>
Date: Tue, 31 Jul 2012 15:25:05 +0200
Subject: [PATCH] Issue #1627654 by joachim, marcin.wosinek: fix doc for drupal_redirect_form

---
 core/includes/form.inc |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)

diff --git a/core/includes/form.inc b/core/includes/form.inc
index 0c9cd5d..3d98a62 100644
--- a/core/includes/form.inc
+++ b/core/includes/form.inc
@@ -1213,6 +1213,12 @@ function drupal_validate_form($form_id, &$form, &$form_state) {
  * );
  * @endcode
  *
+ * However, in case it was not defined and the current request contains a
+ * 'destination' query string, drupal_goto() will redirect to that given
+ * destination instead. If both are defined, the 'destination' query string is
+ * used. To prevent redirection completely even if a 'destination' query string
+ * is present, set $form_state['redirect'] to FALSE.
+ *
  * There are several triggers that may prevent a redirection though:
  * - If $form_state['redirect'] is FALSE, a form builder function or form
  *   validation/submit handler does not want a user to be redirected, which
-- 
1.7.0.4

