Add (document) \keys_set_groups:nnn(n)N

l3kernel/CHANGELOG.md

@@ -9,6 +9,7 @@ this project uses date-based 'snapshot' version identifiers.
 
 ### Added
 - Full set of variants for `\prop_(g)put_if_not_in:Nnn`
+- `keys_set_groups:nnn(n)N` to match `keys_set_exclude_groups:nnn(n)N`
 
 ### Fixed
 - Implementation of deprecated `\pdf_object_write:nn`

l3kernel/l3keys.dtx

@@ -891,18 +891,25 @@
 %   the key names and values are returned.
 % \end{function}
 %
-% \begin{function}[added = 2013-07-14, updated = 2017-05-27]
+% \begin{function}[added = 2013-07-14, updated = 2024-05-08]
 %   {
 %     \keys_set_groups:nnn, \keys_set_groups:nnV,
-%     \keys_set_groups:nnv, \keys_set_groups:nno
+%     \keys_set_groups:nnv, \keys_set_groups:nno,
+%     \keys_set_groups:nnnN, \keys_set_groups:nnVN,
+%     \keys_set_groups:nnvN, \keys_set_groups:nnoN,
+%     \keys_set_groups:nnnnN, \keys_set_groups:nnVnN,
+%     \keys_set_groups:nnvnN, \keys_set_groups:nnonN,
 %   }
 %   \begin{syntax}
 %     \cs{keys_set_groups:nnn} \Arg{module} \Arg{groups} \Arg{keyval list}
 %   \end{syntax}
 %   Activates key filtering in an \enquote{opt-in} sense: only keys assigned to
 %   one or more of the \meta{groups} specified are set. The \meta{groups} are
 %   given as a comma-separated list. Unknown keys are not assigned to any
-%   group and are thus never set.
+%   group and are thus never set.  The key--value pairs for each
+%   key which is filtered out are stored in the \meta{tl} in a
+%   comma-separated form (\emph{i.e.}~an edited version of the \meta{keyval
+%   list}). The \cs{keys_set_groups:nnn} version skips this stage
 % \end{function}
 %
 % \section{Digesting keys}