From: Michael Albinus <michael.albinus@gmx.de>
Date: Mon, 5 Oct 2009 08:11:56 +0000 (+0000)
Subject: * files.texi (Create/Delete Dirs): New command copy-directory.
X-Git-Tag: emacs-pretest-23.1.90~927
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=461bf92b6e447a343c38fe28fd048cd54e6e8256;p=emacs.git

* files.texi (Create/Delete Dirs): New command copy-directory.
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 81d3290702a..66e30109d41 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -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):
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