← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-03-16 16:58:03 UTC
  • mfrom: (3224.3.1 news-typo)
  • Revision ID: pqm@pqm.ubuntu.com-20080316165803-tisoc9mpob9z544o
(Matt Nordhoff) Trivial NEWS typo fix

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/undoing_mistakes.txt
10
10
Dropping the revision history for a project
11
11
-------------------------------------------
12
12
 
13
 
If you accidentally put the wrong tree under version control, simply
 
13
If you accidently put the wrong tree under version control, simply
14
14
delete the ``.bzr`` directory.
15
15
 
16
16
Deregistering a file or directory
17
17
---------------------------------
18
18
 
19
 
If you accidentally register a file using ``add`` that you
 
19
If you accidently register a file using ``add`` that you
20
20
don't want version controlled, you can use the ``remove``
21
21
command to tell Bazaar to forget about it.
22
22
 
29
29
 
30
30
This will complain about the file being modified or unknown.
31
31
If you want to keep the file, use the ``--keep`` option.
32
 
Alternatively, if you want to delete the file, use the ``--force`` option.
 
32
Alternatively, if you want to remove the file, use the ``--force`` option.
33
33
For example::
34
34
 
35
35
  bzr add foo.html
36
36
  (oops - didn't mean that)
37
37
  bzr remove --keep foo.html
38
 
  (foo.html left on disk, but deregistered)
 
38
  (foo.html left on disk)
39
39
 
40
 
On the other hand, the unchanged ``TODO`` file is deregistered and
 
40
On the other hand, the ``TODO`` file is deregistered and
41
41
removed from disk without complaint in this example::
42
42
 
43
43
  bzr add TODO
93
93
one or more files. Some users like to alias ``commit`` to ``commit --strict``
94
94
so that commits fail if unknown files are found in the tree.
95
95
 
96
 
Tags for uncommitted revisions are removed from the branch unless
97
 
``--keep-tags`` was specified.
98
 
 
99
96
Note: While the ``merge`` command is not introduced until the next
100
97
chapter, it is worth noting now that ``uncommit`` restores any pending
101
98
merges. (Running ``bzr status`` after ``uncommit`` will show these.)
102
99
``merge`` can also be used to effectively undo just a selected commit
103
 
earlier in history. For more information on ``merge``, see
104
 
`Merging changes <merging_changes.html>`_ in the next chapter and the
105
 
Bazaar User Reference.
 
100
earlier in history. For more information on ``merge``, see `Merging changes`_
 
101
in the next chapter and the Bazaar User Reference.
106
102
 
107
103
Undoing multiple commits
108
104
------------------------
130
126
  Committed revision 20.
131
127
  (release the code)
132
128
  (hmm - bad fix)
133
 
  bzr revert -r 19
 
129
  bzr revert -r 20
134
130
  bzr commit -m "Backout fix for bug #5"
135
131
 
136
 
This will change your entire tree back to the state as of revision 19,
137
 
which is probably only what you want if you haven't made any new commits
138
 
since then. If you have, the ``revert`` would wipe them out as well. In that
139
 
case, you probably want to use `Reverse cherrypicking
140
 
<adv_merging.html#reverse-cherrypicking>`_ instead to
141
 
back out the bad fix.
142
 
 
143
 
Note: As an alternative to using an absolute revision number (like 19), you can
144
 
specify one relative to the tip (-1) using a negative number like this::
145
 
 
146
 
  bzr revert -r -2
147
 
 
148
132
Correcting a tag
149
133
----------------
150
134
 
153
137
 
154
138
  bzr tag 2.0-beta-1
155
139
  (oops, we're not yet ready for that)
156
 
  (make more commits to include more fixes)
157
140
  bzr tag 2.0-beta-1 --force
158
141
 
159
142
Clearing a tag