Bug#509541: apt: apt_preferences(5) default priority assignments confusing

[Junichi Uekawa <dancer@netfort.gr.jp>]

Package: apt
Version: 0.7.19
Severity: normal


I see in apt_preferences(5) the following; but it looks abrupt and
it doesn't make sense. Is there something missing ?



   APT's Default Priority Assignments
       If there is no preferences file or if there is no entry in the file
       that applies to a particular version then the priority assigned to that
       version is the priority of the distribution to which that version
       belongs. It is possible to single out a distribution, "the target
       release", which receives a higher priority than other distributions do
       by default. The target release can be set on the apt-get command line
       or in the APT configuration file /etc/apt/apt.conf. Note that this has
       precedence over any general priority you set in the
       /etc/apt/preferences file described later, but not over specifically
       pinned packages. For example,

           apt-get install -t testing some-package



           APT::Default-Release "stable";

       If the target release has been specified then APT uses the following
       algorithm to set the priorities of the versions of a package. Assign:




-- System Information:
Debian Release: 5.0
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.26-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=ja_JP.eucJP, LC_CTYPE=ja_JP.eucJP (charmap=EUC-JP) (ignored: LC_ALL set to ja_JP.eucJP)
Shell: /bin/sh linked to /bin/bash

Versions of packages apt depends on:
ii  debian-archive-keyring   2008.04.16+nmu1 GnuPG archive keys of the Debian a
ii  libc6                    2.7-16          GNU C Library: Shared libraries
ii  libgcc1                  1:4.3.2-1       GCC support library
ii  libstdc++6               4.3.2-1         The GNU Standard C++ Library v3

apt recommends no packages.

Versions of packages apt suggests:
pn  apt-doc               <none>             (no description available)
ii  aptitude              0.4.11.11-1~lenny1 terminal-based package manager
ii  bzip2                 1.0.5-1            high-quality block-sorting file co
ii  dpkg-dev              1.14.23            Debian package development tools
ii  lzma                  4.43-14            Compression method of 7z format in
ii  python-apt            0.7.7.1+nmu1       Python interface to libapt-pkg
ii  synaptic              0.62.1             Graphical package manager

-- no debconf information