From a52815ad696d1345731ece57dab880227660e919 Mon Sep 17 00:00:00 2001
From: Santiago Seifert <aquilescanta@google.com>
Date: Tue, 20 Dec 2022 17:13:02 +0000
Subject: [PATCH] Add info about system's ordering to javadoc

Change-Id: I5633752dc3f461a74738e2988bbf4fad84ace5eb
Test: N/A. Javadoc change.
Bug: 241888071
Bug: 235352899
---
 media/java/android/media/RouteListingPreference.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/media/java/android/media/RouteListingPreference.java b/media/java/android/media/RouteListingPreference.java
index 6557277041c29..d74df7ad31d84 100644
--- a/media/java/android/media/RouteListingPreference.java
+++ b/media/java/android/media/RouteListingPreference.java
@@ -87,6 +87,9 @@ public final class RouteListingPreference implements Parcelable {
      * Returns true if the application would like media route listing to use the system's ordering
      * strategy, or false if the application would like route listing to respect the ordering
      * obtained from {@link #getItems()}.
+     *
+     * <p>The system's ordering strategy is implementation-dependent, but may take into account each
+     * route's recency or frequency of use in order to rank them.
      */
     public boolean getUseSystemOrdering() {
         return mUseSystemOrdering;