summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-06-07 15:23:04 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-06-14 17:33:36 +0100
commitbb8e0a4d8b3c4cb41011408d913283ebcaa37b47 (patch)
tree70330129d842ba8d84f648475d87d440eab68074
parent89d55eeb13855d5cd1d29fff609a724ba68a9853 (diff)
downloadpoky-bb8e0a4d8b3c4cb41011408d913283ebcaa37b47.tar.gz
ref-manual: Updates to the RDEPENDS variable entry.
Re-wrote some stuff to be clearer. (From yocto-docs rev: b4c117fe17aaf2385be192fc6cd6d634331828a0) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/ref-manual/ref-variables.xml40
1 files changed, 28 insertions, 12 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index b56b43fdf4..a7635e07d4 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -3050,20 +3050,25 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3050 </para> 3050 </para>
3051 3051
3052 <para> 3052 <para>
3053 The names of the variables you list with 3053 The names of the packages you list within
3054 <filename>RDEPENDS</filename> must be the names of other 3054 <filename>RDEPENDS</filename> must be the names of other
3055 packages as listed in the 3055 packages - they cannot be recipe names.
3056 <note>
3057 Although package names and recipe names usually match,
3058 the important point here is that you are
3059 providing package names within the
3060 <filename>RDEPENDS</filename> variable.
3061 </note>
3062 For an example of the default list of packages created from
3063 a recipe, see the
3056 <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link> 3064 <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>
3057 variable. 3065 variable.
3058 You should not list recipe names
3059 (<link linkend='var-PN'><filename>PN</filename></link>).
3060 </para> 3066 </para>
3061 3067
3062 <para> 3068 <para>
3063 Because the <filename>RDEPENDS</filename> variable applies 3069 Because the <filename>RDEPENDS</filename> variable applies
3064 to packages being built, you should 3070 to packages being built, you should always use the variable
3065 always attach a package name to the variable to specify the 3071 in a form with an attached package name.
3066 particular run-time package that has the dependency.
3067 For example, suppose you are building a development package 3072 For example, suppose you are building a development package
3068 that depends on the <filename>perl</filename> package. 3073 that depends on the <filename>perl</filename> package.
3069 In this case, you would use the following 3074 In this case, you would use the following
@@ -3071,17 +3076,28 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3071 <literallayout class='monospaced'> 3076 <literallayout class='monospaced'>
3072 RDEPENDS_${PN}-dev += "perl" 3077 RDEPENDS_${PN}-dev += "perl"
3073 </literallayout> 3078 </literallayout>
3074 In the example, the package name 3079 In the example, the development package depends on
3075 (<filename>${PN}-dev</filename>) must appear as it would 3080 the <filename>perl</filename> package.
3076 in the 3081 Thus, the <filename>RDEPENDS</filename> variable has the
3082 <filename>${PN}-dev</filename> package name as part of the
3083 variable.
3084 </para>
3085
3086 <para>
3087 If the package with the dependency is one of the default
3088 packages as listed in the
3077 <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> 3089 <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename>
3090 variable, the package name you attach to the
3091 <filename>RDEPENDS</filename> variable must appear
3092 as it would in the <filename>PACKAGES</filename>
3078 namespace before any renaming of the output package by 3093 namespace before any renaming of the output package by
3079 classes like <filename>debian.bbclass</filename>. 3094 classes like <filename>debian.bbclass</filename>.
3080 </para> 3095 </para>
3081 3096
3082 <para> 3097 <para>
3083 In many cases you do not need to explicitly add dependencies 3098 In many cases you do not need to explicitly add
3084 to <filename>RDEPENDS</filename> since some automatic 3099 run-time dependencies using
3100 <filename>RDEPENDS</filename> since some automatic
3085 handling occurs: 3101 handling occurs:
3086 <itemizedlist> 3102 <itemizedlist>
3087 <listitem><para><emphasis><filename>shlibdeps</filename></emphasis>: If 3103 <listitem><para><emphasis><filename>shlibdeps</filename></emphasis>: If