Improve groups and id manpages

Signed-off-by: Serge Hallyn <serge@hallyn.com>

diff --git a/man/groups.1.xml b/man/groups.1.xml
index 2b5b1ff24144ec64e219ff72c142670407ee5337..dcbedbafd8f150252e39e7ddf48e0cb343db612f 100644 (file)
--- 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 624a3f4a9669ae1513cd89af617f3cca7a058023..9d77330fb234f8e435cde7b33019fc41e0334e61 100644 (file)
--- 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>