]> git.rkrishnan.org Git - tahoe-lafs/tahoe-lafs.git/commitdiff
Add section for "Conflict/overwrite decision algorithm" and label substeps so that...
authorDaira Hopwood <daira@jacaranda.org>
Wed, 4 Nov 2015 13:56:49 +0000 (13:56 +0000)
committermeejah <meejah@meejah.ca>
Wed, 20 Jan 2016 08:33:19 +0000 (01:33 -0700)
Signed-off-by: Daira Hopwood <daira@jacaranda.org>
docs/proposed/magic-folder/remote-to-local-sync.rst

index 99d2d81ca9a827e8b002821dc2336bb66e92c8f8..b41de7bfedaa7b70c785110e510eeda473ca4b53 100644 (file)
@@ -768,6 +768,9 @@ metadata. This will have the effect of making other clients treat
 this change as a conflict whenever they already have a copy of the
 file.
 
+Conflict/overwrite decision algorithm
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Now we are ready to describe the algorithm for determining whether a
 download for the file ``foo`` is an overwrite or a conflict (refining
 step 2 of the procedure from the `Earth Dragons`_ section).
@@ -792,11 +795,11 @@ may be absent). Then the algorithm is:
 
 * 2c. If any of the following are true, then classify as a conflict:
 
-  * there are pending notifications of changes to ``foo``;
-  * the last-uploaded statinfo is either absent (i.e. there is no
-    entry in the database for this path), or different from the
+  * i. there are pending notifications of changes to ``foo``;
+  * ii. the last-uploaded statinfo is either absent (i.e. there is
+    no entry in the database for this path), or different from the
     current statinfo;
-  * either ``last_downloaded_uri`` or ``last_uploaded_uri``
+  * iii. either ``last_downloaded_uri`` or ``last_uploaded_uri``
     (or both) are absent, or they are different.
 
   Otherwise, classify as an overwrite.