From 7fb15ce74bbc06c88660440f84845a1f3108c3d3 Mon Sep 17 00:00:00 2001
From: Santos Cordon <santoscordon@google.com>
Date: Fri, 17 May 2013 14:48:54 -0700
Subject: Update documentation of NEW_OUTGOING_CALL

Adds call-handling as a use case for NEW_OUTGOING_CALL

Change-Id: Ie511438bd8d9aa245881f050d32221c81e898745
---
 core/java/android/content/Intent.java | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'core/java/android/content/Intent.java')

diff --git a/core/java/android/content/Intent.java b/core/java/android/content/Intent.java
index cf0603e..6f41fb3 100644
--- a/core/java/android/content/Intent.java
+++ b/core/java/android/content/Intent.java
@@ -2255,6 +2255,10 @@ public class Intent implements Parcelable, Cloneable {
      * <p>Emergency calls cannot be intercepted using this mechanism, and
      * other calls cannot be modified to call emergency numbers using this
      * mechanism.
+     * <p>Some apps (such as VoIP apps) may want to redirect the outgoing
+     * call to use their own service instead. Those apps should first prevent
+     * the call from being placed by setting resultData to <code>null</code>
+     * and then start their own app to make the call.
      * <p>You must hold the
      * {@link android.Manifest.permission#PROCESS_OUTGOING_CALLS}
      * permission to receive this Intent.</p>
-- 
cgit v1.1