From: Serge Hallyn <serge@hallyn.com>
Date: Thu, 2 Feb 2023 18:27:23 +0000 (-0600)
Subject: Improve TTYGROUP description in login.defs manpage
X-Git-Tag: 4.14.0-rc1~197
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1058872a0b630e543e7e4d4d4340104e1f3e7edc;p=thirdparty%2Fshadow.git

Improve TTYGROUP description in login.defs manpage

Closes #457

The existing prose was confusing, or simply wrong.  Make it clear
that only the group ownership of the tty is affected, and how.
Also move the paragraph about defaults after the discussion of
acceptable TTYGROUPs, as this seems more natural.

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

diff --git a/man/login.defs.d/TTYGROUP.xml b/man/login.defs.d/TTYGROUP.xml
index e7cb53d0a..8e0a9e87c 100644
--- a/man/login.defs.d/TTYGROUP.xml
+++ b/man/login.defs.d/TTYGROUP.xml
@@ -13,15 +13,16 @@
       <option>TTYGROUP</option> group, and the permissions will be set to
       <option>TTYPERM</option>.
     </para>
-    <para>
-      By default, the ownership of the terminal is set to the user's
-      primary group and the permissions are set to
-      <replaceable>0600</replaceable>.
-    </para>
     <para>
       <option>TTYGROUP</option> can be either the name of a group or a
       numeric group identifier.
     </para>
+    <para>
+      If TTYGROUP is not defined, then the group ownership of the terminal is
+      set to the user's primary group.  If TTYPERM is not defined, then the
+      permissions are set to
+      <replaceable>0600</replaceable>.
+    </para>
     <para>
       If you have a <command>write</command> program which is "setgid" to
       a special group which owns the terminals, define TTYGROUP to the