X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=policy.sgml;h=d8e6efe5b6ea5327375c1ea99050e11677bbd4e1;hb=0e58a7e67c225766da50544e54459e39172d18ee;hp=4855506e6105556bc6db756e712ed4f849dcbc68;hpb=dd179b4068d028d60aa2dc78db6983ad99a6692a;p=debian%2Fdebian-policy.git diff --git a/policy.sgml b/policy.sgml index 4855506..d8e6efe 100644 --- a/policy.sgml +++ b/policy.sgml @@ -229,9 +229,8 @@ Russ Allbery Bill Allombert - Andrew McMillan - Manoj Srivastava - Colin Watson + Andreas Barth + Jonathan Nieder

@@ -1746,11 +1745,14 @@ zope.

The maintainer name and email address used in the changelog - should be the details of the person uploading this - version. They are not necessarily those of the - usual package maintainer. - If the developer uploading the package is not one of the usual - maintainers of the package (as listed in + should be the details of the person who prepared this release of + the package. They are not necessarily those of the + uploader or usual package maintainer. + In the case of a sponsored upload, the uploader signs the + files, but the changelog maintainer name and address are those + of the person who prepared this release. If the preparer of + the release is not one of the usual maintainers of the package + (as listed in the Maintainer or Uploaders control fields of the package), the first line of the changelog is @@ -1929,6 +1931,10 @@ zope. any target that these targets depend on must also be non-interactive.

+

+ For packages in the main archive, no required targets + may attempt network access. +

The targets are as follows: @@ -2556,7 +2562,9 @@ Package: libc6 the field name is Package and the field value libc6.

- +

Empty field values are only permitted in source package control files + (debian/control). Such fields are ignored. +

A paragraph must not contain more than one instance of a particular field name. @@ -2699,6 +2707,7 @@ Package: libc6 file. These tools are responsible for removing the line breaks from such fields when using fields from debian/control to generate other control files. + They are also responsible for discarding empty fields.

@@ -6972,8 +6981,7 @@ Built-Using: grub2 (= 1.99-9), loadlin (= 1.6e-1) This is necessary in order to reserve the directories for use in cross-installation of library packages from other - architectures, as part of the planned deployment of - multiarch. + architectures, as part of multiarch.

@@ -7053,6 +7061,11 @@ Built-Using: grub2 (= 1.99-9), loadlin (= 1.6e-1) kernel information.

+ +

+ The /var/www directory is additionally allowed. +

+

The requirement for /usr/local/lib<qual> @@ -7343,6 +7356,35 @@ rmdir /usr/local/share/emacs 2>/dev/null || true 65535: + +

+ This value must not be used, because it was + the error return sentinel value when uid_t + was 16 bits. +

+ + + 65536-4294967293: + +

+ Dynamically allocated user accounts. By + default adduser will not allocate UIDs + and GIDs in this range, to ease compatibility with + legacy systems where uid_t is still 16 + bits. +

+ + + 4294967294: + +

+ (uid_t)(-2) == (gid_t)(-2) must not be + used, because it is used as the anonymous, unauthenticated + user by some NFS implementations. +

+ + + 4294967295:

(uid_t)(-1) == (gid_t)(-1) must @@ -8885,6 +8927,7 @@ fname () { would point to /srv/run rather than the intended target. + Symbolic links must not traverse above the root directory.

@@ -9783,7 +9826,7 @@ http://localhost/cgi-bin/.../cgi-bin-name doc-base package. If access to the web document root is unavoidable then use -/var/www +/var/www/html as the Document Root. This might be just a symbolic link to the location where the system administrator @@ -10619,16 +10662,17 @@ END-INFO-DIR-ENTRY

- + Additional documentation

Any additional documentation that comes with the package may be installed at the discretion of the package maintainer. - Plain text documentation should be installed in the directory - /usr/share/doc/package, where - package is the name of the package, and - compressed with gzip -9 unless it is small. +

+ +

+ Plain text documentation should be compressed with gzip + -9 unless it is small.

@@ -10638,6 +10682,25 @@ END-INFO-DIR-ENTRY take up disk space on the machines of users who do not need or want it installed.

+

+ Additional documentation for package, whether the + documentation is packaged separately or not, should be + installed to the directory + /usr/share/doc/package or its + subdirectories. + Rationale: Once installed, the separation of the + documentation packaging should be invisible to the user, + and the documentation should be found in the expected + location for the main binary package. + +

+ +

+ Any separate package providing documentation must still + install files as specified in the rest of this policy; for + example, and . +

+

It is often a good idea to put text information files (READMEs, changelogs, and so forth) that come with @@ -10699,16 +10762,16 @@ END-INFO-DIR-ENTRY via HTML.

- If your package comes with extensive documentation in a + If the package comes with extensive documentation in a markup format that can be converted to various other formats you should if possible ship HTML versions in a binary - package, in the directory - /usr/share/doc/appropriate-package or - its subdirectories. - The rationale: The important thing here is that HTML - docs should be available in some package, not - necessarily in the main binary package. + package. + Rationale: The important thing here is that HTML + documentation should be available from some + binary package. + The documentation must be installed as specified in + .