diff options
authorSean Whitton <>2018-01-27 09:13:38 -0700
committerSean Whitton <>2018-01-27 09:13:38 -0700
commit1c974dcb26adc967020b5aaa77de14724fad834b (patch)
parent720e6334db6f619765cf037eb8517b165e77e80f (diff)
parent4210fa385422c0c5c35f9285410d734d9442430b (diff)
Merge tag 'debian/4.3' into dgit/stretch-backports
dgit release 4.3 for unstable (sid) [dgit] [dgit distro=debian]
4 files changed, 47 insertions, 3 deletions
diff --git a/debian/changelog b/debian/changelog
index 8ff1708..650b058 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,17 @@
+dgit (4.3) unstable; urgency=high
+ Documentation improvements:
+ * dgit(7): Discuss file executability. Closes:#886444.
+ * dgit(7): Discuss git-unrepresentable properties of source trees.
+ * dgit-maint-merge(7): Don't suggest using debian/source/patch-header
+ for 1.0 source format. Closes:#887850. [Sean Whitton]
+ Bugfixes:
+ * dgit archive-api-query: Avoid crashing due to lack of $isuite.
+ This breaks the infrastructure. Closes:#886592.
+ -- Ian Jackson <> Thu, 25 Jan 2018 00:33:56 +0000
dgit (4.2~bpo9+1) stretch-backports; urgency=medium
* Rebuild for stretch-backports.
diff --git a/dgit b/dgit
index e86e398..27dcf1c 100755
--- a/dgit
+++ b/dgit
@@ -6456,6 +6456,7 @@ sub pre_archive_api_query () {
sub cmd_archive_api_query {
badusage "need only 1 subpath argument" unless @ARGV==1;
my ($subpath) = @ARGV;
+ local $isuite = 'DGIT-API-QUERY-CMD';
my @cmd = archive_api_query_cmd($subpath);
push @cmd, qw(-f);
debugcmd ">",@cmd;
diff --git a/dgit-maint-merge.7.pod b/dgit-maint-merge.7.pod
index 0040604..2674d66 100644
--- a/dgit-maint-merge.7.pod
+++ b/dgit-maint-merge.7.pod
@@ -300,9 +300,14 @@ A single combined diff, containing all the changes, follows.
-Alternatively, this text could be added to README.source. However,
-this might distract from more important information present in the
-latter file.
+If you are using the version 1.0 source package format, this text
+should be added to README.source instead. The version 1.0 source
+package format ignores debian/source/patch-header.
+If you're using the version 3.0 (quilt) source package format, you
+could add this text to README.source instead of
+debian/source/patch-header, but this might distract from more
+important information present in README.source.
diff --git a/dgit.7 b/dgit.7
index 70165a1..7ad5aba 100644
--- a/dgit.7
+++ b/dgit.7
@@ -197,6 +197,17 @@ import existing vcs history
(which might not be faithful to dgit's invariants)
or previous non-Dgit uploads
(which would not provide a very rich history).
+git represents only file executability.
+git does not represent empty directories,
+or any leaf objects other than plain files and symlinks.
+The behaviour of Debian source package formats
+on objects with unusual permissions is complicated.
+Some pathological Debian source packages will no longer build
+if empty directories are pruned
+(or if other things not reproduced by git are changed).
+Such sources cannot be worked with properly in git,
+and therefore not with dgit either.
Distros which do not maintain a set of dgit history git repositories
can still be used in a read-only mode with dgit. Currently Ubuntu
@@ -243,6 +254,19 @@ If you are not the maintainer, you do not need to worry about the
source format of the package. You can just make changes as you like
in git. If the package is a `3.0 (quilt)' package, the patch stack
will usually not be represented in the git history.
+Debian source package formats
+do not always faithfully reproduce
+changes to executability.
+But dgit insists that the result of dgit clone is identical
+(as far as git can represent - see Limitations, above)
+to the result of dpkg-source -x.
+So files that are executable in your git tree
+must be executable in the result of dpkg-source -x
+(but often aren't).
+If a package has such troublesome files,
+they have to be non-executable in dgit-compatible git branches.
For a format `3.0 (quilt)' source package, dgit may have to make a
commit on your current branch to contain metadata used by quilt and