From 5d7751d8316dee786d771c1ecfa6e52f853e4e46 Mon Sep 17 00:00:00 2001
From: Bob Vincent <bobvin@pillars.net>
Date: Fri, 1 Jul 2011 14:41:59 -0400
Subject: [PATCH] Document the new prevent property of ajax settings.

---
 developer/topics/forms_api_reference.html |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/developer/topics/forms_api_reference.html b/developer/topics/forms_api_reference.html
index 28b69fb6167a8f8f21f5c6d78e17a9b6c3074309..9eae92c6769a567cf31750bd42bb0dea5fe3012a 100644
--- a/developer/topics/forms_api_reference.html
+++ b/developer/topics/forms_api_reference.html
@@ -2772,7 +2772,19 @@ used for many situations.</p>
 
 <p><strong>Values</strong>: String containing a Drupal menu path.</p>
 
+<h3><a name="ajax_prevent" id="ajax_prevent">#ajax['prevent']</a></h3>
 
+<p><strong>Description</strong>:
+Binding to mousedown rather than click means that it is possible to trigger a
+click by pressing the mouse, holding the mouse button down until the Ajax
+request is complete and the button is re-enabled, and then releasing the mouse
+button. Set 'prevent' so that ajax.js binds an additional handler to prevent
+such a click from triggering a non-Ajax form submission. This also prevents a
+textfield's ENTER press triggering this button's non-Ajax form submission
+behavior.</p>
+
+<p><strong>Values</strong>:
+String. Possible values: Any valid <a href="http://docs.jquery.com/Events">jQuery event</a>, including 'click' (default), 'mousedown', 'blur', 'change', etc.</p>
 
 <h3><a name="ajax_progress" id="ajax_progress">#ajax['progress']</a></h3>
 
-- 
1.7.4.1