diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index ec1f6cbd28..69bb3d43dd 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -445,13 +445,10 @@
         <glossentry id='var-DESCRIPTION'><glossterm>DESCRIPTION</glossterm>
             <glossdef>
                 <para>The package description used by package managers.
-                      By default, <filename>DESCRIPTION</filename> is
-                      defined by the 
+                      If not set, <filename>DESCRIPTION</filename> takes 
+                      the value of the 
                       <link linkend='var-SUMMARY'><filename>SUMMARY</filename></link>
-                      variable:
-                      <literallayout class='monospaced'>
-     DESCRIPTION ?= "${SUMMARY}"
-                      </literallayout>
+                      variable.
                 </para>
             </glossdef>
         </glossentry>
@@ -2445,7 +2442,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     <filename>dpkg</filename>.
                     By default, <filename>SUMMARY</filename> is used to define
                     the <link linkend='var-DESCRIPTION'><filename>DESCRIPTION</filename></link>
-                    variable.
+                    variable if <filename>DESCRIPTION</filename> is not set 
+                    in the recipe.
                 </para>
             </glossdef>
         </glossentry>