diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index cca03a1b03..71e0fb588f 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -105,7 +105,7 @@
                 <para>A larger value for the <filename>BBFILE_PRIORITY</filename> variable results in a higher
                     precedence. 
                     For example, the value 6 has a higher precedence than the value 5. 
-                    By default, the <filename>BBFILE_PRIORITY</filename> variable is set to the value 5.</para>
+                    By default, the <filename>BBFILE_PRIORITY</filename> variable is set to "5".</para>
             </glossdef>
         </glossentry>
 
@@ -380,7 +380,7 @@
 
         <glossentry id='var-FILES'><glossterm>FILES</glossterm>
             <glossdef>
-                <para>list of directories or files that are placed in packages.</para>
+                <para>The list of directories or files that are placed in packages.</para>
             </glossdef>
         </glossentry>
 
@@ -392,7 +392,7 @@
                     and <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename>
                     when compiling an optimised system.
                     This variable defaults to 
-                    <filename>-fexpensive-optimizations -fomit-frame-pointer -frename-registers -O2</filename>.
+                    "-fexpensive-optimizations -fomit-frame-pointer -frename-registers -O2".
                 </para>
             </glossdef>
         </glossentry>
@@ -486,7 +486,7 @@
                     to the other <filename>INITSCRIPT_*</filename> as an override.</para>
                  <para>
                     This variable is used in recipes when using <filename>update-rc.d.bbclass</filename>.
-                    The variable is optional and defaults to <filename>PN</filename>.
+                    The variable is optional and defaults to the <filename>PN</filename> variable.
                 </para>
            </glossdef>
         </glossentry>
@@ -603,7 +603,7 @@
             </glossdef>
          </glossentry>
 
-         <glossentry id='var-MACHINE_EXTRA_RRECOMMENDS'><glossterm>MACHINE_EXTRA_RRECOMMNEDS</glossterm>
+         <glossentry id='var-MACHINE_EXTRA_RRECOMMENDS'><glossterm>MACHINE_EXTRA_RRECOMMENDS</glossterm>
             <glossdef>
                 <para>Specifies the list of packages useful to use the device (e.g.
                     additional kernel modules)</para>
@@ -649,7 +649,7 @@
             <glossdef>
                 <para>The long form description of the binary package for packaging sytems such as 
                     <filename>ipkg</filename>, <filename>rpm</filename> or <filename>debian</filename>.
-                    This variable inherits <filename>DESCRIPTION</filename> by default.</para>
+                    By default, this variable inherits <filename>DESCRIPTION</filename>.</para>
             </glossdef>
         </glossentry>
 
@@ -674,7 +674,7 @@
         <glossentry id='var-PACKAGES'><glossterm>PACKAGES</glossterm>
             <glossdef>
                 <para>The list of packages to be created from the recipe.
-                    The default value is <filename>${PN}-dbg ${PN} ${PN}-doc ${PN}-dev</filename>.</para>
+                    The default value is "${PN}-dbg ${PN} ${PN}-doc ${PN}-dev".</para>
             </glossdef>
         </glossentry>
 
@@ -1029,7 +1029,7 @@
                     This command is used by BitBake to lauch a terminal window with a 
                     shell. 
                     The shell is unspecified so the user's default shell is used. 
-                    By default, the variable is set to <filename>gnome-terminal</filename> but it can 
+                    By default, the variable is set to "gnome-terminal" but it can 
                     be any X11 terminal application or terminal multiplexers-like screen.
                 </para>
             </glossdef>