Rev 6037: (jelmer) Document behaviour with regards to comma's in location specifiers. in file:///home/pqm/archives/thelove/bzr/%2Btrunk/

[Canonical.com Patch Queue Manager]

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

------------------------------------------------------------
revno: 6037 [merge]
revision-id: pqm at pqm.ubuntu.com-20110722105406-gquzv04c6vshmdqv
parent: pqm at pqm.ubuntu.com-20110721103418-isfx9a31sy79q2tu
parent: jelmer at samba.org-20110721100959-21wbkaynbv3e4l0a
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Fri 2011-07-22 10:54:06 +0000
message:
  (jelmer) Document behaviour with regards to comma's in location specifiers.
   (Jelmer Vernooij)
modified:
  bzrlib/help_topics/en/url-special-chars.txt urlspecialchars.txt-20110630155852-mod387qhw2i2gdzp-1
=== modified file 'bzrlib/help_topics/en/url-special-chars.txt'
--- a/bzrlib/help_topics/en/url-special-chars.txt	2011-07-21 09:31:22 +0000
+++ b/bzrlib/help_topics/en/url-special-chars.txt	2011-07-21 10:09:59 +0000
@@ -39,3 +39,9 @@
 Comma also has special meaning in URLs, because it denotes `segment parameters`_
 
 _`segment parameters`: http://www.ietf.org/rfc/rfc3986.txt (section 3.3)
+
+Comma is also special in any file system paths that are specified. To use a literal
+comma in a file system path, specify a URL and URL encode the comma::
+
+  bzr log foo,branch=bla # path "foo" with the segment parameter "branch" set to "bla"
+  bzr log file:foo%2Cbranch=bla # path "foo,branch=bla"