diff mbox series

[5/7] ref-manual/variables.rst: document the LOCALE_UTF8_IS_DEFAULT variable

Message ID 20260630-sync-documentation-conf-v1-5-da14b40cb515@bootlin.com
State New
Headers show
Series Sync yocto-docs glossary with meta/conf/documentation.conf | expand

Commit Message

Antonin Godard June 30, 2026, 8:13 a.m. UTC 
Added by commit fcde0c43f7b5 ("libc-package.bbclass: add
LOCALE_UTF8_IS_DEFAULT") in OE-Core.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/variables.rst | 7 +++++++
 1 file changed, 7 insertions(+)
diff mbox series

Patch

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 231f61d37..20bcf8d60 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -6083,6 +6083,13 @@  system and gives an overview of their function and contents.
       :ref:`overview-manual/concepts:Package Splitting`. The list
       contains ``${datadir}/locale`` by default.
 
+   :term:`LOCALE_UTF8_IS_DEFAULT`
+      If set, locale names are renamed such that those lacking an explicit
+      encoding (e.g. ``en_US``) will always be UTF-8, and non-UTF-8 encodings
+      are renamed to, e.g., ``en_US.ISO-8859-1``. Otherwise, the encoding is
+      specified by `Glibc`'s ``SUPPORTED`` file. This not supported for
+      precompiled locales.
+
    :term:`LOG_DIR`
       Specifies the directory to which the OpenEmbedded build system writes
       overall log files. The default directory is ``${TMPDIR}/log``.