diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 9caa51f587..4d0e3f3434 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -1555,8 +1555,15 @@ recipes-graphics/xorg-font/xorg-font-common.inc:INC_PR = "r2"
                     will be "expat".</para>
                 <para> 
                     The variable refers to a package name in the context of a file created or produced by the
-                    OpenEmbedded build system.
-                    </para>
+                    OpenEmbedded build system.</para>
+                <para>If applicable, the <filename>PN</filename> variable also contains any special 
+                    suffix or prefix.
+                    For example, using <filename>bash</filename> to build packages for the native
+                    machine, <filename>PN</filename> is <filename>bash-native</filename>.
+                    Using <filename>bash</filename> to build packages for the target and for Multilib,
+                    <filename>PN</filename> would be <filename>bash</filename> and  
+                    <filename>lib64-bash</filename>, respectively.
+                </para>
             </glossdef>
         </glossentry>
 
@@ -1853,7 +1860,7 @@ recipes-graphics/xorg-font/xorg-font-common.inc:INC_PR = "r2"
                             recipe file resides:
                             <itemizedlist>
                                 <listitem><para><emphasis><filename>${PN}</filename> -</emphasis> The recipe name 
-                                    with any special suffix or prefix.
+                                    with any special suffix or prefix, if applicable.
                                     For example, using <filename>bash</filename> to build for the native
                                     machine, <filename>PN</filename> is <filename>bash-native</filename>.
                                     Using <filename>bash</filename> to build for the target and for Multilib,