apt: Manpages are useless

[Johanna Moshtar]

Package: apt
Version: 0.6.43.3ubuntu3
Severity: important


The manpage for apt is useless, by its own admission. Contrary to 
popular belief documentation should not be an afterthought or just 
plainly ignored.

Perhaps the development team can take a look at the BSD or Postgresql 
documentation for some pointers on how to deliver a *complete* software 
program.


-- Package-specific info:

-- (no /etc/apt/preferences present) --


-- (/etc/apt/sources.list present, but not submitted) --


-- System Information:
Debian Release: testing/unstable
  APT prefers dapper-updates
  APT policy: (500, 'dapper-updates'), (500, 'dapper-security'), (500, 'dapper-backports'), (500, 'dapper')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.15-51-386
Locale: LANG=en_AU.UTF-8, LC_CTYPE=en_AU.UTF-8 (charmap=UTF-8)

Versions of packages apt depends on:
ii  libc6                  2.3.6-0ubuntu20.5 GNU C Library: Shared libraries an
ii  libgcc1                1:4.0.3-1ubuntu5  GCC support library
ii  libstdc++6             4.0.3-1ubuntu5    The GNU Standard C++ Library v3

Versions of packages apt recommends:
ii  ubuntu-keyring              2005.01.12.1 GnuPG keys of the Ubuntu archive

-- no debconf information