X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=policy.sgml;h=56782145e358644e012b1199bf1bc9a98c64993b;hb=a4a0c387c650eee2379166b785a68415e6b6e823;hp=50c0289fa7f2d682cbc40d7e5bb50c85a937323a;hpb=5da78a06d531b211ab83cc50f7e988a4f559be5b;p=debian%2Fdebian-policy.git

diff --git a/policy.sgml b/policy.sgml
index 50c0289..5678214 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -1330,9 +1330,9 @@ zope.
 	  The package installation scripts should avoid producing
 	  output which is unnecessary for the user to see and
 	  should rely on <prgn>dpkg</prgn> to stave off boredom on
-	  the part of a user installing many packages.  This means,
-	  amongst other things, using the <tt>--quiet</tt> option on
-	  <prgn>install-info</prgn>.
+	  the part of a user installing many packages. This means,
+	  amongst other things, not passing the <tt>--verbose</tt>
+	  option to <prgn>update-alternatives</prgn>.
 	</p>
 
 	<p>
@@ -3969,8 +3969,7 @@ Checksums-Sha256:
 	  Programs called from maintainer scripts should not normally
 	  have a path prepended to them. Before installation is
 	  started, the package management system checks to see if the
-	  programs <prgn>ldconfig</prgn>,
-	  <prgn>start-stop-daemon</prgn>, <prgn>install-info</prgn>,
+	  programs <prgn>ldconfig</prgn>, <prgn>start-stop-daemon</prgn>,
 	  and <prgn>update-rc.d</prgn> can be found via the
 	  <tt>PATH</tt> environment variable. Those programs, and any
 	  other program that one would expect to be in the
@@ -10497,18 +10496,23 @@ name ["<var>syshostname</var>"]:
 
 	<p>
 	  The <prgn>install-info</prgn> program maintains a directory of
-	  installed info documents in <file>/usr/share/info/dir</file> for
-	  the use of info readers.<footnote>
-	    It was previously necessary for packages installing info
-	    documents to run <prgn>install-info</prgn> from maintainer
-	    scripts.  This is no longer necessary.  The installation
-	    system now uses dpkg triggers.
-	  </footnote>
-	  This file must not be included in packages.  Packages containing
-	  info documents should depend on <tt>dpkg (>= 1.15.4) |
-	  install-info</tt> to ensure that the directory file is properly
-	  rebuilt during partial upgrades from Debian 5.0 (lenny) and
-	  earlier.
+	  installed info documents in <file>/usr/share/info/dir</file> for the
+	  use of info readers.  This file must not be included in packages
+	  other than <package>install-info</package>.
+	</p>
+
+	<p>
+	  <prgn>install-info</prgn> is automatically invoked when
+	  appropriate using dpkg triggers.  Packages other than
+	  <package>install-info</package> <em>should not</em> invoke
+	  <prgn>install-info</prgn> directly and <em>should not</em>
+	  depend on, recommend, or suggest <package>install-info</package>
+	  for this purpose.
+	</p>
+
+	<p>
+	  Info readers requiring the <file>/usr/share/info/dir</file> file
+	  should depend on <package>install-info</package>.
 	</p>
 
 	<p>
@@ -12043,6 +12047,11 @@ END-INFO-DIR-ENTRY
 	there is a time, after it has been diverted but before
 	<prgn>dpkg</prgn> has installed the new version, when the file
 	does not exist.</p>
+
+      <p>
+	Do not attempt to divert a conffile, as <prgn>dpkg</prgn> does not
+	handle it well.
+      </p>
     </appendix>
 
   </book>