diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 3601c97ded..1c9b3798e7 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -7,7 +7,7 @@
 <title>Reference: Variables Glossary</title>
 
 <para>
-    This section lists common variables used in Poky and gives an overview
+    This section lists common variables used in the Yocto Project and gives an overview
     of their function and contents.
 </para>
 
@@ -15,9 +15,9 @@
 
 
     <para>
-       <link linkend='var-glossary-a'>A</link> 
-       <link linkend='var-glossary-b'>B</link> 
-       <link linkend='var-glossary-c'>C</link> 
+       <link linkend='var-AUTHOR'>A</link> 
+       <link linkend='var-BB_NUMBER_THREADS'>B</link> 
+       <link linkend='var-CFLAGS'>C</link> 
        <link linkend='var-glossary-d'>D</link> 
        <link linkend='var-glossary-e'>E</link> 
        <link linkend='var-glossary-f'>F</link> 
@@ -47,15 +47,15 @@
 
          <glossentry id='var-AUTHOR'><glossterm>AUTHOR</glossterm>
             <glossdef>
-                <para>E-mail address to contact original author(s) - to
-                send patches, forward bugs...</para>
+                <para>The email address used to contact the original author or authors in 
+                    order to send patches, forward bugs, etc.</para>
             </glossdef>
          </glossentry>
 
         <glossentry id='var-AUTOREV'><glossterm>AUTOREV</glossterm>
             <glossdef>
-                <para>Use current (newest) source revision - used with
-                    <glossterm><link linkend='var-SRCREV'>SRCREV</link></glossterm>
+                <para>Specifies to use the current (newest) source revision.
+                    This variable is with the <filename><link linkend='var-SRCREV'>SRCREV</link></filename>
                     variable.</para>
             </glossdef>
         </glossentry>