Bug#286061: manpage for apt-cache conflicts with internal help for pkgnames

[Stefan Berndtsson <stefan@nocrew.org>]

Package: apt
Version: 0.5.27
Severity: normal


The internal help for apt-cache states:

   pkgnames - List the names of all packages


The manpage for apt-cache states:

   pkgnames [ prefix ]
          This  command prints the name of each package in the system. The
          optional argument is a prefix match to filter the name list. The
          output  is suitable for use in a shell tab complete function and
          the output is generated extremely quickly. This command is  best
          used with the --generate option.


The phrasing "in the system" is not at all obvious to mean "any package
apt knows about". It's far more likely to indicate the same basic list
that "dpkg -l" would give.


-- Package-specific info:

-- System Information:
Debian Release: 3.1
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.7
Locale: LANG=C, LC_CTYPE=C

Versions of packages apt depends on:
ii  libc6                       2.3.2.ds1-16 GNU C Library: Shared libraries an
ii  libgcc1                     1:3.4.1-7    GCC support library
ii  libstdc++5                  1:3.3.4-9    The GNU Standard C++ Library v3

-- no debconf information