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>
This commit is contained in:
Scott Rifenbark
2018-07-11 15:42:57 -07:00
committed by Richard Purdie
parent eabfa9f398
commit 450a3d75f8

View File

@@ -17,26 +17,31 @@
The extensible SDK primarily consists of a pre-configured copy of The extensible SDK primarily consists of a pre-configured copy of
the OpenEmbedded build system from which it was produced. the OpenEmbedded build system from which it was produced.
Thus, the SDK's configuration is derived using that build system and Thus, the SDK's configuration is derived using that build system and
the following filters, which the OpenEmbedded build system applies the filters shown in the following list.
against <filename>local.conf</filename> and When these filters are present, the OpenEmbedded build system applies
<filename>auto.conf</filename> if they are present: them against <filename>local.conf</filename> and
<filename>auto.conf</filename>:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
Variables whose values start with "/" are excluded since the Variables whose values start with "/" are excluded since the
assumption is that those values are paths that are likely to assumption is that those values are paths that are likely to
be specific to the build host. be specific to the
<ulink url='&YOCTO_DOCS_REF_URL;#hardware-build-system-term'>build host</ulink>.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
Variables listed in Variables listed in
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_BLACKLIST'><filename>SDK_LOCAL_CONF_BLACKLIST</filename></ulink> <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_BLACKLIST'><filename>SDK_LOCAL_CONF_BLACKLIST</filename></ulink>
are excluded. are excluded.
The default value blacklists These variables are not allowed through from the OpenEmbedded
<ulink url='&YOCTO_DOCS_REF_URL;#var-CONF_VERSION'><filename>CONF_VERSION</filename></ulink>, build system configuration into the extensible SDK
<ulink url='&YOCTO_DOCS_REF_URL;#var-BB_NUMBER_THREADS'><filename>BB_NUMBER_THREADS</filename></ulink>, configuration.
<ulink url='&YOCTO_DOCS_REF_URL;#var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></ulink>, Typically, these variables are specific to the machine on
<ulink url='&YOCTO_DOCS_REF_URL;#var-PRSERV_HOST'><filename>PRSERV_HOST</filename></ulink>, which the build system is running and could be problematic
and as part of the extensible SDK configuration.</para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></ulink>.
<para>For a list of the variables excluded by default, see the
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_BLACKLIST'><filename>SDK_LOCAL_CONF_BLACKLIST</filename></ulink>
in the glossary of the Yocto Project Reference Manual.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
Variables listed in Variables listed in
@@ -44,7 +49,7 @@
are included. are included.
Including a variable in the value of Including a variable in the value of
<filename>SDK_LOCAL_CONF_WHITELIST</filename> overrides either <filename>SDK_LOCAL_CONF_WHITELIST</filename> overrides either
of the above two conditions. of the previous two filters.
The default value is blank. The default value is blank.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>