[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#845715: debian-policy: Please document that packages are not allowed to write outside their source directories



Hi Adam,

thanks for having a look and your comments!

Quoting Adam D. Barratt (2016-11-26 09:40:17)
> On Sat, 2016-11-26 at 03:34 +0000, Johannes Schauer wrote:
> > +         None of the required targets must attempt to write outside of the
> 
> You either mean "The required targets must not attempt" or "None of the
> required targets may attempt"; the current wording means "None of the
> required targets is required to attempt".
> 
> Based on confusion I've seen before from non-native speakers regarding
> the use of "may" in such constructions (despite being perfectly
> reasonable English), I'd suggest the former wording.

I do not understand why what I wrote is equal to your third version above.
Could you elaborate? I was not able to find the reason myself.

I also prefer your first alternative.

> > +         source package package directory tree. An exception to this rule is
> > +         the use of <file>/tmp</file> which is permitted as long as temporary
> > +         files are deleted and not re-used by subsequent execution of the
> > +         target. This is to prevent that source package builds create and
> > +         depend on state from the outside and thus affect multiple independent
> 
> "This restriction is intended to prevent source package builds creating
> or depending on state outside of themselves and thus ..."?
> 
> > +         rebuilds. Most notably, none of the required targets must attempt to
> > +         write into <file>$HOME</file>.
> 
> This wants re-wording similarly to the first sentence.

Then how about this version:

The required targets must not attempt to write outside of the source package
package directory tree. An exception to this rule is the use of
<file>/tmp</file> which is permitted as long as temporary files are deleted and
not re-used by subsequent execution of the target. This restriction is intended
to prevent that source package builds creating and depending on state outside
of themselves and thus affect multiple independent rebuilds. Most notably, the
required targets must not attempt to write into <file>$HOME</file>.

Thanks!

cheers, josch

Attachment: signature.asc
Description: signature


Reply to: