This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Added note about directories not being created with File::Copy::copy
authorNathan Glenn <garfieldnate@gmail.com>
Sat, 31 Aug 2013 00:40:53 +0000 (17:40 -0700)
committerTony Cook <tony@develop-help.com>
Wed, 18 Sep 2013 06:44:02 +0000 (16:44 +1000)
lib/File/Copy.pm

index b64f609..eb821ed 100644 (file)
@@ -461,8 +461,10 @@ argument may be a string, a FileHandle reference or a FileHandle
 glob. Obviously, if the first argument is a filehandle of some
 sort, it will be read from, and if it is a file I<name> it will
 be opened for reading. Likewise, the second argument will be
 glob. Obviously, if the first argument is a filehandle of some
 sort, it will be read from, and if it is a file I<name> it will
 be opened for reading. Likewise, the second argument will be
-written to (and created if need be).  Trying to copy a file on top
-of itself is an error.
+written to. If the second argument does not exist but the parent
+directory does exist, then it will be created. Trying to copy
+a file into a non-existent directory is an error.
+Trying to copy a file on top of itself is also an error.
 
 If the destination (second argument) already exists and is a directory,
 and the source (first argument) is not a filehandle, then the source
 
 If the destination (second argument) already exists and is a directory,
 and the source (first argument) is not a filehandle, then the source