[PATCH] improve dpkg-source documentation of git format
Based on a patch by Tanguy Ortolo.
man/dpkg-source.1 | 12 +++++++++---
1 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/man/dpkg-source.1 b/man/dpkg-source.1
index 3d87bc5..69b84fe 100644
@@ -555,12 +555,18 @@ The generated .dsc file will contain this value in its \fIFormat\fP field
and not "3.0 (custom)".
.SS Format: 3.0 (git)
-This format is experimental. It uses a bundle of a git repository to hold
-the source of a package.
+This format is experimental.
+A source package in this format consists of a
+single bundle of a git repository \fB.git\fP to hold the source of a package.
+There may also be a \fB.gitshallow\fP file listing revisions for a shallow
-The bundle is cloned to a new git repository.
+The bundle is cloned as a git repository to the target directory.
+If there is a gitshallow file, it is installed as `.git/shallow` inside
+the cloned git repository.
Note that by default the new repository will have the same branch checked
out that was checked out in the original source. (Typically "master", but
see shy jo