From c0ce3327b0a1cbb447f3b782ec439e4b8e815449 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dan=20=C4=8Cerm=C3=A1k?= Date: Wed, 13 Nov 2019 12:18:08 +0100 Subject: [PATCH] Document possible values for the name attribute of package This fixes #1260 Co-Authored-By: Thomas Schraitle --- .../working_with_kiwi/xml_description.rst | 22 ++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/doc/source/working_with_kiwi/xml_description.rst b/doc/source/working_with_kiwi/xml_description.rst index 48291d2c..6ec6c6d5 100644 --- a/doc/source/working_with_kiwi/xml_description.rst +++ b/doc/source/working_with_kiwi/xml_description.rst @@ -780,7 +780,27 @@ removed), whose name is specified via the mandatory `name` attribute: which adds the package `udev` to the list of packages to be added to the -initial filesystem. +initial filesystem. Note, that the value that you pass via the `name` +attribute is passed directly to the used package manager. Thus, if the +package manager supports other means how packages can be specified, you may +pass them in this context too. For example, RPM based package managers +(like :command:`dnf` or :command:`zypper`) can install packages via their +`Provides:`. This can be used to add a package that provides a certain +capability (e.g. `Provides: /usr/bin/my-binary`) via: + +.. code:: xml + + + + + + + + +Whether this works depends on the package manager and on the environment +that is being used. In the Open Build Service, certain `Provides` either +are not visible or cannot be properly extracted from the KIWI +description. Therefore, relying on `Provides` is not recommended. Packages can also be included only on specific architectures via the `arch` attribute. KIWI compares the `arch` attributes value with the output of