From 11e92659b4f8057d8b4ef82bdca3f9f87ad17f25 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <scott.m.rifenbark@intel.com>
Date: Mon, 14 Jan 2013 16:50:19 -0800
Subject: ref-manual: New LINUX_VERSION_EXTENSION variable glossary entry.

(From yocto-docs rev: 98a1d57e0bcf018509bb2a167381817b0b6b95d8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/ref-manual/ref-variables.xml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

(limited to 'documentation')

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index fc95845c66..01f5fe9cfb 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1695,6 +1695,32 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-LINUX_VERSION_EXTENSION'><glossterm>LINUX_VERSION_EXTENSION</glossterm>
+            <glossdef>
+                <para>A string extension compiled into the name of the
+                    Linux kernel built with the OpenEmbedded build system.
+                    You define this variable in the kernel recipe.
+                    For example, the <filename>linux-yocto-custom.bb</filename>
+                    kernel recipe found in
+                    <filename>meta-skeleton/recipes-kernel/linux</filename>
+                    defines the variable as follows:
+                    <literallayout class='monospaced'>
+     LINUX_VERSION_EXTENSION ?= "-custom"
+                    </literallayout>
+                    Defining this variable essentially sets the
+                    Linux kernel configuration item
+                    <filename>CONFIG_LOCALVERSION</filename>, which is visible
+                    through the <filename>uname</filename> command.
+                    Here is an example that shows the extension assuming it
+                    was set as previously shown:
+                    <literallayout class='monospaced'>
+     $ uname -r
+     3.7.0-rc8-custom
+                    </literallayout>
+                </para>
+            </glossdef>
+        </glossentry>
+
     </glossdiv>
 
     <glossdiv id='var-glossary-m'><title>M</title>
-- 
cgit v1.2.3-54-g00ecf