← Back to branch summary

~bzr/ubuntu/lucid/bzr/beta-ppa

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2010-07-02 07:29:40 UTC
  • mfrom: (129.1.7 packaging-karmic)
  • Revision ID: mbp@sourcefrog.net-20100702072940-hpzq5elg8wjve8rh
http://bugs.debian.org/452024
http://bugs.debian.org/464688
http://bugs.debian.org/523595
http://bugs.debian.org/526233
http://bugs.debian.org/537708
http://bugs.debian.org/555336
http://bugs.debian.org/555343
https://launchpad.net/bugs/249452
https://launchpad.net/bugs/385074
* PPA rebuild.
* PPA rebuild for Karmic.
* PPA rebuild for Jaunty.
* PPA rebuild for Hardy.
* From postinst, actually remove the example bash completion scripts.
  (LP: #249452)
* New upstream release.
* New upstream release.
* New upstream release.
* Revert change to Build-depends: Dapper does not have python-central.
  Should be python-support..
* Target ppa..
* Target ppa..
* Target ppa..
* Target ppa..
* New upstream release.
* Switch to dpkg-source 3.0 (quilt) format.
* Bump standards version to 3.8.4.
* Remove embedded copy of python-configobj. Closes: #555336
* Remove embedded copy of python-elementtree. Closes: #555343
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* debian/control: Fix obsolete-relation-form-in-source
  lintian warning. 
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split out docs into bzr-doc package.
* New upstream release.
* Added John Francesco Ferlito to Uploaders.
* Fix install path to quick-reference guide
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again, again.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to path changes.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Bump standards version to 3.8.3.
* Remove unused patch system.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix copy and paste tab error in .install file
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
 + Fixes compatibility with Python 2.4. Closes: #537708
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream version.
* Bump standards version to 3.8.2.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add python-pyrex to build-deps to ensure C extensions are always build.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix API compatibility version. (Closes: #526233)
* New upstream release.
  + Fixes default format for upgrade command. (Closes: #464688)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add missing dependency on zlib development library. (Closes:
  #523595)
* Add zlib build-depends.
* Add zlib build-depends.
* Add zlib build-depends.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Move to section vcs.
* Bump standards version to 3.8.1.
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Recommend ca-certificates. (Closes: #452024)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Update watch file. bazaar now uses launchpad to host its sources.
* Remove patch for inventory root revision copy, applied upstream.
* New upstream release.
* New upstream release.
* New upstream release
* Force removal of files installed in error to /etc/bash_completion.d/
  (LP: #249452)
* New upstream release.
* New upstream release
* New upstream release.
* Bump standards version.
* Include patch for inventory root revision copy, required for bzr-svn.
* New upstream release.
* Remove unused lintian overrides.
* Correct the package version not to be native.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Final 1.5 release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add myself as a co-maintainer.
* Add a Dm-Upload-Allowed: yes header.
* New upstream bugfix release.
* New upstream release.
* Final 1.3 release.
* New upstream release.
* First release candidate of the upcoming 1.3 release.
* Rebuild to fix the problem caused by a build with a broken python-central.
* New upstream release.
* Rebuild for dapper PPA.
* Apply Lamont's patches to fix build-dependencies on dapper.
  (See: https://bugs.launchpad.net/bzr/+bug/189915)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/merging_changes.txt
 
1
Merging changes
 
2
===============
 
3
 
 
4
Parallel development
 
5
--------------------
 
6
 
 
7
Once someone has their own branch of a project, they can make
 
8
and commit changes in parallel to any development proceeding
 
9
on the original branch. Pretty soon though, these independent
 
10
lines of development will need to be combined again. This
 
11
process is known as *merging*.
 
12
 
 
13
The merge command
 
14
-----------------
 
15
 
 
16
To incorporate changes from another branch, use the ``merge`` command.
 
17
Its syntax is::
 
18
 
 
19
  bzr merge [URL]
 
20
 
 
21
If no URL is given, a default is used, initially the branch this branch
 
22
originated from.
 
23
For example, if Bill made a branch from Mary's work, he can merge her
 
24
subsequent changes by simply typing this::
 
25
 
 
26
  bzr merge
 
27
 
 
28
On the other hand, Mary might want to merge into her branch the work Bill
 
29
has done in his. In this case, she needs to explicitly give the URL the
 
30
first time, e.g.::
 
31
 
 
32
  bzr merge sftp://mary@bill-laptop/cool-repo/cool-trunk
 
33
 
 
34
This sets the default merge branch if one is not already set. To change the
 
35
default after it is set, use the ``--remember`` option.
 
36
 
 
37
How does merging work?
 
38
----------------------
 
39
 
 
40
A variety of algorithms exist for merging changes. Bazaar's
 
41
default algorithm is a variation of *3-way merging* which
 
42
works as follows. Given an ancestor A and two branches B and C,
 
43
the following table provides the rules used.
 
44
 
 
45
  === === === ====== =================
 
46
   A   B   C  Result Comment
 
47
  === === === ====== =================
 
48
   x   x   x  x      unchanged
 
49
   x   x   y  y      line from C
 
50
   x   y   x  y      line from B
 
51
   x   y   z  ?      conflict
 
52
  === === === ====== =================
 
53
 
 
54
Note that some merges can only be completed with the assistance
 
55
of a human. Details on how to resolve these are given in
 
56
`Resolving conflicts <resolving_conflicts.html>`_.
 
57
 
 
58
Recording a merge
 
59
-----------------
 
60
 
 
61
After any conflicts are resolved, the merge needs to be committed.
 
62
For example::
 
63
 
 
64
  bzr commit -m "Merged Mary's changes"
 
65
 
 
66
Even if there are no conflicts, an explicit commit is still required.
 
67
Unlike some other tools, this is considered a feature in Bazaar.
 
68
A clean merge is not necessarily a good merge so making the commit
 
69
a separate explicit step allows you to run your test suite first to
 
70
verify all is good. If problems are found, you should correct them
 
71
before committing the merge or throw the merge away using ``revert``.
 
72
 
 
73
Merge tracking
 
74
--------------
 
75
 
 
76
One of the most important features of Bazaar is distributed,
 
77
high quality *merge tracking*.
 
78
In other words, Bazaar remembers what has been merged already and
 
79
uses that information to intelligently choose the best ancestor for
 
80
a merge, minimizing the number and size of conflicts.
 
81
 
 
82
If you are a refugee from many other VCS tools, it can be really
 
83
hard to "unlearn" the *please-let-me-avoid-merging-at-any-cost* habit.
 
84
Bazaar lets you safely merge as often as you like with other people.
 
85
By working in a peer-to-peer manner when it makes sense to do so, you
 
86
also avoid using a central branch as an "integration swamp", keeping
 
87
its quality higher. When the change you're collaborating on is
 
88
truly ready for wider sharing, that's the time to merge and commit
 
89
it to a central branch, not before.
 
90
 
 
91
Merging that Just Works truly can change how developers work together.