summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-09-18 15:01:39 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-09-22 12:20:48 +0100
commitd3bf6bd67767a7734d6f9572bb55c9d4ec90047d (patch)
tree6465a216f8cddd46ad2b01ce3f21c3faedb4f775 /documentation/ref-manual
parent6084246825ea764c689a5c1a04b7d560c897ba50 (diff)
downloadpoky-d3bf6bd67767a7734d6f9572bb55c9d4ec90047d.tar.gz
ref-manual: Added versioning to some R* variables
Fixes [YOCTO #4987] Added some versioning operators to the RCONFLICTS, RREPLACES, and RRECOMMENDS variables. I am using the same base text to get this information across. Because it is a referenced glossary, the duplication is acceptable. (From yocto-docs rev: 47613f962c945e06710ba2e14e0eb5f1f11d0336) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-variables.xml92
1 files changed, 87 insertions, 5 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 5d0d257e23..1fb6cfadb9 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4078,17 +4078,46 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
4078 4078
4079 <glossentry id='var-RCONFLICTS'><glossterm>RCONFLICTS</glossterm> 4079 <glossentry id='var-RCONFLICTS'><glossterm>RCONFLICTS</glossterm>
4080 <glossdef> 4080 <glossdef>
4081 <para>The list of packages that conflict with another package.
4082 Note that the package will not be installed if the conflicting packages are not
4083 first removed.</para>
4084 <para> 4081 <para>
4085 Like all package-controlling variables, you must always use them in 4082 The list of packages that conflict with packages.
4086 conjunction with a package name override. 4083 Note that packages will not be installed if conflicting
4084 packages are not first removed.
4085 </para>
4086
4087 <para>
4088 Like all package-controlling variables, you must always use
4089 them in conjunction with a package name override.
4087 Here is an example: 4090 Here is an example:
4088 <literallayout class='monospaced'> 4091 <literallayout class='monospaced'>
4089 RCONFLICTS_${PN} = "another-conflicting-package-name" 4092 RCONFLICTS_${PN} = "another-conflicting-package-name"
4090 </literallayout> 4093 </literallayout>
4091 </para> 4094 </para>
4095
4096 <para>
4097 BitBake, which the OpenEmbedded build system uses, supports
4098 specifying versioned dependencies.
4099 Although the syntax varies depending on the packaging
4100 format, BitBake hides these differences from you.
4101 Here is the general syntax to specify versions with
4102 the <filename>RCONFLICTS</filename> variable:
4103 <literallayout class='monospaced'>
4104 RCONFLICTS_${PN} = "&lt;package&gt; (&lt;operator&gt; &lt;version&gt;)"
4105 </literallayout>
4106 For <filename>operator</filename>, you can specify the
4107 following:
4108 <literallayout class='monospaced'>
4109 =
4110 &lt;
4111 &gt;
4112 &lt;=
4113 &gt;=
4114 </literallayout>
4115 For example, the following sets up a dependency on version
4116 1.2 or greater of the package <filename>foo</filename>:
4117 <literallayout class='monospaced'>
4118 RCONFLICTS_${PN} = "foo (>= 1.2)"
4119 </literallayout>
4120 </para>
4092 </glossdef> 4121 </glossdef>
4093 </glossentry> 4122 </glossentry>
4094 4123
@@ -4344,6 +4373,32 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
4344 namespace before any renaming of the output package by 4373 namespace before any renaming of the output package by
4345 classes such as <filename>debian.bbclass</filename>. 4374 classes such as <filename>debian.bbclass</filename>.
4346 </para> 4375 </para>
4376
4377 <para>
4378 BitBake, which the OpenEmbedded build system uses, supports
4379 specifying versioned recommends.
4380 Although the syntax varies depending on the packaging
4381 format, BitBake hides these differences from you.
4382 Here is the general syntax to specify versions with
4383 the <filename>RRECOMMENDS</filename> variable:
4384 <literallayout class='monospaced'>
4385 RRECOMMENDS_${PN} = "&lt;package&gt; (&lt;operator&gt; &lt;version&gt;)"
4386 </literallayout>
4387 For <filename>operator</filename>, you can specify the
4388 following:
4389 <literallayout class='monospaced'>
4390 =
4391 &lt;
4392 &gt;
4393 &lt;=
4394 &gt;=
4395 </literallayout>
4396 For example, the following sets up a recommend on version
4397 1.2 or greater of the package <filename>foo</filename>:
4398 <literallayout class='monospaced'>
4399 RRECOMMENDS_${PN} = "foo (>= 1.2)"
4400 </literallayout>
4401 </para>
4347 </glossdef> 4402 </glossdef>
4348 </glossentry> 4403 </glossentry>
4349 4404
@@ -4368,6 +4423,33 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
4368 RREPLACES_${PN} = "other-package-being-replaced" 4423 RREPLACES_${PN} = "other-package-being-replaced"
4369 </literallayout> 4424 </literallayout>
4370 </para> 4425 </para>
4426
4427 <para>
4428 BitBake, which the OpenEmbedded build system uses, supports
4429 specifying versioned replacements.
4430 Although the syntax varies depending on the packaging
4431 format, BitBake hides these differences from you.
4432 Here is the general syntax to specify versions with
4433 the <filename>RREPLACES</filename> variable:
4434 <literallayout class='monospaced'>
4435 RREPLACES_${PN} = "&lt;package&gt; (&lt;operator&gt; &lt;version&gt;)"
4436 </literallayout>
4437 For <filename>operator</filename>, you can specify the
4438 following:
4439 <literallayout class='monospaced'>
4440 =
4441 &lt;
4442 &gt;
4443 &lt;=
4444 &gt;=
4445 </literallayout>
4446 For example, the following sets up a replacement using
4447 version 1.2 or greater of the package
4448 <filename>foo</filename>:
4449 <literallayout class='monospaced'>
4450 RREPLACES_${PN} = "foo (>= 1.2)"
4451 </literallayout>
4452 </para>
4371 </glossdef> 4453 </glossdef>
4372 </glossentry> 4454 </glossentry>
4373 4455