Skip to content

Commit 6a8e15f

Browse files
author
ripley
committed
add comments on choosing translation catalogues
git-svn-id: https://svn.r-project.org/R/trunk@88005 00db46b3-68df-0310-9c12-caf00c1e9a41
1 parent 325cf1b commit 6a8e15f

File tree

1 file changed

+15
-2
lines changed

1 file changed

+15
-2
lines changed

doc/manual/R-admin.texi

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2775,8 +2775,9 @@ This can be overridden first by the setting of the environment variable
27752775
@enindex LC_ALL
27762776
@enindex LC_MESSAGES
27772777
@enindex LANG
2778-
@env{LANGUAGE} and then@footnote{On some systems setting
2779-
@env{LC_ALL} or @env{LC_MESSAGES} to @samp{C} disables @env{LANGUAGE}.}
2778+
@env{LANGUAGE} and then@footnote{On most systems setting
2779+
@env{LC_ALL} or @env{LC_MESSAGES} to @samp{C} disables
2780+
@env{LANGUAGE}. This is allowed but not required by POSIX.}
27802781
by the environment variables @env{LC_ALL}, @env{LC_MESSAGES} and
27812782
@env{LANG}. (The last three are normally used to set the locale and so
27822783
should not be needed, but the first is only used to select the language
@@ -2787,6 +2788,9 @@ names and so @env{LANGUAGE} may need to be set. (One example is
27872788
@samp{LC_ALL=es} on Windows which sets the locale to Estonian and the
27882789
language to Spanish.)
27892790

2791+
Environment variable @env{LANGUAGE} can be used to specify more than one
2792+
language (and optionally territory) separated by colons.
2793+
27902794
It is usually possible to change the language once @R{} is running
27912795
@emph{via} (not Windows) @code{Sys.setlocale("LC_MESSAGES",
27922796
"new_locale")}, or by setting an environment variable such as
@@ -2858,6 +2862,15 @@ If no suitable translation catalogue is found or a particular message is
28582862
not translated in any suitable catalogue, `English'@footnote{with
28592863
Americanisms.} is used.
28602864

2865+
Note that there are several implementations of the @code{libintl}
2866+
library used to manage message translations, includong in @code{libc}
2867+
on GNU and Alpine Linux, and as part of GNU @code{gettext} usually used
2868+
on macOS and Windows.
2869+
@c https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/V1_chap08.html#tag_08_02
2870+
The description here follows the POSIX standard, but implementations may
2871+
not.
2872+
2873+
28612874
See @uref{https://developer.r-project.org/Translations30.html} for how to
28622875
prepare and install translation catalogues.
28632876

0 commit comments

Comments
 (0)