diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 16f703dc42..e3272fec79 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -3863,9 +3863,12 @@ 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 the + wic tool with the + bootimg-partition 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 @@ -3875,7 +3878,27 @@ IMAGE_BOOT_FILES = "u-boot.img uImage;kernel" IMAGE_BOOT_FILES = "u-boot.${UBOOT_SUFFIX} ${KERNEL_IMAGETYPE}" - + + Alternatively, source files can be picked up using + a glob pattern. + In this case, the destination file + will have the same name as the 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: + + IMAGE_BOOT_FILES = "bcm2835-bootfiles/*" + IMAGE_BOOT_FILES = "bcm2835-bootfiles/*;boot/" + + The first example installs all files from + ${DEPLOY_DIR_IMAGE}/bcm2835-bootfiles + into the root of the target partition. + The second example installs the same files into a + boot directory within the + target partition. +