X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=policy.sgml;h=27082429c81303e3bdc0c51c2ac2c38e2892eff1;hb=c3b208f5570c071ee42b91586ce3d6664256e6f5;hp=1508231e766f36edcd722f7d0af2151a8e80f204;hpb=1224a530a4f1846cef54de1499f1b035b1298a2d;p=debian%2Fdebian-policy.git

diff --git a/policy.sgml b/policy.sgml
index 1508231..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>
@@ -8853,7 +8874,9 @@ ln -fs ../sbin/sendmail debian/tmp/usr/bin/runq
 	</p>
 
 	<p>
-	  A symbolic link pointing to a compressed file should always
+	  A symbolic link pointing to a compressed file (in the sense
+	  that it is meant to be uncompressed with <prgn>unzip</prgn>
+	  or <prgn>zless</prgn> etc.) should always
 	  have the same file extension as the referenced file. (For
 	  example, if a file <file>foo.gz</file> is referenced by a
 	  symbolic link, the filename of the link has to end with
@@ -9471,6 +9494,23 @@ done
 	  </p>
 	</sect1>
       </sect>
+
+      <sect id="filenames">
+	<heading>File names</heading>
+
+        <p>
+	  The name of the files installed by binary packages in the system PATH
+	  (namely <tt>/bin</tt>, <tt>/sbin</tt>, <tt>/usr/bin</tt>,
+	  <tt>/usr/sbin</tt> and <tt>/usr/games</tt>) must be encoded in
+	  ASCII.
+	</p>
+
+	<p>
+	  The name of the files and directories installed by binary packages
+	  outside the system PATH must be encoded in UTF-8 and should be
+	  restricted to ASCII when it is possible to do so.
+	</p>
+      </sect>
     </chapt>
 
 
@@ -9669,24 +9709,7 @@ http://localhost/cgi-bin/<var>cgi-bin-name</var>
 	    </item>
 
 	    <item>
-	      <p>Access to HTML documents</p>
-
-	      <p>
-		HTML documents for a package are stored in
-                <file>/usr/share/doc/<var>package</var></file>
-		and can be referred to as
-		<example compact="compact">
-http://localhost/doc/<var>package</var>/<var>filename</var>
-		</example>
-	      </p>
-
-	      <p>
-                The web server should restrict access to the document
-                tree so that only clients on the same host can read
-                the documents. If the web server does not support such
-                access controls, then it should not provide access at
-                all, or ask about providing access during installation.
-	      </p>
+	      <p>(Deleted)</p>
 	    </item>
 
             <item>