From 31c95fcd8f657e95c68d78dae68ca3a045a4fdf3 Mon Sep 17 00:00:00 2001
From: Chris Tate <>
Date: Thu, 2 Apr 2009 10:15:00 -0700
Subject: [PATCH] AI 144139: am: CL 144135 am: CL 144134 Fix issue 1750132 -
 SensorManager listener 'rate' parameter units are undocumented   Original
 author: ctate   Merged from: //branches/cupcake/...   Original author:
 android-build   Merged from: //branches/donutburger/...

Automated import of CL 144139
---
 core/java/android/hardware/SensorManager.java | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/core/java/android/hardware/SensorManager.java b/core/java/android/hardware/SensorManager.java
index 7fbb3a7580572..0c88a2e04072a 100644
--- a/core/java/android/hardware/SensorManager.java
+++ b/core/java/android/hardware/SensorManager.java
@@ -616,7 +616,8 @@ public class SensorManager extends IRotationWatcher.Stub
      * @param sensors a bit masks of the sensors to register to
      * @param rate rate of events. This is only a hint to the system. events
      * may be received faster or slower than the specified rate. Usually events
-     * are received faster.
+     * are received faster. The value must be one of {@link #SENSOR_DELAY_NORMAL},
+     * {@link #SENSOR_DELAY_UI}, {@link #SENSOR_DELAY_GAME}, or {@link #SENSOR_DELAY_FASTEST}.
      *
      * @return true if the sensor is supported and successfully enabled
      */
@@ -785,7 +786,9 @@ public class SensorManager extends IRotationWatcher.Stub
      * @param sensor The {@link android.hardware.Sensor Sensor} to register to.
      * @param rate The rate {@link android.hardware.SensorEvent sensor events} are delivered at.
      * This is only a hint to the system. Events may be received faster or
-     * slower than the specified rate. Usually events are received faster.
+     * slower than the specified rate. Usually events are received faster. The value must be
+     * one of {@link #SENSOR_DELAY_NORMAL}, {@link #SENSOR_DELAY_UI}, {@link #SENSOR_DELAY_GAME},
+     * or {@link #SENSOR_DELAY_FASTEST}.
      *
      * @return true if the sensor is supported and successfully enabled.
      *
@@ -802,7 +805,9 @@ public class SensorManager extends IRotationWatcher.Stub
      * @param sensor The {@link android.hardware.Sensor Sensor} to register to.
      * @param rate The rate {@link android.hardware.SensorEvent sensor events} are delivered at.
      * This is only a hint to the system. Events may be received faster or
-     * slower than the specified rate. Usually events are received faster.
+     * slower than the specified rate. Usually events are received faster. The value must be one
+     * of {@link #SENSOR_DELAY_NORMAL}, {@link #SENSOR_DELAY_UI}, {@link #SENSOR_DELAY_GAME}, or
+     * {@link #SENSOR_DELAY_FASTEST}.
      * @param handler The {@link android.os.Handler Handler} the
      * {@link android.hardware.SensorEvent sensor events} will be delivered to.
      *