$ hg init basic

  $ cd basic

should complain

  $ hg backout

  abort: please specify a revision to backout

  [255]

  $ hg backout -r 0 0

  abort: please specify just one revision

  [255]

basic operation

(this also tests that editor is invoked if the commit message is not

specified explicitly)

  $ echo a > a

  $ hg commit -d '0 0' -A -m a

  adding a

  $ echo b >> a

  $ hg commit -d '1 0' -m b

  $ hg status --rev tip --rev "tip^1"

  M a

  $ HGEDITOR=cat hg backout -d '2 0' tip --tool=true

  reverting a

  Backed out changeset a820f4f40a57

  HG: Enter commit message.  Lines beginning with 'HG:' are removed.

  HG: Leave message empty to abort commit.

  HG: --

  HG: user: test

  HG: branch 'default'

  HG: changed a

  changeset 2:2929462c3dff backs out changeset 1:a820f4f40a57

  $ cat a

  a

  $ hg summary

  parent: 2:2929462c3dff tip

   Backed out changeset a820f4f40a57

  branch: default

  commit: (clean)

  update: (current)

  phases: 3 draft (draft)

commit option

  $ cd ..

  $ hg init commit

  $ cd commit

  $ echo tomatoes > a

  $ hg add a

  $ hg commit -d '0 0' -m tomatoes

  $ echo chair > b

  $ hg add b

  $ hg commit -d '1 0' -m chair

  $ echo grapes >> a

  $ hg commit -d '2 0' -m grapes

  $ hg backout --commit -d '4 0' 1 --tool=:fail

  0 files updated, 0 files merged, 1 files removed, 0 files unresolved

  changeset 3:1c2161e97c0a backs out changeset 1:22cb4f70d813

  $ hg summary

  parent: 3:1c2161e97c0a tip

   Backed out changeset 22cb4f70d813

  branch: default

  commit: (clean)

  update: (current)

  phases: 4 draft (draft)

  $ echo ypples > a

  $ hg commit -d '5 0' -m ypples

  $ hg backout --commit -d '6 0' 2 --tool=:fail

  0 files updated, 0 files merged, 0 files removed, 1 files unresolved

  use 'hg resolve' to retry unresolved file merges

  [1]

  $ hg summary

  parent: 4:ed99997b793d tip

   ypples

  branch: default

  commit: 1 unresolved (clean)

  update: (current)

  phases: 5 draft (draft)

file that was removed is recreated

(this also tests that editor is not invoked if the commit message is

specified explicitly)

  $ cd ..

  $ hg init remove

  $ cd remove

  $ echo content > a

  $ hg commit -d '0 0' -A -m a

  adding a

  $ hg rm a

  $ hg commit -d '1 0' -m b

  $ HGEDITOR=cat hg backout -d '2 0' tip --tool=true -m "Backed out changeset 76862dcce372"

  adding a

  changeset 2:de31bdc76c0d backs out changeset 1:76862dcce372

  $ cat a

  content

  $ hg summary

  parent: 2:de31bdc76c0d tip

   Backed out changeset 76862dcce372

  branch: default

  commit: (clean)

  update: (current)

  phases: 3 draft (draft)

backout of backout is as if nothing happened

  $ hg backout -d '3 0' --merge tip --tool=true

  removing a

  changeset 3:7f6d0f120113 backs out changeset 2:de31bdc76c0d

  $ test -f a

  [1]

  $ hg summary

  parent: 3:7f6d0f120113 tip

   Backed out changeset de31bdc76c0d

  branch: default

  commit: (clean)

  update: (current)

  phases: 4 draft (draft)

across branch

  $ cd ..

  $ hg init branch

  $ cd branch

  $ echo a > a

  $ hg ci -Am0

  adding a

  $ echo b > b

  $ hg ci -Am1

  adding b

  $ hg co -C 0

  0 files updated, 0 files merged, 1 files removed, 0 files unresolved

  $ hg summary

  parent: 0:f7b1eb17ad24 

   0

  branch: default

  commit: (clean)

  update: 1 new changesets (update)

  phases: 2 draft (draft)

should fail

  $ hg backout 1

  abort: cannot backout change that is not an ancestor

  [255]

  $ echo c > c

  $ hg ci -Am2

  adding c

  created new head

  $ hg summary

  parent: 2:db815d6d32e6 tip

   2

  branch: default

  commit: (clean)

  update: 1 new changesets, 2 branch heads (merge)

  phases: 3 draft (draft)

should fail

  $ hg backout 1

  abort: cannot backout change that is not an ancestor

  [255]

  $ hg summary

  parent: 2:db815d6d32e6 tip

   2

  branch: default

  commit: (clean)

  update: 1 new changesets, 2 branch heads (merge)

  phases: 3 draft (draft)

