Note that the "unlink"ing directories is attempted when running as a

superuser, and that some operating systems may not support it.

p4raw-id: //depot/perl@26571

2 files changed, 9 insertions, 8 deletions

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index e33b0306af..abc8355da7 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -6606,10 +6606,11 @@ deleted.
     unlink @goners;
     unlink <*.bak>;
 
-Note: C<unlink> will not delete directories unless you are superuser and
-the B<-U> flag is supplied to Perl.  Even if these conditions are
+Note: C<unlink> will not attempt to delete directories unless you are superuser
+and the B<-U> flag is supplied to Perl.  Even if these conditions are
 met, be warned that unlinking a directory can inflict damage on your
-filesystem.  Use C<rmdir> instead.
+filesystem.  Finally, using C<unlink> on directories is not supported on 
+many operating systems.  Use C<rmdir> instead.
 
 If LIST is omitted, uses C<$_>.
 
diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index d49707479b..6eb6bbf035 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -883,11 +883,11 @@ for details.
 X<-U>
 
 allows Perl to do unsafe operations.  Currently the only "unsafe"
-operations are the unlinking of directories while running as superuser,
-and running setuid programs with fatal taint checks turned into
-warnings.  Note that the B<-w> switch (or the C<$^W> variable) must
-be used along with this option to actually I<generate> the
-taint-check warnings.
+operations are attempting to unlink directories while running as 
+superuser, and running setuid programs with fatal taint checks turned
+into warnings.  Note that the B<-w> switch (or the C<$^W> variable) 
+must be used along with this option to actually I<generate> the
+taint-check warnings.  
 
 =item B<-v>
 X<-v>