/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/using_checkouts.txt

  • Committer: Vincent Ladeuil
  • Date: 2012-01-05 14:26:58 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120105142658-vek3v6pzlxb751s2
Tests passing for a first rough version of a cached branch config store. The changes here are too invasive and several parallel proposals have been made. 

@only_raises is evil and gave a hard time since any exception during
save_changes() was swallowed.

Possible improvements: 

- add some needs_write_lock decorators to crucial
  methods (_set_config_location ?) but keep locking the branch at higher levels

- decorate branch.unlock to call stack.save if last_lock() it True
  outside of @only_raises scope (evil decorator)

- add @needs_write_lock to stack.set and stack.remove (will probably get
  rid of most testing issues) we probably need a specialized decorator
  that can relay to the store and from there to the branch or whatever is
  needed. This will also helps bzr config to get it right. The
  get_mutable_section trick should not be needed anymore either.

- decorate branch.unlock to call stack.save if last_lock() it True outside
  of @only_raises scope (evil decorator)

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.