diff options
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 @@ | |||
| 29 | information in the similarly-named recipe file. | 29 | information in the similarly-named recipe file. |
| 30 | For an example of an append file in use, see the | 30 | For an example of an append file in use, see the |
| 31 | "<ulink url='&YOCTO_DOCS_DEV_URL;#using-bbappend-files'>Using .bbappend Files in Your Layer</ulink>" | 31 | "<ulink url='&YOCTO_DOCS_DEV_URL;#using-bbappend-files'>Using .bbappend Files in Your Layer</ulink>" |
| 32 | section in the Yocto Project Development Tasks Manual. | 32 | section in the Yocto Project Development Tasks Manual.</para> |
| 33 | <note> | 33 | |
| 34 | Append files can also use wildcard patterns in their | 34 | <para>When you name an append file, you can use the |
| 35 | version numbers so they can be applied to more than one | 35 | "<filename>%</filename>" wildcard character to allow for |
| 36 | version of the underlying recipe file. | 36 | matching recipe names. |
| 37 | For example, suppose you have an append file named as follows: | ||
| 38 | <literallayout class='monospaced'> | ||
| 39 | busybox_1.21.%.bbappend | ||
| 40 | </literallayout> | ||
| 41 | That append file would match any | ||
| 42 | <filename>busybox_1.21.</filename><replaceable>x</replaceable><filename>.bb</filename> | ||
| 43 | version of the recipe. | ||
| 44 | So, the append file would match the following recipe names: | ||
| 45 | <literallayout class='monospaced'> | ||
| 46 | busybox_1.21.1.bb | ||
| 47 | busybox_1.21.2.bb | ||
| 48 | busybox_1.21.3.bb | ||
| 49 | </literallayout> | ||
| 50 | <note><title>Important</title> | ||
| 51 | The use of the "<filename>%</filename>" character | ||
| 52 | is limited in that it only works directly in front of the | ||
| 53 | <filename>.bbappend</filename> portion of the append file's | ||
| 54 | name. | ||
| 55 | You cannot use the wildcard character in any other | ||
| 56 | location of the name. | ||
| 37 | </note> | 57 | </note> |
| 38 | </para></listitem> | 58 | </para></listitem> |
| 39 | <listitem><para id='bitbake-term'> | 59 | <listitem><para id='bitbake-term'> |