Define the error conditions for ALooper_pollOnce.
"Unrecoverable internal errors" here means that ALOOPER_POLL_ERROR
will be returned if the internal epoll_wait call fails with something
other than EINTR. I could say that explicitly, but I think the
important info for the caller is "you're doomed, just abort".
Bug: None
Test: None
Change-Id: I869f29122500ee8c71390cae1c28108a63088a77
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