Bug#563425: debian-policy: please clarify the second footnote of section 10.9.
Raphael Geissert <geissert@debian.org> writes:
> 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.
Thanks! Since dpkg-statoverride is documented for use in package
maintainer scripts only in the specific case of needing to change
ownership of a file to a dynamically created user or group, and since in
that case there's no particular need for special documentation, I dropped
the whole sentence for the next Policy release.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: