Merge "Define the error conditions for ALooper_pollOnce." into main am: ec4fb37b08

Original change: https://android-review.googlesource.com/c/platform/frameworks/native/+/3073883

Change-Id: Iaee4f7c355d720369b7f874ef834bb57bdcb9052
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
diff --git a/include/android/looper.h b/include/android/looper.h
index dba2e89..d80a366 100644
--- a/include/android/looper.h
+++ b/include/android/looper.h
@@ -193,8 +193,9 @@
  * Returns ALOOPER_POLL_TIMEOUT if there was no data before the given timeout
  * expired. The poll may also have been explicitly woken by ALooper_wake.
  *
- * Returns ALOOPER_POLL_ERROR if an error occurred. The poll may also have been
- * explicitly woken by ALooper_wake.
+ * Returns ALOOPER_POLL_ERROR if the calling thread has no associated Looper or
+ * for unrecoverable internal errors. The poll may also have been explicitly
+ * woken by ALooper_wake.
  *
  * Returns a value >= 0 containing an identifier (the same identifier `ident`
  * passed to ALooper_addFd()) if its file descriptor has data and it has no