From 8db8f99eb93682658dad5466eac8890c1cf3d80a Mon Sep 17 00:00:00 2001
From: ignapk <59512193+ignapk@users.noreply.github.com>
Date: Fri, 19 Jun 2020 08:29:59 +0200
Subject: [PATCH] man: add note regarding editing user groups

Currently the manual doesn't clearly say whether `homectl update username -G group` will append the group to the user, or overwrite the list and remove user from the groups that aren't specified.

Fix this by updating the manual, basing the change on the usermod manual.
---
 man/homectl.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/man/homectl.xml b/man/homectl.xml
index 14877a0cde0..3a4c6e5f5b1 100644
--- a/man/homectl.xml
+++ b/man/homectl.xml
@@ -268,7 +268,8 @@
         independently, for example with <citerefentry
         project='man-pages'><refentrytitle>groupadd</refentrytitle><manvolnum>8</manvolnum></citerefentry>. If
         non-existent groups that are listed there are ignored. This option may be used more than once, in
-        which case all specified group lists are combined.</para></listitem>
+        which case all specified group lists are combined. If the user is currently a member of a group
+        which is not listed, the user will be removed from the group.</para></listitem>
       </varlistentry>
 
       <varlistentry>
-- 
2.39.5