This is an automated email from the ASF dual-hosted git repository.
ppalaga pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git
The following commit(s) were added to refs/heads/main by this push:
new b9f532f Document locale limitations in native mode #2522
b9f532f is described below
commit b9f532f5044c93e8ba7787ced49ec425adbdcb15
Author: Peter Palaga <[email protected]>
AuthorDate: Mon May 17 17:17:30 2021 +0200
Document locale limitations in native mode #2522
---
docs/modules/ROOT/pages/user-guide/native-mode.adoc | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/docs/modules/ROOT/pages/user-guide/native-mode.adoc
b/docs/modules/ROOT/pages/user-guide/native-mode.adoc
index 1ff9cf2..5911594 100644
--- a/docs/modules/ROOT/pages/user-guide/native-mode.adoc
+++ b/docs/modules/ROOT/pages/user-guide/native-mode.adoc
@@ -25,6 +25,22 @@ quarkus.native.add-all-charsets = true
See also
https://quarkus.io/guides/all-config#quarkus-core_quarkus.native.add-all-charsets[quarkus.native.add-all-charsets]
in Quarkus documentation.
+[[locale]]
+== Locale
+
+Before GraalVM 21.1, only the building JVM's default locale was included in
the native image.
+Quarkus offered a way to set that locale via `application.properties`, so that
you did not need to rely on `LANG` and `LC_*` environement variables:
+
+[source,properties]
+----
+quarkus.native.user-country=US
+quarkus.native.user-language=en
+----
+
+Since https://medium.com/graalvm/graalvm-21-1-96e18f6806bf#7ce8[GraalVM 21.1],
there is a support for embedding multiple locales into the native image
+and for selecting the default locale via GraalVM command line options
`-H:IncludeLocales=fr,en`, `H:+IncludeAllLocales` and `-H:DefaultLocale=de`.
+You can set those via Quarkus `quarkus.native.additional-build-args` property.
+
[[embedding-resource-in-native-executable]]
== Embedding resources in the native executable
