ref-manual: Updated the IMAGE_BOOT_FILES varaible.

Added a final paragraph that provides some cross-referencing to
the sections that describe how to use Wic and to the Wic
reference chapter.

Also, shortened the DOC info line.

(From yocto-docs rev: 4ba5d0119caa3696187537f5b4cc9c64ca00e205)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2018-03-26 11:20:09 -07:00
committed by Richard Purdie
parent 2bb3bcf49c
commit dbf6a1f778

View File

@@ -5720,18 +5720,17 @@
<glossentry id='var-IMAGE_BOOT_FILES'><glossterm>IMAGE_BOOT_FILES</glossterm>
<info>
IMAGE_BOOT_FILES[doc] = "A space-separated list of files from ${DEPLOY_DIR_IMAGE} to place in boot partition. Entries will be installed under a same name as the source file. To change the destination file name, pass a desired name after a semicolon (eg. u-boot.img;uboot)."
IMAGE_BOOT_FILES[doc] = "A space-separated list of files from ${DEPLOY_DIR_IMAGE} to place in boot partition."
</info>
<glossdef>
<para role="glossdeffirst">
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
A space-separated list of files installed into the
boot partition when preparing an image using the
<filename>wic</filename> tool with the
<filename>bootimg-partition</filename> source
boot partition when preparing an image using the Wic tool
with the <filename>bootimg-partition</filename> source
plugin.
By default, the files are installed under
the same name as the source files.
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
@@ -5747,9 +5746,8 @@
<para>
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.
In this case, the destination file must 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
(;).
@@ -5765,6 +5763,15 @@
<filename>boot</filename> directory within the
target partition.
</para>
<para>
You can find information on how to use the Wic tool in the
"<ulink url='&YOCTO_DOCS_DEV_URL;#creating-partitioned-images-using-wic'>Creating Partitioned Images Using Wic</ulink>"
section of the Yocto Project Development Tasks Manual.
Reference material for Wic is located in the
"<ulink url='&YOCTO_DOCS_REF_URL;#ref-kickstart'>OpenEmbedded Kickstart (.wks) Reference</ulink>"
chapter in the Yocto Project Reference Manual.
</para>
</glossdef>
</glossentry>