Updated docs
authorChristos Stathis <chstath@ebs.gr>
Wed, 18 Apr 2012 09:40:49 +0000 (12:40 +0300)
committerChristos Stathis <chstath@ebs.gr>
Wed, 18 Apr 2012 09:40:49 +0000 (12:40 +0300)
docs/source/webclient.rst

index b98fc45..b4e89ed 100644 (file)
@@ -221,6 +221,13 @@ PUT /v1/username/container/path/to/new/foldername
 
 to create a folder with the new name, followed by recursive copy operations (see below about copy/move/paste) to move all folder 's children under the new one. Finally, a folder deletion is done as described earlier.
 
+File Cut/Copy/Paste
+"""""""""""""""""""
+Cut/Copy operations on folders just put the objects in an internal clipboard. The Paste command does the actual job of copying/moving.
+
+Folder copy is done by creating a folder at the new location with a PUT and then recursively copy all subfolders and files.
+Folder move is done the same way followed by a deletion of the initial folder. It is obvious that a copy/move of a big subtree will result in a great number of API requests.
+
 File Operations
 ^^^^^^^^^^^^^^^
 File uploading
@@ -241,6 +248,13 @@ is done by DeleteFileDialog class with a simple
 
 DELETE /v1/username/container/path/to/file
 
+File Cut/Copy/Paste
+"""""""""""""""""""
+Cut/Copy operations on files just put the objects in an internal clipboard. The Paste command does the actual job of copying/moving.
+
+In case of copy, a sequence (if multiple files are copied) of PUT commands is issued to the new path, with X-Copy-From header
+In case of cut, the same PUT commands have X-Move-From header set.
+
 File/Folder sharing
 ^^^^^^^^^^^^^^^^^^^
 Sharing of file and folders with other users is done by setting permissions for other users or groups of users. The FolderPermissionsDialog/FilePermissionsDialog classes display the corresponding UI and perform the API calls. Permissions are set with