man: usermod clarification

man/usermod.8.xml: specify what happens when the current home directory
doesn't exist if using -d and -m options. Moreover, specify what happens
when the group ownership is changed and the uid's don't match in -u and
-g options.

diff --git a/man/usermod.8.xml b/man/usermod.8.xml
index a1d0efd8d4b72003642b211392535e06deeb2d9b..79305896c93971037c7a31b3e2e8daa41a4552e8 100644 (file)
--- a/man/usermod.8.xml
+++ b/man/usermod.8.xml
@@ -143,7 +143,8 @@
            If the <option>-m</option>
            option is given, the contents of the current home directory will
            be moved to the new home directory, which is created if it does
-           not already exist.
+           not already exist. If the current home directory does not exist
+           the new home directory will not be created.
          </para>
        </listitem>
       </varlistentry>
@@ -205,6 +206,12 @@
            The group ownership of files outside of the user's home directory
            must be fixed manually.
          </para>
+         <para>
+           The change of the group ownership of files inside of the user's
+           home directory is also not done if the home dir owner uid is
+           different from the current or new user id. This is a safety measure
+           for special home directories such as <filename>/</filename>.
+         </para>
        </listitem>
       </varlistentry>
       <varlistentry>
@@ -267,7 +274,8 @@
        <listitem>
          <para>
            Move the content of the user's home directory to the new
-           location.
+           location. If the current home directory does not exist
+           the new home directory will not be created.
          </para>
          <para>
            This option is only valid in combination with the
@@ -380,6 +388,12 @@
            The ownership of files outside of the user's home directory
            must be fixed manually.
          </para>
+         <para>
+           The change of the user ownership of files inside of the user's
+           home directory is also not done if the home dir owner uid is
+           different from the current or new user id. This is a safety measure
+           for special home directories such as <filename>/</filename>.
+         </para>
          <para>
            No checks will be performed with regard to the
            <option>UID_MIN</option>, <option>UID_MAX</option>,