Commit e4b3f22f authored by Chong Yidong's avatar Chong Yidong
Browse files

* files.texi (Changing Files): Document updated argument list for

	copy-file.
parent 9c2d888b
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> 2006-05-27 Thien-Thi Nguyen <ttn@gnu.org>
* processes.texi (Bindat Functions): Explain term "total length". * processes.texi (Bindat Functions): Explain term "total length".
......
...@@ -1431,7 +1431,7 @@ with @code{add-name-to-file} and then deleting @var{filename} has the ...@@ -1431,7 +1431,7 @@ with @code{add-name-to-file} and then deleting @var{filename} has the
same effect as renaming, aside from momentary intermediate states. same effect as renaming, aside from momentary intermediate states.
@end deffn @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 This command copies the file @var{oldname} to @var{newname}. An
error is signaled if @var{oldname} does not exist. If @var{newname} error is signaled if @var{oldname} does not exist. If @var{newname}
names a directory, it copies @var{oldname} into that directory, names a directory, it copies @var{oldname} into that directory,
...@@ -1440,16 +1440,18 @@ preserving its final name component. ...@@ -1440,16 +1440,18 @@ preserving its final name component.
If @var{time} is non-@code{nil}, then this function gives the new file 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 the same last-modified time that the old one has. (This works on only
some operating systems.) If setting the time gets an error, 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. This function copies the file modes, too.
In an interactive call, a prefix argument specifies a non-@code{nil} If argument @var{preserve-uid-gid} is @code{nil}, we let the operating
value for @var{time}. 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
The argument @var{mustbenew} controls whether an existing file can be non-@code{nil}, we attempt to copy the user and group ownership of the
overwritten. It works like the similarly-named argument of file. This works only on some operating systems, and only if you have
@code{write-region} (@pxref{Writing to Files, mustbenew}). the correct permissions to do so.
@end deffn @end deffn
@deffn Command make-symbolic-link filename newname &optional ok-if-exists @deffn Command make-symbolic-link filename newname &optional ok-if-exists
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment