From b163870d46488df0cc068b27f91fb8df6ea66515 Mon Sep 17 00:00:00 2001
From: Raph Levien <raph@google.com>
Date: Wed, 27 Apr 2016 11:02:12 -0700
Subject: [PATCH] Give guidance on alternatives to deprecated locale field

The deprecation message for the "locale" field should clearly state
what to do instead when only the primary locale is needed.

Bug: 27532422
Change-Id: I3e83cc1e9054d4e199d7e34b1a42b7bcd6c77f62
---
 core/java/android/content/res/Configuration.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/core/java/android/content/res/Configuration.java b/core/java/android/content/res/Configuration.java
index 9b1d4627807cd..177374c7abc87 100644
--- a/core/java/android/content/res/Configuration.java
+++ b/core/java/android/content/res/Configuration.java
@@ -87,7 +87,8 @@ public final class Configuration implements Parcelable, Comparable<Configuration
      * resource qualifier.
      *
      * @deprecated Do not set or read this directly. Use {@link #getLocales()} and
-     * {@link #setLocales(LocaleList)}.
+     * {@link #setLocales(LocaleList)}. If only the primary locale is needed,
+     * <code>getLocales().get(0)</code> is now the preferred accessor.
      */
     @Deprecated public Locale locale;