Skip to contentSkip to conversation

Document package related variables

PATCH Applied Antonin Godard 1 participant 4 messages Aug 18 – Aug 24

lore
Share & tools
lore
#0 lore raw

cover Document package related variables

---
Antonin Godard (2):
ref-manual/variables.rst: document the PACKAGE_NO_LOCALE variable ref-manual/variables.rst: document the PACKAGEFUNCS variable

 documentation/ref-manual/variables.rst | 53 ++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

---
base-commit: 3660b8085a5e790c1ea8bf75236fff4b216fe19c
change-id: 20260417-packagefuncs-8ae76dcee83b

#1 lore raw

PATCH 1/2 ref-manual/variables.rst: document the PACKAGE_NO_LOCALE variable

Added by commit 4b46c1f6e891 ("Initial population") in OE-Core (2005!).

---
 documentation/ref-manual/variables.rst | 47 ++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
documentation/ref-manual/variables.rst +47 -0
index fa0dfdfb8..09136803c 100644
@@ -7166,6 +7166,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
Signature · 1 line
2.55.0
#2 lore raw

PATCH 2/2 ref-manual/variables.rst: document the PACKAGEFUNCS variable

In reply to Antonin Godard

Added by commit 4b46c1f6e891 ("Initial population") in OE-Core. This completes the variables used during do_package, as PACKAGE_PREPROCESS_FUNCS and PACKAGESPLITFUNCS are already documented.

---
 documentation/ref-manual/variables.rst | 6 ++++++
 1 file changed, 6 insertions(+)
documentation/ref-manual/variables.rst +6 -0
index 09136803c..724293a58 100644
@@ -7360,6 +7360,12 @@ system and gives an overview of their function and contents.
       :ref:`ref-tasks-configure` task, then you need to use
       :term:`PACKAGECONFIG_CONFARGS` appropriately.
 
+   :term:`PACKAGEFUNCS`
+      The :term:`PACKAGEFUNCS` variable holds a list of functions which are
+      executed to process metadata based on split packages found in the
+      :term:`PKGDEST` directory. These functions are executed in the
+      :ref:`ref-classes-package` class in the order found in the list.
+
    :term:`PACKAGEGROUP_DISABLE_COMPLEMENTARY`
       For recipes inheriting the :ref:`ref-classes-packagegroup` class, setting
       :term:`PACKAGEGROUP_DISABLE_COMPLEMENTARY` to "1" specifies that the
Signature · 1 line
2.55.0
author Applied
#3 lore raw
In reply to Antonin Godard

Applied, thanks!

[1/2] ref-manual/variables.rst: document the PACKAGE_NO_LOCALE variable

      commit: 6d69a4744a4d1cfa45dafcf5af28658cafe30a1e
[2/2] ref-manual/variables.rst: document the PACKAGEFUNCS variable
      commit: c3e8c602c60bf78123d6a05b83346235abf7f233