chiark / gitweb /
wip
authorIan Jackson <ijackson@chiark.greenend.org.uk>
Fri, 27 Jul 2018 04:51:03 +0000 (05:51 +0100)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Fri, 27 Jul 2018 04:51:03 +0000 (05:51 +0100)
junk [new file with mode: 0644]
talk.txt [new file with mode: 0644]
usps.md [new file with mode: 0644]

diff --git a/junk b/junk
new file mode 100644 (file)
index 0000000..6466c10
--- /dev/null
+++ b/junk
@@ -0,0 +1,32 @@
+
+git-debrebase does not do any builds.  You use your existing favourite
+build tools for that.  Nor does git-debrebase do anything to do with
+actual source packages (that is, .dsc files).  Typically, other tools
+will automatically convert your git branch into an identical source
+package, when you upload.
+
+git-debrebase does not deal with orig tarballs, either.  It is a
+purely git tool, so it consumes upstream source code in gitish form.
+Ideally, you base your work on upstream git tags, and an equivalent
+orig tarball (or one made with git-deborig).  Otherwise, you can
+import an upstream tarball with a tool gbp-import-orig.
+
+git-debrebase concentrates on managing the Debian packaging, and the
+Debian delta queue - 
+
+[usp slide]
+
+
+
+
+
+, and the Debian packaging.  - the changes you make
+in bb
+
+
+
+(When you are uploading a new upstream to Debian,
+you'll use tools like git-deborig or git-archive to generate a .orig
+corresponding to the upstream source.)
+
+
diff --git a/talk.txt b/talk.txt
new file mode 100644 (file)
index 0000000..d6c7fee
--- /dev/null
+++ b/talk.txt
@@ -0,0 +1,31 @@
+[title slide]
+
+Hi.
+
+[context slide]
+
+Sean Whitton and I are here to present a new git workflow tool for
+Debian packaging.  It's primarily intended for Debian package
+maintainers.  It's an alternative to gbp pq and to git-dpm.
+
+Before I get tell you all about it I need to show where it fits into
+the ecosystem of Debian package management software.  On this slide we
+have you, the maintainer, on the left.  On the right we have the
+Debian repositories.
+
+You may have heard me plugging dgit once or twice.  You should all use
+dgit!  dgit push publishes your git history so Debian's users can use
+it!  But, that's not actually what I am here to talk about today.
+git-debrebase does not need dgit, and dgit does not need
+git-debrebase.
+
+git-debrebase is a tool to help manage your git branch containing the
+Debian version of a package you maintain.  git-debrebase helps you
+maintain a useful git branch with the contents you need (for building
+and uploading).
+
+It maintains your Debian delta queue - that is, that is, the changes
+you make, for Debian, to the upstream parts of the package - as a
+series of commits.
+
+[usps slide]
diff --git a/usps.md b/usps.md
new file mode 100644 (file)
index 0000000..b64a695
--- /dev/null
+++ b/usps.md
@@ -0,0 +1,37 @@
+You can git commit -m fixup! and git commit -m squash!
+| always, unlike gbp pq
+
+You can git-am and git-cherry-pick upstream patches
+| always, unlike gbp pq
+
+You may make mixed commits touching debian/ and upstream files
+| unlike any other Debian delta queue workflow
+
+There is no need to ever use quilt
+
+There is no in-tree metadata to get out of date
+| unlike git-dpm
+
+Your working tree is never dirtied by your tools
+| unlike gbp pq
+
+There is no need to switch branches or switch views
+| unlike gbp pq
+
+Your working tree is always buildable, in-tree, with dpkg-buildpackage, debuild, git-buildpackage, etc.
+| unlike gbp pq
+
+You can mostly ignore the `3.0 (quilt)' source package format
+
+During development you do not need any orig tarballs;
+they are only needed when actually uploading to Debian.
+
+The Debian delta queue is managed using a standard git-rebase workflow.
+
+git-log and git-blame on upstream files show the real upstream history
+followed by your delta queue commits, as expected.
+
+git-log and git-blame on debian/ files show your packaging history.
+
+You don't need to edit diffs, or read diffs of diffs.
+Instead, you edit commits the standard git way.