diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 9af4250e27..cf08dbe0a7 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2166,12 +2166,12 @@
                 <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.
+                    class, this variable identifies packages containing font
+                    files that need to be cached by Fontconfig.
                     By default, the <filename>fontcache</filename> class assumes
-                    that fonts appear in the main package
+                    that fonts are in the recipe's 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
+                    Use this variable if fonts you need are in a package
                     other than that main package.
                 </para>
             </glossdef>