summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-07-29 14:08:25 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-08-02 15:22:15 +0100
commite205789361d6dd6945260f493c20072e4a716cf3 (patch)
tree61bfc8451be73c519a8297e9049a7ac0e6110c7c
parentf0e73a4b65b8632bf9c9642faf8e1b22a628d88e (diff)
downloadpoky-e205789361d6dd6945260f493c20072e4a716cf3.tar.gz
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 <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml21
1 files changed, 21 insertions, 0 deletions
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 @@
1976 The <filename>PROVIDES</filename> statement results in 1976 The <filename>PROVIDES</filename> statement results in
1977 the "libav" recipe also being known as "libpostproc". 1977 the "libav" recipe also being known as "libpostproc".
1978 </para> 1978 </para>
1979
1980 <para>
1981 In addition to providing recipes under alternate names,
1982 the <filename>PROVIDES</filename> mechanism is also used
1983 to implement virtual targets.
1984 A virtual target is a name that corresponds to some
1985 particular functionality (e.g. a Linux kernel).
1986 Recipes that provide the functionality in question list the
1987 virtual target in <filename>PROVIDES</filename>.
1988 Recipes that depend on the functionality in question can
1989 include the virtual target in
1990 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>
1991 to leave the choice of provider open.
1992 </para>
1993
1994 <para>
1995 Conventionally, virtual targets have names on the form
1996 "virtual/function" (e.g. "virtual/kernel").
1997 The slash is simply part of the name and has no
1998 syntactical significance.
1999 </para>
1979 </glossdef> 2000 </glossdef>
1980 </glossentry> 2001 </glossentry>
1981 2002