summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-01-06 10:46:13 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-02-17 15:16:47 +0000
commit66ad91bd54d7a3ab0ea3948ac9bf42e3da53eadc (patch)
tree4f610d3e3e5fc46b596480f9955541e5d019b889
parentc8691a2d44a699a35bedddb940a5f3e70c11d7f4 (diff)
downloadpoky-66ad91bd54d7a3ab0ea3948ac9bf42e3da53eadc.tar.gz
dev-manual: Rewrite of the section on customizing images with packagegroups
This section was pointing to a poor example in meta. I substituted in a better example and rewrote the section to flow better around that example and the final fabricated one. Reported-by: Robert P. J. Day <rpjday@crashcourse.ca> (From yocto-docs rev: c7f07a2993d5c1b8e0c8b7da0e9d4c28242a5e26) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml39
1 files changed, 27 insertions, 12 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 9503593f61..17d725b3b8 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1100,18 +1100,27 @@
1100 an image is to create a custom package group recipe that is 1100 an image is to create a custom package group recipe that is
1101 used to build the image or images. 1101 used to build the image or images.
1102 A good example of a package group recipe is 1102 A good example of a package group recipe is
1103 <filename>meta/recipes-core/packagegroups/packagegroup-core-boot.bb</filename>. 1103 <filename>meta/recipes-core/packagegroups/packagegroup-base.bb</filename>.
1104 The 1104 </para>
1105
1106 <para>
1107 If you examine that recipe, you see that the
1105 <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGES'>PACKAGES</ulink></filename> 1108 <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGES'>PACKAGES</ulink></filename>
1106 variable lists the package group packages you wish to produce. 1109 variable lists the package group packages to produce.
1107 <filename>inherit packagegroup</filename> sets appropriate 1110 The <filename>inherit packagegroup</filename> statement
1108 default values and automatically adds <filename>-dev</filename>, 1111 sets appropriate default values and automatically adds
1109 <filename>-dbg</filename>, and <filename>-ptest</filename> 1112 <filename>-dev</filename>, <filename>-dbg</filename>, and
1110 complementary packages for every package specified in 1113 <filename>-ptest</filename> complementary packages for each
1111 <filename>PACKAGES</filename>. 1114 package specified in the <filename>PACKAGES</filename>
1112 Note that the inherit line should be towards 1115 statement.
1113 the top of the recipe, certainly before you set 1116 <note>
1114 <filename>PACKAGES</filename>. 1117 The <filename>inherit packages</filename> should be
1118 located near the top of the recipe, certainly before
1119 the <filename>PACKAGES</filename> statement.
1120 </note>
1121 </para>
1122
1123 <para>
1115 For each package you specify in <filename>PACKAGES</filename>, 1124 For each package you specify in <filename>PACKAGES</filename>,
1116 you can use 1125 you can use
1117 <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-RDEPENDS'>RDEPENDS</ulink></filename> 1126 <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-RDEPENDS'>RDEPENDS</ulink></filename>
@@ -1119,7 +1128,13 @@
1119 <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-RRECOMMENDS'>RRECOMMENDS</ulink></filename> 1128 <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-RRECOMMENDS'>RRECOMMENDS</ulink></filename>
1120 entries to provide a list of packages the parent task package 1129 entries to provide a list of packages the parent task package
1121 should contain. 1130 should contain.
1122 Following is an example: 1131 You can see examples of these further down in the
1132 <filename>packagegroup-base.bb</filename> recipe.
1133 </para>
1134
1135 <para>
1136 Here is a short, fabricated example showing the same basic
1137 pieces:
1123 <literallayout class='monospaced'> 1138 <literallayout class='monospaced'>
1124 DESCRIPTION = "My Custom Package Groups" 1139 DESCRIPTION = "My Custom Package Groups"
1125 1140