diff options
authorIan Jackson <>2018-01-24 23:46:33 +0000
committerIan Jackson <>2018-01-24 23:46:37 +0000
commit804bfec6be70bf9198938c3f87792aaabe3b4426 (patch)
parent6e65361c03015f933a393ad8667c0fb0dd0b6adf (diff)
dgit(7): Discuss git-unrepresentable properties of source trees.
Signed-off-by: Ian Jackson <>
2 files changed, 12 insertions, 0 deletions
diff --git a/debian/changelog b/debian/changelog
index c32ba46..694743f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,7 @@ dgit (4.3~) unstable; urgency=medium
Documentation improvements:
* dgit(7): Discuss file executability.
+ * dgit(7): Discuss git-unrepresentable properties of source trees.
* dgit archive-api-query: Avoid crashing due to lack of $isuite.
diff --git a/dgit.7 b/dgit.7
index ca11535..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