The following commit has been merged in the sid branch:
commit 16e3b71283d53f56774e1aaceb567f898dc1389c
Author: Joey Hess <jo...@debian.org>
Date: Tue Aug 17 17:00:44 2010 -0400
dpkg-source(1): Improve git format documentation
Based-on-patch-by: Tanguy Ortolo
Signed-off-by: Guillem Jover <guil...@debian.org>
diff --git a/debian/changelog b/debian/changelog
index dd90e42..2bfbdb4 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,8 @@ dpkg (1.15.8.5) UNRELEASED; urgency=low
* Do not print a warning when parsing status or status log files on
half-installed packages w/o a Description or Maintainer field, as
this happens normally when the package was never installed before.
+ * Improve git format documentation in dpkg-source(1).
+ Thanks to Joey Hess, based on a patch by Tanguy Ortolo.
-- Guillem Jover <guil...@debian.org> Sat, 21 Aug 2010 08:09:39 +0200
diff --git a/man/dpkg-source.1 b/man/dpkg-source.1
index 3d87bc5..69b84fe 100644
--- a/man/dpkg-source.1
+++ b/man/dpkg-source.1
@@ -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.
+.PP
+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
+git clone.
.PP
.B Extracting
.PP
-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.
.PP
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
--
dpkg's main repository
--
To UNSUBSCRIBE, email to debian-dpkg-cvs-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
