@@ -34,6 +34,32 @@ On the other hand, some earlier distributions are no longer supported:
See :ref:`all supported distributions <system-requirements-supported-distros>`.
+.. _ref-migration-6-1-groupmems:
+
+useradd: replace :term:`GROUPMEMS_PARAM` assignments to :term:`USERMOD_PARAMS`
+------------------------------------------------------------------------------
+
+The ``groupmems`` command is removed from the ``shadow`` recipe starting from
+version 4.20. The same functionality provided by ``groupmems`` can be achieved
+with the ``usermod`` command.
+
+Assignments made to the :term:`GROUPMEMS_PARAM` variable can be converted to use
+:term:`USERMOD_PARAMS`, by replacing::
+
+ GROUPMEMS_PARAM:${PN} = "--add user --group group1; \
+ --add user --group group2"
+
+With::
+
+ USERMOD_PARAM:${PN} = "--append --groups group1 user; \
+ --append --groups group2 user"
+
+Or written more simply as::
+
+ USERMOD_PARAM:${PN} = "--append --groups group1,group2 user"
+
+See (:oecore_rev:`b8da733ab12c64503a353d5ceb2eb63fed95d851`) for more details.
+
Removed recipes
---------------
After commit b8da733ab12c ("useradd.bbclass: Add support for USERMOD_PARAM") in OE-Core. Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> --- documentation/migration-guides/migration-6.1.rst | 26 ++++++++++++++++++++++++ 1 file changed, 26 insertions(+)