diff --git a/entries/button.xml b/entries/button.xml
index 21b90ad1..a3e99052 100644
--- a/entries/button.xml
+++ b/entries/button.xml
@@ -52,9 +52,14 @@ $( "[type='submit']" ).button();
 		</longdesc>
 	<added>1.0</added>
 	<options>
-		<option name="corners" default="true" example-value="false">
-			<desc>Applies the theme button border-radius if set to true.
+		<option name="corners" default="true"  deprecated="1.5.0" example-value="false" >
+			<desc>
+				<p><strong>This option is deprecated as of jQuery Mobile 1.5.0.</strong> Applies the theme button border-radius if set to true.</p>
+				<p>Add class <code>ui-corner-none</code> to the <a href="#option-wrapperClass">wrapperClass</a> option to disable this option.</p>
 				<p>This option is also exposed as a data attribute: <code>data-corners="false"</code>.</p>
+				<pre><code><![CDATA[
+<input type="button" data-wrapper-class="ui-corner-none" value="The Button"></input>
+]]></code></pre>
 			</desc>
 			<type name="Boolean" />
 		</option>
@@ -89,9 +94,14 @@ $( "[type='submit']" ).button();
 			<type name="Boolean" />
 		</option>
 		<xi:include href="../includes/widget-option-mini.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
-		<option name="shadow" default="true">
-			<desc>Applies the drop shadow style to the <placeholder name="name"/> if set to true.
+		<option name="shadow" default="true" deprecated="1.5.0">
+			<desc>
+				<p><strong>This option is deprecated as of jQuery Mobile 1.5.0.</strong> Applies the drop shadow style to the <placeholder name="name"/> if set to true.</p>
+				<p>Add class <code>ui-shadow-none</code> to the <a href="#option-wrapperClass">wrapperClass</a> option to disable this option.</p>
 				<p>This option is also exposed as a data attribute: <code>data-shadow="false"</code>.</p>
+				<pre><code><![CDATA[
+<input type="button" data-wrapper-class="ui-shadow-none" value="The Button"></input>
+]]></code></pre>
 			</desc>
 			<type name="Boolean" />
 		</option>