develooper Front page | perl.perl5.porters | Postings from November 2013

[perl #120619] Clarification for File::Copy documentation

rrt @ sc3d . org
November 23, 2013 22:11
[perl #120619] Clarification for File::Copy documentation
Message ID:
# New Ticket Created by 
# Please include the string:  [perl #120619]
# in the subject line of all future correspondence about this issue. 
# <URL: >

File::Copy's documentation says about syscopy: "For Unix systems, this is
equivalent to the simple "copy" routine, which doesn't preserve OS-specific

Does this mean that syscopy is like copy, and not like cp, where, according
to the same documentation, "as of version 2.15, <cp> will preserve the
source file's permission bits like the shell utility cp(1) would do"? That
would not seem very logical.

Also, the phrase "doesn't preserve OS-specific attributes" is confusing
when talking about a particular OS: when reading the page, I wondered if it
referred to file-system-specific attributes on UNIX. Maybe it's better just
to leave it out.

Assuming that sanity prevails under the hood, and syscopy is equivalent to
cp, I suggest rewriting this as:

"For Unix systems, this is equivalent to the simple "cp" routine."

If for some reason syscopy on Unix works the same as "copy", then instead:

"For Unix systems, this is equivalent to the simple "copy" routine, and
doesn't preserve attributes."

(Checked against latest version at

-- Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About