[Pkg-shadow-devel] Bug#1006225: Bug#1006225: edited groups.1.xml and id.1.xml and diff files

[Serge E. Hallyn]

Thank you, applied.

On Wed, Feb 23, 2022 at 10:02:12AM +0100, Markus Hiereth wrote:
> 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


> --- ../../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>


> --- ../../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>

> _______________________________________________
> Pkg-shadow-devel mailing list
> Pkg-shadow-devel at alioth-lists.debian.net
> https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/pkg-shadow-devel