2009/dap/file-system file-dir-sys.html,1.20,1.21

Update of /sources/public/2009/dap/file-system
In directory hutz:/tmp/cvs-serv1537

Modified Files:
	file-dir-sys.html 
Log Message:
Specify restrictions on moves onto currently-occupied paths.


Index: file-dir-sys.html
===================================================================
RCS file: /sources/public/2009/dap/file-system/file-dir-sys.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- file-dir-sys.html	28 Sep 2010 22:11:05 -0000	1.20
+++ file-dir-sys.html	28 Sep 2010 22:18:57 -0000	1.21
@@ -548,10 +548,22 @@
           <dt>void moveTo ()</dt>
           <dd>
             <p>
-              Move an entry to a different location on the file system. It is an
-              error to try to move an entry inside itself at any depth if it is
-              a directory, or to move it into its parent if a name different
-              from its current one isn't provided.
+              Move an entry to a different location on the file system.
+              It is an error to try to:
+              <ul>
+                <li>move a directory inside itself or to any child at any
+                depth;</li>
+                <li>move an entry into its parent if a name different from its
+                current one isn't provided;</li>
+                <li>move a file to a path occupied by a directory;</li>
+                <li>move a directory to a path occupied by a file;</li>
+                <li>move any element to a path occupied by a directory which is
+                not empty.</li>
+              </ul>
+              A move of a file on top of an existing file MUST attempt to
+              delete and replace that file.
+              A move of a directory on top of an existing empty directory MUST
+              attempt to delete and replace that directory.
             </p>
             <dl class='parameters'>
               <dt>DirectoryEntry parent</dt>
@@ -1085,10 +1097,22 @@
           <dt>EntrySync moveTo ()</dt>
           <dd>
             <p>
-              Move an entry to a different location on the file system. It is an
-              error to try to move an entry inside itself at any depth if it is
-              a directory, or to move it into its parent if a name different
-              from its current one isn't provided.
+              Move an entry to a different location on the file system.
+              It is an error to try to:
+              <ul>
+                <li>move a directory inside itself or to any child at any
+                depth;</li>
+                <li>move an entry into its parent if a name different from its
+                current one isn't provided;</li>
+                <li>move a file to a path occupied by a directory;</li>
+                <li>move a directory to a path occupied by a file;</li>
+                <li>move any element to a path occupied by a directory which is
+                not empty.</li>
+              </ul>
+              A move of a file on top of an existing file MUST attempt to
+              delete and replace that file.
+              A move of a directory on top of an existing empty directory MUST
+              attempt to delete and replace that directory.
             </p>
             <dl class='parameters'>
               <dt>DirectoryEntrySync parent</dt>

Received on Tuesday, 28 September 2010 22:19:00 UTC