Hi Serge, On Mon, 21 Feb 2022 10:30:17 -0600 serge wrote:
attached groups.1.xml and id.1.xml and patches that replace the previously sent on 21 Feb 2022 17:01:53 +0100. > Changing 'support' to 'allow' is not good. And I do think that > simply referencing initgroups as I did is better than saying "by > using...". Although I don't believe there's any system out there > which does not support initgroups. this point made me change the respective paragraph. In groups.1.xml in the paragraph above, xml-markup <emphasis> was replaced by <replaceable> and one removed as not necessary. In the SEE ALSO section initgroups(3) was added. I hope the two manual pages are done now. Best regards Markus
groups.1.xml
Description: XML document
--- ../../shadow-4.8.1/man/groups.1.xml 2019-07-23 17:26:08.000000000 +0200
+++ groups.1.xml 2022-02-23 09:39:44.060606763 +0100
@@ -80,16 +80,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.
@@ -122,6 +123,9 @@
</citerefentry>,
<citerefentry>
<refentrytitle>getuid</refentrytitle><manvolnum>2</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>initgroups</refentrytitle><manvolnum>3</manvolnum>
</citerefentry>.
</para>
</refsect1>
id.1.xml
Description: XML document
--- ../../shadow-4.8.1/man/id.1.xml 2019-07-23 17:26:08.000000000 +0200
+++ id.1.xml 2022-02-23 09:41:18.640389999 +0100
@@ -79,8 +79,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>
@@ -113,6 +114,9 @@
</citerefentry>,
<citerefentry>
<refentrytitle>getuid</refentrytitle><manvolnum>2</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>initgroups</refentrytitle><manvolnum>3</manvolnum>
</citerefentry>
</para>
</refsect1>
