From efc487fbd46905f5f3efc4f31d7df15625bcbecf Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Thu, 7 May 2009 12:04:21 +0200 Subject: [apt-pkg] allow also codenames for specifying a release * MatchType::Release checks first for archive than for codename equality * new n= option in apt_preference to be able to pin based on a codeName --- doc/apt_preferences.5.xml | 90 ++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 86 insertions(+), 4 deletions(-) (limited to 'doc/apt_preferences.5.xml') diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml index 162c2f00e..ff63f1dd3 100644 --- a/doc/apt_preferences.5.xml +++ b/doc/apt_preferences.5.xml @@ -14,7 +14,7 @@ &apt-email; &apt-product; - 29 February 2004 + 04 May 2009 @@ -190,6 +190,15 @@ Pin: release a=unstable Pin-Priority: 50 +The following record assigns a high priority to all package versions +belonging to any distribution whose Codename is "squeeze". + + +Package: * +Pin: release n=squeeze +Pin-Priority: 900 + + The following record assigns a high priority to all package versions belonging to any release whose Archive name is "stable" and whose release Version number is "3.0". @@ -327,10 +336,11 @@ file are relevant for setting APT priorities: -the Archive: line +the Archive: or Suite: line names the archive to which all the packages in the directory tree belong. For example, the line -"Archive: stable" +"Archive: stable" or +"Suite: stable" specifies that all of the packages in the directory tree below the parent of the Release file are in a stable archive. Specifying this value in the APT preferences file @@ -342,6 +352,22 @@ Pin: release a=stable + +the Codename: line +names the codename to which all the packages +in the directory tree belong. For example, the line +"Codename: squeeze" +specifies that all of the packages in the directory +tree below the parent of the Release file belong to a version named +squeeze. Specifying this value in the APT preferences file +would require the line: + + +Pin: release n=squeeze + + + + the Version: line names the release version. For example, the @@ -522,7 +548,64 @@ version. apt-get install package/unstable + + + + +Tracking the evolution of a codename release + +The following APT preferences file will cause APT to assign a +priority higher than the default (500) to all package versions belonging +to a specified codename of a distribution and a prohibitively low priority to +package versions belonging to other Debian distributions, +codenames and archives. +Note that with this APT preference APT will follow the migration of a release +from the archive testing to stable and +later oldstable. If you want to follow for example the progress +in testing notwithstanding the codename changes you should use +the example configurations above. + + +Explanation: Uninstall or do not install any Debian-originated package versions +Explanation: other than those in the distribution codenamed with squeeze or sid +Package: * +Pin: release n=squeeze +Pin-Priority: 900 + +Explanation: Debian unstable is always codenamed with sid +Package: * +Pin: release a=sid +Pin-Priority: 800 + +Package: * +Pin: release o=Debian +Pin-Priority: -10 + + + +With a suitable &sources-list; file and the above preferences file, +any of the following commands will cause APT to upgrade to the +latest version(s) in the release codenamed with squeeze. + + +apt-get install package-name +apt-get upgrade +apt-get dist-upgrade + + + +The following command will cause APT to upgrade the specified +package to the latest version from the sid distribution. +Thereafter, apt-get upgrade will upgrade +the package to the most recent squeeze version if that is +more recent than the installed version, otherwise, to the most recent +sid version if that is more recent than the installed +version. + +apt-get install package/sid + + @@ -535,4 +618,3 @@ apt-get install package/unstable &manbugs; - -- cgit v1.2.3-70-g09d2 From f0599b9c2ee704f97dbea17262107c55f527bbf0 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Wed, 26 Aug 2009 12:21:54 +0200 Subject: [ Nicolas François ] * doc/*.?.xml (manpages): - add contrib to author tags and also add refmiscinfo to fix warnings MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- debian/changelog | 4 ++++ doc/apt-cache.8.xml | 1 + doc/apt-cdrom.8.xml | 1 + doc/apt-config.8.xml | 1 + doc/apt-extracttemplates.1.xml | 1 + doc/apt-ftparchive.1.xml | 1 + doc/apt-get.8.xml | 1 + doc/apt-key.8.xml | 1 + doc/apt-mark.8.xml | 1 + doc/apt-secure.8.xml | 1 + doc/apt-sortpkgs.1.xml | 1 + doc/apt.conf.5.xml | 1 + doc/apt.ent | 27 +++++++-------------------- doc/apt_preferences.5.xml | 1 + doc/sources.list.5.xml | 1 + 15 files changed, 24 insertions(+), 20 deletions(-) (limited to 'doc/apt_preferences.5.xml') diff --git a/debian/changelog b/debian/changelog index 4923f913f..ed2c91b0e 100644 --- a/debian/changelog +++ b/debian/changelog @@ -43,6 +43,10 @@ apt (0.7.22.3) unstable; urgency=low * apt-pkg/indexcopy.cc: - fix a memory leak then the Release file not exists (Closes: #511556) + [ Nicolas François ] + * doc/*.?.xml (manpages): + - add contrib to author tags and also add refmiscinfo to fix warnings + -- David Kalnischkies Sat, 08 Aug 2009 09:40:08 +0200 apt (0.7.22.2) unstable; urgency=low diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 6c8938d8c..8b76f55b9 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -21,6 +21,7 @@ apt-cache 8 + APT diff --git a/doc/apt-cdrom.8.xml b/doc/apt-cdrom.8.xml index 6ab8fad9c..e57942610 100644 --- a/doc/apt-cdrom.8.xml +++ b/doc/apt-cdrom.8.xml @@ -20,6 +20,7 @@ apt-cdrom 8 + APT diff --git a/doc/apt-config.8.xml b/doc/apt-config.8.xml index 39fed5937..d4d36891f 100644 --- a/doc/apt-config.8.xml +++ b/doc/apt-config.8.xml @@ -21,6 +21,7 @@ apt-config 8 + APT diff --git a/doc/apt-extracttemplates.1.xml b/doc/apt-extracttemplates.1.xml index 0f4ac04d9..77b837022 100644 --- a/doc/apt-extracttemplates.1.xml +++ b/doc/apt-extracttemplates.1.xml @@ -21,6 +21,7 @@ apt-extracttemplates 1 + APT diff --git a/doc/apt-ftparchive.1.xml b/doc/apt-ftparchive.1.xml index de7e5f7a3..7131303ae 100644 --- a/doc/apt-ftparchive.1.xml +++ b/doc/apt-ftparchive.1.xml @@ -21,6 +21,7 @@ apt-ftparchive 1 + APT diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 8db2883c4..b87e17247 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -21,6 +21,7 @@ apt-get 8 + APT diff --git a/doc/apt-key.8.xml b/doc/apt-key.8.xml index 4b3e7c220..7b0691b5e 100644 --- a/doc/apt-key.8.xml +++ b/doc/apt-key.8.xml @@ -13,6 +13,7 @@ apt-key 8 + APT diff --git a/doc/apt-mark.8.xml b/doc/apt-mark.8.xml index f078f2de5..35412d7c9 100644 --- a/doc/apt-mark.8.xml +++ b/doc/apt-mark.8.xml @@ -21,6 +21,7 @@ apt-mark 8 + APT diff --git a/doc/apt-secure.8.xml b/doc/apt-secure.8.xml index 9696e018d..20f473f77 100644 --- a/doc/apt-secure.8.xml +++ b/doc/apt-secure.8.xml @@ -13,6 +13,7 @@ apt-secure 8 + APT diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index 59235f115..2412260e7 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -27,6 +27,7 @@ apt.conf 5 + APT diff --git a/doc/apt.ent b/doc/apt.ent index 4cfc00069..43ac2f8e5 100644 --- a/doc/apt.ent +++ b/doc/apt.ent @@ -158,7 +158,10 @@
apt@packages.debian.org
- Jason Gunthorpe + + Jason Gunthorpe + + 1998-2001 Jason Gunthorpe 28 October 2008 Linux @@ -176,6 +179,7 @@ Jason Gunthorpe + "> @@ -183,12 +187,14 @@ Mike O'Connor + "> APT team + "> @@ -196,25 +202,6 @@ Linux "> - - apt@packages.debian.org - -"> - - - Jason - Gunthorpe - -"> - - - APT team - -"> - Jason Gunthorpe diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml index ff63f1dd3..12ea606b7 100644 --- a/doc/apt_preferences.5.xml +++ b/doc/apt_preferences.5.xml @@ -20,6 +20,7 @@ apt_preferences 5 + APT diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml index b875086ef..c758be61f 100644 --- a/doc/sources.list.5.xml +++ b/doc/sources.list.5.xml @@ -21,6 +21,7 @@ sources.list 5 + APT -- cgit v1.2.3-70-g09d2 From daa4aa525a9d0de9a9a64be59615fc4be044bb83 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Tue, 8 Sep 2009 17:47:59 +0200 Subject: document the new preferences.d folder in apt_preferences(Closes: #544017) --- debian/changelog | 2 ++ doc/apt_preferences.5.xml | 10 +++++++++- 2 files changed, 11 insertions(+), 1 deletion(-) (limited to 'doc/apt_preferences.5.xml') diff --git a/debian/changelog b/debian/changelog index c5a786919..eebef40ff 100644 --- a/debian/changelog +++ b/debian/changelog @@ -29,6 +29,8 @@ apt (0.7.24) UNRELEASED; urgency=low a bit and improve the documentation for this option group. * doc/apt.ent, all man pages: - move the description of files to globally usable entities + * doc/apt_preferences.5.xml: + - document the new preferences.d folder (Closes: #544017) -- David Kalnischkies Fri, 28 Aug 2009 09:40:08 +0200 diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml index 12ea606b7..159d61f2b 100644 --- a/doc/apt_preferences.5.xml +++ b/doc/apt_preferences.5.xml @@ -32,7 +32,8 @@ Description The APT preferences file /etc/apt/preferences -can be used to control which versions of packages will be selected +and the fragment files in the /etc/apt/preferences.d/ +folder can be used to control which versions of packages will be selected for installation. Several versions of a package may be available for installation when @@ -610,6 +611,13 @@ apt-get install package/sid + +Files + + &file-preferences; + + + See Also &apt-get; &apt-cache; &apt-conf; &sources-list; -- cgit v1.2.3-70-g09d2