From 4f226dfe73427519bf001ab1477eab893a7bb101 Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Tue, 18 Aug 2026 11:20:28 +0200 Subject: [PATCH] ref-manual/variables.rst: document the PACKAGE_NO_LOCALE variable Added by commit 4b46c1f6e891 ("Initial population") in OE-Core (2005!). Link: https://patch.msgid.link/20260818-packagefuncs-v1-1-1f26764cbdd3@bootlin.com (From yocto-docs rev: 1cf267bd4dbd0c0ffbdc5a36dd608dae731b6640) Signed-off-by: Antonin Godard (cherry picked from commit 6d69a4744a4d1cfa45dafcf5af28658cafe30a1e) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker --- documentation/ref-manual/variables.rst | 47 ++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index c7f4843371..9e97f9639f 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -6579,6 +6579,53 @@ system and gives an overview of their function and contents. install, the build system does not generate an error. This variable is generally not user-defined. + :term:`PACKAGE_NO_LOCALE` + The :term:`PACKAGE_NO_LOCALE` variable can be set to "1" to prevent the + :term:`OpenEmbedded Build System` from splitting the locales found in the + :term:`PKGD` directory into split packages. + + For example, the ``quilt`` recipe automatically produces split packages + after the :ref:`ref-tasks-package` task is run. Taking a look inside the + :term:`WORKDIR` directory of ``quilt``: + + .. code-block:: console + + $ ls -1 packages-split/ + guards + guards-doc + quilt + quilt-dbg + quilt-dev + quilt-doc + quilt-locale-de + quilt-locale-fr + quilt-locale-ja + quilt-locale-ru + quilt-ptest + quilt-src + quilt-staticdev + + We can see the ``quilt-locale-*`` packages were automatically generated. + Setting :term:`PACKAGE_NO_LOCALE` to "1" would produce the following + packages: + + .. code-block:: console + + $ ls -1 packages-split/ + guards + guards-doc + quilt + quilt-dbg + quilt-dev + quilt-doc + quilt-locale + quilt-ptest + quilt-src + quilt-staticdev + + The ``quilt-locale`` package contains the merged content of the previous + ``quilt-locale-*`` packages. + :term:`PACKAGE_PREPROCESS_FUNCS` Specifies a list of functions run to pre-process the :term:`PKGD` directory prior to splitting the files out