From 804bfec6be70bf9198938c3f87792aaabe3b4426 Mon Sep 17 00:00:00 2001 From: Ian Jackson Date: Wed, 24 Jan 2018 23:46:33 +0000 Subject: [PATCH 1/1] dgit(7): Discuss git-unrepresentable properties of source trees. Signed-off-by: Ian Jackson --- debian/changelog | 1 + dgit.7 | 11 +++++++++++ 2 files changed, 12 insertions(+) diff --git a/debian/changelog b/debian/changelog index c32ba467..694743ff 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 ca115352..7ad5abae 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 -- 2.30.2