Package: debian-policy Version: 3.7.2.2 Severity: minor Hi! While reading the Debian policy I found some minor things I'd like to see improved. I'm refering to the PDF dated 2006-10-02, so page numbers might be slightly inaccurate, please bear with me. - Page 8, 2.5 Priorities, Paragraph on "required": s/Removing an required/Removing a required/ - Page 9, 2.5 Priorities, Paragraph on "extra": This is not too nice read, I'd suggest the following wording: extra For one, this contains all packages that conflict with others of priority required, important, standard or optional. Furthermore it is used for packages that are only likely to be useful if you already know what they are or packages that have specialized requirements. - Page 39, 6.1, second paragraph: ... and must not be not world-writable; either this is a major error as it means that the files _must be_ world-writable, or it should be reworded to must be world-writable. Then it would deserve some explanation because usually one would never want world-writable scripts. - Page 39, 6.1, third paragraph, first line: ... exit status from these scripts. ... should read ... exit status of these scripts. ... - Page 39, 6.1, fourth paragraph: ... (this is usually true when writing shell scripts, in fact). - This is the Debian policy, I think this is not the point for giving general advice (or even opinions of the authors, even though I do agree here). Rather, the reader should be referred to 10.4, Scripts, where this is discussed appropriately. - Page 40, 6.1, first paragraph of page 40: ... These considerations really apply to all shell scripts. - Again, this is the Debian policy, not the point for general advice, refer to 10.4. - Page 40, 6.2, heading: Maintainer scripts Idempotency - idempotency should be lowercase here. - Page 40, 6.3: ... redirected into a pipe for ... ; this should be ... redirected to a pipe for ... - Page 40, 64: ... system looks for the exit status ... ; this should be ... system looks at the exit status ... - Page 41, 6.6, 1, 2: ... If this does not work, the error unwind: -- so - what, there seems to be some part of the sentence missing. Ok, finally, that's it for now. If some of my points are valid, minor may not be an appropriate severity anymore... Best regards, Michael
Attachment:
pgpzG9NQAkWpL.pgp
Description: PGP signature