← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/uncommit.txt

  • Committer: Andrew Bennetts
  • Date: 2007-03-26 06:24:01 UTC
  • mto: This revision was merged to the branch mainline in revision 2376.
  • Revision ID: andrew.bennetts@canonical.com-20070326062401-k3nbefzje5332jaf
Deal with review comments from Robert:

  * Add my name to the NEWS file
  * Move the test case to a new module in branch_implementations
  * Remove revision_history cruft from identitymap and test_identitymap
  * Improve some docstrings

Also, this fixes a bug where revision_history was not returning a copy of the
cached data, allowing the cache to be corrupted.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/uncommit.txt
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.