diff options
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/overview-manual/overview-manual-concepts.xml | 45 |
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 | ||