X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FFile%2FPath.pm;h=5cb9d44bc0e2603092d49d78985afff805522eb2;hb=fa76202e3aa22e9755f1a461416769c368b47afc;hp=ffc077fa6a608f92018bcdf9db2d772a2c443951;hpb=070ed4611e2512e7f027c985566ea59b2621cd8f;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/lib/File/Path.pm b/lib/File/Path.pm
index ffc077f..5cb9d44 100644
--- a/lib/File/Path.pm
+++ b/lib/File/Path.pm
@@ -41,8 +41,8 @@ It returns a list of all directories (including intermediates, determined
 using the Unix '/' separator) created.
 
 If a system error prevents a directory from being created, then the
-C<mkpath> function throws a fatal error with Perl's C<croak> mechanism.
-This error can be trapped with an C<eval> block:
+C<mkpath> function throws a fatal error with C<Carp::croak>. This error
+can be trapped with an C<eval> block:
 
   eval { mkpath($dir) };
   if ($@) {
@@ -90,9 +90,21 @@ were not deleted may be left with permissions reset to allow world
 read and write access.  Note also that the occurrence of errors in
 rmtree can be determined I<only> by trapping diagnostic messages
 using C<$SIG{__WARN__}>; it is not apparent from the return value.
-Therefore, you must be extremely careful about using C<rmtree($foo,$bar,0>
+Therefore, you must be extremely careful about using C<rmtree($foo,$bar,0)>
 in situations where security is an issue.
 
+=head1 DIAGNOSTICS
+
+=over 4
+
+=item *
+
+On Windows, if C<mkpath> gives you the warning: B<No such file or
+directory>, this may mean that you've exceeded your filesystem's
+maximum path length.
+
+=back
+
 =head1 AUTHORS
 
 Tim Bunce <F<Tim.Bunce@ig.co.uk>> and