summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIan Jackson <ijackson@chiark.greenend.org.uk>2018-01-24 23:46:33 +0000
committerIan Jackson <ijackson@chiark.greenend.org.uk>2018-01-24 23:46:37 +0000
commit804bfec6be70bf9198938c3f87792aaabe3b4426 (patch)
tree979767bfa3adcde1038b421d0ff3d0f5abf6fc79
parent6e65361c03015f933a393ad8667c0fb0dd0b6adf (diff)
dgit(7): Discuss git-unrepresentable properties of source trees.
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
-rw-r--r--debian/changelog1
-rw-r--r--dgit.711
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.
Bugfixes:
* 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.
.SH READ-ONLY DISTROS
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