From: Charles Plessy <plessy@debian.org>
Date: Sat, 24 Aug 2013 01:14:12 +0000 (+0900)
Subject: Document the Dgit field for Debian Source Control files.
X-Git-Url: https://git.donarmstrong.com/?p=debian%2Fdebian-policy.git;a=commitdiff_plain;h=c3b208f5570c071ee42b91586ce3d6664256e6f5

Document the Dgit field for Debian Source Control files.

Wording: Ian Jackson <ijackson@chiark.greenend.org.uk>
Seconded: Charles Plessy <plessy@debian.org>
Seconded: Joey Hess <joeyh@debian.org>
Seconded: Dmitrijs Ledkovs <xnox@debian.org>
Closes: #720507
---

diff --git a/policy.sgml b/policy.sgml
index 29d2a53..2708242 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -2759,6 +2759,7 @@ Package: libc6
 	  <item><qref id="f-Uploaders"><tt>Uploaders</tt></qref></item>
 	  <item><qref id="f-Homepage"><tt>Homepage</tt></qref></item>
 	  <item><qref id="f-VCS-fields"><tt>Vcs-Browser</tt>, <tt>Vcs-Git</tt>, et al.</qref></item>
+	  <item><qref id="f-Dgit"><tt>Dgit</tt></qref></item>
 	  <item><qref id="f-Standards-Version"><tt>Standards-Version</tt></qref> (recommended)</item>
 	  <item><qref id="sourcebinarydeps"><tt>Build-Depends</tt> et al</qref></item>
 	  <item><qref id="f-Package-List"><tt>Package-List</tt></qref> (recommended)</item>
@@ -3840,6 +3841,26 @@ Checksums-Sha256:
 	    this value is assumed for paragraphs lacking this field.
 	  </p>
 	</sect1>
+
+	<sect1 id="f-Dgit">
+	  <heading><tt>Dgit</tt></heading>
+
+	  <p>
+	    Folded field containing a single git commit hash, presented in
+	    full, followed optionally by whitespace and other data to be
+	    defined in future extensions.
+	  </p>
+
+	  <p>
+	    Declares that the source package corresponds exactly to a
+	    referenced commit in a Git repository available at the canonical
+	    location called <em>dgit-repos</em>, used by <prgn>dgit</prgn>, a
+	    bidirectional gateway between the Debian archive and Git.  The
+	    commit is reachable from at least one reference whose name matches
+	    <tt>refs/dgit/*</tt>.  See the manual page of <prgn>dgit</prgn> for
+	    further details.
+	  </p>
+	</sect1>
       </sect>
 
       <sect>