Skip to content

Commit a212fd4

Browse files
committed
Cygwin: doc: utils.xml: improve newgrp(1) documentation
Especially document -l as primary option and - just for Linux compatibility. Note that a command on the commandline is a Cygwin extension and incompatible with POSIX and Linux. Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
1 parent 8e3e5a7 commit a212fd4

1 file changed

Lines changed: 16 additions & 11 deletions

File tree

winsup/doc/utils.xml

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2108,13 +2108,13 @@ D: on /d type fat (binary,user,noumount)
21082108

21092109
<refnamediv>
21102110
<refname>newgrp</refname>
2111-
<refpurpose>change primary group for a command</refpurpose>
2111+
<refpurpose>change to a new primary group</refpurpose>
21122112
</refnamediv>
21132113

21142114
<refsynopsisdiv>
21152115
<cmdsynopsis>
21162116
<command>newgrp</command>
2117-
<arg choice="opt">-</arg>
2117+
<arg choice="opt">-l</arg>
21182118
<arg choice="opt"><replaceable>group</replaceable></arg>
21192119
<arg><replaceable>command</replaceable>
21202120
<arg rep="repeat"><replaceable>args</replaceable></arg>
@@ -2124,22 +2124,27 @@ D: on /d type fat (binary,user,noumount)
21242124

21252125
<refsect1 id="newgrp-desc">
21262126
<title>Description</title>
2127-
<para><command>newgrp</command> changes the primary group for a
2128-
command.</para>
2127+
<para><command>newgrp</command> starts a new shell environment under
2128+
a new primary group.</para>
21292129

2130-
<para>If the <option>-</option> flag is given as first argument, the
2130+
<para>If the <option>-l</option> flag is given as first argument, the
21312131
user's environment will be reinitialized as though the user had logged
21322132
in, otherwise the current environment, including current working
2133-
directory, remains unchanged.</para>
2133+
directory, remains unchanged. For Linux compatibility, the flag
2134+
<option>-</option> is allowed as well.</para>
21342135

21352136
<para><command>newgrp</command> changes the current primary group to the
21362137
named group, or to the default group listed in /etc/passwd if no group
2137-
name is given.</para>
2138+
name is given. The user's standard shell is started, called as login
2139+
shell if the <option>-l</option> or <option>-</option> flag has been
2140+
specified.</para>
21382141

2139-
<para>By default, the user's standard shell is started, called as login
2140-
shell if the <option>-</option> flag has been specified. If a group
2141-
has been given as argument, a command and its arguments can be
2142-
specified on the command line.</para>
2142+
<para>The group argument can be specified as group name from the
2143+
group database or a non-negative numeric group ID.</para>
2144+
2145+
<para> If a group has been given as argument, a command and its
2146+
arguments can be specified on the command line. Note that this
2147+
usage is Cygwin-only and incompatible with POSIX and Linux.</para>
21432148

21442149
<para>The new primary group must be either the old primary group, or
21452150
it must be part of the supplementary group list. Setting the primary

0 commit comments

Comments
 (0)