summaryrefslogtreecommitdiffstats
path: root/tools/acp/README
diff options
context:
space:
mode:
Diffstat (limited to 'tools/acp/README')
-rw-r--r--tools/acp/README40
1 files changed, 0 insertions, 40 deletions
diff --git a/tools/acp/README b/tools/acp/README
deleted file mode 100644
index a1809d9..0000000
--- a/tools/acp/README
+++ /dev/null
@@ -1,40 +0,0 @@
-README for Android "acp" Command
-
-The "cp" command was judged and found wanting. The issues are:
-
-Mac OS X:
- - Uses the BSD cp, not the fancy GNU cp. It lacks the "-u" flag, which
- only copies files if they are newer than the destination. This can
- slow the build when copying lots of content.
- - Doesn't take the "-d" flag, which causes symlinks to be copied as
- links. This is the default behavior, so it's not all bad, but it
- complains if you supply "-d".
-
-MinGW/Cygwin:
- - Gets really weird when copying a file called "foo.exe", failing with
- "cp: skipping file 'foo.exe', as it was replaced while being copied".
- This only seems to happen when the source file is on an NFS/Samba
- volume. "cp" works okay copying from local disk.
-
-Linux:
- - On some systems it's possible to have microsecond-accurate timestamps
- on an NFS volume, and non-microsecond timestamps on a local volume.
- If you copy from NFS to local disk, your NFS files will always be
- newer, because the local disk time stamp is truncated rather than
- rounded up. This foils the "-u" flag if you also supply the "-p" flag
- to preserve timestamps.
- - The Darwin linker insists that ranlib be current. If you copy the
- library, the time stamp no longer matches. Preserving the time
- stamp is essential, so simply turning the "-p" flag off doesn't work.
-
-Futzing around these in make with GNU make functions is awkward at best.
-It's easier and more reliable to write a cp command that works properly.
-
-
-The "acp" command takes most of the standard flags, following the GNU
-conventions. It adds a "-e" flag, used when copying executables around.
-On most systems it is ignored, but on MinGW/Cygwin it allows "cp foo bar"
-to work when what is actually meant is "cp foo.exe bar.exe". Unlike the
-default Cygwin cp, "acp foo bar" will not find foo.exe unless you add
-the "-e" flag, avoiding potential ambiguity.
-