[OE-core] [PATCH 3/3] ref-manual: update IMAGE_BOOT_FILES entry

[Maciej Borzecki]

Update entry for IMAGE_BOOT_FILES with information on glob patterns.

Signed-off-by: Maciej Borzecki <maciej.borzecki at open-rnd.pl>
Signed-off-by: Maciek Borzecki <maciek.borzecki at gmail.com>
---
 documentation/ref-manual/ref-variables.xml | 37 ++++++++++++++++++++++++------
 1 file changed, 30 insertions(+), 7 deletions(-)

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 0bae35a..bd857ef 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -3863,19 +3863,42 @@
             <glossdef>
                 <para>
                     A space-separated list of files installed into the
-                    boot partition when preparing an image.
-                    By default, the files are installed under the same name as
-                    the source files.
+                    boot partition when preparing an image using
+                    <filename>wic</filename> tool with
+                    <filename>bootimg-partition</filename> source
+                    plugin. By default, the files are installed under
+                    the same name as the source files.
+
                     To change the installed name, separate it from the
-                    original name with a semi-colon (;).
-                    Source files need to be located in
-                    <link linkend='var-DEPLOY_DIR_IMAGE'><filename>DEPLOY_DIR_IMAGE</filename></link>.
+                    original name with a semi-colon (;).  Source files
+                    need to be located in <link
+                    linkend='var-DEPLOY_DIR_IMAGE'><filename>DEPLOY_DIR_IMAGE</filename></link>.
                     Here are two examples:
 
                     <literallayout class="monospaced">
      IMAGE_BOOT_FILES = "u-boot.img uImage;kernel"
      IMAGE_BOOT_FILES = "u-boot.${UBOOT_SUFFIX} ${KERNEL_IMAGETYPE}"
-                    </literallayout></para>
+                    </literallayout>
+
+                    Alternatively source files can be picked up using
+                    a glob pattern. In this case the destination file
+                    will have the same as base name of the source file
+                    path. To install files into a directory within the
+                    target location pass its name after a semi-colon
+                    (;). Here are two examples:
+
+                    <literallayout class="monospaced">
+     IMAGE_BOOT_FILES = "bcm2835-bootfiles/*"
+     IMAGE_BOOT_FILES = "bcm2835-bootfiles/*;boot/"
+                    </literallayout>
+
+                    The first example installs all files from
+                    <filename>${DEPLOY_DIR_IMAGE}/bcm2835-bootfiles</filename>
+                    into the root of the target partition. The second
+                    example installs the same files into a
+                    <filename>boot</filename> directory within the
+                    target partition.
+                </para>
             </glossdef>
         </glossentry>
 
-- 
1.9.3