documentation/poky-ref-manual/ref-variables.xml: edits to FILESYSTEM_PERMS_TABLES.

Some minor re-wordings to give some context on how to use these special
files and the variable to point to them.

(From yocto-docs rev: 4482b42f4a224bada7a0fa5fe4821a753ba55d80)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 14 insertions, 10 deletions

diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index dbc343c8fb..625cd3eb4b 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -411,25 +411,29 @@
             <glossdef>
                 <para>Allows you to define your own file permissions settings table as part of
                     your configuration for the packaging process.
+                    For example, suppose you need a consistent set of custom permissions for 
+                    a set of groups and users across an entire work project.
+                    It is best to do this in the packages themselves but this is not always 
+                    possible.
+                </para>
+                <para>
                     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. 
+                </para>
+                <para>
                     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.
+                    <filename>conf/local.conf</filename> file, which is found in the Yocto Project's 
+                    build directory, to point to your custom <filename>fs-perms.txt</filename>.
+                    You can specify more than a single file permissions setting table.
+                    The paths you specify to these files must be defined within the 
+                    <filename>BBPATH</filename> variable.  
                 </para>
                 <para>
                     For guidance on how to create your own file permissions settings table file, 
-                    see the <filename>fs-perms.txt</filename>.
+                    examine the existing <filename>fs-perms.txt</filename>.
                 </para>
             </glossdef>
         </glossentry>