Rev 5104: (mbp) better user documentation of urls in file:///home/pqm/archives/thelove/bzr/%2Btrunk/

[Canonical.com Patch Queue Manager]

At file:///home/pqm/archives/thelove/bzr/%2Btrunk/

------------------------------------------------------------
revno: 5104 [merge]
revision-id: pqm at pqm.ubuntu.com-20100322022224-uie280enmzfd9xzs
parent: pqm at pqm.ubuntu.com-20100322015121-7um8d7zqa960emyz
parent: mbp at canonical.com-20100322002950-ek55t84syxhpwhfi
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Mon 2010-03-22 02:22:24 +0000
message:
  (mbp) better user documentation of urls
modified:
  doc/en/user-guide/branching_a_project.txt branching_a_project.-20071122141511-0knao2lklsdsvb1q-2
=== modified file 'doc/en/user-guide/branching_a_project.txt'
--- a/doc/en/user-guide/branching_a_project.txt	2009-12-02 20:34:07 +0000
+++ b/doc/en/user-guide/branching_a_project.txt	2010-03-22 00:29:50 +0000
@@ -30,6 +30,17 @@
 `URL Identifiers <../user-reference/bzr_man.html#url-identifiers>`_
 section of the Bazaar User Reference.
 
+URLs are normally resolved relative to the root directory of the server,
+so ``ftp://example.com/repo/foo`` means the ``/repo/foo`` directory of
+that host.  (We say 'normally' because some server software like Apache
+can be configured to remap URLs arbitrarily, in which case you'll need to
+look at the server configuration to find out which URL corresponds to
+which directory.)
+
+To address a path relative to your home directory on the server, use a
+tilde like so: ``sftp://example.com/~/public_html`` should map to
+``public_html`` within your home directory.
+
 A reminder about shared repositories
 ------------------------------------