diff options
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 38 |
1 files changed, 29 insertions, 9 deletions
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 939ccef590..822731af90 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml | |||
@@ -75,7 +75,6 @@ | |||
75 | <literallayout class='monospaced'> | 75 | <literallayout class='monospaced'> |
76 | $ tar xfj poky-1.1.tar.bz2 | 76 | $ tar xfj poky-1.1.tar.bz2 |
77 | </literallayout></para> | 77 | </literallayout></para> |
78 | |||
79 | <para>This method does not produce a <filename>poky</filename> Git repository. | 78 | <para>This method does not produce a <filename>poky</filename> Git repository. |
80 | You end up simply with a local snapshot of Yocto Project files that are based on the | 79 | You end up simply with a local snapshot of Yocto Project files that are based on the |
81 | particular release in the tarball.</para></listitem> | 80 | particular release in the tarball.</para></listitem> |
@@ -108,20 +107,41 @@ | |||
108 | </itemizedlist></para></listitem> | 107 | </itemizedlist></para></listitem> |
109 | <listitem id='local-kernel-files'><para><emphasis>Linux Yocto Kernel:</emphasis> | 108 | <listitem id='local-kernel-files'><para><emphasis>Linux Yocto Kernel:</emphasis> |
110 | If you are going to be making modifications to a supported Linux Yocto kernel you | 109 | If you are going to be making modifications to a supported Linux Yocto kernel you |
111 | need a local copy of these files. | 110 | need to get set up so that you can edit local copies of the source. |
112 | Creating a local Git repository of the files allows you access to the files locally | 111 | This setup involves creating a bare clone of the Linux Yocto kernel and then cloning |
113 | and gives you opportunity to contribute changes upstream to the Yocto Project.</para> | 112 | that repository.</para> |
114 | <para>As an example, the following transcript shows how to clone the | 113 | <para>As an example, the following transcript shows how to create the bare clone |
115 | <filename>linux-yocto-2.6.37</filename> kernel Git repository: | 114 | of the <filename>linux-yocto-2.6.37</filename> kernel and then create a clone of |
115 | that repository: | ||
116 | <literallayout class='monospaced'> | 116 | <literallayout class='monospaced'> |
117 | $ git clone git://git.yoctoproject.org/linux-yocto-2.6.37 | 117 | $ git clone --bare git://git.yoctoproject.org/linux-yocto-2.6.37 linux-yocto-2.6.37.git |
118 | Initialized empty Git repository in /home/scottrif/linux-yocto-2.6.37/.git/ | 118 | Initialized empty Git repository in /home/scottrif/poky/linux-yocto-2.6.37.git/ |
119 | remote: Counting objects: 1886034, done. | 119 | remote: Counting objects: 1886034, done. |
120 | remote: Compressing objects: 100% (314326/314326), done. | 120 | remote: Compressing objects: 100% (314326/314326), done. |
121 | remote: Total 1886034 (delta 1570200), reused 1870337 (delta 1554798) | 121 | remote: Total 1886034 (delta 1570200), reused 1870337 (delta 1554798) |
122 | Receiving objects: 100% (1886034/1886034), 401.51 MiB | 3.99 MiB/s, done. | 122 | Receiving objects: 100% (1886034/1886034), 401.51 MiB | 3.27 MiB/s, done. |
123 | Resolving deltas: 100% (1570200/1570200), done. | 123 | Resolving deltas: 100% (1570200/1570200), done. |
124 | </literallayout></para> | ||
125 | <para>Now create a clone of the bare clone just created: | ||
126 | <literallayout class='monospaced'> | ||
127 | $ git clone linux-yocto-2.6.37.git linux-yocto-2.6.37 | ||
128 | Initialized empty Git repository in /home/scottrif/poky/linux-yocto-2.6.37/.git/ | ||
124 | Checking out files: 100% (35188/35188), done. | 129 | Checking out files: 100% (35188/35188), done. |
130 | </literallayout></para> | ||
131 | <para>The final repository you need for kernel development is the | ||
132 | <filename>meta-kernel-dev</filename> Git repository. | ||
133 | This repository allows you to configure the build system so that you point to your | ||
134 | local area for the Linux Yocto kernel source files. | ||
135 | Pointing to these files locally is much more efficient than requiring a download of the | ||
136 | source files from upstream each time you build the kernel image: | ||
137 | <literallayout class='monospaced'> | ||
138 | $ git clone git://git.yoctoproject.org/poky-extras poky-extras | ||
139 | Initialized empty Git repository in /home/scottrif/poky/poky-extras/.git/ | ||
140 | remote: Counting objects: 531, done. | ||
141 | remote: Compressing objects: 100% (471/471), done. | ||
142 | remote: Total 531 (delta 138), reused 307 (delta 39) | ||
143 | Receiving objects: 100% (531/531), 517.86 KiB, done. | ||
144 | Resolving deltas: 100% (138/138), done. | ||
125 | </literallayout></para></listitem> | 145 | </literallayout></para></listitem> |
126 | <listitem><para><emphasis>Supported Board Support Packages (BSPs):</emphasis> The same considerations | 146 | <listitem><para><emphasis>Supported Board Support Packages (BSPs):</emphasis> The same considerations |
127 | exist for BSPs. | 147 | exist for BSPs. |