1
0
mirror of https://git.yoctoproject.org/poky synced 2026-06-02 13:29:49 +00:00

ref-manual: Clarify recommended operator for PROVIDES

Updates the documentation for PROVIDES so that it recommends "+="
instead of "=".

(From yocto-docs rev: 39b2ca1e27592488d396d5f0d76965f0006515a1)

Signed-off-by: Joshua Watt <JPEWhacker@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Joshua Watt
2021-01-19 10:42:00 -06:00
committed by Richard Purdie
parent 164db40a72
commit f236145ce4
+4 -11
View File
@@ -5915,23 +5915,16 @@ system and gives an overview of their function and contents.
file ``eudev_3.2.9.bb``: file ``eudev_3.2.9.bb``:
:: ::
PROVIDES = "udev" PROVIDES += "udev"
The ``PROVIDES`` statement The ``PROVIDES`` statement
results in the "eudev" recipe also being available as simply "udev". results in the "eudev" recipe also being available as simply "udev".
.. note:: .. note::
Given that a recipe's own recipe name is already implicitly in its A recipe's own recipe name (:term:`PN`) is always implicitly prepended
own PROVIDES list, it is unnecessary to add aliases with the "+=" operator; to `PROVIDES`, so while using "+=" in the above example may not be
using a simple assignment will be sufficient. In other words, strictly necessary it is recommended to avoid confusion.
while you could write:
::
PROVIDES += "udev"
in the above, the "+=" is overkill and unnecessary.
In addition to providing recipes under alternate names, the In addition to providing recipes under alternate names, the
``PROVIDES`` mechanism is also used to implement virtual targets. A ``PROVIDES`` mechanism is also used to implement virtual targets. A