Add explanation of how to replace local sync folder to FAQ
authorMatthew Setter <matthew@matthewsetter.com>
Tue, 7 Mar 2017 14:35:37 +0000 (15:35 +0100)
committerMarkus Goetz <markus@woboq.com>
Thu, 11 May 2017 10:07:33 +0000 (12:07 +0200)
This fixes owncloud/documentation/issues/2923.

(cherry picked from commit 6580af65c1cd02ed632522f7ed128dfda3200be7)

doc/faq.rst
doc/images/setup/ownCloud-remove_existing_connection.png [new file with mode: 0644]
doc/images/setup/ownCloud-remove_existing_connection_confirmation_dialog.png [new file with mode: 0644]
doc/images/setup/ownCloud-replacement_connection_wizard.png [new file with mode: 0755]

index dba2efdf2b1b2a698f928cbd174c4e1130ece87b..edbd1ff31055409e6d2324dfd2fe65d1c5b13b70 100644 (file)
@@ -18,3 +18,32 @@ The sync client has been intentionally limited to sync no deeper than
 fifty sub-directories, to help prevent memory problems. 
 Unfortunately, it, *currently*, does not report an error when this occurs. 
 However, a UI notification is planned for a future release of ownCloud.
+
+I want to move my local sync folder
+-----------------------------------
+
+The ownCloud desktop client does not provide a way to change the local sync directory. 
+However, it can be done, though it is a bit unorthodox. 
+Specifically, you have to:
+
+1. Remove the existing connection which syncs to the wrong directory
+2. Add a new connection which syncs to the desired directory
+
+image:: images/setup/ownCloud-remove_existing_connection.png
+
+To do so, in the client UI, which you can see above, click the "**Account**" drop-down menu and then click "Remove". 
+This will display a "**Confirm Account Removal**" dialog window.
+
+image:: images/setup/ownCloud-remove_existing_connection_confirmation_dialog.png
+
+If you're sure, click "**Remove connection**".
+
+Then, click the Account drop-down menu again, and this time click "**Add new**".
+
+image:: images/setup/ownCloud-replacement_connection_wizard.png
+
+This opens the ownCloud Connection Wizard, which you can see above, *but* with an extra option.
+This option provides the ability to either: keep the existing data (synced by the previous connection) or to start a clean sync (erasing the existing data).
+
+Make your choice and click "**Connect...**".
+This will then step you through the Connection Wizard, just as you did when you setup the previous sync connection, but giving you the opportunity to choose a new sync directory.
diff --git a/doc/images/setup/ownCloud-remove_existing_connection.png b/doc/images/setup/ownCloud-remove_existing_connection.png
new file mode 100644 (file)
index 0000000..eef14f8
Binary files /dev/null and b/doc/images/setup/ownCloud-remove_existing_connection.png differ
diff --git a/doc/images/setup/ownCloud-remove_existing_connection_confirmation_dialog.png b/doc/images/setup/ownCloud-remove_existing_connection_confirmation_dialog.png
new file mode 100644 (file)
index 0000000..c320d66
Binary files /dev/null and b/doc/images/setup/ownCloud-remove_existing_connection_confirmation_dialog.png differ
diff --git a/doc/images/setup/ownCloud-replacement_connection_wizard.png b/doc/images/setup/ownCloud-replacement_connection_wizard.png
new file mode 100755 (executable)
index 0000000..19b3096
Binary files /dev/null and b/doc/images/setup/ownCloud-replacement_connection_wizard.png differ