/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2009-12-14 06:06:59 UTC
  • mfrom: (4889 +trunk)
  • mto: This revision was merged to the branch mainline in revision 4891.
  • Revision ID: mbp@sourcefrog.net-20091214060659-1ucv8hpnky0cbnaj
merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/branching_a_project.txt
16
16
  ===========         ======================================================
17
17
  Prefix              Description
18
18
  ===========         ======================================================
19
 
  file://             Access using the standard filesystem (default)
20
 
  sftp://             Access using SFTP (most SSH servers provide SFTP).
21
 
  bzr://              Fast access using the Bazaar smart server.
22
 
  ftp://              Access using passive FTP.
23
 
  http://             Read-only access to branches exported by a web server.
 
19
  \file://            Access using the standard filesystem (default)
 
20
  \sftp://            Access using SFTP (most SSH servers provide SFTP).
 
21
  \bzr://             Fast access using the Bazaar smart server.
 
22
  \ftp://             Access using passive FTP.
 
23
  \http://            Read-only access to branches exported by a web server.
24
24
  ===========         ======================================================
25
25
 
26
26
As indicated above, branches are identified using URLs with the
37
37
where to put it on your filesystem. For maximum storage
38
38
efficiency down the track, it is recommended that branches
39
39
be created somewhere under a directory that has been set up
40
 
as a shared repository. For example::
 
40
as a shared repository. (See `Feature branches
 
41
<organizing_your_workspace.html#feature-branches>`_ in
 
42
`Organizing your workspace <organizing_your_workspace.html>`_
 
43
for a commonly used layout.) For example::
41
44
 
42
45
  bzr init-repo my-repo
43
46
  cd my-repo
48
51
The branch command
49
52
------------------
50
53
 
51
 
To get a copy of an existing branch, use the ``branch`` command.
 
54
To get a branch based on an existing branch, use the ``branch`` command.
52
55
The syntax is::
53
56
 
54
57
  bzr branch URL [directory]
55
58
 
56
59
If a directory is not given, one is created based on the last part of
57
 
the URL. Here are some examples showing a network share URL and an
 
60
the URL. Here are some examples showing a drive qualified path (M:/) and an
58
61
sftp URL respectively::
59
62
 
60
 
  bzr branch m:/cool-trunk
 
63
  bzr branch M:/cool-trunk
61
64
  bzr branch sftp://bill@mary-laptop/cool-repo/cool-trunk
62
65
 
63
66
This example shows explicitly giving the directory name to use for the
89
92
the latest version.
90
93
 
91
94
As explained in later chapters, Bazaar also has support for
92
 
lightweight checkouts of a branch, i.e. working trees with
 
95
`lightweight checkouts <using_checkouts.html#getting-a-lightweight-checkout>`_
 
96
of a branch, i.e. working trees with
93
97
no local storage of history. Of course, disconnected usage
94
98
is not available then but that's a tradeoff you can decide
95
99
to make if local disk space is really tight for you. Support for