-----Original Message-----
From: yocto@... <yocto@...> On
Behalf Of Peter Kjellerstedt
Sent: den 11 december 2019 18:12
To: yocto@...
Cc: Scott Rifenbark <srifenbark@...>
Subject: [yocto] [PATCH 2/2] ref-manual: Update the documentation for
USERADD_ERROR_DYNAMIC

* Update USERADD_ERROR_DYNAMIC[doc] and the first paragraph to match
the definition in meta/conf/documentation.conf.
* Add a note explaining the differences in behavior when setting
USERADD_ERROR_DYNAMIC to "warn" and "error" respectively.

[YOCTO #12932]

Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@...>
---
documentation/ref-manual/ref-variables.xml | 33 ++++++++++++++++------
1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/documentation/ref-manual/ref-variables.xml
b/documentation/ref-manual/ref-variables.xml
index e6009926be..c8ece0c579 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -16770,18 +16770,21 @@

<glossentry id='var-
USERADD_ERROR_DYNAMIC'><glossterm>USERADD_ERROR_DYNAMIC</glossterm>
<info>
- USERADD_ERROR_DYNAMIC[doc] = "If set to 'error', forces
the OpenEmbedded build system to produce an error if the user
identification (uid) and group identification (gid) values are not defined
in files/passwd and files/group files. If set to 'warn', a warning will be
issued instead."
+ USERADD_ERROR_DYNAMIC[doc] = "If set to 'error', forces
the OpenEmbedded build system to produce an error if the user
identification (uid) and group identification (gid) values are not defined
in any of the files listed in USERADD_UID_TABLES and USERADD_GID_TABLES.
If set to 'warn', a warning will be issued instead."
</info>
<glossdef>
<para role="glossdeffirst">
<!-- <para role="glossdeffirst"><imagedata
fileref="figures/define-generic.png" /> -->
- If set to "error", forces the OpenEmbedded build
system to
- produce an error if the user identification
- (<filename>uid</filename>) and group identification
- (<filename>gid</filename>) values are not defined
- in <filename>files/passwd</filename>
- and <filename>files/group</filename> files.
- If set to "warn", a warning will be issued instead.
+
+ If set to <filename>error</filename>, forces the
+ OpenEmbedded build system to produce an error if the
user
+ identification (<filename>uid</filename>) and group
+ identification (<filename>gid</filename>) values are
not
+ defined in any of the files listed
+ in <link linkend='var-
USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link>
+ and <link linkend='var-
USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>. If
+ set to <filename>warn</filename>, a warning will be
issued
+ instead.
</para>

<para>
@@ -16808,6 +16811,20 @@
<link linkend='var-
USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>
variables.
</para>
+
+ <note>
+ There is a difference in behavior between
+ setting <filename>USERADD_ERROR_DYNAMIC</filename>
+ to <filename>error</filename> and setting it
+ to <filename>warn</filename>. When it is set
+ to <filename>warn</filename>, the build system will
report a
+ warning for every undefined <filename>uid</filename>
and
+ <filename>gid</filename> in any recipe. But when it
is set
+ to <filename>error</filename>, it will only report
errors
+ for recipes that are actually built. This saves you
from
+ having to add static IDs for recipes that you know
will
+ never be built.
+ </note>
</glossdef>
</glossentry>

--
2.21.0