diff options
| -rw-r--r-- | documentation/overview-manual/concepts.rst | 25 |
1 files changed, 12 insertions, 13 deletions
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index 85dea9fe05..c9405cdd33 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst | |||
| @@ -98,7 +98,7 @@ files, and how to package the compiled output. | |||
| 98 | 98 | ||
| 99 | The term "package" is sometimes used to refer to recipes. However, since | 99 | The term "package" is sometimes used to refer to recipes. However, since |
| 100 | the word "package" is used for the packaged output from the OpenEmbedded | 100 | the word "package" is used for the packaged output from the OpenEmbedded |
| 101 | build system (i.e. ``.ipk`` or ``.deb`` files), this document avoids | 101 | build system (i.e. ``.ipk``, ``.deb`` or ``.rpm`` files), this document avoids |
| 102 | using the term "package" when referring to recipes. | 102 | using the term "package" when referring to recipes. |
| 103 | 103 | ||
| 104 | Classes | 104 | Classes |
| @@ -256,7 +256,7 @@ development environment. | |||
| 256 | .. note:: | 256 | .. note:: |
| 257 | 257 | ||
| 258 | The | 258 | The |
| 259 | scripts/oe-setup-builddir | 259 | ``scripts/oe-setup-builddir`` |
| 260 | script uses the | 260 | script uses the |
| 261 | ``$TEMPLATECONF`` | 261 | ``$TEMPLATECONF`` |
| 262 | variable to determine which sample configuration files to locate. | 262 | variable to determine which sample configuration files to locate. |
| @@ -352,7 +352,7 @@ layers the build system uses to further control the build. These layers | |||
| 352 | provide Metadata for the software, machine, and policies. | 352 | provide Metadata for the software, machine, and policies. |
| 353 | 353 | ||
| 354 | In general, there are three types of layer input. You can see them below | 354 | In general, there are three types of layer input. You can see them below |
| 355 | the "User Configuration" box in the `general workflow | 355 | the "User Configuration" box in the :ref:`general workflow |
| 356 | figure <overview-manual/concepts:openembedded build system concepts>`: | 356 | figure <overview-manual/concepts:openembedded build system concepts>`: |
| 357 | 357 | ||
| 358 | - *Metadata (.bb + Patches):* Software layers containing | 358 | - *Metadata (.bb + Patches):* Software layers containing |
| @@ -420,14 +420,14 @@ build. | |||
| 420 | Distro Layer | 420 | Distro Layer |
| 421 | ~~~~~~~~~~~~ | 421 | ~~~~~~~~~~~~ |
| 422 | 422 | ||
| 423 | The distribution layer provides policy configurations for your | 423 | A distribution layer provides policy configurations for your |
| 424 | distribution. Best practices dictate that you isolate these types of | 424 | distribution. Best practices dictate that you isolate these types of |
| 425 | configurations into their own layer. Settings you provide in | 425 | configurations into their own layer. Settings you provide in |
| 426 | ``conf/distro/distro.conf`` override similar settings that BitBake finds | 426 | ``conf/distro/distro.conf`` override similar settings that BitBake finds |
| 427 | in your ``conf/local.conf`` file in the :term:`Build Directory`. | 427 | in your ``conf/local.conf`` file in the :term:`Build Directory`. |
| 428 | 428 | ||
| 429 | The following list provides some explanation and references for what you | 429 | The following list provides some explanation and references for what you |
| 430 | typically find in the distribution layer: | 430 | typically find in a distribution layer: |
| 431 | 431 | ||
| 432 | - *classes:* Class files (``.bbclass``) hold common functionality that | 432 | - *classes:* Class files (``.bbclass``) hold common functionality that |
| 433 | can be shared among recipes in the distribution. When your recipes | 433 | can be shared among recipes in the distribution. When your recipes |
| @@ -454,7 +454,7 @@ typically find in the distribution layer: | |||
| 454 | BSP Layer | 454 | BSP Layer |
| 455 | ~~~~~~~~~ | 455 | ~~~~~~~~~ |
| 456 | 456 | ||
| 457 | The BSP Layer provides machine configurations that target specific | 457 | A BSP layer provides machine configurations that target specific |
| 458 | hardware. Everything in this layer is specific to the machine for which | 458 | hardware. Everything in this layer is specific to the machine for which |
| 459 | you are building the image or the SDK. A common structure or form is | 459 | you are building the image or the SDK. A common structure or form is |
| 460 | defined for BSP layers. You can learn more about this structure in the | 460 | defined for BSP layers. You can learn more about this structure in the |
| @@ -465,7 +465,7 @@ defined for BSP layers. You can learn more about this structure in the | |||
| 465 | In order for a BSP layer to be considered compliant with the Yocto | 465 | In order for a BSP layer to be considered compliant with the Yocto |
| 466 | Project, it must meet some structural requirements. | 466 | Project, it must meet some structural requirements. |
| 467 | 467 | ||
| 468 | The BSP Layer's configuration directory contains configuration files for | 468 | A BSP layer's configuration directory contains configuration files for |
| 469 | the machine (``conf/machine/machine.conf``) and, of course, the layer | 469 | the machine (``conf/machine/machine.conf``) and, of course, the layer |
| 470 | (``conf/layer.conf``). | 470 | (``conf/layer.conf``). |
| 471 | 471 | ||
| @@ -477,18 +477,18 @@ formfactors, graphics support systems, and so forth. | |||
| 477 | .. note:: | 477 | .. note:: |
| 478 | 478 | ||
| 479 | While the figure shows several | 479 | While the figure shows several |
| 480 | recipes-\* | 480 | ``recipes-*`` |
| 481 | directories, not all these directories appear in all BSP layers. | 481 | directories, not all these directories appear in all BSP layers. |
| 482 | 482 | ||
| 483 | Software Layer | 483 | Software Layer |
| 484 | ~~~~~~~~~~~~~~ | 484 | ~~~~~~~~~~~~~~ |
| 485 | 485 | ||
| 486 | The software layer provides the Metadata for additional software | 486 | A software layer provides the Metadata for additional software |
| 487 | packages used during the build. This layer does not include Metadata | 487 | packages used during the build. This layer does not include Metadata |
| 488 | that is specific to the distribution or the machine, which are found in | 488 | that is specific to the distribution or the machine, which are found in |
| 489 | their respective layers. | 489 | their respective layers. |
| 490 | 490 | ||
| 491 | This layer contains any recipes, append files, and patches, that your | 491 | This layer contains any recipes, append files, and patches that your |
| 492 | project needs. | 492 | project needs. |
| 493 | 493 | ||
| 494 | Sources | 494 | Sources |
| @@ -560,9 +560,8 @@ source tree used by the group). | |||
| 560 | 560 | ||
| 561 | The canonical method through which to include a local project is to use the | 561 | The canonical method through which to include a local project is to use the |
| 562 | :ref:`ref-classes-externalsrc` class to include that local project. You use | 562 | :ref:`ref-classes-externalsrc` class to include that local project. You use |
| 563 | either the ``local.conf`` or a recipe's append file to override or set the | 563 | either ``local.conf`` or a recipe's append file to override or set the |
| 564 | recipe to point to the local directory on your disk to pull in the whole | 564 | recipe to point to the local directory from which to fetch the source. |
| 565 | source tree. | ||
| 566 | 565 | ||
| 567 | Source Control Managers (Optional) | 566 | Source Control Managers (Optional) |
| 568 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 567 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
