=back
+=head1 EDITING THE DEBIAN PACKAGING
+
+Just make commits on master that change the contents of I<debian/>.
+
=head1 EDITING THE DELTA QUEUE
=head2 Adding new patches
=over 4
- % git debrebase
+ % git debrebase -i
=back
Note that each time you conclude 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 delta queue that you think will be
-needed for this upload in a single debrebase, so that there is a
-single debrebase stitch.
+needed for this editing session in a single debrebase, so that there
+is a single debrebase stitch.
=head1 BUILDING AND UPLOADING
=over 4
- % git debrebase launder
+ % git debrebase
% dgit push-source
=back
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
-from the delta queue.
+your patches. A debrebase can be used to strip both the patch and the
+reversion from the delta queue.
=head2 Manually applying the debdiff
Above we noted that each time you conclude a debrebase, you introduce
a pseudomerge into your git history, which may make it harder to read.
-A convention you can use to minimise the number of pseudomerges is to
-debrebase only right before you upload.
+A simple convention you can use to minimise the number of pseudomerges
+is to B<git debrebase conclude> only right before you upload or push
+to B<salsa.debian.org>.
-Before that point, instead of editing the existing delta queue, you
+It is possible to reduce the number of pseudomerges further by
+derebasing only (i) when importing a new release, and (ii) right
+before uploading. 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
+upstream source to the required state. You can push and pull to and
from B<salsa.debian.org> during this. Just before uploading, you
debrebase, once, to tidy everything up.
than any branches, except temporary branches used to prepare patches
for forwarding upstream, for example.
-The thought behind this is that branches are things to which one
-expects to commit, while tags are immutable points in history. From
-the Debian point of the view, the upstream source is immutable. It's
-our packaging to which we expect to commit.
+The thought behind this is that from Debian's point of view, upstream
+releases are immutable points in history, better represented by tags.
=head2 The first ever dgit push
=head2 Alternative ways to start a debrebase
Above we started an interactive debrebase by invoking git-debrebase(1)
-without any arguments, i.e.
+like this:
=over 4
- % git debrebase
+ % git debrebase -i
=back
=back
If you take this approach, you should be very careful not to start the
-rebase earlier than the beginning of the delta queue.
+rebase too early.
=head1 SEE ALSO