diff options
-rw-r--r-- | documentation/sdk-manual/sdk-appendix-obtain.xml | 85 |
1 files changed, 63 insertions, 22 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-obtain.xml b/documentation/sdk-manual/sdk-appendix-obtain.xml index a9996c4d18..baf5dfd42f 100644 --- a/documentation/sdk-manual/sdk-appendix-obtain.xml +++ b/documentation/sdk-manual/sdk-appendix-obtain.xml | |||
@@ -6,28 +6,69 @@ | |||
6 | 6 | ||
7 | <title>Obtaining the SDK</title> | 7 | <title>Obtaining the SDK</title> |
8 | 8 | ||
9 | <para> | 9 | <section id='sdk-appendix-obtain-manual-development-notes'> |
10 | This chapter is going to cover the details on getting the SDK on your | 10 | <title>Manual Development Notes for Scott and Paul</title> |
11 | system. | 11 | |
12 | It is debatable as to whether or not this should be an appendix. | 12 | <para> |
13 | It could be part of a main chapter I think. | 13 | This chapter is going to cover details about the installed SDK and perhaps |
14 | Originally suggested by Paul that it should be an appendix. | 14 | stuff on locating it (e.g. the naming scheme used to identify the |
15 | I have a sub-section in the main chapters to cover this should we | 15 | <filename>.sh</filename> installation script. |
16 | decide to place it there. | 16 | </para> |
17 | </para> | 17 | |
18 | 18 | <para> | |
19 | <para> | 19 | The idea here is to gather all the current information in the regular |
20 | The idea here is to gather all the current information in the regular | 20 | YP doc set that describes how to locate, download, or build out the SDK. |
21 | YP doc set that describes how to locate, download, or build out the SDK. | 21 | </para> |
22 | </para> | 22 | |
23 | 23 | <para> | |
24 | <para> | 24 | One thing that needs discussed is any differences between getting the |
25 | One thing that needs discussed is any differences between getting the | 25 | standard SDK as compared to the extended SDK. |
26 | standard SDK as compared to the extended SDK. | 26 | Do we have pre-build extensible SDKs laying around? |
27 | Do we have pre-build extensible SDKs laying around? | 27 | Where do we get any pre-built SDKs from? |
28 | Where do we get any pre-built SDKs from? | 28 | Show the methods by which the user builds out the SDK? |
29 | Show the methods by which the user builds out the SDK? | 29 | </para> |
30 | </para> | 30 | </section> |
31 | |||
32 | <section id='sdk-installed-standard-sdk-directory-structure'> | ||
33 | <title>Installed Standard SDK Directory Structure</title> | ||
34 | |||
35 | <para> | ||
36 | The following figure shows the resulting directory structure after | ||
37 | you install the Standard SDK by running the <filename>.sh</filename> | ||
38 | SDK installation script: | ||
39 | </para> | ||
40 | |||
41 | <para> | ||
42 | <imagedata fileref="figures/sdk-installed-standard-sdk-directory.png" scale="60" align="center" /> | ||
43 | </para> | ||
44 | |||
45 | <para> | ||
46 | The installed SDK consists of an environment setup script for the SDK, | ||
47 | a configuration file for the target, a version file for the target, | ||
48 | and the root filesystem (<filename>sysroots</filename>) needed to | ||
49 | develop objects for the target system. | ||
50 | </para> | ||
51 | |||
52 | <para> | ||
53 | Within the figure, italicized text is used to indicate replaceable | ||
54 | portions of the file or directory name. | ||
55 | For example, | ||
56 | <replaceable>install_dir</replaceable>/<replaceable>version</replaceable> | ||
57 | is the directory where the SDK is installed. | ||
58 | By default, this directory is <filename>/opt/poky/</filename>. | ||
59 | And, <replaceable>version</replaceable> represents the specific | ||
60 | snapshot of the SDK (e.g. <filename>&DISTRO;+snapshot</filename>). | ||
61 | Furthermore, <replaceable>target</replaceable> represents the target | ||
62 | architecture (e.g. <filename>i586</filename>) and | ||
63 | <replaceable>host</replaceable> represents the development system's | ||
64 | architecture (e.g. <filename>x86_64</filename>). | ||
65 | Thus, the complete names of the two directories within the | ||
66 | <filename>sysroots</filename> could be | ||
67 | <filename>i586-poky-linux</filename> and | ||
68 | <filename>x86_64-pokysdk-linux</filename> for the target and host, | ||
69 | respectively. | ||
70 | </para> | ||
71 | </section> | ||
31 | 72 | ||
32 | </appendix> | 73 | </appendix> |
33 | <!-- | 74 | <!-- |