summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-07-11 15:42:57 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-08-15 10:28:42 +0100
commit450a3d75f8d2feb874042123fa0b4f6844b8393a (patch)
tree90b3c84038371e07e666d9c0c8be6183353c748d /documentation
parenteabfa9f39848c2df6d06fd5fcdc300f20820163f (diff)
downloadpoky-450a3d75f8d2feb874042123fa0b4f6844b8393a.tar.gz
sdk-manual: Updates to "Configuring the Extensible SDK" section
Made improvements to this section and tied the variables together for the explanation. (From yocto-docs rev: de882b81ed8525dee5e10f247cc6f5c8f15e0f72) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/sdk-manual/sdk-appendix-customizing.xml29
1 files changed, 17 insertions, 12 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-customizing.xml b/documentation/sdk-manual/sdk-appendix-customizing.xml
index 5b56e738d6..b1bd03f037 100644
--- a/documentation/sdk-manual/sdk-appendix-customizing.xml
+++ b/documentation/sdk-manual/sdk-appendix-customizing.xml
@@ -17,26 +17,31 @@
17 The extensible SDK primarily consists of a pre-configured copy of 17 The extensible SDK primarily consists of a pre-configured copy of
18 the OpenEmbedded build system from which it was produced. 18 the OpenEmbedded build system from which it was produced.
19 Thus, the SDK's configuration is derived using that build system and 19 Thus, the SDK's configuration is derived using that build system and
20 the following filters, which the OpenEmbedded build system applies 20 the filters shown in the following list.
21 against <filename>local.conf</filename> and 21 When these filters are present, the OpenEmbedded build system applies
22 <filename>auto.conf</filename> if they are present: 22 them against <filename>local.conf</filename> and
23 <filename>auto.conf</filename>:
23 <itemizedlist> 24 <itemizedlist>
24 <listitem><para> 25 <listitem><para>
25 Variables whose values start with "/" are excluded since the 26 Variables whose values start with "/" are excluded since the
26 assumption is that those values are paths that are likely to 27 assumption is that those values are paths that are likely to
27 be specific to the build host. 28 be specific to the
29 <ulink url='&YOCTO_DOCS_REF_URL;#hardware-build-system-term'>build host</ulink>.
28 </para></listitem> 30 </para></listitem>
29 <listitem><para> 31 <listitem><para>
30 Variables listed in 32 Variables listed in
31 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_BLACKLIST'><filename>SDK_LOCAL_CONF_BLACKLIST</filename></ulink> 33 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_BLACKLIST'><filename>SDK_LOCAL_CONF_BLACKLIST</filename></ulink>
32 are excluded. 34 are excluded.
33 The default value blacklists 35 These variables are not allowed through from the OpenEmbedded
34 <ulink url='&YOCTO_DOCS_REF_URL;#var-CONF_VERSION'><filename>CONF_VERSION</filename></ulink>, 36 build system configuration into the extensible SDK
35 <ulink url='&YOCTO_DOCS_REF_URL;#var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></ulink>, 37 configuration.
36 <ulink url='&YOCTO_DOCS_REF_URL;#var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></ulink>, 38 Typically, these variables are specific to the machine on
37 <ulink url='&YOCTO_DOCS_REF_URL;#var-PRSERV_HOST'><filename>PRSERV_HOST</filename></ulink>, 39 which the build system is running and could be problematic
38 and 40 as part of the extensible SDK configuration.</para>
39 <ulink url='&YOCTO_DOCS_REF_URL;#var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></ulink>. 41
42 <para>For a list of the variables excluded by default, see the
43 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_BLACKLIST'><filename>SDK_LOCAL_CONF_BLACKLIST</filename></ulink>
44 in the glossary of the Yocto Project Reference Manual.
40 </para></listitem> 45 </para></listitem>
41 <listitem><para> 46 <listitem><para>
42 Variables listed in 47 Variables listed in
@@ -44,7 +49,7 @@
44 are included. 49 are included.
45 Including a variable in the value of 50 Including a variable in the value of
46 <filename>SDK_LOCAL_CONF_WHITELIST</filename> overrides either 51 <filename>SDK_LOCAL_CONF_WHITELIST</filename> overrides either
47 of the above two conditions. 52 of the previous two filters.
48 The default value is blank. 53 The default value is blank.
49 </para></listitem> 54 </para></listitem>
50 <listitem><para> 55 <listitem><para>