- From: Eric Uhrhane via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 16 Apr 2012 19:30:35 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/file-system
In directory hutz:/tmp/cvs-serv10024
Modified Files:
file-dir-sys.html
Log Message:
Clarify rules for EntrySync.copyTo.
Index: file-dir-sys.html
===================================================================
RCS file: /sources/public/2009/dap/file-system/file-dir-sys.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -d -r1.43 -r1.44
--- file-dir-sys.html 7 Mar 2012 22:54:58 -0000 1.43
+++ file-dir-sys.html 16 Apr 2012 19:30:33 -0000 1.44
@@ -1142,10 +1142,24 @@
newName)</dt>
<dd>
<p>
- Copy an entry to a different location on the file system. It is an
- error to try to copy an entry inside itself at any depth if it is
- a directory, or to copy it into its parent if a name different
- from its current one isn't provided.
+ Copy an entry to a different location on the file system.
+ It is an error to try to:
+ <ul>
+ <li>copy a directory inside itself or to any child at any
+ depth;</li>
+ <li>copy an entry into its parent if a name different from its
+ current one isn't provided;</li>
+ <li>copy a file to a path occupied by a directory;</li>
+ <li>copy a directory to a path occupied by a file;</li>
+ <li>copy any element to a path occupied by a directory which is
+ not empty.</li>
+ </ul>
+ A copy of a file on top of an existing file MUST attempt to
+ delete and replace that file.<br>
+ A copy of a directory on top of an existing empty directory MUST
+ attempt to delete and replace that directory.<br>
+ Directory copies are always recursive--that is, they copy all
+ contents of the directory.
</p>
<dl class='parameters'>
<dt>DirectoryEntrySync parent</dt>
@@ -1380,9 +1394,9 @@
<td><dfn>InvalidModificationError</dfn></td>
<td>
The modification requested was illegal. Examples of invalid
- modifications include moving a directory into its own child or
+ modifications include moving a directory into its own child,
moving a file into its parent directory without changing its
- name.
+ name, or copying a directory to a path occupied by a file.
</td>
</tr>
<tr>
Received on Monday, 16 April 2012 19:30:38 UTC