summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-04-25 08:06:27 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-05-24 17:17:59 +0100
commite24c3ab54946d7fb65620c5ed6d7a777bd6dc094 (patch)
treef7e544b416b6324e7de12fe447c3bea7831e978d /documentation
parent3ed721c919ea1fcc53b31f6b29bd085c12a50925 (diff)
downloadpoky-e24c3ab54946d7fb65620c5ed6d7a777bd6dc094.tar.gz
overview-manual: Bolstered the "Layers" section in the concepts chapter.
This section was really sparse for being in the concepts chapter of this manual. I added some more text to it. (From yocto-docs rev: 9369ba5292126957f89f8b96e06bc2492825c54b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/overview-manual/overview-manual-concepts.xml45
1 files changed, 31 insertions, 14 deletions
diff --git a/documentation/overview-manual/overview-manual-concepts.xml b/documentation/overview-manual/overview-manual-concepts.xml
index 66457d8b5b..8f32dc62b1 100644
--- a/documentation/overview-manual/overview-manual-concepts.xml
+++ b/documentation/overview-manual/overview-manual-concepts.xml
@@ -198,27 +198,44 @@
198 </section> 198 </section>
199 </section> 199 </section>
200 200
201 <section id='cm-layers'> 201 <section id='overview-layers'>
202 <title>Layers</title> 202 <title>Layers</title>
203 203
204 <para> 204 <para>
205 Layers are repositories that contain related sets of instructions 205 Layers are repositories that contain related metadata (i.e.
206 that tell the OpenEmbedded build system what to do. 206 sets of instructions) that tell the OpenEmbedded build system how
207 You use different layers to logically separate information in your 207 to build a target.
208 build. 208 Yocto Project's
209 You can collaborate, share, and reuse layers. 209 <link linkend='the-yocto-project-layer-model'>layer model</link>
210 The Layer Model simultaneously supports collaboration and 210 facilitates collaboration, sharing, customization, and reuse
211 customization. 211 within the Yocto Project development environment.
212 Layers logically separate information for your project.
213 For example, you can use a layer to hold all the configurations
214 for a particular piece of hardware.
215 Isolating hardware-specific configurations allows you to share
216 other metadata by using a different layer where that metadata
217 might be common across several pieces of hardware.
212 </para> 218 </para>
213 219
214 <para> 220 <para>
215 For more introductory information on the Yocto Project's layer 221 Many layers exist that work in the Yocto Project development
216 model, see the 222 environment.
217 "<link linkend='the-yocto-project-layer-model'>The Yocto Project Layer Model</link>" 223 The
218 section. 224 <ulink url='https://caffelli-staging.yoctoproject.org/software-overview/layers/'>Yocto Project Curated Layer Index</ulink>
219 For procedures on how to create layers, see the 225 and
226 <ulink url='http://layers.openembedded.org/layerindex/branch/master/layers/'>OpenEmbedded Layer Index</ulink>
227 both contain layers from which you can use or leverage.
228 </para>
229
230 <para>
231 By convention, layers in the Yocto Project follow a specific form.
232 Conforming to a known structure allows BitBake to make assumptions
233 during builds on where to find types of metadata.
234 You can find procedures and learn about tools (i.e.
235 <filename>bitbake-layers</filename>) for creating layers suitable
236 for the Yocto Project in the
220 "<ulink url='&YOCTO_DOCS_DEV_URL;#understanding-and-creating-layers'>Understanding and Creating Layers</ulink>" 237 "<ulink url='&YOCTO_DOCS_DEV_URL;#understanding-and-creating-layers'>Understanding and Creating Layers</ulink>"
221 section in the Yocto Project Development Tasks Manual. 238 section of the Yocto Project Development Tasks Manual.
222 </para> 239 </para>
223 </section> 240 </section>
224 241