diff options
author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2022-12-09 19:01:55 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2022-12-18 10:41:21 +0000 |
commit | 6846d4d00bc3a9d4e188ad9c8cfdf6e45cd1ba06 (patch) | |
tree | 6a59e9936ac9f2ca063d4fc8a5c4d9ecc9492769 /documentation/sdk-manual/appendix-obtain.rst | |
parent | 474e071608c7c1c97e9dafde810aef5630c716e7 (diff) | |
download | poky-6846d4d00bc3a9d4e188ad9c8cfdf6e45cd1ba06.tar.gz |
manuals: define proper numbered lists
Using "#." instead of "1.", "2.", "3.", etc.
(From yocto-docs rev: 11c2585acd0fa6c330702af2359ce5a9e47cde1f)
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Reported-by: Quentin Schulz <foss+yocto@0leil.net>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/sdk-manual/appendix-obtain.rst')
-rw-r--r-- | documentation/sdk-manual/appendix-obtain.rst | 28 |
1 files changed, 14 insertions, 14 deletions
diff --git a/documentation/sdk-manual/appendix-obtain.rst b/documentation/sdk-manual/appendix-obtain.rst index fa82af5c22..ba844507d3 100644 --- a/documentation/sdk-manual/appendix-obtain.rst +++ b/documentation/sdk-manual/appendix-obtain.rst | |||
@@ -28,14 +28,14 @@ and then run the script to hand-install the toolchain. | |||
28 | 28 | ||
29 | Follow these steps to locate and hand-install the toolchain: | 29 | Follow these steps to locate and hand-install the toolchain: |
30 | 30 | ||
31 | 1. *Go to the Installers Directory:* Go to | 31 | #. *Go to the Installers Directory:* Go to |
32 | :yocto_dl:`/releases/yocto/yocto-&DISTRO;/toolchain/` | 32 | :yocto_dl:`/releases/yocto/yocto-&DISTRO;/toolchain/` |
33 | 33 | ||
34 | 2. *Open the Folder for Your Build Host:* Open the folder that matches | 34 | #. *Open the Folder for Your Build Host:* Open the folder that matches |
35 | your :term:`Build Host` (i.e. | 35 | your :term:`Build Host` (i.e. |
36 | ``i686`` for 32-bit machines or ``x86_64`` for 64-bit machines). | 36 | ``i686`` for 32-bit machines or ``x86_64`` for 64-bit machines). |
37 | 37 | ||
38 | 3. *Locate and Download the SDK Installer:* You need to find and | 38 | #. *Locate and Download the SDK Installer:* You need to find and |
39 | download the installer appropriate for your build host, target | 39 | download the installer appropriate for your build host, target |
40 | hardware, and image type. | 40 | hardware, and image type. |
41 | 41 | ||
@@ -72,7 +72,7 @@ Follow these steps to locate and hand-install the toolchain: | |||
72 | 72 | ||
73 | poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh | 73 | poky-glibc-x86_64-core-image-sato-core2-64-toolchain-ext-&DISTRO;.sh |
74 | 74 | ||
75 | 4. *Run the Installer:* Be sure you have execution privileges and run | 75 | #. *Run the Installer:* Be sure you have execution privileges and run |
76 | the installer. Following is an example from the ``Downloads`` | 76 | the installer. Following is an example from the ``Downloads`` |
77 | directory:: | 77 | directory:: |
78 | 78 | ||
@@ -91,13 +91,13 @@ Building an SDK Installer | |||
91 | As an alternative to locating and downloading an SDK installer, you can | 91 | As an alternative to locating and downloading an SDK installer, you can |
92 | build the SDK installer. Follow these steps: | 92 | build the SDK installer. Follow these steps: |
93 | 93 | ||
94 | 1. *Set Up the Build Environment:* Be sure you are set up to use BitBake | 94 | #. *Set Up the Build Environment:* Be sure you are set up to use BitBake |
95 | in a shell. See the ":ref:`dev-manual/start:preparing the build host`" section | 95 | in a shell. See the ":ref:`dev-manual/start:preparing the build host`" section |
96 | in the Yocto Project Development Tasks Manual for information on how | 96 | in the Yocto Project Development Tasks Manual for information on how |
97 | to get a build host ready that is either a native Linux machine or a | 97 | to get a build host ready that is either a native Linux machine or a |
98 | machine that uses CROPS. | 98 | machine that uses CROPS. |
99 | 99 | ||
100 | 2. *Clone the ``poky`` Repository:* You need to have a local copy of the | 100 | #. *Clone the ``poky`` Repository:* You need to have a local copy of the |
101 | Yocto Project :term:`Source Directory` | 101 | Yocto Project :term:`Source Directory` |
102 | (i.e. a local | 102 | (i.e. a local |
103 | ``poky`` repository). See the ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" and | 103 | ``poky`` repository). See the ":ref:`dev-manual/start:cloning the \`\`poky\`\` repository`" and |
@@ -107,7 +107,7 @@ build the SDK installer. Follow these steps: | |||
107 | how to clone the ``poky`` repository and check out the appropriate | 107 | how to clone the ``poky`` repository and check out the appropriate |
108 | branch for your work. | 108 | branch for your work. |
109 | 109 | ||
110 | 3. *Initialize the Build Environment:* While in the root directory of | 110 | #. *Initialize the Build Environment:* While in the root directory of |
111 | the Source Directory (i.e. ``poky``), run the | 111 | the Source Directory (i.e. ``poky``), run the |
112 | :ref:`structure-core-script` environment | 112 | :ref:`structure-core-script` environment |
113 | setup script to define the OpenEmbedded build environment on your | 113 | setup script to define the OpenEmbedded build environment on your |
@@ -120,12 +120,12 @@ build the SDK installer. Follow these steps: | |||
120 | the script runs, your current working directory is set to the ``build`` | 120 | the script runs, your current working directory is set to the ``build`` |
121 | directory. | 121 | directory. |
122 | 122 | ||
123 | 4. *Make Sure You Are Building an Installer for the Correct Machine:* | 123 | #. *Make Sure You Are Building an Installer for the Correct Machine:* |
124 | Check to be sure that your :term:`MACHINE` variable in the ``local.conf`` | 124 | Check to be sure that your :term:`MACHINE` variable in the ``local.conf`` |
125 | file in your :term:`Build Directory` matches the architecture | 125 | file in your :term:`Build Directory` matches the architecture |
126 | for which you are building. | 126 | for which you are building. |
127 | 127 | ||
128 | 5. *Make Sure Your SDK Machine is Correctly Set:* If you are building a | 128 | #. *Make Sure Your SDK Machine is Correctly Set:* If you are building a |
129 | toolchain designed to run on an architecture that differs from your | 129 | toolchain designed to run on an architecture that differs from your |
130 | current development host machine (i.e. the build host), be sure that | 130 | current development host machine (i.e. the build host), be sure that |
131 | the :term:`SDKMACHINE` variable in the ``local.conf`` file in your | 131 | the :term:`SDKMACHINE` variable in the ``local.conf`` file in your |
@@ -145,7 +145,7 @@ build the SDK installer. Follow these steps: | |||
145 | different from the architecture of the build machine (``x86_64``). | 145 | different from the architecture of the build machine (``x86_64``). |
146 | 146 | ||
147 | 147 | ||
148 | 6. *Build the SDK Installer:* To build the SDK installer for a standard | 148 | #. *Build the SDK Installer:* To build the SDK installer for a standard |
149 | SDK and populate the SDK image, use the following command form. Be | 149 | SDK and populate the SDK image, use the following command form. Be |
150 | sure to replace ``image`` with an image (e.g. "core-image-sato"):: | 150 | sure to replace ``image`` with an image (e.g. "core-image-sato"):: |
151 | 151 | ||
@@ -175,7 +175,7 @@ build the SDK installer. Follow these steps: | |||
175 | static development libraries: TOOLCHAIN_TARGET_TASK:append = " | 175 | static development libraries: TOOLCHAIN_TARGET_TASK:append = " |
176 | libc-staticdev" | 176 | libc-staticdev" |
177 | 177 | ||
178 | 7. *Run the Installer:* You can now run the SDK installer from | 178 | #. *Run the Installer:* You can now run the SDK installer from |
179 | ``tmp/deploy/sdk`` in the :term:`Build Directory`. Following is an example:: | 179 | ``tmp/deploy/sdk`` in the :term:`Build Directory`. Following is an example:: |
180 | 180 | ||
181 | $ cd poky/build/tmp/deploy/sdk | 181 | $ cd poky/build/tmp/deploy/sdk |
@@ -203,7 +203,7 @@ separately extract a root filesystem: | |||
203 | 203 | ||
204 | Follow these steps to extract the root filesystem: | 204 | Follow these steps to extract the root filesystem: |
205 | 205 | ||
206 | 1. *Locate and Download the Tarball for the Pre-Built Root Filesystem | 206 | #. *Locate and Download the Tarball for the Pre-Built Root Filesystem |
207 | Image File:* You need to find and download the root filesystem image | 207 | Image File:* You need to find and download the root filesystem image |
208 | file that is appropriate for your target system. These files are kept | 208 | file that is appropriate for your target system. These files are kept |
209 | in machine-specific folders in the | 209 | in machine-specific folders in the |
@@ -241,7 +241,7 @@ Follow these steps to extract the root filesystem: | |||
241 | 241 | ||
242 | core-image-sato-sdk-beaglebone-yocto.tar.bz2 | 242 | core-image-sato-sdk-beaglebone-yocto.tar.bz2 |
243 | 243 | ||
244 | 2. *Initialize the Cross-Development Environment:* You must ``source`` | 244 | #. *Initialize the Cross-Development Environment:* You must ``source`` |
245 | the cross-development environment setup script to establish necessary | 245 | the cross-development environment setup script to establish necessary |
246 | environment variables. | 246 | environment variables. |
247 | 247 | ||
@@ -253,7 +253,7 @@ Follow these steps to extract the root filesystem: | |||
253 | 253 | ||
254 | $ source poky_sdk/environment-setup-core2-64-poky-linux | 254 | $ source poky_sdk/environment-setup-core2-64-poky-linux |
255 | 255 | ||
256 | 3. *Extract the Root Filesystem:* Use the ``runqemu-extract-sdk`` | 256 | #. *Extract the Root Filesystem:* Use the ``runqemu-extract-sdk`` |
257 | command and provide the root filesystem image. | 257 | command and provide the root filesystem image. |
258 | 258 | ||
259 | Following is an example command that extracts the root filesystem | 259 | Following is an example command that extracts the root filesystem |