diff options
| author |   Scott Rifenbark <srifenbark@gmail.com> | 2018-10-18 13:12:32 -0700 |
|---|---|---|
| committer |   Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-10-20 14:28:00 +0100 |
| commit | 4b4b9c9c1929b7e7ad1381791f6bb720d5d8bc54 (patch) | |
| tree | 6e8e76330e0269de6321bb4b33d37742248d2ca5 /documentation/ref-manual/ref-terms.xml | |
| parent | afec74f512508639648b76cc35fbfaf5f47455fe (diff) | |
| download | openembedded-core-contrib-4b4b9c9c1929b7e7ad1381791f6bb720d5d8bc54.tar.gz | |
ref-manual: Updates to describe wildcarding support
Added specific wildcarding support descriptions for all related
variables and file panthnames.
(From yocto-docs rev: 543e398c4ae1bce38517a88cd91c957a583a2892)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/ref-terms.xml')
| -rw-r--r-- | documentation/ref-manual/ref-terms.xml | 30 |
1 files changed, 25 insertions, 5 deletions
diff --git a/documentation/ref-manual/ref-terms.xml b/documentation/ref-manual/ref-terms.xml index e25a147549..c573a521a7 100644 --- a/documentation/ref-manual/ref-terms.xml +++ b/documentation/ref-manual/ref-terms.xml @@ -29,11 +29,31 @@ information in the similarly-named recipe file. For an example of an append file in use, see the "<ulink url='&YOCTO_DOCS_DEV_URL;#using-bbappend-files'>Using .bbappend Files in Your Layer</ulink>" - section in the Yocto Project Development Tasks Manual. - <note> - Append files can also use wildcard patterns in their - version numbers so they can be applied to more than one - version of the underlying recipe file. + section in the Yocto Project Development Tasks Manual.</para> + + <para>When you name an append file, you can use the + "<filename>%</filename>" wildcard character to allow for + matching recipe names. + For example, suppose you have an append file named as follows: + <literallayout class='monospaced'> + busybox_1.21.%.bbappend + </literallayout> + That append file would match any + <filename>busybox_1.21.</filename><replaceable>x</replaceable><filename>.bb</filename> + version of the recipe. + So, the append file would match the following recipe names: + <literallayout class='monospaced'> + busybox_1.21.1.bb + busybox_1.21.2.bb + busybox_1.21.3.bb + </literallayout> + <note><title>Important</title> + The use of the "<filename>%</filename>" character + is limited in that it only works directly in front of the + <filename>.bbappend</filename> portion of the append file's + name. + You cannot use the wildcard character in any other + location of the name. </note> </para></listitem> <listitem><para id='bitbake-term'> |