From 1eba503ef2a79cde2ae69084a791254732bb2ab6 Mon Sep 17 00:00:00 2001
From: Steven Moreland <smoreland@google.com>
Date: Wed, 22 Mar 2023 22:15:18 +0000
Subject: [PATCH] RemoteException: more docs

Provide info about other types of exceptions that may be
thrown from binder services and mention
DeadObjectException.

Bug: 150808347
Test: N/A
Change-Id: Ic95e4c8f7efb5527bfc0d9c72cdd645983e71bb3
---
 core/java/android/os/RemoteException.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/core/java/android/os/RemoteException.java b/core/java/android/os/RemoteException.java
index 878e1413a8c92..970f4192c36c0 100644
--- a/core/java/android/os/RemoteException.java
+++ b/core/java/android/os/RemoteException.java
@@ -21,6 +21,12 @@ import android.util.AndroidException;
 
 /**
  * Parent exception for all Binder remote-invocation errors
+ *
+ * Note: not all exceptions from binder services will be subclasses of this.
+ *   For instance, RuntimeException and several subclasses of it may be
+ *   thrown as well as OutOfMemoryException.
+ *
+ * One common subclass is {@link DeadObjectException}.
  */
 public class RemoteException extends AndroidException {
     public RemoteException() {