Merge "Vibrator: clarify the API"
diff --git a/include/hardware/vibrator.h b/include/hardware/vibrator.h
index 92b1fd0..200adf0 100644
--- a/include/hardware/vibrator.h
+++ b/include/hardware/vibrator.h
@@ -45,8 +45,8 @@
/** Turn on vibrator
*
- * What happens when this function is called while the the timeout of a
- * previous call has not expired is implementation dependent.
+ * This function must only be called after the previous timeout has expired or
+ * was canceled (through vibrator_off()).
*
* @param timeout_ms number of milliseconds to vibrate
*
@@ -56,8 +56,7 @@
/** Turn off vibrator
*
- * It is not guaranteed that the vibrator will be immediately stopped: the
- * behaviour is implementation dependent.
+ * Cancel a previously-started vibration, if any.
*
* @return 0 in case of success, negative errno code else
*/