Bug#218897: Explicitily disallow adding local diversion by package

[Raphael Geissert <geissert@debian.org>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Russ Allbery wrote:
> diff --git a/policy.sgml b/policy.sgml
> index 9fe7158..587a6b2 100644
> --- 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>
>  

I think it should be more clear and mention that --package must be used when 
adding or removing diversions. --list{,name} and --truename don't require  
- --package.

Cheers,
- -- 
Raphael Geissert - Debian Developer
www.debian.org - get.debian.net
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)

iEYEARECAAYFAkwr2bIACgkQYy49rUbZzlo46gCfdtsXBUuwpJvp8agRxyPfM7fP
yHkAoI/O1T9kw8tKIl3PA6CrPrWb7SD3
=8pul
-----END PGP SIGNATURE-----