diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index db9d7370f4..6807c5c309 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -26,7 +26,7 @@
H
I
- K
+ K
L
M
@@ -1035,6 +1035,61 @@ recipes-graphics/xorg-font/xorg-font-common.inc:INC_PR = "r2"
K
+ KBRANCH
+
+
+ A regular expression used by the build process to explicitly identify the kernel
+ branch that is validated, patched and configured during a build.
+ The KBRANCH variable is optional.
+ You can use it to trigger checks to ensure the exact kernel branch you want is
+ being used by the build process.
+
+
+
+ Values for this variable are set in the kernel's recipe file and the kernel's
+ append file.
+ For example, if you are using the Yocto Project kernel that is based on the
+ Linux 3.2 kernel, the kernel recipe file is the
+ meta/recipes-kernel/linux/linux-yocto_3.2.bb file.
+ Following is the default value for KBRANCH and the five overrides
+ for the architectures the Yocto Project supports:
+
+ KBRANCH = "standard/default/base"
+ KBRANCH_qemux86 = "standard/default/common-pc/base"
+ KBRANCH_qemux86-64 = "standard/default/common-pc-64/base"
+ KBRANCH_qemuppc = "standard/default/qemu-ppc32"
+ KBRANCH_qemumips = "standard/default/mti-malta32-be"
+ KBRANCH_qemuarm = "standard/default/arm-versatile-926ejs"
+
+ Each of the above branches exist in the linux-yocto-3.2 kernel Git
+ repository .
+
+
+
+ This variable is also used from the kernel's append file to identify the kernel
+ branch specific to a particular machine or target hardware.
+ The kernel's append file is located in the BSP layer for a given machine.
+ For example, the kernel append file for the Crown Bay BSP is in the
+ meta-intel Git repository and is named
+ meta-crownbay/recipes-kernel/linux/linux-yocto_3.2.bbappend.
+ Here are the related statements from the append file:
+
+ COMPATIBLE_MACHINE_crownbay = "crownbay"
+ KMACHINE_crownbay = "crownbay"
+ KBRANCH_crownbay = "standard/default/crownbay"
+
+ COMPATIBLE_MACHINE_crownbay-noemgd = "crownbay-noemgd"
+ KMACHINE_crownbay-noemgd = "crownbay"
+ KBRANCH_crownbay-noemgd = "standard/default/crownbay"
+
+ The KBRANCH_* statements identify the kernel branch to
+ use when building for the Crown Bay BSP.
+ In this case there are two identical statements: one for each type of
+ Crown Bay machine.
+
+
+
+
KERNEL_FEATURESIncludes additional metadata from the Yocto Project kernel Git repository.