diff options
author | Quentin Schulz <foss@0leil.net> | 2021-04-07 18:07:24 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-04-09 15:24:46 +0100 |
commit | c380ba5a177de32e97820279685c4af6f837c010 (patch) | |
tree | c494289cda99f5bb76bad0d9492a3d1104d176d4 /documentation/overview-manual/yp-intro.rst | |
parent | 802ac0b75e42657c7ff9f4ff5b2816c65ad29eea (diff) | |
download | poky-c380ba5a177de32e97820279685c4af6f837c010.tar.gz |
docs: replace anchor links
Anchor links are treated by Sphinx as external links and are not checked
during build, meaning it is impossible to know if a link becomes broken or
not.
As a matter of fact, most of the anchor links replaced in this commit
were actually broken.
The README now states that anchor links are forbidden so that there's no
need to go through such a change later on.
(From yocto-docs rev: de9e4d26b46afa3c79137d07529a74553400d2e0)
Signed-off-by: Quentin Schulz <foss@0leil.net>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual/yp-intro.rst')
-rw-r--r-- | documentation/overview-manual/yp-intro.rst | 45 |
1 files changed, 24 insertions, 21 deletions
diff --git a/documentation/overview-manual/yp-intro.rst b/documentation/overview-manual/yp-intro.rst index b01b4e6a8f..fca02e4cec 100644 --- a/documentation/overview-manual/yp-intro.rst +++ b/documentation/overview-manual/yp-intro.rst | |||
@@ -96,18 +96,18 @@ Project: | |||
96 | of your design instead of adopting decisions enforced by some system | 96 | of your design instead of adopting decisions enforced by some system |
97 | software provider. | 97 | software provider. |
98 | 98 | ||
99 | - *Uses a Layer Model:* The Yocto Project `layer | 99 | - *Uses a Layer Model:* The Yocto Project :ref:`layer |
100 | infrastructure <#the-yocto-project-layer-model>`__ groups related | 100 | infrastructure <overview-manual/yp-intro:the yocto project layer model>` |
101 | functionality into separate bundles. You can incrementally add these | 101 | groups related functionality into separate bundles. You can incrementally |
102 | grouped functionalities to your project as needed. Using layers to | 102 | add these grouped functionalities to your project as needed. Using layers to |
103 | isolate and group functionality reduces project complexity and | 103 | isolate and group functionality reduces project complexity and |
104 | redundancy, allows you to easily extend the system, make | 104 | redundancy, allows you to easily extend the system, make |
105 | customizations, and keep functionality organized. | 105 | customizations, and keep functionality organized. |
106 | 106 | ||
107 | - *Supports Partial Builds:* You can build and rebuild individual | 107 | - *Supports Partial Builds:* You can build and rebuild individual |
108 | packages as needed. Yocto Project accomplishes this through its | 108 | packages as needed. Yocto Project accomplishes this through its |
109 | `shared-state cache <#shared-state-cache>`__ (sstate) scheme. Being | 109 | :ref:`overview-manual/concepts:shared state cache` (sstate) scheme. |
110 | able to build and debug components individually eases project | 110 | Being able to build and debug components individually eases project |
111 | development. | 111 | development. |
112 | 112 | ||
113 | - *Releases According to a Strict Schedule:* Major releases occur on a | 113 | - *Releases According to a Strict Schedule:* Major releases occur on a |
@@ -155,8 +155,9 @@ developing using the Yocto Project: | |||
155 | documents on the Yocto Project website. | 155 | documents on the Yocto Project website. |
156 | 156 | ||
157 | - *Project Workflow Could Be Confusing:* The `Yocto Project | 157 | - *Project Workflow Could Be Confusing:* The `Yocto Project |
158 | workflow <#overview-development-environment>`__ could be confusing if | 158 | workflow <overview-manual/development-environment:the yocto project development environment>` |
159 | you are used to traditional desktop and server software development. | 159 | could be confusing if you are used to traditional desktop and server |
160 | software development. | ||
160 | In a desktop development environment, mechanisms exist to easily pull | 161 | In a desktop development environment, mechanisms exist to easily pull |
161 | and install new packages, which are typically pre-compiled binaries | 162 | and install new packages, which are typically pre-compiled binaries |
162 | from servers accessible over the Internet. Using the Yocto Project, | 163 | from servers accessible over the Internet. Using the Yocto Project, |
@@ -437,8 +438,8 @@ activities using the Yocto Project: | |||
437 | Thanks to Pseudo, the Yocto Project never needs root privileges to | 438 | Thanks to Pseudo, the Yocto Project never needs root privileges to |
438 | build images for your target system. | 439 | build images for your target system. |
439 | 440 | ||
440 | You can read more about Pseudo in the "`Fakeroot and | 441 | You can read more about Pseudo in the |
441 | Pseudo <#fakeroot-and-pseudo>`__" section. | 442 | ":ref:`overview-manual/concepts:fakeroot and pseudo`" section. |
442 | 443 | ||
443 | Open-Embedded Build System Components | 444 | Open-Embedded Build System Components |
444 | ------------------------------------- | 445 | ------------------------------------- |
@@ -480,9 +481,9 @@ The following list consists of components associated with the | |||
480 | 481 | ||
481 | Sharing a core set of metadata results in Poky as an integration | 482 | Sharing a core set of metadata results in Poky as an integration |
482 | layer on top of OE-Core. You can see that in this | 483 | layer on top of OE-Core. You can see that in this |
483 | `figure <#yp-key-dev-elements>`__. The Yocto Project combines various | 484 | :ref:`figure <overview-manual/yp-intro:what is the yocto project?>`. |
484 | components such as BitBake, OE-Core, script "glue", and documentation | 485 | The Yocto Project combines various components such as BitBake, OE-Core, |
485 | for its build system. | 486 | script "glue", and documentation for its build system. |
486 | 487 | ||
487 | Reference Distribution (Poky) | 488 | Reference Distribution (Poky) |
488 | ----------------------------- | 489 | ----------------------------- |
@@ -490,8 +491,8 @@ Reference Distribution (Poky) | |||
490 | Poky is the Yocto Project reference distribution. It contains the | 491 | Poky is the Yocto Project reference distribution. It contains the |
491 | :term:`OpenEmbedded Build System` | 492 | :term:`OpenEmbedded Build System` |
492 | (BitBake and OE-Core) as well as a set of metadata to get you started | 493 | (BitBake and OE-Core) as well as a set of metadata to get you started |
493 | building your own distribution. See the | 494 | building your own distribution. See the figure in |
494 | `figure <#what-is-the-yocto-project>`__ in "What is the Yocto Project?" | 495 | ":ref:`overview-manual/yp-intro:what is the yocto project?`" |
495 | section for an illustration that shows Poky and its relationship with | 496 | section for an illustration that shows Poky and its relationship with |
496 | other parts of the Yocto Project. | 497 | other parts of the Yocto Project. |
497 | 498 | ||
@@ -503,8 +504,9 @@ To use the Yocto Project tools and components, you can download | |||
503 | Poky does not contain binary files. It is a working example of how to | 504 | Poky does not contain binary files. It is a working example of how to |
504 | build your own custom Linux distribution from source. | 505 | build your own custom Linux distribution from source. |
505 | 506 | ||
506 | You can read more about Poky in the "`Reference Embedded Distribution | 507 | You can read more about Poky in the |
507 | (Poky) <#reference-embedded-distribution>`__" section. | 508 | ":ref:`overview-manual/yp-intro:reference embedded distribution (poky)`" |
509 | section. | ||
508 | 510 | ||
509 | Packages for Finished Targets | 511 | Packages for Finished Targets |
510 | ----------------------------- | 512 | ----------------------------- |
@@ -567,7 +569,7 @@ Linux. | |||
567 | 569 | ||
568 | 3. *CROPS:* The final and best solution available now for developing | 570 | 3. *CROPS:* The final and best solution available now for developing |
569 | using the Yocto Project on a system not native to Linux is with | 571 | using the Yocto Project on a system not native to Linux is with |
570 | `CROPS <#gs-crops-overview>`__. | 572 | :ref:`CROPS <overview-manual/yp-intro:development tools>`. |
571 | 573 | ||
572 | Development Methods | 574 | Development Methods |
573 | =================== | 575 | =================== |
@@ -727,7 +729,8 @@ Sato. | |||
727 | One of the most powerful properties of Poky is that every aspect of a | 729 | One of the most powerful properties of Poky is that every aspect of a |
728 | build is controlled by the metadata. You can use metadata to augment | 730 | build is controlled by the metadata. You can use metadata to augment |
729 | these base image types by adding metadata | 731 | these base image types by adding metadata |
730 | `layers <#the-yocto-project-layer-model>`__ that extend functionality. | 732 | `layers <overview-manual/yp-intro:the yocto project layer model>` that extend |
733 | functionality. | ||
731 | These layers can provide, for example, an additional software stack for | 734 | These layers can provide, for example, an additional software stack for |
732 | an image type, add a board support package (BSP) for additional | 735 | an image type, add a board support package (BSP) for additional |
733 | hardware, or even create a new image type. | 736 | hardware, or even create a new image type. |
@@ -784,8 +787,8 @@ Following is a brief summary of the "workflow": | |||
784 | 7. The build system generates the file system image and a customized | 787 | 7. The build system generates the file system image and a customized |
785 | Extensible SDK (eSDK) for application development in parallel. | 788 | Extensible SDK (eSDK) for application development in parallel. |
786 | 789 | ||
787 | For a very detailed look at this workflow, see the "`OpenEmbedded Build | 790 | For a very detailed look at this workflow, see the |
788 | System Concepts <#openembedded-build-system-build-concepts>`__" section. | 791 | ":ref:`overview-manual/concepts:openembedded build system concepts`" section. |
789 | 792 | ||
790 | Some Basic Terms | 793 | Some Basic Terms |
791 | ================ | 794 | ================ |