dgit(7): Discuss git-unrepresentable properties of source trees.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/debian/changelog b/debian/changelog
index c32ba467bf372aa2bf106927e0c92ae13ac3ddff..694743ff0deef4aabf0ef23e95e0844788c0729c 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,7 @@ dgit (4.3~) unstable; urgency=medium
 
   Documentation improvements:
   * dgit(7): Discuss file executability.
 
   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.
 
   Bugfixes:
   * dgit archive-api-query: Avoid crashing due to lack of $isuite.

diff --git a/dgit.7 b/dgit.7
index ca1153522b5bce81e7b32166a76b52123ba4041e..7ad5abaee9446462544d85cdd3fb89452783a3d8 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).
 (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
 .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