* files.texi (Create/Delete Dirs): New command copy-directory.
authorMichael Albinus <michael.albinus@gmx.de>
Mon, 5 Oct 2009 08:11:56 +0000 (08:11 +0000)
committerMichael Albinus <michael.albinus@gmx.de>
Mon, 5 Oct 2009 08:11:56 +0000 (08:11 +0000)
doc/lispref/ChangeLog
doc/lispref/files.texi

index 81d3290..66e3010 100644 (file)
@@ -1,3 +1,7 @@
+2009-10-05  Michael Albinus  <michael.albinus@gmx.de>
+
+       * files.texi (Create/Delete Dirs): New command copy-directory.
+
 2009-10-04  Juanma Barranquero  <lekktu@gmail.com>
 
        * anti.texi (Antinews):
index 81f342a..1da1b5c 100644 (file)
@@ -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