summaryrefslogtreecommitdiff
path: root/doc/lispref/files.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lispref/files.texi')
-rw-r--r--doc/lispref/files.texi20
1 files changed, 19 insertions, 1 deletions
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 81f342aee97..1da1b5c3369 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -2482,8 +2482,9 @@ which generate the listing with Lisp code.
@end defvar
@node Create/Delete Dirs
-@section Creating and Deleting Directories
+@section Creating, Copying and Deleting Directories
@cindex creating and deleting directories
+@cindex copying directories
@c Emacs 19 features
Most Emacs Lisp file-manipulation functions get errors when used on
@@ -2501,6 +2502,23 @@ if they don't already exist.
@code{mkdir} is an alias for this.
@end deffn
+@deffn Command copy-directory dirname newname &optional keep-time parents
+This command copies the directory named @var{dirname} to
+@var{newname}. If @var{newname} names an existing directory,
+@var{dirname} will be copied to a subdirectory there.
+
+It always sets the file modes of the copied files to match the
+corresponding original file.
+
+The third arg @var{keep-time} non-@code{nil} means to preserve the
+modification time of the copied files. A prefix arg makes
+@var{keep-time} non-@code{nil}.
+
+Noninteractively, the last argument @var{parents} says whether to
+create parent directories if they don't exist. Interactively,
+this happens by default.
+@end deffn
+
@deffn Command delete-directory dirname &optional recursive
This command deletes the directory named @var{dirname}. The function
@code{delete-file} does not work for files that are directories; you