← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/branching_a_project.txt

merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/branching_a_project.txt
20
20
  \sftp://            Access using SFTP (most SSH servers provide SFTP).
21
21
  \bzr://             Fast access using the Bazaar smart server.
22
22
  \ftp://             Access using passive FTP.
23
 
  \http://            Read-only access to branches exported by a web server.
 
23
  \http://            Access to branches exported by a web server.
 
24
  \https://           Encrypted access to branches exported by a web server.
24
25
  ===========         ======================================================
25
26
 
26
27
As indicated above, branches are identified using URLs with the
27
28
prefix indicating the transfer technology. If no prefix is given,
28
29
normal filenames are assumed. For a complete list of supported
29
30
protocols, see the ``urlspec`` online help topic or the
30
 
`URL Identifiers <../user-reference/bzr_man.html#url-identifiers>`_
 
31
`URL Identifiers <../user-reference/index.html#url-identifiers>`_
31
32
section of the Bazaar User Reference.
32
33
 
33
34
URLs are normally resolved relative to the root directory of the server,
41
42
tilde like so: ``sftp://example.com/~/public_html`` should map to
42
43
``public_html`` within your home directory.
43
44
 
 
45
.. note:: Access over HTTP or HTTPS is read-only by default.
 
46
   See `Pushing over the HTTP smart server
 
47
   <http_smart_server.html#pushing-over-the-http-smart-server>`_ for
 
48
   details on configuring read-write access.
 
49
 
44
50
A reminder about shared repositories
45
51
------------------------------------
46
52
 
69
75
 
70
76
If a directory is not given, one is created based on the last part of
71
77
the URL. Here are some examples showing a drive qualified path (M:/) and an
72
 
sftp URL respectively::
 
78
SFTP URL respectively::
73
79
 
74
80
  bzr branch M:/cool-trunk
75
81
  bzr branch sftp://bill@mary-laptop/cool-repo/cool-trunk