← 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

  • Committer: Andrew Bennetts
  • Date: 2010-10-08 08:15:14 UTC
  • mto: This revision was merged to the branch mainline in revision 5498.
  • Revision ID: andrew.bennetts@canonical.com-20101008081514-dviqzrdfwyzsqbz2
Split NEWS into per-release doc/en/release-notes/bzr-*.txt

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/branching_a_project.txt
9
9
You may decide to make the top level directory of your branch
10
10
a network share, an approach familiar to Windows users.
11
11
Unix users might prefer access to be
12
 
via SSH, a secure protocol built-in to most SSH servers.
 
12
via SFTP, a secure protocol built-in to most SSH servers.
13
13
Bazaar is *very* flexible in this regard with support for
14
14
lots of protocols some of which are given below.
15
15
 
16
16
  ===========         ======================================================
17
17
  Prefix              Description
18
18
  ===========         ======================================================
19
 
  \file://            Access using the standard filesystem (default).
20
 
  \bzr+ssh:/          Access over SSH (best remote option).
 
19
  \file://            Access using the standard filesystem (default)
21
20
  \sftp://            Access using SFTP (most SSH servers provide SFTP).
22
21
  \bzr://             Fast access using the Bazaar smart server.
23
22
  \ftp://             Access using passive FTP.
29
28
prefix indicating the transfer technology. If no prefix is given,
30
29
normal filenames are assumed. For a complete list of supported
31
30
protocols, see the ``urlspec`` online help topic or the
32
 
`URL Identifiers <../user-reference/index.html#url-identifiers>`_
 
31
`URL Identifiers <../user-reference/urlspec-help.html>`_
33
32
section of the Bazaar User Reference.
34
33
 
35
34
URLs are normally resolved relative to the root directory of the server,
40
39
which directory.)
41
40
 
42
41
To address a path relative to your home directory on the server, use a
43
 
tilde like so: ``bzr+ssh://example.com/~/public_html`` should map to
 
42
tilde like so: ``sftp://example.com/~/public_html`` should map to
44
43
``public_html`` within your home directory.
45
44
 
46
45
.. note:: Access over HTTP or HTTPS is read-only by default.
47
 
   See `Pushing over the HTTP smart server
 
46
   See `Pushing over the http smart server
48
47
   <http_smart_server.html#pushing-over-the-http-smart-server>`_ for
49
48
   details on configuring read-write access.
50
49
 
76
75
 
77
76
If a directory is not given, one is created based on the last part of
78
77
the URL. Here are some examples showing a drive qualified path (M:/) and an
79
 
SFTP URL respectively::
 
78
sftp URL respectively::
80
79
 
81
80
  bzr branch M:/cool-trunk
82
81
  bzr branch sftp://bill@mary-laptop/cool-repo/cool-trunk