diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 8d5a386184..4846d3c834 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -5453,6 +5453,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-PACKAGE_ARCHS'><glossterm>PACKAGE_ARCHS</glossterm>
+            <glossdef>
+                <para>
+                    Specifies a list of architectures compatible with
+                    the target machine.
+                    Separate the entries using spaces and list them in order
+                    of priority.
+                    This variable is set automatically and should not
+                    normally be hand-edited.
+                    The default value for
+                    <filename>PACKAGE_ARCHS</filename> is "all any noarch
+                    ${PACKAGE_EXTRA_ARCHS} ${MACHINE_ARCH}"
+                </para>
+            </glossdef>
+        </glossentry>
+
+
+
         <glossentry id='var-PACKAGE_BEFORE_PN'><glossterm>PACKAGE_BEFORE_PN</glossterm>
             <glossdef>
                 <para>Enables easily adding packages to