summaryrefslogtreecommitdiffstats
path: root/man/homectl.xml
diff options
context:
space:
mode:
authorAdrian Vovk <adrianvovk@gmail.com>2024-02-04 18:27:01 +0100
committerAdrian Vovk <adrianvovk@gmail.com>2024-02-13 23:39:14 +0100
commit49e55abb7f74f0ae38e81356654746affa0d290f (patch)
tree33a3d9cee0903ea9752e8dff36a010462ad3a894 /man/homectl.xml
parentlocale-util: Restrict valid locales (diff)
downloadsystemd-49e55abb7f74f0ae38e81356654746affa0d290f.tar.xz
systemd-49e55abb7f74f0ae38e81356654746affa0d290f.zip
user-record: Add languages field
This field is like preferredLanguage, but takes a priority list of languages instead. If an app isn't translated into a user's primary language, it can fall back to one of the other languages in the list thus making the app more accessible to the user. For instance: in my experience, many Ukrainians are fluent in Russian, often significantly better than English (especially if they are of a generation that grew up during the USSR). Such a person might set this new variable to ["uk_UA.UTF-8", "ru_UA.UTF-8"] so that software that lacks Ukrainian translations will first try Russian translations before defaulting to English. Fixes #31290
Diffstat (limited to 'man/homectl.xml')
-rw-r--r--man/homectl.xml9
1 files changed, 5 insertions, 4 deletions
diff --git a/man/homectl.xml b/man/homectl.xml
index 0143b2ac4e..0e79f82e0f 100644
--- a/man/homectl.xml
+++ b/man/homectl.xml
@@ -366,10 +366,11 @@
<varlistentry>
<term><option>--language=</option><replaceable>LANG</replaceable></term>
- <listitem><para>Takes a specifier indicating the preferred language of the user. The
- <varname>$LANG</varname> environment variable is initialized from this value on login, and thus a
- value suitable for this environment variable is accepted here, for example
- <option>--language=de_DE.UTF8</option>.</para>
+ <listitem><para>Takes a comma- or colon-separated list of languages preferred by the user, ordered
+ by descending priority. The <varname>$LANG</varname> and <varname>$LANGUAGE</varname> environment
+ variables are initialized from this value on login, and thus values suitible for these environment
+ variables are accepted here, for example <option>--language=de_DE.UTF-8</option>. This option may
+ be used more than once, in which case the language lists are concatenated.</para>
<xi:include href="version-info.xml" xpointer="v245"/></listitem>
</varlistentry>