[Pkg-shadow-devel] Bug#154996: useradd: Document that the home_dir is not created by default

[Christian Perrier]

In http://bugs.debian.org/154996, the user complains that nothing
really mentions that "-d" does not create the user's home
directory. He suggest fixing useradd which was done by adding the "-m"
option.

The attached patch, relative to current CVS, makes it clearer that
"-d" alone does not create the home directory.

Tomasz, could you consider applying it to your CVS?

-- 


-------------- next part --------------
--- useradd.8.xml.ori	2005-09-12 18:33:28.000000000 +0200
+++ useradd.8.xml	2005-09-12 18:42:02.000000000 +0200
@@ -85,11 +85,15 @@
 	<listitem>
 	  <para>
 	    The new user will be created using
-	    <replaceable>HOME_DIR</replaceable> as the value for the user's
-	    login directory. The default is to append the
+	    <replaceable>HOME_DIR</replaceable> as the value for the
+	    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.
+	    <replaceable>BASE_DIR</replaceable> and use that as the
+	    login directory name.  The
+	    <replaceable>HOME_DIR</replaceable> directory may be
+	    missing but, in that case, it will not be created unless
+	    the <option>-m</option> or <option>--create-home</option>
+	    option is used.
 	  </para>
 	</listitem>
       </varlistentry>