/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/stacked.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/stacked.txt
41
41
To create a stacked branch, use the ``stacked`` option of the branch command.
42
42
For example::
43
43
 
44
 
  bzr branch --stacked source-url my-dir
 
44
  brz branch --stacked source-url my-dir
45
45
 
46
46
This will create ``my-dir`` as a stacked branch with no local revisions.
47
47
If it is defined, the public branch associated with ``source-url`` will be
69
69
branch stacked on one of these is easy to do using the ``push``
70
70
command like this::
71
71
 
72
 
  bzr push --stacked-on reference-url my-url
 
72
  brz push --stacked-on reference-url my-url
73
73
 
74
74
This creates a new branch at ``my-url`` that is stacked on ``reference-url``
75
75
and only contains the revisions in the current branch that are not already
78
78
can be used additionally to inform ``push`` to reference the
79
79
revisions in ``reference-url``. For example::
80
80
 
81
 
  bzr push --stacked-on bzr+ssh://host/project bzr+ssh://host/user/stacked-branch
 
81
  brz push --stacked-on bzr+ssh://host/project bzr+ssh://host/user/stacked-branch
82
82
 
83
83
This usage fits the scenario described in the Motivation section.
84
84
 
87
87
the branch you are pushing (or its ``public_location`` if configured).  For
88
88
example::
89
89
 
90
 
  bzr branch source-url my-dir
 
90
  brz branch source-url my-dir
91
91
  cd my-dir
92
92
  (hack, hack, hack)
93
 
  bzr commit -m "fix bug"
94
 
  bzr push --stacked
 
93
  brz commit -m "fix bug"
 
94
  brz push --stacked
95
95
 
96
 
You can combine ``bzr branch --stacked`` and ``bzr push --stacked`` to work on a
 
96
You can combine ``brz branch --stacked`` and ``brz push --stacked`` to work on a
97
97
branch without downloading or uploading the whole history::
98
98
 
99
 
  bzr branch --stacked source-url my-dir
 
99
  brz branch --stacked source-url my-dir
100
100
  cd my-dir
101
101
  (hack, hack, hack)
102
 
  bzr commit -m "fix bug"
103
 
  bzr push --stacked
 
102
  brz commit -m "fix bug"
 
103
  brz push --stacked
104
104
 
105
105
 
106
106
Limitations of stacked branches
115
115
``public_location`` to help prevent that.
116
116
 
117
117
Similarly, because most of the history is stored in the stacked-on repository,
118
 
operations like ``bzr log`` can be slower when the stacked-on repository is
 
118
operations like ``brz log`` can be slower when the stacked-on repository is
119
119
accessed via a network.
120
120
 
121
121
If a stacked branch is in a format older than 2a, you cannot commit to it due to
127
127
Changing branch stacking
128
128
------------------------
129
129
 
130
 
Stacking of existing branches can be changed using the ``bzr reconfigure``
 
130
Stacking of existing branches can be changed using the ``brz reconfigure``
131
131
command to either stack on an existing branch, or to turn off stacking.
132
 
Be aware that when ``bzr reconfigure --unstacked`` is used, bzr will
 
132
Be aware that when ``brz reconfigure --unstacked`` is used, brz will
133
133
copy all the referenced data from the stacked-on repository into the
134
134
previously stacked repository.  For large repositories this may take
135
135
considerable time and may substantially increase the size of the