@@ -10120,10 +10120,14 @@ class WriteMode(bb.Union):
10120
10120
:ivar files.WriteMode.overwrite: Always overwrite the existing file. The
10121
10121
autorename strategy is the same as it is for ``add``.
10122
10122
:ivar str files.WriteMode.update: Overwrite if the given "rev" matches the
10123
- existing file's "rev". The autorename strategy is to append the string
10124
- "conflicted copy" to the file name. For example, "document.txt" might
10125
- become "document (conflicted copy).txt" or "document (Panda's conflicted
10126
- copy).txt".
10123
+ existing file's "rev". The supplied value should be the latest known
10124
+ "rev" of the file, for example, from :type:`FileMetadata`, from when the
10125
+ file was last downloaded by the app. This will cause the file on the
10126
+ Dropbox servers to be overwritten if the given "rev" matches the
10127
+ existing file's current "rev" on the Dropbox servers. The autorename
10128
+ strategy is to append the string "conflicted copy" to the file name. For
10129
+ example, "document.txt" might become "document (conflicted copy).txt" or
10130
+ "document (Panda's conflicted copy).txt".
10127
10131
"""
10128
10132
10129
10133
_catch_all = None
@@ -10170,9 +10174,14 @@ def is_update(self):
10170
10174
def get_update (self ):
10171
10175
"""
10172
10176
Overwrite if the given "rev" matches the existing file's "rev". The
10173
- autorename strategy is to append the string "conflicted copy" to the
10174
- file name. For example, "document.txt" might become "document
10175
- (conflicted copy).txt" or "document (Panda's conflicted copy).txt".
10177
+ supplied value should be the latest known "rev" of the file, for
10178
+ example, from :class:`FileMetadata`, from when the file was last
10179
+ downloaded by the app. This will cause the file on the Dropbox servers
10180
+ to be overwritten if the given "rev" matches the existing file's current
10181
+ "rev" on the Dropbox servers. The autorename strategy is to append the
10182
+ string "conflicted copy" to the file name. For example, "document.txt"
10183
+ might become "document (conflicted copy).txt" or "document (Panda's
10184
+ conflicted copy).txt".
10176
10185
10177
10186
Only call this if :meth:`is_update` is true.
10178
10187
0 commit comments