-"aliases", in a file named ~/.tahoe/private/aliases . These are short strings
-that stand for a directory read- or write- cap. The default starting point
-uses an alias named "tahoe:", and for backwards compatibility can be stored
-in a file named ~/.tahoe/private/root_dir.cap .
-
-The Tahoe CLI commands use the same filename syntax as scp and rsync, an
+"aliases", in a file named ~/.tahoe/private/aliases . These aliases are short
+strings that stand in for a directory read- or write- cap. The default
+starting point uses an alias named "tahoe:".
+
+For backwards compatibility with Tahoe-1.0, if the "tahoe": alias is not
+found in ~/.tahoe/private/aliases, the CLI will use the contents of
+~/.tahoe/private/root_dir.cap instead. Tahoe-1.0 had only a single starting
+point, and stored it in this root_dir.cap file, so Tahoe-1.1 will use it if
+necessary. However, once you've set a "tahoe:" alias with "tahoe set-alias",
+that will override anything in the old root_dir.cap file.
+
+The Tahoe CLI commands use the same filename syntax as scp and rsync: an