summaryrefslogtreecommitdiffstats
path: root/documentation/sdk-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/sdk-manual')
-rw-r--r--documentation/sdk-manual/sdk-appendix-customizing-standard.xml63
-rw-r--r--documentation/sdk-manual/sdk-manual.xml2
2 files changed, 65 insertions, 0 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-customizing-standard.xml b/documentation/sdk-manual/sdk-appendix-customizing-standard.xml
new file mode 100644
index 0000000000..fd903e38e5
--- /dev/null
+++ b/documentation/sdk-manual/sdk-appendix-customizing-standard.xml
@@ -0,0 +1,63 @@
1<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
4
5<appendix id='sdk-appendix-customizing-standard'>
6
7<title>Customizing the Standard SDK</title>
8
9<para>
10 This appendix presents customizations you can apply to the standard SDK.
11</para>
12
13<section id='sdk-adding-individual-packages'>
14 <title>Adding Individual Packages to the Standard SDK</title>
15
16 <para>
17 When you build a standard SDK using the
18 <filename>bitbake -c populate_sdk</filename>, a default set of
19 packages is included in the resulting SDK.
20 The
21 <ulink url='&YOCTO_DOCS_REF_URL;#var-TOOLCHAIN_HOST_TASK'><filename>TOOLCHAIN_HOST_TASK</filename></ulink>
22 and
23 <ulink url='&YOCTO_DOCS_REF_URL;#var-TOOLCHAIN_TARGET_TASK'><filename>TOOLCHAIN_TARGET_TASK</filename></ulink>
24 variables contol the set of packages adding to the SDK.
25 </para>
26
27 <para>
28 If you want to add individual packages to the toolchain that runs on
29 the host, simply add those packages to the
30 <filename>TOOLCHAIN_HOST_TASK</filename> variable.
31 Similarly, if you want to add packages to the default set that is
32 part of the toolchain that runs on the target, add the packages to the
33 <filename>TOOLCHAIN_TARGET_TASK</filename> variable.
34 </para>
35</section>
36
37<section id='adding-api-documentation-to-the-standard-sdk'>
38 <title>Adding API Documentation to the Standard SDK</title>
39
40 <para>
41 You might want to include documentation as part of the standard SDK.
42 For example, you might want the API documentation to be built and
43 included with the SDK.
44 You can include API documentation as well as any other documentation
45 with the standard SDK by setting the
46 <ulink url='&YOCTO_DOCS_REF_URL;#var-SDKIMAGE_FEATURES'><filename>SDKIMAGE_FEATURES</filename></ulink>
47 and
48 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></ulink>
49 variables:
50 <literallayout class='monospaced'>
51 SDKIMAGE_FEATURES = "doc-pkgs"
52 DISTRO_FEATURES = "api-documentation"
53 </literallayout>
54 Setting these variables as shown here causes the OpenEmbedded build
55 system to build the documentation and then include it in the
56 standard SDK.
57 </para>
58</section>
59
60</appendix>
61<!--
62vim: expandtab tw=80 ts=4
63-->
diff --git a/documentation/sdk-manual/sdk-manual.xml b/documentation/sdk-manual/sdk-manual.xml
index 6c72a03464..1b4e198e6e 100644
--- a/documentation/sdk-manual/sdk-manual.xml
+++ b/documentation/sdk-manual/sdk-manual.xml
@@ -76,6 +76,8 @@
76 76
77 <xi:include href="sdk-appendix-customizing.xml"/> 77 <xi:include href="sdk-appendix-customizing.xml"/>
78 78
79 <xi:include href="sdk-appendix-customizing-standard.xml"/>
80
79 <xi:include href="sdk-appendix-mars.xml"/> 81 <xi:include href="sdk-appendix-mars.xml"/>
80 82
81<!-- <index id='index'> 83<!-- <index id='index'>