commit c2299de4ecd91b72aff78ace029db4542e2dcdd1
author Scott Main <smain@google.com> Mon Feb 14 11:37:50 2011 -0800
committer Scott Main <smain@google.com> Mon Feb 14 11:37:50 2011 -0800
tree 07733ec3563a1a10c91ef08c5f4bdce8d1d15c28
parent ea72329bcc360437d67492bc4f2c82e65e8ba841

docs: add clarification to split touch events

Change-Id: If7904475a40905c603b5bf756fecc007073f6242

docs/html/sdk/android-3.0.jd

diff --git a/docs/html/sdk/android-3.0.jd b/docs/html/sdk/android-3.0.jd
index 4be98e6..1f1f6d3 100644
--- a/docs/html/sdk/android-3.0.jd
+++ b/docs/html/sdk/android-3.0.jd
@@ -717,21 +717,23 @@
 or <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code
 android:targetSdkVersion}</a> attribute's value to {@code "11"}.</p>
 
-<p>However, the following properties allow you to disable split touch events for
-specific view groups, certain activities, or the entire application.</p>
+<p>However, the following properties allow you to disable split touch events across views inside
+specific view groups and across windows.</p>
 
 <ul>
 <li>The {@link android.R.attr#splitMotionEvents android:splitMotionEvents} attribute for view groups
-allows you to disable split motion events for the children in a layout. For example:
+allows you to disable split touch events that occur between child views in a layout. For example:
 <pre>
 &lt;LinearLayout android:splitMotionEvents="false" ... >
     ...
 &lt;/LinearLayout>
 </pre>
+<p>This way, child views in the linear layout cannot split touch events&mdash;only one view can
+receive touch events at a time.</p>
 </li>
 
 <li>The {@link android.R.attr#windowEnableSplitTouch android:windowEnableSplitTouch} style property
-allows you to disable split motion events across windows by applying it to a theme for the activity
+allows you to disable split touch events across windows, by applying it to a theme for the activity
 or entire application. For example:
 <pre>
 &lt;style name="NoSplitMotionEvents" parent="android:Theme.Holo">
@@ -744,7 +746,8 @@
 href="{@docRoot}guide/topics/manifest/application-element.html">{@code &lt;application&gt;}</a>,
 only touch events within the current activity window are accepted. For example, by disabling split
 touch events across windows, the system bar cannot receive touch events at the same time as the
-activity.</p>
+activity. This does <em>not</em> affect whether views inside the activity can split touch
+events&mdash;by default, the activity can still split touch events across views.</p>
 
 <p>For more information about creating a theme, read <a
 href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a>.</p>