chiark / gitweb /
dgit-maint-debrebase(7): patch queue -> delta queue
authorSean Whitton <spwhitton@spwhitton.name>
Tue, 3 Apr 2018 17:28:21 +0000 (10:28 -0700)
committerSean Whitton <spwhitton@spwhitton.name>
Thu, 19 Apr 2018 16:43:44 +0000 (09:43 -0700)
For consistency with git-debrebase(5).

Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
dgit-maint-debrebase.7.pod

index 63b964131660d3aacb819a28ef3e940d01711164..f46944fe53cb646ef3b68a059e0f1ea23884b5f5 100644 (file)
@@ -17,7 +17,7 @@ Some advantages of this workflow:
 
 =item
 
 
 =item
 
-Manipulate the patch queue using the full power of git-rebase(1),
+Manipulate the delta queue using the full power of git-rebase(1),
 instead of relying on quilt(1), and without having to switch back and
 forth between patches-applied and patches-unapplied branches when
 committing changes and trying to build, as with gbp-pq(1).
 instead of relying on quilt(1), and without having to switch back and
 forth between patches-applied and patches-unapplied branches when
 committing changes and trying to build, as with gbp-pq(1).
@@ -94,11 +94,11 @@ something like this:
 
 Now go ahead and Debianise your package.  Just make commits on the
 master branch, adding things in the I<debian/> directory.  If you need
 
 Now go ahead and Debianise your package.  Just make commits on the
 master branch, adding things in the I<debian/> directory.  If you need
-to patch the upstream source, see "EDITING THE PATCH QUEUE", below.
+to patch the upstream source, see "EDITING THE DELTA QUEUE", below.
 Note that there is no need to maintain a separate 'upstream' branch,
 unless you also happen to be involved in upstream development.  We
 Note that there is no need to maintain a separate 'upstream' branch,
 unless you also happen to be involved in upstream development.  We
-work with upstream tags rather than any branches, except when
-forwarding patches (see FORWARDING PATCHES UPSTREAM, below).
+work with upstream tags rather than any branches, except temporary
+branches used to prepare patches for forwarding upstream, for example.
 
 Finally, you need an orig tarball:
 
 
 Finally, you need an orig tarball:
 
@@ -338,7 +338,7 @@ a tarball:
 
 =back
 
 
 =back
 
-=head1 EDITING THE PATCH QUEUE
+=head1 EDITING THE DELTA QUEUE
 
 =head2 Adding new patches
 
 
 =head2 Adding new patches
 
@@ -379,7 +379,7 @@ using git-rebase(1).  For example,
 =back
 
 If you take this approach, you should be very careful not to start the
 =back
 
 If you take this approach, you should be very careful not to start the
-rebase earlier than the beginning of the patch queue.
+rebase earlier than the beginning of the delta queue.
 
 =head2 Editing patches: finishing a debrebase
 
 
 =head2 Editing patches: finishing a debrebase
 
@@ -401,12 +401,12 @@ git remote such as B<salsa.debian.org>,
 
 Note that each time you stitch a debrebase you introduce a pseudomerge
 into your git history, which may make it harder to read.  Try to do
 
 Note that each time you stitch a debrebase you introduce a pseudomerge
 into your git history, which may make it harder to read.  Try to do
-all of the editing of the patch queue that you think will be needed
+all of the editing of the delta queue that you think will be needed
 for this upload in a single debrebase, so that there is a single
 debrebase stitch.
 
 A strategy is to debrebase only right before you upload.  Before that
 for this upload in a single debrebase, so that there is a single
 debrebase stitch.
 
 A strategy is to debrebase only right before you upload.  Before that
-point, instead of editing the existing patch series, you append fixup
+point, instead of editing the existing delta queue, you append fixup
 commits (and reversions of commits) that alter the upstream source to
 the required state.  You can freely push and pull from
 B<salsa.debian.org> during this.  Just before uploading, you debrebase
 commits (and reversions of commits) that alter the upstream source to
 the required state.  You can freely push and pull from
 B<salsa.debian.org> during this.  Just before uploading, you debrebase
@@ -434,10 +434,10 @@ If you want to skip dgit's checks while iterating on a problem with
 the package build (for example, you don't want to commit your changes
 to git), you can just run dpkg-buildpackage(1) or debuild(1) instead.
 
 the package build (for example, you don't want to commit your changes
 to git), you can just run dpkg-buildpackage(1) or debuild(1) instead.
 
-=head2 Laundering the patch queue before uploading
+=head2 Laundering the delta queue before uploading
 
 Just before you B<dgit push> or B<dgit push-source>, you might want to
 
 Just before you B<dgit push> or B<dgit push-source>, you might want to
-have git-debrebase(1) shuffle your branch such that the Debian patch
+have git-debrebase(1) shuffle your branch such that the Debian delta
 queue appears at the end:
 
 =over 4
 queue appears at the end:
 
 =over 4
@@ -496,7 +496,7 @@ probably want to debrebase before your next upload to tidy those up.
 
 For example, the NMUer might have used git-revert(1) to unapply one of
 your patches.  A debrebase will strip both the patch and the reversion
 
 For example, the NMUer might have used git-revert(1) to unapply one of
 your patches.  A debrebase will strip both the patch and the reversion
-from the patch series.
+from the delta queue.
 
 =head1 SEE ALSO
 
 
 =head1 SEE ALSO