diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/apt-get.8.xml | 9 | ||||
| -rw-r--r-- | doc/apt.conf.5.xml | 2 | ||||
| -rw-r--r-- | doc/apt_preferences.5.xml | 90 |
3 files changed, 95 insertions, 6 deletions
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index c1b3470ef..c63b2a6c6 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -53,6 +53,9 @@ <arg choice='plain'> <replaceable>target_release_number_expression</replaceable> </arg> + <arg choice='plain'> + <replaceable>target_release_codename</replaceable> + </arg> </group> </arg> @@ -71,6 +74,9 @@ <arg choice='plain'> /<replaceable>target_release_name</replaceable> </arg> + <arg choice='plain'> + /<replaceable>target_release_codename</replaceable> + </arg> </group> </arg> </arg> @@ -455,7 +461,8 @@ of this option. In short, this option lets you have simple control over which distribution packages will be retrieved from. Some common examples might be - <option>-t '2.1*'</option> or <option>-t unstable</option>. + <option>-t '2.1*'</option>, <option>-t unstable</option> + or <option>-t sid</option>. Configuration Item: <literal>APT::Default-Release</literal>; see also the &apt-preferences; manual page.</para></listitem> </varlistentry> diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index 74966c5b3..fb2be9a28 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -110,7 +110,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; <varlistentry><term>Default-Release</term> <listitem><para>Default release to install packages from if more than one - version available. Contains release name or release version. Examples: 'stable', 'testing', 'unstable', '4.0', '5.0*'. Release codenames ('etch', 'lenny' etc.) are not allowed now. See also &apt-preferences;.</para></listitem> + version available. Contains release name, codename or release version. Examples: 'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also &apt-preferences;.</para></listitem> </varlistentry> <varlistentry><term>Ignore-Hold</term> 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; <!-- The last update date --> - <date>29 February 2004</date> + <date>04 May 2009</date> </refentryinfo> <refmeta> @@ -191,6 +191,15 @@ Pin-Priority: 50 </programlisting> <simpara>The following record assigns a high priority to all package versions +belonging to any distribution whose Codename is "<literal>squeeze</literal>".</simpara> + +<programlisting> +Package: * +Pin: release n=squeeze +Pin-Priority: 900 +</programlisting> + +<simpara>The following record assigns a high priority to all package versions belonging to any release whose Archive name is "<literal>stable</literal>" and whose release Version number is "<literal>3.0</literal>".</simpara> @@ -327,10 +336,11 @@ file are relevant for setting APT priorities: <variablelist> <varlistentry> -<term>the <literal>Archive:</literal> line</term> +<term>the <literal>Archive:</literal> or <literal>Suite:</literal> line</term> <listitem><simpara>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 <filename>Release</filename> file are in a <literal>stable</literal> archive. Specifying this value in the APT preferences file @@ -343,6 +353,22 @@ Pin: release a=stable </varlistentry> <varlistentry> +<term>the <literal>Codename:</literal> line</term> +<listitem><simpara>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 <filename>Release</filename> file belong to a version named +<literal>squeeze</literal>. Specifying this value in the APT preferences file +would require the line: +</simpara> +<programlisting> +Pin: release n=squeeze +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> <term>the <literal>Version:</literal> line</term> <listitem><simpara>names the release version. For example, the packages in the tree might belong to Debian GNU/Linux release @@ -522,7 +548,64 @@ version. apt-get install <replaceable>package</replaceable>/unstable </programlisting> </para> +</refsect2> + + +<refsect2> +<title>Tracking the evolution of a codename release</title> + +<para>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 <literal>Debian</literal> distributions, +codenames and archives. +Note that with this APT preference APT will follow the migration of a release +from the archive <literal>testing</literal> to <literal>stable</literal> and +later <literal>oldstable</literal>. If you want to follow for example the progress +in <literal>testing</literal> notwithstanding the codename changes you should use +the example configurations above. + +<programlisting> +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 +</programlisting> +</para> + +<para>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 <literal>squeeze</literal>. + +<programlisting> +apt-get install <replaceable>package-name</replaceable> +apt-get upgrade +apt-get dist-upgrade +</programlisting> +</para> + +<para>The following command will cause APT to upgrade the specified +package to the latest version from the <literal>sid</literal> distribution. +Thereafter, <command>apt-get upgrade</command> will upgrade +the package to the most recent <literal>squeeze</literal> version if that is +more recent than the installed version, otherwise, to the most recent +<literal>sid</literal> version if that is more recent than the installed +version. +<programlisting> +apt-get install <replaceable>package</replaceable>/sid +</programlisting> +</para> </refsect2> </refsect1> @@ -535,4 +618,3 @@ apt-get install <replaceable>package</replaceable>/unstable &manbugs; </refentry> - |