From 541499a772ee569c173af8280308c31bf07599c8 Mon Sep 17 00:00:00 2001
From: Soonil Nagarkar <sooniln@google.com>
Date: Thu, 4 Feb 2021 08:30:38 -0800
Subject: [PATCH] Update deprecation docs with more info

Add additional javadoc around LocationProvider deprecation.

Bug: 178651398
Test: na
Change-Id: I601fccaf897400667a4dc4f9a9d1af5150a234a1
---
 location/java/android/location/LocationProvider.java | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/location/java/android/location/LocationProvider.java b/location/java/android/location/LocationProvider.java
index 60b251ea990d4..26cf0188f046f 100644
--- a/location/java/android/location/LocationProvider.java
+++ b/location/java/android/location/LocationProvider.java
@@ -23,7 +23,9 @@ import android.location.provider.ProviderProperties;
  * Information about the properties of a location provider.
  *
  * @deprecated This class is incapable of representing unknown provider properties and may return
- * incorrect results when the properties are unknown.
+ * incorrect results on the rare occasion when a provider's properties are unknown. Prefer using
+ * {@link LocationManager#getProviderProperties(String)} to retrieve {@link ProviderProperties}
+ * instead.
  */
 @Deprecated
 public class LocationProvider {