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