← Back to branch summary

~ubuntu-branches/ubuntu/maverick/bzr/maverick-updates

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Jelmer Vernooij
  • Date: 2010-03-24 22:27:38 UTC
  • mfrom: (1.4.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20100324222738-5lsc0gdzmtcdp1vp
Tags: 2.1.1-1
http://bugs.debian.org/573427
* Remove bob2 from uploaders. Closes: #573427
* New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/stacked.txt
65
65
and only contains the revisions in the current branch that are not already
66
66
in the branch at ``reference-url``.
67
67
 
68
 
If the local branch was created as a stacked branch, then you can
69
 
use the ``--stacked`` option to ``push`` and the *stacked-on* location
70
 
will be implicit. For example::
71
 
 
72
 
  bzr branch --stacked source-url my-dir
73
 
  cd my-dir
74
 
  (hack, hack, hack)
75
 
  bzr commit -m "fix bug"
76
 
  bzr push --stacked
 
68
 
 
69
.. The following text is hidden because bug 375013 breaks the example.
 
70
   When bug 375013 is fixed, we should unhide this text.
 
71
      - Andrew Bennetts, 10 March 2010
 
72
 
 
73
.. If the local branch was created as a stacked branch, then you can
 
74
.. use the ``--stacked`` option to ``push`` and the *stacked-on* location
 
75
.. will be implicit. For example::
 
76
.. 
 
77
..   bzr branch --stacked source-url my-dir
 
78
..   cd my-dir
 
79
..   (hack, hack, hack)
 
80
..   bzr commit -m "fix bug"
 
81
..   bzr push --stacked
77
82
 
78
83
 
79
84
Limitations of stacked branches
80
85
-------------------------------
81
86
 
 
87
Currently, you cannot commit to a stacked branch, due to `bug 375013`_.
 
88
 
 
89
.. _bug 375013: https://bugs.launchpad.net/bzr/+bug/375013
 
90
 
82
91
The important thing to remember about a stacked branch is that the
83
92
stacked-on branch needs to be available for almost all operations. This is
84
93
not an issue when both branches are local or both branches are on the
85
94
same server.
86
95
 
 
96
Similarly, because most of the history is stored in the stacked-on repository,
 
97
operations like ``bzr log`` can be slower when the stacked-on repository is
 
98
accessed via a network.
 
99
 
87
100
 
88
101
Changing branch stacking
89
102
------------------------