From eacff30830e6ce3f0055293d3466a94c15571bd5 Mon Sep 17 00:00:00 2001 From: Russ Allbery Date: Fri, 13 Feb 2009 19:20:12 -0800 Subject: [PATCH] No multiple distributions in Distribution, update footnote Document that the Debian archive software does not allow listing multiple distributions in the *.changes file. Update the footnote listing Distribution field values to list the ones currently used, remove frozen, remove the discussion of testing, and add a mention of stable-security and testing-security. Based on wording proposed by Colin Watson and Adam D. Barratt. --- policy.sgml | 86 ++++++++++++++++++++++++----------------------------- 1 file changed, 39 insertions(+), 47 deletions(-) diff --git a/policy.sgml b/policy.sgml index 36f51aa..969b5c7 100644 --- a/policy.sgml +++ b/policy.sgml @@ -3062,69 +3062,58 @@ Package: libc6 distribution(s) where this version of the package should be installed. Valid distributions are determined by the archive maintainers. - Current distribution names are: + Current distribution names in the Debian archive used in + .changes files are: - stable - - This is the current "released" version of Debian - GNU/Linux. Once the distribution is - stable only security fixes and other - major bug fixes are allowed. When changes are - made to this distribution, the release number is - increased (for example: 2.2r1 becomes 2.2r2 then - 2.2r3, etc). - - unstable - This distribution value refers to the - developmental part of the Debian - distribution tree. New packages, new upstream - versions of packages and bug fixes go into the - unstable directory tree. Download from - this distribution at your own risk. + This distribution value refers to the + developmental part of the Debian distribution + tree. Most new packages, new upstream versions of + packages and bug fixes go into the unstable + directory tree. - testing + experimental - This distribution value refers to the - testing part of the Debian distribution - tree. It receives its packages from the - unstable distribution after a short time lag to - ensure that there are no major issues with the - unstable packages. It is less prone to breakage - than unstable, but still risky. It is not - possible to upload packages directly to - testing. + The packages with this distribution value are deemed + by their maintainers to be high risk. Oftentimes they + represent early beta or developmental packages from + various sources that the maintainers want people to + try, but are not ready to be a part of the other parts + of the Debian distribution tree. - frozen + stable-proposed-updates - From time to time, the testing - distribution enters a state of "code-freeze" in - anticipation of release as a stable - version. During this period of testing only - fixes for existing or newly-discovered bugs will - be allowed. The exact details of this stage are - determined by the Release Manager. + Once a distribution of Debian GNU/Linux is released, + it is declared stable and only security fixes + and other major bug fixes are allowed. Proposed + non-security updates for stable are uploaded + using this distribution value after getting approval + from the stable release managers. - experimental + testing-proposed-updates - The packages with this distribution value are - deemed by their maintainers to be high - risk. Oftentimes they represent early beta or - developmental packages from various sources that - the maintainers want people to try, but are not - ready to be a part of the other parts of the - Debian distribution tree. Download at your own - risk. + The testing distribution, which cannot be + uploaded to directly, normally receives its packages + from the unstable distribution after a short + time lag. However sometimes, such as during release + freezes before a new stable release or when a problem + in the testing distribution requires fixing + before the unstable version can migrate, + direct uploads to testing are useful. This + distribution value is used for those exceptions.

- You should list all distributions that the - package should be installed into. + Security fixes for the stable or + testing distributions are handled via a + separate upload queue and special + stable-security and testing-security + distribution values.

@@ -3132,6 +3121,9 @@ Package: libc6 Reference, section "The Debian archive".

+ The Debian archive software only supports listing a single + distribution. Migration of packages to other distributions is + handled outside of the upload process.

-- 2.39.5