diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 625cd3eb4b..2127455ed1 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -860,11 +860,9 @@
 
         <glossentry id='var-POKYMODE'><glossterm>POKYMODE</glossterm>
             <glossdef>
-                <para>The toolchain selector. 
-                    This variable has been replaced by <filename>TCMODE</filename>.
-                    The <filename>POKYMODE</filename> would select the external toolchain
-                    built from the Yocto Project or a few supported combinations of
-                    upstream GCC or CodeSourcery Labs toolchain.</para>
+                <para>This variable is no longer supported and has been replaced by the
+                    <link linkend='var-TCMODE'><filename>TCMODE</filename></link> variable.
+                </para>
             </glossdef>
         </glossentry>
 
@@ -1127,15 +1125,25 @@
 
         <glossentry id='var-TCMODE'><glossterm>TCMODE</glossterm>
             <glossdef>
-                <para>The toolchain selector. 
-                    This variable replaces <filename>POKYMODE</filename>.
+                <para>
+                    The toolchain selector. 
+                    This variable replaces <filename>POKYMODE</filename>, which is no longer
+                    supported.
+                </para>
+                <para>
+                    The <filename>TCMODE</filename> variable selects the external toolchain
+                    built from the Yocto Project or a few supported combinations of
+                    the upstream GCC or CodeSourcery Labs toolchain.
                     The variable determines which of the files in 
                     <filename>meta/conf/distro/include/tcmode-*</filename> is used. 
+                </para>
+                <para>
                     By default, <filename>TCMODE</filename> is set to "default", which 
-                    chooses <filename>tcmode-default.inc</filename>.</para>
-                <para>The variable is similar to <filename>TCLIBC</filename>, which controls the 
-                    <filename>libc</filename> used: <filename>eglibc</filename> or <filename>uclibc</filename>.
-                    </para>
+                    chooses <filename>tcmode-default.inc</filename>.
+                    The variable is similar to <filename>TCLIBC</filename>, which controls 
+                    the variant of the GNU standard C library (<filename>libc</filename>)
+                    used during the build process: <filename>eglibc</filename> or <filename>uclibc</filename>.
+                </para>
             </glossdef>
         </glossentry>