/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: Jelmer Vernooij
  • Date: 2017-05-21 19:09:26 UTC
  • mfrom: (6622.1.36 breezy)
  • Revision ID: jelmer@jelmer.uk-20170521190926-5vtz8xaf0e9ylrpc
Merge rename to breezy.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/branching_a_project.txt
10
10
a network share, an approach familiar to Windows users.
11
11
Unix users might prefer access to be
12
12
via SSH, a secure protocol built-in to most SSH servers.
13
 
Bazaar is *very* flexible in this regard with support for
 
13
Breezy is *very* flexible in this regard with support for
14
14
lots of protocols some of which are given below.
15
15
 
16
16
  ===========         ======================================================
19
19
  \file://            Access using the standard filesystem (default).
20
20
  \bzr+ssh:/          Access over SSH (best remote option).
21
21
  \sftp://            Access using SFTP (most SSH servers provide SFTP).
22
 
  \bzr://             Fast access using the Bazaar smart server.
 
22
  \bzr://             Fast access using the Breezy smart server.
23
23
  \ftp://             Access using passive FTP.
24
24
  \http://            Access to branches exported by a web server.
25
25
  \https://           Encrypted access to branches exported by a web server.
30
30
normal filenames are assumed. For a complete list of supported
31
31
protocols, see the ``urlspec`` online help topic or the
32
32
`URL Identifiers <../user-reference/index.html#url-identifiers>`_
33
 
section of the Bazaar User Reference.
 
33
section of the Breezy User Reference.
34
34
 
35
35
URLs are normally resolved relative to the root directory of the server,
36
36
so ``ftp://example.com/repo/foo`` means the ``/repo/foo`` directory of
60
60
`Organizing your workspace <organizing_your_workspace.html>`_
61
61
for a commonly used layout.) For example::
62
62
 
63
 
  bzr init-repo my-repo
 
63
  brz init-repo my-repo
64
64
  cd my-repo
65
65
 
66
66
You are now ready to grab a branch from someone else and
72
72
To get a branch based on an existing branch, use the ``branch`` command.
73
73
The syntax is::
74
74
 
75
 
  bzr branch URL [directory]
 
75
  brz branch URL [directory]
76
76
 
77
77
If a directory is not given, one is created based on the last part of
78
78
the URL. Here are some examples showing a drive qualified path (M:/) and an
79
79
SFTP URL respectively::
80
80
 
81
 
  bzr branch M:/cool-trunk
82
 
  bzr branch sftp://bill@mary-laptop/cool-repo/cool-trunk
 
81
  brz branch M:/cool-trunk
 
82
  brz branch sftp://bill@mary-laptop/cool-repo/cool-trunk
83
83
 
84
84
This example shows explicitly giving the directory name to use for the
85
85
new branch::
86
86
 
87
 
  bzr branch /home/mary/cool-repo/cool-trunk cool
 
87
  brz branch /home/mary/cool-repo/cool-trunk cool
88
88
 
89
89
Time and space considerations
90
90
-----------------------------
95
95
Subsequent updates should be much faster as only the
96
96
changes are transferred then.
97
97
 
98
 
Keep in mind that Bazaar is transferring the
 
98
Keep in mind that Breezy is transferring the
99
99
complete history of the branch, not just the latest snapshot.
100
100
As a consequence, you can be off the network (or disconnected
101
101
from the network share) after ``branch`` completes but you'll
103
103
branch as much as you want. Furthermore, these operations
104
104
are quick as the history is stored locally.
105
105
 
106
 
Note that Bazaar uses smart compression technology to
 
106
Note that Breezy uses smart compression technology to
107
107
minimize the amount of disk space required to store version
108
108
history. In many cases, the complete history of a project
109
109
will take up less disk space than the working copy of
110
110
the latest version.
111
111
 
112
 
As explained in later chapters, Bazaar also has support for
 
112
As explained in later chapters, Breezy also has support for
113
113
`lightweight checkouts <using_checkouts.html#getting-a-lightweight-checkout>`_
114
114
of a branch, i.e. working trees with
115
115
no local storage of history. Of course, disconnected usage
124
124
If you wish to see information about a branch including where it came from,
125
125
use the ``info`` command. For example::
126
126
 
127
 
  bzr info cool
 
127
  brz info cool
128
128
 
129
129
If no branch is given, information on the current branch is displayed.