summaryrefslogtreecommitdiff
path: root/git-debrebase.1.pod
diff options
context:
space:
mode:
authorSean Whitton <spwhitton@spwhitton.name>2018-11-17 11:00:54 -0700
committerSean Whitton <spwhitton@spwhitton.name>2018-11-17 11:00:54 -0700
commitfde00691054302b53783d14880ef015e8f81758b (patch)
tree323aae3f069791b9b9966ffdbf8fe3f5fc979cd6 /git-debrebase.1.pod
parent43faee259ac0418b98f0c973a794c21f47c9d1c1 (diff)
parentbfb113c41cdc9bc875cec6f1c24f930e664e853e (diff)
Merge tag 'debian/8.1' into stretch-bpo
dgit release 8.1 for unstable (sid) [dgit] [dgit distro=debian] # gpg: Signature made Wed 07 Nov 2018 07:11:36 PM MST # gpg: using RSA key 559AE46C2D6B6D3265E7CBA1E3E3392348B50D39 # gpg: Can't check signature: No public key
Diffstat (limited to 'git-debrebase.1.pod')
-rw-r--r--git-debrebase.1.pod37
1 files changed, 29 insertions, 8 deletions
diff --git a/git-debrebase.1.pod b/git-debrebase.1.pod
index 04a57ee..00b664b 100644
--- a/git-debrebase.1.pod
+++ b/git-debrebase.1.pod
@@ -254,18 +254,39 @@ If the problem is simply that
the existing patches were not made by git-debrebase,
using dgit quilt-fixup instead should succeed.
+=item git-debrebase convert-from-unapplied [<upstream-commit-ish>]
+
=item git-debrebase convert-from-gbp [<upstream-commit-ish>]
-Cnnverts a gbp patches-unapplied branch
-(not a gbp pq patch queue branch)
-into a git-debrebase interchange branch.
+Cnnverts any of the following into a git-debrebase interchange branch:
+
+=over
+
+=item
+
+a gbp patches-unapplied branch (but not a gbp pq patch-queue branch)
+
+=item
+
+a patches-unapplied git packaging branch containing debian/patches,
+as used with quilt
+
+=item
+
+a git branch for a package which has no Debian delta -
+ie where upstream files are have not been modified in Debian,
+so there are no patches
+
+=back
+
+(These two commands operate identically and are simply aliases.)
-This is done by generating a new anchor merge,
-converting the quilt patches as a delta queue,
+The conversion is done by generating a new anchor merge,
+converting any quilt patches as a delta queue,
and dropping the patches from the tree.
The upstream commit-ish should correspond to
-the gbp upstream branch, if there is one.
+the upstream branch or tag, if there is one.
It is a snag if it is not an ancestor of HEAD,
or if the history between the upstream and HEAD
contains commits which make changes to upstream files.
@@ -284,14 +305,14 @@ and if it finds it will make a pseduomerge so that
your new git-debrebase view is appropriately fast forward.
The result is a well-formed git-debrebase interchange branch.
-The result is also fast-forward from the gbp branch.
+The result is also fast-forward from the original branch.
It is a snag if the new branch looks like it will have diverged,
just as for a laundering/unstitching call to git-debrebase;
See L</Establish the current branch's ffq-prev>, below.
Note that it is dangerous not to know whether you are
-dealing with a gbp patches-unapplied branch containing quilt patches,
+dealing with a (gbp) patches-unapplied branch containing quilt patches,
or a git-debrebase interchange branch.
At worst,
using the wrong tool for the branch format might result in