git-debrebase(1): Very minor clarification to "quick"

[dgit.git] / git-debrebase

diff --git a/git-debrebase b/git-debrebase
index fcca5b1ad6b0cb4bb4ee893bf7b61b8216a79bbe..00d2f575a6d29361fdc7ddf397f0e1a9be7348db 100755 (executable)
--- a/git-debrebase
+++ b/git-debrebase
@@ -396,6 +396,15 @@ sub classify ($) {
        # BreakwaterStart commits are also anchors in the terminology
        # of git-debrebase(5), but they are untagged (and always
        # manually generated).
+       #
+       # We cannot not tolerate any tagged linear commit (ie,
+       # BreakwaterStart commits tagged `[anchor:') because such a
+       # thing could result from an erroneous linearising raw git
+       # rebase of a merge anchor.  That would represent a corruption
+       # of the branch. and we want to detect and reject the results
+       # of such corruption before it makes it out anywhere.  If we
+       # reject it here then we avoid making the pseudomerge which
+       # would be needed to push it.
 
        my $badanchor = sub { $unknown->("git-debrebase \`anchor' but @_"); };
        @p == 2 or return $badanchor->("has other than two parents");
@@ -1310,10 +1319,10 @@ sub cmd_stitch () {
     do_stitch($prose);
 }
 
-sub cmd_conclude () {
+sub cmd_quick () {
     badusage "no arguments allowed" if @ARGV;
-    do_launder_head 'launder for conclude';
-    do_stitch 'conclude';
+    do_launder_head 'launder for git-debrebase quick';
+    do_stitch 'quick';
 }
 
 sub cmd_convert_from_gbp () {