Mercurial > emacs
changeset 71003:7733ed75db62
* files.texi (Changing Files): Document updated argument list for
copy-file.
| author | Chong Yidong <cyd@stupidchicken.com> |
|---|---|
| date | Sat, 27 May 2006 14:35:49 +0000 |
| parents | 280984b0f4da |
| children | aca1b9717822 |
| files | lispref/ChangeLog lispref/files.texi |
| diffstat | 2 files changed, 15 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/lispref/ChangeLog Sat May 27 14:20:03 2006 +0000 +++ b/lispref/ChangeLog Sat May 27 14:35:49 2006 +0000 @@ -1,3 +1,8 @@ +2006-05-27 Chong Yidong <cyd@stupidchicken.com> + + * files.texi (Changing Files): Document updated argument list for + copy-file. + 2006-05-27 Thien-Thi Nguyen <ttn@gnu.org> * processes.texi (Bindat Functions): Explain term "total length".
--- a/lispref/files.texi Sat May 27 14:20:03 2006 +0000 +++ b/lispref/files.texi Sat May 27 14:35:49 2006 +0000 @@ -1431,7 +1431,7 @@ same effect as renaming, aside from momentary intermediate states. @end deffn -@deffn Command copy-file oldname newname &optional ok-if-exists time mustbenew +@deffn Command copy-file oldname newname &optional ok-if-exists time preserve-uid-gid This command copies the file @var{oldname} to @var{newname}. An error is signaled if @var{oldname} does not exist. If @var{newname} names a directory, it copies @var{oldname} into that directory, @@ -1440,16 +1440,18 @@ If @var{time} is non-@code{nil}, then this function gives the new file the same last-modified time that the old one has. (This works on only some operating systems.) If setting the time gets an error, -@code{copy-file} signals a @code{file-date-error} error. +@code{copy-file} signals a @code{file-date-error} error. In an +interactive call, a prefix argument specifies a non-@code{nil} value +for @var{time}. This function copies the file modes, too. -In an interactive call, a prefix argument specifies a non-@code{nil} -value for @var{time}. - -The argument @var{mustbenew} controls whether an existing file can be -overwritten. It works like the similarly-named argument of -@code{write-region} (@pxref{Writing to Files, mustbenew}). +If argument @var{preserve-uid-gid} is @code{nil}, we let the operating +system decide the user and group ownership of the new file (this is +usually set to the user running Emacs). If @var{preserve-uid-gid} is +non-@code{nil}, we attempt to copy the user and group ownership of the +file. This works only on some operating systems, and only if you have +the correct permissions to do so. @end deffn @deffn Command make-symbolic-link filename newname &optional ok-if-exists