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 @@
$ tar xfj poky-1.1.tar.bz2
-
This method does not produce a poky Git repository.
You end up simply with a local snapshot of Yocto Project files that are based on the
particular release in the tarball.
@@ -108,20 +107,41 @@
Linux Yocto Kernel:
If you are going to be making modifications to a supported Linux Yocto kernel you
- need a local copy of these files.
- Creating a local Git repository of the files allows you access to the files locally
- and gives you opportunity to contribute changes upstream to the Yocto Project.
- As an example, the following transcript shows how to clone the
- linux-yocto-2.6.37 kernel Git repository:
+ need to get set up so that you can edit local copies of the source.
+ This setup involves creating a bare clone of the Linux Yocto kernel and then cloning
+ that repository.
+ As an example, the following transcript shows how to create the bare clone
+ of the linux-yocto-2.6.37 kernel and then create a clone of
+ that repository:
- $ git clone git://git.yoctoproject.org/linux-yocto-2.6.37
- Initialized empty Git repository in /home/scottrif/linux-yocto-2.6.37/.git/
+ $ git clone --bare git://git.yoctoproject.org/linux-yocto-2.6.37 linux-yocto-2.6.37.git
+ Initialized empty Git repository in /home/scottrif/poky/linux-yocto-2.6.37.git/
remote: Counting objects: 1886034, done.
remote: Compressing objects: 100% (314326/314326), done.
remote: Total 1886034 (delta 1570200), reused 1870337 (delta 1554798)
- Receiving objects: 100% (1886034/1886034), 401.51 MiB | 3.99 MiB/s, done.
+ Receiving objects: 100% (1886034/1886034), 401.51 MiB | 3.27 MiB/s, done.
Resolving deltas: 100% (1570200/1570200), done.
+
+ Now create a clone of the bare clone just created:
+
+ $ git clone linux-yocto-2.6.37.git linux-yocto-2.6.37
+ Initialized empty Git repository in /home/scottrif/poky/linux-yocto-2.6.37/.git/
Checking out files: 100% (35188/35188), done.
+
+ The final repository you need for kernel development is the
+ meta-kernel-dev Git repository.
+ This repository allows you to configure the build system so that you point to your
+ local area for the Linux Yocto kernel source files.
+ Pointing to these files locally is much more efficient than requiring a download of the
+ source files from upstream each time you build the kernel image:
+
+ $ git clone git://git.yoctoproject.org/poky-extras poky-extras
+ Initialized empty Git repository in /home/scottrif/poky/poky-extras/.git/
+ remote: Counting objects: 531, done.
+ remote: Compressing objects: 100% (471/471), done.
+ remote: Total 531 (delta 138), reused 307 (delta 39)
+ Receiving objects: 100% (531/531), 517.86 KiB, done.
+ Resolving deltas: 100% (138/138), done.
Supported Board Support Packages (BSPs): The same considerations
exist for BSPs.