Bug#179648: dpkg: Error in update-alternatives(8) man page re: --install args
Package: dpkg
Version: 1.10.9
Severity: minor
Excerpt from the man page:
=============================================================
generic name
A name, like /usr/bin/editor, which refers, via the
alternatives system, to one of a number of files of
similar function.
symlink
Without any further qualification, this means a
symbolic link in the alternatives directory: one
which the system administrator is expected to
adjust.
alternative
The name of a specific file in the filesystem,
which may be made accessible via a generic name
using the alternatives system.
[...]
ACTIONS
--install link gen path pri [--slave slink sgen spath] ...
Add a group of alternatives to the system. gen is
the generic name for the master link, link is the
name of its symlink, and path is the alternative
being introduced for the master link.
[...]
--remove name path
=============================================================
The "ACTIONS --install" line is wrong. Actually the syntax is
--install gen link path pri [--slave sgen slink spath] ...
More descriptive would be
--install gen link alt pri [--slave sgen slink salt] ...
Add a group of alternatives to the system. gen is
the generic name for the master link, link is the
name of its symlink in the alternatives directory,
and alt is the alternative being introduced for the
master link.
And so on for the rest of the description. Also, the
"ACTIONS ... --remove" should use the same terminology to describe
its arguments as the "--install" part. Thus
--remove link alt
The usage output of update-alternatives should be changed
accordingly too.
-- System Information:
Debian Release: 3.0
Architecture: i386
Kernel: Linux thanatos 2.4.20 #2 Tue Jan 28 11:08:09 CET 2003 i686
Locale: LANG=en_GB, LC_CTYPE=en_GB
Versions of packages dpkg depends on:
ii dselect 1.10.9 a user tool to manage Debian packa
ii libc6 2.3.1-10 GNU C Library: Shared libraries an
-- no debconf information
Reply to: