Merge "Update javadoc for getDeclaredInstances." am: 5d7776c28a

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/2305921

Change-Id: I3b54a28fe405e49f9d8a557f2e06769c669700a0
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>

core/java/android/os/ServiceManager.java

@@ -252,10 +252,12 @@ public final class ServiceManager {
     }
 
     /**
-     * Returns the list of declared instances for an interface.
+     * Returns an array of all declared instances for a particular interface.
+     *
+     * For instance, if 'android.foo.IFoo/foo' is declared (e.g. in VINTF
+     * manifest), and 'android.foo.IFoo' is passed here, then ["foo"] would be
+     * returned.
      *
-     * @return true if the service is declared somewhere (eg. VINTF manifest) and
-     * waitForService should always be able to return the service.
      * @hide
      */
     @SystemApi(client = SystemApi.Client.MODULE_LIBRARIES)