summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-09-01 11:49:34 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-09-23 15:27:32 +0100
commit2233924ee6fd95b115f865bba52ed0badf243b20 (patch)
tree05026699a5c1ed6792a70f4cd02fb2891fc6f82d
parent44b0b07a6f06a96af1ff8c2ebefe20ce2f031736 (diff)
downloadpoky-2233924ee6fd95b115f865bba52ed0badf243b20.tar.gz
ref-manual: Updated the MACHINEOVERRIDES variable description
Fixes [YOCTO #10175] Provided a more detailed description of this variable. (From yocto-docs rev: 95a80313dfb276425020a61d199b75d259b47ff1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/ref-manual/ref-variables.xml47
1 files changed, 26 insertions, 21 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 64fd94c9a2..7dafb313b5 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7808,36 +7808,41 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7808 7808
7809 <glossentry id='var-MACHINEOVERRIDES'><glossterm>MACHINEOVERRIDES</glossterm> 7809 <glossentry id='var-MACHINEOVERRIDES'><glossterm>MACHINEOVERRIDES</glossterm>
7810 <info> 7810 <info>
7811 MACHINEOVERRIDES[doc] = "Lists overrides specific to the current machine. By default, this list includes the value of MACHINE." 7811 MACHINEOVERRIDES[doc] = "A colon-separated list of overrides that apply to the current machine."
7812 </info> 7812 </info>
7813 <glossdef> 7813 <glossdef>
7814 <para role="glossdeffirst"> 7814 <para role="glossdeffirst">
7815<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> 7815<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
7816 Lists overrides specific to the current machine. 7816 A colon-separated list of overrides that apply to the
7817 By default, this list includes the value 7817 current machine.
7818 of <filename><link linkend='var-MACHINE'>MACHINE</link></filename>. 7818 By default, this list includes the value of
7819 You can extend the list to apply variable overrides for 7819 <link linkend='var-MACHINE'><filename>MACHINE</filename></link>.
7820 classes of machines.
7821 For example, all QEMU emulated machines (e.g. qemuarm,
7822 qemux86, and so forth) include a common file named
7823 <filename>meta/conf/machine/include/qemu.inc</filename>
7824 that prepends <filename>MACHINEOVERRIDES</filename> with
7825 the following variable override:
7826 <literallayout class='monospaced'>
7827 MACHINEOVERRIDES =. "qemuall:"
7828 </literallayout>
7829 </para> 7820 </para>
7830 7821
7831 <para> 7822 <para>
7832 Applying an override like <filename>qemuall</filename> 7823 You can extend <filename>MACHINEOVERRIDES</filename>
7833 affects all QEMU emulated machines elsewhere. 7824 to add extra overrides that should apply to a machine.
7834 Here is an example from the 7825 For example, all machines emulated in QEMU (e.g.
7835 <filename>connman-conf</filename> recipe: 7826 <filename>qemuarm</filename>, <filename>qemux86</filename>,
7827 and so forth) include a file named
7828 <filename>meta/conf/machine/include/qemu.inc</filename>
7829 that prepends the following override to
7830 <filename>MACHINEOVERRIDES</filename>:
7836 <literallayout class='monospaced'> 7831 <literallayout class='monospaced'>
7837 SRC_URI_append_qemuall = "file://wired.config \ 7832 MACHINEOVERRIDES =. "qemuall:"
7838 file://wired-setup \
7839 "
7840 </literallayout> 7833 </literallayout>
7834 This override allows variables to be overriden for all
7835 machines emulated in QEMU, like in the following example
7836 from the <filename>connman-conf</filename> recipe:
7837 <literallayout class='monospaced'>
7838 SRC_URI_append_qemuall = "file://wired.config \
7839 file://wired-setup \
7840 "
7841 </literallayout>
7842 The underlying mechanism behind
7843 <filename>MACHINEOVERRIDES</filename> is simply that it is
7844 included in the default value of
7845 <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link>.
7841 </para> 7846 </para>
7842 </glossdef> 7847 </glossdef>
7843 </glossentry> 7848 </glossentry>