Merge pull request #563 from jprichardson/copy-preserve-timestamps-false

copy*() preserveTimestamps: false behavior is OS-dependent

docs/copy-sync.md

@@ -8,7 +8,7 @@ Copy a file or directory. The directory can have contents. Like `cp -r`.
   - `overwrite` `<boolean>`: overwrite existing file or directory, default is `true`. _Note that the copy operation will silently fail if you set this to `false` and the destination exists._ Use the `errorOnExist` option to change this behavior.
   - `errorOnExist` `<boolean>`: when `overwrite` is `false` and the destination exists, throw an error. Default is `false`.
   - `dereference` `<boolean>`: dereference symlinks, default is `false`.
-  - `preserveTimestamps` `<boolean>`: will set last modification and access times to the ones of the original source files, default is `false`.
+  - `preserveTimestamps` `<boolean>`: When true, will set last modification and access times to the ones of the original source files. When false, timestamp behavior is OS-dependent. Default is `false`.
   - `filter` `<Function>`: Function to filter copied files. Return `true` to include, `false` to exclude.
 
 ## Example:

docs/copy.md

@@ -8,7 +8,7 @@ Copy a file or directory. The directory can have contents. Like `cp -r`.
   - `overwrite` `<boolean>`: overwrite existing file or directory, default is `true`. _Note that the copy operation will silently fail if you set this to `false` and the destination exists._ Use the `errorOnExist` option to change this behavior.
   - `errorOnExist` `<boolean>`: when `overwrite` is `false` and the destination exists, throw an error. Default is `false`.
   - `dereference` `<boolean>`: dereference symlinks, default is `false`.
-  - `preserveTimestamps` `<boolean>`: will set last modification and access times to the ones of the original source files, default is `false`.
+  - `preserveTimestamps` `<boolean>`: When true, will set last modification and access times to the ones of the original source files. When false, timestamp behavior is OS-dependent. Default is `false`.
   - `filter` `<Function>`: Function to filter copied files. Return `true` to include, `false` to exclude. Can also return a `Promise` that resolves to `true` or `false` (or pass in an `async` function).
 - `callback` `<Function>`
 

lib/copy-sync/__tests__/copy-sync-preserve-time.test.js

@@ -29,16 +29,6 @@ describeIfPractical('copySync() - preserveTimestamps option', () => {
 
   afterEach(done => fs.remove(TEST_DIR, done))
 
-  describe('> when preserveTimestamps option is false', () => {
-    it('should have different timestamps on copy', done => {
-      setTimeout(() => {
-        fs.copySync(SRC, DEST, {preserveTimestamps: false})
-        FILES.forEach(testFile({preserveTimestamps: false}))
-        done()
-      }, 100)
-    })
-  })
-
   describe('> when preserveTimestamps option is true', () => {
     it('should have the same timestamps on copy', () => {
       fs.copySync(SRC, DEST, {preserveTimestamps: true})

lib/copy/__tests__/copy-preserve-time.test.js

@@ -30,17 +30,6 @@ describeIfPractical('copy() - preserve timestamp', () => {
 
   afterEach(done => fs.remove(TEST_DIR, done))
 
-  describe('> when timestamp option is false', () => {
-    it('should have different timestamps on copy', done => {
-      setTimeout(() => {
-        copy(SRC, DEST, {preserveTimestamps: false}, () => {
-          FILES.forEach(testFile({preserveTimestamps: false}))
-          done()
-        })
-      }, 100)
-    })
-  })
-
   describe('> when timestamp option is true', () => {
     it('should have the same timestamps on copy', done => {
       copy(SRC, DEST, {preserveTimestamps: true}, () => {