diff --git a/dropbox/files.py b/dropbox/files.py index aade9a54..d33deb7a 100644 --- a/dropbox/files.py +++ b/dropbox/files.py @@ -10120,10 +10120,14 @@ class WriteMode(bb.Union): :ivar files.WriteMode.overwrite: Always overwrite the existing file. The autorename strategy is the same as it is for ``add``. :ivar str files.WriteMode.update: Overwrite if the given "rev" matches the - existing file's "rev". The autorename strategy is to append the string - "conflicted copy" to the file name. For example, "document.txt" might - become "document (conflicted copy).txt" or "document (Panda's conflicted - copy).txt". + existing file's "rev". The supplied value should be the latest known + "rev" of the file, for example, from :type:`FileMetadata`, from when the + file was last downloaded by the app. This will cause the file on the + Dropbox servers to be overwritten if the given "rev" matches the + existing file's current "rev" on the Dropbox servers. The autorename + strategy is to append the string "conflicted copy" to the file name. For + example, "document.txt" might become "document (conflicted copy).txt" or + "document (Panda's conflicted copy).txt". """ _catch_all = None @@ -10170,9 +10174,14 @@ def is_update(self): def get_update(self): """ Overwrite if the given "rev" matches the existing file's "rev". The - autorename strategy is to append the string "conflicted copy" to the - file name. For example, "document.txt" might become "document - (conflicted copy).txt" or "document (Panda's conflicted copy).txt". + supplied value should be the latest known "rev" of the file, for + example, from :class:`FileMetadata`, from when the file was last + downloaded by the app. This will cause the file on the Dropbox servers + to be overwritten if the given "rev" matches the existing file's current + "rev" on the Dropbox servers. The autorename strategy is to append the + string "conflicted copy" to the file name. For example, "document.txt" + might become "document (conflicted copy).txt" or "document (Panda's + conflicted copy).txt". Only call this if :meth:`is_update` is true. diff --git a/spec b/spec index 837cc878..d439f00c 160000 --- a/spec +++ b/spec @@ -1 +1 @@ -Subproject commit 837cc8789d6a620442a1b404a3cf8446979b7203 +Subproject commit d439f00c77d82184d4d14c783166f372c8f03dd1