- initial import of revision 374 from cnc
[apt.git] / contrib / allow-duplicated / README
1 This script will handle Allow-Duplicated packages when more
2 than one is available during an install operation, and will
3 also upgrade these packages in a dist-upgrade operation.
4
5 For the dist-upgrade operation, only those packages matching
6 a regular expression in the RPM::Allow-Duplicated-Upgrade
7 option will be affected.
8
9 For example, suppose that the following packages are
10 available:
11
12         kernel26#2.6.2-48393cl 2.6.2-48393cl [Installed]
13         kernel26#2.6.0-41929cl 2.6.0-41929cl [Installed]
14         kernel26#2.6.1-44677cl 2.6.1-44677cl [Installed]
15         kernel26#2.6.3-50659cl 2.6.3-50659cl
16
17 If you try to install the package "kernel26", you'll usually
18 get a message that these packages are available, and you must
19 select one of them.
20
21 With this script plugged into the necessary slots, the 2.6.3
22 version will be correctly selected for installation in
23 the "install kernel26" operation is performed. It will also
24 be selected for installation if you perform a dist-upgrade
25 operation with something like this in your configuration:
26
27         RPM::Allow-Duplicated-Upgrade:: "kernel.*";
28