From bdd26d71b2477e5e0a466982b24f52c08f82ce8d Mon Sep 17 00:00:00 2001
From: Nick Craig-Wood <nick@craig-wood.com>
Date: Mon, 2 May 2016 12:34:15 +0100
Subject: [PATCH] Clarify swift errors - fixes #460

---
 docs/content/swift.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/content/swift.md b/docs/content/swift.md
index 5b588385d..efa7edf10 100644
--- a/docs/content/swift.md
+++ b/docs/content/swift.md
@@ -139,3 +139,19 @@ amongst others) for storing the modification time for an object.
 The Swift API doesn't return a correct MD5SUM for segmented files
 (Dynamic or Static Large Objects) so rclone won't check or use the
 MD5SUM for these.
+
+### Troublshooting ###
+
+#### Rclone gives Failed to create file system for "remote:": Bad Request ####
+
+Due to an oddity of the underlying swift library, it gives a "Bad
+Request" error rather than a more sensible error when the
+authentication fails for Swift.
+
+So this most likely means your username / password is wrong.  You can
+investigate further with the `--dump-bodies` flag.
+
+#### Rclone gives Failed to create file system: Response didn't have storage storage url and auth token ####
+
+This is most likely caused by forgetting to specify your tenant when
+setting up a swift remote.