Description: improve description of u1 urls (for #697426)
Author: Alexander Zangerl <az@debian.org>
--- a/bin/duplicity.1
+++ b/bin/duplicity.1
@@ -1071,9 +1071,9 @@ tahoe://alias/directory
 .PP
 .BI "Ubuntu One"
 .br
-u1://host_is_ignored/volume_path
+u1://host_is_ignored/volume_name/sub_path
 .br
-u1+http://volume_path
+u1+http://volume_name/sub_path
 .br
 See also
 .BI "A NOTE ON UBUNTU ONE"
@@ -1628,7 +1628,26 @@ for symmetric encryption and the passphr
 
 .SH A NOTE ON UBUNTU ONE
 
-To use Ubuntu One you must have an Ubuntu One OAuth access token. Such
+The Ubuntu One backend in duplicity treats URLs specially:
+You can either use
+.BI u1://
+or
+.BI u1+http://
+in the URL schema. With the u1 URL schema you have to give a dummy
+hostname (which will be ignored), followed by your Ubuntu One volume
+name and path. If you use the u1+http schema, then
+you'll have to give only the volume name and path in the URL.
+
+For example, for a volume named
+.BR backups
+containing the folder
+.BR weekly ","
+correct URLs would be
+.BI u1://ignoreme/backups/weekly/
+or
+.BI u1+http://backups/weekly/
+
+To use Ubuntu One you must also have an Ubuntu One OAuth access token. Such
 OAuth tokens have a practically unlimited lifetime; you can have multiple
 active tokens and you can revoke tokens using the Ubuntu One web interface.
 .PP
