From 0bee34892d744458a5ed95550febfebd34d67c50 Mon Sep 17 00:00:00 2001 From: Guénaël Muller Date: Mon, 2 Dec 2024 12:01:28 +0100 Subject: ref-manual: use standardized method accross both ubuntu and debian for locale install MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Modify locale installation method to be standard accross all debian-based distributions. Pre-existing method is available only on Ubuntu, locale-gen tool has no parameter in Debian. (From yocto-docs rev: 057f2fbce22fc020bef7d432275e28227895e022) Signed-off-by: Guénaël Muller Reviewed-by: Yoann Congal Reviewed-by: Antonin Godard Tested-by: Antonin Godard Signed-off-by: Antonin Godard (cherry picked from commit 30002019198a168e48537407bb928facb26af82a) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman --- documentation/ref-manual/system-requirements.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index b45c863005..5b0beab7c2 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -160,8 +160,25 @@ with a supported Ubuntu or Debian Linux distribution:: $ sudo apt install &UBUNTU_HOST_PACKAGES_ESSENTIAL; +You also need to ensure you have the ``en_US.UTF-8`` locale enabled:: + + $ locale --all-locales | grep en_US.utf8 + +If this is not the case, you can reconfigure the ``locales`` package to add it +(requires an interactive shell):: + + $ sudo dpkg-reconfigure locales + .. note:: + - If you are not in an interactive shell, ``dpkg-reconfigure`` will + not work as expected. To add the locale you will need to edit + ``/etc/locale.gen`` file to add/uncomment the ``en_US.UTF-8`` locale. + A naive way to do this as root is:: + + $ echo "en_US.UTF-8 UTF-8" >> /etc/locale.gen + $ locale-gen + - If your build system has the ``oss4-dev`` package installed, you might experience QEMU build failures due to the package installing its own custom ``/usr/include/linux/soundcard.h`` on the Debian -- cgit v1.2.3-54-g00ecf