Merge "Update javadoc for getDeclaredInstances." am: 5d7776c28a am: 9cde85d84f am: 0fb5d7af4d

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

Change-Id: Iae6ed393ed1b4d764f231e71047831e94b69dce5
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)