summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-start.xml38
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.