summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-01-31 16:25:55 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-02-11 12:01:32 +0000
commitf670e3a13401d6f690657ae4a17084074c015a13 (patch)
tree9482b809a09e4d099d29688524486c862f66e72a /documentation
parentf084e33e5d72cebb7272287245c87c0ce3486920 (diff)
downloadast2050-yocto-poky-f670e3a13401d6f690657ae4a17084074c015a13.zip
ast2050-yocto-poky-f670e3a13401d6f690657ae4a17084074c015a13.tar.gz
ref-manual: Edits to ROOT_HOME
Fixes [YOCTO #5762] Applied some more detail based on Laszlo's review comments. (From yocto-docs rev: eb8d11504d6c22dfd9620422df3fc31cfcebb00c) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/ref-variables.xml21
1 files changed, 17 insertions, 4 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index ae39bf2..b7189e7 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -5480,13 +5480,26 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<literallayout class='monospaced'>
ROOT_HOME ??= "/home/root"
</literallayout>
+ <note>
+ This default value is likely used because some
+ embedded solutions prefer to have a read-only root
+ filesystem and prefer to keep writeable data in one
+ place.
+ </note>
+ </para>
+
+ <para>
You can override the default by setting the variable
- in any layer or in the
- <filename>local.conf</filename> file using the following
- form:
+ in any layer or in the <filename>local.conf</filename> file.
+ Because the default is set using a "weak" assignment
+ (i.e. "??="), you can use either of the following forms
+ to define your override:
<literallayout class='monospaced'>
- ROOT_HOME ?= "&lt;path&gt;"
+ ROOT_HOME = "/root"
+ ROOT_HOME ?= "/root"
</literallayout>
+ These override examples use <filename>/root</filename>,
+ which is probably the most commonly used override.
</para>
</glossdef>
</glossentry>
OpenPOWER on IntegriCloud