docs and comments

shelljs · Jan 26, 2022 · 3c57b61 · 3c57b61
1 parent df4cdaf
commit 3c57b61
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -206,6 +206,7 @@ Available options:
 + `-r`, `-R`: recursive
 + `-L`: follow symlinks
 + `-P`: don't follow symlinks
++ `-p`: preserve file mode, ownership, and timestamps
 
 Examples:
 

diff --git a/src/cp.js b/src/cp.js
@@ -76,6 +76,8 @@ function copyFileSync(srcFile, destFile, options) {
 
     if (options.preserve) {
       fs.fchownSync(fdw, srcStat.uid, srcStat.gid);
+      // Note: utimesSync does not work (rounds to seconds), but futimesSync has
+      // millisecond precision.
       fs.futimesSync(fdw, srcStat.atime, srcStat.mtime);
     }
 
@@ -201,6 +203,7 @@ function cpcheckcycle(sourceDir, srcFile) {
 //@ + `-r`, `-R`: recursive
 //@ + `-L`: follow symlinks
 //@ + `-P`: don't follow symlinks
+//@ + `-p`: preserve file mode, ownership, and timestamps
 //@
 //@ Examples:
 //@