From fce30b57e2fbe750cdebf1794d3917f3176d06ce Mon Sep 17 00:00:00 2001
From: Chris Rebert <code@rebertia.com>
Date: Tue, 5 May 2015 14:59:32 -0700
Subject: [PATCH 1/2] Mark stateful button feature as deprecated

Refs https://github.com/twbs/bootstrap/issues/16362#issuecomment-96268469
[skip sauce]
---
 docs/_includes/js/buttons.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/_includes/js/buttons.html b/docs/_includes/js/buttons.html
index 827906cd88..bd4644b3c8 100644
--- a/docs/_includes/js/buttons.html
+++ b/docs/_includes/js/buttons.html
@@ -10,6 +10,7 @@
 
   <h2 id="buttons-stateful">Stateful</h2>
   <p>Add <code>data-loading-text="Loading..."</code> to use a loading state on a button.</p>
+  <p><strong class="text-danger">This feature is deprecated since v3.3.5 and will be removed in v4.</strong></p>
   <div class="bs-callout bs-callout-info" id="callout-buttons-state-names">
     <h4>Use whichever state you like!</h4>
     <p>For the sake of this demonstration, we are using <code>data-loading-text</code> and <code>$().button('loading')</code>, but that's not the only state you can use. <a href="#buttons-methods">See more on this below in the <code>$().button(string)</code> documentation</a>.</p>

From 89f2c5c5c04022e2e6381d361c66395d99c570d5 Mon Sep 17 00:00:00 2001
From: Chris Rebert <code@rebertia.com>
Date: Tue, 5 May 2015 15:02:07 -0700
Subject: [PATCH 2/2] Document that $(...).button('reset') is async.

Closes #16362.
[skip sauce]
---
 docs/_includes/js/buttons.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/_includes/js/buttons.html b/docs/_includes/js/buttons.html
index bd4644b3c8..55009dee2f 100644
--- a/docs/_includes/js/buttons.html
+++ b/docs/_includes/js/buttons.html
@@ -120,7 +120,7 @@
   <p>Toggles push state. Gives the button the appearance that it has been activated.</p>
 
   <h4><code>$().button('reset')</code></h4>
-  <p>Resets button state - swaps text to original text.</p>
+  <p>Resets button state - swaps text to original text. <strong>This method is asynchronous and returns before the resetting has actually completed.</strong></p>
 
   <h4><code>$().button(string)</code></h4>
   <p>Swaps text to any data defined text state.</p>