From: Scott Rifenbark <scott.m.rifenbark@intel.com>
Date: Tue, 17 Sep 2013 23:07:56 +0000 (-0700)
Subject: ref-manual: Updated the RDEPENDS variable to include syntax
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=33ed042d4f6de99efca7c6724b8966b9da79e330;p=thirdparty%2Fopenembedded%2Fopenembedded-core-contrib.git

ref-manual: Updated the RDEPENDS variable to include syntax

Fixes [YOCTO #4987]

This variable supports some boolean operators that we are not
showing for supporting versioned dependencies.  I added the
explanation for them.  There will be other variables affected
later once we settle on the changes here.

(From yocto-docs rev: e5c1e66d670c708012bd5ab51aa94f87426f57e2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 2ba4882d8f2..51f4966349c 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4132,6 +4132,32 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     </itemizedlist>
                 </para>
 
+                <para>
+                    BitBake, which the OpenEmbedded build system uses, supports
+                    specifying versioned dependencies.
+                    Although the syntax varies depending on the packaging
+                    format, BitBake hides these differences from you.
+                    Here is the general syntax to specify versions with
+                    the <filename>RDEPENDS</filename> variable:
+                    <literallayout class='monospaced'>
+     RDEPENDS_${PN} = "&lt;package&gt; (&lt;operator&gt; &lt;version&gt;)"
+                    </literallayout>
+                    For <filename>operator</filename>, you can specify the
+                    following:
+                    <literallayout class='monospaced'>
+     =
+     &lt;
+     &gt;
+     &lt;=
+     &gt;=
+                    </literallayout>
+                    For example, the following sets up a dependency on version
+                    1.2 or greater of the package <filename>foo</filename>:
+                    <literallayout class='monospaced'>
+     RDEPENDS_${PN} = "foo (>= 1.2)"
+                    </literallayout>
+                </para>
+
                 <para>
                     For information on build-time dependencies, see the
                     <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>