Set a default locale on Android

* doc/emacs/android.texi (Android Environment): Revise for
change.

* src/android.c (initEmacs): Set LANG to either en_US.utf8 or C,
subject to whether the system is newer than Android
5.0 (inclusive).

1 files changed, 10 insertions, 0 deletions

diff --git a/doc/emacs/android.texi b/doc/emacs/android.texi
index 915ba948b93..52912d045eb 100644
--- a/doc/emacs/android.texi
+++ b/doc/emacs/android.texi
@@ -409,6 +409,16 @@ Startup}) connect the Android system to another computer, and run:
 $ adb shell "settings put global settings_enable_monitor_phantom_procs false"
 @end example
 
+@cindex C locale settings, Android
+  Emacs does not respect the locale configured for user applications
+in the system, for the selection of locales available there does not
+match that supplied by the C library.  When Emacs starts on Android
+5.0 or newer, the @code{LANG} environment variable is set to
+@code{en_US.utf8}, which induces subprocesses linked against the
+Android C library to print output sensibly.  Earlier versions of
+Android do not implement locales at all, on account of which the
+variable is set to @code{C} instead.
+
 @cindex running emacs in the background, android
 @cindex emacs killed, android
 @cindex emacs in the background, android