~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/uncommit.txt

  • Committer: Martin Pool
  • Date: 2005-06-01 06:09:59 UTC
  • Revision ID: mbp@sourcefrog.net-20050601060959-e0be99c26487bd63
Major rework of locking code:

- New ReadLock and WriteLock objects, with unlock methods, and that
  give a warning if they leak without being unlocked

- The lock file is opened readonly for read locks, which should avoid
  problems when the user only has read permission for a branch.

- Selective definitions of locking code is perhaps simpler now

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Uncommit Performance Notes
2
 
==========================
3
 
 
4
 
Specification of uncommit
5
 
-------------------------
6
 
 
7
 
``uncommit`` removes revisions from the head of a branch.  (By default, only
8
 
the very latest revision is removed, but optionally more can be taken.)
9
 
Uncommit does not affect the repository (garbage collection is a separate
10
 
step and not done by default).  The working tree is not logically
11
 
modified (revert is a different operation), except as described below
12
 
about merges.
13
 
 
14
 
Uncommit can be performed on either a branch or a working tree (and
15
 
implicitly its branch.)
16
 
 
17
 
If the uncommitted revisions includes one or more merges, after the
18
 
uncommit those revisions are in the working tree's list of pending merges,
19
 
because their tree changes are still present in the tree.
20
 
 
21
 
For a bound branch, uncommit fails unless the local branch is up to date.