Clarify the legend in update-alternatives '--help' (Andrew Ferrier).

Closes: #305318

diff --git a/ChangeLog b/ChangeLog
index 73f46e7870b2c241b10babc177776a8a110730f4..dbbb5020999315f3e8369adfdc113ee2b711357d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2006-06-16  Andrew Ferrier  <andrew@new-destiny.co.uk>
+           Guillem Jover  <guillem@debian.org>
+
+       * scripts/update-alternatives.pl (usage): Clarify the legend for the
+       help text.
+
 2006-06-16  Guillem Jover  <guillem@debian.org>
 
        * scripts/update-alternatives.pl (config_message): Print '--config'

diff --git a/debian/changelog b/debian/changelog
index 2dab6b657d53df0dd27603426b397be5ed73816e..c8961d1ff0aef8f0577e63200904c71827e47a11 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -7,6 +7,8 @@ dpkg (1.13.22~) UNRELEASED; urgency=low
     Suggested by Adeodato Simó. Closes: #370392
   * Print update-alternatives '--config' listing layout evenly spaced.
     Closes: #325895
+  * Clarify the legend in update-alternatives '--help' (Andrew Ferrier).
+    Closes: #305318
 
   [ Updated dpkg Translations ]
   * Romanian (Eddy Petrişor).

diff --git a/scripts/update-alternatives.pl b/scripts/update-alternatives.pl
index b482526fec36c15d6cda3d9a7615896067e61010..f6f3500794a9e852f6e1cca14dcecec3f349dab1 100755 (executable)
--- a/scripts/update-alternatives.pl
+++ b/scripts/update-alternatives.pl
@@ -64,10 +64,14 @@ Commands:
   --set <name> <path>      set <path> as alternative for <name>.
   --all                    call --config on all alternatives.
 
-<name> is the name in /etc/alternatives.
-<path> is the name referred to.
-<link> is the link pointing to /etc/alternatives/<name>.
-<priority> is an integer; options with higher numbers are chosen.
+<link> is the symlink pointing to /etc/alternatives/<name>.
+  (e.g. /usr/bin/pager)
+<name> is the master name for this link group.
+  (e.g. pager)
+<path> is the location of one of the alternative target files.
+  (e.g. /usr/bin/less)
+<priority> is an integer; options with higher numbers have higher priority in
+  automatic mode.
 
 Options:
   --altdir <directory>     change the alternatives directory.