diff --git a/advanced/folder-ignoredelete.rst b/advanced/folder-ignoredelete.rst new file mode 100644 index 000000000..6bb806668 --- /dev/null +++ b/advanced/folder-ignoredelete.rst @@ -0,0 +1,28 @@ +ignoreDelete +============ + +``ignoreDelete`` is an advanced folder setting that affects the handling of +incoming index updates. When set, incoming updates with the delete flag set +are ignored. + +Example Scenario +---------------- + +Assume two devices, "Alice" and "Bob", sharing a folder. Bob has set +``ignoreDelete``. + +New and updated files are synchronized as usual between Alice and Bob. When +Bob deletes a file, it is deleted for Alice as well. When Alice deletes a +file, Bob ignores that update and does not delete the file. + +In this state, Bob is fully up to date from his own point of view, as is Alice +from her own point of view. However from the point of view of Bob, who ignored +the delete entry from Alice, Alice is now out of date because she is missing +the file that was deleted. + +Should Bob modify any of the files that Alice has deleted, the update will be +sent to Alice and Alice will download the now updated file. + +.. note:: + Ignoring deletes in both directions between two devices can be a + confusing configuration. diff --git a/users/advanced.rst b/users/advanced.rst new file mode 100644 index 000000000..446eeb8c7 --- /dev/null +++ b/users/advanced.rst @@ -0,0 +1,25 @@ +.. _advanced: + +Advanced Configuration +====================== + +Description +----------- + +Syncthing has settings that are available but not exposed in the usual folder +and device configuration screens. The reason for not exposing these settings +more prominently varies from them simply being rarely useful, to them being +actively dangerous when used improperly. + +.. warning:: + Use care when changing advanced configuration settings and make sure that + you understand the resulting effects and consequences. + +Per Folder Settings +------------------- + +.. toctree:: + :maxdepth: 1 + :glob: + + ../advanced/folder-*