From: Serge Hallyn <serge@hallyn.com>
Date: Thu, 24 Apr 2025 00:28:48 +0000 (-0500)
Subject: man/useradd.8.xml: fix the CREATE_HOME description
X-Git-Tag: 4.18.0-rc1~107
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=639d2c97e979c7324029f6dd3335423122a52e35;p=thirdparty%2Fshadow.git

man/useradd.8.xml: fix the CREATE_HOME description

Fixes: #1249

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

diff --git a/man/useradd.8.xml b/man/useradd.8.xml
index eda1fefe5..b842c8c3e 100644
--- a/man/useradd.8.xml
+++ b/man/useradd.8.xml
@@ -157,10 +157,13 @@
 	    user's login directory. The default is to append the
 	    <replaceable>LOGIN</replaceable> name to
 	    <replaceable>BASE_DIR</replaceable> and use that as the
-	    login directory name.  If the directory
-	    <replaceable>HOME_DIR</replaceable> does not exist, then
-	    it will be created unless the <option>-M</option> option
-	    is specified.
+	    login directory name.  
+	    The directory <replaceable>HOME_DIR</replaceable> is not created by
+	    default.  However it will be created for non-system users if either the
+	    <option>-m</option> flag is specifed or
+	    <replaceable>CREATE_HOME</replaceable> in
+	    <filename>login.defs</filename> is set to true.  However, it will never
+	    be created if the <option>-M</option> flag is specified.
 	  </para>
 	</listitem>
       </varlistentry>