summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/ref-variables.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-01-30 14:10:25 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-02-14 17:24:00 +0000
commit6a926df682a3964d6b5bc65c6610acf7463adaee (patch)
tree18e4bc8d46490333a9b42ffecf9031e48b1f9595 /documentation/ref-manual/ref-variables.xml
parent58f61cf79eb0796864c090b1ec0203760c6ec3ae (diff)
downloadpoky-6a926df682a3964d6b5bc65c6610acf7463adaee.tar.gz
ref-manual: Updates to the FILESEXTRAPATHS variable.
Fixed YOCTO #3662 Updates to the description so _prepend is used to add paths to the front of the search order and use of the variable without _prepend just adds paths to the end of the FILESPATH order. Reported-by: Robert P. J. Day <rpjday@crashcourse.ca> (From yocto-docs rev: 44c98058c1a75a9e6c95e4f33dbe1696e23d97d0) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r--documentation/ref-manual/ref-variables.xml32
1 files changed, 20 insertions, 12 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 3088123581..0a29502544 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1012,31 +1012,39 @@ Core layer for images cannot be removed
1012 <glossentry id='var-FILESEXTRAPATHS'><glossterm>FILESEXTRAPATHS</glossterm> 1012 <glossentry id='var-FILESEXTRAPATHS'><glossterm>FILESEXTRAPATHS</glossterm>
1013 <glossdef> 1013 <glossdef>
1014 <para> 1014 <para>
1015 Extends the search path the OpenEmbedded build system uses when 1015 Extends the search path the OpenEmbedded build system uses
1016 looking for files and patches as it processes recipes. 1016 when looking for files and patches as it processes recipes.
1017 The directories BitBake uses when it processes recipes is defined by the 1017 The directories BitBake uses when it processes recipes are
1018 defined by the
1018 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> variable. 1019 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> variable.
1019 You can add directories to the search path by defining the 1020 You can add directories to the search path by defining the
1020 <filename>FILESEXTRAPATHS</filename> variable. 1021 <filename>FILESEXTRAPATHS</filename> variable.
1021 </para> 1022 </para>
1022 1023
1023 <para> 1024 <para>
1024 To add paths to the search order, provide a list of directories and separate 1025 To add paths to the front of the search order, prepend
1026 them and use the immediate expansion
1027 (<filename>:=</filename>) operator.
1028 Provide a list of directories and separate
1025 each path using a colon character as follows: 1029 each path using a colon character as follows:
1026 <literallayout class='monospaced'> 1030 <literallayout class='monospaced'>
1027 FILESEXTRAPATHS_prepend := "path_1:path_2:path_3:" 1031 FILESEXTRAPATHS_prepend := "path_1:path_2:path_3:"
1028 </literallayout> 1032 </literallayout>
1029 Typically, you want your directories searched first. 1033 You can add paths to the end of the search order by simply
1030 To make sure that happens, use <filename>_prepend</filename> and 1034 adding them as follows:
1031 the immediate expansion (<filename>:=</filename>) operator as shown in the 1035 <literallayout class='monospaced'>
1032 previous example. 1036 FILESEXTRAPATHS := "path_1:path_2:path_3:"
1033 Finally, to maintain the integrity of the <filename>FILESPATH</filename> variable, 1037 </literallayout>
1034 you must include the appropriate beginning or ending (as needed) colon character. 1038 To maintain the integrity of the
1039 <filename>FILESPATH</filename> variable, you must include
1040 the appropriate beginning or ending (as needed) colon
1041 character.
1035 </para> 1042 </para>
1036 1043
1037 <para> 1044 <para>
1038 The <filename>FILESEXTRAPATHS</filename> variable is intended for use in 1045 The <filename>FILESEXTRAPATHS</filename> variable is
1039 <filename>.bbappend</filename> files to include any additional files provided in that layer. 1046 intended for use in <filename>.bbappend</filename> files
1047 to include any additional files provided in that layer.
1040 You typically accomplish this with the following: 1048 You typically accomplish this with the following:
1041 <literallayout class='monospaced'> 1049 <literallayout class='monospaced'>
1042 FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" 1050 FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"