summaryrefslogtreecommitdiffstats
path: root/documentation/sdk-manual/appendix-customizing.rst
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/sdk-manual/appendix-customizing.rst')
-rw-r--r--documentation/sdk-manual/appendix-customizing.rst24
1 files changed, 12 insertions, 12 deletions
diff --git a/documentation/sdk-manual/appendix-customizing.rst b/documentation/sdk-manual/appendix-customizing.rst
index c122fb5836..8c635d1662 100644
--- a/documentation/sdk-manual/appendix-customizing.rst
+++ b/documentation/sdk-manual/appendix-customizing.rst
@@ -35,13 +35,13 @@ build system applies them against ``local.conf`` and ``auto.conf``:
35- Variables listed in 35- Variables listed in
36 :term:`SDK_LOCAL_CONF_WHITELIST` 36 :term:`SDK_LOCAL_CONF_WHITELIST`
37 are included. Including a variable in the value of 37 are included. Including a variable in the value of
38 ``SDK_LOCAL_CONF_WHITELIST`` overrides either of the previous two 38 :term:`SDK_LOCAL_CONF_WHITELIST` overrides either of the previous two
39 filters. The default value is blank. 39 filters. The default value is blank.
40 40
41- Classes inherited globally with 41- Classes inherited globally with
42 :term:`INHERIT` that are listed in 42 :term:`INHERIT` that are listed in
43 :term:`SDK_INHERIT_BLACKLIST` 43 :term:`SDK_INHERIT_BLACKLIST`
44 are disabled. Using ``SDK_INHERIT_BLACKLIST`` to disable these 44 are disabled. Using :term:`SDK_INHERIT_BLACKLIST` to disable these
45 classes is the typical method to disable classes that are problematic 45 classes is the typical method to disable classes that are problematic
46 or unnecessary in the SDK context. The default value blacklists the 46 or unnecessary in the SDK context. The default value blacklists the
47 :ref:`buildhistory <ref-classes-buildhistory>` 47 :ref:`buildhistory <ref-classes-buildhistory>`
@@ -95,7 +95,7 @@ adjustments:
95 95
96 - Disable the tasks if they are added by a class and you do not need 96 - Disable the tasks if they are added by a class and you do not need
97 the functionality the class provides in the extensible SDK. To 97 the functionality the class provides in the extensible SDK. To
98 disable the tasks, add the class to the ``SDK_INHERIT_BLACKLIST`` 98 disable the tasks, add the class to the :term:`SDK_INHERIT_BLACKLIST`
99 variable as described in the previous section. 99 variable as described in the previous section.
100 100
101- Generally, you want to have a shared state mirror set up so users of 101- Generally, you want to have a shared state mirror set up so users of
@@ -142,12 +142,12 @@ section.
142 142
143By default, this title is derived from 143By default, this title is derived from
144:term:`DISTRO_NAME` when it is 144:term:`DISTRO_NAME` when it is
145set. If the ``DISTRO_NAME`` variable is not set, the title is derived 145set. If the :term:`DISTRO_NAME` variable is not set, the title is derived
146from the :term:`DISTRO` variable. 146from the :term:`DISTRO` variable.
147 147
148The 148The
149:ref:`populate_sdk_base <ref-classes-populate-sdk-*>` 149:ref:`populate_sdk_base <ref-classes-populate-sdk-*>`
150class defines the default value of the ``SDK_TITLE`` variable as 150class defines the default value of the :term:`SDK_TITLE` variable as
151follows:: 151follows::
152 152
153 SDK_TITLE ??= "${@d.getVar('DISTRO_NAME') or d.getVar('DISTRO')} SDK" 153 SDK_TITLE ??= "${@d.getVar('DISTRO_NAME') or d.getVar('DISTRO')} SDK"
@@ -158,7 +158,7 @@ creates an SDK installer title that applies across your distribution. As
158an example, assume you have your own layer for your distribution named 158an example, assume you have your own layer for your distribution named
159"meta-mydistro" and you are using the same type of file hierarchy as 159"meta-mydistro" and you are using the same type of file hierarchy as
160does the default "poky" distribution. If so, you could update the 160does the default "poky" distribution. If so, you could update the
161``SDK_TITLE`` variable in the 161:term:`SDK_TITLE` variable in the
162``~/meta-mydistro/conf/distro/mydistro.conf`` file using the following 162``~/meta-mydistro/conf/distro/mydistro.conf`` file using the following
163form:: 163form::
164 164
@@ -220,7 +220,7 @@ class as follows::
220 220
221You can 221You can
222change this default installation directory by specifically setting the 222change this default installation directory by specifically setting the
223``SDKEXTPATH`` variable. 223:term:`SDKEXTPATH` variable.
224 224
225While there are several ways of setting this variable, 225While there are several ways of setting this variable,
226the method that makes the most sense is to set the variable in your 226the method that makes the most sense is to set the variable in your
@@ -229,7 +229,7 @@ default directory that applies across your distribution. As an example,
229assume you have your own layer for your distribution named 229assume you have your own layer for your distribution named
230"meta-mydistro" and you are using the same type of file hierarchy as 230"meta-mydistro" and you are using the same type of file hierarchy as
231does the default "poky" distribution. If so, you could update the 231does the default "poky" distribution. If so, you could update the
232``SDKEXTPATH`` variable in the 232:term:`SDKEXTPATH` variable in the
233``~/meta-mydistro/conf/distro/mydistro.conf`` file using the following 233``~/meta-mydistro/conf/distro/mydistro.conf`` file using the following
234form:: 234form::
235 235
@@ -284,11 +284,11 @@ source, you need to do a number of things:
284 284
285 SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS" 285 SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS"
286 286
287 - Alternatively, if you just want to set the ``SSTATE_MIRRORS`` 287 - Alternatively, if you just want to set the :term:`SSTATE_MIRRORS`
288 variable's value for the SDK alone, create a 288 variable's value for the SDK alone, create a
289 ``conf/sdk-extra.conf`` file either in your 289 ``conf/sdk-extra.conf`` file either in your
290 :term:`Build Directory` or within any 290 :term:`Build Directory` or within any
291 layer and put your ``SSTATE_MIRRORS`` setting within that file. 291 layer and put your :term:`SSTATE_MIRRORS` setting within that file.
292 292
293 .. note:: 293 .. note::
294 294
@@ -333,7 +333,7 @@ following::
333 333
334See the :term:`SDK_INCLUDE_PKGDATA` variable for additional information. 334See the :term:`SDK_INCLUDE_PKGDATA` variable for additional information.
335 335
336Setting the ``SDK_INCLUDE_PKGDATA`` variable as shown causes the "world" 336Setting the :term:`SDK_INCLUDE_PKGDATA` variable as shown causes the "world"
337target to be built so that information for all of the recipes included 337target to be built so that information for all of the recipes included
338within it are available. Having these recipes available increases build 338within it are available. Having these recipes available increases build
339time significantly and increases the size of the SDK installer by 30-80 339time significantly and increases the size of the SDK installer by 30-80
@@ -358,7 +358,7 @@ You can explicitly control whether or not to include the toolchain when
358you build an SDK by setting the 358you build an SDK by setting the
359:term:`SDK_INCLUDE_TOOLCHAIN` 359:term:`SDK_INCLUDE_TOOLCHAIN`
360variable to "1". In particular, it is useful to include the toolchain 360variable to "1". In particular, it is useful to include the toolchain
361when you have set ``SDK_EXT_TYPE`` to "minimal", which by default, 361when you have set :term:`SDK_EXT_TYPE` to "minimal", which by default,
362excludes the toolchain. Also, it is helpful if you are building a small 362excludes the toolchain. Also, it is helpful if you are building a small
363SDK for use with an IDE or some other tool where you do not want to take 363SDK for use with an IDE or some other tool where you do not want to take
364extra steps to install a toolchain. 364extra steps to install a toolchain.