ref-manual: Added useradd-staticids class and edits to some variables.

Added the new useradd-staticids class to the reference section
for classes.

Updated the USERADD_UID_TABLES and USERADD_GID_TABLES variables
to tell how the system uses BBPATH in the default mode to
get UID and GID information from the files/passwd and files/group
files.

Added a note indicating that you can delete the TMPDIR directory
to fix things up if you configure useradd-staticids in a
configured system.

(From yocto-docs rev: a3f5ee3f5060369405d59a238fb02bddfeae5d6f)

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

1 files changed, 17 insertions, 5 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index d553ba8f71..6eae958e58 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7853,8 +7853,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                 </para>
 
                 <para>
-                    The default behavior for the build system is to dynamically
-                    apply <filename>gid</filename> values.
+                    The default behavior for the build system is to look in
+                    <link linkend='var-BBPATH'><filename>BBPATH</filename></link>
+                    for a <filename>files/group</filename> file and then dynamically
+                    apply <filename>uid</filename> values.
                     However, you can override this behavior by using the
                     <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>
                     variable.
@@ -7885,8 +7887,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                 </para>
 
                 <para>
-                    The default behavior for the build system is to dynamically
-                    apply <filename>uid</filename> values.
+                    The default behavior for the build system is to look in
+                    <link linkend='var-BBPATH'><filename>BBPATH</filename></link>
+                    for the <filename>files/passwd</filename> file and
+                    then dynamically apply <filename>uid</filename> values.
                     However, you can override this behavior by using the
                     <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>
                     variable.
@@ -7965,7 +7969,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
-        <glossentry id='var-USERADDEXTENSION'><glossterm>USERADDEXTENTION</glossterm>
+        <glossentry id='var-USERADDEXTENSION'><glossterm>USERADDEXTENSION</glossterm>
             <glossdef>
                 <para>
                     When set to "useradd-staticids", causes the
@@ -7980,6 +7984,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     <literallayout class='monospaced'>
      USERADDEXTENSION = "useradd-staticids"
                     </literallayout>
+                    <note>
+                        Setting this variable to use static
+                        <filename>uid</filename> and <filename>gid</filename>
+                        values causes the OpenEmbedded build system to employ
+                        the
+                        <link linkend='ref-classes-useradd-staticids'><filename>useradd-staticids</filename></link>
+                        class.
+                    </note>
                 </para>
 
                 <para>