From e205789361d6dd6945260f493c20072e4a716cf3 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 29 Jul 2016 14:08:25 -0700 Subject: bitbake: bitbake-user-manual: Updated the PROVIDES variable Fixes [YOCTO #10011] Added paragraphs near the end to describe the role of virtual targets. (Bitbake rev: fc47bb99dbc1972dfb3a83c0f4c479963da64bcc) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../bitbake-user-manual-ref-variables.xml | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'bitbake/doc') diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml index a152218e32..dcf3ab3dd0 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml @@ -1976,6 +1976,27 @@ The PROVIDES statement results in the "libav" recipe also being known as "libpostproc". + + + In addition to providing recipes under alternate names, + the PROVIDES mechanism is also used + to implement virtual targets. + A virtual target is a name that corresponds to some + particular functionality (e.g. a Linux kernel). + Recipes that provide the functionality in question list the + virtual target in PROVIDES. + Recipes that depend on the functionality in question can + include the virtual target in + DEPENDS + to leave the choice of provider open. + + + + Conventionally, virtual targets have names on the form + "virtual/function" (e.g. "virtual/kernel"). + The slash is simply part of the name and has no + syntactical significance. + -- cgit 1.2.3-korg