diff --git a/ChangeLog b/ChangeLog index 25f6d9d5..487ab747 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2008-05-19 Nicolas François + + * NEWS, man/useradd.8.xml: Document the -k, --skel option, and + update the -m, --create-home documentation. + 2008-05-19 Nicolas François * man/useradd.8.xml: Sort options. diff --git a/NEWS b/NEWS index db1ee125..15c3e03a 100644 --- a/NEWS +++ b/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 diff --git a/man/useradd.8.xml b/man/useradd.8.xml index b10b19e3..2da9c304 100644 --- a/man/useradd.8.xml +++ b/man/useradd.8.xml @@ -183,21 +183,23 @@ - , + , + SKEL_DIR - The user's home directory will be created if it does not exist. - The files contained in SKEL_DIR will - be copied to the home directory if the - option is used, otherwise the files contained in - /etc/skel will be used instead. Any - directories contained in SKEL_DIR or - /etc/skel will be created in the user's - home directory as well. The option is only - valid in conjunction with the option. The - default is to not create the directory and to not copy any - files. + The skeleton directory, which contains files and directories + to be copied in the user's home directory, when the home + directory is created by useradd. + + + This option is only valid if the (or + ) option is specified. + + + If this option is not set, the skeleton directory is defined + in /etc/default/useradd or, by default, + /etc/skel. @@ -241,6 +243,22 @@ + + + , + + + + 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) + will be copied to the home directory. + + + By default, no home directories are created. + + + ,