From f236145ce42d3486ee25dd099d6ee2f5a6597cf1 Mon Sep 17 00:00:00 2001 From: Joshua Watt Date: Tue, 19 Jan 2021 10:42:00 -0600 Subject: 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 Signed-off-by: Richard Purdie --- documentation/ref-manual/variables.rst | 15 ++++----------- 1 file changed, 4 insertions(+), 11 deletions(-) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 5ec19970e4..2cb37b6a2b 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -5915,23 +5915,16 @@ system and gives an overview of their function and contents. file ``eudev_3.2.9.bb``: :: - PROVIDES = "udev" + PROVIDES += "udev" The ``PROVIDES`` statement results in the "eudev" recipe also being available as simply "udev". .. note:: - Given that a recipe's own recipe name is already implicitly in its - own PROVIDES list, it is unnecessary to add aliases with the "+=" operator; - using a simple assignment will be sufficient. In other words, - while you could write: - :: - - PROVIDES += "udev" - - - in the above, the "+=" is overkill and unnecessary. + A recipe's own recipe name (:term:`PN`) is always implicitly prepended + to `PROVIDES`, so while using "+=" in the above example may not be + strictly necessary it is recommended to avoid confusion. In addition to providing recipes under alternate names, the ``PROVIDES`` mechanism is also used to implement virtual targets. A -- cgit v1.2.3-54-g00ecf