ref-manual: Added fontcache class and FONT_PACKAGES variable.

(From yocto-docs rev: 6e091001cabeca1d7427e6c74058b0c5b9204938)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2013-11-27 10:12:50 -08:00 committed by Richard Purdie
parent 6032dcdb32
commit 48cef6ad6b
2 changed files with 38 additions and 0 deletions

View File

@ -573,6 +573,29 @@
</para>
</section>
<section id='ref-classes-fontcache'>
<title><filename>fontcache.bbclass</filename></title>
<para>
The font cache (<filename>fontcache</filename>) class generates the
proper post-installation and post-remove (postinst and postrm)
scriptlets for font packages.
These scriptlets call <filename>fc-cache</filename> (part of
<filename>Fontconfig</filename>) to add the fonts to the font
information cache.
Since the cache files are architecture-specific,
<filename>fc-cache</filename> runs using QEMU if the postinst
scriptlets need to be run on the build host during image creation.
</para>
<para>
If the fonts being installed are in packages other than the main
package, set
<link linkend='var-FONT_PACKAGES'><filename>FONT_PACKAGES</filename></link>
to include the packages containing the fonts.
</para>
</section>
<section id='ref-classes-debian'>
<title>Debian Renaming - <filename>debian.bbclass</filename></title>

View File

@ -2065,6 +2065,21 @@
</glossdef>
</glossentry>
<glossentry id='var-FONT_PACKAGES'><glossterm>FONT_PACKAGES</glossterm>
<glossdef>
<para>
When a recipe inherits the
<link linkend='ref-classes-fontcache'><filename>fontcache</filename></link>
class, this variable identifies packages that contain fonts
the OpenEmbedded build system installs.
By default, installed fonts appear in the main package
(i.e. <filename>${</filename><link linkend='var-PN'><filename>PN</filename></link><filename>}</filename>).
Use this variable if fonts you need appear in a package
other than that main package.
</para>
</glossdef>
</glossentry>
<glossentry id='var-FULL_OPTIMIZATION'><glossterm>FULL_OPTIMIZATION</glossterm>
<glossdef>
<para>