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:31 +0100
commit69b36d1a06757a9c2f0d0f1bfded1eb2b4cda1de (patch)
tree94ecf865aa728c826ab27266b20f71d022682749
parentd67aecffea4fc5a3df386f1381fdbffb734149f1 (diff)
downloadpoky-69b36d1a06757a9c2f0d0f1bfded1eb2b4cda1de.tar.gz
ref-manual: Updates to the RDEPENDS variable entry.
Re-wrote some stuff to be clearer. (From yocto-docs rev: 7c8f529d099d1a234be5e5652acdbb63c9d44d42) 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 2e3ae56b3c..e12058d796 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -3095,20 +3095,25 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3095 </para> 3095 </para>
3096 3096
3097 <para> 3097 <para>
3098 The names of the variables you list with 3098 The names of the packages you list within
3099 <filename>RDEPENDS</filename> must be the names of other 3099 <filename>RDEPENDS</filename> must be the names of other
3100 packages as listed in the 3100 packages - they cannot be recipe names.
3101 <note>
3102 Although package names and recipe names usually match,
3103 the important point here is that you are
3104 providing package names within the
3105 <filename>RDEPENDS</filename> variable.
3106 </note>
3107 For an example of the default list of packages created from
3108 a recipe, see the
3101 <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link> 3109 <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>
3102 variable. 3110 variable.
3103 You should not list recipe names
3104 (<link linkend='var-PN'><filename>PN</filename></link>).
3105 </para> 3111 </para>
3106 3112
3107 <para> 3113 <para>
3108 Because the <filename>RDEPENDS</filename> variable applies 3114 Because the <filename>RDEPENDS</filename> variable applies
3109 to packages being built, you should 3115 to packages being built, you should always use the variable
3110 always attach a package name to the variable to specify the 3116 in a form with an attached package name.
3111 particular run-time package that has the dependency.
3112 For example, suppose you are building a development package 3117 For example, suppose you are building a development package
3113 that depends on the <filename>perl</filename> package. 3118 that depends on the <filename>perl</filename> package.
3114 In this case, you would use the following 3119 In this case, you would use the following
@@ -3116,17 +3121,28 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3116 <literallayout class='monospaced'> 3121 <literallayout class='monospaced'>
3117 RDEPENDS_${PN}-dev += "perl" 3122 RDEPENDS_${PN}-dev += "perl"
3118 </literallayout> 3123 </literallayout>
3119 In the example, the package name 3124 In the example, the development package depends on
3120 (<filename>${PN}-dev</filename>) must appear as it would 3125 the <filename>perl</filename> package.
3121 in the 3126 Thus, the <filename>RDEPENDS</filename> variable has the
3127 <filename>${PN}-dev</filename> package name as part of the
3128 variable.
3129 </para>
3130
3131 <para>
3132 If the package with the dependency is one of the default
3133 packages as listed in the
3122 <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename> 3134 <filename><link linkend='var-PACKAGES'>PACKAGES</link></filename>
3135 variable, the package name you attach to the
3136 <filename>RDEPENDS</filename> variable must appear
3137 as it would in the <filename>PACKAGES</filename>
3123 namespace before any renaming of the output package by 3138 namespace before any renaming of the output package by
3124 classes like <filename>debian.bbclass</filename>. 3139 classes like <filename>debian.bbclass</filename>.
3125 </para> 3140 </para>
3126 3141
3127 <para> 3142 <para>
3128 In many cases you do not need to explicitly add dependencies 3143 In many cases you do not need to explicitly add
3129 to <filename>RDEPENDS</filename> since some automatic 3144 run-time dependencies using
3145 <filename>RDEPENDS</filename> since some automatic
3130 handling occurs: 3146 handling occurs:
3131 <itemizedlist> 3147 <itemizedlist>
3132 <listitem><para><emphasis><filename>shlibdeps</filename></emphasis>: If 3148 <listitem><para><emphasis><filename>shlibdeps</filename></emphasis>: If