chiark / gitweb /
git-debrebase: Rename new-upstream-v0 command to new-upstream
authorIan Jackson <ijackson@chiark.greenend.org.uk>
Sun, 17 Jun 2018 22:22:23 +0000 (23:22 +0100)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Sun, 17 Jun 2018 22:22:24 +0000 (23:22 +0100)
This UI is pretty good now, I think, for single-piece upstreams.

For multi-piece ones, which are quite tricky anyway, it is tolerable,
and we it doesn't steal much of the available syntax space.  So we
don't need the -v0 any more.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
NOTES.git-debrebase
dgit-maint-debrebase.7.pod
git-debrebase
git-debrebase.1.pod
tests/tests/gdr-newupstream-v0

index f32cf87..f87718b 100644 (file)
@@ -40,7 +40,7 @@ workflow
 #  * Workflow is currently clumsy.  Lots of spurious runes to type.
 #    There's not even a guide.
 #
-#  * new-upstream-v0 has a terrible UI for multiple upstream pieces.
+#  * new-upstream has an awkward UI for multiple upstream pieces.
 #    You end up with giant runic command lines.  Does this matter /
 #    One consequence of the lack of richness it can need -f in
 #    fairly sensible situations.
index 5ae921f..e492768 100644 (file)
@@ -323,7 +323,7 @@ or if you have a working watch file
 
 =over 4
 
-    % git debrebase new-upstream-v0 1.2.3
+    % git debrebase new-upstream 1.2.3
 
 =back
 
index 216d7df..9e8d707 100755 (executable)
@@ -1129,7 +1129,7 @@ sub do_stitch ($;$) {
     stitch($dangling_head, $ffq_prev, $gdrlast, $ffq_prev_commitish, $prose);
 }
 
-sub cmd_new_upstream_v0 () {
+sub cmd_new_upstream () {
     # automatically and unconditionally launders before rebasing
     # if rebase --abort is used, laundering has still been done
 
index 6a98ed2..6168e14 100644 (file)
@@ -100,7 +100,7 @@ If there is no ffq-prev, it is an error, unless --noop-ok.
 You should consider using B<conclude> instead,
 because that launders the branch too.
 
-=item git-debrebase new-upstream-v0 <new-version> [<upstream-details>...]
+=item git-debrebase new-upstream <new-version> [<upstream-details>...]
 
 Rebases the delta queue
 onto a new upstream version.  In detail:
@@ -199,11 +199,6 @@ L<git-deborig(1)>,
 L<git-archive(1)>, L<dgit(1)> and
 L<gbp-import-orig(1)> may be able to help.
 
-This subcommand has -v0 in its name because we are not yet sure
-that its command line syntax is optimal.
-We may want to introduce an incompatible replacement syntax
-under the name C<new-upstream>.
-
 =item git-debrebase make-patches [--quiet-would-amend]
 
 Generate patches in debian/patches/
index e866edc..536f49c 100755 (executable)
@@ -31,11 +31,11 @@ v=2.1-1
 git checkout master
 
 t-expect-fail F:'Could not determine appropriate upstream commitish' \
-t-git-debrebase new-upstream-v0 $v
+t-git-debrebase new-upstream $v
 
 git tag v2.1 upstream
 
-t-git-debrebase new-upstream-v0 $v
+t-git-debrebase new-upstream $v
 t-gdr-good laundered
 
 t-git-debrebase stitch
@@ -54,7 +54,7 @@ anchor=$(perl <../anal.anch -ne '
        exit;
 ')
 
-t-git-debrebase --anchor=$anchor -fanchor-treated new-upstream-v0 $v upstream
+t-git-debrebase --anchor=$anchor -fanchor-treated new-upstream $v upstream
 t-gdr-good laundered
 
 t-git-debrebase stitch