summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorPaul Eggleton <paul.eggleton@microsoft.com>2022-10-09 17:39:46 +1300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-10-19 17:32:57 +0100
commit1bdb6457ddae110e76c0bf95b649f3fe9c74a91f (patch)
treea817e952c58b849fae206e4dd538176e6501e404 /documentation
parentb1d17778658275a7757419f53bd47ed3906d50b2 (diff)
downloadpoky-1bdb6457ddae110e76c0bf95b649f3fe9c74a91f.tar.gz
ref-manual: complementary package installation recommends
Add a note to the COMPLEMENTARY_GLOB variable glossary entry mentioning that recommends aren't installed (since this seems to be the only place that complementary package installation is really discussed). Also turn the paragraph about globbing into a regular paragraph as I don't think it should be called out in a note block. (From yocto-docs rev: abc67b101b0821b174eb65bc13922a8bee1016eb) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/variables.rst15
1 files changed, 9 insertions, 6 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index f8da00c7ce..0622bedf84 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -1171,12 +1171,10 @@ system and gives an overview of their function and contents.
1171 packages for all the packages explicitly (or implicitly) installed in 1171 packages for all the packages explicitly (or implicitly) installed in
1172 an image. 1172 an image.
1173 1173
1174 .. note:: 1174 The :term:`COMPLEMENTARY_GLOB` variable uses Unix filename pattern matching
1175 1175 (`fnmatch <https://docs.python.org/3/library/fnmatch.html#module-fnmatch>`__),
1176 The :term:`COMPLEMENTARY_GLOB` variable uses Unix filename pattern matching 1176 which is similar to the Unix style pathname pattern expansion
1177 (`fnmatch <https://docs.python.org/3/library/fnmatch.html#module-fnmatch>`__), 1177 (`glob <https://docs.python.org/3/library/glob.html>`__).
1178 which is similar to the Unix style pathname pattern expansion
1179 (`glob <https://docs.python.org/3/library/glob.html>`__).
1180 1178
1181 The resulting list of complementary packages is associated with an 1179 The resulting list of complementary packages is associated with an
1182 item that can be added to 1180 item that can be added to
@@ -1191,6 +1189,11 @@ system and gives an overview of their function and contents.
1191 1189
1192 COMPLEMENTARY_GLOB[dev-pkgs] = '*-dev' 1190 COMPLEMENTARY_GLOB[dev-pkgs] = '*-dev'
1193 1191
1192 .. note::
1193
1194 When installing complementary packages, recommends relationships
1195 (set via :term:`RRECOMMENDS`) are always ignored.
1196
1194 :term:`COMPONENTS_DIR` 1197 :term:`COMPONENTS_DIR`
1195 Stores sysroot components for each recipe. The OpenEmbedded build 1198 Stores sysroot components for each recipe. The OpenEmbedded build
1196 system uses :term:`COMPONENTS_DIR` when constructing recipe-specific 1199 system uses :term:`COMPONENTS_DIR` when constructing recipe-specific