/breezy/unstable

To get this branch, use:
bzr branch https://code.breezy-vcs.org/breezy/unstable

« back to all changes in this revision

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

  • Committer: Jelmer Vernooij
  • Date: 2017-05-24 01:39:33 UTC
  • mfrom: (3815.3776.6)
  • Revision ID: jelmer@jelmer.uk-20170524013933-ir4y4tqtrsiz2ka2
New upstream snapshot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Bazaar Zen
 
1
Breezy Zen
2
2
==========
3
3
 
4
 
Grokking Bazaar
 
4
Grokking Breezy
5
5
---------------
6
6
 
7
 
While Bazaar is similar to other VCS tools in many ways, there are
 
7
While Breezy is similar to other VCS tools in many ways, there are
8
8
some important differences that are not necessarily obvious at first
9
9
glance.  This section attempts
10
 
to explain some of the things users need to know in order to "grok" Bazaar,
 
10
to explain some of the things users need to know in order to "grok" Breezy,
11
11
i.e. to deeply understand it.
12
12
 
13
 
Note: It isn't necessary to fully understand this section to use Bazaar.
 
13
Note: It isn't necessary to fully understand this section to use Breezy.
14
14
You may wish to skim this section now and come back to it at a later time.
15
15
 
16
16
Understanding revision numbers
29
29
number of revisions since the branch started. For example, 3112.1.5 is the
30
30
first branch from revision 3112, the fifth revision on that branch.
31
31
 
32
 
.. [#] Versions prior to bzr 1.2 used a slightly different algorithm.
 
32
.. [#] Versions prior to brz 1.2 used a slightly different algorithm.
33
33
   Some nested branches would get extra numbers (such as 1.1.1.1.1)
34
34
   rather than the simpler 3-number system.
35
35
 
60
60
Many teams use this approach because their tools make branching and merging
61
61
difficult. As a consequence, developers update from and commit to the trunk
62
62
frequently, minimizing integration pain by spreading it over every commit.
63
 
If you wish, you can use Bazaar exactly like this. Bazaar does offer other
 
63
If you wish, you can use Breezy exactly like this. Breezy does offer other
64
64
ways though that you ought to consider.
65
65
 
66
66
An alternative approach encouraged by distributed VCS tools is to create
153
153
Each branch has its own view of history
154
154
---------------------------------------
155
155
 
156
 
As explained above, Bazaar makes the distinction between:
 
156
As explained above, Breezy makes the distinction between:
157
157
 
158
158
 * mainline revisions, i.e. ones you committed in your branch, and
159
159
 
184
184
merging the trunk (and resolving any conflicts caused by doing that) is
185
185
just one step as far as the history of this branch is concerned.
186
186
 
187
 
It's important to remember that Bazaar is not changing history here, nor
 
187
It's important to remember that Breezy is not changing history here, nor
188
188
is it changing the global revision identifiers. You can always use the
189
189
latter if you really want to. In fact, you can use the branch specific
190
190
revision numbers when communicating *as long as* you provide the branch
191
 
URL as context. (In many Bazaar projects, developers imply the central
 
191
URL as context. (In many Breezy projects, developers imply the central
192
192
trunk branch if they exchange a revision number without a branch URL.)
193
193
 
194
194
Merges do not change revision numbers in a branch, though they do
195
195
allocate local revision numbers to newly merged revisions. The only time
196
 
Bazaar will change revision numbers in a branch is when you explicitly
 
196
Breezy will change revision numbers in a branch is when you explicitly
197
197
ask it to mirror another branch.
198
198
 
199
199
Note: Revisions are numbered in a stable way: if two branches have
206
206
-------
207
207
 
208
208
In general, if you follow the advice given earlier - organise
209
 
your work in branches and use merge to collaborate - you'll find Bazaar
 
209
your work in branches and use merge to collaborate - you'll find Breezy
210
210
generally does what you expect.
211
211
 
212
 
In coming chapters, we examine various ways of using Bazaar beginning with
213
 
the simplest: using Bazaar for personal projects.
 
212
In coming chapters, we examine various ways of using Breezy beginning with
 
213
the simplest: using Breezy for personal projects.
214
214
 
215
215
..
216
216
   vim: ft=rst tw=74 ai