Document the -k, --skel option, and update the -m, --create-home documentation.

ChangeLog

@@ -1,3 +1,8 @@
+2008-05-19  Nicolas François  <nicolas.francois@centraliens.net>
+
+	* NEWS, man/useradd.8.xml: Document the -k, --skel option, and
+	update the -m, --create-home documentation.
+
 2008-05-19  Nicolas François  <nicolas.francois@centraliens.net>
 
 	* man/useradd.8.xml: Sort options.

NEWS

@@ -27,6 +27,7 @@ shadow-4.1.1 -> shadow-4.1.2						UNRELEASED
   manpages.
 - Document the -c, --crypt-method and -s, --sha-rounds options in the
   newusers manpage.
+- Document the -k, --skel option in the useradd manpage.
 
 shadow-4.1.0 -> shadow-4.1.1						02-04-2008
 

man/useradd.8.xml

@@ -183,21 +183,23 @@
       </varlistentry>
       <varlistentry>
 	<term>
-	  <option>-m</option>, <option>--create-home</option>
+	  <option>-k</option>, <option>--skel</option>
+	  <replaceable>SKEL_DIR</replaceable>
 	</term>
 	<listitem>
 	  <para>
-	    The user's home directory will be created if it does not exist. 
+	    The skeleton directory, which contains files and directories
-	    The files contained in <replaceable>SKEL_DIR</replaceable> will
+	    to be copied in the user's home directory, when the home
-	    be copied to the home directory if the <option>-k</option>
+	    directory is created by <command>useradd</command>.
-	    option is used, otherwise the files contained in
+	  </para>
-	    <filename>/etc/skel</filename> will be used instead. Any
+	  <para>
-	    directories contained in <replaceable>SKEL_DIR</replaceable> or
+	    This option is only valid if the <option>-m</option> (or
-	    <filename>/etc/skel</filename> will be created in the user's
+	    <option>--create-home</option>) option is specified.
-	    home directory as well. The <option>-k</option> option is only
+	  </para>
-	    valid in conjunction with the <option>-m</option> option. The
+	  <para>
-	    default is to not create the directory and to not copy any
+	    If this option is not set, the skeleton directory is defined
-	    files.
+	    in <filename>/etc/default/useradd</filename> or, by default,
+	    <filename>/etc/skel</filename>.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -241,6 +243,22 @@
 	  </para>
 	</listitem>
       </varlistentry>
+      <varlistentry>
+	<term>
+	  <option>-m</option>, <option>--create-home</option>
+	</term>
+	<listitem>
+	  <para>
+	    Create the user's home directory if it does not exist. 
+	    The files and directories contained in the skeleton directory
+	    (which can be defined with the <option>-k</option> option)
+	    will be copied to the home directory.
+	  </para>
+	  <para>
+	    By default, no home directories are created.
+	  </para>
+	</listitem>
+      </varlistentry>
       <varlistentry>
 	<term>
 	  <option>-N</option>, <option>--no-user-group</option>