From 10b2e1e7c578590fbe448374968740c60dde12dc Mon Sep 17 00:00:00 2001
From: Markus Hiereth <post@hiereth.de>
Date: Sun, 6 Mar 2022 17:59:41 -0600
Subject: [PATCH] Improve groups and id manpages

Signed-off-by: Serge Hallyn <serge@hallyn.com>
---
 man/groups.1.xml | 12 ++++++++----
 man/id.1.xml     |  8 ++++++--
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/man/groups.1.xml b/man/groups.1.xml
index 2b5b1ff2..dcbedbaf 100644
--- a/man/groups.1.xml
+++ b/man/groups.1.xml
@@ -56,16 +56,17 @@
       The <command>groups</command> command displays the current group names
       or ID values. If the value does not have a corresponding entry in
       <filename>/etc/group</filename>, the value will be displayed as the
-      numerical group value. The optional <emphasis
-      remap='I'>user</emphasis> parameter will display the groups for the
-      named <emphasis remap='I'>user</emphasis>.
+      numerical group value. The optional <replaceable>user</replaceable>
+      parameter will display the groups for the named user.
     </para>
   </refsect1>
 
   <refsect1 id='note'>
     <title>NOTE</title>
     <para>
-      Systems which do not support concurrent group sets will have the
+      Systems which do not support supplementary groups (see <citerefentry>
+	<refentrytitle>initgroups</refentrytitle><manvolnum>3</manvolnum>
+      </citerefentry>) will have the
       information from <filename>/etc/group</filename> reported. The user
       must use <command>newgrp</command> or <command>sg</command> to change
       his current real and effective group ID.
@@ -98,6 +99,9 @@
       </citerefentry>,
       <citerefentry>
 	<refentrytitle>getuid</refentrytitle><manvolnum>2</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+	<refentrytitle>initgroups</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>.
     </para>
   </refsect1>
diff --git a/man/id.1.xml b/man/id.1.xml
index 624a3f4a..9d77330f 100644
--- a/man/id.1.xml
+++ b/man/id.1.xml
@@ -55,8 +55,9 @@
       have a corresponding entry in <filename>/etc/passwd</filename> or
       <filename>/etc/group</filename>, the value will be displayed without
       the corresponding name. The optional <option>-a</option> flag will
-      display the group set on systems which support multiple concurrent
-      group membership.
+      display the group set on systems which support supplementary groups
+      (see <citerefentry><refentrytitle>initgroups</refentrytitle>
+      <manvolnum>3</manvolnum></citerefentry>).
     </para>
   </refsect1>
 
@@ -89,6 +90,9 @@
       </citerefentry>,
       <citerefentry>
 	<refentrytitle>getuid</refentrytitle><manvolnum>2</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+	<refentrytitle>initgroups</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>
     </para>
   </refsect1>