Document in its man page that update-alternatives requires cooperation

from all packages dealing with the specific file. Closes: #396338
Thanks to Tomas Pospisek <tpo_deb@sourcepole.ch>.

diff --git a/debian/changelog b/debian/changelog
index bcea3cabd7d5d14ad3444148da19a792993019d6..226cbae829bcc5e2180a550c5a7809a154b83a35 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,9 @@ dpkg (1.13.25~) UNRELEASED; urgency=low
   [ Guillem Jover ]
   * Fix year 2018 in changelog for Michael Alan Dorman's upload in 1998,
     which was confusing the changelog parsers.
+  * Document in its man page that update-alternatives requires cooperation
+    from all packages dealing with the specific file. Closes: #396338
+    Thanks to Tomas Pospisek <tpo_deb@sourcepole.ch>.
 
   [ Updated dpkg translations ]
   * Chinese (Traditional, Asho Yeh)

diff --git a/man/C/update-alternatives.8 b/man/C/update-alternatives.8
index d4b37f1c380d1ff6089a0ee3ba335313c7837e59..cf46b4a136267941d394d06e40fbfce9b9c17dbe 100644 (file)
--- a/man/C/update-alternatives.8
+++ b/man/C/update-alternatives.8
@@ -5,7 +5,7 @@
 .\" by the Free Software Foundation; either version 2 of the License, or
 .\" (at your option) any later version.  There is NO WARRANTY.  You can
 .\" find the GNU GPL in /usr/share/common-licenses/GPL on any Debian system.
-.TH update\-alternatives 8 "2006-05-23" "Debian Project" "dpkg utilities"
+.TH update\-alternatives 8 "2006-11-24" "Debian Project" "dpkg utilities"
 .SH NAME
 update\-alternatives - maintain symbolic links determining default commands
 .
@@ -176,6 +176,17 @@ option in order to return to the automatic mode.
 If you want to configure non-interactively you can use the
 .I \-\-set
 option instead (see below).
+.PP
+Different packages providing the same file need to do so
+.BR cooperatively .
+That is - the usage of
+.B update\-alternatives
+is
+.B mandatory
+for all involved packages in such case - it is not possible to
+override some file in a package that does not employ the
+.B update\-alternatives
+mechanism.
 .
 .SH TERMINOLOGY
 Since the activities of

diff --git a/man/ChangeLog b/man/ChangeLog
index baa01660ba6cf56b9d2a7e1e48c46f1f0c7fd4e8..c6d94bdfa05aa3bbfa1d605ff738b7f7abfc3bd8 100644 (file)
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,8 @@
+2006-11-24  Tomas Pospisek  <tpo_deb@sourcepole.ch>
+
+       * C/update-alternatives.8: Document that it requires cooperation from
+       all packages dealing with the same file.
+
 2006-10-07  Nicolas Francois  <nicolas.francois@centraliens.net>
 
        * po4a/dpkg-deb.1/dpkg-deb.1.cfg: The PO are now in UTF-8, specify the