diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2018-10-18 13:15:49 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-10-29 16:54:48 +0000 |
commit | 8c0a94129e0e1699cd72fd965ac1cc6504b1269f (patch) | |
tree | 5eb847e6938935b08c9e60a4da107036e8570450 /bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml | |
parent | 3e5c6cbf3475b513458a0bfc57dcd3353dd9e44d (diff) | |
download | poky-8c0a94129e0e1699cd72fd965ac1cc6504b1269f.tar.gz |
bitbake: bitbake-user-manual: Added wildcarding descriptions
Fixes [YOCTO #12390]
Added specific descriptions for how wildcarding works for a variety
of variables and files (e.g. append files).
(Bitbake rev: 0a4377cb1837ede213d9640344f4908de3689d91)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml | 13 |
1 files changed, 11 insertions, 2 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml index 9e2e6b2eb2..f7d312a32b 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml | |||
@@ -342,13 +342,14 @@ | |||
342 | 342 | ||
343 | <para> | 343 | <para> |
344 | When you name an append file, you can use the | 344 | When you name an append file, you can use the |
345 | wildcard character (%) to allow for matching recipe names. | 345 | "<filename>%</filename>" wildcard character to allow for matching |
346 | recipe names. | ||
346 | For example, suppose you have an append file named | 347 | For example, suppose you have an append file named |
347 | as follows: | 348 | as follows: |
348 | <literallayout class='monospaced'> | 349 | <literallayout class='monospaced'> |
349 | busybox_1.21.%.bbappend | 350 | busybox_1.21.%.bbappend |
350 | </literallayout> | 351 | </literallayout> |
351 | That append file would match any <filename>busybox_1.21.x.bb</filename> | 352 | That append file would match any <filename>busybox_1.21.</filename><replaceable>x</replaceable><filename>.bb</filename> |
352 | version of the recipe. | 353 | version of the recipe. |
353 | So, the append file would match the following recipe names: | 354 | So, the append file would match the following recipe names: |
354 | <literallayout class='monospaced'> | 355 | <literallayout class='monospaced'> |
@@ -356,6 +357,14 @@ | |||
356 | busybox_1.21.2.bb | 357 | busybox_1.21.2.bb |
357 | busybox_1.21.3.bb | 358 | busybox_1.21.3.bb |
358 | </literallayout> | 359 | </literallayout> |
360 | <note><title>Important</title> | ||
361 | The use of the "<filename>%</filename>" character | ||
362 | is limited in that it only works directly in front of the | ||
363 | <filename>.bbappend</filename> portion of the append file's | ||
364 | name. | ||
365 | You cannot use the wildcard character in any other | ||
366 | location of the name. | ||
367 | </note> | ||
359 | If the <filename>busybox</filename> recipe was updated to | 368 | If the <filename>busybox</filename> recipe was updated to |
360 | <filename>busybox_1.3.0.bb</filename>, the append name would not | 369 | <filename>busybox_1.3.0.bb</filename>, the append name would not |
361 | match. | 370 | match. |