← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/using_checkouts.txt
7
7
If you have a local branch and wish to make it a checkout, use the
8
8
``bind`` command like this::
9
9
 
10
 
  bzr bind sftp://centralhost/srv/bzr/PROJECT/trunk
 
10
  bzr bind bzr+ssh://centralhost/srv/bzr/PROJECT/trunk
11
11
 
12
12
This is necessary, for example, after creating a central branch using
13
13
``push`` as illustrated in the previous section.
56
56
To get a history-less checkout in Bazaar, use the ``--lightweight``
57
57
option like this::
58
58
 
59
 
  bzr checkout --lightweight sftp://centralhost/srv/bzr/PROJECT/trunk
 
59
  bzr checkout --lightweight bzr+ssh://centralhost/srv/bzr/PROJECT/trunk
60
60
 
61
61
Of course, many of the benefits of a normal checkout are lost by doing
62
62
this but that's a tradeoff you can make if and when it makes sense.