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>.

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)

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

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