Bug#208014: dpkg: Improvements to the update-alternatives manpage
The --config option is missing from the list of actions in
update-alternatives(8). It is mentioned in the text and synopsis,
but should really be found next to its friends like --display.
The patch below adds an entry under the ACTIONS section, and also
adds a new EXAMPLES section so that people can see the most common
usage at a glance. The patch is against dpkg-1.10.10
--- scripts/update-alternatives.8.orig Mon Aug 25 10:18:20 2003
+++ scripts/update-alternatives.8 Sun Aug 31 13:16:05 2003
@@ -210,6 +210,42 @@
When a link group is in manual mode,
the alternatives system will not make any changes
to the system administrator's settings.
+There are several packages which provide a text editor compatible
+.BR vi ,
+.BR nvi " and " vim .
+Which one is used is controlled by the link group
+.BR vi ,
+which includes links for the program itself and the associated manpage.
+To display the available packages which provide
+and the current setting for it, use the
+update-alternatives --display vi
+To choose a particular
+implementation, use this command as root and then select a number
+from the list:
+update-alternatives --config vi
+To go back to having the
+implementation chosen automatically, do this as root:
+update-alternatives --auto vi
Exactly one action must be specified if
@@ -321,6 +357,13 @@
Display all targets of the link group.
+Show available alternatives for a link group and allow the user to
+interactively select which one to use. The link group is updated
+and taken out of