Bug#563425: debian-policy: please clarify the second footnote of section 10.9.

[Raphael Geissert <geissert@debian.org>]

Package: debian-policy
Version: 3.8.3.0
Severity: minor

Hi,

The second footnote reads:
> [2]  Ordinary files installed by `dpkg' (as opposed to `conffile's and
>      other similar objects) normally have their permissions reset to the
>      distributed permissions when the package is reinstalled.  However, the
>      use of `dpkg-statoverride' overrides this default behavior.  If *you*
>      use _this_ method, you should remember to describe `dpkg-statoverride'
>      in the package documentation; being a relatively new addition to
>      Debian, it is probably not yet well-known.

Since dpkg-statoverride is meant to be used by the system owner I don't see 
how that last sentence makes sense.

I see two options:
a) Drop the sentence.
b) Replace "this method" with something like "special permissions."

The "being a relatively new addition to Debian, it is probably not yet 
well-known." part should also be dropped as dpkg-statoverride dates back to 
year 2000.

Cheers,
-- 
Raphael Geissert - Debian Developer
www.debian.org - get.debian.net