API Doc: Revision to vmousedown

Author: AliciaLippert

entries/vmousedown.xml

@@ -4,6 +4,9 @@
 	<desc>Virtualized mouseover event handler.</desc>
 	<longdesc>
 		<p>The jQuery Mobile <code>vmousedown</code> event handler simulates the "onmousedown" event handler on mobile devices. This event is fired on the initial touch of the screen on the device.</p>
+		<p><i>Warning: Requires a mouse-type device to work.</i></p>
+		<p>The idea behind virtualized mouse events is to translate touch events into mouse events. Developers should be aware that these virtualized mouse events will not prevent any synthetic mouse events from being triggered inside the browser after a touch event. If a mouse-type device is used on the system, the virtualized mouse events are dispatched at the same time as the normal mouse events.</p>
+
 		<xi:include href="../includes/core-extension-desc.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
 		<pre>
 		<code><![CDATA[
@@ -16,9 +19,10 @@
 	</longdesc>
 	<added>1.0</added>
 	<signature>
-		<argument name="callback" type="Function" optional="true">
-			<desc>A function to invoke after the vmousedown event is fired.</desc>
+		<argument name="preventDefault" type="Function" optional="true">
+			<desc>A function to invoke in the event binding to prevent the synthetic click event by the browser.</desc>
 		</argument>
+
 	</signature>
 	<pre>
 		<code>