Update webapi docs to reference new PUT behavior.
authorkevan <kevan@isnotajoke.com>
Mon, 20 Jul 2009 03:44:47 +0000 (20:44 -0700)
committerkevan <kevan@isnotajoke.com>
Mon, 20 Jul 2009 03:44:47 +0000 (20:44 -0700)
docs/frontends/webapi.txt

index 1353f233ab5085f47f7dbbc8dc4478ad82863b92..6d196756b697251e19e5eee593a5293ecc413fd9 100644 (file)
@@ -572,7 +572,10 @@ PUT /uri/$DIRCAP/[SUBDIRS../]CHILDNAME?t=uri
   there is already an object at the given location, rather than overwriting the
   existing object. Note that "true", "t", and "1" are all synonyms for "True",
   and "false", "f", and "0" are synonyms for "False". the parameter is
-  case-insensitive.
+  case-insensitive. If you want this behavior only if there is an existing 
+  directory at the same location (that is, you want the operation to return an
+  error if there is a directory at the same name, but to succeed if there is a
+  file), add a "replace=only-files" argument, as "?t=uri&replace=only-files".
 
 === Deleting a File or Directory ===