diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index bdf59de8a6..e456d540a0 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -465,7 +465,7 @@
One way to get additional software into an image is to create a custom image.
The following example shows the form for the two lines you need:
- IMAGE_INSTALL = "task-core-x11-base package1 package2"
+ IMAGE_INSTALL = "packagegroup-core-x11-base package1 package2"
inherit core-image
@@ -494,58 +494,60 @@
- Customizing Images Using Custom Tasks
+ Customizing Images Using Custom Package Groups
- For complex custom images, the best approach is to create a custom task package
+ For complex custom images, the best approach is to create a custom package group recipe
that is used to build the image or images.
- A good example of a tasks package is
- meta/recipes-core/tasks/task-core-boot.bb
+ A good example of a package group recipe is
+ meta/recipes-core/packagegroups/packagegroup-core-boot.bb.
The
PACKAGES
- variable lists the task packages to build along with the complementary
- -dbg and -dev packages.
- For each package added, you can use
+ variable lists the package group packages you wish to produce. inherit packagegroup
+ sets appropriate default values and automatically adds -dev
+ and -dbg complementary
+ packages for every package specified in PACKAGES.
+ Note that the inherit line should be towards
+ the top of the recipe, certainly before you set PACKAGES.
+ For each package you specify in PACKAGES, you can use
RDEPENDS
and
RRECOMMENDS
entries to provide a list of packages the parent task package should contain.
Following is an example:
- DESCRIPTION = "My Custom Tasks"
+ DESCRIPTION = "My Custom Package Groups"
+
+ inherit packagegroup
PACKAGES = "\
- task-custom-apps \
- task-custom-apps-dbg \
- task-custom-apps-dev \
- task-custom-tools \
- task-custom-tools-dbg \
- task-custom-tools-dev \
+ packagegroup-custom-apps \
+ packagegroup-custom-tools \
"
- RDEPENDS_task-custom-apps = "\
+ RDEPENDS_packagegroup-custom-apps = "\
dropbear \
portmap \
psplash"
- RDEPENDS_task-custom-tools = "\
+ RDEPENDS_packagegroup-custom-tools = "\
oprofile \
oprofileui-server \
lttng-control \
lttng-viewer"
- RRECOMMENDS_task-custom-tools = "\
+ RRECOMMENDS_packagegroup-custom-tools = "\
kernel-module-oprofile"
- In the previous example, two task packages are created with their dependencies and their
- recommended package dependencies listed: task-custom-apps, and
- task-custom-tools.
- To build an image using these task packages, you need to add
- task-custom-apps and/or
- task-custom-tools to
+ In the previous example, two package group packages are created with their dependencies and their
+ recommended package dependencies listed: packagegroup-custom-apps, and
+ packagegroup-custom-tools.
+ To build an image using these packagegroup packages, you need to add
+ packagegroup-custom-apps and/or
+ packagegroup-custom-tools to
IMAGE_INSTALL.
For other forms of image dependencies see the other areas of this section.