summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/sdk-manual/sdk-appendix-customizing.xml50
1 files changed, 31 insertions, 19 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-customizing.xml b/documentation/sdk-manual/sdk-appendix-customizing.xml
index b1bd03f037..2d1788660b 100644
--- a/documentation/sdk-manual/sdk-appendix-customizing.xml
+++ b/documentation/sdk-manual/sdk-appendix-customizing.xml
@@ -78,11 +78,13 @@
78 </para> 78 </para>
79</section> 79</section>
80 80
81<section id='adjusting-the-extensible-sdk-to-suit-your-build-system-setup'> 81<section id='adjusting-the-extensible-sdk-to-suit-your-build-hosts-setup'>
82 <title>Adjusting the Extensible SDK to Suit Your Build System Setup</title> 82 <title>Adjusting the Extensible SDK to Suit Your Build Host's Setup</title>
83 83
84 <para> 84 <para>
85 In most cases, the extensible SDK defaults should work. 85 In most cases, the extensible SDK defaults should work with your
86 <ulink url='&YOCTO_DOCS_REF_URL;#hardware-build-system-term'>build host's</ulink>
87 setup.
86 However, some cases exist for which you might consider making 88 However, some cases exist for which you might consider making
87 adjustments: 89 adjustments:
88 <itemizedlist> 90 <itemizedlist>
@@ -93,33 +95,43 @@
93 variable and you do not need or want those classes enabled in 95 variable and you do not need or want those classes enabled in
94 the SDK, you can blacklist them by adding them to the 96 the SDK, you can blacklist them by adding them to the
95 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_INHERIT_BLACKLIST'><filename>SDK_INHERIT_BLACKLIST</filename></ulink> 97 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_INHERIT_BLACKLIST'><filename>SDK_INHERIT_BLACKLIST</filename></ulink>
96 variable. 98 variable as described in the fourth bullet of the previous
97 The default value of <filename>SDK_INHERIT_BLACKLIST</filename> 99 section.
98 is set using the "?=" operator. 100 <note>
99 Consequently, you will need to either set the complete value 101 The default value of
100 using "=" or append the value using "_append". 102 <filename>SDK_INHERIT_BLACKLIST</filename> is set using
103 the "?=" operator.
104 Consequently, you will need to either define the entire
105 list by using the "=" operator, or you will need to append
106 a value using either "_append" or the "+=" operator.
107 You can learn more about these operators in the
108 "<ulink url='&YOCTO_DOCS_BB_URL;#basic-syntax'>Basic Syntax</ulink>"
109 section of the BitBake User Manual.
110 </note>.
101 </para></listitem> 111 </para></listitem>
102 <listitem><para> 112 <listitem><para>
103 If you have classes or recipes that add additional tasks to 113 If you have classes or recipes that add additional tasks to
104 the standard build flow (i.e. that execute as part of building 114 the standard build flow (i.e. the tasks execute as the recipe
105 the recipe as opposed to needing to be called explicitly), then 115 builds as opposed to being called explicitly), then you need
106 you need to do one of the following: 116 to do one of the following:
107 <itemizedlist> 117 <itemizedlist>
108 <listitem><para> 118 <listitem><para>
109 Ensure the tasks are shared state tasks (i.e. their 119 After ensuring the tasks are
110 output is saved to and can be restored from the shared 120 <ulink url='&YOCTO_DOCS_OM_URL;#shared-state-cache'>shared state</ulink>
111 state cache), or that the tasks are able to be 121 tasks (i.e. the output of the task is saved to and
112 produced quickly from a task that is a shared state 122 can be restored from the shared state cache) or
113 task and add the task name to the value of 123 ensuring the tasks are able to be produced quickly from
124 a task that is a shared state task, add the task name
125 to the value of
114 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_RECRDEP_TASKS'><filename>SDK_RECRDEP_TASKS</filename></ulink>. 126 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_RECRDEP_TASKS'><filename>SDK_RECRDEP_TASKS</filename></ulink>.
115 </para></listitem> 127 </para></listitem>
116 <listitem><para> 128 <listitem><para>
117 Disable the tasks if they are added by a class and 129 Disable the tasks if they are added by a class and
118 you do not need the functionality the class provides 130 you do not need the functionality the class provides
119 in the extensible SDK. 131 in the extensible SDK.
120 To disable the tasks, add the class to 132 To disable the tasks, add the class to the
121 <filename>SDK_INHERIT_BLACKLIST</filename> as previously 133 <filename>SDK_INHERIT_BLACKLIST</filename> variable
122 described. 134 as described in the previous section.
123 </para></listitem> 135 </para></listitem>
124 </itemizedlist> 136 </itemizedlist>
125 </para></listitem> 137 </para></listitem>