chiark / gitweb /
dgit(7): Discuss git-unrepresentable properties of source trees.
authorIan Jackson <ijackson@chiark.greenend.org.uk>
Wed, 24 Jan 2018 23:46:33 +0000 (23:46 +0000)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Wed, 24 Jan 2018 23:46:37 +0000 (23:46 +0000)
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
debian/changelog
dgit.7

index c32ba46..694743f 100644 (file)
@@ -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 (file)
--- 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