dev-manual: Added new section on how to exclude a package
Fixes [YOCTO #4079] The changes here address the documentation component of this bug. There is now a new section in the dev-manual in the "Working With Packages" section that describes and introduces the three variables the user can use to control this feature: BAD_RECOMMENDATIONS, NO_RECOMMENDATIONS, and PACKAGE_EXCLUDE. (From yocto-docs rev: a7e2097c43955db99ec068068d4291fc4e1deaf8) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
0ca3c5f540
commit
de62377415
|
@ -2926,6 +2926,8 @@
|
||||||
<para>
|
<para>
|
||||||
This section describes a few tasks that involve packages:
|
This section describes a few tasks that involve packages:
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
|
<listitem><para>Excluding packages from an image
|
||||||
|
</para></listitem>
|
||||||
<listitem><para>Incrementing a package revision number
|
<listitem><para>Incrementing a package revision number
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
<listitem><para>Handling a package name alias
|
<listitem><para>Handling a package name alias
|
||||||
|
@ -2940,6 +2942,49 @@
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
<section id='excluding-packages-from-an-image'>
|
||||||
|
<title>Excluding Packages from an Image</title>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
You might find it necessary to prevent specific packages
|
||||||
|
from being installed into an image.
|
||||||
|
If so, you can use several variables to direct the build
|
||||||
|
system to essentially ignore installing recommended packages
|
||||||
|
or to not install a package at all.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
The following list introduces variables you can use to
|
||||||
|
prevent packages from being installed into your image.
|
||||||
|
Each of these variables only works with IPK and RPM
|
||||||
|
package types.
|
||||||
|
Support for Debian packages does not exist.
|
||||||
|
Also, you can use these variables from your
|
||||||
|
<filename>local.conf</filename> file or attach them to a
|
||||||
|
specific image recipe by using a recipe name override.
|
||||||
|
For more detail on the variables, see the descriptions in the
|
||||||
|
Yocto Project Reference Manual's glossary chapter.
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem><para><ulink url='&YOCTO_DOCS_REF_URL;#var-BAD_RECOMMENDATIONS'><filename>BAD_RECOMMENDATIONS</filename></ulink>:
|
||||||
|
Use this variable to specify "recommended-only"
|
||||||
|
packages that you do not want installed.
|
||||||
|
</para></listitem>
|
||||||
|
<listitem><para><ulink url='&YOCTO_DOCS_REF_URL;#var-NO_RECOMMENDATIONS'><filename>NO_RECOMMENDATIONS</filename></ulink>:
|
||||||
|
Use this variable to prevent all "recommended-only"
|
||||||
|
packages from being installed.
|
||||||
|
</para></listitem>
|
||||||
|
<listitem><para><ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_EXCLUDE'><filename>PACKAGE_EXCLUDE</filename></ulink>:
|
||||||
|
Use this variable to prevent specific packages from
|
||||||
|
being installed regardless of whether they are
|
||||||
|
"recommended-only" or not.
|
||||||
|
You need to realize that things could break when you
|
||||||
|
prevent the installation of a package whose presence
|
||||||
|
is required by an installed package.
|
||||||
|
</para></listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
|
|
||||||
<section id='incrementing-a-package-revision-number'>
|
<section id='incrementing-a-package-revision-number'>
|
||||||
<title>Incrementing a Package Revision Number</title>
|
<title>Incrementing a Package Revision Number</title>
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue