From c2299de4ecd91b72aff78ace029db4542e2dcdd1 Mon Sep 17 00:00:00 2001
From: Scott Main <smain@google.com>
Date: Mon, 14 Feb 2011 11:37:50 -0800
Subject: [PATCH] docs: add clarification to split touch events

Change-Id: If7904475a40905c603b5bf756fecc007073f6242
---
 docs/html/sdk/android-3.0.jd | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/docs/html/sdk/android-3.0.jd b/docs/html/sdk/android-3.0.jd
index 4be98e634aa16..1f1f6d3c90a7c 100644
--- a/docs/html/sdk/android-3.0.jd
+++ b/docs/html/sdk/android-3.0.jd
@@ -717,21 +717,23 @@ href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code android:
 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/activity-element.html">{@code &lt;activity
 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>