Forbid dpkg-divert --local in package maintainer scripts

State that package maintainer scripts must use --package and must
not use --local when invoking dpkg-divert.

diff --git a/policy.sgml b/policy.sgml
index 9fe7158f215f5fe8381f4aac8be87aa9f430be25..587a6b29be5bf8bb5aaa89d81c7f6d2df25650ae 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -1214,9 +1214,11 @@
        </p>
 
        <p>
-         You should not use <prgn>dpkg-divert</prgn> on a file
-         belonging to another package without consulting the
-         maintainer of that package first.
+         You should not use <prgn>dpkg-divert</prgn> on a file belonging
+         to another package without consulting the maintainer of that
+         package first.  Package maintainer scripts must provide
+         the <tt>--package</tt> flag to <prgn>dpkg-divert</prgn> and must
+         not use <tt>--local</tt>.
        </p>
 
        <p>