backout with merge

  $ cd ..

  $ hg init merge

  $ cd merge

  $ echo line 1 > a

  $ echo line 2 >> a

  $ hg commit -d '0 0' -A -m a

  adding a

  $ hg summary

  parent: 0:59395513a13a tip

   a

  branch: default

  commit: (clean)

  update: (current)

  phases: 1 draft (draft)

remove line 1

  $ echo line 2 > a

  $ hg commit -d '1 0' -m b

  $ echo line 3 >> a

  $ hg commit -d '2 0' -m c

  $ hg backout --merge -d '3 0' 1 --tool=true

  reverting a

  created new head

  changeset 3:26b8ccb9ad91 backs out changeset 1:5a50a024c182

  merging with changeset 3:26b8ccb9ad91

  merging a

  0 files updated, 1 files merged, 0 files removed, 0 files unresolved

  (branch merge, don't forget to commit)

  $ hg commit -d '4 0' -m d

  $ hg summary

  parent: 4:c7df5e0b9c09 tip

   d

  branch: default

  commit: (clean)

  update: (current)

  phases: 5 draft (draft)

check line 1 is back

  $ cat a

  line 1

  line 2

  line 3

  $ cd ..

backout should not back out subsequent changesets

  $ hg init onecs

  $ cd onecs

  $ echo 1 > a

  $ hg commit -d '0 0' -A -m a

  adding a

  $ echo 2 >> a

  $ hg commit -d '1 0' -m b

  $ echo 1 > b

  $ hg commit -d '2 0' -A -m c

  adding b

  $ hg summary

  parent: 2:882396649954 tip

   c

  branch: default

  commit: (clean)

  update: (current)

  phases: 3 draft (draft)

without --merge

  $ hg backout -d '3 0' 1 --tool=true

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  changeset 22bca4c721e5 backed out, don't forget to commit.

  $ hg locate b

  b

  $ hg update -C tip

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg locate b

  b

  $ hg summary

  parent: 2:882396649954 tip

   c

  branch: default

  commit: (clean)

  update: (current)

  phases: 3 draft (draft)

with --merge

  $ hg backout --merge -d '3 0' 1 --tool=true

  reverting a

  created new head

  changeset 3:3202beb76721 backs out changeset 1:22bca4c721e5

  merging with changeset 3:3202beb76721

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  (branch merge, don't forget to commit)

  $ hg locate b

  b

  $ hg update -C tip

  1 files updated, 0 files merged, 1 files removed, 0 files unresolved

  $ hg locate b

  [1]

  $ cd ..

  $ hg init m

  $ cd m

  $ echo a > a

  $ hg commit -d '0 0' -A -m a

  adding a

  $ echo b > b

  $ hg commit -d '1 0' -A -m b

  adding b

  $ echo c > c

  $ hg commit -d '2 0' -A -m b

  adding c

  $ hg update 1

  0 files updated, 0 files merged, 1 files removed, 0 files unresolved

  $ echo d > d

  $ hg commit -d '3 0' -A -m c

  adding d

  created new head

  $ hg merge 2

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  (branch merge, don't forget to commit)

  $ hg commit -d '4 0' -A -m d

  $ hg summary

  parent: 4:b2f3bb92043e tip

   d

  branch: default

  commit: (clean)

  update: (current)

  phases: 5 draft (draft)

backout of merge should fail

  $ hg backout 4

  abort: cannot backout a merge changeset

  [255]

backout of merge with bad parent should fail

  $ hg backout --parent 0 4

  abort: cb9a9f314b8b is not a parent of b2f3bb92043e

  [255]

backout of non-merge with parent should fail

  $ hg backout --parent 0 3

  abort: cannot use --parent on non-merge changeset

  [255]

backout with valid parent should be ok

  $ hg backout -d '5 0' --parent 2 4 --tool=true

  removing d

  changeset 5:10e5328c8435 backs out changeset 4:b2f3bb92043e

  $ hg summary

  parent: 5:10e5328c8435 tip

   Backed out changeset b2f3bb92043e

  branch: default

  commit: (clean)

  update: (current)

  phases: 6 draft (draft)

  $ hg rollback

  repository tip rolled back to revision 4 (undo commit)

  working directory now based on revision 4

  $ hg update -C

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg summary

  parent: 4:b2f3bb92043e tip

   d

  branch: default

  commit: (clean)

  update: (current)

  phases: 5 draft (draft)

  $ hg backout -d '6 0' --parent 3 4 --tool=true

  removing c

  changeset 5:033590168430 backs out changeset 4:b2f3bb92043e

  $ hg summary

  parent: 5:033590168430 tip

   Backed out changeset b2f3bb92043e

  branch: default

  commit: (clean)

  update: (current)

  phases: 6 draft (draft)

  $ cd ..

named branches

  $ hg init named_branches

  $ cd named_branches

  $ echo default > default

  $ hg ci -d '0 0' -Am default

  adding default

  $ hg branch branch1

  marked working directory as branch branch1

  (branches are permanent and global, did you want a bookmark?)

  $ echo branch1 > file1