From d6fe9f9f9977d834ab5397c427dfa683d61deec8 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: f0a786c185ca4d8fa1e1f2f64e2af5465d9ac4aa) 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/poky.yaml.in | 3 +-- documentation/ref-manual/system-requirements.rst | 17 +++++++++++++++++ 2 files changed, 18 insertions(+), 2 deletions(-) (limited to 'documentation') diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in index 0c04b615ea..197e6c757a 100644 --- a/documentation/poky.yaml.in +++ b/documentation/poky.yaml.in @@ -13,8 +13,7 @@ YOCTO_RELEASE_DL_URL : "&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;" UBUNTU_HOST_PACKAGES_ESSENTIAL : "gawk wget git diffstat unzip texinfo gcc \ build-essential chrpath socat cpio python3 python3-pip python3-pexpect \ xz-utils debianutils iputils-ping python3-git python3-jinja2 \ - python3-subunit zstd liblz4-tool file locales libacl1 - \n\ $ sudo locale-gen en_US.UTF-8" + python3-subunit zstd liblz4-tool file locales libacl1" FEDORA_HOST_PACKAGES_ESSENTIAL : "gawk make wget tar bzip2 gzip python3 unzip perl patch \ diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath \ ccache perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue perl-bignum socat \ diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index 0fc92550a5..43c3c5834b 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst @@ -152,8 +152,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