Autocomplete, Dialog: Note that the appendTo option should not be changed while the widget is open.

Author: scottgonzalez

entries/autocomplete.xml

@@ -39,7 +39,9 @@
 	<added>1.8</added>
 	<options>
 		<option name="appendTo" type="Selector" default="null" example-value='"#someElem"'>
-			<desc>Which element the menu should be appended to. When the value is <code>null</code>, the parents of the input field will be checked for a class of <code>ui-front</code>. If an element with the <code>ui-front</code> class is found, the menu will be appended to that element. Regardless of the value, if no element is found, the menu will be appended to the body.</desc>
+			<desc>
+				<p>Which element the menu should be appended to. When the value is <code>null</code>, the parents of the input field will be checked for a class of <code>ui-front</code>. If an element with the <code>ui-front</code> class is found, the menu will be appended to that element. Regardless of the value, if no element is found, the menu will be appended to the body.</p>
+				<div class="warning"><strong>Note:</strong> The <code>appendTo</code> option should not be changed while the suggestions menu is open.</div></desc>
 		</option>
 		<option name="autoFocus" type="Boolean" default="false" example-value="true">
 			<desc>If set to <code>true</code> the first item will automatically be focused when the menu is shown.</desc>

entries/dialog.xml

@@ -66,7 +66,10 @@
 	<added>1.0</added>
 	<options>
 		<option name="appendTo" type="Selector" default='"body"' example-value='"#someElem"' added="1.10.0">
-			<desc>Which element the dialog (and overlay, if <a href="#option-modal">modal</a>) should be appended to.</desc>
+			<desc>
+				<p>Which element the dialog (and overlay, if <a href="#option-modal">modal</a>) should be appended to.</p>
+				<div class="warning"><strong>Note:</strong> The <code>appendTo</code> option should not be changed while the dialog is open.</div>
+			</desc>
 		</option>
 		<option name="autoOpen" default="true" example-value="false">
 			<desc>If set to <code>true</code>, the dialog will automatically open upon initialization. If <code>false</code>, the dialog will stay hidden until the <a href="#method-open"><code>open()</code></a> method is called.</desc>