public inbox for cygwin-cvs@sourceware.org
help / color / mirror / Atom feed
From: Corinna Vinschen <corinna@sourceware.org>
To: cygwin-cvs@sourceware.org
Subject: [newlib-cygwin/main] Cygwin: newgrp: improve doumentation
Date: Sat, 14 Jan 2023 19:16:24 +0000 (GMT)	[thread overview]
Message-ID: <20230114191624.F37553858D1E@sourceware.org> (raw)

https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=34b361c903c6409a41c9404590885d4d4b7c6a06

commit 34b361c903c6409a41c9404590885d4d4b7c6a06
Author:     Corinna Vinschen <corinna@vinschen.de>
AuthorDate: Sat Jan 14 20:13:54 2023 +0100
Commit:     Corinna Vinschen <corinna@vinschen.de>
CommitDate: Sat Jan 14 20:13:54 2023 +0100

    Cygwin: newgrp: improve doumentation
    
    Signed-off-by: Corinna Vinschen <corinna@vinschen.de>

Diff:
---
 winsup/doc/utils.xml | 28 +++++++++++++++++-----------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/winsup/doc/utils.xml b/winsup/doc/utils.xml
index 927dc7c6b85e..71c220d3006d 100644
--- a/winsup/doc/utils.xml
+++ b/winsup/doc/utils.xml
@@ -1967,26 +1967,32 @@ D: on /d type fat (binary,user,noumount)
       <para><command>newgrp</command> changes the primary group for a
         command.</para>
 
-      <para>If the '-' flag is given as first argument, the user's environment
-        will be reinitialized as though the user had logged in, otherwise the
-	current environment, including current working directory, remains
-	unchanged.</para>
+      <para>If the <option>-</option> flag is given as first argument, the
+	user's environment will be reinitialized as though the user had logged
+	in, otherwise the current environment, including current working
+	directory, remains unchanged.</para>
 
       <para><command>newgrp</command> changes the current primary group to the
         named group, or to the default group listed in /etc/passwd if no group
 	name is given.</para>
 
       <para>By default, the user's standard shell is started, called as login
-        shell if the '-' flag has been specified.  If a group has been given
-	as argument, a command and its arguments can be specified on the
-	command line.</para>
+        shell if the <option>-</option> flag has been specified.  If a group
+	has been given as argument, a command and its arguments can be
+	specified on the command line.</para>
 
       <para>Please note that setting the primary group to any arbitrary group
-        is no privileged operation on Windows.  However, if this group is not
-	in your current user token, or if the group is in your user token but
-	marked as <literal>deny-only</literal>, no additional permissions can
-	be obtained by setting this group as primary group.</para>
+        is no privileged operation on Windows.  However, even if this group is
+	not in your current user token, or if the group is in your user token
+	but marked as <literal>deny-only</literal>, no additional permissions
+	can be obtained by setting this group as primary group.</para>
     </refsect1>
+
+    <refsect1 id="newgrp-seealso">
+      <title>See also</title>
+      <para><command>id</command>(1), <command>login</command>(1).</para>
+    </refsect1>
+
   </refentry>
 
   <refentry id="passwd">

                 reply	other threads:[~2023-01-14 19:16 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20230114191624.F37553858D1E@sourceware.org \
    --to=corinna@sourceware.org \
    --cc=cygwin-cvs@sourceware.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).