From 639d2c97e979c7324029f6dd3335423122a52e35 Mon Sep 17 00:00:00 2001
From: Serge Hallyn <serge@hallyn.com>
Date: Wed, 23 Apr 2025 19:28:48 -0500
Subject: [PATCH] man/useradd.8.xml: fix the CREATE_HOME description

Fixes: #1249

Signed-off-by: Serge Hallyn <serge@hallyn.com>
---
 man/useradd.8.xml | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

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>
-- 
2.47.2