diff options
Diffstat (limited to 'documentation/what-i-wish-id-known.rst')
-rw-r--r-- | documentation/what-i-wish-id-known.rst | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/documentation/what-i-wish-id-known.rst b/documentation/what-i-wish-id-known.rst index cf378747c6..67bf84e07f 100644 --- a/documentation/what-i-wish-id-known.rst +++ b/documentation/what-i-wish-id-known.rst | |||
@@ -8,7 +8,7 @@ What I wish I'd known about Yocto Project | |||
8 | 8 | ||
9 | .. note:: | 9 | .. note:: |
10 | 10 | ||
11 | Before reading further, make sure you’ve taken a look at the | 11 | Before reading further, make sure you've taken a look at the |
12 | :yocto_home:`Software Overview</software-overview>` page which presents the | 12 | :yocto_home:`Software Overview</software-overview>` page which presents the |
13 | definitions for many of the terms referenced here. Also, know that some of the | 13 | definitions for many of the terms referenced here. Also, know that some of the |
14 | information here won't make sense now, but as you start developing, it is the | 14 | information here won't make sense now, but as you start developing, it is the |
@@ -16,8 +16,8 @@ What I wish I'd known about Yocto Project | |||
16 | working with Yocto Project and they are updated regularly. | 16 | working with Yocto Project and they are updated regularly. |
17 | 17 | ||
18 | Using the Yocto Project is fairly easy, *until something goes wrong*. Without an | 18 | Using the Yocto Project is fairly easy, *until something goes wrong*. Without an |
19 | understanding of how the build process works, you’ll find yourself trying to | 19 | understanding of how the build process works, you'll find yourself trying to |
20 | troubleshoot “a black box”. Here are a few items that new users wished they had | 20 | troubleshoot "a black box". Here are a few items that new users wished they had |
21 | known before embarking on their first build with Yocto Project. Feel free to | 21 | known before embarking on their first build with Yocto Project. Feel free to |
22 | contact us with other suggestions. | 22 | contact us with other suggestions. |
23 | 23 | ||
@@ -34,7 +34,7 @@ contact us with other suggestions. | |||
34 | </software-over/layer/>`. Generally check the Compatible layer index first, | 34 | </software-over/layer/>`. Generally check the Compatible layer index first, |
35 | and if you don't find the necessary layer check the general layer index. The | 35 | and if you don't find the necessary layer check the general layer index. The |
36 | layer index is an original artifact from the Open Embedded Project. As such, | 36 | layer index is an original artifact from the Open Embedded Project. As such, |
37 | that index doesn’t have the curating and testing that the Yocto Project | 37 | that index doesn't have the curating and testing that the Yocto Project |
38 | provides on Yocto Project Compatible layer list, but the latter has fewer | 38 | provides on Yocto Project Compatible layer list, but the latter has fewer |
39 | entries. Know that when you start searching in the layer index that not all | 39 | entries. Know that when you start searching in the layer index that not all |
40 | layers have the same level of maturity, validation, or usability. Nor do | 40 | layers have the same level of maturity, validation, or usability. Nor do |
@@ -110,7 +110,7 @@ contact us with other suggestions. | |||
110 | :ref:`bitbake-user-manual/bitbake-user-manual-intro:generating dependency | 110 | :ref:`bitbake-user-manual/bitbake-user-manual-intro:generating dependency |
111 | graphs` section in the BitBake User Manual. | 111 | graphs` section in the BitBake User Manual. |
112 | 112 | ||
113 | #. **Here’s how you decode “magic” folder names in tmp/work:** | 113 | #. **Here's how you decode "magic" folder names in tmp/work:** |
114 | The build system fetches, unpacks, preprocesses, and builds. If something | 114 | The build system fetches, unpacks, preprocesses, and builds. If something |
115 | goes wrong, the build system reports to you directly the path to a folder | 115 | goes wrong, the build system reports to you directly the path to a folder |
116 | where the temporary (build/tmp) files and packages reside resulting from the | 116 | where the temporary (build/tmp) files and packages reside resulting from the |
@@ -128,8 +128,8 @@ contact us with other suggestions. | |||
128 | Yocto Project, the instructions found in the | 128 | Yocto Project, the instructions found in the |
129 | :doc:`brief-yoctoprojectqs/brief-yoctoprojectqs` show how to create an image | 129 | :doc:`brief-yoctoprojectqs/brief-yoctoprojectqs` show how to create an image |
130 | and then run or flash that image. However, you can actually build just a | 130 | and then run or flash that image. However, you can actually build just a |
131 | single recipe. Thus, if some dependency or recipe isn’t working, you can just | 131 | single recipe. Thus, if some dependency or recipe isn't working, you can just |
132 | say “bitbake foo” where "foo" is the name for a specific recipe. As you | 132 | say "bitbake foo" where "foo" is the name for a specific recipe. As you |
133 | become more advanced using the Yocto Project, and if builds are failing, it | 133 | become more advanced using the Yocto Project, and if builds are failing, it |
134 | can be useful to make sure the fetch itself works as desired. Here are some | 134 | can be useful to make sure the fetch itself works as desired. Here are some |
135 | valuable links: :ref:`dev-manual/dev-manual-common-tasks:Using a Development | 135 | valuable links: :ref:`dev-manual/dev-manual-common-tasks:Using a Development |
@@ -147,11 +147,11 @@ contact us with other suggestions. | |||
147 | the recipe is building but are different parts (packages) of the build | 147 | the recipe is building but are different parts (packages) of the build |
148 | (i.e. the main package, the doc package, the debug symbols package, the | 148 | (i.e. the main package, the doc package, the debug symbols package, the |
149 | separate utilities package, and so forth). The build system splits out the | 149 | separate utilities package, and so forth). The build system splits out the |
150 | packages so that you don’t need to install the packages you don’t want or | 150 | packages so that you don't need to install the packages you don't want or |
151 | need, which is advantageous because you are building for small devices when | 151 | need, which is advantageous because you are building for small devices when |
152 | developing for embedded and IoT. | 152 | developing for embedded and IoT. |
153 | 153 | ||
154 | #. **You will want to learn about and know what’s packaged in rootfs.** | 154 | #. **You will want to learn about and know what's packaged in rootfs.** |
155 | 155 | ||
156 | #. **Create your own image recipe:** | 156 | #. **Create your own image recipe:** |
157 | There are a number of ways to create your own image recipe. We suggest you | 157 | There are a number of ways to create your own image recipe. We suggest you |