Index: shadow-4.5/man/newusers.8.xml
===================================================================
--- shadow-4.5.orig/man/newusers.8.xml
+++ shadow-4.5/man/newusers.8.xml
@@ -218,7 +218,15 @@
 	  <para>
 	    If this field does not specify an existing directory, the
 	    specified directory is created, with ownership set to the
-	    user being created or updated and its primary group.
+	    user being created or updated and its primary group. Note 
+            that newusers does not create parent directories of the new 
+            user's home directory. The newusers command will fail to 
+            create the home directory if the parent directories do not 
+            exist, and will send a message to stderr informing the user 
+            of the failure. The newusers command will not halt or return 
+            a failure to the calling shell if it fails to create the home 
+            directory, it will continue to process the batch of new users 
+            specified.
 	  </para>
 	  <para>
 	    If the home directory of an existing user is changed,