Bug#29274: dpkg-dev: email address hint for debian-changelog-mode.el

[Roderick Schertler <roderick@argon.org>]

Package: dpkg-dev
Version: 1.4.0.31

A lot of people put code at the end of their debian/changelog files
to set add-log-mailing-address so that they can use their debian.org
address in the changelog file without using it for all of their email.
This isn't a great solution because it screws up NMUs, and because it's
more work than should be necessary.  This is a documentation patch for
debian-changelog-mode.el which describes a better way for the user to
get what they want.

--- debian-changelog-mode.el.~1~	Thu Oct 22 20:51:43 1998
+++ debian-changelog-mode.el	Tue Nov 10 16:59:58 1998
@@ -218,7 +218,20 @@
 
 Key bindings:
 
-\\{debian-changelog-mode-map}"
+\\{debian-changelog-mode-map}
+Hint:  If you want to use your debian.org email address for debian/changelog
+entries without using it for the rest of your email, put
+
+    (add-hook 'debian-changelog-mode-hook 'my-debian-changelog-mode-hook)
+    (defun my-debian-changelog-mode-hook ()
+      (make-local-variable 'add-log-mailing-address)
+      (setq add-log-mailing-address \"myname@debian.org\"))
+
+in your ~/.emacs file.  This is better than including a local setting
+for add-log-mailing-address in the changelog itself both because you
+only have to set it up once and because it works in the presense of
+NMUs."
+
   (interactive)
   (kill-all-local-variables)
   (text-mode)