diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 65f52b43af..0105222010 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -407,6 +407,33 @@
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-FILESYSTEM_PERMS_TABLES'><glossterm>FILESYSTEM_PERMS_TABLES</glossterm>
+            <glossdef>
+                <para>Allows you to define your own file permissions settings table as part of
+                    your configuration for the packaging process.
+                    By default, the Yocto Project uses the <filename>fs-perms.txt</filename>, which
+                    is located in the <filename>meta/files</filename> directory of the Yocto Project
+                    files directory.
+                    While it is recommended that you just allow the build system to use the 
+                    default <filename>fs-perms.txt</filename>, you can create and use 
+                    your own file permissions file and then set
+                    the <filename>FILESYSTEM_PERMS_TABLES</filename> variable to point to that 
+                    file. 
+                </para>
+                <para>
+                    If you create your own file permissions setting table, you should place it in your
+                    layer or the distros layer. 
+                    You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the 
+                    <filename>conf/local.conf</filename> file found in the Yocto Project's 
+                    build directory.
+                </para>
+                <para>
+                    For guidance on how to create your own file permissions settings table file, 
+                    see the <filename>fs-perms.txt</filename>.
+                </para>
+            </glossdef>
+        </glossentry>
+
         <glossentry id='var-FULL_OPTIMIZATION'><glossterm>FULL_OPTIMIZATION</glossterm>
             <glossdef>
                 <para>