← 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: Richard Wilbur
  • Date: 2016-02-04 19:07:28 UTC
  • mto: This revision was merged to the branch mainline in revision 6618.
  • Revision ID: richard.wilbur@gmail.com-20160204190728-p0zvfii6zase0fw7
Update COPYING.txt from the original http://www.gnu.org/licenses/gpl-2.0.txt  (Only differences were in whitespace.)  Thanks to Petr Stodulka for pointing out the discrepancy.

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