X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=git-debrebase.1.pod;h=04a57ee25a5ecbb9c76d04cb407faa3c5b83beb0;hb=8381243a5f0a311bdf8ef2c8d695d7993de76a9d;hp=28f3084816064107440ab23f938091d4079269c1;hpb=b58f7c61452fc5b8b7d70f735283ecdc1b5e8ac3;p=dgit.git diff --git a/git-debrebase.1.pod b/git-debrebase.1.pod index 28f30848..04a57ee2 100644 --- a/git-debrebase.1.pod +++ b/git-debrebase.1.pod @@ -95,22 +95,30 @@ If the branch is already laundered and stitched, does nothing. =item git-debrebase prepush [--prose=] +If the branch is unstitched, +stitches it, +consuming ffq-prev. + +This is a good command to run before pushing to a git server. +You should consider using B instead, +because that launders the branch too. + =item git-debrebase stitch [--prose=] Stitches the branch, consuming ffq-prev. -This is a good command to run before pushing to a git server. If there is no ffq-prev, it is an error, unless --noop-ok. -You should consider using B instead, -because that launders the branch too. +You should consider using B or B instead. =item git-debrebase scrap Throws away all the work since the branch was last stitched. This is done by rewinding you to ffq-prev. +If you are in the middle of a git-rebase, will abort that too. + =item git-debrebase new-upstream [...] Rebases the delta queue @@ -414,6 +422,20 @@ and it should not be necessary. =back +=item git-debrebase forget-was-ever-debrebase + +Deletes the ffq-prev and debrebase-last refs +associated with this branch, +that git-debrebase and dgit use to determine +whether this branch is managed by git-debrebase, +and what previous head may need to be stitched back in. + +This can be useful if you were just playing with git-debrebase, +and have used git-reset --hard to go back to a commit +before your experiments. + +Do not use this if you expect to run git-debrebase on the branch again. + =back =head1 OPTIONS @@ -488,6 +510,17 @@ This is provided mostly for the benefit of the test suite. Requests (more) debugging. May be repeated. +=item --experimntal-merge-resolution + +Enable experimental code for handling general merges +(see L). + +This option may generate lossage of various kinds, +including misleading error messages, +references to nonexistent documentation, and +you being handed an incomprehensible pile of +multidimensional merge wreckage. + =back =head1 UNSTITCHING AND LAUNDERING